[beta]{class="badge informative"}

Conectar Google Ads a Experience Platform mediante la API Flow Service

Una conexión base representa la conexión autenticada entre el origen y Adobe Experience Platform. Use este tutorial para conectar su cuenta de Google Ads a Experience Platform mediante la Flow Service API.

Una conexión base de Google Ads almacena los detalles de autenticación necesarios para acceder a la API de Google Ads y crea el ID de conexión que utilizará en pasos posteriores para explorar la configuración de origen y crear un flujo de datos.

Introducción

Esta guía requiere una comprensión práctica de los siguientes componentes de Experience Platform:

Las secciones siguientes proporcionan información adicional que necesitará conocer para conectarse correctamente a Google Ads mediante la API Flow Service.

Uso de API de Experience Platform

Para obtener información sobre cómo realizar llamadas correctamente a las API de Experience Platform, consulte la guía sobre introducción a las API de Experience Platform.

Recopilación de valores para los encabezados obligatorios

Para realizar llamadas a las API de Experience Platform, primero debe completar el tutorial de autenticación. Al completar el tutorial de autenticación se proporcionan los valores para cada uno de los encabezados necesarios en todas las llamadas a la API de Experience Platform, como se muestra a continuación:

Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
x-sandbox-name: {SANDBOX_NAME}
Content-Type: application/json

Todos los recursos de Experience Platform están aislados para zonas protegidas virtuales específicas. Todas las solicitudes a las API de Experience Platform requieren un encabezado que especifique el nombre de la zona protegida en la que se realizará la operación.

Recopilar credenciales necesarias

Para obtener información sobre la autenticación, lea la Google Ads descripción general del origen.

Crear una conexión base

Una conexión base retiene información entre el origen y Experience Platform, incluidas las credenciales de autenticación del origen, el estado actual de la conexión y el identificador único de la conexión base.

Para crear un identificador de conexión base, realice una petición POST al extremo /connections y proporcione las credenciales de autenticación de Google Ads como parte de los parámetros de la solicitud.

Formato de API

POST /connections

Solicitud

La siguiente solicitud crea una conexión base para Google Ads:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json'
  -d '{
      "name": "Google Ads base connection",
      "description": "Google Ads base connection",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "clientCustomerID": "{CLIENT_CUSTOMER_ID}",
              "loginCustomerID": "{LOGIN_CUSTOMER_ID}",
              "developerToken": "{DEVELOPER_TOKEN}",
              "refreshToken": "{REFRESH_TOKEN}",
              "clientId": "{CLIENT_ID}",
              "clientSecret": "{CLIENT_SECRET}",
              "googleAdsApiVersion": "v19"

          }
      },
      "connectionSpec": {
          "id": "d771e9c1-4f26-40dc-8617-ce58c4b53702",
          "version": "1.0"
      }
  }'

Si su cuenta de anunciante de Target es directamente accesible y no requiere enrutamiento de cuenta de administrador, puede omitir loginCustomerID del objeto auth.params.

Respuesta

Una respuesta correcta devuelve detalles de la conexión base recién creada, incluido su identificador único (id). Este ID es necesario en el siguiente paso para crear una conexión de origen.

{
    "id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
    "etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}

Compruebe los detalles de la conexión

Después de crear la conexión base, valide lo siguiente antes de continuar:

Si la autenticación se realiza correctamente pero el acceso a los datos descendentes falla, la causa más común es un loginCustomerId incorrecto o innecesario.

Próximos pasos

Al seguir este tutorial, ha creado una conexión base de Google Ads mediante la API de Flow Service.

Ahora puede continuar con los siguientes tutoriales:

Resolución de problemas

Errores de autorización para cuentas de anunciante secundarias

Si las solicitudes fallan al intentar obtener acceso a una cuenta de anunciante secundaria, compruebe que loginCustomerId esté establecido en la cuenta de administrador correcta. Esto es necesario cuando el acceso se realiza a través de una jerarquía MCC.

Token de actualización no válido o revocado

Si el conector no puede actualizar los tokens de acceso, vuelva a autorizar la cuenta de Google Ads para generar un nuevo token de actualización.

Versión de API no admitida

Si las solicitudes fallan debido a que la versión no coincide, asegúrese de que googleAdsApiVersion esté establecido en una versión compatible con Experience Platform.