Marketing API

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 Karussell 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 der Nutzer 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. Erstellen eine Werbekampagne
  2. Erstelle eine Anzeigengruppe, die deine Werbeanzeigen mit deiner Werbekampagne verbindet
  3. Erstelle eine Anzeigengestaltung für deinen gewünschten den Messenger Ad-Typ
  4. Erstelle eine Werbeanzeige, indem du deine Anzeigengestaltung mit deiner Anzeigengruppe verknüpfst
  5. Veröffentliche deine Werbeanzeige auf Facebook, 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:

  • Ein 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 mit deinen Werten.
curl -X POST "https://graph.facebook.com/v19.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. Erforderlich für werbliche Nachrichten
  • status auf PAUSED festgelegt
  • targeting – bei werblichen Nachrichten muss device_platforms sowohl Mobile als auch Desktop enthalten.

Kurzreferenz für Anzeigengruppen

Beispielanfrage

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie ad_account_id mit deinen Werten.
curl -X POST "https://graph.facebook.com/v19.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
  • messenger_sponsored_message – erforderlich für werbliche Nachrichten
  • name
  • object_id – erforderlich für werbliche Nachrichten
  • object_story_spec – erforderlich
  • object_type – erforderlich für werbliche Nachrichten
  • 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/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" }
               }   
             }
           }
         }'

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 mit deinen Werten.
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"
             } 
           }
         }'

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 mit deinen Werten.
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"
             }
           }
         }'

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

Anzeigen, die per Klick zum Abonnieren weiterleiten

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 Einwilligungsanfrage 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 mit deinen Werten.
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"
                             }]
                         }]
                       }
                     }
                   } 
                 }
               }"
             }
           }
         }'

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 mit deinen Werten.
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"
             }
           ]
        }'

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 mit deinen Werten.
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" }"
            }
          }
       }'

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 mit deinen Werten.
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" 
            }
          }
       }'

Werbliche Nachrichten sind ein Anzeigentyp, der als Nachricht an alle Kontenübersichts-Konten gesendet werden kann, die eine bestehende Messenger-Unterhaltung mit der Facebook-Seite deines Unternehmens haben. Du kannst auch andere Targeting-Kriterien festlegen, beispielsweise demografische oder geografische Daten, Custom Audiences oder Interessen.

Anforderungen

  • Verwende keine Custom Audiences , um Nutzer*innen vom Erhalt werblicher Nachrichten auszuschließen.
  • Für targeting.publisher_platforms darf nur messenger festgelegt sein.
  • Für targeting.messenger_positions darf nur sponsored_messages festgelegt sein.
  • Für device_platforms muss sowohl mobile als auch desktop festgelegt sein.
  • promoted_object muss die Facebook-Seiten-ID deines Unternehmens sein.
  • Du musst die Payload bzw. URL für den Button angeben.
  • Du musst innerhalb der Unterhaltung Optionen bereitstellen, um den Erhalt von Nachrichten zu widerrufen oder Nachrichten sowohl auf Desktop- als auch auf Mobilgeräten zu blockieren.

Einschränkung

  • Es werden nur CPMs mit billing_event=IMPRESSIONS und optimization_goal=IMPRESSIONS unterstützt. Das Mindestgebot variiert je nach Land. Mehr erfahren.
  • Nur Text oder Bilder mit Buttons oder Schnellantworten werden unterstützt.

    Um eine Anzeigengestaltung für eine werbliche Nachricht zu erstellen, sollte deine Anfrage den Parameter object_id beinhalten, für den die ID deiner Facebook-Seite festgelegt ist. Für object_type muss SHARE festgelegt werden und für das Objekt messenger_sponsored_message wird der Parameter message.text auf den Text der Anzeige festgelegt. Das Objekt message.attachment muss die folgenden Parameter beinhalten:

    Kurzreferenz für den Nachrichtenanhang einer werblichen Nachricht in Messenger

    Beispielanfrage für eine Image-Anzeigengestaltung

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

    Beispielanfrage für eine Schnellantwort bei einer Image-Anzeigengestaltung

    Um eine werbliche Nachricht mit einer Schnellantwort-Nachricht zu erstellen, lege im messenger_sponsored_message.message-Objekt für den text deine Frage oder Anweisung fest und füge ein quick_replies-Array für jede Schnellantwort-Option hinzu.

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

    Beispielantwort für die Anzeigengestaltung

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

    {
  "id": "ad_creative_id"
}

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

    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 zum Anrufen deines Unternehmens.

    Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie page_access_token mit deinen Werten.
    ... 
      "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 mit deinen Werten.
    ... 
      "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 zu erhalten, wenn eine Person auf deine Anzeige klickt, falls du noch keine eingerichtet hast.

    Mehr erfahren

    Hier findest du weitere Informationen über die Marketing API und zusätzliche Optionen für Click-to-Messenger Ads und werbliche Nachrichtenanzeigen.

    Marketing API

    Messenger-Plattform