このガイドでは、マーケティングAPIを使って複数リンク先誘導広告を作成し、公開する方法について説明します。
複数リンク先誘導広告では、広告をクリックした利用者を、応答する可能性が最も高い1つまたは複数のメッセージアプリ(Messenger、Instagram、WhatsApp)でのビジネスとのスレッドに直接誘導します。この広告を利用することで、顧客に大規模にリーチし、優れたサービスをパーソナライズして提供できます。
複数リンク先誘導広告とは、Messengerチャット、Instagramチャット、WhatsAppチャットの任意の組み合わせをリンク先とする広告のことです。
リンク先が1つだけの広告を作成する場合は、次の資料をご覧ください。
このドキュメントでは、複数リンク先誘導広告のための統合を設定する手順の概要を説明します。次のことをする必要があります。
まず広告キャンペーンを作成します。そのためには、/act_<AD_ACCOUNT_ID>/campaigns
エンドポイントに対して、POST
リクエストを送信します(<AD_ACCOUNT_ID>
はMeta広告アカウントのID)。リクエストには以下を含める必要があります。
名前 | 説明 |
---|---|
文字列 | 必須。 |
列挙型 | 必須。 |
list<Object> | 必須。 |
列挙型 | 任意。 |
curl -X POST \
-F 'name=Click to Multi Destination Campaign' \
-F 'objective=OUTCOME_ENGAGEMENT' \
-F 'status=ACTIVE' \
-F 'special_ad_categories=[]' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/campaigns
成功すると、アプリは新たに作成されたキャンペーンのIDを含むJSONの応答を受け取ります。
{ "id": "<AD_CAMPAIGN_ID>" }
/<AD_CAMPAIGN_ID>
に対してPOST
リクエストを発行することにより、キャンペーンを更新することができます。
複数リンク先誘導キャンペーンの作成が成功したことを確認するには、/<AD_CAMPAIGN_ID>
にGET
リクエストを発行します。利用可能な全パラメーターのリストについては、広告キャンペーンのリファレンスをご覧ください。
curl -X GET -G \
-d 'fields=name,status,objective' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<AD_CAMPAIGN_ID>
{ "name": "Click to Multi Destination Campaign", "status": "ACTIVE", "objective": "OUTCOME_ENGAGEMENT", "id": "<AD_CAMPAIGN_ID>" }
広告キャンペーンが作成されたら、広告セットを作成します。広告セットを作成するには、/act_<AD_ACCOUNT_ID>/adsets
エンドポイントに対して、POST
リクエストを送信します(<AD_ACCOUNT_ID>
はMeta広告アカウントのID)。リクエストには以下を含める必要があります。
名前 | 説明 |
---|---|
符号なしint32 | bid_strategyが |
列挙型 | 任意。 |
列挙型 | 必須。 |
数値文字列または整数 | 必須。 |
int64 |
|
文字列 | 必須。
注: WhatsAppをリンク先に含める場合は、自分のページにリンクされているWhatsApp Business番号があることを確認してください。Instagramをリンク先に含める場合は、自分のページにリンクされているInstagramビジネスアカウントがあることを確認してください。 |
datetime |
|
int64 |
|
文字列 | 必須。 |
列挙型 | 必須。 |
| 必須。
詳しくは、広告セット、宣伝の対象物をご覧ください。 |
datetime | 任意。 |
列挙型 | 任意。 |
ターゲット設定オブジェクト | 必須。 |
datetime | 任意。 |
datetime |
|
利用可能なパラメーターの一覧については、広告アカウント広告セットのリファレンスをご覧ください。
curl -X POST \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
-F 'billing_event=IMPRESSIONS' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'daily_budget=<DAILY_BUDGET>' \
-F 'destination_type=<DESTINATION_TYPE>' \
-F 'name=<AD_SET_NAME>' \
-F 'optimization_goal=CONVERSATIONS' \
-F 'promoted_object={
"page_id": "<PAGE_ID>"
}' \
-F 'status=ACTIVE' \
-F 'start_time=<START_TIME>' \
-F 'targeting={
"geo_locations": { "countries":["US","CA"] },
"device_platforms": ["mobile", "desktop"]
}' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adsets
成功すると、アプリは新たに作成された広告セットのIDを含むJSON応答を受け取ります。
{ "id": "<AD_SET_ID>" }
/<AD_SET_ID>
に対してPOST
リクエストを発行することにより、広告セットを更新することができます。
複数リンク先誘導広告セットの作成が成功したことを確認するには、/<AD_SET_ID>
にGET
リクエストを発行します。利用可能なパラメーターの一覧については、広告セットのリファレンスをご覧ください。
curl -X GET -G \
-d 'fields=name,destination_type,optimization_goal,bid_strategy' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<AD_SET_ID>
{ "name": "<AD_SET_NAME>", "destination_type": "<DESTINATION_TYPE>", "optimization_goal": "CONVERSATIONS", "bid_strategy": "LOWEST_COST_WITHOUT_CAP'" "id": "<AD_SET_ID>" }
広告クリエイティブを使用して、広告にアセットを追加できます。広告クリエイティブを作成するには、/act_<AD_ACCOUNT_ID>/adcreatives
エンドポイントに対して、POST
リクエストを送信します(<AD_ACCOUNT_ID>
はMeta広告アカウントのID)。リクエストには以下を含める必要があります。
名前 | 説明 |
---|---|
| 必須。 必須
Messenger { "type": "MESSAGE_PAGE", "value": { "app_destination": "MESSENGER", "link": "https://fb.com/messenger_doc/" } } { "type": "WHATSAPP_MESSAGE", "value": { "app_destination": "WHATSAPP", "link": "https://api.whatsapp.com/send" } } { "type": "INSTAGRAM_MESSAGE", "value": { "app_destination": "INSTAGRAM_DIRECT", "link": "https://www.instagram.com" } } |
文字列 | 必須。 |
| 必須。 必須
任意
|
| 任意。 |
利用可能なパラメーターの一覧については、広告クリエイティブのリファレンスをご覧ください。
顧客に対して表示されるデフォルトのメッセージは「こんにちは!これについての詳しい情報をいただけますか?」というものです。object_story_spec
の下のpage_welcome_message
フィールドの中で、広告のあいさつメッセージ、icebreaker、自動入力メッセージをカスタマイズすることにより、複数リンク先誘導広告のユーザーエクスペリエンスをさらに調整することができます。
Icebreakerについて詳しくは、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" }
page_welcome_message
フィールドを次のようにクリエイティブに追加します。
curl -X POST \
-F 'name=<CREATIVE_NAME>' \
-F 'object_story_spec={
"page_id": "438346666550309",
"link_data": {
"name": "<AD_HEADLINE>",
"message": "<AD_PRIMARY_TEXT>",
"image_hash": "<IMAGE_HASH>"
"link": "https://fb.com/messenger_doc/",
"page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
"call_to_action": {
"type": "MESSAGE_PAGE",
"value": {
"app_destination": "MESSENGER"
}
}
}
}' \
-F 'asset_feed_spec={
"optimization_type": "DOF_MESSAGING_DESTINATION",
"call_to_actions": [
{
"type": "MESSAGE_PAGE",
"value": {
"app_destination": "MESSENGER",
"link": "https://fb.com/messenger_doc/"
}
},
{
"type": "WHATSAPP_MESSAGE",
"value": {
"app_destination": "WHATSAPP",
"link": "https://api.whatsapp.com/send"
}
},
{
"type": "INSTAGRAM_MESSAGE",
"value": {
"app_destination": "INSTAGRAM_DIRECT",
"link": "https://www.instagram.com"
}
}
]
}' \
-F 'degrees_of_freedom_spec={
"creative_features_spec": {
"standard_enhancements": {
"enroll_status": "OPT_IN"
}
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
成功すると、アプリは新たに作成されたクリエイティブのIDを含むJSONの応答を受け取ります。
{ "id": "<AD_CREATIVE_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アカウントを設定するをご覧ください。
/<AD_CREATIVE_ID>
に対してPOST
リクエストを発行することにより、広告クリエイティブを更新できます。
複数リンク先誘導広告クリエイティブの作成が成功したことを確認するには、/<AD_CREATIVE_ID>
にGET
リクエストを発行します。利用可能なパラメーターの一覧については、広告クリエイティブをご覧ください。
curl -X GET -G \
-d 'fields=name,object_story_spec{page_welcome_message},asset_feed_spec' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<AD_CREATIVE_ID>
{ "name": "<CREATIVE_NAME>", "object_story_spec": { "page_welcome_message": { "type": "VISUAL_EDITOR", "version": 2, "landing_screen_type": "welcome_message", "media_type": "text", "text_format": { "customer_action_type": "ice_breakers", "message": { "text": "Sample greeting message", "ice_breakers": [ { "title": "Sample icebreaker" }, { "title": "Sample icebreaker" }, { "title": "Sample icebreaker" } ] } } } }, "asset_feed_spec": { "optimization_type": "DOF_MESSAGING_DESTINATION", "call_to_actions": [ { "type": "MESSAGE_PAGE", "value": { "app_destination": "MESSENGER", "link": "https://fb.com/messenger_doc/" } }, { "type": "WHATSAPP_MESSAGE", "value": { "app_destination": "WHATSAPP", "link": "https://api.whatsapp.com/send" } }, { "type": "INSTAGRAM_MESSAGE", "value": { "app_destination": "INSTAGRAM_DIRECT", "link": "https://www.instagram.com" } } ] }, "id": "<AD_CREATIVE_ID>" }
広告により、広告クリエイティブの情報を広告セットに関連付けることができます。広告を作成するには、/act_<AD_ACCOUNT_ID>/ads
エンドポイントに対して、POST
リクエストを送信します(<AD_ACCOUNT_ID>
はMeta広告アカウントのID)。リクエストには以下を含める必要があります。
名前 | 説明 |
---|---|
文字列 | 必須。 |
数値文字列または整数 | 必須。 |
| 必須。 |
列挙型 | 必須。 |
curl -X POST \
-F 'name=<AD_NAME>' \
-F 'adset_id=<AD_SET_ID> \
-F 'creative={
"creative_id": "<AD_CREATIVE_ID>"
}' \
-F 'status=ACTIVE \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/ads
成功すると、アプリは新たに作成された広告のIDを含むJSON応答を受け取ります。
{ "id": "<AD_ID>" }
広告を作成する際にコールトゥアクションを設定することもできます。
"asset_feed_spec": { "optimization_type": "DOF_MESSAGING_DESTINATION", "call_to_actions": [ { "type": "MESSAGE_PAGE", "value": { "app_destination": "MESSENGER", "link": "https://fb.com/messenger_doc/" } }, { "type": "INSTAGRAM_MESSAGE", "value": { "app_destination": "INSTAGRAM_DIRECT", "link": "https://www.instagram.com" } } ] }
詳細は、アセットフィードの仕様のドキュメントをご覧ください。
/<AD_ID>
に対してPOST
リクエストを発行することにより、広告を更新できます。
複数リンク先誘導広告の作成が成功したことを確認するには、/<AD_ID>
にGET
リクエストを発行します。利用可能なパラメーターの一覧については、広告のリファレンスをご覧ください。
curl -X GET -G \
-d 'fields=status,adset_id \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<AD_ID>
{ "status": "ACTIVE", "adset_id": "<AD_SET_ID>", "id": "<AD_ID>" }