Insights API-Aufschlüsselungen
Mithilfe von Aufschlüsselungen kannst du die Insights API-Ergebnisse in verschiedene Gruppen einteilen.
Die Insights API kann mehrere Kennzahlen zurückgeben, die geschätzt werden, sich in Entwicklung befinden, oder beides. Insights-Aufschlüsselungswerte sind Schätzungen. Weitere Informationen findest du unter Insights API, geschätzte und veraltete Kennzahlen.
Einschränkungen
Nicht verfügbare Felder
Die folgenden Felder können bei Angabe einer Aufschlüsselung nicht angefordert werden:
app_store_clicksnewsfeed_avg_positionnewsfeed_clicksrelevance_scorenewsfeed_impressions
Beschränkungen für Handlungskennzahlen außerhalb von Meta
Die folgenden Aufschlüsselungen stehen für Handlungskennzahlen außerhalb von Meta nicht mehr zur Verfügung.
Typ 1
regiondmahourly_stats_aggregated_by_audience_time_zonehourly_stats_aggregated_by_advertiser_time_zone
Typ 2
action_deviceaction_destinationaction_target_idproduct_idaction_carousel_card_id/action_carousel_card_nameaction_canvas_component_name
Regeln zu Abfragen, die die vorstehenden Aufschlüsselungen enthalten:
- Typ 1: Die Insights API gibt keine nicht unterstützten externen Kennzahlen zurück (z. B. Handlungskennzahl mit Aufschlüsselungen vom Typ 1).
- Typ 2: Die API gibt weiterhin externe Websitekennzahlen zurück. Diese enthalten jedoch nicht den Aufschlüsselungswert. Die mobilen Kennzahlen werden nicht mehr zurückgegeben, wenn sie mit diesen Aufschlüsselungen abgefragt werden.
Hinweis: Die oben genannten Aufschlüsselungen werden für Kennzahlen in Meta, wie Impressions, Link-Klicks usw., unterstützt. Die Änderungen haben außerdem keine Auswirkungen auf historische Daten vor dem 27. April 2021. Aufschlüsselungen für historische Daten sind weiterhin verfügbar.
Handlungskennzahlen
In den folgenden Situationen sind keine Kennzahlen verfügbar:
- Wenn eine Aggregation über mehrere Attributionseinstellungen hinweg versucht wird.
- Wenn sie mit betroffenen Aufschlüsselungen angefordert werden (diese Beschränkung gilt nur für Handlungsarten außerhalb von Meta).
Hinweis: Wenn die Abfrage mit action_attribution_windows=1d_click,7d_click,1d_view erfolgt (das Standardfenster ist nicht einbezogen), sind Kennzahlen verfügbar.
Generische Aufschlüsselungen
Die folgenden Aufschlüsselungen sind verfügbar.
| Aufschlüsselung | Beschreibung |
|---|---|
| Das Gerät, auf dem das getrackte Conversion-Event stattgefunden hat. Zum Beispiel \"Desktop\", wenn jemand auf einem Desktop-Computer konvertiert hat. |
| Name einer Komponente in einer Canvas-Werbeanzeige. |
| Die ID der spezifischen Carousel-Karte, mit der Personen interagiert haben, als deine Werbeanzeige angezeigt wurde. |
| Die spezifische Carousel-Karte, mit der Personen interagiert haben, als deine Werbeanzeige angezeigt wurde. Die Karten werden anhand ihrer Überschrift identifiziert. |
| Das Ziel, das Personen besuchen, nachdem sie auf deine Werbeanzeige geklickt haben. Das könnte deine Facebook-Seite, eine externe URL für dein Conversion Pixel oder eine mit dem SDK (Software Development Kit) konfigurierte App sein. |
| Die Anzahl der Reaktionen auf deine Werbeanzeigen oder beworbenen Beiträge. Mit dem Reaktions-Button auf einer Werbeanzeige können Personen verschiedene Reaktionen auf den Inhalt teilen: Gefällt mir, Love, Haha, Wow, Traurig oder Wütend. |
| Die ID des Ziels, das Personen besuchen, nachdem sie auf deine Werbeanzeige geklickt haben. Das könnte deine Facebook-Seite, eine externe URL für dein Conversion Pixel oder eine mit dem SDK (Software Development Kit) konfigurierte App sein. |
| Die Art der Aktionen für deine Werbeanzeige, Seite, App oder dein Event, nachdem deine Werbeanzeige an jemanden ausgeliefert wurde, auch wenn der*die Empfänger*in nicht darauf geklickt hat. Zu den Aktionstypen gehören „Gefällt mir“-Angaben auf der Seite, App-Installationen, Conversions, Antworten auf Veranstaltungen usw. |
| Der Tonstatus (Ein/Aus), wenn deine Video Ad wiedergegeben wird. |
| Aufschlüsselung der Videokennzahlen. |
| Die ID des Anzeigenformat-Assets einer Impression, eines Klicks oder einer Aktion. |
| Die Altersspanne der Personen, die du erreicht hast. |
| Die ID der Anwendung, die mit dem angeforderten Werbekonto oder der angeforderten Werbekampagne verknüpft ist. Die App-Informationen, einschließlich der App-ID, können im App-Dashboard angezeigt werden. Diese Aufschlüsselung wird nur vom Feld |
| Die ID des Text-Assets einer Impression, eines Klicks oder einer Aktion. |
| Die ID des Call to Action-Assets einer Impression, eines Klicks oder einer Aktion. |
| Das Land, in dem sich die Personen befinden, die du erreicht hast. Dies basiert auf Informationen wie der Heimatstadt einer Person, ihrem aktuellen Wohnort und dem geographischen Standort, an dem sie sich häufig aufhält, wenn sie Meta besucht. |
| Die ID des Beschreibungs-Assets einer Impression, eines Klicks oder einer Aktion. |
| Der Gerätetyp, mobil oder Desktop, den eine Person nutzt, während sie eine Werbeanzeige ansieht oder anklickt (wie im Anzeigenbericht angegeben). |
| Die DMA(Designated Market Area)-Regionen sind die 210 geografischen Bereiche in den USA, in denen lokale Fernsehgewohnheiten von The Nielsen Company gemessen werden. |
| Die Häufigkeit, mit der eine Werbeanzeige in deiner Reichweite und Frequenz-Kampagne an die einzelnen Konten der Kontenübersicht ausgeliefert wurde. |
| Geschlecht der Personen, die du erreicht hast. Personen, die ihr Geschlecht nicht angeben, werden mit „nicht angegeben“ aufgeführt. |
| Aufschlüsselung nach Stunden, zusammengefasst nach den Uhrzeiten, zu denen Werbeanzeigen ausgeliefert wurden (in der Zeitzone des Werbetreibenden). Wenn die Auslieferung deiner Werbeanzeigen beispielsweise von 9:00 bis 11:00 Uhr geplant ist, jedoch Zielgruppen in mehreren Zeitzonen erreicht werden, können sie mitunter von 9:00 bis 13:00 Uhr in der Zeitzone des Werbetreibenden ausgeliefert werden. Statistiken werden in vier Gruppen zusammengefasst: 9:00–10 00 Uhr, 10:00–11:00 Uhr, 11:00–12:00 Uhr und 12:00–13 00 Uhr. |
| Aufschlüsselung nach Stunden, zusammengefasst nach den Uhrzeiten, zu denen Werbeanzeigen ausgeliefert wurden (in der Zeitzone der Zielgruppe). Wenn die Auslieferung deiner Werbeanzeigen beispielsweise von 9:00 bis 11:00 Uhr geplant ist, jedoch Zielgruppen in mehreren Zeitzonen erreicht werden, können sie mitunter von 9:00 bis 13:00 Uhr in der Zeitzone des Werbetreibenden ausgeliefert werden. Statistiken werden in zwei Gruppen aggregiert: 9:00 bis 10:00 Uhr und 10:00 bis 11:00 Uhr. |
| Die ID des Image-Assets einer Impression, eines Klicks oder einer Aktion. |
| Das Gerät, auf dem deine letzte Werbeanzeige an eine*n Nutzer*in auf Meta ausgeliefert wurde. Zum Beispiel \"iPhone\", wenn jemand deine Werbeanzeige auf einem iPhone gesehen hat. |
| Eine boolesche Kennzeichnung die angibt, ob die Diese Aufschlüsselung wird nur vom Feld |
| Die ID des URL-Assets einer Impression, eines Klicks oder einer Aktion. |
| Die ID der Seite des Ortes einer Impression oder eines Klicks. Insights auf Kontoebene und die |
| Der Ort, an dem deine Werbeanzeige in einer Plattform gezeigt wurde, zum Beispiel im Facebook-Desktop-Feed oder im mobilen Feed von Instagram. |
| Die ID und der Name des Produkts einer Impression, eines Klicks oder einer Aktion. |
| Die Plattform, auf der deine Werbeanzeige gezeigt wurde, zum Beispiel auf Facebook, Instagram oder Audience Network. |
| Die Regionen, in denen sich die Personen befinden, die du erreicht hast. Dies basiert auf Informationen wie der Heimatstadt einer Person, ihrem aktuellen Wohnort und dem geographischen Standort, an dem sie sich häufig aufhält, wenn sie Facebook besucht. |
| Die reine Kampagnen-ID als Teil eines Skan-Postbacks von iOS 15 und höher. Hinweis: Diese Aufschlüsselung wird nur vom Feld |
| Die zugewiesene Conversion ID (auch als Prioritäts-ID bezeichnet) des Events bzw. des Event-Bundles, das im SKAdNetwork-Konfigurationsschema der Anwendung konfiguriert ist. Die Konfiguration der App-Events kann im Meta Events Manager angezeigt und angepasst werden. Hier erfährst du mehr darüber, wie du deine App-Events für das SKAdNetwork von Apple konfigurierst. Hinweis: Diese Aufschlüsselung wird nur vom Feld |
| Die ID des Titel-Assets einer Impression, eines Klicks oder einer Aktion. |
| Nutzer*innensegment (z. B. neu, bestehend) der Advantage+ Shopping Campaigns (ASC). Der*die bestehende Nutzer*in wird in den ASC-Einstellungen über die Custom Audience spezifiziert. |
| Die ID des Video-Assets einer Impression, eines Klicks oder einer Aktion. |
Hinweise
app_idundskan_conversion_idkönnen derzeit nicht mit demfiltering-Feld gefiltert werden.- Die
dma-Aufschlüsselung ist nicht verfügbar für dieestimated_ad_recall_rate-Kennzahl oder dievideo_thruplay_watched_actions-Kennzahl. - Die
dma-Aufschlüsselung nutzt ein Stichprobenverfahren, um Kennzahlen wie die Anzahl der erreichten Einzelpersonen zu berechnen. In Fällen, in denen eine große Anzahl von DMA-Regionen mit vergleichsweise geringem Volumen vorliegt, sind diese möglicherweise nicht in der Stichprobe vertreten oder könnten auf eine Potenz von 2 hochskaliert werden. Daher empfiehlt es sich für ein genaueres Ergebnis, auch die entsprechenden Impressionen abzufragen. frequency_valuewird nur mitreachverwendet. Zum Beispiel die Häufigkeit, mit der ein*e individuelle*r Nutzer*in eine Werbeanzeige gesehen hat.- Standardmäßig sind die
image_asset- undvideo_asset-Aufschlüsselungen auf der Werbekonto-Ebene für in der dynamischen Anzeigengestaltung verwendete Elemente nicht verfügbar. - Werbeanzeigen
video_p25_watched_actions,video_p50_watched_actions,video_p75_watched_actions,video_p95_watched_actionsundvideo_p100_watched_actionsunterstützen keineregion-Aufschlüsselung. - Alle Aufschlüsselungen zu Elementen mit dynamischer Anzeigengestaltung unterstützen nur eine begrenzte Auswahl von Kennzahlen:
| Aufschlüsselungen zur dynamischen Anzeigengestaltung | Unterstützte Kennzahlen für Aufschlüsselungen zur dynamischen Anzeigengestaltung |
|---|---|
|
|
Der folgende Aufruf gruppiert die Ergebnisse nach age und gender.
curl -G \
-d "breakdowns=age,gender" \
-d "fields=impressions" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"Stündliche Aufschlüsselungen
Stündliche Statistiken sind jetzt über die folgenden Aufschlüsselungen verfügbar:
hourly_stats_aggregated_by_advertiser_time_zonehourly_stats_aggregated_by_audience_time_zone
Unter Aufschlüsselungen kombinieren wird angegeben, wie viele Aufschlüsselungen du maximal mit der stündlichen Aufschlüsselung anfragen kannst. Stündliche Aufschlüsselungen unterstützen keine individuellen Felder. Diesen Feldern ist das Präfix unique_* vorangestellt. Die Felder reach und frequency werden ebenfalls nicht unterstützt. Die Felder reach und frequency geben 0 zurück, wenn du stündliche Aufschlüsselungen verwendest.
curl -G \
-d "fields=impressions" \
-d "breakdowns=hourly_stats_aggregated_by_audience_time_zone" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"Handlungsaufschlüsselung
Gruppiere Ergebnisse im Feld actions. Du kannst die folgenden Aufschlüsselungen für action_breakdowns verwenden:
Die folgenden Aufschlüsselungen können im Feld action_breakdowns angegeben werden.
action_deviceconversion_destinationmatched_persona_idmatched_persona_namesignal_source_bucketstandard_event_content_typeaction_canvas_component_nameaction_carousel_card_idaction_carousel_card_nameaction_destinationaction_reactionaction_target_idaction_typeaction_video_soundaction_video_type
action_type wird implizit als die action_breakdowns hinzugefügt, wenn der action_breakdowns-Parameter nicht angegeben ist.
Gesamtanzahl in actions
Die Gesamtzahl (Summe) aller zurückgegebenen Werte in Gruppenergebnissen (actions).
Dieses Ergebnis entspricht möglicherweise nicht total_actions, da in actions zurückgegebene Felder hierarchisch sind und detaillierte Handlungen nicht gezählt werden.
total_actions - 33
page_engagement - 10
post_engagement - 10
link_click - 2
comment - 3
post_reaction - 3
like - 2
mobile_app_install - 12
app_custom_event - 11
app_custom_event.fb_mobile_activate_app - 6
app_custom_event.other - 5In diesem Beispiel ist post_engagement die Summe von link_click, comment, like und post_reaction, wobei post_reaction die Anzahl aller Reaktionen einschließlich „Gefällt mir“-Angaben ist. Das Feld total_actions stellt die Summe der Handlungen der obersten Ebene für ein Objekt wie page_engagement, mobile_app_install und app_custom_event dar.
Aufschlüsselungen kombinieren
Aufgrund von Speicherbegrenzungen sind nur einige Varianten von Aufschlüsselungen verfügbar. Mit einem Sternchen (*) gekennzeichnete Varianten können mit action_type, action_target_id und action_destination (dem Namen für action_target_id) verbunden werden.
| Variante |
|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Einschränkungen
video_*-Felder können nicht mit stündlichen Aufschlüsselungen angefragt werden.- Das
video_avg_time_watched_actions-Feld kann nicht mit der Regionsaufschlüsselung angefragt werden. action_typewird implizit als dieaction_breakdownshinzugefügt, wenn deraction_breakdowns-Parameter nicht angegeben ist.