Transformación de informes de Facebook Ads

En este documento se describe cómo se transforman sus informes de anuncios de Facebook cuando ejecuta una transferencia de anuncios de Facebook a BigQuery.

Asignación de tablas para informes de anuncios de Facebook

Cuando tus informes de Facebook Ads se transfieren a BigQuery, se transforman en las siguientes tablas y vistas de BigQuery.

Informe AdAccounts

Nombre del campo de la API de Meta	Nombre del campo de BigQuery asignado	Tipo	Descripción
id	ID [KEY]	String	ID de la cuenta publicitaria.
	Objetivo	String	El objetivo que se ha usado para obtener las cuentas publicitarias. Este valor es `null` para obtener todas las cuentas publicitarias.
account_id	AccountId	String	El ID de la cuenta publicitaria cuando se ve directamente en Facebook.
account_status	AccountStatus	Entero	Estado de la cuenta. 1 = Activa, 2 = Inhabilitada, 3 = Sin liquidar, 7 = Pendiente de revisión, 9 = En periodo de gracia, 101 = No disponible temporalmente, 100 = Pendiente de cierre.
age	Edad	Doble	Tiempo que lleva abierta la cuenta publicitaria, en días.
amount_spent	AmountSpent	Entero	Importe total actual gastado por la cuenta. Se puede restablecer.
balance	Saldo	Entero	Importe pendiente de la factura.
business_city	BusinessCity	String	Ciudad de la dirección de la empresa.
business_country_code	BusinessCountryCode	String	Código de país de la dirección de la empresa.
business_name	BusinessName	String	El nombre de la empresa de la cuenta.
business_state	BusinessState	String	Abreviatura del estado de la dirección de la empresa.
business_street	BusinessStreet	String	Primera línea de la dirección postal de la empresa de la cuenta.
business_street2	BusinessStreet2	String	Segunda línea de la dirección postal de la empresa de la cuenta.
business_zip	BusinessZip	String	Código postal de la dirección de la empresa.
capabilities	Funciones	String	Funciones permitidas para esta cuenta publicitaria.
created_time	CreatedTime	Fecha y hora	La hora en que se creó la cuenta.
currency	Moneda	String	Moneda que se usa en la cuenta, basada en el valor correspondiente de la configuración de la cuenta.
min_campaign_group_spend_cap	MinCampaignGroupSpendCap	String	El límite de gasto mínimo del grupo de campañas.
name	Nombre	String	Nombre de la cuenta. Ten en cuenta que muchas cuentas no tienen nombre, por lo que este campo puede estar vacío.
offsite_pixels_tos_accepted	OffsitePixelsTosAccepted	String	Indica si se ha firmado el contrato de los Términos del Servicio de píxeles externos.
owner	OwnerId	String	ID de Facebook del propietario de la cuenta publicitaria.
spend_cap	SpendCap	Entero	El importe máximo que puede gastar esta cuenta. Una vez alcanzado, las campañas se pausarán. El valor 0 significa que no hay límite de gasto.
timezone_id	TimezoneId	String	ID de la zona horaria.
timezone_name	TimezoneName	String	Nombre de la zona horaria.
timezone_offset_hours_utc	TimezoneOffsetHoursUTC	Doble	Diferencia horaria con respecto a UTC.

Informe AdInsights

Nombre del campo de la API de Meta	Nombre del campo de BigQuery asignado	Tipo	Descripción
	Objetivo	String	El ID de la cuenta de la que se van a obtener estadísticas.
date_start	DateStart	Fecha	Fecha de inicio para obtener estadísticas. En la interfaz de usuario de Facebook, este campo es "Inicio del informe".
date_stop	DateEnd	Fecha	Fecha de finalización para obtener estadísticas. En la interfaz de Facebook, este es el campo "Final del informe".
	TimeIncrement	String	Número de días de agregación de datos. Este valor es 1.
	Nivel	String	El nivel en el que se representan los resultados. Este valor se define como `ad`.
account_currency	AccountCurrency	String	La moneda que usa la cuenta publicitaria.
action_attribution_windows	ActionAttributionWindows	String	Lista separada por comas que determina cuál es la ventana de atribución de las acciones. Por ejemplo, 28d_click significa que la API devuelve todas las acciones que se produjeron 28 días después de que un usuario hiciera clic en el anuncio. Esta opción está definida en [1d_view,28d_click].
account_id	AdAccountId	String	ID de la cuenta publicitaria asociada a la fila del informe.
account_name	AdAccountName	String	Nombre de la cuenta publicitaria asociada a la fila del informe.
campaign_id	CampaignId	String	Es el ID de la campaña asociada a la fila del informe.
campaign_name	CampaignName	String	Nombre de la campaña asociada a la fila del informe.
adset_id	AdSetId	String	Es el ID del conjunto de anuncios asociado a la fila del informe.
adset_name	AdSetName	String	Nombre del conjunto de anuncios asociado a la fila del informe.
ad_id	AdId	String	Es el ID del anuncio asociado a la fila del informe.
ad_name	AdName	String	Nombre del anuncio asociado a la fila del informe.
buying_type	BuyingType	String	El método por el que se pagan los anuncios orientados en sus campañas.
clicks	Clics	Larga	El número total de clics en su anuncio. En función de lo que promociones, puede incluir Me gusta en la página, respuestas a eventos o descargas de aplicaciones. En la interfaz de Facebook, se trata del campo Clics (todos).
conversion_rate_ranking	ConversionRateRanking	String	La clasificación de la tasa de conversión.
cost_per_estimated_ad_recallers	CostPerEstimatedAdRecallers	Decimal	El coste medio por persona adicional que estimamos que recordará haber visto tu anuncio si se le pregunta en un plazo de 2 días.
cost_per_inline_link_click	CostPerInlineLinkClick	Decimal	El coste medio por clic en los enlaces del anuncio.
cost_per_inline_post_engagement	CostPerInlinePostEngagement	Decimal	El coste medio por interacción con la publicación.
cost_per_unique_click	CostPerUniqueClick	Decimal	El coste medio por clic único de estos anuncios, calculado como el importe gastado dividido entre el número de clics únicos recibidos.
cost_per_unique_inline_link_click	CostPerUniqueInlineLinkClick	Decimal	El importe medio que ha pagado por cada clic único en un enlace insertado.
cpc	CPC	Decimal	El coste medio por clic de estos anuncios, calculado como el importe gastado dividido entre el número de clics recibidos.
cpm	CPM	Decimal	El coste medio que has pagado por cada 1000 impresiones de tu anuncio.
cpp	CPP	Decimal	El coste medio que has pagado para que tu anuncio se muestre a 1000 usuarios únicos.
ctr	CTR	Doble	El número de clics que has recibido dividido entre el número de impresiones. En la interfaz de Facebook, se trata del campo "CTR (todo) %".
estimated_ad_recall_rate	EstimatedAdRecallRate	Doble	El número estimado de personas que recuerdan tu anuncio dividido entre el número de personas a las que ha llegado tu anuncio.
estimated_ad_recallers	EstimatedAdRecallers	Doble	El número adicional de usuarios que estimamos que recordarán haber visto tus anuncios si se les pregunta en un plazo de 2 días.
frequency	Frecuencia	Doble	El número medio de veces que se ha servido tu anuncio a cada persona.
impressions	Impresiones	Larga	Número de veces que se ha publicado su anuncio. En las aplicaciones móviles, un anuncio se considera publicado la primera vez que se ve. En el resto de las interfaces de Facebook, un anuncio se publica la primera vez que se coloca en la sección de noticias de un usuario o cada vez que se coloca en la columna de la derecha.
inline_link_clicks	InlineLinkClicks	Larga	Número total de clics en los enlaces del anuncio.
inline_link_click_ctr	InlineLinkClicksCounter	Doble	Porcentaje de clics de los clics insertados en el enlace.
inline_post_engagement	InlinePostEngagement	Larga	El número total de interacciones en la publicación.
instant_experience_clicks_to_open	InstantExperienceClicksToOpen	Larga	Corresponde al campo instant_experience_clicks_to_open de la API META.
instant_experience_clicks_to_start	InstantExperienceClicksToStart	Larga	Se corresponde con el campo instant_experience_clicks_to_start de la API de Meta.
instant_experience_outbound_clicks	InstantExperienceOutboundClicks	Larga	Corresponde al campo instant_experience_outbound_clicks de la API META.
objective	Objetivo	String	El objetivo que has seleccionado para tu campaña. Tu objetivo refleja lo que quieres conseguir con tu publicidad.
quality_ranking	QualityRanking	String	La clasificación de calidad.
reach	Cobertura	Larga	El número de personas a las que se ha mostrado tu anuncio.
spend	Inversión	Decimal	El importe total que has gastado hasta ahora.
	UniqueClicks	Larga	El número total de usuarios únicos que han hecho clic en tu anuncio. Por ejemplo, si 3 personas hacen clic en el mismo anuncio 5 veces, se contabilizarán 3 clics únicos.
	UniqueCTR	Doble	El número de usuarios que han hecho clic en tu anuncio dividido entre el número de usuarios a los que has llegado. Por ejemplo, si has recibido 20 clics únicos y tu anuncio se ha mostrado a 1000 usuarios únicos, tu porcentaje de clics únicos sería del 2%.
inline_link_clicks	UniqueInlineLinkClicks	Larga	Número de clics únicos en enlaces insertados que ha recibido tu anuncio. En la interfaz de Facebook, se trata del campo Clics únicos en enlace.
	UniqueInlineLinkClickCounter	Doble	Porcentaje de clics de los clics únicos insertados en el enlace.
	UniqueLinkClicksCounter	Doble	El porcentaje de clics únicos de los clics en el enlace. El número de usuarios que han hecho clic en el enlace de tu anuncio que dirige a los usuarios fuera de Facebook dividido entre el número de usuarios a los que has llegado. Por ejemplo, si has recibido 20 clics únicos en el enlace y tu anuncio se ha mostrado a 1000 usuarios únicos, tu porcentaje de clics únicos sería del 2%.
	Checkins	Int	El número de registros atribuidos al anuncio.
	EventResponses	Int	Número de respuestas de eventos atribuidas al anuncio.
inline_link_clicks	LinkClicks	Int	Número de clics en el enlace atribuidos al anuncio.
	OfferSaves	Int	Número de ofertas recibidas atribuidas al anuncio.
outbound_clicks	OutboundClicks	Int	Número de clics salientes atribuidos al anuncio.
	PageEngagements	Int	Número de interacciones con la página atribuidas al anuncio.
	PageLikes	Int	Número de Me gusta de la página atribuidos al anuncio.
	PageMentions	Int	Número de menciones de página atribuidas al anuncio.
	PagePhotoViews	Int	El número de visualizaciones de fotos atribuidas al anuncio.
	PostComments	Int	Número de comentarios de la publicación atribuidos al anuncio.
	PostEngagements	Int	Número de interacciones con la publicación atribuidas al anuncio.
	PostShares	Int	Número de veces que se ha compartido la publicación atribuido al anuncio.
	PostReactions	Int	Número de reacciones a la publicación atribuidas al anuncio.
	PageTabViews	Int	Número de vistas de la pestaña atribuidas al anuncio.
	Región	String	La región desde la que ha visto el anuncio. Este es un campo de desglose.
	Video3SecondViews	Int	Número de visualizaciones de vídeo atribuidas al anuncio. Las visualizaciones se contabilizan si se han reproducido al menos 3 segundos del vídeo o todo el vídeo (si dura menos de 3 segundos).
Desgloses genéricos
	Edad	String	El intervalo de edad de las métricas de esta fila.
	Sexo	String	El sexo de las métricas de esta fila.
	País	String	El país de las métricas de esta fila.
	Región	String	La región desde la que se ha visto el anuncio.
	FrequencyValue	String	Número de veces que se ha mostrado un anuncio de tu campaña de cobertura y frecuencia a cada persona.
	HStatsByAdvertiserTZ	String	Periodo durante el que se han recogido las estadísticas del anunciante.
	HStatsByAudienceTZ	String	Periodo durante el que se han recogido las estadísticas de la audiencia.
	ImpressionDevice	String	Los dispositivos usados para ver el anuncio.
	PlatformPosition	String	La posición en la plataforma.
	PublisherPlatform	String	Las plataformas en las que se publicaron los anuncios.
	ProductId	String	El ID del producto anunciado en el anuncio.

Informe AdInsightsActions

ACTION_COLLECTION hace referencia a los tipos de acciones que han realizado los usuarios en respuesta a tu anuncio. Para ver una lista completa de colecciones de acciones, consulta Colecciones de acciones.

Nombre del campo de la API de Meta	Nombre del campo de BigQuery asignado	Tipo	Descripción
	Objetivo	String	El ID de la cuenta de la que se van a obtener estadísticas.
date_start	DateStart	Fecha	Fecha de inicio para recuperar las estadísticas. En la interfaz de usuario de Facebook, este campo es "Inicio del informe".
date_stop	DateEnd	Fecha	Fecha de finalización para obtener estadísticas. En la interfaz de Facebook, este es el campo "Final del informe".
	TimeIncrement	String	Número de días de agregación de datos. Este valor es 1.
	Nivel	String	El nivel en el que se representan los resultados. El valor es ad.
action_attribution_windows	ActionAttributionWindows	String	Lista separada por comas que determina cuál es la ventana de atribución de las acciones. Por ejemplo, 28d_click significa que la API devuelve todas las acciones que se produjeron 28 días después de que un usuario hiciera clic en el anuncio. La opción predeterminada es [1d_view,7d_click]. Entre los posibles valores se incluyen 1d_view, 7d_view, 28d_view, 1d_click, 7d_click, 28d_click y default.
	ActionCollection	String	Esto depende de las colecciones de acciones que elijas en la transferencia.
account_id	AdAccountId	String	ID de la cuenta publicitaria asociada a la fila del informe.
account_name	AdAccountName	String	Nombre de la cuenta publicitaria asociada a la fila del informe.
campaign_id	CampaignId	String	Es el ID de la campaña asociada a la fila del informe.
campaign_name	CampaignName	String	Nombre de la campaña asociada a la fila del informe.
adset_id	AdSetId	String	ID del conjunto de anuncios asociado a la fila del informe.
adset_name	AdSetName	String	Nombre del conjunto de anuncios asociado a la fila del informe.
ad_id	AdId	String	Es el ID del anuncio asociado a la fila del informe.
ad_name	AdName	String	Nombre del anuncio asociado a la fila del informe.
ACTION_COLLECTION.value	ActionValue	Entero	Valor de métrica de la ventana de atribución predeterminada.
ACTION_COLLECTION.1d_click	Action1dClick	String	Valor de la métrica de la ventana de atribución 1 día después de hacer clic en el anuncio.
ACTION_COLLECTION.1d_view	Action1dView	String	Valor de la métrica de la ventana de atribución 1 día después de ver el anuncio.
ACTION_COLLECTION.7d_click	Action7dClick	String	Valor de la métrica de la ventana de atribución 7 días después de hacer clic en el anuncio.
ACTION_COLLECTION.7d_view	Action7dView	String	Valor de la métrica de la ventana de atribución 7 días después de ver el anuncio.
ACTION_COLLECTION.28d_click	Action28dClick	String	Valor de la métrica de la ventana de atribución de 28 días después de hacer clic en el anuncio.
ACTION_COLLECTION.28d_view	Action28dView	String	Valor de la métrica de la ventana de atribución 28 días después de ver el anuncio.
ACTION_COLLECTION.dda	ActionDDA	String	Valor de métrica de la ventana de atribución basada en datos.
Desgloses genéricos
	Edad	String	El intervalo de edad de las métricas de esta fila.
	Sexo	String	El sexo de las métricas de esta fila.
	País	String	El país de las métricas de esta fila.
	Región	String	La región desde la que se ha visto el anuncio.
	FrequencyValue	String	Número de veces que se ha mostrado un anuncio de tu campaña de cobertura y frecuencia a cada persona.
	HStatsByAdvertiserTZ	String	Periodo durante el que se han recogido las estadísticas del anunciante.
	HStatsByAudienceTZ	String	Periodo durante el que se han recogido las estadísticas de la audiencia.
	ImpressionDevice	String	Los dispositivos usados para ver el anuncio.
	PlatformPosition	String	La posición en la plataforma.
	PublisherPlatform	String	Las plataformas en las que se publicaron los anuncios.
	ProductId	String	El ID del producto anunciado en el anuncio.
Desgloses de acciones
	ActionType	String	El tipo de acciones que se realizan en tu anuncio después de que se haya mostrado a un usuario, aunque no haya hecho clic en él.
	ActionCanvasComponentName	String	Nombre de un componente de un anuncio de lienzo.
	ActionCarouselCardId	String	ID de la tarjeta de carrusel específica con la que han interactuado los usuarios cuando han visto tu anuncio.
	ActionCarouselCardName	String	La tarjeta de carrusel específica con la que han interactuado los usuarios cuando han visto tu anuncio. Las tarjetas se identifican por sus títulos.
	ActionDestination	String	El destino al que se dirige a los usuarios después de hacer clic en tu anuncio.
	ActionDevice	String	El dispositivo en el que se ha producido el evento de conversión del que está haciendo un seguimiento.
	ActionReaction	String	El número de reacciones en tus anuncios o publicaciones impulsadas.
	ActionTargetId	String	ID del destino al que se dirige a los usuarios después de hacer clic en tu anuncio.
	ActionVideoSound	String	Estado del sonido (activado o desactivado) cuando el usuario ve tu anuncio de vídeo.
	ActionVideoType	String	Desglose de las métricas de vídeo.
	ActionConvertedProductId	String	IDs de producto convertidos para anuncios colaborativos.