La plantilla de Google Ads a BigQuery es una canalización por lotes que lee informes de Google Ads y escribe en BigQuery.
Requisitos de la canalización
- Los IDs de las cuentas de Google Ads que se usará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ámetros obligatorios
- customerIds: Una lista de los IDs de las cuentas de Google Ads que se usarán para ejecutar la consulta. (Ejemplo: 12345,67890).
- query: La consulta que se usará para obtener los datos. Consulta Lenguaje de consulta de Google Ads. Por ejemplo:
SELECT campaign.id, campaign.name FROM campaign
. (Por ejemplo: SELECT campaign.id, campaign.name FROM campaign). - qpsPerWorker: La tasa de solicitudes de consultas por segundo (QPS) que se envían a Google Ads. Divide las QPS por canalización deseadas por la cantidad máxima de trabajadores. Evita exceder los límites de tokens por cuenta o de desarrollador. Consulta los límites de frecuencia (https://developers.google.com/google-ads/api/docs/best-practices/rate-limits).
- 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 (https://developers.google.com/google-ads/api/docs/oauth/cloud-project#create_a_client_id_and_client_secret).
- 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 (https://developers.google.com/google-ads/api/docs/oauth/cloud-project#create_a_client_id_and_client_secret).
- googleAdsRefreshToken: El token de actualización de OAuth 2.0 que se usará para conectarse a la API de Google Ads Consulta la verificación en dos pasos (https://developers.google.com/google-ads/api/docs/oauth/2sv).
- googleAdsDeveloperToken: El token de desarrollador de Google Ads que se usará para conectarse a la API de Google A.ds Consulta Cómo obtener un token de desarrollador (https://developers.google.com/google-ads/api/docs/get-started/dev-token).
- outputTableSpec: La ubicación de la tabla de BigQuery en la que se escribirá el resultado. Por ejemplo,
<PROJECT_ID>:<DATASET_NAME>.<TABLE_NAME>
. Según elcreateDisposition
especificado, es posible que la tabla de resultados se cree automáticamente con el esquema de Avro proporcionado por el usuario.
Parámetros opcionales
- loginCustomerId: Un ID de cuenta de administrador de Google Ads que se usará para acceder a los IDs de cuentas. (Ejemplo: 12345).
- bigQueryTableSchemaPath: La ruta de acceso de Cloud Storage al archivo JSON del esquema de BigQuery. Si no se configura este valor, entonces el esquema se infiere a partir del esquema Proto. (Ejemplo: gs://MyBucket/bq_schema.json).
- writeDisposition: El valor de WriteDisposition de BigQuery (https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobconfigurationload). Por ejemplo,
WRITE_APPEND
,WRITE_EMPTY
oWRITE_TRUNCATE
. La configuración predeterminada esWRITE_APPEND
. - createDisposition: el objeto CreateDisposition de BigQuery (https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobconfigurationload). Por ejemplo,
CREATE_IF_NEEDED
yCREATE_NEVER
. El valor predeterminado esCREATE_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 POST HTTP. 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.