Dans BI Builder, les données de Facebook Ads sont collectées au niveau des créations. Une même création peut être utilisée dans plusieurs annonces, ce qui permet une analyse précise des dépenses en associant la création et ses paramètres imbriqués.

Fonctionnement de la collecte des données. Les données sur les dépenses et les liens sont obtenues via l'API Facebook Ads. L'objet principal pour extraire les liens et les balises UTM est AdCreative. BI Builder vérifie successivement les champs susceptibles de contenir un lien. Si une balise est trouvée, elle est utilisée ; sinon, le champ suivant est analysé.

Ordre d'extraction :

1. url_tags - paramètres appliqués à tous les liens de la création. Si un lien contient déjà ces paramètres, les valeurs de url_tags les remplacent.
2. template_url, object_url - liens directs ou modèles définis dans AdCreative.
3. template_url_spec - non traité (contient des liens spécifiques à iOS/Android/Web, pouvant varier entre plateformes).
4. object_story_spec - utilisé dans les annonces statiques (inclut link_data.link, template_data.link, video_data.link). Les champs text_data et photo_data sont ignorés (absence de liens).
5. call_to_action → value → link - liens des boutons d'action (ex. « En savoir plus »).
6. asset_feed_spec → link_urls - liens dans les annonces dynamiques (ex. website_url ou carousel_see_more_url).
7. asset_feed_spec → call_to_actions → url_tags - balises des boutons dans les annonces dynamiques.
8. value.link (objets imbriqués) - utilisé si aucun champ prioritaire ne contient de lien.

Comportement et particularités. Si plusieurs liens sont présents (ex. object_url et template_url), BI Builder sélectionne celui ayant la priorité la plus élevée. Les liens sont extraits uniquement des champs textuels ; les tableaux et médias sans URL sont ignorés.

Valeurs dynamiques. Les paramètres UTM peuvent inclure des modèles comme {{nom_du_champ}}. BI Builder remplace les variables prises en charge :

• {{ad.id}}, {{ad.name}}
• {{adset.id}}, {{adset.name}}
• {{campaign.id}}, {{campaign.name}}

Si un modèle contient l'une de ces variables, il est remplacé par sa valeur réelle. Les autres modèles restent inchangés. Exemple : si url_tags contient utm_medium=cpc et template_url_spec contient utm_medium=social, le lien final utilisera utm_medium=cpc (priorité à url_tags).

Dans BI Builder, les données de Google Ads sont collectées au niveau des annonces individuelles, permettant un suivi précis des dépenses.

Fonctionnement de la collecte des données. Les données sont obtenues via l'API Google Ads en interrogeant l'objet ad_group_ad.
Générateur de requêtes API Google Ads (ad_group_ad)

BI Builder extrait les champs suivants :

• segments.date - date d'affichage.
• campaign.id, campaign.name - identifiants et noms des campagnes.
• ad_group.id, ad_group.name - groupe d'annonces.
• ad_group_ad.ad.id, ad_group_ad.ad.type - identifiant et type d'annonce.
• customer.currency_code - devise du compte.
• metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.average_cpc, metrics.average_cpm - statistiques sur les impressions, clics et dépenses.
• ad_group_ad.ad.text_ad.headline et responsive_search_ad.headlines - titres des annonces.

Extraction des balises UTM. Les liens sont extraits du champ ad_group_ad.ad.final_urls, qui contient les URL cibles avec les paramètres ValueTrack. BI Builder remplace les variables dynamiques prises en charge :

• {campaignid} → valeur de campaign.id.
• {creative} → valeur de ad_group_ad.ad.id.
• {adgroupid} → valeur de ad_group.id.

Les autres paramètres restent inchangés.
Documentation sur les paramètres ValueTrack

BI Builder prend en charge tous les types d'annonces contenant final_urls, comme TEXT_AD et RESPONSIVE_SEARCH_AD. Si une annonce ne contient pas de final_urls, les balises ne sont pas extraites.

Les balises UTM sont extraites uniquement de la première URL dans final_urls. Les variables prises en charge sont remplacées automatiquement ; les autres paramètres (y compris les balises ValueTrack non prises en charge) restent inchangés.

Nous avons écrit une requête SQL pour extraire des données de deux ensembles : les sources publicitaires (tracking_source) et les statistiques des dépenses publicitaires (tracking_source_expenses). La requête joint les données des ensembles par l'identifiant de la source et sélectionne les informations uniquement pour les campagnes publicitaires avec les identifiants 19644720474 et 13541843024. Vous pouvez copier la requête et voir comment fonctionne la sélection. Remplacez les identifiants des campagnes avant d'exécuter la requête.

 SELECT tracking_source.ID AS "Identifiant de la source", tracking_source.NAME AS "Nom de la source", tracking_source_expenses.CAMPAIGN_ID AS "ID de campagne", tracking_source_expenses.CAMPAIGN_NAME AS "Nom de la campagne", tracking_source_expenses.DATE AS "Date", tracking_source_expenses.EXPENSES AS "Dépenses", tracking_source_expenses.CLICKS AS "Nombre de clics", tracking_source_expenses.CPC AS "Coût par clic" FROM tracking_source INNER JOIN tracking_source_expenses ON tracking_source.ID = tracking_source_expenses.SOURCE_ID WHERE tracking_source_expenses.CAMPAIGN_ID IN ('19644720474', '13541843024'); 

SELECT - détermine quelles données extraire des ensembles. Par exemple, la requête tracking_source.ID AS "Identifiant de la source".

• sélectionne l'identifiant de la source ID de l'ensemble tracking_source,
• lui attribue le nom Identifiant de la source,
• affiche le résultat dans une colonne distincte du tableau.

FROM - indique l'ensemble principal à partir duquel les données sont extraites. Nous extrayons de tracking_source, qui est une table avec la liste des sources publicitaires.

INNER JOIN - lie les ensembles et combine les informations qu'ils contiennent. La requête tracking_source_expenses ON tracking_source.ID = tracking_source_expenses.SOURCE_ID combine les informations sur les sources publicitaires avec leurs dépenses.

WHERE - filtre les résultats pour sélectionner les données uniquement de certaines campagnes publicitaires.