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 Messaging-App oder in den Apps (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/v19.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/v19.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/v19.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/v19.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.

Beispiel

Hinzufügen von Eisbrechern mit einer Grußbotschaft

"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": "<GREETING_MESSAGE>",
      "ice_breakers": [
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        }
      ]
    }
  }
}

Beispiele für die Erstellung einer Anzeigengestaltung

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/v19.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>"
}

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/v19.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/v19.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>"
}

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/v19.0/<AD_ID>

Antwort

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