Marketing API

Advantage+-Shopping-Kampagnen

Mit Advantage+-Shopping-Kampagnen können Werbetreibenden im E-Commerce und im Einzelhandel potenziell bessere Performance, mehr Personalisierung und eine höhere Effizienz erzielen. Diese Kampagnen bieten ein höheres Maß an Flexibilität für die Steuerung von Hebeln wie Anzeigengestaltung, Targeting, Platzierungen und Budget und mehr Möglichkeiten für die Optimierung von Kampagnen um so die Conversions zu steigern.

Anstatt mehrere Kampagnen mit segmentierten Zielgruppen zu schalten, kannst du mit Advantage+-Shopping-Kampagnen alle deine Zielgruppen für einen bestimmten Markt in einer einzigen Kampagnenstruktur zusammenfassen. Damit kannst du die Erstellung und Verwaltung vereinfachen und gleichzeitig die Überschneidungen bei Zielgruppen verringern.

Manuelle Kampagneneinrichtung im Vergleich zu Advantage+-Shopping-Kampagnen

Manuelle Einrichtung von BAU-KampagnenAdvantage+-Shopping-Kampagne

Mehrere BAU-Kampagnen

BAU-Portfolio-Ersatz


Manuelles Targeting mit sieben Targeting-Hebeln


Automatisiertes Targeting, Automatisierung zur Steigerung der Einrichtungseffizienz mit Input aus einem Land


Strikte Budgetzuweisungen in mehreren Kampagnen


Budgetliquidität innerhalb einer Kampagne


Teste bis zu 50 Kombinationen aus Werbeanzeigen


Ermöglicht sowohl dynamische als auch statische Werbeanzeigen mit bis zu 150 Anzeigenkombinationen


Dieses Dokument enthält die Schritte zur Einrichtung deiner Integration für Advantage+-Shopping-Kampagnen. Du musst Folgendes tun:

  1. Bestandskund*innen definieren
  2. Kampagne erstellen
  3. Kampagnenerstellung überprüfen
  4. Anzeigengruppe erstellen
  5. Anzeigengestaltung und Werbeanzeigen bereitstellen
  6. Mindestalter und Geo-Ausschluss festlegen (siehe Referenzdokument zur Werbekontosteuerung)

Erfahre mehr über die kanalübergreifende Conversion-Optimierung für Advantage+-Shopping-Kampagnen.

Schritt 1: Definiere deine Bestandskund*innen

Mit Advantage+-Shopping-Kampagnen kannst du deine Bestandskund*innen als Sammlung Custom Audience-IDs definieren. Deine Bestandskund*innen sind Nutzer*innen, die dein Unternehmen/Produkt bereits kennen. Nachdem du diese Definition eingerichtet hast, kannst du damit dein Budget für Advantage+-Shopping-Kampagnen segmentieren, um die Ausgaben für Bestandskund*innen zu beschränken. Wir stellen dir auch Kennzahlen zur Verfügung, an denen du die Performance deiner Kampagnen für diese verschiedenen Segmenten ablesen kannst.

Du kannst deine Anzeige definieren, indem du sie an den /act_{ad_account_id} Endpunkt veröffentlichst. Zum Einrichten dieser Definition musst du den folgenden Parameter einfügen:

ParameterBeschreibung

existing_customers

Array<string>

Array der Custom Audience-IDs, auf die das Werbekonto Zugriff hat. Die unterstützten Quellen für die Custom Audience sind derzeit Website, App-Aktivität, Kund*innenliste, Katalog und Offline-Aktivität.


Weitere Informationen zum Erstellen einer Custom Audience findest du auf diese Seite.

Beispiel

curl -X POST \
  -F 'existing_customers=[<CUSTOM_AUDIENCE_ID>, <CUSTOM_AUDIENCE_ID>]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>

Weitere Informationen zur Nachverfolgung neuer und bestehender Zielgruppen in Tracking-Tools von Drittanbietern findest du unter URL-Parameter für Zielgruppentypen.

Schritt 2: Erstellen deine Kampagne

Erstelle zunächst deine Anzeigenkampagne. Stelle hierzu eine POST Anfrage an /act_{ad_account_id}/campaigns.

Parameter


ParameterBeschreibung

name
String

Erforderlich
Name für die Advantage+-Shopping-Kampagne

objective
Enum

Erforderlich
Kampagnenziel. Gib für diese Anzeigenart OUTCOME_SALES an

special_ad_categories

Liste<Object>

Erforderlich
Besondere Anzeigenkategorien für die Advantage+-Shopping-Kampagne

adlabels

Liste<Object>

Optional
Anzeigen-Labels für die Advantage+-Shopping-Kampagne

buying_type
String

Optional
Advantage+-Shopping-Kampagnen unterstützen nur den Wert AUCTION

execution_options

Liste<enum>

Optional
Standardwert: set. Sonstige Optionen:

  • validate_only: Mit dieser Option wird die Mutation mit dem API-Anruf nicht ausgeführt. Er erfolgt jedoch mit den Überprüfungsregeln für die Werte der einzelnen Felder.
  • include_recommendations: Diese Option kann nicht eigenständig verwendet werden. Wird diese Option verwendet, werden Empfehlungen für die Konfiguration von Anzeigenobjekten berücksichtigt. In die Antwort wird ein eigener Abschnitt Empfehlungen aufgenommen, sofern Empfehlungen für diese Spezifikation vorhanden sind.

Besteht der Anruf die Überprüfung oder Bewertung, lautet die Antwort {"success": true}. Besteht der Anruf nicht, wird ein Fehler mit weiteren Details zurückgegeben.

smart_promotion_type
Enum

Required
Möchtest du angeben, dass es sich um eine Advantage+-Shopping-Kampagne handelt, solltest du für den intelligenten Promotionstyp AUTOMATED_SHOPPING_ADS angeben.

status
Enum

Optional
Gültige Optionen sind: PAUSED und ACTIVE.


Ist dieser Status PAUSED, werden alle dazugehörigen aktiven Anzeigengruppen und Werbeanzeigen angehalten und erhalten den effektiven Status CAMPAIGN_PAUSED.

Beispiel für die Kampagnenerstellung

curl -X POST \
  -F 'name=Advantage+ Shopping Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'smart_promotion_type=AUTOMATED_SHOPPING_ADS' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/campaigns

Aktualisieren

Du kannst eine Kampagne aktualisieren, indem du eine POST Anfrage an /{campaign_id} stellst.

Parameter


ParameterBeschreibung

name
String

Name für die Advantage+-Shopping-Kampagne

special_ad_categories

Liste<Object>

Spezielle Anzeigenkategorien für die Advantage+-Shopping-Kampagne

adlabels

Liste<Object>

Anzeigen-Labels für die Advantage+-Shopping-Kampagne

execution_options

Liste<enum>

Standardwert: set. Sonstige Optionen:

  • validate_only: Mit dieser Option wird die Mutation mit dem API-Anruf nicht ausgeführt. Er erfolgt jedoch mit den Überprüfungsregeln für die Werte der einzelnen Felder.
  • include_recommendations: Diese Option kann nicht eigenständig verwendet werden. Wird diese Option verwendet, werden Empfehlungen für die Konfiguration von Anzeigenobjekten berücksichtigt. In die Antwort wird ein eigener Abschnitt Empfehlungen aufgenommen, sofern Empfehlungen für diese Spezifikation vorhanden sind.

Besteht der Anruf die Überprüfung oder Bewertung, lautet die Antwort {"success": true}. Besteht der Anruf nicht, wird ein Fehler mit weiteren Details zurückgegeben.

topline_id
numerischer String oder Integer

Topline-ID

status
Enum

Du kannst den folgenden Status für einen Update-API-Aufruf verwenden:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Ist für eine Werbekampagne PAUSED eingestellt, werden ihre aktiven untergeordneten Elemente angehalten und erhalten den effektiven Status CAMPAIGN_PAUSED.

Beispiel für Kampagnen-Update

curl -X POST \
  -F 'name=Advantage+ Shopping Update Sample Campaign' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<CAMPAIGN_ID>

Schritt 3: Überprüfe die Kampagnenerstellung

Um zu bestätigen, dass du eine Advantage+-Shopping-Kampagne erfolgreich erstellt hast, kannst du eine GET-Anfrage an /<AD_CAMPAIGN_ID> stellen und das Feld smart_promotion_type verwenden.

Eine gültige Advantage+-Shopping-Kampagne liefert den Feldwert AUTOMATED_SHOPPING_ADS.

Beispiel

curl -X GET -G \
  -d 'fields=smart_promotion_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_CAMPAIGN_ID>

Antwort

{
  "smart_promotion_type": "AUTOMATED_SHOPPING_ADS",
  "id": <AD_CAMPAIGN_ID>
}

Schritt 4: Erstelle eine Anzeigengruppe

Erstelle nach der Erstellung einer Werbekampagne deine Anzeigengruppe. Jeder Advantage+-Shopping-Kampagne darf nur eine Anzeigengruppe zugeordnet sein.

Sende zur Erstellung einer Anzeigengruppe eine POST Anfrage an /act_{ad_account_id}/adsets.

Parameter


ParameterBeschreibung

campaign_id
Numerischer String oder Integer

Erforderlich
Eine gültige Advantage+-Shopping-Kampagne, zu der du diese Anzeigengruppe hinzufügen möchtest.

name
String

Erforderlich
Name für die Advantage+-Shopping-Kampagne

promoted_object
Objekt

Erforderlich
Das Objekt, das diese Anzeigengruppe in allen ihren Werbeanzeigen hervorhebt. Gib für Advantage+-Shopping-Kampagnen Folgendes an:

  • pixel_id und
  • custom_event_type: Advantage+-Shopping-Anzeigengruppen unterstützen die folgenden Events: PURCHASE, ADD_TO_CART, INITIATED_CHECKOUT, ADD_PAYMENT_INFO, ADD_TO_WISHLIST, CONTENT_VIEW, COMPLETE_REGISTRATION, DONATE, START_TRIAL, SUBSCRIBE, SEARCH, OTHER.

Erfahre mehr über die Cross-Channel-Conversion-Optimierung für Advantage+-Shopping-Kampagnen.

targeting
Targeting-Objekt

Erforderlich
Die Targeting-Struktur einer Advantage+ Shopping-Anzeigengruppe. Es dürfen nur geo_locations angegeben werden.

geo_locations
array

Erforderlich
Wird verwendet, um die Zielgruppe der Anzeigengruppe zu begrenzen

  • countries — Länder-Targeting. Erfordert ein Array mit 2-stelligen ISO 3166-Formatcodes.
    Beispiel:
    {
  "geo_locations": {
    "countries": [“US”]
  },
}
  • regions — Staat, Provinz oder Region. Erfahre unter Targeting-Suche, Regionen mehr über verfügbare Werte. Höchstwert: 200.
    Beispiel:
    {
  "geo_locations": {
    "regions": [{"key":"3847"}]
  },
}

daily_budget
int64

Optional
Das Tagesbudget, das in deiner Kontowährung festgelegt ist, ist nur für Anzeigengruppen mit einer Laufzeit (Differenz zwischen end_time und start_time) von über 24 Stunden zulässig.


daily_budget oder lifetime_budget muss größer als Null sein.

lifetime_budget
int64

Optional
Laufzeitbudget, definiert in deiner Kontowährung. Falls angegeben, musst du auch eine end_time festlegen.


daily_budget oder lifetime_budget muss größer als Null sein.

end_time
Datum/Uhrzeit

Erforderlich, wenn lifetime_budget angegeben wird.
Wenn du eine Anzeigengruppe mit daily_budget erstellst, gib end_time=0 an, um die Anzeigengruppe als kontinuierlich ohne Enddatum zu definieren. UTC-UNIX-Zeitstempel


Beispiel: 2015-03-12 23:59:59-07:00 oder 2015-03-12 23:59:59 PDT.

optimization_goal
Enum

Optional
Wähle OFFSITE_CONVERSIONS als Optimierungsziel aus, um die Anzahl der Conversions zu maximieren. Wähle VALUE als Optimierungsziel aus, wenn du den Wert von Conversions maximieren möchtest. Im Werbeanzeigenmanager zeigen wir den höchsten Wert als deine Gebotsstrategie an.

bid_strategy
Enum

Optional

  • LOWEST_COST_WITHOUT_CAP: Facebook bietet automatisch für dich und holt für dich die Ergebnisse mit den niedrigsten Kosten ein. Deine effektiven Gebote werden automatisch erhöht, bis du deine gewünschten Ergebnisse basierend auf deinem optimization_goal erhältst. Das ist der Standard bid_strategy, wenn für optimization_goal OFFSITE_CONVERSION oder VALUE festgelegt ist.
  • LOWEST_COST_WITH_MIN_ROAS: Spezifische Gebotsoption zur Wertoptimierung. Du musst einen roas_average_floor angeben, der dem gewünschten Mindestwert für den ROAS entspricht. Siehe Mindest-ROAS-Gebote.
  • COST_CAP: Erhalte so viele Ergebnisse wie möglich und bleibe dabei innerhalb der von dir festgelegten Kosten pro Handlung. Du musst im Feld bid_amount einen Begrenzungswert angeben. Hinweis: Die Einhaltung der Kostenbegrenzung kann nicht garantiert werden. Siehe Kostenbegrenzung.

bid_amount

Erforderlich, wenn für bid_strategy COST_CAP festgelegt ist.

bid_constraints
JSON-Objekt

Optional

  • optimization_goal muss VALUE sein.
  • bid_strategy muss LOWEST_COST_WITH_MIN_ROAS sein.
  • Für ROAS-Mindestgebote wird bid_constraints zur Übergabe von „ROAS floor“ verwendet, kannst jedoch nicht mit bid_constraints verwendet werden. Verwende stattdessen roas_average_floor. Siehe Mindest-ROAS-Gebote.
  • Der gültige Bereich von roas_average_floor ist [100, 10000000] einschließlich. Das bedeutet, dass der gültige Bereich von „Mindest-ROAS“ [0.01, 1000.0] oder [1%, 100000.0%] einschließlich ist.

billing_event
Enum

Erforderlich
Ein Abrechnungs-Event für die Anzeigengruppe. Nur IMPRESSIONS wird für Advantage+-Shopping-Kampagnen unterstützt.

existing_customer_budget_percentage
Zahl

Optional
Gibt den maximalen Prozentsatz des Budgets an, der für Bestandskund*innen ausgegeben werden kann, die mit diesem Werbekonto verbunden sind. Geringere Werte können zu höheren Kosten pro Conversion führen. Es können Werte zwischen 0 und 100 angegeben werden.

adlabels

list<Object>

Optional

Gibt eine Liste der Labels zurück, die mit diesem Objekt verknüpft werden sollen.

start_time
Datum/Uhrzeit

Optional.
Die Startzeit der Gruppe. UTC-UNIX-Zeitstempel


Beispiel: 2015-03-12 23:59:59-07:00 oder 2015-03-12 23:59:59 PDT.

time_start
Datenzeit

Optional

Startzeit

time_stop
Datum/Uhrzeit

Optional

Endzeit

attribution_spec

Liste<JSON Object>

Optional
Conversion-Attributionsspezifikation für die Attribution von Conversions

Beispiel für die Erstellung von Anzeigengruppen

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'promoted_object={ "pixel_id": "<PIXEL_ID>", "CUSTOM_EVENT_TYPE": "PURCHASE" }' \
  -F 'daily_budget=<NUM>' \
  -F 'existing_customer_budget_percentage=<NUM>' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'targeting={"geo_locations": {"countries": ["US"]}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets

Aktualisieren

Du kannst eine Anzeigengruppe aktualisieren, indem du eine POST-Anfrage an /{ad_set_id} sendest.

Parameter


ParameterBeschreibung

adlabels

list<Object>

Gibt eine Liste der Labels zurück, die mit diesem Objekt verknüpft werden sollen. Dieses Feld ist optional.

daily_budget
int64

Das in deiner Kontowährung definierte Tagesbudget kann nur für Anzeigengruppen mit einer Dauer von weniger als 24 Stunden (Differenz zwischen end_time und start_time) verwendet werden.


daily_budget oder lifetime_budget muss größer als Null sein.

existing_customer_budget_percentage
Zahl

Gibt den maximalen Prozentsatz des Budgets an, der für mit diesem Werbekonto verknüpften Bestandskund*innen ausgegeben werden kann. Geringere Werte können zu höheren Kosten pro Conversion führen. Es können Werte zwischen 0 und 100 angegeben werden.

end_time
Datum/Uhrzeit

Endzeit, erforderlich, wenn lifetime_budget angegeben wird.


Beispiel: 2015-03-12 23:59:59-07:00 oder 2015-03-12 23:59:59 PDT


Gib bei der Erstellung einer Anzeigengruppe mit einem Tagesbudget end_time=0 an, um die Anzeigengruppe als kontinuierlich ohne Enddatum einzurichten.


UTC-UNIX-Zeitstempel.

execution_options

Liste<enum>

Standardwert: set. Sonstige Optionen:

  • validate_only: Mit dieser Option wird die Mutation mit dem API-Anruf nicht ausgeführt. Er erfolgt jedoch mit den Überprüfungsregeln für die Werte der einzelnen Felder.
  • include_recommendations: Diese Option kann nicht eigenständig verwendet werden. Wird diese Option verwendet, werden Empfehlungen für die Konfiguration von Anzeigenobjekten berücksichtigt. In die Antwort wird ein eigener Abschnitt Empfehlungen aufgenommen, sofern Empfehlungen für diese Spezifikation vorhanden sind.

Besteht der Anruf die Überprüfung oder Bewertung, lautet die Antwort {"success": true}. Besteht der Anruf nicht, wird ein Fehler mit weiteren Details zurückgegeben.

start_time
Datum/Uhrzeit

Die Startzeit der Gruppe. Muss mit UTC-UNIX-Zeitstempel angegeben werden.


Beispiel: 2015-03-12 23:59:59-07:00 oder 2015-03-12 23:59:59 PDT.

status
Enum

Verfügbare Optionen für Updates:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Wenn PAUSED angegeben wurde, werden alle dazugehörigen aktiven Werbeanzeigen angehalten und erhalten den effektiven Status ADSET_PAUSED.

lifetime_budget
int64

Laufzeitbudget, in deiner Kontowährung definiert. Falls angegeben, musst du auch eine end_time festlegen.


daily_budget oder lifetime_budget muss größer als Null sein.

time_start
Datenzeit

Startzeit

time_stop
Datum/Uhrzeit

Endzeit

targeting
Targeting-Objekt

Targeting-Struktur für deine Anzeigengruppe. Gültige Werte für das Targeting sind geo_locations.

geo_locations
array

Erforderlich
Wird verwendet, um die Zielgruppe der Anzeigengruppe zu begrenzen

  • countries — Länder-Targeting. Erfordert ein Array mit 2-stelligen ISO 3166-Formatcodes.
    Beispiel:
    {
  "geo_locations": {
    "countries": [“US”]
  },
}
  • regions — Staat, Provinz oder Region. Erfahre unter Targeting-Suche, Regionen mehr über verfügbare Werte. Höchstwert: 200.
    Beispiel:
    {
  "geo_locations": {
    "regions": [{"key":"3847"}]
  },
}

attribution_spec

Liste<JSON Object>

Optional
Conversion-Attributionsspezifikation für die Attribution von Conversions

Beispiel für Update einer Anzeigengruppe

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Updated Ad Set' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_SET_ID>

Schritt 5: Stelle Anzeigengestaltungen und kreative Werbeanzeigen bereit

Sobald du eine Anzeigengruppe hast, kannst du deine Anzeige erstellen, indem du sie am Endpunkt /act_{ad_account_id}/ads veröffentlichst. Du kannst die folgenden Parameter einschließen:

Parameter


ParameterBeschreibung

name
String

Erforderlich
Name der Anzeige

adset_id
int64

Erforderlich
Die ID der Anzeigengruppe, die bei der Erstellung erforderlich ist.

creative
AdCreative

Erforderlich
Die Anzeigenspezifikation oder die ID der Anzeigengestaltung, die von dieser Anzeige verwendet werden soll. Gültige Felder sind:

  • object_story_spec
  • product_set_id
  • use_page_actor_override
  • creative_id

Hier erfährst du mehr über Anzeigengestaltungen.


Gib die Anzeigengestaltung im folgenden Format an: {"creative_id": <CREATIVE_ID>}


Oder gib eine Anzeigenspezifikation an:

{
        "creative": {
          "name": <NAME>, 
          "object_story_spec": <SPEC>,
          "product_set_id": <PRODUCT_SET_ID>
        }
}

status
Enum

Optional
Nur ACTIVE und PAUSED sind während der Erstellung gültig. Während des Tests wird empfohlen, Werbeanzeigen auf den PAUSED-Status zu setzen, um keine versehentlichen Ausgaben zu verursachen.

adlabels

list<Object>

Optional
Anzeigen-Labels, die mit dieser Anzeige verbunden sind

execution_options

Liste<enum>

Optional
Standardwert: set.

  • validate_only: Mit dieser Option wird die Mutation mit dem API-Anruf nicht ausgeführt. Er erfolgt jedoch mit den Überprüfungsregeln für die Werte der einzelnen Felder.
  • synchronous_ad_review: Diese Option sollte nicht ohne weitere Angaben genutzt werden. Sie sollte immer zusammen mit validate_only angegeben werden. Wenn diese Optionen angegeben sind, führt der API-Aufruf Ads Integrity-Validierungen durch, darunter die Überprüfung der Nachrichtensprache, die 20-%-Textrichtlinie für Bilder usw. sowie die Validierungslogik.
  • include_recommendations: Diese Option kann nicht eigenständig verwendet werden. Wird diese Option verwendet, werden Empfehlungen für die Konfiguration von Anzeigenobjekten berücksichtigt. In der Antwort ist ein separater Abschnitt mit Empfehlungen enthalten, jedoch nur wenn Empfehlungen für diese Spezifikation vorliegen.

Besteht der Anruf die Überprüfung oder Bewertung, lautet die Antwort {"success": true}. Besteht der Anruf nicht, wird ein Fehler mit weiteren Details zurückgegeben.

Beispiel für die Erstellung einer Anzeige

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Ad' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/ads

Felder der Anzeigengestaltung

Eine vollständige Liste der Felder der Anzeigengestaltung findest du hier.

FeldBeschreibung

object_story_spec
AdCreativeObjectStorySpec

Erforderlich
Verwende diese Option, wenn du einen neuen unveröffentlichten Seitenbeitrag erstellen und den Beitrag in eine Anzeige umwandeln möchtest. Die Seiten-ID und der Inhalt zum Erstellen eines neuen unveröffentlichten Seitenbeitrags.

use_page_actor_override
AdCreative

Erforderlich
Wenn das Feld true ist, zeigen wir die Facebook-Seite, die mit den Advantage-Shopping Ads verbunden ist.

Beispiel für die Erstellung einer Anzeigengestaltung

curl -X POST \
  -F 'object_story_spec=<SPEC>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

Aktualisieren

Du kannst eine Anzeige aktualisieren, indem du eine POST-Anfrage an /{ad_id} stellst.

Parameter


ParameterBeschreibung

name
String

Neuer Name der Anzeige

adlabels

list<Object>

Anzeigen-Labels, die mit dieser Anzeige verbunden sind.

execution_options

Liste<enum>

Standardwert: set. Sonstige Optionen:

  • validate_only: Mit dieser Option wird die Mutation mit dem API-Anruf nicht ausgeführt. Er erfolgt jedoch mit den Überprüfungsregeln für die Werte der einzelnen Felder.
  • synchronous_ad_review: Diese Option sollte nicht ohne weitere Angaben genutzt werden. Sie sollte immer zusammen mit validate_only angegeben werden. Wenn diese Optionen angegeben sind, führt der API-Aufruf Ads Integrity-Validierungen durch, darunter die Überprüfung der Nachrichtensprache, die 20-%-Textrichtlinie für Bilder usw. sowie die Validierungslogik.
  • include_recommendations: Diese Option kann nicht eigenständig verwendet werden. Wird diese Option verwendet, werden Empfehlungen für die Konfiguration von Anzeigenobjekten berücksichtigt. In der Antwort ist ein separater Abschnitt mit Empfehlungen enthalten, jedoch nur wenn Empfehlungen für diese Spezifikation vorliegen.

Besteht der Anruf die Überprüfung oder Bewertung, lautet die Antwort {"success": true}. Besteht der Anruf nicht, wird ein Fehler mit weiteren Details zurückgegeben.

status
Enum

Optionen:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Während des Tests wird empfohlen, Werbeanzeigen auf den PAUSED-Status zu setzen, um keine versehentlichen Ausgaben zu verursachen.

creative
AdCreative

Die Anzeigenspezifikation der Anzeigengestaltung, die von dieser Anzeige verwendet werden soll. Gültige Felder sind object_story_spec, asset_feed_spec und use_page_actor_override und können hier eingesehen werden. Hier erfährst du mehr über Anzeigengestaltungen.


Gib die Anzeigengestaltung im folgenden Format an:

{
    "creative": {
      "name": <NAME>, 
      "object_story_spec": <SPEC>,
      "product_set_id": <PRODUCT_SET_ID>
    }
}

Beispiel für die Aktualisierung einer Anzeige

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Update Ad' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_ID>

Mehr erfahren