Transformación de informes de Facebook Ads

En este documento, se describe cómo se transforman tus informes de Facebook Ads cuando ejecutas una transferencia de Facebook Ads a BigQuery.

Asignación de tablas para informes de Facebook Ads

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

Informe en AdAccounts

Nombre del campo de la API de Meta Nombre del campo de BigQuery asignado Tipo Descripción
id ID [CLAVE] String Es el ID de la cuenta publicitaria.
Objetivo String Es el objetivo que se usa para obtener cuentas de anuncios. Este valor es "nulo" para obtener todas las cuentas de anuncios.
account_id AccountId String Es el ID de la cuenta publicitaria cuando se ve directamente en Facebook.
account_status AccountStatus Número entero Es el estado de la cuenta. 1 = Activa, 2 = Inhabilitada, 3 = Sin liquidar, 7 = Pendiente de revisión, 9 = En período de gracia, 101 = No disponible temporalmente, 100 = Pendiente de cierre.
age Edad Doble Es la cantidad de tiempo que la cuenta publicitaria ha estado abierta, en días.
amount_spent AmountSpent Número entero Es el importe total actual que invirtió la cuenta. Se puede restablecer.
balance Saldo Número entero Es el importe de la factura pendiente.
business_city BusinessCity String Ciudad de la dirección comercial.
business_country_code BusinessCountryCode String Es el código de país de la dirección de la empresa.
business_name BusinessName String Es el nombre de la empresa de la cuenta.
business_state BusinessState String Es la abreviatura del estado de la dirección de la empresa.
business_street BusinessStreet String Primera línea de la dirección comercial de la cuenta.
business_street2 BusinessStreet2 String Segunda línea de la dirección de la empresa para la cuenta.
business_zip BusinessZip String Código postal de la dirección de la empresa.
capabilities Funciones String Son las capacidades permitidas para esta cuenta publicitaria.
created_time CreatedTime Fecha y hora Fecha y hora en que se creó la cuenta.
currency Moneda String Es la moneda que se usa para la cuenta, según el valor correspondiente en la configuración de la cuenta.
min_campaign_group_spend_cap MinCampaignGroupSpendCap String Es el límite de inversión 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 firmó el contrato de Condiciones del Servicio del píxel externo.
owner OwnerId String Es el ID de Facebook del propietario de la cuenta publicitaria.
spend_cap SpendCap Número entero Es el importe máximo que puede gastar esta cuenta, después del cual se pausarán las campañas. Un valor de 0 significa que no hay límite de inversión.
timezone_id TimezoneId String Es el ID de la zona horaria.
timezone_name TimezoneName String Nombre de la zona horaria.
timezone_offset_hours_utc TimezoneOffsetHoursUTC Doble Diferencia de zona horaria con respecto a UTC.

Informe en AdInsights

Nombre del campo de la API de Meta Nombre del campo de BigQuery asignado Tipo Descripción
Objetivo String Es el ID de la cuenta para la que se obtendrán estadísticas.
date_start DateStart Fecha Es la fecha de inicio para recuperar estadísticas. En la IU de Facebook, este es el campo Fecha de inicio del informe.
date_stop DateEnd Fecha Es la fecha de finalización para recuperar estadísticas. En la IU de Facebook, este es el campo Fecha de finalización del informe.
TimeIncrement String Es la cantidad de días de agregación de datos. Este valor se establece en 1.
Nivel String Es el nivel en el que se representarán los resultados. Este valor se establece en "ad".
account_currency AccountCurrency String Es la moneda que utiliza la cuenta publicitaria.
action_attribution_windows ActionAttributionWindows String Es una lista separada por comas que determina cuál es la ventana de atribución para las acciones. Por ejemplo, 28d_click significa que la API devuelve todas las acciones que se produjeron 28 días después de que alguien hizo clic en el anuncio. Esta opción se establece en [1d_view,28d_click].
account_id AdAccountId String Es el ID de la cuenta de anuncios asociada con la fila del informe.
account_name AdAccountName String Es el nombre de la cuenta de anuncios asociada con la fila del informe.
campaign_id CampaignId String Es el ID de la campaña asociada con la fila del informe.
campaign_name CampaignName String Es el nombre de la campaña asociada con la fila del informe.
adset_id AdSetId String Es el ID del conjunto de anuncios asociado con la fila del informe.
adset_name AdSetName String Es el nombre del conjunto de anuncios asociado a la fila del informe.
ad_id AdId String Es el ID del anuncio asociado con la fila del informe.
ad_name AdName String Es el nombre del anuncio asociado a la fila del informe.
buying_type BuyingType String Es el método con el que se pagan los anuncios segmentados en tus campañas.
clicks Clics Larga Es la cantidad total de clics en tu anuncio. Según lo que promociones, esto puede incluir Me gusta en la página, respuestas a eventos o instalaciones de aplicaciones. En la IU de Facebook, este es el campo Clics (todos).
conversion_rate_ranking ConversionRateRanking String Es el ranking del porcentaje de conversiones.
cost_per_estimated_ad_recallers CostPerEstimatedAdRecallers Decimal Es el costo promedio 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 Es el costo promedio por clic en los vínculos del anuncio.
cost_per_inline_post_engagement CostPerInlinePostEngagement Decimal Es el costo promedio por interacción en la publicación.
cost_per_unique_click CostPerUniqueClick Decimal Es el costo promedio por clic único de estos anuncios, calculado como el importe invertido dividido por la cantidad de clics únicos recibidos.
cost_per_unique_inline_link_click CostPerUniqueInlineLinkClick Decimal Es el promedio que pagaste por cada clic único en el vínculo integrado.
cpc CPC Decimal Es el costo por clic promedio de estos anuncios, calculado como el importe invertido dividido por la cantidad de clics recibidos.
cpm CPM Decimal Es el costo promedio que pagaste para obtener 1,000 impresiones en tu anuncio.
cpp Costo por llamada telefónica Decimal Es el costo promedio que pagaste para que tu anuncio se mostrara a 1,000 personas únicas.
ctr CTR Doble Es la cantidad de clics que recibiste dividida por la cantidad de impresiones. En la IU de Facebook, este es el campo CTR (All) %.
estimated_ad_recall_rate EstimatedAdRecallRate Doble Es la cantidad estimada de personas que recuerdan tu anuncio dividida por la cantidad de personas a las que llegó tu anuncio.
estimated_ad_recallers EstimatedAdRecallers Doble Es la cantidad adicional de personas que estimamos que recordarán haber visto tus anuncios si se les pregunta en un plazo de 2 días.
frequency Frecuencia Doble Es la cantidad promedio de veces que se publicó tu anuncio para cada persona.
impressions Impresiones Larga Es la cantidad de veces que se publicó tu anuncio. En las aplicaciones para dispositivos móviles, se considera que se publicó un anuncio la primera vez que se ve. En todas las demás interfaces de Facebook, un anuncio se publica la primera vez que se coloca en el feed de noticias de una persona o cada vez que se coloca en la columna derecha.
inline_link_clicks InlineLinkClicks Larga Es la cantidad total de clics en los vínculos del anuncio.
inline_link_click_ctr InlineLinkClicksCounter Doble Es la tasa de clics de los clics intercalados para vincular.
inline_post_engagement InlinePostEngagement Larga Es la cantidad total de participaciones en la publicación.
instant_experience_clicks_to_open InstantExperienceClicksToOpen Larga Corresponde al campo instant_experience_clicks_to_open de la API de META.
instant_experience_clicks_to_start InstantExperienceClicksToStart Larga Corresponde al 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 de META.
objective Objetivo String Es el objetivo que seleccionaste para tu campaña. Tu objetivo refleja la meta que deseas alcanzar con tu publicidad.
quality_ranking QualityRanking String Es la clasificación de calidad.
reach Alcance Larga Es la cantidad de personas a las que se mostró tu anuncio.
spend Gasto Decimal Es el importe total que invertiste hasta el momento.
UniqueClicks Larga Es la cantidad total de personas únicas que hicieron clic en tu anuncio. Por ejemplo, si 3 personas hacen clic en el mismo anuncio 5 veces, se registran 3 clics únicos.
UniqueCTR Doble Es la cantidad de personas que hicieron clic en tu anuncio dividida por la cantidad de personas a las que llegaste. Por ejemplo, si recibiste 20 clics únicos y tu anuncio se mostró a 1,000 personas únicas, tu tasa de clics únicos sería del 2%.
inline_link_clicks UniqueInlineLinkClicks Larga Es la cantidad de clics únicos en el vínculo intercalado que recibió tu anuncio. En la IU de Facebook, este es el campo Clics únicos en el vínculo.
UniqueInlineLinkClickCounter Doble Es la tasa de clics de los clics intercalados únicos en el vínculo.
UniqueLinkClicksCounter Doble Es la tasa de clics única para los clics en el vínculo. Es la cantidad de personas que hicieron clic en el vínculo de tu anuncio que las dirige fuera de Facebook dividida por la cantidad de personas a las que llegaste. Por ejemplo, si recibiste 20 clics únicos en el vínculo y tu anuncio se mostró a 1,000 personas únicas, tu tasa de clics únicos sería del 2%.
Entradas Int Es la cantidad de registros atribuidos al anuncio.
EventResponses Int Es la cantidad de respuestas a eventos atribuidas al anuncio.
inline_link_clicks LinkClicks Int Es la cantidad de clics en el vínculo atribuidos al anuncio.
OfferSaves Int Es la cantidad de ofertas recibidas atribuidas al anuncio.
outbound_clicks OutboundClicks Int Es la cantidad de clics salientes atribuidos al anuncio.
PageEngagements Int Es la cantidad de interacciones en la página atribuidas al anuncio.
PageLikes Int Es la cantidad de Me gusta en la página atribuidos al anuncio.
PageMentions Int Es la cantidad de menciones de la página atribuidas al anuncio.
PagePhotoViews Int Es la cantidad de vistas de fotos atribuidas al anuncio.
PostComments Int Es la cantidad de comentarios de la publicación atribuidos al anuncio.
PostEngagements Int Es la cantidad de participaciones en la publicación atribuidas al anuncio.
PostShares Int Es la cantidad de veces que se compartió la publicación y que se atribuyeron al anuncio.
PostReactions Int Es la cantidad de reacciones a la publicación atribuidas al anuncio.
PageTabViews Int Es la cantidad de vistas de la pestaña atribuidas al anuncio.
Región String Es la región desde la que un usuario vio el anuncio. Este es un campo de desglose.
Video3SecondViews Int Es la cantidad de vistas de video atribuidas al anuncio. Se registran vistas si se reprodujeron al menos 3 segundos del video o todo el video (si dura menos de 3 segundos).
Desgloses genéricos
Edad String Es el rango etario para las métricas de esta fila.
Género String Es el género para las métricas de esta fila.
País String Es el país para el que se muestran las métricas en esta fila.
Región String Es la región desde la que alguien vio el anuncio.
FrequencyValue String Es la cantidad de veces que se mostró un anuncio de tu campaña de alcance y frecuencia a cada persona.
HStatsByAdvertiserTZ String Es el período durante el cual se tomaron las estadísticas del anunciante.
HStatsByAudienceTZ String Es el período durante el cual se tomaron las estadísticas del público.
ImpressionDevice String Son los dispositivos que se usaron para ver el anuncio.
PlatformPosition String Es la posición en la plataforma.
PublisherPlatform String Son las plataformas en las que se publicaron los anuncios.
ProductId String Es el ID del producto que se promociona en el anuncio.

Informe en AdInsightsActions

ACTION_COLLECTION hace referencia a los tipos de acciones que las personas realizaron en respuesta a tu anuncio. Para obtener una lista completa de las 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 Es el ID de la cuenta para la que se obtendrán estadísticas.
date_start DateStart Fecha Es la fecha de inicio para recuperar estadísticas. En la IU de Facebook, este es el campo Fecha de inicio del informe.
date_stop DateEnd Fecha Es la fecha de finalización para la que se recuperarán las estadísticas. En la IU de Facebook, este es el campo Fecha de finalización del informe.
TimeIncrement String Es la cantidad de días de agregación de datos. Este valor se establece en 1.
Nivel String Es el nivel en el que se representarán los resultados. El valor se establece en ad.
action_attribution_windows ActionAttributionWindows String Es una lista separada por comas que determina cuál es la ventana de atribución para las acciones. Por ejemplo, 28d_click significa que la API devuelve todas las acciones que se produjeron 28 días después de que alguien hizo clic en el anuncio. La opción predeterminada significa [1d_view,7d_click]. Entre los valores posibles, se incluyen 1d_view, 7d_view, 28d_view, 1d_click, 7d_click, 28d_click y default.
ActionCollection String Esto se debe a tu elección de colecciones de acciones en la transferencia.
account_id AdAccountId String Es el ID de la cuenta de anuncios asociada con la fila del informe.
account_name AdAccountName String Es el nombre de la cuenta de anuncios asociada con la fila del informe.
campaign_id CampaignId String Es el ID de la campaña asociada con la fila del informe.
campaign_name CampaignName String Es el nombre de la campaña asociada con la fila del informe.
adset_id AdSetId String Es el ID del conjunto de anuncios asociado con la fila del informe.
adset_name AdSetName String Es el 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 Es el nombre del anuncio asociado a la fila del informe.
ACTION_COLLECTION.value ActionValue Número entero Es el valor de la métrica del período de atribución predeterminado.
ACTION_COLLECTION.1d_click Action1dClick String Es el 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 Es el 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 Es el 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 Es el 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 Es el valor de la métrica de la ventana de atribución 28 días después de hacer clic en el anuncio.
ACTION_COLLECTION.28d_view Action28dView String Es el 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 Es el valor de la métrica de la ventana de atribución que se basa en el modelo basado en datos.
Desgloses genéricos
Edad String Es el rango etario para las métricas de esta fila.
Género String Es el género para las métricas de esta fila.
País String Es el país para el que se muestran las métricas en esta fila.
Región String Es la región desde la que alguien vio el anuncio.
FrequencyValue String Es la cantidad de veces que se mostró un anuncio de tu campaña de alcance y frecuencia a cada persona.
HStatsByAdvertiserTZ String Es el período durante el cual se tomaron las estadísticas del anunciante.
HStatsByAudienceTZ String Es el período durante el cual se tomaron las estadísticas del público.
ImpressionDevice String Son los dispositivos que se usaron para ver el anuncio.
PlatformPosition String Es la posición en la plataforma.
PublisherPlatform String Son las plataformas en las que se publicaron los anuncios.
ProductId String Es el ID del producto que se promociona en el anuncio.
Desgloses de acciones
ActionType String Son las acciones que se realizan en tu anuncio después de que se publicó para alguien, incluso si no hizo clic en él.
ActionCanvasComponentName String Es el nombre de un componente dentro de un anuncio de Canvas.
ActionCarouselCardId String Es el ID de la tarjeta de carrusel específica con la que interactuaron los usuarios cuando vieron tu anuncio.
ActionCarouselCardName String Es la tarjeta específica del carrusel con la que interactuaron las personas cuando vieron tu anuncio. Las tarjetas se identifican por sus títulos.
ActionDestination String Es el destino al que se dirigen las personas después de hacer clic en tu anuncio.
ActionDevice String Es el dispositivo en el que se generó el evento de conversión del que realizas un seguimiento.
ActionReaction String Es la cantidad de reacciones en tus anuncios o publicaciones promocionadas.
ActionTargetId String Es el ID del destino al que se dirigen las personas después de hacer clic en tu anuncio.
ActionVideoSound String Es el estado del sonido (activado o desactivado) cuando el usuario mira tu anuncio de video.
ActionVideoType String Desglose de las métricas de video
ActionConvertedProductId String Son los IDs de los productos convertidos para los anuncios colaborativos.