Facebook Ads-Berichte umwandeln
In diesem Dokument wird beschrieben, wie Ihre Facebook Ads-Berichte bei einer Facebook Ads-Übertragung in BigQuery transformiert werden.
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
Name des Meta API-Felds | Zugewiesener BigQuery-Feldname | Typ | Beschreibung |
---|---|---|---|
id |
ID [KEY] | String | Die ID des Google Ads-Kontos. |
|
Ziel | String | Das Ziel, von dem aus Anzeigenkonten abgerufen werden. 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 beglichen, 7 = Überprüfung ausstehend, 9 = Kulanzzeitraum, 101 = vorübergehend nicht verfügbar, 100 = Schließung ausstehend. |
age |
Alter | Doppelt | Die Zeitspanne in Tagen, seit das Werbekonto erstellt wurde. |
amount_spent |
AmountSpent | Ganzzahl | Der aktuelle Gesamtbetrag, der über das Konto ausgegeben wurde. Dieser Wert 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 Name des Unternehmens für das Konto. |
business_state |
BusinessState | String | Abkürzung des US-Bundesstaats für die Geschäftsadresse. |
business_street |
BusinessStreet | String | Erste Zeile der Adresse des Unternehmens für das Konto. |
business_street2 |
BusinessStreet2 | String | Zweite Zeile der Adresse des Unternehmens 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 für das Konto verwendete Währung, 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, sodass dieses Feld möglicherweise leer ist. |
offsite_pixels_tos_accepted |
OffsitePixelsTosAccepted | String | Gibt an, ob der Vertrag zu den Nutzungsbedingungen für das Offsite-Pixel unterzeichnet wurde. |
owner |
OwnerId | String | Facebook-ID des Inhabers des Werbekontos. |
spend_cap |
SpendCap | Ganzzahl | Der Betrag, der für dieses Konto maximal ausgegeben werden kann, bis Kampagnen pausiert werden. Ein Wert von 0 bedeutet, dass keine Ausgabenobergrenze festgelegt ist. |
timezone_id |
TimezoneId | String | ID der Zeitzone. |
timezone_name |
TimezoneName | String | Name der Zeitzone. |
timezone_offset_hours_utc |
TimezoneOffsetHoursUTC | Doppelt | Zeitzonenunterschied zu UTC. |
AdInsights
-Bericht
Name des Meta API-Felds | Zugewiesener 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 „Berichtsbeginn“. |
date_stop |
DateEnd | Datum | Das Enddatum für den Abruf von Statistiken. In der Facebook-Benutzeroberfläche ist dies das Feld „Ende des Berichtszeitraums“. |
|
TimeIncrement | String | Die Anzahl der Tage, für die Daten zusammengefasst werden. Dieser Wert ist auf „1“ festgelegt. |
|
Level | String | Ebene, auf der die Ergebnisse dargestellt werden sollen. Dieser Wert ist auf „ad“ festgelegt. |
account_currency |
AccountCurrency | String | Die Währung, die für das Werbekonto verwendet wird. |
action_attribution_windows |
ActionAttributionWindows | String | Eine durch Kommas getrennte Liste, mit der das Attributionsfenster für die Aktionen festgelegt wird. „28d_click“ bedeutet beispielsweise, dass die API alle Aktionen zurückgibt, die 28 Tage nach einem 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 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 des Anzeigensets, die mit der Berichtszeile verknüpft ist. |
adset_name |
AdSetName | String | Der Name des Anzeigensets, das mit der Berichtszeile verknüpft ist. |
AdId | ad_id |
String | Die ID der Anzeige, die der Berichtszeile zugeordnet ist. |
ad_name |
AdName | String | Der Name der Anzeige, der der Berichtszeile zugeordnet ist. |
buying_type |
BuyingType | String | Die Methode, mit der in Ihren Kampagnen Anzeigen mit Ausrichtung bezahlt werden. |
clicks |
Klicks | Lang | Die Gesamtzahl der Klicks auf Ihre Anzeige. Je nachdem, was Sie bewerben, können dies Seiten-Likes, Ereignisantworten oder App-Installationen sein. In der Facebook-Benutzeroberfläche ist das das Feld „Klicks (alle)“. |
conversion_rate_ranking |
ConversionRateRanking | String | Die Rangfolge der Conversion-Rate. |
cost_per_estimated_ad_recallers |
CostPerEstimatedAdRecallers | Decimal | Die durchschnittlichen Kosten pro zusätzlicher Person, die sich Ihrer Schätzung nach innerhalb von zwei Tagen an Ihre Anzeige erinnern wird. |
cost_per_inline_link_click |
CostPerInlineLinkClick | Decimal | Der durchschnittliche Cost-per-Click auf Links in der Anzeige. |
cost_per_inline_post_engagement |
CostPerInlinePostEngagement | Decimal | Die durchschnittlichen Kosten pro Interaktion mit dem Beitrag. |
cost_per_unique_click |
CostPerUniqueClick | Decimal | Die durchschnittlichen Kosten pro einzelnem Klick für diese Anzeigen. Dieser Wert wird berechnet, indem die Ausgaben durch die Anzahl der einzelnen Klicks geteilt werden. |
cost_per_unique_inline_link_click |
CostPerUniqueInlineLinkClick | Decimal | Der durchschnittliche Betrag, den Sie pro Klick auf einen einzelnen Inline-Link bezahlt haben. |
cpc |
CPC | Decimal | Der durchschnittliche Cost-per-Click für diese Anzeigen, berechnet als Ausgaben geteilt durch die Anzahl der 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 für die Auslieferung Ihrer Anzeige an 1.000 Nutzer bezahlt haben. |
ctr |
CTR | Doppelt | Die Anzahl der Klicks geteilt durch die Anzahl der Impressionen. In der Facebook-Benutzeroberfläche ist dies das Feld „CTR (alle) %“. |
estimated_ad_recall_rate |
EstimatedAdRecallRate | Doppelt | Die geschätzte Anzahl der Nutzer, die sich an Ihre Anzeige erinnern, geteilt durch die Anzahl der Nutzer, die Ihre Anzeige erreicht hat. |
estimated_ad_recallers |
EstimatedAdRecallers | Doppelt | Die zusätzliche Anzahl von Nutzern, die sich Ihre Anzeigen laut unserer Schätzung innerhalb von zwei Tagen erinnern werden, wenn sie danach gefragt werden. |
frequency |
Häufigkeit | Doppelt | Die durchschnittliche Anzahl der Auslieferungen Ihrer Anzeige an eine 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 zum ersten Mal ausgeliefert, wenn sie 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 | Doppelt | 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. Das Zielvorhaben gibt an, was 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 Nutzer fünfmal auf dieselbe Anzeige klicken, werden drei einzelne Klicks gezählt. |
|
UniqueCTR | Doppelt | 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 die CTR für einzelne Nutzer 2%. |
inline_link_clicks |
UniqueInlineLinkClicks | Lang | Die Anzahl der einzelnen Klicks auf einen Inlinelink in Ihrer Anzeige. In der Facebook-Benutzeroberfläche ist dies das Feld „Einzelne Klicks auf Link“. |
|
UniqueInlineLinkClickCounter | Doppelt | Die Klickrate für einzelne Inline-Klicks auf den Link. |
|
UniqueLinkClicksCounter | Doppelt | Die Klickrate für Klicks auf den Link. Die Anzahl der Nutzer, die auf den Link in Ihrer Anzeige geklickt haben, über den sie zu einer externen Website weitergeleitet werden, geteilt durch die Anzahl der Nutzer, die Sie erreicht haben. Wenn Sie beispielsweise 20 einzelne Klicks auf den Link erhalten haben und Ihre Anzeige 1.000 einzelnen Nutzern präsentiert wurde, beträgt die Klickrate für einzelne Nutzer 2%. |
|
Check-ins | Int | Die Anzahl der Check-ins, die der Anzeige zugeordnet sind. |
|
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 empfangenen Angebote, die der Anzeige zugeordnet sind. |
outbound_clicks |
OutboundClicks | Int | Die Anzahl der Klicks auf externe Links, 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 sind. |
|
PageMentions | Int | Die Anzahl der Seitenerwähnungen, die der Anzeige zugeordnet sind. |
|
PagePhotoViews | Int | Die Anzahl der Fotoaufrufe, die der Anzeige zugeordnet werden. |
|
PostComments | Int | Die Anzahl der Kommentare zu Beiträgen, die der Anzeige zugeordnet sind. |
|
PostEngagements | Int | Die Anzahl der Interaktionen mit einem Beitrag, die der Anzeige zugeordnet werden. |
|
PostShares | Int | Die Anzahl der Beiträge, die der Anzeige zugeordnet wurden. |
|
PostReactions | Int | Die Anzahl der Reaktionen auf einen Beitrag, die der Anzeige zugeordnet sind. |
|
PageTabViews | Int | Die Anzahl der Tabaufrufe, die der Anzeige zugeordnet werden. |
|
Video3SecondViews | Int | Die Anzahl der Videoaufrufe, die der Anzeige zugeordnet wurden. Aufrufe werden gezählt, wenn ein Video mindestens 3 Sekunden lang oder bis zum Ende wiedergegeben wurde (bei kürzeren Videos wird das gesamte Video gezählt). |
AdInsightsActions
-Bericht
Name des Meta API-Felds | Zugewiesener 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 „Berichtsbeginn“. |
date_stop |
DateEnd | Datum | Das Enddatum, für das Statistiken abgerufen werden sollen. In der Facebook-Benutzeroberfläche ist dies das Feld „Ende des Berichtszeitraums“. |
|
TimeIncrement | String | Die Anzahl der Tage, für die Daten zusammengefasst werden. Dieser Wert ist auf „1“ festgelegt. |
|
Level | String | 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 das Attributionsfenster für die Aktionen festlegt. „28d_click“ bedeutet beispielsweise, dass die API alle Aktionen zurückgibt, die 28 Tage nach einem Klick auf die Anzeige erfolgt sind. Die Standardoption entspricht [1d_view,7d_click]. Zulässige Werte: 1d_view, 7d_view, 28d_view, 1d_click, 7d_click, 28d_click, default. |
|
ActionCollection | String | Die Aktionssammlung, die abgerufen werden soll. Der Wert ist auf Actions 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 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 des Anzeigensets, die mit der Berichtszeile verknüpft ist. |
adset_name |
AdSetName | String | Der Name des Anzeigensets, das 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. |
actions.action_type |
ActionType | String | Aktionen, die auf Ihre Anzeige, Seite, App oder ein Ereignis ausgeführt wurden, nachdem Ihre Anzeige einem Nutzer präsentiert wurde, auch wenn er nicht auf die Anzeige geklickt hat. |
actions.value |
ActionValue | Ganzzahl | Messwert für das Standard-Attributionsfenster. |
actions.1d_click |
Action1dClick | String | Messwert des Attributionszeitraums 1 Tag nach dem Klicken auf die Anzeige. |
actions.1d_view |
Action1dView | String | Messwert für den Attributionszeitraum 1 Tag nach dem Betrachten der Anzeige. |
actions.7d_click |
Action7dClick | String | Messwert für das Attributionsfenster 7 Tage nach dem Klicken auf die Anzeige. |
actions.7d_view |
Action7dView | String | Messwert für den Attributionszeitraum sieben Tage nach der Auslieferung der Anzeige. |
actions.28d_click |
Action28dClick | String | Messwert des Attributionszeitraums 28 Tage nach dem Klicken auf die Anzeige. |
actions.28d_view |
Action28dView | String | Messwert für den Attributionszeitraum 28 Tage nach der Anzeigenauslieferung. |
actions.dda |
ActionDDA | String | Messwert des Attributionszeitraums, der auf einem datengetriebenen Modell basiert. |
actions.action_canvas_component_name |
ActionCanvasComponentName | String | Name einer Komponente in einer Canvas-Anzeige. |
actions.action_carousel_card_id |
ActionCarouselCardId | String | Die ID der bestimmten Karussellkarte, mit der Nutzer interagiert haben, als sie Ihre Anzeige gesehen haben. |
actions.action_carousel_card_name |
ActionCarouselCardName | String | Die bestimmte Karussellkarte, mit der Nutzer interagiert haben, als sie Ihre Anzeige gesehen haben. Die Karten werden anhand ihrer Überschriften identifiziert. |
actions.action_destination |
ActionDestination | String | Das Ziel, zu dem Nutzer weitergeleitet werden, nachdem sie auf Ihre Anzeige geklickt haben. |
actions.action_device |
ActionDevice | String | Das Gerät, auf dem das Conversion-Ereignis erfasst wurde. |
actions.action_reaction |
ActionReaction | String | Die Anzahl der Reaktionen auf Ihre Anzeigen oder geboosteten Beiträge. |
actions.action_target_id |
ActionTargetId | String | Die ID des Ziels, zu dem Nutzer weitergeleitet werden, nachdem sie auf Ihre Anzeige geklickt haben. |
actions.action_video_sound |
ActionVideoSound | String | Der Tonstatus (an/aus), wenn sich ein Nutzer Ihre Videoanzeige ansieht. |