ชิ้นงานโฆษณา

การปรับแต่งองค์ประกอบตำแหน่งการจัดวาง

ใช้โซลูชั่นนี้เพื่อปรับแต่งองค์ประกอบชิ้นงานโฆษณาที่แสดงในตำแหน่งการจัดวางโฆษณาต่างๆ คอยควบคุมชิ้นงานโฆษณาให้ดีขณะที่ใช้ตำแหน่งการจัดวางที่ต่างกันหลายรายการไปด้วย

การปรับแต่งองค์ประกอบตำแหน่งการจัดวางเป็น 1 ใน 3 API ที่ใช้กฎการปรับแต่งองค์ประกอบ เรียนรู้เพิ่มเติมเกี่ยวกับกฎการปรับแต่งองค์ประกอบ

เริ่มต้น

ไม่รองรับการปรับแต่งองค์ประกอบตำแหน่งการจัดวางในโพสต์ที่มีอยู่ผ่าน API อีกต่อไป คุณสามารถใช้ตัวเลือกนี้ได้ในตัวจัดการโฆษณาเท่านั้น

ขั้นตอนที่ 2: จัดเตรียมชิ้นงานโฆษณา

ใช้ asset_feed_spec เพื่อจัดเตรียมชิ้นงานโฆษณา คุณสามารถระบุองค์ประกอบชิ้นงานโฆษณาหลายรายการสำหรับองค์ประกอบแต่ละประเภท ซึ่งรวมถึงรูปภาพ วิดีโอ ภาพสไลด์ พาดหัว และเนื้อความ จัดเตรียมคำอธิบายลิงก์เพียงรายการเดียวเท่านั้น เนื่องจากไม่สามารถปรับแต่งคำอธิบายลิงก์ต่อตำแหน่งการจัดวางได้

วิธีใช้การปรับแต่ง:

  1. กำหนด asset_customization_rules ใน asset_feed_spec ของคุณ
  2. ให้เพิ่ม customization_spec และป้ายองค์ประกอบสำหรับกฎแต่ละข้อ

ในการปรับแต่งองค์ประกอบตำแหน่งการจัดวาง ทุกๆ asset_feed_spec ต้องมีกฎการปรับแต่งอยู่มากกว่า 1 รายการ

ดูกฎการปรับแต่งองค์ประกอบ

คุณสมบัติที่รองรับ


ชื่อคุณสมบัติ คำอธิบาย

customization_spec

ประเภท: ช่องที่รองรับ

จำเป็นต้องระบุ

ตำแหน่งการจัดวางที่คุณต้องการแสดงองค์ประกอบ

image_label

รูปแบบ: {"name": "{LABEL_NAME}"}

ต้องระบุสำหรับรูปแบบ SINGLE_IMAGE

ป้ายของรูปภาพที่คุณต้องการแสดง ซึ่งจะกำกับองค์ประกอบที่เป็นรูปภาพใน asset_feed_spec

video_label

รูปแบบ: {"name": "{LABEL_NAME}"}

ต้องระบุสำหรับโฆษณารูปแบบ SINGLE_VIDEO

ป้ายของวิดีโอที่คุณต้องการแสดง ซึ่งจะกำกับองค์ประกอบที่เป็นวิดีโอใน asset_feed_spec

carousel_label
รูปแบบ: {"name": "{LABEL_NAME}"}

ต้องระบุสำหรับรูปแบบ CAROUSELS

ป้ายของภาพสไลด์ที่คุณต้องการแสดง ซึ่งจะกำกับองค์ประกอบที่เป็นภาพสไลด์ใน asset_feed_spec

หมายเหตุ: หากมีภาพสไลด์ผ่านการปรับแต่งองค์ประกอบการจัดวาง สิ่งที่แนบมาที่เป็นรายการย่อยทั้งหมดจะต้องถูกกำหนดไว้ภายในข้อมูลจำเพาะของฟีดองค์ประกอบ และอ้างอิงผ่านป้ายกำกับโฆษณา สิ่งที่แนบมาที่เป็นรายการย่อยอาจไม่ได้ถูกกำหนดแบบอินไลน์ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบ carousels ได้ที่ตัวเลือกข้อมูลจำเพาะของฟีดองค์ประกอบ

ช่องที่รองรับใน customization_spec


ชื่อคุณสมบัติ คำอธิบาย

publisher_platforms

จำเป็นต้องระบุ

ตำแหน่งการจัดวางที่โฆษณาของคุณสามารถใช้ได้ ตัวเลือก ได้แก่ facebook, instagram, messenger และ audience_network

facebook_positions

ระบุหรือไม่ก็ได้ แต่จะต้องระบุถ้าเลือก Facebook ใน publisher_platforms

ตำแหน่งการจัดวางสำหรับ Facebook โดยเฉพาะ ตัวเลือก ได้แก่ feed, right_hand_column, marketplace, video_feeds, search และstory

instagram_positions

ระบุหรือไม่ก็ได้ แต่จะต้องระบุถ้าเลือก Instagram ใน publisher_platforms

ตำแหน่งการจัดวางสำหรับ Instagram โดยเฉพาะ ตัวเลือก ได้แก่ stream, story, explore, explore_homeprofile_feed และ ig_search

หมายเหตุ: ตำแหน่งการจัดวาง explore_home รองรับเฉพาะรูปแบบ SINGLE_IMAGE เท่านั้น

messenger_positions

ระบุหรือไม่ก็ได้ แต่จะต้องระบุถ้าเลือก Messenger ใน publisher_platforms

ตำแหน่งการจัดวางสำหรับ Messenger โดยเฉพาะ ตัวเลือก ได้แก่ messenger_home, sponsored_messages และ story

audience_network_positions

ระบุหรือไม่ก็ได้ แต่จะต้องระบุถ้าเลือก Audience Network ใน publisher_platforms

ตำแหน่งการจัดวางสำหรับ Audience Network โดยเฉพาะ ตัวเลือก ได้แก่ classic, instream_video และ rewarded_video

เรียนรู้เพิ่มเติมเกี่ยวกับตัวเลือกตำแหน่งการจัดวางที่ใช้ได้ของเรา

ตัวอย่าง — การตั้งค่าฟีด

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
      "videos": [
      {
        "adlabels": [
          {
            "name": "labelfb"
          }
        ],
        "video_id": "<VIDEO_ID>"
      },
      {
        "adlabels": [
          {
            "name": "labelig"
          }
        ],
        "video_id": "<VIDEO_ID>"
      }
    ],
    "bodies": [
      {
        "text": "Begin Your Adventure"
      }
    ],
    "link_urls": [
      {
        "website_url": "<WEBSITE_URL>",
        "display_url": "<DISPLAY_URL>"
      }
    ],
    "titles": [
      {
        "text": "Level Up"
      }
    ],
    "ad_formats": [
      "SINGLE_VIDEO"
    ],
    "call_to_action_types": [
      "WATCH_MORE"
    ],
    "descriptions": [
      {
        "text": "Description"
      }
    ],
    "asset_customization_rules": [
      {
        "customization_spec": {          
          "publisher_platforms": [
            "facebook"
          ],          
          "facebook_positions": [
            "feed",
            "instream_video"
          ]
        },
        "video_label": {
          "name": "labelfb"
        }
      },
      {
        "customization_spec": {          
          "publisher_platforms": [
            "instagram"
          ],          
          "instagram_positions": [
            "stream"           
          ]
        },
        "video_label": {
          "name": "labelig"
        }
      }
    ]
  }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

ตัวอย่าง — การปรับแต่งองค์ประกอบหน้าหลักของแท็บสำรวจบน Instagram

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "<IMAGE-LABEL>"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "explore_home"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "<IMAGE-HASH>",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "<IMAGE-HASH>",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "",
            "display_url": "",
            "deeplink_url": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

ตัวอย่าง — การปรับแต่งองค์ประกอบผลการค้นหาบน Instagram

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "placement_asset_f1048d832ecd558_1661539731099"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "ig_search"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "<WEBSITE_URL>",
            "display_url": "<DISPLAY_URL>",
            "deeplink_url": "<DEEPLINK_URL>",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

ดูตัวเลือกทั้งหมดที่ใช้งานได้สำหรับข้อมูลจำเพาะของฟีดองค์ประกอบ

ขั้นตอนที่ 5 (ไม่บังคับ): อ่านชิ้นงานโฆษณา

สำหรับโฆษณาการปรับแต่งองค์ประกอบตำแหน่งการจัดวาง ควรเรียกดูช่องชิ้นงานโฆษณาที่เกี่ยวข้องกับ Instagram ผ่านทาง {ad-account-id}/ads ตัวอย่างเช่น:

https://graph.facebook.com/v21.0/{ad-account-id}/ads?fields=creative{effective_instagram_story_id,instagram_permalink_url}