Transformation des rapports Facebook Ads

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 le réinitialiser.
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 du groupe de campagnes.
name Nom Chaîne Nom du compte. Notez que de nombreux comptes ne portent pas de nom. Par conséquent, ce champ peut être 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'interface utilisateur de 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.
AdId ad_id 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 de paiement des 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.
PageLikes 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.
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'interface utilisateur de 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 est [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.action_type ActionType Chaîne Actions effectuées sur votre annonce, votre page, votre application ou votre événement après sa diffusion, même si l'utilisateur n'a pas cliqué dessus.
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.
actions.action_canvas_component_name ActionCanvasComponentName Chaîne Nom d'un composant d'une annonce Canvas.
actions.action_carousel_card_id ActionCarouselCardId Chaîne ID de la fiche du carrousel spécifique avec laquelle les utilisateurs ont interagi lorsqu'ils ont vu votre annonce.
actions.action_carousel_card_name ActionCarouselCardName Chaîne Fiche spécifique du carrousel avec laquelle les utilisateurs ont interagi lorsqu'ils ont vu votre annonce. Les fiches sont identifiées par leurs titres.
actions.action_destination ActionDestination Chaîne Destination vers laquelle les utilisateurs sont redirigés après avoir cliqué sur votre annonce.
actions.action_device ActionDevice Chaîne Appareil sur lequel l'événement de conversion que vous suivez s'est produit.
actions.action_reaction ActionReaction Chaîne Nombre de réactions sur vos annonces ou posts sponsorisés.
actions.action_target_id ActionTargetId Chaîne ID de la destination vers laquelle les utilisateurs sont redirigés après avoir cliqué sur votre annonce.
actions.action_video_sound ActionVideoSound Chaîne État du son (activé/désactivé) lorsque l'utilisateur regarde votre annonce vidéo.