Carga datos de anuncios de Facebook en BigQuery

Para programar transferencias de datos recurrentes de Facebook Ads a BigQuery, crea una configuración de transferencia para especificar qué objetos de datos transferir y con qué frecuencia programar la transferencia de datos. Puedes crear una configuración de transferencia con la consola de Cloud de Confiance , la herramienta de línea de comandos debq o la API del Servicio de transferencia de datos de BigQuery. Una vez que hayas configurado la transferencia, el Servicio de transferencia de datos de BigQuery transferirá los datos más recientes a una tabla de BigQuery según la programación especificada.

Para obtener información sobre cómo funciona una transferencia de Facebook Ads, consulta Introducción a las transferencias de Facebook Ads.

Limitaciones

Las transferencias de datos de Facebook Ads están sujetas a las siguientes limitaciones:

• El tiempo de intervalo mínimo entre las transferencias de datos recurrentes de Facebook Ads es 24 horas. El intervalo predeterminado para una transferencia de datos recurrente es de 24 horas.
• El Servicio de transferencia de datos de BigQuery para Facebook Ads solo admite un conjunto fijo de tablas. No se admiten los informes personalizados.
• Las transferencias de datos de Facebook Ads tienen una duración máxima de seis horas. Una transferencia falla si lleva más de esta duración máxima.
• Las transferencias incrementales no son compatibles con las tablas AdInsights, AdInsightsActions, AdInsightsMMM, Ads, Campaigns y AdSets. Cuando creas una transferencia de datos que incluye las tablas AdInsights, AdInsightsActions, AdInsightsMMM, Ads, Campaigns y AdSets, y especificaste una fecha en Opciones de programación, se transfieren todos los datos disponibles para esa fecha.
• El Servicio de transferencia de datos de BigQuery admite una ventana de actualización de hasta 30 días para las tablas AdInsights, AdInsightsActions, AdInsightsMMM, Ads, Campaigns y AdSets. El período de actualización se refiere a la cantidad de días a partir de los cuales una transferencia de datos recuperará los datos de origen. Cuando ejecutas una transferencia de datos por primera vez, la transferencia de datos recupera todos los datos de origen disponibles dentro del período de actualización.

• El token de acceso de usuario de larga duración que se requiere para las transferencias de Facebook Ads vence después de 60 días.

  Si tu token de acceso de usuario de larga duración está vencido, puedes obtener el nuevo; para ello, ve a los detalles de la transferencia de datos y haz clic en Editar. En la página para editar la transferencia, sigue los mismos pasos en Requisitos previos de Facebook Ads para generar un token de acceso de usuario de larga duración nuevo.

• Para usar un adjunto de red con esta transferencia de datos, primero debes crear un adjunto de red definiendo una dirección IP estática.

• Si la conexión de red configurada y la instancia de máquina virtual (VM) se encuentran en regiones diferentes, es posible que haya movimiento de datos entre regiones cuando transfieras datos de Anuncios de Facebook.

Antes de comenzar

En las siguientes secciones, se describen los pasos que debes seguir antes de crear una transferencia de datos de Facebook Ads.

Requisitos previos de Facebook Ads

Asegúrate de tener la siguiente información de Facebook Ads cuando crees una transferencia de datos de Facebook Ads.

Para obtener un clientID y un clientSecret, sigue estos pasos:

1. Crea una app para desarrolladores de Facebook con el tipo de app Business.
2. En el panel de la app de Facebook, haz clic en Configuración de la app > Básico y busca el ID de la app y el secreto de la app que correspondan a la app.

Para obtener un token de acceso de usuario de larga duración, también conocido como token de actualización, sigue estos pasos:

1. En la consola de Cloud de Confiance , continúa con los pasos para crear una transferencia de Facebook Ads.

2. En la sección Detalles de la fuente de datos, copia el URI de redireccionamiento que se muestra después del campo Token de actualización.

3. Haz clic en el panel de la app de Facebook y, luego, en Configurar en la sección Acceso con Facebook para empresas.

   

4. En la página Configuración, ingresa la URL de redireccionamiento en el campo URI de redireccionamiento de OAuth válidos y haz clic en Guardar.

5. Regresa a la Cloud de Confiance consola. En la sección Detalles de la fuente de datos, haz clic en Autorizar. Se te redireccionará a la página de autenticación de Facebook.

   

6. Selecciona la app de desarrollador de Facebook para autorizar la cuenta que se conecta con el Servicio de transferencia de datos de BigQuery.

7. Cuando termines, haz clic en Entendido para volver a la consola de Cloud de Confiance . El token de acceso de usuario larga duración ahora se propaga en la configuración de la transferencia.

Los tokens de acceso de usuario de larga duración vencen después de 60 días. Para obtener información sobre cómo obtener un nuevo token de acceso de usuario de larga duración, consulta Limitaciones.

Alternativas a los tokens de actualización

Como alternativa, puedes proporcionar un token de actualización cuando crees una transferencia de datos si obtuviste uno con uno de los siguientes métodos:

• Genera un token de acceso de usuario de larga duración con la API de Graph. Se requieren los permisos ads_management, ads_read y business_management para un token válido de la transferencia de datos.
• Genera un token de usuario del sistema. Un token de usuario del sistema te permite agregar manualmente recursos, como cuentas de anuncios, para que se incluyan en la transferencia de datos. Si un token de usuario del sistema venció, debes actualizar manualmente la configuración de transferencia con credenciales nuevas. También tienes la opción de crear un token que no venza cuando crees un token de usuario del sistema. Para obtener más información, consulta Tokens de acceso admitidos.

Requisitos previos de BigQuery

• Verifica si completaste todas las acciones necesarias para habilitar el Servicio de transferencia de datos de BigQuery
• Crea un conjunto de datos de BigQuery para almacenar tus datos.
• Si quieres configurar las notificaciones de ejecución de transferencias para Pub/Sub, asegúrate de tener el permiso pubsub.topics.setIamPolicy de Identity and Access Management (IAM). Si solo configuras las notificaciones por correo electrónico, no se necesitan los permisos de Pub/Sub. Para obtener más información, consulta la sección sobre notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.

Roles de BigQuery requeridos

Para obtener los permisos que necesitas para crear una transferencia de datos del Servicio de transferencia de datos de BigQuery, pídele a tu administrador que te otorgue el rol de IAM de administrador de BigQuery (roles/bigquery.admin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para crear una transferencia de datos del Servicio de transferencia de datos de BigQuery. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información, consulta Cómo otorgar acceso a bigquery.admin.

Crea una transferencia de datos de Facebook Ads

Selecciona una de las siguientes opciones:

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=DISPLAY_NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

bq mk
--transfer_config
--target_dataset=mydataset
--data_source=facebook_ads
--display_name='My Transfer'
--params='{"connector.authentication.oauth.clientId": "1650000000",
    "connector.authentication.oauth.clientSecret":"TBA99550",
    "connector.authentication.oauth.refreshToken":"abcdef",
    "connector.authorizedAdAccountsOnly":true,
    "connector.actionCollections":["Actions", "Conversions"],
    "connector.genericBreakdowns":["PublisherPlatform", "PlatformPosition"],
    "connector.actionBreakdowns":["ActionDevice", "ActionType"]}'

Para ejecutar manualmente una transferencia de datos fuera de tu programa habitual, puedes iniciar una ejecución de reabastecimiento.

Para obtener información sobre cómo se asignan tus datos transferidos a los campos de la API de Meta, consulta Transformación de informes de anuncios de Facebook.

Colecciones de acciones

Las colecciones de acciones son objetos que especifican los diferentes tipos de acciones que realizaron las personas en respuesta a tu anuncio. Puedes especificar colecciones de acciones cuando configuras la transferencia.

Las colecciones de acciones representan los campos del tipo list<AdsActionStats> que están presentes en la respuesta del endpoint Ad Account, Insights.

Cuando se completa una transferencia, estas colecciones de acciones se propagan en la tabla AdInsightsActions.

A continuación, se incluye una lista de las colecciones de acciones admitidas en una transferencia de datos de Anuncios de Facebook:

• ActionValues
• Actions
• AdClickActions
• AdImpressionActions
• CatalogSegmentActions
• CatalogSegmentValue
• CatalogSegmentValueMobilePurchaseRoas
• CatalogSegmentValueOmniPurchaseRoas
• CatalogSegmentValueWebsitePurchaseRoas
• ConversionValues
• Conversions
• ConvertedProductQuantity
• ConvertedProductValue
• CostPer15_secVideoView
• CostPer2SecContinuousVideoView
• CostPerActionType
• CostPerAdClick
• CostPerConversion
• CostPerOneThousandAdImpression
• CostPerOutboundClick
• CostPerThruplay
• CostPerUniqueActionType
• CostPerUniqueConversion
• CostPerUniqueOutboundClick
• InteractiveComponentTap
• MobileAppPurchaseRoas
• OutboundClicks
• OutboundClicksCtr
• PurchaseRoas
• UniqueActions
• UniqueConversions
• UniqueOutboundClicks
• UniqueOutboundClicksCtr
• UniqueVideoView15_sec
• Video15_secWatchedActions
• Video30_secWatchedActions
• VideoAvgTimeWatchedActions
• VideoContinuous2SecWatchedActions
• VideoP100_watchedActions
• VideoP25WatchedActions
• VideoP50WatchedActions
• VideoP75WatchedActions
• VideoP95WatchedActions
• VideoPlayActions
• VideoPlayCurveActions
• VideoPlayRetentionGraphActions
• VideoTimeWatchedActions
• WebsiteCtr
• WebsitePurchaseRoas

Combinación de desgloses

Facebook Ads tiene restricciones sobre qué columnas se pueden seleccionar juntas. Si se usan estas combinaciones restringidas, la transferencia de datos fallará.

Para obtener más información sobre qué desgloses se pueden combinar, consulta Cómo combinar desgloses.

Soluciona problemas con la configuración de una transferencia

Si tienes problemas para configurar una transferencia de datos de Facebook Ads, prueba los siguientes pasos para solucionar problemas:

• Comprueba si el token de acceso del usuario venció con el depurador de tokens de acceso de Facebook. Los tokens de acceso de usuario de larga duración vencen después de 60 días. Si tu token de acceso de larga duración venció, navega a los detalles de tu transferencia y, luego, haz clic en Editar para modificar la configuración de tu transferencia. En la página para editar la transferencia, sigue los mismos pasos en Requisitos previos de Facebook Ads para generar uno nuevo.

• Comprueba que el token de acceso de larga duración se genere con los permisos requeridos: ads_management, ads_read y business_management. Para verificar los permisos de tu token de acceso de usuario de larga duración, ingresa el siguiente vínculo en tu navegador:

  https://graph.facebook.com/me/permissions?access_token=TOKEN
  

  Aquí TOKEN es el valor del token de acceso de usuario de larga duración.

  Si no tienes los permisos necesarios, genera un token de acceso de usuario de larga duración nuevo siguiendo los pasos que se indican en los requisitos previos de Facebook Ads.

• Revisa la pestaña Acciones requeridas en el panel de la app de Facebook para cualquier elemento que requiera atención.

Es posible que veas los siguientes mensajes de error relacionados con errores de límite de frecuencia de la API de Meta:

Error: There have been too many calls from this ad-account. Wait a bit and try again.

Resolución: Verifica que no haya flujos de trabajo paralelos que usen las mismas apps o credenciales. Si estos errores persisten, intenta actualizar tus permisos a Acceso avanzado para obtener más cuota de límite de frecuencia. Para obtener más información, consulta Límites de frecuencia de la API de Marketing.

Mensajes comunes de métricas de supervisión

También puedes verificar las métricas de supervisión del Servicio de transferencia de datos de BigQuery para determinar la causa de una falla de transferencia de datos. En la siguiente tabla, se mencionan algunos mensajes ERROR_CODE comunes para las transferencias de datos de Facebook Ads.

¿Qué sigue?

• Obtén más información acerca del Servicio de transferencia de datos de BigQuery.
• Obtén más información sobre cómo trabajar con transferencias, como la visualización de configuraciones y el historial de ejecución.
• Obtén información para cargar datos con operaciones de BigQuery Omni.