La plantilla de Google Ads a BigQuery es una canalización por lotes que lee informes de Google Ads y los escribe en BigQuery.
Requisitos de la canalización
- Los ID de la cuenta de Google Ads que se utilizarán
- La consulta del lenguaje de consulta de Google Ads para obtener los datos.
- Credenciales de OAuth para la API de Google Ads.
Parámetros de la plantilla
Parámetro | Descripción |
---|---|
customerIds |
Una lista de los ID de cuentas de Google Ads que se usarán para ejecutar la consulta. Por ejemplo: 12345,67890 . |
query |
La consulta que se usará para obtener los datos. Consulte el Lenguaje de consultas de Google Ads. Por ejemplo: SELECT campaign.id, campaign.name FROM campaign . |
qpsPerWorker |
La tasa de solicitudes por segundo (QPS) de consulta para enviar a Google Ads. Divide las QPS deseadas por canalización por la cantidad máxima de trabajadores. Evita exceder los límites de tokens por cuenta o de desarrollador. Consulta Límites de frecuencia. |
googleAdsClientId |
El ID de cliente de OAuth 2.0 que identifica la aplicación. Consulta Crea un ID de cliente y un secreto del cliente. |
googleAdsClientSecret |
El secreto del cliente de OAuth 2.0 que corresponde al ID de cliente especificado. Consulta Crea un ID de cliente y un secreto del cliente. |
googleAdsRefreshToken |
El token de actualización de OAuth 2.0 para usar con la API de Google Ads. Consulta Verificación en dos pasos. |
googleAdsDeveloperToken |
El token de desarrollador de Google Ads que se usará para conectarse a la API de Google Ads. Consulta Obtén un token de desarrollador. |
outputTableSpec |
La ubicación de la tabla de BigQuery en la que se escribirá el resultado. El nombre debe tener el formato <project>:<dataset>.<table_name> . El esquema de la tabla debe coincidir con los objetos de entrada. |
loginCustomerId |
Opcional: Un ID de cuenta de administrador de Google Ads que se usará para acceder a los ID de la cuenta. Por ejemplo: 12345 . |
bigQueryTableSchemaPath |
Opcional: La ruta de acceso de Cloud Storage al archivo JSON de esquema de BigQuery. Si no se configura este valor, el esquema se infiere a partir del esquema Proto. Por ejemplo: gs://MyBucket/bq_schema.json . |
writeDisposition |
Opcional: El valor WriteDisposition de BigQuery. Por ejemplo, WRITE_APPEND , WRITE_EMPTY o WRITE_TRUNCATE . La configuración predeterminada es:
WRITE_APPEND . |
createDisposition |
Opcional: El valor CreateDisposition de BigQuery. Por ejemplo: CREATE_IF_NEEDED , CREATE_NEVER . La configuración predeterminada es:
CREATE_IF_NEEDED . |
Ejecuta la plantilla
Consola
- Ve a la página Crear un trabajo a partir de una plantilla de Dataflow. Ir a Crear un trabajo a partir de una plantilla
- En el campo Nombre del trabajo, ingresa un nombre de trabajo único.
- Opcional: Para Extremo regional, selecciona un valor del menú desplegable. La región predeterminada es
us-central1
.Para obtener una lista de regiones en las que puedes ejecutar un trabajo de Dataflow, consulta Ubicaciones de Dataflow.
- En el menú desplegable Plantilla de Dataflow, selecciona the Google Ads to BigQuery template.
- En los campos de parámetros proporcionados, ingresa los valores de tus parámetros.
- Haga clic en Ejecutar trabajo.
gcloud
En tu shell o terminal, ejecuta la plantilla:
gcloud dataflow flex-template run JOB_NAME \ --template-file-gcs-location=gs://dataflow-templates-REGION_NAME/VERSION/flex/Google_Ads_to_BigQuery \ --project=PROJECT_ID \ --region=REGION_NAME \ --parameters \ customerIds=CUSTOMER_IDS,\ query=QUERY,\ qpsPerWorker=QPS_PER_WORKER,\ googleAdsClientId=GOOGLE_ADS_CLIENT_ID,\ googleAdsClientSecret=GOOGLE_ADS_CLIENT_SECRET,\ googleAdsRefreshToken=GOOGLE_ADS_REFRESH_TOKEN,\ googleAdsDeveloperToken=GOOGLE_ADS_DEVELOPER_TOKEN,\ outputTableSpec=OUTPUT_TABLE_SPEC,\
Reemplaza lo siguiente:
JOB_NAME
: Es el nombre del trabajo que elijasVERSION
: Es la versión de la plantilla que deseas usar.Puedes usar los siguientes valores:
latest
para usar la última versión de la plantilla, que está disponible en la carpeta superior non-dated en el bucket gs://dataflow-templates-REGION_NAME/latest/- el nombre de la versión, como
2023-09-12-00_RC00
, para usar una versión específica de la plantilla, que se puede encontrar anidada en la carpeta superior con fecha correspondiente en el bucket gs://dataflow-templates-REGION_NAME/
REGION_NAME
: La región en la que deseas implementar tu trabajo de Dataflow, por ejemplo,us-central1
CUSTOMER_IDS
: Los ID de las cuentas de Google AdsQUERY
: La consulta del lenguaje de consulta de Google AdsQPS_PER_WORKER
: El porcentaje de solicitudes de Google Ads requerido por trabajadorGOOGLE_ADS_CLIENT_ID
: el ID de cliente de OAuth 2.0 que identifica la aplicaciónGOOGLE_ADS_CLIENT_SECRET
: El secreto del cliente de OAuth 2.0 que corresponde al ID de cliente especificadoGOOGLE_ADS_REFRESH_TOKEN
: El token de actualización de OAuth 2.0 que se usará para conectarse a la API de Google AdsGOOGLE_ADS_DEVELOPER_TOKEN
: El token de desarrollador de Google Ads que se usará para conectarse a la API de Google AdsOUTPUT_TABLE_SPEC
: Es la tabla de salida de BigQuery.
API
Para ejecutar la plantilla con la API de REST, envía una solicitud HTTP POST. Para obtener más información de la API y sus permisos de autorización, consulta projects.templates.launch
.
POST https://dataflow.googleapis.com/v1b3/projects/PROJECT_ID/locations/LOCATION/flexTemplates:launch { "launchParameter": { "jobName": "JOB_NAME", "parameters": { "customerIds": "CUSTOMER_IDS", "query": "QUERY", "qpsPerWorker": "QPS_PER_WORKER", "googleAdsClientId": "GOOGLE_ADS_CLIENT_ID", "googleAdsClientSecret": "GOOGLE_ADS_CLIENT_SECRET", "googleAdsRefreshToken": "GOOGLE_ADS_REFRESH_TOKEN", "googleAdsDeveloperToken": "GOOGLE_ADS_DEVELOPER_TOKEN", "outputTableSpec": "OUTPUT_TABLE_SPEC", }, "containerSpecGcsPath": "gs://dataflow-templates-LOCATION/VERSION/flex/Google_Ads_to_BigQuery", "environment": { "maxWorkers": "10" } } }
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto de Google Cloud en el que deseas ejecutar el trabajo de Dataflow.JOB_NAME
: Es el nombre del trabajo que elijasVERSION
: Es la versión de la plantilla que deseas usar.Puedes usar los siguientes valores:
latest
para usar la última versión de la plantilla, que está disponible en la carpeta superior non-dated en el bucket gs://dataflow-templates-REGION_NAME/latest/- el nombre de la versión, como
2023-09-12-00_RC00
, para usar una versión específica de la plantilla, que se puede encontrar anidada en la carpeta superior con fecha correspondiente en el bucket gs://dataflow-templates-REGION_NAME/
LOCATION
: La región en la que deseas implementar tu trabajo de Dataflow, por ejemplo,us-central1
CUSTOMER_IDS
: Los ID de las cuentas de Google AdsQUERY
: La consulta del lenguaje de consulta de Google AdsQPS_PER_WORKER
: El porcentaje de solicitudes de Google Ads requerido por trabajadorGOOGLE_ADS_CLIENT_ID
: el ID de cliente de OAuth 2.0 que identifica la aplicaciónGOOGLE_ADS_CLIENT_SECRET
: El secreto del cliente de OAuth 2.0 que corresponde al ID de cliente especificadoGOOGLE_ADS_REFRESH_TOKEN
: El token de actualización de OAuth 2.0 que se usará para conectarse a la API de Google AdsGOOGLE_ADS_DEVELOPER_TOKEN
: El token de desarrollador de Google Ads que se usará para conectarse a la API de Google AdsOUTPUT_TABLE_SPEC
: Es la tabla de salida de BigQuery.
¿Qué sigue?
- Obtén información sobre las plantillas de Dataflow.
- Consulta la lista de plantillas que proporciona Google.