Click-to-Multidestination Ads

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

Click-to-Multidestination Ads leiten Nutzer*innen, die auf deine Werbeanzeige klicken, direkt zu Unterhaltungen mit deinem Unternehmen in der bzw. den Messaging-App(s) (Messenger, Instagram oder WhatsApp), über die sie am wahrscheinlichsten antworten. Mithilfe dieser Anzeigen kannst du einen großen Personenkreis erreichen und einen herausragenden, individuellen Service bieten.

Multidestination Ads bedeuten, dass die Werbeanzeige eine Kombination von Zielen erreichen kann: Messenger-Chat, Instagram-Chat, WhatsApp-Chat.

Wenn du eine Anzeige erstellen möchtest, die nur ein Ziel hat, findest du hier entsprechende Informationen:

• Click-to-Messenger Ads
• Click-to-Instagram Ads
• Click-to-WhatsApp Ads

Übersicht über die Anzeigenerstellung

Dieses Dokument beschreibt die Schritte, die du befolgen musst, um deine Integration für Click-to-Multidestination Ads einzurichten. Du musst Folgendes tun:

1. Eine Werbekampagne erstellen
2. Eine Anzeigengruppe erstellen, die deine Werbeanzeigen mit deiner Werbekampagne verbindet
3. Eine Anzeigengestaltung für die gewünschte Multidestination-Anzeigenart erstellen
4. Eine Werbeanzeige erstellen, indem du deine Anzeigengestaltung mit deiner Anzeigengruppe verknüpfst

Bevor du loslegst

Voraussetzungen für diesen Leitfaden:

• Ein Werbekonto bei Meta
• Alle Inhalte wie Bilder oder Videos, die in deinen Werbeanzeigen verwendet werden sollen, sind auf Meta-Server hochgeladen

Schritt 1: Eine Werbekampagne erstellen

Erstelle zunächst deine Werbekampagne. Stelle dazu 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:

Parameter

Anfrage

curl -X POST \
  -F 'name=Click to Multi Destination Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Antwort

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

{
  "id": "<AD_CAMPAIGN_ID>"
}

Aktualisieren

Du kannst eine Kampagne aktualisieren, indem du eine POST-Anfrage an /<AD_CAMPAIGN_ID> stellst.

Lesen

Um zu bestätigen, dass du erfolgreich eine Click-to-Multidestination-Kampagne erstellt hast, kannst du eine GET-Anfrage an /<AD_CAMPAIGN_ID> stellen. Die vollständige Liste der verfügbaren Parameter findest du in der Referenz zu Werbekampagnen.

Anfrage

curl -X GET -G \
  -d 'fields=name,status,objective' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CAMPAIGN_ID>

Antwort

{
  "name": "Click to Multi Destination Campaign",
  "status": "ACTIVE",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_CAMPAIGN_ID>"
}

Schritt 2: Anzeigengruppe erstellen

Sobald du eine Werbekampagne hast, erstelle deine Anzeigengruppe. Um eine Anzeigengruppe zu erstellen, stelle 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:

Parameter

Die vollständige Liste der verfügbaren Parameter findest du in der Referenz zu Werbekonto-Anzeigengruppen.

Anfrage

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=<DAILY_BUDGET>' \
  -F 'destination_type=<DESTINATION_TYPE>' \
  -F 'name=<AD_SET_NAME>' \
  -F 'optimization_goal=CONVERSATIONS' \
  -F 'promoted_object={
      "page_id": "<PAGE_ID>"
    }' \
  -F 'status=ACTIVE' \
  -F 'start_time=<START_TIME>' \
  -F 'targeting={ 
        "geo_locations": { "countries":["US","CA"] },
        "device_platforms": ["mobile", "desktop"]
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

Antwort

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

{
  "id": "<AD_SET_ID>"
}

Aktualisieren

Du kannst eine Anzeigengruppe aktualisieren, indem du eine POST-Anfrage an /<AD_SET_ID> stellst.

Lesen

Um zu bestätigen, dass du erfolgreich eine Click-to-Multidestination-Anzeigengruppe erstellt hast, kannst du eine GET-Anfrage an /<AD_SET_ID> senden. Eine vollständige Liste der verfügbaren Parameter findest du in der Referenz zu Anzeigengruppen.

Anfrage

curl -X GET -G \
  -d 'fields=name,destination_type,optimization_goal,bid_strategy' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_SET_ID>

Antwort

{
  "name": "<AD_SET_NAME>",
  "destination_type": "<DESTINATION_TYPE>",
  "optimization_goal": "CONVERSATIONS",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP'"
  "id": "<AD_SET_ID>"
}

Schritt 3: Eine Anzeigengestaltung erstellen

Die Anzeigengestaltung ermöglicht das Hinzufügen von Assets zu deinen Anzeigen. Um eine Anzeigengestaltung zu erstellen, sende 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:

Parameter

{
  "type": "MESSAGE_PAGE",
    "value": {
       "app_destination": "MESSENGER",
       "link": "https://fb.com/messenger_doc/"
    }
} 

{
  "type": "WHATSAPP_MESSAGE",
    "value": {
       "app_destination": "WHATSAPP",
       "link": "https://api.whatsapp.com/send"
    }
}

{
  "type": "INSTAGRAM_MESSAGE",
    "value": {
       "app_destination": "INSTAGRAM_DIRECT",
       "link": "https://www.instagram.com"
    }
}

Die vollständige Liste der verfügbaren Parameter findest du in der Referenz zur Anzeigengestaltung.

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

Beispiele für die Erstellung einer Anzeigengestaltung

Füge das Feld page_welcome_message wie folgt zum Inhalt der Werbeanzeige hinzu.

Anfrage

curl -X POST \
-F 'name=<CREATIVE_NAME>' \
-F 'object_story_spec={
     "page_id": "438346666550309",
     "link_data": {
       "name": "<AD_HEADLINE>",
       "message": "<AD_PRIMARY_TEXT>",
       "image_hash": "<IMAGE_HASH>"
       "link": "https://fb.com/messenger_doc/",
       "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
       "call_to_action": {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER"
         }
       }
     }
   }' \
-F 'asset_feed_spec={
     "optimization_type": "DOF_MESSAGING_DESTINATION",
     "call_to_actions": [
       {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER",
           "link": "https://fb.com/messenger_doc/"
         }
       },
       {
         "type": "WHATSAPP_MESSAGE",
         "value": {
           "app_destination": "WHATSAPP",
           "link": "https://api.whatsapp.com/send"
         }
       },
       {
         "type": "INSTAGRAM_MESSAGE",
         "value": {
           "app_destination": "INSTAGRAM_DIRECT",
           "link": "https://www.instagram.com"
         }
       }
     ]
   }' \
-F 'degrees_of_freedom_spec={
     "creative_features_spec": {
       "standard_enhancements": {
         "enroll_status": "OPT_IN"
       }
     }
   }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Antwort

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

{
  "id": "<AD_CREATIVE_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.

Aktualisieren

Du kannst eine Anzeigengestaltung aktualisieren, indem du eine POST-Anfrage an /<AD_CREATIVE_ID> stellst.

Lesen

Um zu bestätigen, dass du erfolgreich eine Click-to-Multidestination-Anzeigengestaltung erstellt hast, kannst du eine GET-Anfrage an /<AD_CREATIVE_ID> stellen. Die vollständige Liste verfügbarer Parameter findest du unter Anzeigengestaltung.

Anfrage

curl -X GET -G \
  -d 'fields=name,object_story_spec{page_welcome_message},asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CREATIVE_ID>

Antwort

{
  "name": "<CREATIVE_NAME>",
  "object_story_spec": {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "ice_breakers",
        "message": {
          "text": "Sample greeting message",
          "ice_breakers": [
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            }
          ]
        }
      }
    }
  },
  "asset_feed_spec": {
    "optimization_type": "DOF_MESSAGING_DESTINATION",
    "call_to_actions": [
      {
        "type": "MESSAGE_PAGE",
        "value": {
          "app_destination": "MESSENGER",
          "link": "https://fb.com/messenger_doc/"
        }
      },
      {
        "type": "WHATSAPP_MESSAGE",
        "value": {
          "app_destination": "WHATSAPP",
          "link": "https://api.whatsapp.com/send"
        }
      },
      {
        "type": "INSTAGRAM_MESSAGE",
        "value": {
          "app_destination": "INSTAGRAM_DIRECT",
          "link": "https://www.instagram.com"
        }
      }
    ]
  },
  "id": "<AD_CREATIVE_ID>"
}

Schritt 4: Eine Anzeige erstellen

Werbeanzeigen ermöglichen es dir, Informationen zur Anzeigengestaltung mit deinen Anzeigengruppen zu verbinden. Um eine Anzeige zu erstellen, stelle 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:

Parameter

Anfrage

curl -X POST \
  -F 'name=<AD_NAME>' \
  -F 'adset_id=<AD_SET_ID> \
  -F 'creative={
       "creative_id": "<AD_CREATIVE_ID>"
     }' \
  -F 'status=ACTIVE \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Antwort

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

{
  "id": "<AD_ID>"
}

Call-to-Action

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

"asset_feed_spec": {
  "optimization_type": "DOF_MESSAGING_DESTINATION",
  "call_to_actions": [
    {
      "type": "MESSAGE_PAGE",
      "value": {
        "app_destination": "MESSENGER",
        "link": "https://fb.com/messenger_doc/"
      }
    },
    {
      "type": "INSTAGRAM_MESSAGE",
      "value": {
        "app_destination": "INSTAGRAM_DIRECT",
        "link": "https://www.instagram.com"
      }
    }
  ]
}

Weitere Informationen findest du in der Dokumentation zur Asset-Feed-Spezifikationen.

Aktualisieren

Du kannst eine Anzeige aktualisieren, indem du eine POST-Anfrage an /<AD_ID> stellst.

Lesen

Um zu bestätigen, dass du erfolgreich eine Click-to-Multidestination Ad erstellt hast, kannst du eine GET-Anfrage an /<AD_ID> stellen. Die vollständige Liste der verfügbaren Parameter findest du in der Referenz zu Anzeigen.

Anfrage

curl -X GET -G \
  -d 'fields=status,adset_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_ID>

Antwort

{
  "status": "ACTIVE",
  "adset_id": "<AD_SET_ID>",
  "id": "<AD_ID>"
}