Click-to-Messenger Ads

In diesem Leitfaden wird erläutert, wie du Click-to-Messenger Ads mit der Marketing API erstellen und veröffentlichen kannst.

Wenn du mit dem Werbeanzeigenmanager eine Kampagne für Lead Ads erstellen möchtest, besuche den Meta-Hilfebereich für Unternehmen.

Click-to-Messenger Ads leiten Personen, die auf deine Werbeanzeigen klicken, direkt zu Unterhaltungen mit deinem Unternehmen im Messenger weiter. Mithilfe dieser Anzeigen kannst du einen großen Personenkreis erreichen und einen herausragenden, individuellen Service bieten.

Click-to-Messenger Ads unterstützen Werbeanzeigen mit einem Bild, einem Video, einem Carousel oder einer Slideshow. Du kannst außerdem Anrufaufforderungen in deine Anzeige integrieren.

Wenn du Werbeanzeigen erstellen möchtest, die Personen zu Instagram- oder WhatsApp-Chats weiterleiten, findest du unter Click-to-Instagram Ads oder Click-to-WhatsApp Ads entsprechende Anleitungen. Du kannst auch Werbeanzeigen erstellen, die das Ziel auswählen, von dem aus der*die Nutzer*in am ehesten reagiert. Mehr dazu findest du unter Click-to-Multidestination Ads.

Übersicht über die Anzeigenerstellung

Führe die folgenden Schritte aus, um eine Anzeige zu erstellen und zu veröffentlichen:

  1. Erstelle eine Werbekampagne
  2. Erstelle eine Anzeigengruppe, die deine Werbeanzeigen mit deiner Werbekampagne verbindet
  3. Erstelle eine Anzeigengestaltung für deinen gewünschten Messenger Ad-Typ
  4. Erstelle eine Werbeanzeige, indem du deine Anzeigengestaltung mit deiner Anzeigengruppe verknüpfst
  5. Veröffentliche deine Werbeanzeige auf Facebook, auf Instagram und im Messenger

Bevor du beginnst

Voraussetzungen für diesen Leitfaden:

Um erfolgreiche Aufrufe an alle Endpunkte zu tätigen, benötigst du Folgendes:

  • Einen Seiten-Zugriffsschlüssel, der von einer Person angefordert wurde, die auf der Seite die ADVERTIZE-Aufgabe ausführen kann.
  • Einer Person, die deine App nutzt, müssen die folgenden Berechtigungen gewährt werden:
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

Schritt 1: Kampagne erstellen

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

  • access_token
  • buying_type
  • name
  • objective festgelegt auf OUTCOME_TRAFFIC oder OUTCOME_LEADS für Lead Ads
  • special_ad_categories
  • status

Kurzreferenz für Werbekampagnen

Beispielanfrage

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie ad_account_id durch deine Werte.
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"],
         }'

Bei Erfolg erhält deine App eine JSON-Antwort mit der ID deiner Kampagne.

{
  "id": "campaign_id"
}

Schritt 2: Anzeigengruppe erstellen

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

  • access_token
  • bid_amount
  • billing_event festgelegt auf IMPRESSIONS
  • campaign_id
  • daily_budget
  • destination_type festgelegt auf MESSENGER
  • name
  • optimization_goal festgelegt auf CONVERSATIONS, IMPRESSIONS oder LEAD_GENERATION bzw. QUALITY_LEAD für Lead Ads
  • promoted_object – festgelegt auf die ID für die Facebook-Seite deines Unternehmens.
  • status auf PAUSED festgelegt
  • targeting

Kurzreferenz für Anzeigengruppen

Beispielanfrage

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie ad_account_id durch deine Werte.
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"] 
           } 
         }'

Bei Erfolg erhält deine App die folgende JSON-Antwort mit der Anzeigengruppen-ID.

{
  "id": "adset_id"
}

Schritt 3: Anzeigengestaltung erstellen

Die Anzeigengestaltung ermöglicht das Hinzufügen von Assets zu deinen Anzeigen.

Einschränkungen

  • Anzeigen, die mit object_story_id erstellt wurden, werden nicht unterstützt.
  • Um deine Anzeige zu sehen, muss die Person den Messenger auf ihrem Gerät installiert haben.
  • Es gibt keine Unterstützung für Platzierungen auf der rechten Seite.

Um eine Anzeigengestaltung 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 – erforderlich
  • privacy_url – erforderlich für Lead Ads
  • standard_enhancements.enroll_status – erforderlich für Anzeigengestaltungen, die zu Standardoptimierungen berechtigt sind.

Kurzreferenz für übergeordnete Anzeigengestaltungsparameter

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

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie page_access_token mit deinen Werten.
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" }
               }   
             }
           }
         }'          

Kurzreferenz für Click-to-Messenger Video Ads

Beispielanfrage für Video Ads

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie page_access_token durch deine Werte.
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"
             } 
           }
         }'

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

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie page_access_token durch deine Werte.
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"
             }
           }
         }'

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

Ausfüllen einer Begrüßungsnachricht für die Seite

Die Standardnachricht, die ein*e Kund*in sieht, lautet: „Hallo! Kann ich mehr Infos dazu bekommen?“ Du kannst individuellere Nutzungserlebnisse für deine Click-to-Messenger Ads schaffen, indem du die Grußbotschaft deiner Werbeanzeigen, Eisbrecher und Autofill-Nachrichten im Feld page_welcome_message unter object_story_spec personalisierst.

Weitere Informationen zu Eisbrechern findest du in der ice_breakers-Referenz.

Einschränkungen

  • Titel von Eisbrechern dürfen höchstens 80 Zeichen lang sein.
  • Eisbrecherantworten dürfen höchstens 300 Zeichen lang sein.
  • Der Nachrichtentext darf höchstens 300 Zeichen lang sein.

Beispiel

Erstelle das Objekt page_welcome_message, um Eisbrecher mit einer Begrüßungsnachricht hinzuzufügen.

"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"
}

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

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie ad_account_id durch deine Werte.
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"
                             }]
                         }]
                       }
                     }
                   } 
                 }
               }"
             }
           }
         }'          

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.

Bevor du Anzeigengestaltungen für Messenger Ads für Leads erstellen kannst, musst du die Nutzungsbedingungen für Messenger Ads für Leads akzeptieren.

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

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie page_access_token durch deine Werte.
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"
             }
           ]
        }'

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

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie ad_account_id durch deine Werte.
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" }"
            }
          }
       }' 

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

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie ad_account_id durch deine Werte.
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" 
            }
          }
       }' 

Erstellen von Anzeigengestaltungen mit Instagram-Content

Instagram-Beiträge

Weitere Einzelheiten findest du unter Verwenden von Beiträgen als Instagram-Werbeanzeigen.

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

Instagram-Bilder

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

Erstellen von Anzeigengestaltungen mit Facebook-Content

Weitere Einzelheiten findest du unter Verwenden von Beiträgen als Instagram-Werbeanzeigen: Facebook-Beiträge.

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>"

Dabei ist object_story_id die Beitrags-ID im Format postOwnerID_postID und instagram_actor_id entweder die ID eines mit einer Seite verbundenen Instagram-Kontos oder die ID eines auf einer Seite basierenden Instagram-Kontos. Mehr dazu erfährst du unter Einrichten von Instagram-Konten mit Seiten.

Schritt 4: Anzeige erstellen

Um die Anzeige zu erstellen, musst du die Anzeigengestaltung der Anzeigengruppe zuordnen. Um die Anzeige zu erstellen, sendest du eine POST-Anfrage an den /act_ad_account_id/ads-Endpunkt, wobei ad_account_id die ID für dein Meta-Werbekonto ist. Deine Anfrage muss Folgendes enthalten:

Kurzreferenz für Werbekonto-Anzeigen

Beispielanfrage für eine Anzeige mit Anzeigengestaltung

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie ad_account_id durch deine Werte.
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"
         }'

Bei Erfolg erhält deine App die folgende JSON-Antwort mit der Anzeigen-ID.

{
  "id": "ad_id"
}

Call-to-Action

Du kannst beim Erstellen deiner Werbeanzeige auch einen Call-to-Action festlegen.

"call_to_action": {
  "value": {"app_destination":"MESSENGER"},
  "type": "MESSAGE_PAGE"
}

Schritt 5: Anzeige veröffentlichen

Prüfe im Werbeanzeigenmanager , ob deine Anzeige vorhanden ist. Klicke auf den Button Überprüfen und veröffentlichen in der oberen rechten Ecke. Wähle deine Kampagne, die Anzeigengruppe für die Kampagne und die Anzeige aus.

Du kannst deine Anzeige über den Werbeanzeigenmanager oder mithilfe der API veröffentlichen. Um die Anzeige über die API zu veröffentlichen, wiederhole Schritt 4 und lege für statusACTIVE fest.

Deine Anzeige wird von Meta überprüft und der Status wird auf PENDING_REVIEW gesetzt. Sobald die Anzeige genehmigt ist, wechselt der Status zu ACTIVE und deine Anzeige wird ausgeliefert.

Erweiterte Click-to-Messenger-Elemente

Du kannst Nachrichten erstellen, die mehr als ein Nachrichtenelement enthalten (z. B. eine Anrufaufforderung oder mehrere Vorlagen). Du kannst diese Elemente hinzufügen, indem du für den Wert *_data.page_welcome_message anstatt eines String-Werts ein Array aus Objekten festlegst.

Kurzreferenz für das Begrüßungsnachricht-Array der Seite

Anrufaufforderung hinzufügen

Du kannst eine Anrufaufforderung zu deiner Click-to-Messenger Ad hinzufügen, indem du für den Wert von *_data.page_welcome_message ein Array aus Objekten festlegst, das deine Anrufaufforderungs-Elemente definiert. Lege für den landing_screen_type-Parameter call_prompt fest, für den media_typetext, im Objekt text_format.message gibst du für den text den Text deiner Begrüßungsnachricht an und für die call_prompt_data.call_prompt_message eine Aufforderung, dein Unternehmen anzurufen.

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie page_access_token durch deine Werte.
... 
      "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"
              }
            }
          },
        }
      ]"
...

Eine oder mehrere Vorlagen hinzufügen

Um eine Anzeige mit mehreren Vorlagen zu erstellen, lege für den Parameter *_data.page_welcome_message ein Array mit einer Nachrichtenvorlage fest. Das folgende Beispiel fügt eine Vorlage für eine Schnellantwort hinzu.

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie page_access_token durch deine Werte.
... 
      "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  '
            }
          ]
        }
      }]",
...

Nächste Schritte

Richte Webhooks ein, um Benachrichtigungen zu erhalten, wenn eine Person auf deine Anzeige klickt, falls du noch keine eingerichtet hast.