Panduan ini menjelaskan cara membuat dan memublikasikan iklan yang klik ke Messenger menggunakan Marketing API.
Jika Anda ingin menggunakan Pengelola Iklan untuk membuat kampanye iklan prospek, kunjungi Pusat Bantuan Meta Business.
Iklan yang klik ke Messenger mengarahkan orang yang mengeklik iklan Anda langsung ke percakapan dengan bisnis Anda di Messenger. Gunakan iklan ini untuk menjangkau orang dalam skala besar dan memberikan layanan perorangan yang menonjol.
Iklan yang klik ke Messenger mendukung iklan dengan gambar, video, carousel, atau tayangan slide. Anda juga dapat menyertakan topik panggilan di iklan Anda.
Jika Anda tertarik membuat iklan yang mengarahkan orang ke obrolan Instagram atau WhatsApp, lihat Iklan yang klik ke Instagram atau Iklan yang klik ke WhatsApp untuk panduan. Anda juga dapat membuat iklan yang memilih tujuan yang kemungkinan besar akan ditanggapi oleh pengguna, lihat Iklan yang klik ke multidestinasi untuk informasi selengkapnya.
Untuk membuat dan mempublikasikan iklan, Anda perlu:
Panduan ini mengasumsikan Anda memiliki:
Untuk membuat panggilan yang berhasil ke semua endpoint dalam panduan ini, Anda memerlukan:
ADVERTIZE
di Halamanads_management
pages_manage_ads
pages_read_engagement
pages_show_list
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:
|
|
Referensi Cepat Kampanye Iklan
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/campaigns" \
-H "Content-Type: application/json" \
-d '{
"access_token":"Your_page_access_token",
"buying_type":"AUCTION",
"name":"Messenger_ad_campaign_name",
"objective":"OUTCOME_TRAFFIC",
"status":"PAUSED",
"special_ad_categories":["NONE"],
}'
Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan ID kampanye Anda.
{ "id": "campaign_id" }
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:
access_token
bid_amount
billing_event
diatur ke IMPRESSIONS
campaign_id
daily_budget
destination_type
diatur ke MESSENGER
name
optimization_goal
diatur ke CONVERSATIONS
, IMPRESSIONS
, atau LEAD_GENERATION
atau QUALITY_LEAD
untuk iklan prospekpromoted_object
– diatur ke ID Halaman Facebook bisnis Anda.status
diatur ke PAUSED
targeting
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/adsets"
-H "Content-Type: application/json"
-d '{
"access_token":"Your_page_access_token",
"bid_amount":"Your_bid_amount",
"billing_event":"IMPRESSIONS",
"campaign_id":"Your_campaign_id",
"daily_budget":"Your_daily_budget",
"destination_type":"MESSENGER",
"name:"Your_messenger_adset_name",
"optimization_goal:IMPRESSIONS",
"status:PAUSED",
"targeting":{
"geo_locations": { "countries":["US","CA"] },
"device_platforms": ["mobile", "desktop"],
"publisher_platforms": ["messenger"]
}
}'
Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON berikut dengan ID set iklan.
{ "id": "adset_id" }
Materi iklan memungkinkan Anda untuk menambahkan aset ke iklan Anda.
Batasan
|
Untuk membuat materi iklan, kirim POST
permintaan ke /act_ad_account_id/adcreatives
endpoint dengan ad_account_id sebagai ID untuk akun iklan Meta Anda. Permintaan Anda harus menyertakan:
access_token
name
object_story_spec
– Wajibprivacy_url
– Wajib untuk iklan prospekstandard_enhancements.enroll_status
– Wajib untuk materi iklan yang memenuhi syarat untuk penyempurnaan standar. Referensi Cepat Parameter Materi Iklan Level Atas
Untuk membuat materi iklan Klik ke Messenger, kirim permintaan POST
ke endpoint /act_ad_account_id/adcreatives
dengan ad_account_id adalah ID akun iklan Meta Anda. Permintaan Anda harus menyertakan:
access_token
name
object_story_spec
dengan objek *_data
yang mendefinisikan jenis media
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token":"page_access_token",
"name":"Your_CTM_image_ad_name",
"object_story_spec":{
"page_id": "your_page_id",
"link_data": {
"page_welcome_message": "Your_welcome_message",
"image_hash": "Your_image_hash",
"link": "Your_image_URL",
"call_to_action": {
"type":"LEARN_MORE",
"value":{ "app_destination":"MESSENGER" }
}
}
}
}'
Referensi Cepat Iklan Video Klik ke Messenger
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token": "page_access_token",
"name": "Your_CTM_image_ad_name",
"object_story_spec": {
"page_id": "your_page_id",
"video_data": {
"call_to_action": {
"type": "LEARN_MORE",
"value": { "app_destination": "MESSENGER" }
},
"link_description": "Your_link_description",
"image_url": "Your_thumbnail_URL",
"page_welcome_message": "Your_welcome_text",
"video_id": "video_id"
}
}
}'
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token": "page_access_token",
"name": "Your_CTM_image_ad_name",
"object_story_spec": {
"page_id": "your_page_id",
"link_data": {
"image_hash": "your_image_hash",
"link": "your_image_URL",
"call_to_action": {
"type": "MESSAGE_PAGE",
"value": { "app_destination":"MESSENGER" }
}
}
},
"asset_feed_spec": {
"additional_data": {
"partner_app_welcome_message_flow_id": "FLOW-ID"
}
}
}'
Untuk informasi selengkapnya tentang alur aplikasi berkirim pesan, lihat Alur pesan sambutan dalam dokumentasi Platform Messenger.
Pesan default yang dilihat pelanggan adalah "Halo! Bisakah saya mendapatkan info selengkapnya tentang ini?". Anda dapat membuat pengalaman pengguna yang lebih disesuaikan untuk iklan Anda yang mengklik ke Messenger dengan menyesuaikan pesan salam, pencair suasana, dan pesan isi otomatis iklan di kolom page_welcome_message
di bawah object_story_spec
.
Untuk informasi lebih lanjut tentang pencair suasana, lihat ice_breakers
referensi.
Buat objek page_welcome_message
untuk menambahkan pencair suasana dengan pesan salam.
"page_welcome_message": { "type":"VISUAL_EDITOR", "version":2, "landing_screen_type":"welcome_message", "media_type":"text", "text_format":{ "customer_action_type":"ice_breakers", "message":{ "ice_breakers":[ {"title":"Can I make a purchase?","response":"This is a response 1"}, {"title":"Can I see a menu?", "response":"This is a response 2"}, {"title":"Where are you located?", "response":"This is a response 3"}], "quick_replies":[], "text":"Hi {{user_first_name}}! Please let us know how we can help you."} }, "user_edit":false, "surface":"visual_editor_new" }
Iklan Klik untuk Berlangganan (CTS) adalah iklan Klik ke Messenger di mana object_story_spec.page_welcome_message
adalah array objek dengan template pesan notifikasi. Ketika seseorang mengeklik tombol Dapatkan pesan di iklan Anda, orang tersebut setuju untuk menerima pesan marketing dari bisnis Anda.
Untuk membuat materi iklan Klik untuk Berlangganan, kirim permintaan POST
ke endpoint /act_ad_account_id/adcreatives
dengan ad_account_id adalah ID akun iklan Meta Anda. Permintaan Anda harus menyertakan:
access_token
name
object_story_spec
dengan
*_data
yang mendefinisikan jenis media page_welcome_message
yang mendefinisikan permintaan persetujuan ikut serta pesan marketing. Harus menyertakan landing_screen_type
yang diatur ke marketing_messages
dan lampiran pesan payload.template_type
yang diatur ke nofitication_messages
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token": "page_access_token",
"name": "Your_CTS_image_ad_name",
"object_story_spec": {
"page_id": "your_page_id",
"link_data": {
"image_hash": "Your_image_hash",
"link": "Your_image_URL",
"call_to_action": {
"type": "LEARN_MORE",
"value":{ "app_destination": "MESSENGER" }
}
"page_welcome_message": "{
"landing_screen_type": "marketing_messages",
"media_type": "image",
"image_format": {
"customer_action_type": "buttons",
"message": {
"text": "Your_welcome_message",
"attachment": {
"type": "template",
"payload":{
"template_type":"notification_messages",
"elements": [{
"title": "Your_CTS_title",
"subtitle": "Your_CTS_subtitle",
"image_url": "Your_image_URL",
"app_id": "Your_Meta_app_ID",
"buttons": [{
"type": "postback",
"payload": "Data_to_include_in_webhook_notification",
"title": "Get messages"
}]
}]
}
}
}
}
}"
}
}
}'
Iklan Messenger untuk Prospek memungkinkan Anda menciptakan prospek di Messenger melalui template obrolan otomatis. Anda bisa mengajukan pertanyaan tertentu kepada orang yang tertarik dengan bisnis Anda secara langsung di platform pengiriman pesan pilihan, mengumpulkan preferensi pelanggan, dan mengajukan pertanyaan khusus untuk memprioritaskan prospek yang paling memenuhi syarat.
Sebelum Anda dapat membuat materi iklan untuk Iklan Messenger untuk Prospek, Anda harus menerima syarat dan ketentuan untuk Iklan Messenger untuk Prospek.
Untuk membuat template pesan, kirim permintaan POST
ke endpoint /page_id/messenger_lead_forms
dengan page_id adalah ID Halaman Facebook bisnis Anda. Permintaan Anda harus menyertakan:
access_token
privacy_url
step_list
yang mencakup message
, reply_type
step_id
, dan step_type
template_name
reminder_text
Template pesan berikut menyertakan template_name
Anda, privacy_url
, step_list
dengan pesan sambutan di step_id: 0
, pertanyaan di step_id: 1
sampai 4
, pesan konfirmasi di step_id: 5
, dan pesan diskualifikasi di step_id: 6
.
Referensi Cepat Template Pesan
curl -X POST "https://graph.facebook.com/v21.0
/your_page_ID/messenger_lead_forms"
-H "Content-Type: application/json"
-d '{
"access_token": "Your_page_access_token",
"privacy_url": "Your_privacy_policy_URL",
"reminder_text": "Your_reminder_text",
"template_name": "Your_template_name",
"step_list": [
{
"step_id": "0",
"message": "Your_welcome_message",
"step_type": "INTRO",
"reply_type": "NONE",
"next_step_ids": "1"
},
{
"step_id": "1"
"message": "Are_you_interested_in_our_products_or_services?",
"step_type": "QUESTION",
"reply_type": "QUICK_REPLIES",
"answers": ["Yes", "Not now", "Maybe"],
"next_step_ids": [2,6,2],
"allow_to_skip": false,
"answer_validation_enabled": true
},
{
"step_id": "2",
"message": "What city do you live in?",
"step_type": "QUESTION",
"reply_type": "PREFILL",
"prefill_type": "CITY",
"next_step_ids": "3",
"allow_to_skip": true
},
{
"step_id": "3",
"message": "What is your phone number?",
"step_type": "QUESTION",
"reply_type": "PREFILL",
"prefill_type": "PHONE",
"next_step_ids": "4",
"allow_to_skip": false,
"answer_validation_enabled": true
},
{
"step_id": "4",
"message": "What is your email address?",
"step_type": "QUESTION",
"reply_type": "PREFILL",
"prefill_type": "EMAIL",
"next_step_ids": "5",
"allow_to_skip": false,
"answer_validation_enabled": true
},
{
"step_id": "5",
"message": "Your_confirmation_message",
"step_type": "CONFIRMATION",
"reply_type": "NONE"
},
{
"step_id": "6",
"message": "Your_disqualification_message",
"step_type": "DISQUALIFY",
"reply_type": "NONE"
}
]
}'
Setelah berhasil, aplikasi Anda akan menerima objek JSON dengan ID template.
{ "id": "your_messenger_lead_gen_template_id" }
fblead_form
juga dibuat dan dikaitkan dengan template pesan sebagai bagian dari proses ini.
Untuk mendapatkan daftar template formulir penciptaan prospek Messenger, Anda dapat mengirim permintaan GET
ke endpoint /page_id/messenger_lead_forms
. Anda juga bisa mendapatkan informasi tentang template tertentu dengan mengirim permintaan GET
ke endpoint /
Your_messenger_lead_gen_template_id
.
Untuk membuat materi iklan Klik ke Messenger, kirim permintaan POST
ke endpoint /act_
ad_account_id
/adcreatives
dengan ad_account_id
adalah ID akun iklan Meta Anda. Permintaan Anda harus menyertakan:
access_token
name
object_story_spec
dengan objek *_data
yang mendefinisikan jenis media, gambar atau video, dan berisi:
*_data.page_welcome_message
yang diatur ke pasangan kode-nilai
ctm_lead_gen_template_id:
Your_messenger_lead_gen_template_id
curl -X POST "https://graph.facebook.com/v21.0
/act_AD_ACCOUNT_ID/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token": "Your_page_access_token",
"degrees_of_freedom_spec": {
"creative_features_spec": {
"standard_enhancements": { "enroll_status": "OPT_IN" }
}
},
"name": "Your_lead_ad_image_ad_name",
"object_story_spec": {
"page_id": "Your_page_id",
"link_data": {
"call_to_action": {
"type": "MESSAGE_PAGE",
"value": { "app_destination": "MESSENGER" }
},
"description": "Sample_description",
"image_hash": "Your_image_hash",
"message": "Sample_message_for_Creative",
"page_welcome_message": "{ "ctm_lead_gen_template_id": "Your_messenger_lead_gen_template_id" }"
}
}
}'
curl -X POST "https://graph.facebook.com/v21.0
/act_AD_ACCOUNT_ID/adcreatives"
-H "Content-Type: application/json"
-d '{
"access_token": "Your_page_access_token",
"degrees_of_freedom_spec": {
"creative_features_spec": {
"standard_enhancements": { "enroll_status": "OPT_IN" }
}
},
"name": "Your_lead_ad_video_ad_name",
"object_story_spec": {
"page_id": "your_page_id",
"video_data": {
"call_to_action": {
"type": "MESSAGE_PAGE",
"value":{ "app_destination": "MESSENGER" }
},
"image_url": "Your_thumbnail_url",
"link_description": "Your_link_description ",
"message": "Sample message for Creative ",
"page_welcome_message": "{ "ctm_lead_gen_template_id": "Your_messenger_lead_gen_template_id" }",
"video_id": "Your_video_id"
}
}
}'
Lihat Gunakan Postingan sebagai Iklan Instagram untuk detail selengkapnya.
curl -X POST \
-F 'name=Sample ad creative from Instagram post' \
-F 'object_id=<PAGE_ID>' \
-F 'instagram_user_id=<INSTAGRAM_USER_ID>' \
-F 'source_instagram_media_id=<INSTAGRAM_POST_ID>' \
-F 'call_to_action={
"type": "INSTAGRAM_MESSAGE",
"value": {
"link": "https://www.instagram.com"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
curl -X POST \
-F 'name=Sample ad creative from Instagram image' \
-F 'object_story_spec={
"page_id": "<PAGE_ID>",
"instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
"link_data": {
"message": "<AD_PRIMARY_TEXT>",
"picture": "<IMAGE_URL>"
"page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
"call_to_action": {
"type": "INSTAGRAM_MESSAGE",
"value": {
"app_destination": "INSTAGRAM_DIRECT"
}
}
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Lihat Gunakan Postingan sebagai Iklan Instagram: Postingan Facebook untuk detail selengkapnya.
curl -i -X POST \
"https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT>/adcreatives
?object_story_id=<postOwnerID_postID>
&instagram_actor_id=<IG_USER_ID>
&call_to_action="{'type':MESSAGE_PAGE,'value':{'app_destination':'MESSENGER'}}"
&access_token=<ACCESS_TOKEN>"
object_story_id
adalah ID postingan dalam format postOwnerID_postID
sedangkan instagram_actor_id
adalah ID akun Instagram yang terhubung dengan Halaman atau ID akun Instagram yang didukung Halaman. Lihat detail selengkapnya di Menyiapkan Akun Instagram dengan Halaman.
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:
Referensi Cepat Iklan Akun Iklan
curl -X POST "https://graph.facebook.com/v21.0
/act_ad_account_id/ads"
-H "Content-Type: application/json"
-d '{
"access_token": "Your_page_access_token",
"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" }
Anda juga dapat mengatur ajakan bertindak saat membuat iklan Anda.
"call_to_action": { "value": {"app_destination":"MESSENGER"}, "type": "MESSAGE_PAGE" }
Verifikasikan bahwa iklan Anda ada di pengelola iklan. Klik tombol Tinjau dan terbitkan di pojok kanan atas. Pilih kampanye, set iklan untuk kampanye, dan iklan.
Anda dapat menerbitkan iklan Anda dari pengelola iklan atau menggunakan API. Untuk menerbitkan dengan menggunakan API, ulangi Langkah 4 dengan parameter status
diatur ke ACTIVE
.
Iklan Anda akan ditinjau oleh Meta dan statusnya akan PENDING_REVIEW
. Setelah disetujui, statusnya akan menjadi ACTIVE
dan iklan Anda akan ditayangkan.
Anda dapat membuat pesan yang menyertakan beberapa elemen pesan, seperti topik panggilan atau beberapa template. Anda akan menambahkan elemen-elemen ini dengan mengatur array objek untuk nilai *_data.page_welcome_message
dan bukan nilai string.
Referensi Cepat Array Pesan Sambutan Halaman
Anda dapat menambahkan topik telepon ke iklan Klik ke Messenger dengan mengatur nilai *_data.page_welcome_message
ke array objek yang mendefinisikan elemen topik panggilan Anda. Atur parameter landing_screen_type
ke call_prompt
, media_type
ke text
, dan objek text_format.message
dengan text
ke teks sambutan Anda, serta call_prompt_data.call_prompt_message
diatur ke permintaan untuk menghubungi bisnis Anda.
... "page_welcome_message": "[ { "landing_screen_type": "call_prompt", "media_type": "text", "text_format": { "message": { "text": "Your_welcome_message", "call_prompt_data": { "call_prompt_message": "Your_call_prompt_message" } } }, } ]" ...
Untuk membuat iklan dengan beberapa template, atur parameter *_data.page_welcome_message
ke array dengan template pesan Contoh berikut menambahkan template untuk balasan cepat.
... "page_welcome_message": "[{ 'message': { 'text':' Your_question_or_directive ', 'quick_replies':[ { 'content_type':'text', 'title':' Option_1 ', 'payload':' Option_1_information_for_webhook ' }, { 'content_type':'text', 'title':' Option_2 ', 'payload':' Option_2_information_for_webhook ' }, { 'content_type':'text', 'title':' Option_3 ', 'payload':' Option_3_information_for_webhook ' } ] } }]", ...
Jika Anda belum melakukannya, siapkan webhooks untuk mendapatkan notifikasi saat seseorang mengeklik iklan Anda.
Pelajari selengkapnya tentang Marketing API dan opsi tambahan untuk Klik ke Messenger.