Memulai Iklan Katalog Advantage+

Iklan katalog Advantage+ memungkinkan Anda membuat iklan yang dipersonalisasi yang menargetkan pemirsa yang tepat berdasarkan set produk.

Sebelum Memulai

Untuk membuat kampanye iklan katalog Advantage+, Anda perlu:

• Halaman Facebook mewakili pengiklan, dan secara opsional, Akun Instagram jika menjalankan kampanye ini di Instagram.
• Akun iklan dengan informasi pembayaran yang terdaftar.
• Katalog, seperti katalog produk yang tersedia di akun Pengelola Bisnis Anda.

Secara opsional, Anda dapat menyiapkan pemirsa dinamis, tetapi Anda tidak diharuskan untuk melibatkan penyertaan atau pengecualian set produk dalam pengaturan penargetan Anda.

Langkah 1: Buat Kampanye Iklan

Lihat dokumentasi Kampanye Iklan untuk mempelajari cara membuat kampanye iklan.

Di level ini, Anda harus mengatur tujuan periklanan Anda melalui kolom objective. Untuk iklan katalog Advantage+, tujuan yang didukung adalah PRODUCT_CATALOG_SALES, CONVERSIONS, LINK_CLICKS, atau APP_INSTALLS. Jika objective yang Anda sediakan adalah CONVERSIONS, LINK_CLICKS, atau APP_INSTALLS, maka kolom promoted_object tidak diperlukan.

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

Langkah 2: Buat Set Iklan

Untuk iklan katalog Advantage+, Anda harus menentukan product_set_id dalam promoted_object untuk level set iklan Anda guna mempromosikan produk dari set produk tersebut.

Selain itu, Anda juga bisa menentukan peristiwa konversi untuk set produk tersebut dengan menentukan custom_event_type di promoted_object saat optimization_goal dalam OFFSITE_CONVERSIONS. Pilihan ini menargetkan iklan Anda kepada orang-orang yang melakukan peristiwa tersebut di aplikasi atau situs Anda.

Contoh: jika Anda menetapkannya ke ADD_TO_CART, berarti peristiwa Penambahan ke Keranjang Belanja adalah peristiwa konversi. Secara default, custom_event_type diatur ke PURCHASE. Pelajari selengkapnya tentang peristiwa standar dan nilai untuk custom_event_type di Pelacakan Konversi Meta Pixel.

Jika Anda ingin mengoptimalkan konversi di luar situs, termasuk konversi untuk peristiwa aplikasi dan Meta Pixel, dan ditagih untuk impresi:

• Atur optimization_goal ke OFFSITE_CONVERSIONS
• Atur billing_event ke IMPRESSIONS

Detail selengkapnya tentang kombinasi optimization_goal dan billing_event dapat ditemukan di Pengoptimalan Target dan Peristiwa Tagihan.

Contoh pembuatan set iklan yang ditagihkan di IMPRESSIONS dan pengoptimalan untuk OFFSITE_CONVERSIONS:

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

DYNAMIC_AUDIENCE_ID merujuk ke pemirsa produk. Secara opsional, dynamic_audience_ids dapat dihilangkan dari panggilan.

Contoh: untuk kasus penggunaan e-commerce, Anda dapat menghilangkan dynamic_audience_ids dari panggilan dan sebagai gantinya mengirimkan informasi penargetan perilaku sebagai bagian dari parameter product_audience_specs atau excluded_product_audience_specs. Spesifikasi ini ditentukan oleh parameter yang sama dengan yang Anda gunakan untuk membuat pemirsa produk.

Parameter

Penargetan Ulang

Dalam contoh ini, kami menargetkan orang-orang yang melihat produk dalam 3-5 hari terakhir, tetapi belum membeli. Penempatan iklan adalah di beranda seluler dan Audience Network. Untuk membuat pemirsa ini:

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=LINK_CLICKS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "publisher_platforms": ["facebook","audience_network"], 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"ViewContent"}}}], 
        "exclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":259200,"rule":{"event":{"eq":"ViewContent"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":<PRODUCT_SET_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Cross-Selling atau Upsell

Contoh mengiklankan produk yang belum dilihat oleh pengguna:

curl \
-F 'name=Case 1 Adset' \
-F 'bid_amount=3000' \
-F 'billing_event=IMPRESSIONS' \
-F 'status=ACTIVE' \
-F 'daily_budget=15000' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'targeting= { \
            "geo_locations": { \
            "countries":["US"], \
             }, \
            "interests":[ \
                {"id":6003397425735,"name":"Tennis"}, \
            ], \
        }' \
-F 'promoted_object={"product_set_id”:<PRODUCT_SET_ID>}' \
-F 'access_token=<ACCESS_TOKEN>’ \
https://graph.facebook.com/<API_VERSION>/act_<ACCOUNT_ID>/adsets

Untuk melakukan cross-selling antara set produk:

• Sediakan pemirsa produk dengan aturan peristiwa yang berkaitan dengan set produk A.
• Perlihatkan produk dari set produk B di iklan tersebut dengan mengatur product_set_id ke set produk B pada level materi iklan.

Contoh: sebuah bisnis ingin meningkatkan penjualan tas tangan di PRODUCT_SET_1 dengan menargetkan iklan kepada pengguna yang sudah menunjukkan minat pada sepatu yang termasuk dalam PRODUCT_SET_2. Atur product_set_id di product_audience_specs ke ID PRODUCT_SET_2 atau sepatu, dan product_set_id di promoted_object ke ID PRODUCT_SET_1 atau tas tangan.

curl \
  -F 'name=My cross sell ad set' \
  -F 'bid_amount=3000' \
  -F 'billing_event=LINK_CLICKS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_2_ID>", 
        "inclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"ViewContent"}}}], 
        "exclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_2_ID>", 
        "inclusions": [{"retention_seconds":259200,"rule":{"event":{"eq":"ViewContent"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_1_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets  

Dan atur product_set_id di materi iklan sebagai ID PRODUCT_SET_1.

  curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Penargetan Pemirsa Luas

Selain penargetan ulang dan cross-selling kepada pelanggan yang sudah ada, Iklan Katalog Advantage+ dapat digunakan untuk menargetkan kepada pemirsa yang luas, memanfaatkan usia, jenis kelamin, dan penargetan demografi lainnya, dengan produk-produk yang relevan dari katalog produk Anda. Dengan memanfaatkan pemirsa yang ditargetkan secara luas, dipadukan dengan tawaran konversi di luar situs, iklan katalog Advantage+ memungkinkan Anda memperluas jangkauan iklan Anda secara efisien.

Untuk menargetkan pemirsa luas:

• Buat pemirsa dengan menggunakan penargetan demografi, seperti perempuan di AS berusia di atas 18 tahun.
• Sertakan customOptimize untuk OFFSITE_CONVERSIONS dengan sinyal niat yang lebih kuat seperti Purchase atau InitiateCheckout.

Pada contoh ini, kami membuat set iklan yang ditargetkan kepada perempuan berusia 30-65 yang tinggal di AS, tidak termasuk pelanggan yang pernah membeli dalam 10 hari terakhir. Kami akan menawarkan $8, menggunakan OFFSITE_CONVERSIONS untuk peristiwa PURCHASE.

curl \
  -F 'name=Broad Audience Targeting' \
  -F 'bid_amount=800' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "age_max": 65, 
    "age_min": 30, 
    "geo_locations": {"countries":["US"]}, 
    "genders": [2], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":864000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>","custom_event_type":"PURCHASE"}' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Kategori untuk Iklan Katalog Advantage+

Kategori untuk iklan katalog Advantage+ memperkenalkan dua opsi materi iklan baru untuk platform iklan katalog Advantage+, yang keduanya dapat digunakan untuk mempersonalisasi materi iklan bagi pembeli yang lebih awal dalam perjalanan keputusan mereka. Dengan fitur ini, Anda dapat membuat katalog gambar kedua yang lebih kecil dan mewakili tiap kategori (selain katalog gambar produk yang sudah Anda miliki), dan kami akan mencocokkan kategori produk dengan orang pada iklan dengan cara yang sama kami mencocokkan produk dengan orang.

Kategori untuk iklan katalog Advantage+ dapat digunakan dengan opsi penargetan dengan tujuan traffic, konversi, atau penjualan katalog. Jika Anda tidak memiliki gambar berkualitas tinggi yang dapat mewakili tiap kategori atau merek, Facebook dapat membuat secara otomatis kolase produk terpopuler berukuran 2x2 untuk tiap grup produk.

Saat memetakan gambar baru ini ke katalog produk yang ada, Anda dapat menggunakan salah satu dari tiga kolom di beranda Anda untuk mengelompokkan item: merek, jenis produk, dan kategori produk Google.

Dalam contoh katalog di bawah ini, kolom Jenis Produk memiliki lima nilai unik. Pengiklan dapat menyediakan hingga lima kolase atau gambar gaya hidup — satu untuk setiap nilai unik dalam product_type. Jenis produk adalah kriteria kategorisasi dari kategori, yang merupakan nama kolom katalog yang digunakan untuk menentukan kategori. Nilai kolom katalog adalah nilai kriteria kategori.

Kategori dapat diidentifikasi secara unik oleh:

• ID katalog produk
• Kriteria kategorisasi (merek, jenis produk, atau kategori produk Google)
• Nilai kriteria (diambil dari katalog)

Pengiklan dapat mengaitkan tiap kategori (contoh: tiap grup produk yang ditentukan oleh nilai unik di salah satu kolom yang ditentukan di atas) dengan aset:

• Nama — Nama singkat kategori yang menghadap pengguna (maksimal 40 karakter).
• Deskripsi — Deskripsi kategori yang menghadap pengguna (maksimal 20 karakter).
• destination_uri — URL halaman tujuan saat pengguna mengeklik kategori.
• image_url — Opsional. URL gambar gaya hidup yang mewakili kategori. Jika tidak ada image_url yang diberikan, kami akan membuat secara otomatis kolase produk terpopuler dari kategori tersebut.

Selama waktu penayangan iklan, kami secara dinamis mencocokkan tiap akun Pusat Akun dengan kategori yang kemungkinan besar akan mereka tanggapi berdasarkan model pembelajaran mesin yang sama dengan yang memberdayakan iklan katalog Advantage+ sekarang.

API Pengelolaan Kategori

Informasi kategori disimpan di level katalog, artinya beragam iklan yang mempromosikan kategori dari katalog yang sama akan membagikan aset, sama dengan iklan yang mempromosikan produk akan membagikan aset yang ditentukan di katalog. Kami mendukung berbagai opsi materi iklan untuk menyesuaikan iklan kategori.

Berikut adalah API untuk mendapatkan dan memperbarui informasi kategori.

Membaca

Permintaan

  curl -G \
    -d 'fields=["criteria_value","name","description","destination_uri","image_url"]' \
    -d 'categorization_criteria=product_type' \
    -d 'filter={"price_amount":{"gt":1500}}' \ # optional
    -d 'access_token=<ACCESS_TOKEN>' \
    https://graph.facebook.com/v19.0/<PRODUCT_CATALOG_ID>/categories

Kami meng-kueri semua produk (filter opsional didukung) dan menemukan 1.000 teratas (urutan sesuai jumlah produk).

Contoh tanggapan

{
  "data": [
    {
      "criteria_value": "clothes",
      "name": "Awesome clothes",
      "description": "Check out these awesome clothes!",
      "destination_uri": "http://www.example.com/clothes",
      "image_url": "http://www.example.com/clothes.jpg"
    },
    ...
    {
      "criteria_value": "shoes",
      "name": "Awesome shoes",
      "description": "Check out these awesome shoes!",
      "destination_uri": "http://www.example.com/shoes",
      "image_url": "http://www.example.com/shoes.jpg"
    }
  ]
}

Memperbarui

Anda dapat menentukan beberapa informasi kategori di data. Untuk setiap kategori, categorization_criteria dan criteria_value diperlukan, sedangkan kolom name, description, destination_uri, dan image_url bersifat opsional. Saat pertama kali memperbarui informasi kategori, Anda harus menentukan destination_uri. Jika pengiklan ingin melewati penayangan suatu kategori, cukup kosongi destination_uri.

Catatan: Menghapus kategori tidak didukung untuk saat ini.

Permintaan

curl \
  -F 'data=[{"categorization_criteria":"product_type","criteria_value":"product_type_value","name":"Name","description":"Description","destination_uri":"http://www.example.com/","image_url":"<IMAGE_URL>"}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<lPRODUCT_CATALOG_ID>/categories

Pembuatan Iklan

Kategori untuk pembuatan iklan katalog Advantage+ mirip dengan pembuatan iklan untuk iklan katalog Advantage+ lainnya, tetapi pilihan materi iklan sedikit berbeda. Pengiklan masih mempromosikan set produk dengan iklan kategori dinamis; perbedaannya adalah kami menampilkan materi iklan kategori sebagai gantinya.

curl \
  -F "name=Dynamic Category Ad Creative" \
  -F 'object_story_spec={"page_id": "<PAGE_ID>", "template_data": {"description": "{{category.description}}", "link": "https://www.example.com/", "message": "<MESSAGE>", "name": "{{category.name}}"}}' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'categorization_criteria=brand' \
  -F 'category_media_source=MIXED' \ # optional
  -F access_token=<ACCESS_TOKEN> \
  https://graph.facebook.com/v19.0/act_<ACCOUNT_ID>/adcreatives

Ini membuat materi iklan kategori di-render dalam format carousel:

Token Kategori

Token kategori yang didukung:

• category.name — Nama kategori dalam set produk yang dipromosikan.
• category.description — Deskripsi kategori dalam set produk yang dipromosikan.
• category.destination_uri — URI destinasi kategori.
• category.min_price — Harga minimal untuk kategori ini dalam set produk yang dipromosikan. Informasi ini diambil dari katalog.

Parameter

Nama	Deskripsi
categorization_criteria	Menentukan jenis kategori yang akan digunakan. Values: brand product_type google_product_category
category_media_source	Menentukan cara me-render kartu carousel kategori. Nilai: mixed (default) Menggunakan gambar kategori jika ada; jika tidak, kembali ke products_collage. category Menggunakan gambar kategori. Lewati kategori ini jika kategori ini tidak memiliki gambar. products_collage Membuat kolase gambar produk berukuran 2x2 dari kategori ini. products_slideshow Me-render tayangan slide produk dari kategori ini.

Selama pembuatan materi iklan kategori, kami mencari kategori yang dapat di-render.

Catatan: Kami memfilter kategori tanpa nama atau URL destinasi. Kami juga memfilter kategori tanpa gambar jika category_media_source = category.

Kesalahan Umum

Pembuatan materi iklan gagal jika terdapat kurang dari 4 kategori yang memenuhi syarat (contoh: untuk menggunakan kategori dalam iklan katalog Advantage+ sebagai materi iklan Anda untuk kampanye tertentu, harus ada setidaknya empat nilai unik di kolom tertentu dari file feed data Anda).

Langkah 3: Sediakan Materi Iklan

Template iklan katalog Advantage+ menggunakan postingan halaman inline untuk membuat materi iklan template katalog Advantage+.

Membuat Template Materi Iklan

Membuat materi iklan template iklan katalog Advantage+ mirip dengan membuat materi iklan lainnya. Perbedaannya adalah bahwa Anda dapat menambahkan parameter template yang me-render dengan benar pada runtime berdasarkan data di file feed data Anda.

Buat template berdasarkan objek template_dataobject_story_spec dan gunakan kolom berikut:

Contoh

Membuat template iklan katalog Advantage+ carousel

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Menggunakan template iklan katalog Advantage+ dengan overlay gambar

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}",
      "image_layer_specs": [
        {
          "layer_type": "image",
          "image_source": "catalog"
        },
        {
          "layer_type": "frame_overlay",
          "blending_mode": "lighten",
          "frame_image_hash": "<HASH>",
          "frame_source": "custom",
          "opacity": 100,
          "overlay_position": "center",
          "scale": 100
        },
        {
          "layer_type": "text_overlay",
          "content": {
            "type": "price"
          },
          "opacity": 100,
          "overlay_position": "top_left",
          "overlay_shape": "rectangle",
          "shape_color": "DF0005",
          "text_color": "FFFFFF",
          "text_font": "open_sans_bold"
        }
      ]
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

Membuat template iklan katalog Advantage+ satu produk dengan ajakan bertindak

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "force_single_link": true, 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Membuat template iklan katalog Advantage+ carousel dengan gambar iklan menggunakan gambar pertama dari array gambar tambahan

Untuk melihat pratinjau iklan katalog Advantage+ dengan additional_image_index, Anda harus meneruskan seluruh object_story_spec ke endpoint /generatepreviews. Jika hanya meneruskan object_story_id, pratinjau iklan tidak akan dibuat.

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "additional_image_index": 0, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Membuat template iklan katalog Advantage+ untuk satu produk dengan tiap gambar berasal dari array gambar tambahan di katalog

curl -X POST \
     -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
     -F 'object_story_spec={
           "page_id": <PAGE_ID>,
           "template_data": {
             "message": "Test {{product.name | titleize}}",
             "link": "<YOUR_LINK_URL>",
             "name": "Headline {{product.price}}",
             "description": "Description {{product.description}}",
             "multi_share_end_card": false,
             "force_single_link": true,
             "show_multiple_images": true,
           }
         }' \
     -F 'product_set_id=<PRODUCT_SET_ID>' \
     -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Membuat template iklan katalog Advantage+ carousel dengan kartu pertama sebagai kartu statis kupon

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "child_attachments": [ 
        { 
          "call_to_action": {"type":"SHOP_NOW"}, 
          "description": "30% off", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/coupon", 
          "name": "Coupon Static Card", 
          "static_card": true 
        }, 
        { 
          "call_to_action": {"type":"SHOP_NOW"}, 
          "description": "Description {{product.description}}", 
          "name": "Headline {{product.price}}" 
        } 
      ], 
      "link": "<LINK>", 
      "message": "Test Message" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Membuat tayangan slide carousel dari template iklan katalog Advantage+

Kami me-render tiap kartu dinamis di carousel sebagai tayangan slide. Tiap tayangan slide menampilkan gambar dari satu barang dinamis jika barang tersebut memiliki beberapa gambar. Jika barang dinamis hanya memiliki satu gambar, kami me-render kartu sebagai gambar statis.

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={
    "page_id": "PAGE_ID",
    "template_data": {
      "call_to_action": {"type":"SHOP_NOW"},
      "description": "Description {{product.description}}",
      "link": "LINK",
      "message": "Test {{product.name | titleize}}",
      "name": "Headline {{product.price}}",
      "format_option": "carousel_slideshows"
    }
  }' \
  -F 'product_set_id=PRODUCT_SET_ID' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

Tanggapan terhadap panggilan ini adalah ID dari materi iklan template katalog Advantage+ yang baru.

{"id":"creative_id"}

Mengunggah katalog

Saat mengunggah katalog, Anda dapat menentukan tanda string alfanumerik arbitrer untuk tiap gambar di tiap properti.

<listing>
 <hotel_id>hotel_1</hotel_id>
 ...
 <image>
 <url>https://media-cdn.tripadvisor.com/media/photo-o/05/ca/40/af/the-epiphany-a-joie-de.jpg (https://l.facebook.com/l.php?u=https%3A%2F%2Fmedia-cdn.tripadvisor.com%2Fmedia%2Fphoto-o%2F05%2Fca%2F40%2Faf%2Fthe-epiphany-a-joie-de.jpg&h=ATPTuLcCa7Vsnmn07cEVa0YseTFl1C2hOax9NezejmXDbR48w3CLdjLlwlpuGCRDQmuafQvk03ybGqfhk-2mBcH7xtuKAsnuuq9xKwBd8DwfuBMZkq3n1qX5MdychRKGy2bo2ax9BZQzgqVDY_AvC1EqE6aAdUEc)</url>
 <tag>exterior</tag>
 <tag>first image</tag>
 <tag>tree</tag>
 </image>
 <image>
 <url>http://www3.hilton.com/resources/media/hi/DFWANHH/en_US/img/shared/full_page_image_gallery/main/HH_exteriorview001_1270x560_FitToBoxSmallDimension_Center.jpg (http://l.facebook.com/l.php?u=http%3A%2F%2Fwww3.hilton.com%2Fresources%2Fmedia%2Fhi%2FDFWANHH%2Fen_US%2Fimg%2Fshared%2Ffull_page_image_gallery%2Fmain%2FHH_exteriorview001_1270x560_FitToBoxSmallDimension_Center.jpg&h=ATPTuLcCa7Vsnmn07cEVa0YseTFl1C2hOax9NezejmXDbR48w3CLdjLlwlpuGCRDQmuafQvk03ybGqfhk-2mBcH7xtuKAsnuuq9xKwBd8DwfuBMZkq3n1qX5MdychRKGy2bo2ax9BZQzgqVDY_AvC1EqE6aAdUEc)</url>
 <tag>skyline</tag>
 ...
 </image>
 ...
</listing>

Membuat Materi Iklan

Saat membuat materi iklan, array preferred_image_tags dapat diteruskan dalam object_story_spec.

curl \
 -F 'name=Ad Creative Test'\
 -F 'object_story_spec={
     "page_id": '<PAGE_ID>',
     "template_data": {
       "preferred_image_tags": ["skyline","exterior"],
       "call_to_action": {"type":"BOOK_TRAVEL"},
       "description": "{{hotel.description}}",
       "link": "<URL>",
        "message": "Book your stay in {{hotel.city}}",
        "name": "{{hotel.name | titleize}}"
     }
    }' \
 -F 'product_set_id=<PRODUCT_SET_ID>' \
 -F 'access_token=<ACCESS_TOKEN>' \
 https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Mengaktifkan Video untuk Iklan Katalog Advantage+

Langkah-langkah utama membuat iklan katalog Advantage+ masih sama. Untuk mengaktifkan video, Anda harus menyertakan data video dan menyediakan data tersebut di dalam katalog. Lihat perubahan di bawah yang perlu dilakukan saat Anda membuat atau memperbarui katalog.

Langkah 1: Menyiapkan katalog

Saat Anda menambahkan video ke daftar, kolom url dan tag didukung. Saat ini, hanya satu video yang didukung untuk tiap produk.

<?xml version="1.0" encoding="utf-8"?>
<listings>
  <title>Test hotel feed</title>
  <listing>
    <hotel_id>hotel_1</hotel_id>
    <name>Test Hotel 1</name>
    <description>A very nice hotel</description>
    <brand>Facebook</brand>
    <address format="simple">
      <component name="addr1">180 Hamilton Ave</component>
      <component name="city">Palo Alto</component>
      <component name="city_id">12345</component>
      <component name="region">California</component>
      <component name="postal_code">94301</component>
      <component name="country">United States</component>
    </address>
    <latitude>37.4435997</latitude>
    <longitude>-122.1615219</longitude>
    <neighborhood>Palo Alto</neighborhood>
    <neighborhood>Silicon Valley</neighborhood>
    <margin_level>8</margin_level>
    <base_price>200.5 USD</base_price>
    <phone>+1 650 666-3311</phone>
    <star_rating>2.5</star_rating>
    <guest_rating>
      <score>7.8</score>
      <rating_system>tripAdvisor</rating_system>
      <number_of_reviewers>300</number_of_reviewers>
    </guest_rating>
    <guest_rating>
      <score>9.8</score>
      <rating_system>Hotels.com</rating_system>
      <number_of_reviewers>35000</number_of_reviewers>
    </guest_rating>
    <image>
      <url>https://media-cdn.tripadvisor.com/media/photo-o/05/ca/40/af/the-epiphany-a-joie-de.jpg</url>
      <tag>front view</tag>
      <tag>first image</tag>
    </image>
    <image>
      <url>http://www.jdvhotels.com/content/uploads/2014/06/72-1200x800.jpg</url>
      <tag>room</tag>
      <tag>bed</tag>
    </image>
    <loyalty_program>Starwood</loyalty_program>
    <url>http://www.jdvhotels.com/hotels/california/silicon-valley-hotels/the-epiphany-hotel/</url>
    <applink property="ios_url" content="example-ios://electronic"/>
    <applink property="ios_app_store_id" content="42"/>
    <applink property="ios_app_name" content="Electronic Example iOS"/>
*    <video>
      <url>http://example.com/some_video1.mp4</url>
      <tag>City</tag>
      <tag>Package</tag>
    </video>*
  </listing>
</listings>

Spesifikasi video

Langkah 2: Gunakan API untuk mendapatkan metadata video untuk pemecahan masalah

Anda bisa menggunakan API untuk memeriksa data yang diunggah. Untuk setiap item, izinkan meng-kueri "metadata video"-nya.

Permintaan

curl -i -X GET \
 "https://graph.intern.facebook.com/v19.0/1234567890?fields=videos_metadata.fields(video,tags,url)&access_token=<ACCESS TOKEN>"

Contoh tanggapan

Langkah 3: Aktifkan video dalam iklan atau materi iklan

Untuk mengaktifkan konten video di level produk dalam iklan, lihat dokumentasi Buat Iklan dengan Media Dinamis.

Pelacakan Klik dan Template

Jika Anda melacak klik tautan melalui pelacak klik pihak ketiga sebelum mengarahkan ke URL produk akhir, Anda dapat menggunakan kolom template_url_spec dalam materi iklan. Hal ini memungkinkan untuk menambahkan template pelacak klik ke level iklan tanpa perlu membuat kode keras di file feed data Anda. Anda juga dapat menggunakan kolom ini untuk membuat template untuk tautan dalam.

Dalam kolom ini, Anda bisa menggunakan kolom dinamis seperti URL atau ID produk, dan harus berenkode URL jika nilainya bisa berisi karakter yang membuat URL tidak valid.

Contoh

Untuk membuat template iklan katalog Advantage+ carousel dengan pengaturan template_url_spec:

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<URL>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'template_url_spec={ 
    "ios": { 
      "app_store_id": "123", 
      "url": "example:\/\/link\/?nav=item.view&id={{product.retailer_id | urlencode}}&referrer=http:\/\/rover.example.com\/rover\/1\/711-198453-24755-9\/16%3Fitemid={{product.retailer_id | urlencode | urlencode}}" 
    }, 
    "web": { 
      "url": "http:\/\/clicktrack.com\/cm325?id={{product.retailer_id | urlencode}}&redirect_url={{product.url | urlencode | urlencode}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Menggunakan File Feed Data di Template Anda

Saat iklan ditampilkan, Facebook menggantikan konten di bagian {{ }} dengan nilai yang tepat dari file feed data Anda. Nilai template yang tersedia adalah:

Opsi

Beberapa nilai template mungkin menerima opsi, dengan urutan tertentu, dalam format berikut:

{{field option1 option2 ...}}

Opsi berikut tersedia:

Transformasi

Anda dapat membuat nilai template dengan transformasi yang menyesuaikan nilai berdasarkan format ini:

{{field | transform}}

Gunakan salah satu transformasi ini:

Menentukan Perilaku Klik Iklan yang Diinginkan dari Seluler

Saat menampilkan materi iklan dinamis, Anda bisa menentukan perilaku yang diinginkan saat seseorang mengeklik iklan di aplikasi Facebook native. Ada dua persyaratan untuk dapat menggunakan penautan dalam:

1. Aplikasi seluler native di mana pengguna harus dikirimkan untuk mendukung penautan dalam (iOS atau Android).
2. Informasi tautan dalam sudah disertakan dalam file feed data atau informasi tautan dalam tersedia melalui Tautan Aplikasi.

Jika kedua persyaratan ini terpenuhi, Anda bisa menggunakan kolom applink_treatment saat membuat materi iklan untuk menentukan perilaku yang diinginkan saat pengguna mengeklik iklan.

Contoh

Membuat template iklan katalog Advantage+ carousel dengan ajakan bertindak yang akan tertaut dalam ke aplikasi native jika tersedia atau fall back ke web:

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'applink_treatment=deeplink_with_web_fallback' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Contoh untuk membuat template iklan katalog Advantage+ carousel dengan tanda URL diaktifkan yang akan menautkan dalam ke aplikasi native jika tersedia atau fall back ke app store untuk aplikasi:

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'applink_treatment=deeplink_with_appstore_fallback' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Membuat Katalog yang Dilokalkan untuk Iklan Katalog Advantage+

Lihat detailnya di Katalog yang Dilokalkan untuk Iklan Katalog Advantage+.

Langkah 4: Buat Iklan

Akhirnya, Anda bisa membuat iklan Dinamis. Iklan mereferensikan materi iklan.

Contoh

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

'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const AdAccount = bizSdk.AdAccount;
const Ad = bizSdk.Ad;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<AD_ACCOUNT_ID>';
const api = bizSdk.FacebookAdsApi.init(access_token);
const showDebugingInfo = true; // Setting this to true shows more debugging info.
if (showDebugingInfo) {
  api.setDebug(true);
}

const logApiCallResult = (apiCallName, data) => {
  console.log(apiCallName);
  if (showDebugingInfo) {
    console.log('Data:' + JSON.stringify(data));
  }
};

let fields, params;
fields = [
];
params = {
  'name' : 'My Ad',
  'adset_id' : '<adSetID>',
  'creative' : {'creative_id':'<adCreativeID>'},
  'status' : 'PAUSED',
};
const ads = (new AdAccount(id)).createAd(
  fields,
  params
);
logApiCallResult('ads api call complete.', ads);

require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\Ad;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

$access_token = '<ACCESS_TOKEN>';
$app_secret = '<APP_SECRET>';
$app_id = '<APP_ID>';
$id = '<AD_ACCOUNT_ID>';

$api = Api::init($app_id, $app_secret, $access_token);
$api->setLogger(new CurlLogger());

$fields = array(
);
$params = array(
  'name' => 'My Ad',
  'adset_id' => '<adSetID>',
  'creative' => array('creative_id' => '<adCreativeID>'),
  'status' => 'PAUSED',
);
echo json_encode((new AdAccount($id))->createAd(
  $fields,
  $params
)->exportAllData(), JSON_PRETTY_PRINT);

from facebook_business.adobjects.adaccount import AdAccount
from facebook_business.adobjects.ad import Ad
from facebook_business.api import FacebookAdsApi

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'
FacebookAdsApi.init(access_token=access_token)

fields = [
]
params = {
  'name': 'My Ad',
  'adset_id': '<adSetID>',
  'creative': {'creative_id':'<adCreativeID>'},
  'status': 'PAUSED',
}
print AdAccount(id).create_ad(
  fields=fields,
  params=params,
)

import com.facebook.ads.sdk.*;
import java.io.File;
import java.util.Arrays;

public class SAMPLE_CODE_EXAMPLE {
  public static void main (String args[]) throws APIException {

    String access_token = \"<ACCESS_TOKEN>\";
    String app_secret = \"<APP_SECRET>\";
    String app_id = \"<APP_ID>\";
    String id = \"<AD_ACCOUNT_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new AdAccount(id, context).createAd()
      .setName(\"My Ad\")
      .setAdsetId(<adSetID>L)
      .setCreative(
          new AdCreative()
            .setFieldId(\"<adCreativeID>\")
        )
      .setStatus(Ad.EnumStatus.VALUE_PAUSED)
      .execute();

  }
}

require 'facebook_ads'

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'

FacebookAds.configure do |config|
  config.access_token = access_token
  config.app_secret = app_secret
end

ad_account = FacebookAds::AdAccount.get(id)
ads = ad_account.ads.create({
    name: 'My Ad',
    adset_id: '<adSetID>',
    creative: {'creative_id':'<adCreativeID>'},
    status: 'PAUSED',
})

Selamat! Anda telah membuat iklan katalog Advantage+ pertama Anda. Anda bisa melanjutkan jeda untuk melanjutkan penayangan iklan kapan saja.

Langkah Berikutnya

Pratinjau Iklan Katalog Advantage+

Anda dapat membuat pratinjau materi iklan dinamis Anda dengan API Pratinjau Iklan. Tentukan parameter product_item_ids atau tentukan beberapa product_item_ids untuk melihat pratinjau iklan carousel.

curl -X GET \
  -d 'ad_format="DESKTOP_FEED_STANDARD"' \
  -d 'product_item_ids=[
       "<PRODUCT_ITEM_ID>"
     ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<CREATIVE_ID>/previews

'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const AdCreative = bizSdk.AdCreative;
const AdPreview = bizSdk.AdPreview;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<AD_CREATIVE_ID>';
const api = bizSdk.FacebookAdsApi.init(access_token);
const showDebugingInfo = true; // Setting this to true shows more debugging info.
if (showDebugingInfo) {
  api.setDebug(true);
}

const logApiCallResult = (apiCallName, data) => {
  console.log(apiCallName);
  if (showDebugingInfo) {
    console.log('Data:' + JSON.stringify(data));
  }
};

let fields, params;
fields = [
];
params = {
  'ad_format' : 'DESKTOP_FEED_STANDARD',
  'product_item_ids' : ['<productItemID>'],
};
const previewss = (new AdCreative(id)).getPreviews(
  fields,
  params
);
logApiCallResult('previewss api call complete.', previewss);

require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\AdCreative;
use FacebookAds\Object\AdPreview;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

$access_token = '<ACCESS_TOKEN>';
$app_secret = '<APP_SECRET>';
$app_id = '<APP_ID>';
$id = '<AD_CREATIVE_ID>';

$api = Api::init($app_id, $app_secret, $access_token);
$api->setLogger(new CurlLogger());

$fields = array(
);
$params = array(
  'ad_format' => 'DESKTOP_FEED_STANDARD',
  'product_item_ids' => array('<productItemID>'),
);
echo json_encode((new AdCreative($id))->getPreviews(
  $fields,
  $params
)->getResponse()->getContent(), JSON_PRETTY_PRINT);

from facebook_business.adobjects.adcreative import AdCreative
from facebook_business.adobjects.adpreview import AdPreview
from facebook_business.api import FacebookAdsApi

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_CREATIVE_ID>'
FacebookAdsApi.init(access_token=access_token)

fields = [
]
params = {
  'ad_format': 'DESKTOP_FEED_STANDARD',
  'product_item_ids': ['<productItemID>'],
}
print AdCreative(id).get_previews(
  fields=fields,
  params=params,
)

import com.facebook.ads.sdk.*;
import java.io.File;
import java.util.Arrays;

public class SAMPLE_CODE_EXAMPLE {
  public static void main (String args[]) throws APIException {

    String access_token = \"<ACCESS_TOKEN>\";
    String app_secret = \"<APP_SECRET>\";
    String app_id = \"<APP_ID>\";
    String id = \"<AD_CREATIVE_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new AdCreative(id, context).getPreviews()
      .setAdFormat(AdPreview.EnumAdFormat.VALUE_DESKTOP_FEED_STANDARD)
      .setProductItemIds(\"[\\"<productItemID>\\"]\")
      .execute();

  }
}

require 'facebook_ads'

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_CREATIVE_ID>'

FacebookAds.configure do |config|
  config.access_token = access_token
  config.app_secret = app_secret
end

ad_creative = FacebookAds::AdCreative.get(id)
previewss = ad_creative.previews({
    fields: {  },
    ad_format: 'DESKTOP_FEED_STANDARD',
    product_item_ids: ['<productItemID>'],
})

Parameter

Mengambil Data Statistik Iklan Produk

Anda bisa mengambil data statistik per produk dengan membuat panggilan GET ke endpoint insight. Tambahkan product_id ke parameter fields.

Ini menunjukkan statistik semua produk di set produk akun yang ditampilkan di iklan katalog Advantage+.

Contoh

Contoh ini melaporkan clicks, actions, dan impressions untuk masing-masing product_id.

Permintaan

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\Fields\AdsInsightsFields;
use FacebookAds\Object\Values\AdsInsightsActionBreakdownsValues;
use FacebookAds\Object\Values\AdsInsightsDatePresetValues;
use FacebookAds\Object\Values\AdsInsightsBreakdownsValues;

$account = new AdAccount('act_<AD_ACCOUNT_ID>');

$fields = array(
  AdsInsightsFields::ACCOUNT_NAME,
  AdsInsightsFields::IMPRESSIONS,
  AdsInsightsFields::ACTIONS,
);

$params = array(
  'date_preset' => AdsInsightsDatePresetValues::LAST_WEEK,
  'action_breakdowns' => array(
    AdsInsightsActionBreakdownsValues::ACTION_TYPE,
  ),
  'breakdowns' => array(
    AdsInsightsBreakdownsValues::PRODUCT_ID,
  ),
);

$stats = $account->getInsights($fields, $params);

from facebookads.adobjects.adaccount import AdAccount
from facebookads.adobjects.adsinsights import AdsInsights

account = AdAccount('act_<AD_ACCOUNT_ID>')

fields = [
    AdsInsights.Field.account_name,
    AdsInsights.Field.impressions,
    AdsInsights.Field.actions,
]

params = {
    'date_preset': 'last_week',
    'actions_group_by': ['action_type'],
    'breakdowns': [
        AdsInsights.Breakdowns.product_id,
    ],
}

stats = account.get_insights(fields=fields, params=params)

APINodeList<AdsInsights> adsInsightss = new AdAccount(act_<AD_ACCOUNT_ID>, context).getInsights()
  .setDatePreset(AdsInsights.EnumDatePreset.VALUE_LAST_WEEK)
  .setActionBreakdowns("[\"action_type\"]")
  .setBreakdowns("[\"product_id\"]")
  .requestField("account_name")
  .requestField("impressions")
  .requestField("actions")
  .execute();

curl -G \
  -d 'date_preset=last_week' \
  -d 'action_breakdowns=["action_type"]' \
  -d 'breakdowns=["product_id"]' \
  -d 'fields=account_name,impressions,actions' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.8/act_<AD_ACCOUNT_ID>/insights

Tanggapan

{
 "data": [ 
   {
      "account_id": "123456", 
      "product_id": "60750", 
      "date_start": "2015-02-03", 
      "date_stop": "2015-02-03", 
      "impressions": 880, 
      "clicks": 8, 
      "actions": [ 
        {
          "action_type": "link_click", 
          "value": 6
        }, 
        {
          "action_type": "offsite_conversion.other", 
          "value": 5
        },  
        {
          "action_type": "offsite_conversion", 
          "value": 5
        }
      ], 
      "account_name": "My Account"
    }, 
 ], 
...
}

Mengambil Data Komentar dan Suka

Anda bisa mengambil data komentar, suka, dan product_id untuk postingan iklan katalog Advantage+. Buat panggilan GET sebagai berikut dengan post_id. post_id adalah effective_object_story_idmateri iklan, dalam format PageID_PostID.

Catatan: Endpoint ini tidak dapat digunakan untuk mengambil komentar dari Instagram.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<POST_ID>/dynamic_posts

Endpoint ini menampilkan objek postingan dinamis.

Setelah mendapatkan postingan dinamis, Anda bisa mengambil comments, likes, product_id, dan child_attachments untuk format carousel, jika berlaku.

Pelajari Selengkapnya

• Menyiapkan Katalog
• Membangun Pemirsa
• Referensi Set Iklan
• Referensi Materi Iklan
• Kursus Meta Blueprint: Membuat dan Menyiapkan Katalog untuk Iklan Katalog Advantage+
• Kursus Meta Blueprint: Memecahkan Masalah Katalog untuk Iklan Katalog Advantage+
• Pelatihan langsung Meta Blueprint: Memecahkan Masalah Katalog untuk Iklan Katalog Advantage+