Click-to-Messenger Ads

Click-to-Messenger Ads

Um eine Anzeigengestaltung für eine Click-to-Messenger Ad zu erstellen, sendest du eine POST-Anfrage an den /act_ad_account_id/adcreatives-Endpunkt, wobei ad_account_id die ID für dein Meta-Werbekonto ist. Deine Anfrage muss Folgendes enthalten:

• access_token
• name
• object_story_spec mit einem *_data-Objekt, das den Medientyp definiert

Kurzreferenz für Image Ads

Beispielanfrage für Image Ads

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

Kurzreferenz für Click-to-Messenger Video Ads

Beispielanfrage für Video Ads

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

Anzeige mit einem Messaging-Flow, der in einer Partner-App konfiguriert wurde

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

Weitere Informationen zu Messaging-App-Flows findest du unter Begrüßungsnachrichten-Abläufe in der Dokumentation zur Messenger-Plattform.

Click-to-Subscribe Ads

Anzeigen, die per Klick zum Abonnieren weiterleiten (Click To Subscribe, CTS) sind Click-to-Messenger Ads, bei denen object_story_spec.page_welcome_message ein Array aus Objekten mit einer Nachrichtenvorlage ist. Wenn eine Person auf den Button Nachrichten erhalten in deiner Anzeige klickt, stimmt die Person dem Erhalt von Marketing-Nachrichten deines Unternehmens zu.

Um eine Anzeigengestaltung für Anzeigen, die per Klick zum Abonnieren weiterleiten, zu erstellen, sendest du eine POST-Anfrage an den /act_ad_account_id/adcreatives-Endpunkt, wobei ad_account_id die ID für dein Meta-Werbekonto ist. Deine Anfrage muss Folgendes enthalten:

• access_token
• name
• object_story_spec mit

  • einem *_data-Objekt, das den Medientyp definiert.
  • Das page_welcome_message-Array, das die Opt-in-Anfrage für Marketing-Nachrichten definiert. Muss landing_screen_type beinhalten, welcher auf marketing_messages festgelegt wird, und den Nachrichtenanhang payload.template_type, der auf nofitication_messages festgelegt wird.

Beispielanfrage für Image Ads

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

Lead Ads in Unterhaltungen

Mit Messenger Ads für Leads kannst du über eine automatisierte Chatvorlage Leads im Messenger generieren. Du kannst Personen, die sich für dein Unternehmen interessieren, direkt auf deiner bevorzugten Messaging-Plattform bestimmte Fragen stellen, Kund*innenpräferenzen erfassen und selbstdefinierte Fragen stellen, um die qualifiziertesten Leads zu priorisieren.

Anforderungen an Nachrichtenvorlagen

• Eine Begrüßungsnachricht, die Personen begrüßt, nachdem sie auf deine Anzeige getippt haben, und ihnen mitteilt, was dein Unternehmen anbietet.
• Fragen, die Informationen darüber sammeln, ob die Person ein Lead ist. Dazu können Fragen über Interessen, Standort und Kontaktinformationen wie E-Mail-Adresse und Telefonnummer gehören.
• Eine Bestätigungsnachricht, mit der du Personen für ihre Antworten danken und ihnen mitteilen kannst, was der nächste Schritt ist. Du findest deinen neuen Lead im Werbeanzeigenmanager, in den Beitragsoptionen deiner Seite oder in deinem CRM.
• Eine Datenschutzrichtlinie, da du Kund*inneninformationen sammelst.

Einschränkungen

• Nachrichtenvorlagen können nach ihrer Erstellung weder bearbeitet noch gelöscht werden.

Nachrichtenvorlage erstellen

Um eine Nachrichtenvorlage zu erstellen, sendest du eine POST-Anfrage an den /page_id/messenger_lead_forms-Endpunkt, wobei page_id die ID der Facebook-Seite deines Unternehmens ist. Deine Anfrage muss Folgendes enthalten:

• access_token
• privacy_url
• step_list-Array mit message, reply_type, step_id und step_type
• template_name
• reminder_text

Die folgende Nachrichtenvorlage enthält deinen template_name, deine privacy_url, deine step_list mit einer Begrüßungsnachricht in step_id: 0, Fragen in step_id: 1 bis 4, einer Bestätigungsnachricht in step_id: 5 und einer Disqualifizierungsnachricht in step_id: 6.

Kurzreferenz zu Nachrichtenvorlagen

Beispielvorlage für Leads-Nachrichten

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

Bei Erfolg erhält deine App ein JSON-Objekt, das die ID der Vorlage enthält.

{
  "id": "your_messenger_lead_gen_template_id"
}

In diesem Prozess wird auch eine fblead_form erstellt und der Nachrichtenvorlage zugeordnet.

Liste mit Formularen abrufen

Um eine Liste der Formularvorlagen zur Messenger-Leadgenerierung abzurufen, kannst du eine GET-Anfrage an den /page_id/messenger_lead_forms-Endpunkt senden. Du kannst Informationen zu einer bestimmten Vorlage auch abrufen, indem du eine GET-Anfrage an den /Your_messenger_lead_gen_template_id-Endpunkt sendest.

Beispiele für die Anzeigengestaltung

Um eine Anzeigengestaltung für Lead Ads zu erstellen, sendest du eine POST-Anfrage an den /act_ad_account_id/adcreatives-Endpunkt, wobei ad_account_id die ID für dein Meta-Werbekonto ist. Deine Anfrage muss Folgendes enthalten:

• access_token
• name
• object_story_spec mit einem *_data-Objekt, das den Medientyp (Bild oder Video) definiert und Folgendes enthält:

  • den Parameter *_data.page_welcome_message, der auf das Schlüssel-Wert-Paar

    • ctm_lead_gen_template_id:Your_messenger_lead_gen_template_id festgelegt ist

Beispiel-Anzeigengestaltung für Messenger Ads bei Leads mit einem Bild

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

Beispiel-Anzeigengestaltung für Messenger Ads bei Leads mit einem Video

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