BI Builder recopila los datos de Facebook Ads a nivel de creativos. Un mismo creativo puede usarse en mñultiples anuncios, por lo que el análisis se realiza combinando el creativo con sus parámetros asociados. Esto permite un seguimiento más preciso de los gastos publicitarios.

Cómo funciona la recopilación de datos. Los datos sobre gastos y enlaces se obtienen mediante los elementos publicitarios de API de Facebook. El objeto principal para extraer enlaces y etiquetas UTM es AdCreative. BI Builder verifica secuencialmente los campos que pueden contener enlaces. Si encuentra una etiqueta, la utiliza; de lo contrario, pasa al siguiente campo según el orden de prioridad.

Orden de extracción:

1. url_tags: conjunto de parámetros aplicados a todos los enlaces del creativo. Si el enlace ya contiene estos parámetros, los valores de url_tags los sobrescriben.
2. template_url, object_url: enlaces directos o plantillas definidos en AdCreative.
3. template_url_spec: no se procesa. Contiene enlaces específicos para iOS, Android y Web, con etiquetas que pueden variar entre plataformas. Se excluye para evitar errores.
4. object_story_spec: se usa en anuncios estáticos. Puede incluir: link_data.link, template_data.link, video_data.link. BI Builder revisa todos los campos válidos dentro del objeto. Los campos text_data y photo_data no se procesan al no contener enlaces.
5. call_to_action → value → link: enlaces de botones de acción, como "Más información".
6. asset_feed_spec → link_urls: conjunto de enlaces en anuncios dinámicos, como website_url o carousel_see_more_url en galerías. BI Builder revisa la matriz y extrae las referencias con etiquetas.
7. asset_feed_spec → call_to_actions → url_tags: etiquetas de botones en anuncios dinámicos. BI Builder revisa la matriz call_to_actions y procesa url_tags si están configurados.
8. value.link (objetos anidados): último nivel. Se usa si no se encuentran enlaces en los campos anteriores.

Comportamiento y características. Cuando un objeto contiene varios enlaces (como object_url y template_url), BI Builder selecciona el campo con mayor prioridad. Si un anuncio incluye tanto object_story_spec como asset_feed_spec, se procesan ambos. Solo se extraen enlaces de campos de texto, omitiendo arrays, objetos sin URL y contenido multimedia sin enlaces.

Valores dinámicos. En los parámetros UTM, puedes usar plantillas como {{nombre_del_campo}}. BI Builder admite estas variables:

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

Cuando un enlace contiene una plantilla con estas variables, BI Builder la reemplaza por su valor real. Otras plantillas permanecen sin cambios. Por ejemplo, si url_tags contiene utm_medium=cpc y template_url_spec contiene utm_medium=social, el enlace final usará utm_medium=cpc, ya que el valor de url_tags tiene prioridad y sobrescribe el parámetro en el enlace.

BI Builder recopila los datos de Google Ads a nivel de anuncios individuales, lo que permite un seguimiento preciso de los gastos publicitarios.

Cómo funciona la recopilación de datos. Los datos se obtienen mediante API de Google Ads a través de solicitudes al elemento ad_group_ad.
Generador de consultas de Google Ads (ad_group_ad)

BI Builder extrae los siguientes campos:

• segments.date: fecha de la impresión.
• campaign.id, campaign.name: identificadores y nombres de campañas.
• ad_group.id, ad_group.name: grupo de anuncios.
• ad_group_ad.ad.id, ad_group_ad.ad.type: identificador y tipo del anuncio.
• customer.currency_code: moneda de la cuenta.
• metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.average_cpc, metrics.average_cpm: estadísticas de impresiones, clics y gastos.
• ad_group_ad.ad.text_ad.headline y responsive_search_ad.headlines — títulos de los anuncios.

Cómo se extraen las etiquetas UTM. Los enlaces con parámetros UTM se obtienen del campo ad_group_ad.ad.final_urls. Este campo contiene las URL de destino de los anuncios, incluidas las configuradas con parámetros de ValueTrack. BI Builder analiza estas URL y reemplaza automáticamente los valores de los siguientes parámetros dinámicos:

• {campaignid}: se reemplaza por el valor real de campaign.id.
• {creative}: se reemplaza por ad_group_ad.ad.id.
• {adgroupid}: se reemplaza por ad_group.id.

El resto de parámetros en la URL permanecen sin modificación.
Documentación sobre las variables de ValueTrack

BI Builder es compatible con todos los tipos de anuncios que contienen el campo final_urls, incluidos TEXT_AD y RESPONSIVE_SEARCH_AD. Si un anuncio no tiene final_urls o carece de enlaces, no se extraen etiquetas.

Solo se procesan las etiquetas UTM de la primera URL en el array final_urls. Los parámetros admitidos se reemplazan automáticamente, mientras que los demás, incluidos los no compatibles con ValueTrack, permanecen sin cambios en la URL.

A continuación, se presenta una consulta SQL para extraer datos de dos conjuntos: lista de fuentes publicitarias (tracking_source) y estadísticas de costos publicitarios (tracking_source_expenses). Esta consulta combina datos de los conjuntos mencionados utilizando los IDs de las fuentes y selecciona información solo para las campañas publicitarias con los IDs 19644720474 y 13541843024. Puedes copiarla y ver cómo funciona. Solo reemplaza los IDs de las campañas antes de ejecutar la consulta.

 
SELECT 
    tracking_source.ID AS "ID de la fuente", 
    tracking_source.NAME AS "Nombre de la fuente", 
    tracking_source_expenses.CAMPAIGN_ID AS "ID de la campaña", 
    tracking_source_expenses.CAMPAIGN_NAME AS "Nombre de la campaña", 
    tracking_source_expenses.DATE AS "Fecha", 
    tracking_source_expenses.EXPENSES AS "Gastos", 
    tracking_source_expenses.CLICKS AS "Número de clics",
    tracking_source_expenses.CPC AS "Costo por 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 — determina qué información extraer del conjunto de datos. Por ejemplo, la consulta tracking_source.ID AS "ID de la fuente":

• selecciona el identificador de la fuente del conjunto de datos tracking_source,
• le asigna el nombre ID de la fuente,
• muestra el resultado en una columna separada en la tabla.

FROM — indica el conjunto principal del que se extraen los datos. Por ejemplo, tracking_source.

INNER JOIN — conecta conjuntos de datos y combina su información. La consulta tracking_source_expenses ON tracking_source.ID = tracking_source_expenses.SOURCE_ID une los datos de las fuentes de anuncios con sus gastos.

WHERE — filtra los resultados para incluir datos solo de campañas publicitarias específicas.