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.
Führe die folgenden Schritte aus, um eine Anzeige zu erstellen und zu veröffentlichen:
Voraussetzungen für diesen Leitfaden:
Um erfolgreiche Aufrufe an alle Endpunkte zu tätigen, benötigst du Folgendes:
ADVERTIZE
-Aufgabe ausführen kann.ads_management
pages_manage_ads
pages_read_engagement
pages_show_list
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:
|
|
Kurzreferenz für Werbekampagnen
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" }
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 Adspromoted_object
– festgelegt auf die ID für die Facebook-Seite deines Unternehmens.status
auf PAUSED
festgelegttargeting
Kurzreferenz für Anzeigengruppen
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" }
Die Anzeigengestaltung ermöglicht das Hinzufügen von Assets zu deinen Anzeigen.
Einschränkungen
|
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
– erforderlichprivacy_url
– erforderlich für Lead Adsstandard_enhancements.enroll_status
– erforderlich für Anzeigengestaltungen, die zu Standardoptimierungen berechtigt sind. Kurzreferenz für übergeordnete Anzeigengestaltungsparameter
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
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
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"
}
}
}'
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.
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.
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" }
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
*_data
-Objekt, das den Medientyp definiert. 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.
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"
}]
}]
}
}
}
}
}"
}
}
}'
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.
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
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.
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.
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:
*_data.page_welcome_message
, der auf das Schlüssel-Wert-Paar
ctm_lead_gen_template_id:
Your_messenger_lead_gen_template_id
festgelegt ist
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" }"
}
}
}'
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"
}
}
}'
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
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
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.
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
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" }
Du kannst beim Erstellen deiner Werbeanzeige auch einen Call-to-Action festlegen.
"call_to_action": { "value": {"app_destination":"MESSENGER"}, "type": "MESSAGE_PAGE" }
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 status
ACTIVE
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.
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
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_type
text
, 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.
... "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" } } }, } ]" ...
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.
... "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 ' } ] } }]", ...
Richte Webhooks ein, um Benachrichtigungen zu erhalten, wenn eine Person auf deine Anzeige klickt, falls du noch keine eingerichtet hast.
Hier findest du weitere Informationen über die Marketing API und zusätzliche Optionen für Click-to-Messenger.