Marketing API

Iklan Video dan Carousel

Anda dapat dengan mudah membuat, mengukur, dan mengoptimalkan iklan video dan carousel di Facebook melalui API. Lihat Facebook untuk Bisnis, Iklan Carousel. Untuk format video yang didukung untuk iklan, lihat Pusat Bantuan Pengiklan, Video.

Iklan Video

Dokumen Referensi

Untuk membuat iklan video di tujuan VIDEO_VIEWS dan mengoptimalkan tawaran untuk jangkauan, ikuti langkah-langkah berikut:

Langkah 1: Sediakan materi iklan

Buat iklan video menggunakan ID video yang ada dan video yang diunggah ke Facebook.

Anda akan memerlukan:

  • Izin pages_read_engagement dan ads_management
  • video yang diunggah ke endpoint act_{ad-account-id}/advideos
curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Tayangan Slide

Untuk memperluas atau meluncurkan kampanye merek ke telepon berfitur dasar di pasar negara berkembang atau untuk membuat video sederhana, coba tayangan slide gambar (Paling sedikit perlu 3 gambar). Unggah gambar ke aset video. Contoh:

curl \
  -F 'slideshow_spec={ 
  "images_urls": [ 
  "<IMAGE_URL_1>", 
  "<IMAGE_URL_2>", 
  "<IMAGE_URL_3>" 
  ], 
  "duration_ms": 2000, 
  "transition_ms": 200 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph-video.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/advideos
 
  Open In Graph API Explorer

Lihat Praktik Terbaik Materi Iklan Video dan Referensi: Video Iklan.

Langkah 2: Buat kampanye iklan

Tetapkan tujuan ke VIDEO_VIEWS:

curl -X POST \
  -F 'name="Video Views campaign"' \
  -F 'objective="OUTCOME_ENGAGEMENT"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns
  
Open In Graph API Explorer

Lihat Referensi: Kampanye, Tujuan Iklan di PHP dan Tujuan Iklan di Python

Langkah 3: Buat set iklan

Jika target Anda adalah biaya per tayangan serendah mungkin, Anda harus memasangkan tujuan kampanye tayangan video dengan optimization_goal=THRUPLAY set iklan. Anda dapat mengatur bidding_event ke IMPRESSIONS atau THRUPLAY, untuk membayar per impresi atau per tayangan video. Lihat tawaran CPV.

curl \
  -F 'name=A CPV Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2024-05-06T04:45:29+0000' \
  -F 'end_time=2024-06-06T04:45:29+0000' \
  -F 'billing_event=THRUPLAY' \
  -F 'optimization_goal=THRUPLAY' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
  "device_platforms": ["mobile"], 
  "geo_locations": {"countries":["US"]}, 
  "publisher_platforms": ["facebook"] 
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets


  Open In Graph API Explorer

Tarif biaya per tayangan lebih rendah untuk set iklan dengan optimization_goal=THRUPLAY dibandingkan dengan CPV dari pembelian Jangkauan dan Frekuensi yang dioptimalkan untuk tayangan video. Tanggal akhir harus di waktu yang akan datang. Lihat Referensi: Set Iklan.

Langkah 4: Buat iklan

Gunakan set iklan dan materi iklan yang ada:

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/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Jika tujuan kampanye adalah VIDEO_VIEWS, secara default iklan mendapatkan spesifikasi pelacakan yang benar, yang menentukan tindakan yang dilacak untuk suatu iklan. Contoh, tayangan video:

{'action.type':'video_view','post':'POST_ID','post.wall':'PAGE_ID'}

Lihat Pengelola Iklan: Kampanye Saya dan Referensi: Iklan.

Contoh Brand Awareness

Untuk membuat iklan video guna brand awareness, lihat blog brand awareness.

Contoh Jangkauan dan Frekuensi

Dokumen Referensi

Untuk memperluas jangkauan video ke lebih banyak orang, gunakan tujuan kampanye tayangan video dengan Jangkauan dan Frekuensi. Anda harus membuat prediksi, memesannya, dan menetapkannya ke set iklan Anda.

Ikuti pembuatan tayangan video, tetapi terapkan Jangkauan dan Frekuensi untuk set iklan Anda. Tentukan parameter tambahan ini:

-F "rf_prediction_id=<RESERVATION_ID>" \

Video untuk Tanggapan Langsung

Untuk mendorong orang beralih dari kesadaran ke tindakan, lihat Materi Iklan Video dalam Format Carousel.

  • Menjangkau orang yang menonton video. Dari kesadaran hingga afinitas dan pertimbangan. Lihat marketing ulang.
  • Interaksi dengan merek dan produk. Tambahkan ajakan bertindak untuk mengujungi halaman tertentu di situs web Anda. Lihat ajakan bertindak.

Marketing ulang

Marketing ulang iklan video memberikan dukungan bagi pengiklan untuk menargetkan pemirsa khusus tertentu dari video organik atau berbayar di Facebook dan Instagram. Gunakan fitur ini untuk memindahkan orang dari awareness ke tujuan corong yang lebih dalam seperti ketertarikan dan pertimbangan. Lihat Penelitian: Kombinasi Materi Iklan yang Berhasil.

Anda memerlukan izin pengiklan untuk halaman yang berisi video guna membuat pemirsa untuk video tersebut.

Untuk pemirsa, tetapkan subtype=ENGAGEMENT. Lalu tulis aturan untuk pemirsa yang ingin dibuat. Setiap aturan memiliki object_id, seperti ID video, dan event_name. event_name adalah salah satu:

  • video_watched: berapa kali video Anda ditonton selama agregat minimal 3 detik atau selama hampir total durasi, tergantung mana yang terjadi terlebih dahulu.
  • video_completed: berapa kali video ditonton selama 95% dari durasinya, termasuk tontonan yang dilewatkan sampai titik ini.
  • video_view_10s: Frekuensi video Anda ditonton selama agregat minimal 10 detik, atau selama hampir total durasi, tergantung mana yang terjadi lebih dahulu.
  • video_view_15s: frekuensi video Anda ditonton selama agregat minimal 15 detik, atau selama hampir total durasi, tergantung mana yang terjadi terlebih dahulu.
  • video_view_25_percent: berapa kali video ditonton selama 25% dari durasinya, termasuk tontonan yang dilewatkan sampai titik ini.
  • video_view_50_percent: frekuensi video Anda ditonton selama 50% dari durasinya, termasuk tontonan yang lompat ke titik ini.
  • video_view_75_percent: berapa kali video ditonton selama 75% dari durasinya, termasuk tontonan yang dilewatkan sampai titik ini.

Anda dapat menggabungkan video untuk membuat pemirsa berdasarkan berbagai video dan tindakan. Contoh: pemirsa dapat terdiri dari tayangan 3 detik dari video A, dan menyelesaikan video B dan C.

Cara ini menciptakan pemirsa dari penonton video 1 selama 3 detik lebih dan penonton video 2 yang menonton video sampai selesai dalam 14 hari terakhir. Pemirsa juga terisi otomatis untuk penonton sebelum pembuatan pemirsa dengan prefill=true.

curl \
  -F 'name=Video Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who watched my video' \
  -F 'prefill=1' \
  -F 'rule=[ 
  {"object_id":"%video_id_1","event_name":"video_watched"}, 
  {"object_id":"%video_id_2","event_name":"video_completed"} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences
  
Open In Graph API Explorer

Backfill didukung untuk tayangan video setelah 16 Oktober 2015.

Ajakan Bertindak

Video dengan Ajakan Bertindak (CTA) mendorong orang untuk mempelajari lebih lanjut dan mengunjungi halaman tertentu di situs web. Tingkatkan kinerja jika tujuan utama Anda adalah mendorong tayangan video atau brand awareness dan tujuan sekunder Anda adalah mendorong klik di luar situs. Anda harus menggunakan iklan tautan video untuk tujuan kedua tersebut. Cara CTA di-render:

  • Untuk Seluler dan Desktop, ditampilkan sebagai bagian dari postingan. Ketika video dijeda, CTA ditampilkan di samping opsi Lanjutkan.
  • Untuk Seluler, saat seseorang mengeklik video untuk ditonton dalam layar penuh, CTA mengambang muncul sebagai overlay video.
  • Postingan tautan video eksternal tidak menampilkan CTA.

Anda dapat menggunakan video dengan CTA hanya dengan tujuan kampanye berikut:

Lihat Perluasan video ke Tujuan Tambahan. Berikut cara membuat iklan video dengan ajakan bertindak GET_DIRECTIONS:

curl \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": { 
  "call_to_action": { 
  "type": "GET_DIRECTIONS", 
  "value": { 
  "link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\"" 
  } 
  }, 
  "image_url": "<THUMBNAIL_URL>", 
  "link_description": "Come check out our new store in Menlo Park!", 
  "video_id": "<VIDEO_ID>" 
  } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
   https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Metrik Video

Insight Postingan Video, Organik

Dokumen Referensi

Pelajari selengkapnya tentang performa video Anda di Facebook dan buat keputusan yang lebih tepat tentang konten video. Saat ini kami hanya menyediakan metrik ketika seseorang mulai menonton video. Hal ini termasuk tayangan video, tayangan video unik, durasi rata-rata tayangan video, dan retensi pemirsa. Lihat posisi berhentinya orang-orang di video Anda dan bagian yang mungkin paling menarik bagi orang-orang.

Insight Iklan Video, Berbayar

Gunakan Ads Insights API. Tanggapan berisi berbagai metrik video.

Jenis Video

Ambil statistik iklan video yang dikelompokkan menurut jenis video seperti putar otomatis, klik-putar. Sertakan action_video_type di action_breakdowns. Nilai yang diharapkan untuk action_video_type adalah total, click_to_play, dan auto_play.

Kami sedang dalam pengujian terbatas untuk opsi action_video_type. Untuk mengidentifikasi klien dengan perincian, periksa CAN_USE_VIDEO_METRICS_BREAKDOWN untuk akun iklan.

curl -G \
  -d 'action_breakdowns=action_video_type' \
  -d 'date_preset=last_30_days' \
  -d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
  -d 'access_token= <ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
   
Open In Graph API Explorer

Tanggapan mencakup objek dengan action_type sebagai video_view dan berisi kode action_video_type:

{
  "data": [
    {
      "actions": [
        ...
        {
          "action_type": "video_play", 
          "value": 9898
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 921129
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 915971
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 5158
        }
      ], 
      "video_avg_pct_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 60.59
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 60.47
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 80.63
        }
      ], 
      "video_complete_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 156372
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 154015
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 2357
        }
      ], 
      "date_start": "2014-12-26", 
      "date_stop": "2015-03-25"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "MA==", 
      "after": "MA=="
    }
  }
}

Lihat Ads Insights API

Dapatkan real estat yang lebih kreatif di Kabar dan dorong orang ke situs web atau aplikasi seluler Anda untuk berkonversi. Buat iklan carousel dengan dua cara:

Iklan carousel tidak didukung untuk Facebook Stories.

Membuat Inline

Buat postingan halaman iklan carousel sambil membuat materi iklan. Tentukan konten postingan halaman di object_story_spec, yang membuat postingan halaman yang tidak diterbitkan dari adcreatives. Lihat materi iklan. Contoh:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "child_attachments": [ 
        { 
          "description": "$8.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product1", 
          "name": "Product 1", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$9.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product2", 
          "name": "Product 2", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$10.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product3", 
          "name": "Product 3" 
        } 
      ], 
      "link": "<URL>" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Tanggapannya berupa ID materi iklan:

{"id":"<CREATIVE_ID>"}

Buat Postingan, lalu Iklan

Buat postingan Halaman yang tidak diterbitkan. child_attachments adalah array dari objek tautan. Di setiap objek tautan, picture, name, dan description bersifat opsional. Anda dapat memposting ini sebagai "oleh Halaman" hanya dengan token akses Halaman.

curl -X GET \
  -d 'message="Browse our latest products"' \
  -d 'published=0' \
  -d 'child_attachments=[
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 1",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 2",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 3",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 4",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       }
     ]' \
  -d 'caption="WWW.EXAMPLE.COM"' \
  -d 'link="http://www.example.com/products"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/posts
  
Open In Graph API Explorer

Lalu, sediakan materi iklan dengan postingan Halaman yang tidak diterbitkan. Gunakan id untuk object_story_id di materi iklan Anda.

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Membuat Iklan Carousel Video

Iklan carousel video dapat memiliki 'keterangan' di lampiran turunan untuk menyesuaikan URL tayangan di layar akhir:

"child_attachments": [
 {
   "link": "https://www.facebookmarketingdevelopers.com/",
   "name": "Facebook Marketing Developers",
   "description": "Facebook Marketing Developers",
   "call_to_action": {
     "type": "APPLY_NOW",
     "value": {
      "link_title": "Facebook Marketing Developers"
     }
   },
   "video_id": "123",
   "caption": "mycustomlinkcaption.com"
  },
]

Untuk mendapatkan detail lampiran turunan, gunakan ID dan hubungi Graph API, Video, Referensi.

Membuat Iklan Aplikasi Seluler

Batasan:

  • Iklan aplikasi seluler carousel hanya mendukung satu aplikasi
  • Minimal 3 gambar, dibandingkan dengan 2 pada iklan carousel iklan non-aplikasi
  • Iklan aplikasi seluler carousel harus memiliki ajakan bertindak
  • Kartu terakhir yang biasanya menampilkan foto profil halaman tidak akan ditampilkan untuk iklan aplikasi seluler carousel. Perhatikan bahwa Anda harus menentukan tautan toko aplikasi yang sama di masing-masing child_attachment. Anda tidak perlu menentukan tautan lagi di call_to_action:{'value':{'link':... }}}

Contoh: untuk membuat iklan carousel untuk penginstalan aplikasi seluler:

\

curl -X POST \
  -F 'name="Carousel app ad"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "message": "My message",
         "link": "http://www.example.com/appstoreurl",
         "caption": "WWW.ITUNES.COM",
         "name": "The link name",
         "description": "The link description",
         "child_attachments": [
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           }
         ],
         "multi_share_optimized": true
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Anda hanya dapat menerbitkan postingan Anda sebagai Halaman Facebook yang terkait dengan aplikasi seluler. Anda juga harus menggunakan token akses Halaman.

curl \
  -F 'message=My description' \
  -F 'link=<APP_STORE_URL>' \
  -F 'caption=WWW.ITUNES.COM' \
  -F 'child_attachments=[ 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    } 
  ]' \
  -F 'multi_share_optimized=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/feed

Gunakan id dari tanggapan untuk membuat AdCreative:

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Spesifikasi Kolom

Ini adalah Iklan Carousel di iOS, yang menunjukkan cara penggunaan kolom yang dijelaskan.

Nama Deskripsi

child_attachments

jenis: objek

Array 2-10 elemen dari objek tautan diperlukan untuk iklan carousel. Anda harus menggunakan sedikitnya 3 objek untuk mendapatkan kinerja yang optimal; 2 objek untuk mengaktifkan integrasi ringan dan menggunakan 2 objek dapat menghasilkan hasil kampanye yang kurang optimal.

child_attachments.link

jenis: string

URL tautan atau URL toko aplikasi yang dilampirkan ke postingan. Diperlukan.

child_attachments.picture

jenis: URL

Cuplikan gambar yang terkait dengan tautan. Rasio aspek 1:1 dan minimum 458 x 458 px untuk tampilan terbaik. picture atau image_hash harus ditentukan.

child_attachments.image_hash

jenis: string

Hash gambar pratinjau yang terkait dengan tautan dari galeri gambar; gunakan rasio aspek 1:1 dan minimum 458 x 458 px untuk tampilan terbaik. Salah satu dari picture atau image_hash harus ditentukan.

child_attachments.name

jenis: string

Judul cuplikan tautan. Jika tidak ditentukan, judul halaman tertaut yang digunakan. Biasanya dipotong setelah 35 karakter. Anda harus menentukan name unik, karena antarmuka Facebook menunjukkan tindakan yang dilaporkan oleh name.

child_attachments.description

jenis: string

Harga, diskon, atau domain situs web. Jika tidak ditentukan, konten halaman yang ditautkan akan diekstraksi dan digunakan. Biasanya dipotong setelah 30 karakter.

child_attachments.call_to_action

jenis: objek

Ajakan bertindak opsional. Lihat Ajakan Bertindak. Anda tidak perlu menentukan tautan lagi di call_to_action:{'value':{'link':... }}}

child_attachments.video_id

jenis: string

ID video iklan. Dapat digunakan dalam elemen turunan. Jika ditentukan, image_hash atau picture juga harus diatur.

message

jenis: string

Badan utama postingan, juga disebut pesan status.

link

jenis: string

URL tautan ke "Lihat selengkapnya". Diperlukan.

caption

jenis: string

URL untuk ditampilkan di tautan "Lihat selengkapnya". Tidak berlaku untuk iklan aplikasi seluler carousel

multi_share_optimized

jenis: boolean

Jika diatur ke true, gambar dan tautan secara otomatis dipilih dan dipesan. Jika tidak, gunakan urutan asli elemen turunan. Default-nya true.

multi_share_end_card

jenis: boolean

Jika diatur ke false, kartu akhir yang menampilkan ikon halaman akan dihapus. Default-nya adalah true.

Statistik Iklan Per Produk

Kelompokkan tindakan untuk iklan Carousel menurut setiap produk dengan actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name']. Setiap child_attachment memiliki ID kartu yang berbeda. action_carousel_card_id dan action_carousel_card_name hanya untuk iklan Carousel.

Dapatkan statistik berikut per kartu:

  • website_ctr: tersedia saat menentukan fields=['website_ctr']
  • app_install, app_use, apps.uses, credit_spent, mobile_app_install, tab_view, link_click, mobile_app_install, app_custom_event.*, offsite_conversion.*: tersedia saat menentukan fields=['actions']. Tindakan lain tidak tersedia dengan perincian kartu.
curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
  -d 'level=ad' \
  -d 'date_preset=last_30_days' \
  -d 'time_increment=all_days' \
  -d 'breakdowns=placement' \
  --data-urlencode 'filtering=[ 
    { 
      "field": "action_type", 
      "operator": "IN", 
      "value": ["link_click"] 
    } 
  ]' \
  -d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Tanggapan:

{
...
   "website_ctr": [
      {
         "action_carousel_card_id": "1",
         "action_type": "link_click",
         "value": 51.401869158878
      },
      {
         "action_carousel_card_id": "2",
         "action_type": "link_click",
         "value": 50.980392156863
      }
   ],
   "placement": "mobile_feed",
   "date_start": "2015-05-25",
   "date_stop": "2015-05-28"
}

Anda juga dapat meminta cost_per_action_type untuk perincian biaya berdasarkan jenis tindakan:

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
  -d 'level=ad' \
  -d 'breakdowns=placement' \
  -d 'fields=impressions,campaign_name,cost_per_action_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Contoh tanggapan:

{
   "data": [
      {
         "impressions": "1862555",
         "campaign_name": "My Campaign",
         "cost_per_action_type": [
            {
               "action_carousel_card_name": "My Carousel Card 1",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.093347346315861
            },
            {
               "action_carousel_card_name": "My Carousel Card 2",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.38324089579301
            },
            ...
         ],
      }
   ]
}
  • Metrik perincian Carousel untuk action_report_time=impression tidak akurat sebelum 20 Juni 2015.
  • Metrik perincian Carousel untuk action_report_time=conversion tidak akurat sebelum 20 Juli 2015.

Penempatan

Jika hanya memilih right_hand_column sebagai penempatan, Anda hanya dapat menggunakan satu video atau format carousel di grup iklan. Kami tidak mendukung format video hanya dengan penempatan right_hand_column yang dipilih. Lihat Penempatan dan Penargetan Lanjutan.

Contoh: buat set iklan dengan right_hand_column sebagai satu-satunya penempatan Anda:

curl \
  -F 'name=RHS only Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2017-11-21T15:41:36+0000' \
  -F 'end_time=2017-11-28T15:41:36+0000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook"] ,
    "facebook_positions": ["right_hand_column"] ,  
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  
Open In Graph API Explorer

Sediakan materi iklan dengan video:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Atau, sediakan format iklan canvas untuk materi iklan:

curl \
  -F 'image_hash=<IMAGE_HASH>' \
  -F 'object_story_spec={ 
    "link_data": { 
      "call_to_action": {"type":"LEARN_MORE"}, 
      "image_hash": "<IMAGE_HASH>", 
      "link": "CANVAS_LINK", 
      "name": "Creative message" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Jika Anda mencoba membuat iklan dengan set iklan dan materi iklan:

curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Jika Anda mendapatkan kode kesalahan, Anda harus memberikan materi iklan yang didukung atau mengubah penargetan Anda.

Lihat Juga