Anzeigen, die per Klick zu WhatsApp weiterleiten

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

Click-to-WhatsApp Ads leiten Nutzer*innen, die auf deine Werbeanzeige klicken, direkt zu einer Unterhaltung mit deinem Unternehmen auf WhatsApp weiter. Mithilfe dieser Anzeigen kannst du einen großen Personenkreis erreichen und einen herausragenden, individuellen Service bieten.

Click-to-WhatsApp 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 Messenger- oder Instagram-Chats weiterleiten, findest du unter Click-to-WhatsApp Ads oder Click-to-Instagram Ads entsprechende Anleitungen. Du kannst auch Werbeanzeigen erstellen, die das Ziel auswählen, von dem die*der Nutzer*in am ehesten reagiert. Mehr dazu findest du unter Click-to-Multidestination Ads.

Übersicht über die Anzeigenerstellung

Dieses Dokument beschreibt die Schritte, die du befolgen musst, um deine Integration für Click-to-WhatsApp 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 deinen gewünschten die WhatsApp-Anzeigenart erstellen
4. Eine Werbeanzeige erstellen, indem du deine Anzeigengestaltung mit deiner Anzeigengruppe verknüpfst
5. Deine Werbeanzeige auf Facebook, Instagram und im Messenger veröffentlichen

Bevor du beginnst

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
• Eine Facebook-Seite mit einer WhatsApp-Nummer, die manuell oder über API verknüpft ist

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

Standardanfrage

curl -X POST \
  -F 'name=Click to WhatsApp 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

Anfrage zur Durchführung einer Telefonaktion

curl -X POST \
  -F 'name=Click to WhatsApp Calling Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=PAUSED' \
  -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 verifizieren, dass du erfolgreich eine Click-to-WhatsApp-Kampagne erstellt hast, kannst du eine GET-Anfrage an /<AD_CAMPAIGN_ID> stellen. In der Referenz zu Werbekampagnen findest du eine vollständige Liste der verfügbaren Parameter.

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 WhatsApp Campaign",
  "status": "PAUSED",
  "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 \
  -H "Content-Type: application/json" \
  -d '{
    "access_token":"<ACCESS_TOKEN>",
    "bid_amount":"<BID_AMOUNT>",
    "billing_event":"IMPRESSIONS",
    "campaign_id":"<CAMPAIGN_ID>",
    "daily_budget":"<DAILY_BUDGET>",
    "destination_type":"WHATSAPP",
    "name": "<AD_SET_NAME>",
    "optimization_goal": "IMPRESSIONS",
    "promoted_object": {
      "page_id": "<PAGE_ID>"
    },
    "status": "PAUSED",
    "start_time": "<START_TIME>",
    "targeting": { 
      "geo_locations": { "countries":["US","CA"] },
      "device_platforms": ["mobile", "desktop"]
    } 
  }' \
"https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets"

Antwort

{
  "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 eine Click-to-WhatsApp-Anzeigengruppe erfolgreich erstellt hast, kannst du eine GET-Anfrage an /<AD_SET_ID> senden. Eine vollständige Liste der verfügbaren Parameter findest du in der Anzeigegruppen-Referenz.

Anfrage

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

Antwort

{
  "name": "Click to WhatsApp Campaign",
  "status": "PAUSED",
  "objective": "OUTCOME_ENGAGEMENT",
  "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

In der Referenz für die Anzeigengestaltung findest du eine vollständige Liste der verfügbaren Parameter.

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-WhatsApp Ads schaffen, indem du die Grußbotschaft deiner Werbeanzeigen im Feld page_welcome_message unter object_story_spec personalisierst.

Hinweis: Wenn du die WhatsApp-Nachricht benutzt, um Bot-Flows auszulösen, stelle bitte sicher, dass du diese in Zusammenarbeit mit deinem BSP und deinen Agenturen aktualisierst, damit die Flows nicht unterbrochen werden.

Beispiel

Hinzufügen einer Autofill-Nachricht 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": "autofill_message",
    "message": {
      "autofill_message": {
        "content": "<AUTOFILL_MESSAGE>"
      },
      "text": "<GREETING_MESSAGE>"
    }
  }
}

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

Hinzufügen von Nachricht mit einer Anrufaufforderung

curl \
  -F 'object_story_spec={
      "page_id": "<PAGE_ID>"
      "link_data": {
     "image_hash":<IMAGE_HASH>
            "call_to_action": {
              	"type": "WHATSAPP_MESSAGE",
              	"value": {
                  	"app_destination": "WHATSAPP"
             	 }
          },
          "link": "https://api.whatsapp.com/send",
          "name": <AD_HEADLINE>",
          "page_welcome_message":
       "type": "VISUAL_EDITOR",
        "version": 2,
        "landing_screen_type": "ctwa_call_prompt",
        "media_type": "text",
        "text_format": {
          "message": {
            "text": "<MESSAGE>"", 
            "call_prompt_data": {
              "call_prompt_message": "<CALL_PROMPT_MESSAGE>"
            }
          }
        },
        "user_edit": false
      },
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Antwort

{
  "id": "<AD_CREATIVE_ID>"
}

Beispiele für die Erstellung einer Anzeigengestaltung

Anfrage

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Sample ad creative",
        "object_story_spec": {
          "page_id": "<PAGE_ID>",
          "link_data": {
            "name": "<AD_HEADLINE>",
            "message": "<AD_PRIMARY_TEXT>",
            "description": "<AD_DESCRIPTION>",
            "image_hash": "<IMAGE_HASH>",
            "link": "https://api.whatsapp.com/send",
            "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
            "call_to_action": {
              "type": "WHATSAPP_MESSAGE",
              "value": {
                "app_destination": "WHATSAPP"
              }
            }
          }
        },
        "degrees_of_freedom_spec": {
          "creative_features_spec": {
            "standard_enhancements": {
              "enroll_status": "OPT_IN"
            }
          }
        }
      }' \
"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

Du kannst deinen bestehenden Instagram-Content auch für deine Anzeigengestaltung verwenden.

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "source_instagram_media_id": "<INSTAGRAM_MEDIA_ID>",
        "instagram_user_id": "<INSTAGRAM_USER_ID>",
        "object_id": "<PAGE_ID>",
        "call_to_action": {
          "type": "WHATSAPP_MESSAGE",
            "value": {
              "link": "https://api.whatsapp.com/send",
              "app_destination": "WHATSAPP"
            }
          }
        },
        "degrees_of_freedom_spec": {
          "creative_features_spec": {
            "standard_enhancements": {
              "enroll_status": "OPT_IN"
            }
          }
        }
      }' \
  https://graph.facebook.com/latest-api-version />/act_<AD_ACCOUNT_ID>/adcreatives

Aktualisieren

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

Lesen

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

Anfrage

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

Antwort

{
  "name": "Sample ad creative",
  "object_story_spec" {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "autofill_message",
        "message": {
          "autofill_message": {
            "content": "Sample autofill message"
          },
        "text": "Sample greeting message"
        }
      }
    }
  },
  "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 \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Sample ad",
        "adset_id": "<AD_SET_ID>",
        "creative": {
          "creative_id": "<AD_CREATIVE_ID>"
        },
        "status": "PAUSED"
     }' \
  "https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads"

Antwort

{
  "id": "<AD_ID>"
}

Aktualisieren

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

Lesen

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

Anfrage

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

Antwort

{
  "status": "PAUSED",
  "adset_id": "<AD_SET_ID>",
  "campaign_id": "<AD_CAMPAIGN_ID>",
  "id": "<AD_ID>"
}

Schritt 5: Deine Anzeige veröffentlichen

Stelle sicher, dass deine Anzeige im Werbeanzeigenmanager existiert. Wenn du bereit bist, deine Änderungen zu veröffentlichen, wähle deine Kampagne, die Anzeigengruppe für die Kampagne und die Anzeige aus und klicke auf den Button Veröffentlichen.

Du kannst deine Anzeige auch über die API veröffentlichen. Sende einfach eine POST-Anfrage an /<AD_ID>, wobei der status-Parameter auf ACTIVE festgelegt ist und <AD_ID> die Anzeige ist, die du veröffentlichen möchtest.

Deine Anzeige wird von Meta überprüft und der Status lautet PENDING_REVIEW. Sobald diese genehmigt wurde, wird der Status automatisch auf ACTIVE aktualisiert und deine Anzeige wird ausgeliefert.