Version 3.0

Marketing API

Veröffentlicht 1. Mai 2018 | Verfügbar bis 1. Februar 2019 | Blog-Post

• Neue Funktionen
• Funktionsgefährdende Änderungen
• Veraltete Elemente
• Sofort veraltete Elemente

Neue Funktionen

Gebotsstrategie „Niedrigste Kosten“, bid_strategy-Feld

Wir haben das neue bid_strategy-Feld für {account-id}/adsets eingeführt. Hier kannst du eine Werbeanzeigen-Gebotsstrategie für deine jeweiligen Geschäftsziele auswählen. Jede Strategie hat Vor- und Nachteile. Verfügbare Optionen:

• LOWEST_COST: Erhalte die meisten Ergebnisse basierend auf deinem Anzeigengruppenbudget und dem optimization_goal für die Auslieferung. Facebook bietet automatisch mehr als notwendig, um dein Budget auszugeben. Du kannst mit dieser Option einen Höchstbetrag oder keine Begrenzung für dein Gebot angeben.

• TARGET_COST: Liefert stabile durchschnittliche Kosten für deine Werbeanzeigen, wenn du dein Budget für Anzeigengruppen erhöhst.

Weitere Informationen findest du unter Kauf und Optimierung von Werbeanzeigen, Gebotsstrategie.

Collection Ads, Erstellen

Neue API für die Erstellung von Collection Ads: Bisher erstellte Facebook beim Erstellen einer Collection Ad im Hintergrund eine Canvas Ad. Dadurch wurde dein Zugriff auf die zugrunde liegende Canvas eingeschränkt. Du konntest sie nicht dazu verwenden, Zielgruppen für Interaktionen für Canvas erneut anzusprechen. Wenn du nun eine Collection Ad aus Produktpaletten erstellst, muss du auch ausdrücklich eine Canvas mit den zulässigen Elementen erstellen. Wenn du diese Canvas in einer Collection Ad verwendest, erstellt Facebook die Collection Ad automatisch. Weitere Informationen dazu findest du unter Collection Ads aus Produktpaletten.

Funktionsgefährdende Änderungen

Werbeanzeigenverwaltung

• Ungültige rechte Spalte: Anzeigen werden ungültig, die nur die Facebook-Position targetieren, right_hand_column mit ungültigen Zielen für right_hand_column von {ad_account_id}/adsets. Wir unterstützen nun für unterstützte Anzeigenformate mit den folgenden Ziele die Platzierung auf der rechten Seite: Traffic, Conversions und Produktkatalogverkäufe.

• is_autobid und is_average_price_pacing sind in v3.0 und höher in GET und in POST veraltet.

Zielgruppen und Anzeigen-Targeting

• Geänderte Regelsyntax für Custom Audiences: Wir haben die Struktur für Regeln geändert, die für die Erstellung von Custom Audiences für Webseiten, Custom Audiences über mobile Apps, Custom Audiences für Seiten-Interaktionen, Interaktionszielgruppen für Lead Ads, Interaktionszielgruppen für Canvas und Offline-Custom Audiences verwendet werden. Damit kannst du auf aggregierten Verhalten basierende Regeln und Regeln aus verschiedenen Event-Quellen erstellen und Regeln ausschließen. Siehe:

  • Custom Audiences über deine Webseite, Zielgruppenregeln

  • Custom Audiences über deine mobile App, Zielgruppenregeln

  • Custom Audiences für Seiten-Interaktionen

  • Interaktionszielgruppen für Lead Ads

  • Interaktionszielgruppen für Canvas und

  • Custom Audiences aus Offline-Conversions.

Dynamic Ads

• Produktkatalogzugriff: Für den Zugriff auf Katalogelemente musst du die richtige Katalogbranche angeben. Entspricht deine Anfrage nicht der richtigen Branche für deinen Katalog, wird ein Fehler ausgegeben. Verfügst du beispielsweise über einen E-Commerce-Katalog, solltest du mit dem entsprechenden /products-Endpunkt darauf zugreifen, wie zum Beispiel GET {catalog_id}/products, GET {product_feed_id}/products oder GET {product_set_id}/products. Mit Endpunkten für andere Branchen wie GET {catalog_id}/autos, GET {product_feed_id}/hotels oder GET {product_set_id}/flights kannst du nicht auf den Katalog zugreifen.

• Leerer String in Vorlagen-Tags: Leere Strings sind als Parameter für Dynamic Ads nicht mehr erlaubt, Vorlagen-Tag-Optionen. Wenn du beispielsweise einen leeren String an {{trip.checkin_date date_format:}} übergibst, wird ein Fehler angezeigt. Hintergrundinformationen findest du unter Dynamic Ads, Verwaltung von Werbeanzeigen.

Ads Insights und Messung

• Insight-Zeitüberschreitungen: Wenn wir davon ausgehen, dass für eine Insights API-Anfrage vor Abschluss eine Zeitüberschreitung eintritt, zeigen wir einen Fehler mit dem Fehlercode 100 und dem Untercode 1504033 an. Wir schätzen diesen Zeitpunkt anhand der Anfragegröße und dem jeweiligen Verarbeitungsfortschritt im Verhältnis zu den Begrenzungen für die Zeitüberschreitung. Wir dieser Fehler angezeigt, solltest du eine asynchrone Insights API-Anfrage für diese Daten tätigen. Siehe Asynchrone Jobs der Insights API.

• Negative Werte in Event-Daten: Wenn du Event-Daten für {data_set_id}/events mit einem negativen Wert veröffentlichst, schlägt dies fehl. Dies wirkt sich auf das data-Feld für POST /{data_set_id-id}/events aus.

• Insights in die Budgetoptimierung auf Kampagnenebene: adset_budget_value gibt nun using campaign budget zurück, wenn für deine Werbekampagne Budgetoptimierung auf Kampagnenebene aktiviert ist. Dies wirkt sich aus auf:

  • GET {adaccount-id}/insights,

  • GET {campaign-id}/insights,

  • GET {adset-id}/insights,

  • GET {ad-id}/insights,

  • POST {adaccount-id}/insights,

  • POST {campaign-id}/insights,

  • POST {adset-id}/insights,

  • POST {ad-id}/insights.

• Standardsortierung für Pixel: Wenn du die GET {account_id}/adspixel-Edge für ein Business-Konto oder ein Anzeigenkonto aufrufst, geben wir Ergebnisse zurück, die standardmäßig nach Pixelname anstatt nach dem Zeitpunkt der letzten Pixelauslösung sortiert sind.

• Umbenennung Pixel-Statistik-Feld: Wir haben das timestamp-Feld auf der Pixel-Statistik-Edge in start_time umbenannt. Dieses enthält den Zeitpunkt, zu dem wir mit dem Aggregieren stündlicher Daten zu Pixel-Auslösungen beginnen. Wir geben dies nun im ISO 8601-Format zurück und geben den Zeitzonen-Offset an. Damit wird ein Problem behoben, bei dem ungültige Unix-Zeitstempel zurückgegeben wurden. Dies wirkt sich auf die folgenden Endpunkte aus: GET {ads-pixel-id}/stats.

Veraltete Elemente

Business Manager

Veralteter POST {pixel-id}/shared_agencies-Endpunkt. Verwende die Business Manager-UI, um Anzeigenpixel mit Agenturen zu teilen.

Werbeanzeigenverwaltung

• kpi_custom_conversion_id, kpi_type und kpi_results aus /{ad_campaign_id} und /ad_account_ID/campaigns sind veraltet.

• „Redownload“-Flag von den folgenden Endpunkten zur Vereinfachung der API veraltet:

  • POST {ad-id}/,

  • POST {adset-id}/,

  • POST act_{ad-account-id},

  • POST act_{ad-account-id}/ads,

  • POST act_{ad-account-id}/adsets

  Diese Informationen kannst du weiter mit dem „fields“-Parameter abrufen.

• Das Feld zipbytes aus POST act_{ad-account-id}/adimages ist veraltet und an dieser Edge können keine ZIP-Dateien mehr hochgeladen werden. Verwende ein Bild mit den folgenden Erweiterungen: jpg, jpeg, gif, bmp, png, tiff oder tif.

• Die Methode zur Erstellung von Collection Ads, für die ein API-Aufruf mit allen erforderlichen Elementen als Parameter verwendet wurde, ist veraltet. Stattdessen musst du nun zunächst ein Canvas erstellen und anschließend mit dem Canvas-Link ein Collection Ad erstellen. Auf diese Weise kannst du auf das zugrundeliegende Canvas-Objekt zugreifen, um beispielsweise Zielgruppen erneut anzusprechen. Mehr dazu erfährst du unter Collection Ads.

• Verwendung des Carousel-Anzeigenformats für Anzeigen mit dem Ziel der Interaktion mit Seitenbeiträgen wurde eingestellt. Diese Kombination ist nicht mehr gültig. Siehe Validierung, Ziele und Anzeigengestaltung

Kauf und Gebote von Werbeanzeigen

• Die Felder is_autobid und is_average_price_pacing von Endpunkten werden nicht mehr unterstützt: POST {ad-account-id}/adsets und POST {adset-id}. Verwende stattdessen das neue bid_strategy-Feld, um eine bestimmte Gebotsstrategie für die Anzeigengruppe anzugeben. Weitere Informationen findest du unter Gebote und Optimierung.

• Veraltete Felder unter delivery_estimate für Werbeanzeigen und Anzeigenkonten. Die Ergebnisse entsprachen nicht den Anforderungen des Werbetreibenden. Vielmehr haben viele Werbetreibenden Geschäftsziele, denen mit dem von Facebook vorgeschlagenen Gebotsbetrag möglicherweise nicht optimal entsprochen wird. Folgende Felder und Parameter sind z. B. veraltet:

  • bid_estimate-Feld,

  • currency-Parameter,

  • daily_budget-Parameter,

  • optimize_for-Parameter

  Wir empfehlen dir, den echten, inhärenten Geschäftswert zu verwenden, den du aus Facebook-Werbeanzeigen erhältst, und auf dieser Basis zu bieten. Wenn du diesen Wert nicht kennst, kannst du am besten mit automatischen Geboten arbeiten. Weitere Informationen findest du unter Hilfebereich für Werbung, Anzeigenauktion und Kauf und Optimierung von Werbeanzeigen.

• Veraltetes zurückgegebenes Ergebnis aus dem curve_budget_reach-Feld für GET /{rf-prediction-id}. Wir geben nun eine Zuordnung zurück und der Rückgabewert für den als JSON serialisierten String ist veraltet. Dies wirkt sich aus auf: GET /{rf-prediction-id}.

• Das GET /{ad-account-id}/ratecard-Edge ist veraltet.

• Mehrere Felder für die Abrechnung zu /ad_accounts sind veraltet. Dazu gehören:

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• Die Felder pixel_id und external_event_source sind veraltet GET /customaudience.

Ads Insights und Messung

• matched_unique_users ist veraltet für OFFLINE_EVENT_SET_ID die zurückgegeben wurde von GET /{data-set-id} und GET /{data-set-upload-id}. Siehe Offline Conversions API.

• Das attributed_events-Edge und das attribute_stats-Feld für die GET /{data_set_id} API sind veraltet. Verwende die GET /{data_set_id}/stats-API, um zugeordnete Event-Statistiken abzurufen.

• Das Feld matched_unique_users für OFFLINE_EVENT_SET_ID, das von GET /{data-set-id} und GET /{data-set-upload-id} zurückgegeben wurde, ist veraltet.

• Standardrückgabewerte für GET {data_set_upload_id} sind veraltet. Diese Felder werden nicht mehr standardmäßig zurückgegeben: first_upload_time, last_upload_time, api_calls, valid_entries, matched_entries, duplicate_entries, event_time_min, event_time_max, event_stats und matched_unique_users.

• Standardrückgabewerte für GET {data_set_id}/stats sind veraltet. Es werden nun standardmäßig nur Rücksendungszahlstatistiken angegeben. Verwende zur Angabe, welche Statistiken zurückgegeben werden sollen, den fields-Parameter oder den summary-Parameter für kumulative Statistiken wie average_upload_delay.

• Die Standardrückgabewerte für GET {data_set_id} sind veraltet. Diese Felder werden nicht mehr standardmäßig zurückgegeben: attribute_stats, duplicate_entries, event_stats, event_time_max, event_time_min, matched_entries, matched_unique_users, usage, valid_entries.

• Das GET {data-set-upload-id}/stats-Edge ist veraltet. Verwende stattdessen die Felder valid_entries oder matched_entries aus GET {data-set-upload-id}.

• canvas_component_avg_pct_view aus der Insights API ist veraltet.