Version 13.0

Graph API

Veröffentlicht 8. Februar 2022 | Verfügbar bis Ausstehend | Blog-Post

Instagram Graph API

IG Media

Version 13 ist die letzte Version, in der video_title-Feldanfragen für IG-Medien durchgeführt werden können, ohne dass ein Fehler zurückgegeben wird. Zur Erinnerung: Die derzeitige Verhaltensweise der API, die in unserem Blogeintrag vom 5. Oktober 2021 beschrieben wird, sieht so aus:

• Das Feld media_product_type gibt für alle Versionen FEED zurück
• Das Feld video_title wird in allen Versionen in Antworten ausgelassen
• Die Felder comments und mentions von Instagram Webhooks werden in allen Versionen unterstützt

Das oben beschriebene Verhalten gilt für alle IG-Medien einschließlich mit der Instagram TV-App erstellte IG-Medien ungeachtet des Erstellungsdatums.

Nutzer*innen-Insights

Gilt ab Version 13.0.

Die folgenden Kennzahlen für IG-Nutzer*innen-Insights unterstützen nicht mehr die Parameter since und until und Antworten enthalten nicht länger die JSON-Eigenschaft end_time.

• audience_city
• audience_country
• audience_gender_age
• audience_locale

Marketing API

Veröffentlicht 8. Februar 2022 | Verfügbar bis 25. Januar 2023 | Blog-Post

Anzeigengestaltung

Werbeanzeigen mithilfe der Asset Customization für Platzierungen

Gilt ab Version 13.0.

Der Node asset_feed_spec des Endpunkts POST /{ad-account-id}/adcreatives lässt jetzt die Erstellung von Carousel Ads über Werbeanzeigen mithilfe der Asset Customization für Platzierungen zu.

Ads Library API

Werbebibliothek

Gilt ab Version 13.0.

Die folgenden Abfrage-Edges und -felder im GET /ads_archive-Endpunkt sind veraltet und werden ersetzt:

Die folgenden Rückgabeparamter im GET /ads_archive-Endpunkt sind veraltet und werden ersetzt:

Anzeigengruppen

Lookalike-Ausweitung

Gilt ab Version 13.0. Gilt ab dem 9. Mai 2022 für alle Versionen.

Bei neu erstellen Anzeigengruppen, die Wert, Conversions oder App-Events optimieren, wird die Lookalike-Ausweitung standardmäßig aktiviert und kann nicht deaktiviert werden. Wenn wir eine Anzeigengruppe erhalten, die Wert, Conversions oder App-Events optimiert, geben wir eine neue Lookalike-Eigenschaft in der targeting_optimization_types-Zuordnung zurück, die angibt, dass die Lookalike-Ausweitung aktiviert ist, und die detailed_targeting-Eigenschaft für die detaillierte Zielausweitung vervollständigt.

Diese Änderung wirkt sich auf die folgenden Endpunkte aus:

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

Conversions API

Parameter für Kund*innen-Informationen

Gilt ab Version 13.0.

Es gibt neue Anforderungen für die Kombinationen von Parametern für Kund*innen-Informationen, die für ein Event als gültig angesehen werden. Ein Event wird als ungültig betrachtet, wenn es ausschließlich Parameter enthält, die aus einer der folgenden Kombinationen oder einer Teilmenge davon bestehen.

• ct + country + st + zp + ge + client_user_agent
• db + client_user_agent
• fn + ge
• ln + ge

Um sicherzustellen, dass Events keinen Fehler auslösen, solltest du dir die Best Practices für die Conversions API ansehen.

Diese Änderung wirkt sich auf die folgenden Endpunkte aus:

• POST /{pixel-id}/events
• POST /{offline_dataset_id}/events

Handelsplattform

Shipping Profiles API

Gilt ab Version 13.0.

Das Feld handling_time im Endpunkt GET /{cms-id}/shipping_profiles wurde aus dem shipping_profile-Objekt in das address_category-Objekt verschoben.

Katalog

Feed API

Gilt ab Version 13.0.

Der Code für Fehler beim Hochladen des Produkt-Feeds „XML_JUNK_AFTER_DOCUMENT“ wurde umbenannt in „DATA_OUTSIDE_XML_TAGS“. Hierbei handelt es sich lediglich um eine Namensänderung.

Der folgende Endpunkt ist betroffen:

• GET /{feed_upload_session_id}