No Criador de BI, os dados do Facebook Ads são coletados no nível dos criativos. Como um mesmo criativo pode ser usado em múltiplos anúncios, a análise é realizada com base na combinação entre o criativo e seus parâmetros associados, permitindo um rastreamento preciso dos gastos com publicidade.

Mecanismo de coleta de dados. As informações sobre despesas e links são obtidas dos elementos de anúncio através da API do Facebook. O principal objeto para extração de links e tags UTM é o AdCreative. O Criador de BI verifica sequencialmente os campos que podem conter links, utilizando o primeiro parâmetro válido encontrado.

Ordem de prioridade para extração:

1. url_tags - conjunto de parâmetros aplicados a todos os links do criativo (sobrescreve parâmetros existentes),
2. template_url, object_url - links diretos ou templates definidos no AdCreative,
3. template_url_spec - não processado (contém links variáveis por plataforma que podem causar inconsistências),
4. object_story_spec - utilizado em anúncios estáticos (processa link_data.link, template_data.link, video_data.link). O Criador de BI itera por todos os campos válidos dentro de um objeto. Os campos text_data e photo_data não são processados, eles não contêm links,
5. call_to_action → value → link - links em botões de ação como "Saiba mais",
6. asset_feed_spec → link_urls - array de links em anúncios dinâmicos. Por exemplo, website_url ou carousel_see_more_url dos cartões da galeria. O Criador de BI itera pela matriz e extrai as referências se elas contiverem rótulos.
7. asset_feed_spec → call_to_actions → url_tags - rótulos de botões de cartão em anúncios dinâmicos. O Criador de BI itera sobre o array call_to_actions e processa url_tags se elas estiverem definidas.
8. value.link - último nível de verificação. Usado se nada com prioridade mais alta for encontrado.

Comportamento do sistema. Quando um objeto contém múltiplos links (como object_url e template_url), o Criador de BI seleciona o campo com maior prioridade. Anúncios que combinam object_story_spec e asset_feed_spec têm ambos os objetos processados. A extração ocorre apenas em campos de texto - arrays, objetos sem URL e conteúdo multimídia sem links são ignorados.

Valores dinâmicos. Nos parâmetros UTM, é possível utilizar templates como {{nome_do_campo}}. O Criador de BI substitui automaticamente as variáveis suportadas:

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

Se um link encontrar um modelo com uma dessas variáveis, o Criador de BI o substituirá pelo valor real. Os modelos restantes permanecem inalterados. Por exemplo, se url_tags contiver utm_medium=cpc e template_url_spec contiver utm_medium=social. O link final conterá utm_medium=cpc, o valor de url_tags tem precedência e substitui o parâmetro no link.

No Criador de BI, os dados do Google Ads são coletados no nível de anúncios individuais, garantindo precisão no rastreamento de investimentos em publicidade.

Mecanismo de coleta. Os dados são obtidos via API através de consultas ao elemento ad_group_ad.
Criador de consultas da API Google Ads (ad_group_ad)

O sistema extrai os seguintes campos:

• segments.date - data de exibição,
• campaign.id, campaign.name - identificação e nome da campanha,
• ad_group.id, ad_group.name - grupo de anúncios,
• ad_group_ad.ad.id, ad_group_ad.ad.type - tipo e ID do anúncio,
• customer.currency_code - moeda da conta,
• metrics.impressions, metrics.clicks, metrics.cost_micros - estatísticas sobre impressões, cliques e custos,
• ad_group_ad.ad.text_ad.headline - títulos de anúncios.

Extração de tags UTM. Os links com parâmetros são obtidos do campo ad_group_ad.ad.final_urls. Este campo contém os endereços de destino do anúncio, incluindo aqueles com parâmetros ValueTrack. O Criador de BI analisa links e substitui valores por parâmetros dinâmicos suportados. Suportado e substituído:

• {campaignid} - substituído por campaign.id
• {creative} - substituído por ad_group_ad.ad.id
• {adgroupid} - substituído por ad_group.id

Demais parâmetros permanecem inalterados.
Documentação oficial dos parâmetros ValueTrack

O Criador de BI processa todos os tipos de anúncio que possuem final_urls, incluindo TEXT_AD e RESPONSIVE_SEARCH_AD. Se o anúncio não contiver final_urls ou o link estiver ausente, as tags não serão extraídas.

As tags UTM são extraídas apenas do link principal em final_urls - este é o primeiro URL na matriz. Variáveis ​​suportadas são substituídas automaticamente. Os parâmetros restantes, incluindo tags ValueTrack não incluídas na lista, permanecem inalterados no link.

A seguir, é apresentada uma consulta SQL para extrair dados de dois conjuntos: lista de fontes publicitárias (tracking_source) e estatísticas de custos publicitários (tracking_source_expenses). Esta consulta combina dados dos conjuntos mencionados utilizando os IDs das fontes e seleciona informações apenas para as campanhas publicitárias com os IDs 19644720474 e 13541843024. Você pode copiá-la e ver como funciona. Apenas substitua os IDs das campanhas antes de executar a consulta.

 SELECT tracking_source.ID AS "ID da fonte", tracking_source.NAME AS "Nome da fonte", tracking_source_expenses.CAMPAIGN_ID AS "ID da campanha", tracking_source_expenses.CAMPAIGN_NAME AS "Nome da campanha", tracking_source_expenses.DATE AS "Data", tracking_source_expenses.EXPENSES AS "Gastos", tracking_source_expenses.CLICKS AS "Número de cliques", tracking_source_expenses.CPC AS "Custo por clique" 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 — determina qual informação extrair do conjunto de dados. Por exemplo, a consulta tracking_source.ID AS "ID da fonte":

• seleciona o identificador da fonte do conjunto de dados tracking_source,
• atribui o nome ID da fonte a ele,
• mostra o resultado em uma coluna separada na tabela.

FROM — indica o conjunto principal do qual os dados são extraídos. Por exemplo, tracking_source.

INNER JOIN — conecta conjuntos de dados e combina suas informações. A consulta tracking_source_expenses ON tracking_source.ID = tracking_source_expenses.SOURCE_ID une os dados das fontes de anúncios com seus gastos.

WHERE — filtra os resultados para incluir dados apenas de campanhas publicitárias específicas.