このガイドでは、マーケティングAPIを使ってMessenger誘導広告を作成し、公開する方法について説明します。
広告マネージャを使用してリード獲得広告のキャンペーンを作成したい場合は、Metaビジネスヘルプセンターをご覧ください。
Messenger誘導広告は、広告をクリックした利用者をMessengerでのビジネスとの会話に直接誘導します。この広告を利用することで、顧客に大規模にリーチし、優れたサービスをパーソナライズして提供できます。
Messenger誘導広告では、画像、動画、カルーセル、スライドショーを利用した広告がサポートされます。広告に通話プロンプトを含めることもできます。
InstagramやWhatsAppのチャットに誘導する広告の作成ガイダンス情報については、Instagram誘導広告またはWhatsApp誘導広告をご覧ください。また、ユーザーが反応する可能性が最も高いリンク先を選ぶ広告を作成することもできます。詳しくは、複数誘導先広告をご覧ください。
広告を作成して公開する手順は、次のとおりです。
このガイドは、以下を前提としています。
このガイドに掲載するすべてのエンドポイントについて呼び出しを成功させるには、以下が必要です。
ADVERTIZE
タスクを実行できる人がリクエストしたページアクセストークンads_management
pages_manage_ads
pages_read_engagement
pages_show_list
広告キャンペーンを作成するには、POST
リクエストをact_ad_account_id/campaigns
エンドポイントに送信します。このad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。
|
|
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"],
}'
成功すると、アプリはキャンペーンのIDを含むJSONの応答を受け取ります。
{ "id": "campaign_id" }
広告セットを作成するには、act_ad_account_id/adsets
エンドポイントに対してPOST
リクエストを送信します。このエンドポイントにあるad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。
access_token
bid_amount
IMPRESSIONS
に設定したbilling_event
campaign_id
daily_budget
MESSENGER
に設定したdestination_type
name
optimization_goal
をCONVERSATIONS
またはIMPRESSIONS
に設定。リード獲得広告の場合は、LEAD_GENERATION
またはQUALITY_LEAD
に設定promoted_object
– ビジネスのFacebookページのIDに設定。status
を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"]
}
}'
成功すると、アプリは広告セットのIDを含む次のJSONの応答を受け取ります。
{ "id": "adset_id" }
広告クリエイティブを使用して、広告にアセットを追加することができます。
制限
|
広告クリエイティブを作成するには、POST
リクエストをact_ad_account_id/campaigns
エンドポイントに送信します。このad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。
access_token
name
object_story_spec
– 必須privacy_url
– リード獲得広告の場合は必須standard_enhancements.enroll_status
– 標準エンハンスの対象となる広告クリエイティブの場合は必須。 トップレベルの広告クリエイティブパラメーターのクイックリファレンス
Messenger誘導広告のクリエイティブを作成するには、POST
リクエストを/act_ad_account_id/adcreatives
エンドポイントに送信します。このad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。
access_token
name
*_data
付きのobject_story_spec
オブジェクト
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" }
}
}
}
}'
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"
}
}
}'
メッセージアプリのフローについて詳しくは、Messengerプラットフォームのドキュメントにあるウェルカムメッセージのフローを参照してください。
顧客に対して表示されるデフォルトのメッセージは「こんにちは!これについて詳しい情報をいただけますか?」というものです。object_story_spec
の下のpage_welcome_message
フィールドの中で、広告のあいさつメッセージ、icebreaker、自動入力メッセージをカスタマイズすることにより、Messenger誘導広告のユーザーエクスペリエンスをさらに調整することができます。
cebreakerについて詳しくは、ice_breakers
リファレンスをご覧ください。
page_welcome_message
オブジェクトを作成して、あいさつメッセージ付きのicebreakerを追加します。
"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" }
購読登録誘導広告(CTS)は、Messenger誘導広告です。この広告のobject_story_spec.page_welcome_message
は、通知メッセージテンプレートを指定したオブジェクトの配列です。利用者は広告の[メッセージを受け取る]ボタンをクリックすることにより、ビジネスのマーケティングメッセージを受信することに同意します。
購読登録誘導広告の広告クリエイティブを作成するには、POST
リクエストを/act_ad_account_id/adcreatives
エンドポイントに送信します。このad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。
access_token
name
object_story_spec
に以下を指定
object_story_spec
オブジェクト page_welcome_message
配列。landing_screen_type
をmarketing_messages
にし、メッセージ添付のpayload.template_type
を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"
}]
}]
}
}
}
}
}"
}
}
}'
リード獲得のMessenger広告を利用すると、自動チャットテンプレートを通じてMessengerでリードを獲得することができます。自分で選んだメッセージプラットフォームであなたのビジネスに興味がある人に特定の質問を直接尋ねたり、顧客の好みを収集したり、カスタムの質問をしたりして、厳密に絞り込んだリードを優先することができます。
リード獲得のMessenger広告の広告クリエイティブを作成するには、その前に、リード獲得のMessenger広告の利用規約に同意する必要があります。
メッセージテンプレートを作成するには、/page_id/messenger_lead_forms
エンドポイントに対してPOST
リクエストを送信します(page_idは、ビジネスのFacebookページのID)。リクエストには以下を含める必要があります。
access_token
privacy_url
message
、reply_type
、step_id
、step_type
を含むstep_list
配列template_name
reminder_text
以下のメッセージテンプレートには、template_name
、privacy_url
、step_id: 0
にウェルカムメッセージが含まれるstep_list
、step_id: 1
~4
の質問、step_id: 5
の確認メッセージ、step_id: 6
の対象外メッセージが含まれます。
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"
}
]
}'
成功すると、アプリはテンプレートのIDを含むJSONオブジェクトを受け取ります。
{ "id": "your_messenger_lead_gen_template_id" }
fblead_form
も作成され、この処理の一部としてメッセージテンプレートに関連付けられます。
Messengerリード獲得フォームテンプレートのリストを取得するには、/page_id/messenger_lead_forms
エンドポイントにGET
リクエストを送信します。また、/
Your_messenger_lead_gen_template_id
エンドポイントにGET
リクエストを送信することによって、特定のテンプレートに関する情報を取得することもできます。
リード獲得広告の広告クリエイティブを作成するには、/act_
ad_account_id
/adcreatives
エンドポイントにPOST
リクエストを送信します(ad_account_id
はMeta広告アカウントのID)。リクエストには以下を含める必要があります。
access_token
name
object_story_spec
で、メディアタイプ、画像、動画を定義する*_data
が指定されており、以下を含むもの。
*_data.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_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"
}
}
}'
詳細については、投稿をInstagram広告として使用するを参照してください。
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
詳細については、投稿をInstagram広告として使用する: Facebook投稿を参照してください。
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
はpostOwnerID_postID
形式の投稿IDであり、instagram_actor_id
はページ連動InstagramアカウントIDまたはページバックInstagramアカウント IDです。詳細は、ページでInstagramアカウントを設定するをご覧ください。
広告を作成するために広告クリエイティブと広告セットを関連付ける必要があります。広告を作成するには、POST
リクエストを/act_ad_account_id/ads
エンドポイントに送信します。このad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。
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"
}'
成功すると、アプリは広告のIDを含む次のJSON応答を受け取ります。
{ "id": "ad_id" }
広告を作成する際にコールトゥーアクションを設定することもできます。
"call_to_action": { "value": {"app_destination":"MESSENGER"}, "type": "MESSAGE_PAGE" }
通話プロンプトや複数のテンプレートなど、複数のメッセージ要素を含むメッセージを作成できます。これらの要素を追加するには、文字列値の代わりに*_data.page_welcome_message
値のオブジェクトの配列を設定します。
*_data.page_welcome_message
の値を、通話プロンプト要素を定義するオブジェクトの配列に設定すると、Messenger誘導広告に通話プロンプトを追加できます。landing_screen_type
パラメーターをcall_prompt
に、media_type
をtext
に設定し、text
にウェルカムメッセージテキストを設定したtext_format.message
オブジェクトを指定し、ビジネスへの通話を促すプロンプトをcall_prompt_data.call_prompt_message
に設定します。
... "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" } } }, } ]" ...
複数のテンプレートを使用して広告を作成するには、*_data.page_welcome_message
パラメーターにメッセージテンプレートを含む配列を設定します。次の例では、クイック返信用のテンプレートを追加します。
... "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 ' } ] } }]", ...
まだしていなければ、広告がクリックされたときの通知を受け取るために、Webhooksを設定してください。
マーケティングAPIについての詳細や、Messenger誘導広告の追加オプションをご確認ください。