Nội dung quảng cáo

Tùy chỉnh tài sản theo vị trí quảng cáo

Hãy sử dụng giải pháp này để tùy chỉnh tài sản nội dung hiển thị ở các vị trí quảng cáo khác nhau. Duy trì khả năng kiểm soát nội dung trong khi sử dụng nhiều vị trí.

Tùy chỉnh tài sản theo vị trí quảng cáo là 1 trong 3 API sử dụng quy tắc tùy chỉnh tài sản. Tìm hiểu thêm về Quy tắc tùy chỉnh tài sản.

Bắt đầu

Chúng tôi không còn hỗ trợ tính năng Tùy chỉnh tài sản theo vị trí quảng cáo với bài viết hiện có qua API. Bạn chỉ có thể sử dụng tùy chọn này trong Trình quản lý quảng cáo.

Bước 2: Cung cấp nội dung

Hãy sử dụng asset_feed_spec để cung cấp nội dung. Bạn có thể chỉ định nhiều tài sản nội dung cho mỗi loại tài sản, trong đó có hình ảnh, video, thẻ quay vòng, tiêu đề và văn bản nội dung. Chỉ cung cấp 1 nội dung mô tả liên kết, vì bạn không thể tùy chỉnh nội dung mô tả này cho mỗi vị trí.

Cách áp dụng tính năng tùy chỉnh:

  1. Đặt asset_customization_rules bên trong asset_feed_spec.
  2. Thêm customization_spec và nhãn tài sản cho mỗi quy tắc.

Đối với tính năng Tùy chỉnh tài sản theo vị trí quảng cáo, mỗi asset_feed_spec đều cần được đính kèm nhiều quy tắc tùy chỉnh.

Xem Quy tắc tùy chỉnh tài sản.

Thuộc tính được hỗ trợ


Tên thuộc tính Mô tả

customization_spec

loại: Trường được hỗ trợ

Bắt buộc.

Vị trí bạn muốn hiển thị tài sản.

image_label

định dạng: {"name": "{LABEL_NAME}"}

Bắt buộc đối với định dạng SINGLE_IMAGE.

Nhãn của hình ảnh mà bạn muốn hiển thị. Nhãn này được đính kèm với tài sản hình ảnh trong asset_feed_spec.

video_label

định dạng: {"name": "{LABEL_NAME}"}

Bắt buộc đối với định dạng SINGLE_VIDEO.

Nhãn của video mà bạn muốn hiển thị. Nhãn này được đính kèm với tài sản video trong asset_feed_spec.

carousel_label
định dạng: {"name": "{LABEL_NAME}"}

Bắt buộc đối với định dạng CAROUSELS.

Nhãn của thẻ quay vòng mà bạn muốn hiển thị. Nhãn này được đính kèm với tài sản thẻ quay vòng trong asset_feed_spec.

Lưu ý: nếu cung cấp thẻ quay vòng thông qua tính năng Tùy chỉnh tài sản theo vị trí quảng cáo, bạn phải xác định tất cả file đính kèm phụ trong Quy cách nguồn cấp dữ liệu tài sản, đồng thời tham chiếu những file này qua nhãn quảng cáo. File đính kèm phụ có thể không được xác định nội tuyến. Hãy xem bài viết Tùy chọn cho quy cách nguồn cấp dữ liệu tài sản để biết thêm chi tiết về định dạng carousels.

Trường được hỗ trợ trong customization_spec


Tên thuộc tính Mô tả

publisher_platforms

Bắt buộc.

Vị trí bạn có thể sử dụng cho quảng cáo. Tùy chọn: facebook, instagram, messenger và audience_network.

facebook_positions

Không bắt buộc, nhưng sẽ bắt buộc nếu bạn chọn Facebook trong publisher_platforms.

Vị trí cụ thể trên Facebook. Tùy chọn: feed, right_hand_column, marketplace, video_feeds, search và story.

instagram_positions

Không bắt buộc, nhưng sẽ bắt buộc nếu bạn chọn Instagram trong publisher_platforms.

Vị trí cụ thể trên Instagram. Tùy chọn: stream, story, explore, explore_home, profile_feed và ig_search.

Lưu ý: Vị trí explore_home chỉ hỗ trợ định dạng SINGLE_IMAGE.

messenger_positions

Không bắt buộc, nhưng sẽ bắt buộc nếu bạn chọn Messenger trong publisher_platforms.

Vị trí cụ thể trên Messenger. Tùy chọn: messenger_home, sponsored_messages và story.

audience_network_positions

Không bắt buộc, nhưng sẽ bắt buộc nếu bạn chọn Audience Network trong publisher_platforms.

Vị trí cụ thể trên Audience Network. Tùy chọn: classic, instream_video và rewarded_video.

Tìm hiểu thêm về các tùy chọn vị trí có sẵn.

Ví dụ - Thiết lập nguồn cấp dữ liệu

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

Ví dụ - Tùy chỉnh tài sản trong trang chủ Khám phá trên 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

Ví dụ - Tùy chỉnh tài sản trong kết quả tìm kiếm trên 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

Xem tất cả tùy chọn có sẵn cho Quy cách nguồn cấp dữ liệu tài sản.

Bước 5 (không bắt buộc): Đọc nội dung quảng cáo

Đối với quảng cáo có sử dụng tính năng Tùy chỉnh tài sản theo vị trí quảng cáo, bạn phải truy xuất các trường nội dung liên quan đến Instagram thông qua {ad-account-id}/ads. Ví dụ:

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