Marketing API

Iklan Shops

Iklan Shops adalah solusi yang meningkatkan kinerja iklan Anda dengan mengarahkan calon pelanggan ke situs web atau toko Anda, tergantung tempat yang menurut kami lebih berpotensi menghasilkan pembelian.

Sebelum memulai

Untuk membuat iklan penjualan atau konversi katalog produk menggunakan situs web dan lokasi konversi toko, Anda memerlukan:

  • Toko yang menggunakan Proses Pembayaran dengan Facebook dan Instagram.
  • Halaman Facebook atau akun Instagram yang terhubung ke toko Anda.
  • Katalog yang terhubung ke toko Anda. Lihat dokumentasi Kolom Katalog untuk mengetahui kolom yang diperlukan untuk perdagangan dan iklan.
  • Kelayakan perdagangan untuk Iklan Shops.

Langkah 1: Buat kampanye

Mulailah dengan membuat kampanye iklan Anda dengan permintaan POST ke /act_{ad_account_id}/campaigns.

Pada tingkat ini, Anda harus mengatur target iklan Anda melalui kolom tujuan. Untuk iklan Shops, tujuan yang didukung adalah PRODUCT_CATALOG_SALES dan CONVERSIONS untuk selain Pengalaman Iklan Berbasis Hasil (ODAX) dan tujuan OUTCOME_SALES untuk ODAX.

  • Untuk tujuan PRODUCT_CATALOG_SALES, promoted_object adalah ID katalog produk. Perhatikan bahwa katalog produk harus dihubungkan ke toko di situs agar memenuhi syarat untuk iklan Shops.
  • Untuk tujuan CONVERSIONS, kolom promoted_object tidak wajib diisi.

Contoh untuk tujuan non-ODAX

Contoh membuat kampanye dengan tujuan PRODUCT_CATALOG_SALES

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Contoh membuat kampanye dengan tujuan CONVERSIONS

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=CONVERSIONS' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Contoh untuk tujuan ODAX

Contoh membuat kampanye PRODUCT_CATALOG_SALES dengan tujuan OUTCOME_SALES

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \ 
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Contoh membuat kampanye CONVERSIONS dengan tujuan OUTCOME_SALES

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]'
  -F 'access_token=<ACCESS_TOKEN>' \ 
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Langkah 2: Buat set iklan

Untuk iklan Shops, Anda harus menentukan jenis destinasi sebagai SHOP_AUTOMATIC untuk set iklan Anda.

  • Jika tujuan kampanye diatur ke PRODUCT_CATALOG_SALES, Anda harus memberikan ID set produk di promoted_object untuk mempromosikan produk dari set produk tersebut.
  • Jika objek kampanye diatur ke CONVERSIONS, tentukan promoted_object Anda sebagai akun perdagangan yang mengaktifkan proses pembayaran di situs.

Persyaratan lain untuk iklan Shops:

  • Iklan Shops hanya mendukung PURCHASE sebagai peristiwa konversi (CUSTOM_EVENT_TYPE) di set produk (jika tujuannya adalah PRODUCT_CATALOG_SALES) atau di Meta Pixel (jika tujuannya adalah CONVERSIONS).
  • Iklan Shops hanya mendukung pengoptimalan untuk konversi di luar situs (OFFSITE_CONVERSIONS sebagai optimization_goal).
  • Iklan Shops hanya mendukung strategi tawaran tanpa batas biaya.
  • Agar iklan Shops dapat ditayangkan ke toko, penargetan harus menyertakan pemirsa di wilayah yang mendukung proses pembayaran di situs (saat ini, Amerika Serikat).
  • Agar iklan Shops dapat ditayangkan ke toko, penempatannya harus menyertakan setidaknya satu platform dengan dukungan proses pembayaran di situs (saat ini, Facebook dan Instagram).

Contoh membuat set iklan Shops dengan kampanye yang mempunyai tujuan PRODUCT_CATALOG_SALES yang ditagih di IMPRESSIONS

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]} }' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>","custom_event_type": "PURCHASE"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Contoh membuat set iklan Shops dengan kampanye yang mempunyai tujuan CONVERSIONS, yang ditagih di IMPRESSIONS

curl \
  -F 'name=Conversion Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}}' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"omnichannel_object":{"onsite":[{"commerce_merchant_settings_id":"<COMMERCE_ACCOUNT_ID>"}],
  "pixel":[{"pixel_id": "<PIXEL_ID>","custom_event_type": "PURCHASE"}]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<D_ACCOUNT_ID>/adsets

Langkah 3: Sediakan materi iklan

Dengan set iklan Shops, Anda dapat membuat

Iklan Shops tidak mendukung hal-hal berikut ini:

  • Format iklan gambar/video jika tujuan kampanye adalah PRODUCT_CATALOG_SALES
  • Format iklan koleksi
  • Ajakan bertindak yang diatur untuk mengirim pesan ke Halaman, Instagram, atau WhatsApp
  • Destinasi yang diatur ke aplikasi, peristiwa, atau Instant Experiences ketika tujuannya adalah CONVERSIONS

Iklan Carousel atau Iklan Gambar/Video

Anda dapat membuat iklan carousel seperti halnya iklan non-Shops. Jika tujuan kampanye Anda adalah CONVERSIONS, Anda juga dapat membuat iklan image/video.

page_id dan/atau instagram_actor_id yang ditentukan dalam object_story_spec harus memiliki setidaknya satu toko yang termasuk dalam akun perdagangan yang Anda pilih untuk dipromosikan dalam set iklan atau katalog yang Anda pilih untuk dipromosikan dalam kampanye. Toko tersebut juga harus terhubung ke akun perdagangan yang sama.

Selain untuk iklan Shops, Anda perlu menentukan destinasi di situs sebagai destinasi alternatif untuk halaman tujuan di luar situs Anda. Untuk melakukannya, atur kolom onsite_destination di asset_feed_spec materi iklan Anda.

Destinasi di situs haruslah salah satu dari:

  • Halaman etalase toko
    Toko harus termasuk dalam akun perdagangan yang Anda promosikan di set iklan Anda.

  • Set produk
    Set produk harus termasuk dalam katalog akun perdagangan yang Anda promosikan di set iklan Anda dan harus berisi setidaknya satu produk yang terlihat dalam stok.

  • Produk
    Produk harus termasuk dalam katalog akun perdagangan yang Anda promosikan di set iklan Anda.

Contoh kolom onsite_destinations di asset_feed_spec yang diatur ke halaman etalase toko

asset_feed_spec= {
  "onsite_destinations": [
    {
      "storefront_shop_id": "<SHOP_STOREFRONT_ID>"
    }
  ]
}

Contoh kolom onsite_destinations di asset_feed_spec yang diatur ke set produk

asset_feed_spec= {
  "onsite_destinations": [
    {
      "shop_collection_product_set_id": "<PRODUCT_SET_ID>"
    }
  ]
}

Contoh kolom onsite_destinations di asset_feed_spec yang diatur ke produk tertentu

asset_feed_spec= {
  "onsite_destinations": [
    {
      "details_page_product_id": "<PRODUCT_ID>"
    }
  ]
}

Contoh materi iklan untuk iklan gambar

curl \
  -F 'name=Sample Creative' \
  -F 'asset_feed_spec= {
        "onsite_destinations": [
          {
            "storefront_shop_id": "<SHOP_STOREFRONT_ID>"
          }
        ]
      }' \
  -F 'object_story_spec={ 
    "link_data": { 
      "image_hash": "<IMAGE_HASH>", 
      "link": "<OFFSITE_LANDING_URL>", 
      "message": "try it out" 
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_OUT"
        }
      }
    }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Iklan katalog Advantage+ dengan format carousel

Untuk membuat iklan carousel yang mempromosikan produk dari set produk, Anda dapat mengikuti Memulai Iklan Katalog Advantage+ - Langkah 3: Sediakan Materi Iklan.

page_id dan/atau instagram_actor_id yang ditentukan dalam object_story_spec harus memiliki setidaknya satu toko yang termasuk dalam akun perdagangan yang Anda pilih untuk dipromosikan dalam set iklan atau katalog yang Anda pilih untuk dipromosikan dalam kampanye. Toko tersebut juga harus terhubung ke akun perdagangan yang sama.

Untuk set produk dalam materi iklan:

  • Jika Anda menyiapkan kampanye dengan PRODUCT_CATALOG_SALES sebagai tujuan, set produk yang Anda pilih harus termasuk dalam katalog yang Anda atur di kampanye Anda dan harus sama dengan set produk yang Anda pilih untuk dipromosikan di set iklan Anda.
  • Jika Anda menyiapkan kampanye dengan CONVERSIONS sebagai tujuan, set produk yang Anda pilih harus termasuk dalam katalog akun perdagangan yang Anda pilih untuk dipromosikan di set iklan.

Fitur tambahan yang didukung untuk iklan Shops adalah pengoptimalan untuk toko. Jika kami merasa hal tersebut dapat meningkatkan performa iklan Anda, kami akan secara otomatis menambahkan pengoptimalan yang berbeda ke iklan Anda. Untuk menggunakan fitur pengoptimalan, atur shops_bundle ke true dalam asset_feed_spec materi iklan Anda (Hal ini mencakup label produk otomatis dan alasan berbelanja saat ini, dan kemungkinan pengoptimalan lainnya di masa mendatang.)

Pengoptimalan toko yang didukung saat ini adalah:

  • Label produk otomatis: Kami dapat secara otomatis menandai produk di iklan Anda. Label produk mengirim orang langsung ke halaman produk yang relevan di toko Anda.
  • Alasan berbelanja: Kami dapat secara otomatis menyoroti informasi produk dari toko Anda, seperti "Gratis ongkir", "Sedang tren", atau "Stok sedikit". Kami juga dapat menambahkan promo yang sudah ada, yang memungkinkan pelanggan dengan produk pilihan di toko Anda.

Untuk menggunakan label produk otomatis, atur automated_product_tags ke true dalam template_data pada object_story_spec. Untuk menggunakan alasan berbelanja, atur reasons_to_shop ke true dalam asset_feed_spec materi iklan Anda.

Contoh iklan carousel yang mempromosikan set produk dengan pilihan untuk menggunakan pengoptimalan toko yang sepenuhnya otomatis


Menggunakan shops_bundle

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
        "shops_bundle": true
      }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Menggunakan automated_product_tags

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'object_story_spec={ 
    "template_data": {
      "automated_product_tags": true
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>"
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Menggunakan reasons_to_shop

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
        "reasons_to_shop": true
      }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Catatan:

  • Iklan Shops tidak mendukung kategori untuk iklan katalog Advantage+.
  • Pengoptimalan label produk otomatis hanya didukung di Instagram.

Materi iklan Advantage+ untuk katalog

Iklan Shops juga mendukung materi iklan Advantage+ untuk katalog. Fitur ini menampilkan format dan materi iklan yang berbeda ke akun Pusat Akun yang berbeda berdasarkan apa yang paling mungkin mereka tanggapi.

Anda dapat mengikuti petunjuk di Materi Iklan Advantage+ untuk Katalog - Langkah 3: Sediakan Materi Iklan untuk menyiapkan materi iklan Anda.

page_id dan/atau instagram_actor_id yang ditentukan dalam object_story_spec harus memiliki setidaknya satu toko yang termasuk dalam akun perdagangan yang Anda pilih untuk dipromosikan dalam set iklan atau katalog yang Anda pilih untuk dipromosikan dalam kampanye. Toko tersebut juga harus terhubung ke akun perdagangan yang sama.

Untuk set produk dalam materi iklan:

  • Jika Anda menyiapkan kampanye dengan PRODUCT_CATALOG_SALES sebagai tujuan, set produk yang Anda pilih harus termasuk dalam katalog yang Anda atur di kampanye Anda dan harus sama dengan set produk yang Anda pilih untuk dipromosikan di set iklan Anda.
  • Jika Anda menyiapkan kampanye dengan CONVERSIONS sebagai tujuan, set produk yang Anda pilih harus termasuk dalam katalog akun perdagangan yang Anda pilih untuk dipromosikan di set iklan Anda.

Contoh materi iklan Advantage+ untuk katalog

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
    "optimization_type":"FORMAT_AUTOMATION",
    "ad_formats": ["CAROUSEL", "COLLECTION"],
    "images": [{"hash": "<CUSTOMIZED_IMAGE_HASH>"}],
    "descriptions": [{"text": "{{product.description}}", "From {{product.current_price}}", ...]
    } 
   }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    “instagram_actor_id” : “<INSTAGRAM_ACTOR_ID>” 
  }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_OUT"
        }
      }
    }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Langkah 4: Buat iklan

Terakhir, Anda dapat membuat iklan yang merujuk pada materi iklan.

curl \
-F 'status=PAUSED' \
-F 'name=Test' \
-F 'adset_id=<ADSET_ID>' \
-F 'creative= {
       "creative_id": "<CREATIVE_ID>"
    },
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

Iklan Shops dengan Kampanye Belanja Advantage+

Iklan Shops didukung bersama dengan kampanye belanja Advantage+, yang diyakini dapat mendorong kinerja yang lebih baik jika digabungkan.

Untuk membuat kampanye belanja Advantage+ dengan iklan Shops, ikuti langkah-langkah di Kampanye Belanja Advantage+ - Langkah 2: Buat Kampanye untuk membuat kampanye terlebih dahulu.

Saat membuat set iklan untuk kampanye belanja Advantage+ dengan iklan Shops, mirip dengan iklan Shops sendiri, atur destination_type menjadi SHOP_AUTOMATIC dan tentukan akun perdagangan Anda di promoted_object.

curl \
  -F 'name=Advantage+ Shopping Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}}' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"omnichannel_object":{"onsite":[{"commerce_merchant_settings_id":"<COMMERCE_ACCOUNT_ID>"}],"pixel":[{"pixel_id": "<PIXEL_ID>","custom_event_type": "PURCHASE"}]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Lihat Pengoptimalan Konversi Lintas Saluran untuk Kampanye Belanja Advantage+ untuk mendapatkan informasi selengkapnya.

Saat membuat materi iklan dan iklan untuk kampanye belanja Advantage+ dengan iklan Shops, spesifikasinya sama dengan iklan Shops itu sendiri. Lihat Langkah 3: Sediakan materi iklan di atas untuk mengetahui detail selengkapnya.

Kelayakan Perdagangan untuk Iklan Shops

Untuk mendapatkan ID yang relevan untuk iklan Shops, Anda memerlukan izin catalog_management dari klien Anda.

Untuk membuat iklan Shops untuk Halaman, Halaman harus memiliki toko yang terlihat di situs. Anda bisa mendapatkannya dari

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,shops{id,fb_sales_channel{status,fb_page{id,name}},is_onsite_enabled,shop_status}&access_token=<PAGE_ACCESS_TOKEN>"

Contoh Tanggapan

{
  "id":"<commerce_account_id>",
  "shops": {
    "data": [
      {
        "fb_sales_channel": {
          "status": "STAGING",
          "fb_page": {
            "name": "Page 1",
            "id": "<page_id>"
          }
        },
        "id": "<shop_id_1>",
        "is_onsite_enabled": true,
        "shop_status": "INACTIVE"
      },
      {
        "fb_sales_channel": {
          "status": "ENABLED",
          "fb_page": {
            "name": "Page 2",
            "id": "<page_id>"
          }
        },
        "id": "<shop_id_2>",
        "is_onsite_enabled": true,
        "shop_status": "ACTIVE"
      }
    ],    
    // …
}

Untuk Halaman yang ingin Anda gunakan untuk membuat iklan Shops, periksa apakah is_onsite_enabled adalah true dan shop_status adalah ACTIVE. Jika demikian, Anda akan dapat membuat iklan Shops untuk Halaman melalui petunjuk di bagian selanjutnya dari panduan ini.

Dapatkan ID Perdagangan untuk Membuat Iklan Shops

Untuk membuat iklan Shops untuk Halaman, Anda memerlukan:

Anda bisa mendapatkan ID Akun Perdagangan dan ID Toko dengan menjalankan kueri sebelumnya.

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,shops{id,fb_sales_channel{fb_page{id,name}}}&access_token=<PAGE_ACCESS_TOKEN>"

Akun perdagangan mungkin memiliki banyak toko, Anda harus mempunyai satu toko dengan Halaman yang akan Anda gunakan untuk membuat iklan Shops.

Untuk ID katalog, ID set produk, dan ID produk

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,product_catalogs{id,product_sets}&access_token=<PAGE_ACCESS_TOKEN>"

Contoh Tanggapan

{
  "id": "<commerce_account_id>",
  "product_catalogs": {
    "data": [
      {
        "id": "<product_catalog_id>",
        "product_sets": {
          "data": [
            {
              "id": "<product_set_id>",
              "name": "Product Set 1",
              "filter": "{\"product_item_id\":{\"is_any\":[]}}"
            },
          ],
        }
      }
    ]
  }
}