Messenger誘導広告

Messenger誘導広告

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/v19.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" }
               }   
             }
           }
         }'          

Messenger動画誘導広告のクイックリファレンス

動画広告のリクエストの例

curl -X POST "https://graph.facebook.com/v19.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/v19.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プラットフォームのドキュメントにあるウェルカムメッセージのフローを参照してください。

サブスクリプション登録誘導広告

購読登録誘導広告(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/v19.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でリードを獲得することができます。自分で選んだメッセージプラットフォームであなたのビジネスに興味がある人に特定の質問を直接尋ねたり、顧客の好みを収集したり、カスタムの質問をしたりして、厳密に絞り込んだリードを優先することができます。

メッセージテンプレートの要件

• 広告をタップした人にあいさつし、何を取り扱うビジネスなのかを知らせるためのウェルカムメッセージ
• その人がリードかどうかについての情報を収集するための質問。これには、興味・関心、位置情報、メールアドレスや電話番号などの連絡先情報に関する質問を含めることができます。
• 回答に感謝し、次に行われることを知らせる確認メッセージ。新しいリードは、広告マネージャ、ページの投稿ツール、またはCRMで確認することができます。
• プライバシーポリシー。顧客情報を収集するので必要です。

制限

• メッセージテンプレートをいったん作成したら、編集や削除はできません

メッセージテンプレートを作成する

メッセージテンプレートを作成するには、/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/v19.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

画像を使うリード獲得用Messenger広告のクリエイティブの例

curl -X POST "https://graph.facebook.com/v19.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" }"
            }
          }
       }' 

動画を使うリード獲得のMessenger広告のクリエイティブの例

curl -X POST "https://graph.facebook.com/v19.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" 
            }
          }
       }' 

広告メッセージ

スポンサードメッセージは、ビジネスのFacebookページとの既存のMessengerスレッドがあるすべてのアカウントセンター内アカウントに、メッセージとして送信できる広告タイプです。利用者層データ、地理データ、カスタムオーディエンス、興味・関心など、他のターゲット条件を含めることもできます。 要件 ユーザーがスポンサードメッセージを受信しないようにするためにカスタムオーディエンスを使用することはしないでください targeting.publisher_platformsには、messengerのみを指定してください targeting.messenger_positionsには、sponsored_messagesのみを指定してください device_platformsには、mobileとdesktopの両方を指定してください promoted_objectには、ビジネスのFacebookページのIDを指定してください ボタンには、ペイロードまたはURLを指定する必要があります スレッドでは、メッセージの受信をオプトアウトするか、デスクトップデバイスとモバイルデバイスの両方でメッセージをブロックするかのオプションを提供する必要があります。 制限 billing_event=IMPRESSIONSとoptimization_goal=IMPRESSIONSのCPMのみがサポートされます。最低入札価格は国によって異なります。詳しくはこちら。 ボタン付きのテキストや画像か、クイック返信のみがサポートされています。

スポンサードメッセージの広告クリエイティブを作成するには、FacebookページのIDに設定したobject_idパラメーター、SHAREに設定したobject_type、広告のテキストに設定したmessage.textパラメーターを含むmessenger_sponsored_messageオブジェクト、次のパラメーターを含むmessage.attachmentオブジェクトをリクエストに含める必要があります。

Messengerのスポンサードメッセージの添付メッセージのクイックリファレンス

広告画像クリエイティブのリクエストの例

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token"
           "object_id": "Your_page_id",
           "object_type": "SHARE",
           "messenger_sponsored_message": {
             "message":{
               "text":"Your_ad_creative_text",
               "attachment":{
                 "type":"template",   
                 "payload":{
                   "template_type":"generic", 
                   "elements":[{
                     "title":"Your_image_text",
                     "image_hash":"Your_image_hash",
                     "buttons":[{
                       "type":"web_url", 
                       "title":"Your_button_text", 
                       "url":"Your_destination_URL"
                     }]
                   }]
                 }
               }
             }
           }
         }'

クイック返信広告クリエイティブのリクエストの例

クイック返信メッセージを含むスポンサードメッセージを作成するには、messenger_sponsored_message.messageオブジェクトに、質問かディレクティブを設定したtextと、各クイック返信オプションのquick_replies配列を設定します。

curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "access_token": "Your_page_access_token"
           "object_id": "Your_page_id",
           "object_type": "SHARE",
           "messenger_sponsored_message": {
             "message":{
               "text":"Your_ad_creative_text",
               "quick_replies":[
                 {
                   "content_type": "text",
                   "title": "Your_reply_first_option_reply",
                   "payload": "Information_sent_via_postback_webhook_when_option_1_is_selected"
                 },
                 {
                   "content_type": "text",
                   "title": "Your_reply_second_option_reply",
                   "payload": "Information_sent_via_postback_webhook_when_option_2_is_selected"
                 }
               ]              
             }
           }'