Marketing API

Erste Schritte

Erstelle mit diesen Schritten deine erste Werbeanzeige mit der Marketing API.

Bevor du beginnst

Du solltest dich mit der Graph API und der Werbekampagnenstruktur von Facebook vertraut machen. Sobald du bereit bist, Aufrufe zu tätigen, benötigst du Folgendes:

Anschließend kannst du beginnen. Informiere dich unbedingt über die allgemeinen Best Practices für die Nutzung der Marketing API.

Schritt 1: Erstelle eine Kampagne

Beginne den Prozess mit der Erstellung eines neuen Kampagnenobjekts aus der Klasse Campaign. In dieser Phase musst du ein Ziel für deine Werbeanzeigen festlegen, das das Gesamtziel deiner Kampagne ist. Nach Möglichkeit solltest du zunächst eine PAUSED-Kampagne erstellen, damit während der Testphase keine Kosten entstehen.

curl -X POST \
  -F 'name="My campaign"' \
  -F 'objective="OUTCOME_TRAFFIC"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

Nach erfolgreichem Abschluss wird eine ID für deine neu erstellte Werbekampagne zurückgegeben. Vergiss nicht, diese ID zu speichern. Du kannst außerdem im Werbeanzeigenmanager überprüfen, ob deine Kampagne erstellt wurde.

Ressourcen:

Schritt 2: Lege das Targeting fest

Referenzdokumentation

Bevor wir uns mit der Erstellung deiner Anzeigengruppen befassen, musst du deine Zielgruppe definieren. Im nächsten Schritt erstellst du eine Anzeigengruppe und gibst die Attribute deiner Zielgruppe an.

Hierfür gibt es zahlreiche Targeting-Optionen. In diesem Beispiel verwenden wir die Targeting-Suche zum Suchen von vordefinierten Werten, mit denen du eine Zielgruppe einrichten kannst.

Zuerst suchen wir nach verfügbaren Ländern, die das Wort „united“ enthalten:

curl -G \
  -d 'location_types=["country"]' \
  -d 'type=adgeolocation' \
  -d 'q=united' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Anschließend suchen wir nach Interessen, die das Wort „movie“ enthalten:

curl -G \
  -d 'type=adinterest' \
  -d 'q=movie' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Basierend auf den Werten, die von den oben genannten Aufrufen zurückgegeben werden, wissen wir, dass wir eine Zielgruppe erstellen können, die sich in den USA befindet und an Filmen interessiert ist. Die Targeting-Spezifikation sieht so aus:

targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "interests": [{id: 6003139266461, 'name': 'Movies'}]
}

Schritt 3: Erstelle Anzeigengruppen und lege Budgets, Abrechnung, Optimierung und Dauer fest

Eine Anzeigengruppe ist eine Gruppe von Werbeanzeigen, bei denen das Tages- oder Laufzeitbudget, der Zeitplan, die Abrechnung, die Optimierung, und die Targeting-Daten identisch sind. In diesem Schritt erstellst du ein neues Objekt aus der Klasse AdSet und gibst Folgendes an:

  • Dauer: Wie lange deine Werbeanzeigen laufen werden. Lege sie mit start_time und end_time fest.
  • Budget: Welchen Betrag du ausgeben möchtest. Verwende daily_budget oder lifetime_budget.
  • Optimierung: Was du mit deiner Werbeanzeige erreichen möchtest. Richte sie mit optimization_goal ein.
  • Abrechnung: Wie du bezahlen möchtest. Verwende billing_event.
  • Gebot: Wie viel dir dein Optimierungs-Event wert ist. Verwende das bid_amount-Feld.
  • Targeting: Verwende die in Schritt 2 erstellte Targeting-Spezifikation.

Zum Erstellen deiner Anzeigengruppe brauchst du auch die Kampagnen-ID, die du in Schritt 1 gespeichert hast:

curl \
  -F 'name=My Ad Set' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}, "interests": [{id: 6003139266461, "name": "Movies"}]}' \
  -F 'start_time=2024-10-06T04:45:17+0000' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

Wir empfehlen die Erstellung einer Anzeigengruppe mit dem Status PAUSED, um Kosten während des Tests zu vermeiden.

Schritt 4: Anzeigengestaltung bereitstellen

Referenzdokumentation

In diesem Schritt verwendest du das AdCreative-Objekt, um die visuellen Elemente deiner Anzeige bereitzustellen. Welche Informationen du angeben musst, hängt von deinem Ziel ab. Die folgenden Attribute werden häufig verwendet:

  • Bilder und Videos
  • Titel und Beschreibung
  • Links
  • Call to Action-Buttons

Je nach deinem Ziel musst du möglicherweise erweiterte Felder hinzufügen. Werbeanzeigen für eine iOS-App benötigen z. B. eine App Store-URL.

Du kannst die Anzeigengestaltung als Teil einer Anzeigengruppe oder eigenständig definieren. Wir speichern in jedem Fall deine Anzeigengestaltung in der Anzeigengestaltungsbibliothek deines Werbekontos, damit du sie in Werbeanzeigen verwenden kannst.

Beispiel

Im folgenden Beispiel wird gezeigt, wie ein Bild bereitgestellt und das Objekt AdCreative erstellt wird.

Erstelle zuerst ein AdImage-Objekt aus einer Bilddatei:

curl \
  -F 'filename=@<IMAGE_PATH>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/adimages

Erstelle anschließend die AdCreative mithilfe des Bild-Hash:

curl -X POST \
  -F 'name="Sample Creative"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "image_hash": "<IMAGE_HASH>",
         "link": "https://facebook.com/<PAGE_ID>",
         "message": "try it out"
       }
     }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_IN"
        }
      }
    }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

Rufe die Medienbibliothek im Werbeanzeigenmanager auf, um den Upload des Bildes zu verifizieren.

Die AdCreative mit deinem Link ist im Werbeanzeigenmanager noch nicht sichtbar. Du siehst diese Daten, nachdem du die Werbeanzeige gebucht hast. Du kannst die Gestaltung der Werbeanzeige mit Graph API Explorer debuggen und die zu lesenden Felder angeben:

GET /{my-creative-id} HTTP/1.1
Host: graph.facebook.com/?fields=object_story_spec

Schritt 5: Auslieferung planen

Erstelle zum Schluss dein Anzeigenobjekt zur Verknüpfung von AdCreative und AdSet. Setze den status deiner Ad auf paused, damit nicht sofort eine Anzeige geschaltet wird.

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="&lt;AD_SET_ID&gt;"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

Prüfe im Werbeanzeigenmanager, ob deine Werbeanzeige vorhanden ist. Klicke auf die gerade erstellte Kampagne, anschließend auf die Anzeigengruppe und dann auf die Anzeige.

Wenn du dich an die Buchung von Werbeanzeigen über die API gewöhnt hast, setze den Status auf active. Die Werbeanzeige durchläuft zunächst die Anzeigenprüfung und hat dabei den Status PENDING_REVIEW. Nachdem die Überprüfung abgeschlossen ist, wird der Status wieder auf ACTIVE gesetzt.

Kopieren von Werbeanzeigen

Alternativ kannst du vorhandene Werbeanzeigen, Assets oder Kampagnen kopieren. So kannst du eine Kampagne schnell duplizieren, um Konfigurationen zu ändern oder Testgruppen für die Extraktion von Performance-Erkenntnissen zu erstellen. Weitere Informationen dazu findest du hier: