Materi Iklan

Penyesuaian Aset Penempatan

Gunakan solusi ini untuk menyesuaikan aset materi iklan yang ditampilkan dalam beragam penempatan iklan. Pertahankan kontrol atas materi iklan, saat menggunakan beberapa penempatan yang berbeda.

Penyesuaian Aset Penempatan adalah salah satu dari tiga API kami yang menggunakan aturan penyesuaian aset. Pelajari selengkapnya tentang Aturan Penyesuaian Aset.

Memulai

Penyesuaian Aset Penempatan dengan postingan yang sudah ada tidak lagi didukung melalui API. Anda hanya dapat menggunakan opsi ini di Pengelola Iklan.

Langkah 2: Masukkan Materi Iklan

Gunakan asset_feed_spec untuk menyediakan materi iklan. Anda dapat menentukan banyak aset materi iklan untuk setiap jenis aset, termasuk gambar, video, carousel, judul, dan teks isi. Hanya berikan satu deskripsi tautan, karena deskripsi tautan tidak dapat disesuaikan per penempatan.

Untuk menerapkan penyesuaian:

  1. Atur asset_customization_rules di dalam asset_feed_spec Anda.
  2. Untuk setiap aturan, tambahkan customization_spec dan label aset.

Untuk Penyesuaian Aset Penempatan, setiap asset_feed_spec harus memiliki lebih dari satu aturan penyesuaian yang dilampirkan padanya.

Lihat Aturan Penyesuaian Aset.

Properti yang Didukung


Nama Properti Deskripsi

customization_spec

jenis: Kolom yang Didukung

Wajib.

Penempatan yang hendak menampilkan aset.

image_label

format: {"name": "{LABEL_NAME}"}

Wajib untuk format SINGLE_IMAGE.

Label gambar yang ingin ditampilkan. Dilampirkan ke aset gambar di asset_feed_spec.

video_label

format: {"name": "{LABEL_NAME}"}

Wajib untuk format SINGLE_VIDEO.

Label video yang ingin Anda tampilkan. Dilampirkan ke aset video di asset_feed_spec.

carousel_label
format: {"name": "{LABEL_NAME}"}

Wajib untuk format CAROUSELS.

Label carousel yang ingin ditampilkan. Dilampirkan ke aset carousel di asset_feed_spec.

Catatan: jika menyediakan carousel melalui Penyesuaian Aset Penempatan, semua lampiran turunan harus ditentukan dalam Spesifikasi Kabar Aset dan direferensikan melalui label iklan. Lampiran turunan tidak dapat didefinisikan dalam satu baris. Lihat Opsi Spesifikasi Kabar Aset untuk detil selengkapnya tentang format carousels.

Kolom yang Didukung dalam customization_spec


Nama Properti Deskripsi

publisher_platforms

Wajib.

Kemungkinan penempatan untuk iklan Anda. Opsi: facebook, instagram, messenger, dan audience_network.

facebook_positions

Opsional, tetapi menjadi wajib jika Facebook dipilih dalam publisher_platforms.

Penempatan khusus Facebook. Opsi: feed, right_hand_column, marketplace, video_feeds, search, dan story.

instagram_positions

Opsional, tetapi menjadi wajib jika Instagram dipilih dalam publisher_platforms.

Penempatan khusus Instagram. Opsi: stream, story, explore, explore_home, profile_feed, dan ig_search.

Catatan: Penempatan explore_home hanya mendukung format SINGLE_IMAGE.

messenger_positions

Opsional, tetapi menjadi wajib jika Messenger dipilih dalam publisher_platforms.

Penempatan khusus Messenger. Opsi: messenger_home, sponsored_messages, dan story.

audience_network_positions

Opsional, tetapi menjadi wajib jika Audience Network dipilih dalam publisher_platforms.

Penempatan khusus Audience Network. Opsi: classic, instream_video, dan rewarded_video.

Pelajari selengkapnya tentang opsi penempatan yang tersedia.

Contoh — Pengaturan Feed

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

Contoh — Penyesuaian Aset beranda Jelajahi 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

Contoh — Penyesuaian Aset hasil pencarian 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

Lihat semua opsi yang tersedia untuk Spesifikasi Kabar Aset.

Langkah 5 Opsional: Baca Materi Iklan

Untuk iklan Penyesuaian Aset Penempatan, kolom materi iklan terkait Instagram harus diambil melalui {ad-account-id}/ads. Contoh:

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