Transformation des rapports Facebook Ads

Preview

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Remarque : Pour obtenir de l'aide ou envoyer des commentaires sur cette fonctionnalité, contactez [e-mail].

Ce document explique comment vos rapports Facebook Ads sont transformés lorsque vous exécutez un transfert Facebook Ads vers BigQuery.

Mapper les tables pour les rapports Facebook Ads

Lorsque vos rapports Facebook Ads sont transférés vers BigQuery, ils sont transformés en tables et vues BigQuery comme indiqué ci-dessous.

Rapport AdAccounts

Nom du champ de l'API méta	Nom du champ BigQuery mappé	Type	Description
id	ID [KEY]	Chaîne	ID du compte publicitaire.
	Cible	Chaîne	Cible utilisée pour obtenir des comptes publicitaires. Cette valeur est "null" pour obtenir tous les comptes publicitaires.
account_id	AccountId	Chaîne	Identifiant du compte publicitaire lorsqu'il est consulté directement dans Facebook.
account_status	AccountStatus	Entier	État du compte. 1 = Actif, 2 = Désactivé, 3 = Non réglé, 7 = En attente d'examen, 9 = En délai de grâce, 101 = Temporairement indisponible, 100 = En attente de fermeture.
age	Âge	Double	Durée d'existence du compte publicitaire, en jours.
amount_spent	AmountSpent	Entier	Montant total actuel dépensé par le compte. Vous pouvez réinitialiser cette valeur.
balance	Balance	Entier	Montant dû de la facture.
business_city	BusinessCity	Chaîne	Ville de l'adresse de l'établissement.
business_country_code	BusinessCountryCode	Chaîne	Code pays de l'adresse de l'établissement.
business_name	BusinessName	Chaîne	Nom de l'entreprise associé au compte.
business_state	BusinessState	Chaîne	Abréviation de l'État pour l'adresse de l'établissement.
business_street	BusinessStreet	Chaîne	Première ligne de l'adresse postale de l'établissement pour le compte.
business_street2	BusinessStreet2	Chaîne	Deuxième ligne de l'adresse postale de l'établissement pour le compte.
business_zip	BusinessZip	Chaîne	Code postal de l'adresse de l'établissement.
capabilities	Capacités	Chaîne	Fonctionnalités autorisées pour ce compte publicitaire.
created_time	CreatedTime	Date/Heure	Heure de création du compte.
currency	Devise	Chaîne	Devise utilisée pour le compte, en fonction de la valeur correspondante dans les paramètres du compte.
min_campaign_group_spend_cap	MinCampaignGroupSpendCap	Chaîne	Limite minimale de dépenses pour le groupe de campagnes.
name	Nom	Chaîne	Nom du compte. Notez que de nombreux comptes ne portent pas de nom. Il est donc possible que ce champ soit vide.
offsite_pixels_tos_accepted	OffsitePixelsTosAccepted	Chaîne	Indique si le contrat des conditions d'utilisation des pixels hors site a été signé.
owner	OwnerId	Chaîne	ID Facebook du titulaire du compte publicitaire.
spend_cap	SpendCap	Entier	Montant maximal que ce compte peut dépenser au-delà duquel les campagnes seront mises en veille. La valeur 0 signifie qu'il n'y a pas de plafond de dépenses.
timezone_id	TimezoneId	Chaîne	ID du fuseau horaire.
timezone_name	TimezoneName	Chaîne	Nom du fuseau horaire.
timezone_offset_hours_utc	TimezoneOffsetHoursUTC	Double	Différence de fuseau horaire par rapport au fuseau UTC.

Rapport AdInsights

Nom du champ de l'API méta	Nom du champ BigQuery mappé	Type	Description
	Cible	Chaîne	ID du compte pour lequel obtenir des insights.
date_start	DateStart	Date	Date de début de la période pour laquelle vous souhaitez récupérer des insights. Dans l'UI Facebook, il s'agit du champ "Début du rapport".
date_stop	DateEnd	Date	Date de fin pour récupérer des insights. Dans l'interface utilisateur de Facebook, il s'agit du champ "Date de fin du rapport".
	TimeIncrement	Chaîne	Nombre de jours d'agrégation des données. Cette valeur est définie sur 1.
	Niveau	Chaîne	Niveau au niveau duquel les résultats doivent être représentés. Cette valeur est définie sur "ad".
account_currency	AccountCurrency	Chaîne	Devise utilisée par le compte publicitaire.
action_attribution_windows	ActionAttributionWindows	Chaîne	Liste séparée par des virgules qui détermine la période d'attribution des actions. Par exemple, 28d_click signifie que l'API renvoie toutes les actions qui se sont produites 28 jours après qu'un utilisateur a cliqué sur l'annonce. Cette option est définie sur [1d_view,28d_click].
account_id	AdAccountId	Chaîne	ID du compte publicitaire associé à la ligne du rapport.
account_name	AdAccountName	Chaîne	Nom du compte publicitaire associé à la ligne du rapport.
campaign_id	CampaignId	Chaîne	ID de la campagne associée à la ligne du rapport.
campaign_name	CampaignName	Chaîne	Nom de la campagne associée à la ligne du rapport.
adset_id	AdSetId	Chaîne	ID de l'ensemble d'annonces associé à la ligne du rapport.
adset_name	AdSetName	Chaîne	Nom de l'ensemble d'annonces associé à la ligne du rapport.
ad_id	AdId	Chaîne	ID de l'annonce associée à la ligne du rapport.
ad_name	AdName	Chaîne	Nom de l'annonce associée à la ligne du rapport.
buying_type	BuyingType	Chaîne	Méthode utilisée pour payer les annonces ciblées dans vos campagnes.
clicks	Clics	Long	Nombre total de clics sur votre annonce. Selon ce que vous promouvez, cela peut inclure les "J'aime" de la page, les réponses aux événements ou les installations d'applications. Dans l'interface utilisateur de Facebook, il s'agit du champ "Clics (Tous)".
conversion_rate_ranking	ConversionRateRanking	Chaîne	Classement du taux de conversion.
cost_per_estimated_ad_recallers	CostPerEstimatedAdRecallers	Décimal	Coût moyen par personne supplémentaire qui, selon nos estimations, se souviendra d'avoir vu votre annonce si elle y est interrogée dans les deux jours.
cost_per_inline_link_click	CostPerInlineLinkClick	Décimal	Coût moyen par clic sur les liens de l'annonce.
cost_per_inline_post_engagement	CostPerInlinePostEngagement	Décimal	Coût moyen par interaction sur le post.
cost_per_unique_click	CostPerUniqueClick	Décimal	Coût moyen par clic unique pour ces annonces, calculé en divisant le montant dépensé par le nombre de clics uniques reçus.
cost_per_unique_inline_link_click	CostPerUniqueInlineLinkClick	Décimal	Coût moyen que vous avez payé pour chaque clic unique sur un lien intégré.
cpc	CPC	Décimal	Coût par clic moyen de ces annonces, calculé en divisant le montant dépensé par le nombre de clics reçus.
cpm	CPM	Décimal	Coût moyen que vous avez payé pour 1 000 impressions de votre annonce.
cpp	CPP	Décimal	Coût moyen que vous avez payé pour diffuser votre annonce auprès de 1 000 personnes uniques.
ctr	CTR	Double	Nombre de clics enregistrés divisé par le nombre d'impressions. Dans l'interface utilisateur de Facebook, il s'agit du champ "CTR (Tout) %".
estimated_ad_recall_rate	EstimatedAdRecallRate	Double	Estimation du nombre de personnes qui se souviennent de votre annonce, divisé par le nombre de personnes touchées par votre annonce.
estimated_ad_recallers	EstimatedAdRecallers	Double	Nombre supplémentaire de personnes que nous estimons se souvenir d'avoir vu vos annonces si elles y sont interrogées dans les deux jours.
frequency	Fréquence	Double	Nombre moyen de fois où votre annonce a été diffusée auprès de chaque personne.
impressions	Impressions	Long	Nombre de fois où votre annonce a été diffusée. Dans les applications mobiles, une annonce est comptabilisée comme diffusée la première fois qu'elle est vue. Dans toutes les autres interfaces Facebook, une annonce est diffusée la première fois qu'elle est placée dans le flux d'actualités d'un utilisateur ou chaque fois qu'elle est placée dans la colonne de droite.
inline_link_clicks	InlineLinkClicks	Long	Nombre total de clics sur les liens de l'annonce.
inline_link_click_ctr	InlineLinkClicksCounter	Double	Taux de clics sur les liens intégrés.
inline_post_engagement	InlinePostEngagement	Long	Nombre total d'interactions avec le post.
instant_experience_clicks_to_open	InstantExperienceClicksToOpen	Long	Correspond au champ instant_experience_clicks_to_open de l'API META.
instant_experience_clicks_to_start	InstantExperienceClicksToStart	Long	Correspond au champ instant_experience_clicks_to_start de l'API META.
instant_experience_outbound_clicks	InstantExperienceOutboundClicks	Long	Correspond au champ "instant_experience_outbound_clicks" de l'API META.
objective	Objectif	Chaîne	L'objectif que vous avez sélectionné pour votre campagne. Votre objectif reflète l'objectif que vous souhaitez atteindre avec votre publicité.
quality_ranking	QualityRanking	Chaîne	Classement de qualité.
reach	Audience	Long	Nombre de personnes auprès desquelles votre annonce a été diffusée.
spend	Dépenses	Décimal	Montant total que vous avez dépensé à ce jour.
	UniqueClicks	Long	Nombre total de personnes uniques ayant cliqué sur votre annonce. Par exemple, si trois personnes cliquent sur la même annonce cinq fois, cela compte pour trois clics uniques.
	UniqueCTR	Double	Nombre de personnes ayant cliqué sur votre annonce, divisé par le nombre de personnes touchées. Par exemple, si vous avez reçu 20 clics uniques et que votre annonce a été diffusée auprès de 1 000 personnes uniques, votre taux de clics uniques est de 2%.
inline_link_clicks	UniqueInlineLinkClicks	Long	Nombre de clics uniques sur les liens intégrés de votre annonce. Dans l'interface utilisateur de Facebook, il s'agit du champ "Clics uniques sur un lien".
	UniqueInlineLinkClickCounter	Double	Taux de clics sur les liens intégrés uniques.
	UniqueLinkClicksCounter	Double	Taux de clics uniques sur un lien. Nombre de personnes ayant cliqué sur le lien de votre annonce qui les redirige vers un site externe, divisé par le nombre de personnes que vous avez touchées. Par exemple, si vous avez reçu 20 clics uniques vers le lien et que votre annonce a été diffusée auprès de 1 000 personnes uniques, votre taux de clics uniques est de 2%.
	Arrivées	Int	Nombre de check-ins attribués à l'annonce.
	EventResponses	Int	Nombre de réponses aux événements attribuées à l'annonce.
inline_link_clicks	LinkClicks	Int	Nombre de clics sur le lien attribués à l'annonce.
	OfferSaves	Int	Nombre d'offres de réception attribuées à l'annonce.
outbound_clicks	OutboundClicks	Int	Nombre de clics sortants attribués à l'annonce.
	PageEngagements	Int	Nombre d'engagements sur la page attribués à l'annonce.
	"J'aime" sur la page	Int	Nombre de "J'aime" attribués à la page.
	PageMentions	Int	Nombre de mentions de pages attribuées à l'annonce.
	PagePhotoViews	Int	Nombre de vues des photos attribuées à l'annonce.
	PostComments	Int	Nombre de commentaires sur le post attribués à l'annonce.
	PostEngagements	Int	Nombre d'engagements sur les posts attribués à l'annonce.
	PostShares	Int	Nombre de partages de posts attribués à l'annonce.
	PostReactions	Int	Nombre de réactions au post attribuées à l'annonce.
	PageTabViews	Int	Nombre de vues d'onglets attribuées à l'annonce.
	Région	Chaîne	Région dans laquelle l'utilisateur a vu l'annonce. Il s'agit d'un champ de répartition.
	Video3SecondViews	Int	Nombre de vues de la vidéo attribuées à l'annonce. Les vues sont comptabilisées si la vidéo a été visionnée pendant au moins trois secondes ou dans son intégralité (si elle dure moins de trois secondes).

Rapport AdInsightsActions

Nom du champ de l'API méta	Nom du champ BigQuery mappé	Type	Description
	Cible	Chaîne	ID du compte pour lequel obtenir des insights.
date_start	DateStart	Date	Date de début pour laquelle vous souhaitez récupérer des insights. Dans l'UI Facebook, il s'agit du champ "Début du rapport".
date_stop	DateEnd	Date	Date de fin pour laquelle vous souhaitez récupérer des insights. Dans l'interface utilisateur de Facebook, il s'agit du champ "Date de fin du rapport".
	TimeIncrement	Chaîne	Nombre de jours d'agrégation des données. Cette valeur est définie sur 1.
	Niveau	Chaîne	Niveau au niveau duquel les résultats doivent être représentés. La valeur est définie sur ad.
action_attribution_windows	ActionAttributionWindows	Chaîne	Liste séparée par des virgules qui détermine la période d'attribution des actions. Par exemple, 28d_click signifie que l'API renvoie toutes les actions qui se sont produites 28 jours après qu'un utilisateur a cliqué sur l'annonce. L'option par défaut signifie [1d_view,7d_click]. Les valeurs possibles sont 1d_view, 7d_view, 28d_view, 1d_click, 7d_click, 28d_click et default.
	ActionCollection	Chaîne	Collection d'actions à récupérer. La valeur est définie sur Actions.
account_id	AdAccountId	Chaîne	ID du compte publicitaire associé à la ligne du rapport.
account_name	AdAccountName	Chaîne	Nom du compte publicitaire associé à la ligne du rapport.
campaign_id	CampaignId	Chaîne	ID de la campagne associée à la ligne du rapport.
campaign_name	CampaignName	Chaîne	Nom de la campagne associée à la ligne du rapport.
adset_id	AdSetId	Chaîne	ID de l'ensemble d'annonces associé à la ligne du rapport.
adset_name	AdSetName	Chaîne	Nom de l'ensemble d'annonces associé à la ligne du rapport.
ad_id	AdId	Chaîne	ID de l'annonce associée à la ligne du rapport.
ad_name	AdName	Chaîne	Nom de l'annonce associée à la ligne du rapport.
actions.value	ActionValue	Entier	Valeur de la métrique de la période d'attribution par défaut.
actions.1d_click	Action1dClick	Chaîne	Valeur de la métrique de la période d'attribution un jour après le clic sur l'annonce.
actions.1d_view	Action1dView	Chaîne	Valeur de la métrique de la période d'attribution un jour après la visualisation de l'annonce.
actions.7d_click	Action7dClick	Chaîne	Valeur de la métrique de la période d'attribution sept jours après le clic sur l'annonce.
actions.7d_view	Action7dView	Chaîne	Valeur de la métrique de la période d'attribution sept jours après la visualisation de l'annonce.
actions.28d_click	Action28dClick	Chaîne	Valeur de la métrique de la période d'attribution 28 jours après le clic sur l'annonce.
actions.28d_view	Action28dView	Chaîne	Valeur de la métrique de la période d'attribution 28 jours après le visionnage de l'annonce.
actions.dda	ActionDDA	Chaîne	Valeur de la métrique de la période d'attribution basée sur un modèle d'attribution basée sur les données.