Umwandlung von Facebook Ads-Berichten
In diesem Dokument wird beschrieben, wie Ihre Facebook Ads-Berichte transformiert werden, wenn Sie eine Facebook Ads-Übertragung nach BigQuery ausführen.
Tabellenzuordnung für Facebook Ads-Berichte
Ihre Facebook Ads-Berichte werden bei der Übertragung in BigQuery in die folgenden BigQuery-Tabellen und -Ansichten umgewandelt.
AdAccounts-Bericht
| Meta-API-Feldname | Zugeordneter BigQuery-Feldname | Typ | Beschreibung |
|---|---|---|---|
id |
ID [KEY] | String | Die ID des Werbekontos. |
|
Ziel | String | Das Ziel, von dem Anzeigenkonten abgerufen werden sollen. Dieser Wert ist „null“, um alle Anzeigenkonten abzurufen. |
account_id |
AccountId | String | Die ID des Werbekontos, wenn es direkt in Facebook aufgerufen wird. |
account_status |
AccountStatus | Ganzzahl | Status des Kontos. 1 = Aktiv, 2 = Deaktiviert, 3 = Nicht abgerechnet, 7 = Überprüfung steht aus, 9 = Im Kulanzzeitraum, 101 = Vorübergehend nicht verfügbar, 100 = Schließung steht aus. |
age |
Alter | Double | Anzahl der Tage, seit denen das Werbekonto besteht. |
amount_spent |
AmountSpent | Ganzzahl | Der aktuelle Gesamtbetrag, der für das Konto ausgegeben wurde. Das kann zurückgesetzt werden. |
balance |
Kontostand | Ganzzahl | Fälliger Rechnungsbetrag. |
business_city |
BusinessCity | String | Ort der Geschäftsadresse. |
business_country_code |
BusinessCountryCode | String | Ländercode der Geschäftsadresse. |
business_name |
BusinessName | String | Der Unternehmensname für das Konto. |
business_state |
BusinessState | String | Abkürzung des Bundesstaats für die Geschäftsadresse. |
business_street |
BusinessStreet | String | Die erste Zeile der Geschäftsadresse für das Konto. |
business_street2 |
BusinessStreet2 | String | Zweite Zeile der Geschäftsadresse für das Konto. |
business_zip |
BusinessZip | String | Postleitzahl der Geschäftsadresse. |
capabilities |
Leistungsspektrum | String | Für dieses Werbekonto zulässige Funktionen. |
created_time |
CreatedTime | Datum/Uhrzeit | Der Zeitpunkt, zu dem das Konto erstellt wurde. |
currency |
Währung | String | Die Währung, die für das Konto verwendet wird, basierend auf dem entsprechenden Wert in den Kontoeinstellungen. |
min_campaign_group_spend_cap |
MinCampaignGroupSpendCap | String | Das Mindestausgabenlimit für die Kampagnengruppe. |
name |
Name | String | Name des Kontos. Viele Konten haben keinen Namen, daher kann dieses Feld leer sein. |
offsite_pixels_tos_accepted |
OffsitePixelsTosAccepted | String | Gibt an, ob der Vertrag zu den Nutzungsbedingungen für Offsite-Pixel unterzeichnet wurde. |
owner |
OwnerId | String | Die Facebook-ID des Inhabers des Werbekontos. |
spend_cap |
SpendCap | Ganzzahl | Der maximale Betrag, der für dieses Konto ausgegeben werden kann, bevor Kampagnen pausiert werden. Ein Wert von 0 bedeutet, dass es kein Ausgabenlimit gibt. |
timezone_id |
TimezoneId | String | ID für die Zeitzone. |
timezone_name |
TimezoneName | String | Name für die Zeitzone. |
timezone_offset_hours_utc |
TimezoneOffsetHoursUTC | Double | Zeitunterschied zur UTC-Zeit. |
AdInsights-Bericht
| Meta-API-Feldname | Zugeordneter BigQuery-Feldname | Typ | Beschreibung |
|---|---|---|---|
|
Ziel | String | Die ID des Kontos, für das Statistiken abgerufen werden sollen. |
date_start |
DateStart | Datum | Das Startdatum für den Abruf von Statistiken. In der Facebook-Benutzeroberfläche ist das das Feld „Berichtszeitraum“. |
date_stop |
DateEnd | Datum | Das Enddatum für den Abruf von Statistiken. In der Facebook-Benutzeroberfläche ist das das Feld „Berichtsende“. |
|
TimeIncrement | String | Die Anzahl der Tage, über die Daten zusammengefasst werden. Dieser Wert ist auf 1 festgelegt. |
|
Level | String | Die Ebene, auf der die Ergebnisse dargestellt werden sollen. Dieser Wert ist auf „ad“ festgelegt. |
account_currency |
AccountCurrency | String | Die Währung, die vom Werbekonto verwendet wird. |
action_attribution_windows |
ActionAttributionWindows | String | Eine durch Kommas getrennte Liste, die das Attributionszeitfenster für die Aktionen festlegt. Beispiel: „28d_click“ bedeutet, dass die API alle Aktionen zurückgibt, die 28 Tage nach dem Klick auf die Anzeige erfolgt sind. Diese Option ist auf [1d_view,28d_click] festgelegt. |
account_id |
AdAccountId | String | Die ID des Werbekontos, das mit der Berichtszeile verknüpft ist. |
account_name |
AdAccountName | String | Der Name des Anzeigenkontos, das mit der Berichtszeile verknüpft ist. |
campaign_id |
CampaignId | String | Die ID der Kampagne, die der Berichtszeile zugeordnet ist. |
campaign_name |
CampaignName | String | Der Name der Kampagne, die mit der Berichtszeile verknüpft ist. |
adset_id |
AdSetId | String | Die ID des Anzeigensatzes, der mit der Berichtszeile verknüpft ist. |
adset_name |
AdSetName | String | Der Name der Anzeigengruppe, die mit der Berichtszeile verknüpft ist. |
ad_id |
AdId | String | Die ID der Anzeige, die mit der Berichtszeile verknüpft ist. |
ad_name |
AdName | String | Der Name der Anzeige, die mit der Berichtszeile verknüpft ist. |
buying_type |
BuyingType | String | Die Methode, mit der Zielanzeigen in Ihren Kampagnen bezahlt werden. |
clicks |
Klicks | Lang | Die Gesamtzahl der Klicks auf Ihre Anzeige. Je nachdem, was Sie bewerben, können das Seiten-Likes, Event-Antworten oder App-Installationen sein. In der Facebook-Benutzeroberfläche ist das das Feld „Klicks (alle)“. |
conversion_rate_ranking |
ConversionRateRanking | String | Das Ranking der Conversion-Rate. |
cost_per_estimated_ad_recallers |
CostPerEstimatedAdRecallers | Decimal | Die durchschnittlichen Kosten pro zusätzlicher Person, die sich innerhalb von zwei Tagen voraussichtlich daran erinnern wird, Ihre Anzeige gesehen zu haben, wenn sie danach gefragt wird. |
cost_per_inline_link_click |
CostPerInlineLinkClick | Decimal | Die durchschnittlichen Kosten pro Klick auf Links in der Anzeige. |
cost_per_inline_post_engagement |
CostPerInlinePostEngagement | Decimal | Die durchschnittlichen Kosten pro Engagement für den Beitrag. |
cost_per_unique_click |
CostPerUniqueClick | Decimal | Die durchschnittlichen Kosten pro eindeutigem Klick für diese Anzeigen, berechnet als Ausgaben geteilt durch die Anzahl der eindeutigen Klicks. |
cost_per_unique_inline_link_click |
CostPerUniqueInlineLinkClick | Decimal | Der durchschnittliche Betrag, den Sie für jeden einzelnen Inline-Linkklick bezahlt haben. |
cpc |
CPC | Decimal | Die durchschnittlichen Kosten pro Klick für diese Anzeigen, berechnet als Ausgaben geteilt durch die Anzahl der erhaltenen Klicks. |
cpm |
CPM | Decimal | Die durchschnittlichen Kosten,die Sie für 1.000 Impressionen Ihrer Anzeige bezahlt haben. |
cpp |
CPP | Decimal | Die durchschnittlichen Kosten, die Sie bezahlt haben, damit Ihre Anzeige für 1.000 einzelne Nutzer ausgeliefert wird. |
ctr |
CTR | Double | Die Anzahl der erzielten Klicks geteilt durch die Anzahl der Impressionen. In der Facebook-Benutzeroberfläche ist das das Feld „CTR (Alle) %“. |
estimated_ad_recall_rate |
EstimatedAdRecallRate | Double | Die geschätzte Anzahl der Personen, die sich an Ihre Anzeige erinnern, geteilt durch die Anzahl der Personen, die Ihre Anzeige erreicht hat. |
estimated_ad_recallers |
EstimatedAdRecallers | Double | Die zusätzliche Anzahl von Personen, die sich nach unserer Schätzung innerhalb von zwei Tagen daran erinnern, Ihre Anzeigen gesehen zu haben, wenn sie danach gefragt werden. |
frequency |
Häufigkeit | Double | Die durchschnittliche Anzahl der Auslieferungen Ihrer Anzeige für jede Person. |
impressions |
Impressionen | Lang | Gibt an, wie oft Ihre Anzeige ausgeliefert wurde. In mobilen Apps wird eine Anzeige als ausgeliefert gezählt, wenn sie zum ersten Mal angesehen wird. Auf allen anderen Facebook-Oberflächen wird eine Anzeige ausgeliefert, wenn sie zum ersten Mal im Newsfeed einer Person platziert wird oder jedes Mal, wenn sie in der rechten Spalte platziert wird. |
inline_link_clicks |
InlineLinkClicks | Lang | Die Gesamtzahl der Klicks auf Links in der Anzeige. |
inline_link_click_ctr |
InlineLinkClicksCounter | Double | Die Klickrate für Inline-Klicks auf den Link. |
inline_post_engagement |
InlinePostEngagement | Lang | Die Gesamtzahl der Interaktionen mit dem Beitrag. |
instant_experience_clicks_to_open |
InstantExperienceClicksToOpen | Lang | Entspricht dem Feld „instant_experience_clicks_to_open“ aus der META API. |
instant_experience_clicks_to_start |
InstantExperienceClicksToStart | Lang | Entspricht dem Feld „instant_experience_clicks_to_start“ aus der META API. |
instant_experience_outbound_clicks |
InstantExperienceOutboundClicks | Lang | Entspricht dem Feld „instant_experience_outbound_clicks“ aus der META API. |
objective |
Ziel | String | Das Zielvorhaben, das Sie für Ihre Kampagne ausgewählt haben. Ihr Zielvorhaben entspricht dem Ziel, das Sie mit Ihrer Werbung erreichen möchten. |
quality_ranking |
QualityRanking | String | Das Qualitätsranking. |
reach |
Reichweite | Lang | Die Anzahl der Nutzer, für die Ihre Anzeige ausgeliefert wurde. |
spend |
Ausgaben | Decimal | Der Gesamtbetrag, den Sie bisher ausgegeben haben. |
|
UniqueClicks | Lang | Die Gesamtzahl der einzelnen Nutzer, die auf Ihre Anzeige geklickt haben. Wenn beispielsweise drei Personen jeweils fünfmal auf dieselbe Anzeige klicken, werden drei eindeutige Klicks gezählt. |
|
UniqueCTR | Double | Die Anzahl der Nutzer, die auf Ihre Anzeige geklickt haben, geteilt durch die Anzahl der Nutzer, die Sie erreicht haben. Wenn Sie beispielsweise 20 einzelne Klicks erhalten haben und Ihre Anzeige 1.000 einzelnen Nutzern präsentiert wurde, beträgt Ihre einzelne Klickrate 2%. |
inline_link_clicks |
UniqueInlineLinkClicks | Lang | Die Anzahl der einzelnen Inline-Link-Klicks, die Ihre Anzeige erzielt hat. In der Facebook-Benutzeroberfläche ist das das Feld „Einzelne Linkklicks“. |
|
UniqueInlineLinkClickCounter | Double | Die Klickrate für einzelne Inline-Klicks auf den Link. |
|
UniqueLinkClicksCounter | Double | Die einzelne Klickrate für Klicks auf den Link. Die Anzahl der Personen, die auf den Link in Ihrer Anzeige geklickt haben, der Nutzer von Facebook wegführt, geteilt durch die Anzahl der Personen, die Sie erreicht haben. Wenn Sie beispielsweise 20 einzelne Linkklicks erhalten haben und Ihre Anzeige 1.000 einzelnen Nutzern präsentiert wurde, beträgt Ihre einzelne Klickrate 2%. |
|
Check-ins | Int | Die Anzahl der Check-ins, die der Anzeige zugeordnet wurden. |
|
EventResponses | Int | Die Anzahl der Ereignisantworten, die der Anzeige zugeordnet sind. |
inline_link_clicks |
LinkClicks | Int | Die Anzahl der Linkklicks, die der Anzeige zugeordnet werden. |
|
OfferSaves | Int | Die Anzahl der erhaltenen Angebote, die der Anzeige zugeordnet sind. |
outbound_clicks |
OutboundClicks | Int | Die Anzahl der ausgehenden Klicks, die der Anzeige zugeordnet werden. |
|
PageEngagements | Int | Die Anzahl der Seiteninteraktionen, die der Anzeige zugeordnet werden. |
|
PageLikes | Int | Die Anzahl der Seiten-Likes, die der Anzeige zugeordnet werden. |
|
PageMentions | Int | Die Anzahl der Seitenverweise, die der Anzeige zugeordnet werden. |
|
PagePhotoViews | Int | Die Anzahl der Fotoaufrufe, die der Anzeige zugeordnet werden. |
|
PostComments | Int | Die Anzahl der Post-Kommentare, die der Anzeige zugeordnet werden. |
|
PostEngagements | Int | Die Anzahl der Post-Interaktionen, die der Anzeige zugeordnet werden. |
|
PostShares | Int | Die Anzahl der Post-Freigaben, die der Anzeige zugeordnet werden. |
|
PostReactions | Int | Die Anzahl der Beitragsreaktionen, die der Anzeige zugeordnet werden. |
|
PageTabViews | Int | Die Anzahl der Tabaufrufe, die der Anzeige zugeordnet werden. |
|
Region | String | Die Region, in der sich ein Nutzer die Anzeige angesehen hat. Dies ist ein Aufschlüsselungsfeld. |
|
Video3SecondViews | Int | Die Anzahl der Videoaufrufe, die der Anzeige zugeordnet werden. Aufrufe werden gezählt, wenn mindestens 3 Sekunden oder das gesamte Video (wenn es kürzer als 3 Sekunden ist) wiedergegeben wurden. |
| Allgemeine Aufschlüsselungen | |||
|
Alter | String | Die Altersspanne für die Messwerte in dieser Zeile. |
|
Geschlecht | String | Das Geschlecht für die Messwerte in dieser Zeile. |
|
Land | String | Das Land für die Messwerte in dieser Zeile. |
|
Region | String | Die Region, in der sich der Nutzer befand, als er die Anzeige gesehen hat. |
|
FrequencyValue | String | Die Anzahl der Auslieferungen einer Anzeige in Ihrer Kampagne zur Steigerung von Reichweite und Häufigkeit an die einzelnen Nutzer. |
|
HStatsByAdvertiserTZ | String | Der Zeitraum, für den die Statistiken für den Werbetreibenden erfasst wurden. |
|
HStatsByAudienceTZ | String | Zeitraum, in dem die Statistiken für die Zielgruppe erhoben wurden. |
|
ImpressionDevice | String | Die Geräte, auf denen die Anzeige angesehen wurde. |
|
PlatformPosition | String | Die Position auf der Plattform. |
|
PublisherPlatform | String | Die Plattformen, auf denen die Anzeigen veröffentlicht wurden. |
|
Product_Id (Produkt-ID) | String | Die Produkt-ID, die in der Anzeige beworben wird. |
AdInsightsActions-Bericht
ACTION_COLLECTION bezieht sich auf die Arten von Aktionen, die Nutzer als Reaktion auf Ihre Anzeige ausgeführt haben. Eine vollständige Liste der Aktionssammlungen finden Sie unter Aktionssammlungen.
| Meta-API-Feldname | Zugeordneter BigQuery-Feldname | Typ | Beschreibung |
|---|---|---|---|
|
Ziel | String | Die ID des Kontos, für das Statistiken abgerufen werden sollen. |
date_start |
DateStart | Datum | Das Startdatum, für das Statistiken abgerufen werden sollen. In der Facebook-Benutzeroberfläche ist das das Feld „Berichtszeitraum“. |
date_stop |
DateEnd | Datum | Das Enddatum, für das Statistiken abgerufen werden sollen. In der Facebook-Benutzeroberfläche ist das das Feld „Berichtsende“. |
|
TimeIncrement | String | Die Anzahl der Tage, über die Daten zusammengefasst werden. Dieser Wert ist auf 1 festgelegt. |
|
Level | String | Die Ebene, auf der die Ergebnisse dargestellt werden sollen. Der Wert ist auf ad festgelegt. |
action_attribution_windows |
ActionAttributionWindows | String | Eine durch Kommas getrennte Liste, die den Attributionszeitraum für die Aktionen festlegt. Beispiel: „28d_click“ bedeutet, dass die API alle Aktionen zurückgibt, die 28 Tage nach dem Klick auf die Anzeige erfolgt sind. Die Standardoption ist [1d_view,7d_click]. Mögliche Werte sind 1d_view, 7d_view, 28d_view, 1d_click, 7d_click, 28d_click und default. |
|
ActionCollection | String | Das hängt von der Auswahl der Aktionssammlungen bei der Übertragung ab. |
account_id |
AdAccountId | String | Die ID des mit der Berichtszeile verknüpften Werbekontos. |
account_name |
AdAccountName | String | Der Name des Anzeigenkontos, das mit der Berichtszeile verknüpft ist. |
campaign_id |
CampaignId | String | Die ID der Kampagne, die mit der Berichtszeile verknüpft ist. |
campaign_name |
CampaignName | String | Der Name der Kampagne, die mit der Berichtszeile verknüpft ist. |
adset_id |
AdSetId | String | Die ID der Anzeigengruppe, die mit der Berichtszeile verknüpft ist. |
adset_name |
AdSetName | String | Der Name der Anzeigengruppe, die mit der Berichtszeile verknüpft ist. |
ad_id |
AdId | String | Die ID der Anzeige, die mit der Berichtszeile verknüpft ist. |
ad_name |
AdName | String | Der Name der Anzeige, die mit der Berichtszeile verknüpft ist. |
ACTION_COLLECTION.value |
ActionValue | Ganzzahl | Messwertwert des Standard-Attributionszeitraums. |
ACTION_COLLECTION.1d_click |
Action1dClick | String | Messwert des Attributionszeitraums einen Tag nach dem Klicken auf die Anzeige. |
ACTION_COLLECTION.1d_view |
Action1dView | String | Messwert des Attributionszeitraums einen Tag nach dem Ansehen der Anzeige. |
ACTION_COLLECTION.7d_click |
Action7dClick | String | Messwert des Attributionszeitraums 7 Tage nach dem Klicken auf die Anzeige. |
ACTION_COLLECTION.7d_view |
Action7dView | String | Messwert des Attributionszeitraums 7 Tage nach dem Ansehen der Anzeige. |
ACTION_COLLECTION.28d_click |
Action28dClick | String | Messwert des Attributionszeitraums 28 Tage nach dem Klicken auf die Anzeige. |
ACTION_COLLECTION.28d_view |
Action28dView | String | Messwert des Attributionszeitraums 28 Tage nach dem Ansehen der Anzeige. |
ACTION_COLLECTION.dda |
ActionDDA | String | Messwert des Attributionszeitraums, der auf einem datengetriebenen Modell basiert. |
| Allgemeine Aufschlüsselungen | |||
|
Alter | String | Die Altersspanne für die Messwerte in dieser Zeile. |
|
Geschlecht | String | Das Geschlecht für die Messwerte in dieser Zeile. |
|
Land | String | Das Land für die Messwerte in dieser Zeile. |
|
Region | String | Die Region, in der sich der Nutzer befand, als er die Anzeige gesehen hat. |
|
FrequencyValue | String | Die Anzahl der Auslieferungen einer Anzeige in Ihrer Kampagne zur Steigerung von Reichweite und Häufigkeit an die einzelnen Nutzer. |
|
HStatsByAdvertiserTZ | String | Der Zeitraum, für den die Statistiken für den Werbetreibenden erfasst wurden. |
|
HStatsByAudienceTZ | String | Zeitraum, in dem die Statistiken für die Zielgruppe erhoben wurden. |
|
ImpressionDevice | String | Die Geräte, auf denen die Anzeige angesehen wurde. |
|
PlatformPosition | String | Die Position auf der Plattform. |
|
PublisherPlatform | String | Die Plattformen, auf denen die Anzeigen veröffentlicht wurden. |
|
Product_Id (Produkt-ID) | String | Die Produkt-ID, die in der Anzeige beworben wird. |
| Aufschlüsselungen von Aktionen | |||
| ActionType | String | Die Art der Aktionen, die mit Ihrer Anzeige ausgeführt werden, nachdem sie für einen Nutzer ausgeliefert wurde, auch wenn er nicht darauf geklickt hat. | |
| ActionCanvasComponentName | String | Name einer Komponente in einer Canvas-Anzeige. | |
| ActionCarouselCardId | String | Die ID der spezifischen Karussellkarte, mit der Nutzer interagiert haben, als sie Ihre Anzeige gesehen haben. | |
| ActionCarouselCardName | String | Die spezifische Karussellkarte, mit der Nutzer interagiert haben, als sie Ihre Anzeige gesehen haben. Die Karten werden anhand ihrer Überschriften identifiziert. | |
| ActionDestination | String | Das Ziel, zu dem Nutzer nach dem Klicken auf Ihre Anzeige weitergeleitet werden. | |
| ActionDevice | String | Das Gerät, auf dem das Conversion-Ereignis, das Sie erfassen, stattgefunden hat. | |
| ActionReaction | String | Die Anzahl der Reaktionen auf Ihre Anzeigen oder beworbenen Beiträge. | |
| ActionTargetId | String | Die ID des Ziels, zu dem Nutzer nach dem Klicken auf Ihre Anzeige weitergeleitet werden. | |
| ActionVideoSound | String | Der Tonstatus (an/aus), wenn sich der Nutzer Ihre Videoanzeige ansieht. | |
| ActionVideoType | String | Aufschlüsselung der Videomesswerte | |
| ActionConvertedProductId | String | Konvertierte Produkt-IDs für Collaborative Ads. | |