Einträge im Änderungsprotokoll sind in die folgenden Kategorien unterteilt:
Neue Funktionen, Änderungen und Veraltete Elemente betreffen nur diese Version. Funktionsgefährdende Änderungen nach 90 Tagen betreffen alle Versionen.
Funktionsgefährdende Änderungen werden hier nicht aufgeführt, da sie nicht an bestimmte Veröffentlichungen gebunden sind.
Veröffentlicht 1. Mai 2018 | Verfügbar bis 28. Juli 2020 | Blog-Post
subscribed_domains_phishing
-Endpunkt der Transparenz von Zertifikaten-API verwenden, um Domains für Phishing-Warnungen zu abonnieren.groups_access_member_info
und publish_to_groups
./comments
-Edge leere Daten für die folgenden Nodes zurück:
Ablauf des Zugriffsschlüssels: Ein Zugriffsschlüssel wird ungültig, wenn der Nutzer die App innerhalb der letzten 90 Tage nicht aufgerufen hat.
id
first_name
last_name
middle_name
name
name_format
picture
short_name
age_range
context
cover
currency
devices
gender
link
locale
timezone
updated_time
verified
Die Berechtigungen rsvp_event
und user_managed_groups
sind veraltet. Die user_managed_groups
-Berechtigung kann weiterhin zu Testzwecken verwendet werden, sie kann jedoch nicht zur Login Review eingereicht werden.
groups_access_member_info
: Für den Erhalt mitgliedsbezogener Daten zum Gruppeninhalt.
publish_to_groups
: Für die Veröffentlichung von Inhalt in einer Gruppe für einen Nutzer.
user_age_range
– Für den Zugriff auf die Altersgruppe einer Person.
user_gender
– Für den Zugriff auf das Geschlecht einer Person.
user_link
– Für den Zugriff auf die Facebook-Profil-URL für einen anderen Nutzer der App.
Für diese Version sind keine veralteten Elemente vorhanden.
Für aufgeschlüsselte Kennzahlen für Seiten-Insights werden nur Werte ungleich Null zurückgegeben.
Interaktionskennzahlen für Seiten- und Beitragsstories, einschließlich mit dem Metrikfeld verwendeter metric
, der von stories
in activity
umbenannt wurde.
Interaktionskennzahlen für Seitenbeitragsnutzung, einschließlich mit dem Metrikfeld verwendeter metric
, umbenannt von post_consumption*
in post_clicks*
.
GET /{page-id}/insights/{metric}
- Diese Metrik wird in 90 Tagen entfernt.
page_story_adds
page_story_adds_by_age_gender_unique
page_story_adds_by_city_unique
page_story_adds_by_country_unique
page_views
page_views_unique
page_views_login
page_views_login_unique
GET /{post-id}/insights/{metric}
- Diese Metrik wird in 90 Tagen entfernt.
post_story_adds_by_action_type
post_story_adds_by_action_type_unique
post_story_adds_unique
post_story_adds
post_fan_reach
post_interests_impressions
post_interests_impressions_unique
post_interests_consumptions
post_interests_consumptions_unique
post_interests_consumptions_by_type
post_interests_consumptions_by_type_unique
post_interests_action_by_type
post_interests_action_by_type_unique
/photos
-Edge – Der type
-Parameter für die /photos
-Edge (die auf verschiedenen Nodes verfügbar ist) unterstützt uploaded
nicht mehr als Wert für GET
-Vorgänge (GET /object/photos?type=uploaded
).GET /user
– Das third_party_id
-Feld ist veraltet. Apps, die ältere Versionen der API verwenden, können dieses Feld noch bis zum 30. Juli 2018 abrufen. Vom Nutzer nach am 1. Mai 2018 oder später installierte Apps können dieses Feld nicht abrufen. Dies ist von der verwendeten API-Version unabhängig.Veröffentlicht 1. Mai 2018 | Verfügbar bis 1. Februar 2019 | Blog-Post
bid_strategy
-FeldWir 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.
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.
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.
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:
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.
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
.
Veralteter POST {pixel-id}/shared_agencies
-Endpunkt. Verwende die Business Manager-UI, um Anzeigenpixel mit Agenturen zu teilen.
kpi_custom_conversion_id
, kpi_type
und kpi_results
aus /{ad_campaign_id}
und /ad_account_ID/campaigns
sind veraltet.POST {ad-id}/
,
POST {adset-id}/
,
POST act_{ad-account-id}
,
POST act_{ad-account-id}/ads
,
POST act_{ad-account-id}/adsets
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
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
pixel_id
und external_event_source
sind veraltet GET /customaudience
.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.