Marketing API

Iklan Telepon

Panduan ini menjelaskan cara membuat dan menerbitkan iklan telepon menggunakan Marketing API dari Meta.

Sebelum Memulai

Panduan ini berasumsi Anda memiliki:

Untuk membuat panggilan yang berhasil ke semua endpoint dalam panduan ini, Anda akan membutuhkan:

  • Token akses Halaman yang diminta oleh orang yang dapat melakukan tugas ADVERTIZE di Halaman
  • Izin berikut harus diberikan kepada orang yang menggunakan aplikasi Anda:
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

Rekomendasi

Pastikan untuk mengatur jam buka untuk bisnis Anda di Pengaturan Halaman Facebook.

Saat menguji panggilan API, Anda dapat menyertakan parameter access_token ke token akses Anda. Namun, saat melakukan panggilan aman dari aplikasi Anda, gunakan kelas token akses.

Batasan

  • Pemirsa target harus berusia 18 tahun ke atas
  • Nomor telepon yang termasuk dalam Ajakan Bertindak harus berasal dari negara yang sama dengan pemirsa target

Langkah 1: Buat Kampanye

Untuk membuat kampanye iklan Anda, kirim permintaan POST ke endpoint act_ad_account_id/campaigns dengan ad_account_id adalah ID akun iklan Meta Anda. Permintaan Anda harus menyertakan:

  • name
  • objective – atur ke salah satu tujuan yang didukung ini:
    • OUTCOME_AWARENESS
    • OUTCOME_ENGAGEMENT
    • OUTCOME_LEADS
    • OUTCOME_SALES
    • OUTCOME_TRAFFIC
  • special_ad_categories

Contoh Permintaan

Diformat agar mudah dibaca. Ganti nilai yang dicetak tebal, dicetak miring, seperti ad_account_id, dengan nilai Anda.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "name":"Call_ad_campaign_name",
           "objective":"OUTCOME_TRAFFIC",
           "special_ad_categories":["NONE"],
         }'

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan ID kampanye Anda.

{
  "id": "campaign_id"
}

Langkah 2: Buat Set Iklan

Untuk membuat set iklan, kirim permintaan POST ke endpoint act_ad_account_id/adsets dengan ad_account_id adalah ID akun iklan Meta Anda. Permintaan Anda harus menyertakan:

  • bid_amount
  • billing_event diatur ke IMPRESSIONS
  • campaign_id
  • daily_budget
  • destination_type diatur ke PHONE_CALL
  • name
  • optimization_goal diatur ke QUALITY_CALL untuk semua iklan telepon
  • targeting

Contoh Permintaan

Diformat agar mudah dibaca. Ganti nilai yang dicetak tebal, dicetak miring, seperti ad_account_id, dengan nilai Anda.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "destination_type":"PHONE_CALL",
           "name:"Your_call_adset_name",
           "optimization_goal":"QUALITY_CALL",
           "targeting":{ 
             "geo_locations": { "countries":["US","CA"] },
             "device_platforms": ["mobile"],
             "publisher_platforms": ["facebook"] 
           } 
         }'

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON berikut dengan ID set iklan.

{
  "id": "adset_id"
}

Langkah 3: Buat Materi Iklan

Dengan materi iklan, Anda dapat menambahkan aset ke iklan Anda. Iklan carousel, gambar, hanya teks, dan video didukung.

Untuk membuat materi iklan, kirim permintaan POST ke endpoint /act_ad_account_id/adcreatives dengan ad_account_id sebagai ID untuk akun iklan Meta Anda. Permintaan Anda harus menyertakan:

  • name
  • object_story_spec
  • object_story_spec dengan objek link_data yang mendefinisikan call_to_action dengan type yang diatur ke CALL_NOW dan value sebagai nomor telepon untuk bisnis Anda

Permintaan Contoh Iklan Gambar

Diformat agar mudah dibaca. Ganti nilai yang dicetak tebal dan miring, seperti page_access_token, dengan nilai Anda.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "name":"Your_call_image_ad_name",
           "object_story_spec":{
             "page_id": "your_page_id",
             "link_data": {
               "picture": "Your_image_URL", 
               "link": "Your_business_page_URL", 
               "call_to_action": {
                 "type":"CALL_NOW",
                 "value":{ "link":"tel:+Your_business_phone_number_with_country_code" }
               }   
             }
           }
         }'

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON berikut dengan ID materi iklan.

{
  "id": "ad_creative_id"
}

Langkah 4: Buat Iklan

Untuk membuat iklan, Anda perlu menghubungkan materi iklan dan set iklan. Untuk membuat iklan, kirim permintaan POST ke endpoint /act_ad_account_id/ads dengan ad_account_id adalah ID akun iklan Meta Anda. Permintaan Anda harus menyertakan:

Contoh Permintaan Iklan dengan Materi Iklan

Diformat agar mudah dibaca. Ganti nilai yang dicetak tebal, dicetak miring, seperti ad_account_id, dengan nilai Anda.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/ads"
     -H "Content-Type: application/json" 
     -d '{

           "adset_id": "Your_ad_set_id",
           "creative": { "creative_id": "Your_ad_creative_id" },
           "status": "PAUSED"
         }'

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON berikut dengan ID iklan.

{
  "id": "ad_id"
}

Langkah Berikutnya

Kunjungi Panduan Memulai untuk mempelajari cara mengajukan iklan Anda agar ditinjau.

Pelajari Selengkapnya

Pelajari selengkapnya tentang Marketing API dan opsi tambahan untuk iklan telepon.

Pusat Bantuan Bisnis

Marketing API