[beta]{class="badge informative"}
Conectar o Google Ads ao Experience Platform usando a API Flow Service
Uma conexão base representa a conexão autenticada entre a origem e o Adobe Experience Platform. Use este tutorial para conectar sua conta do Google Ads ao Experience Platform usando a Flow Service API.
Uma conexão básica do Google Ads armazena os detalhes de autenticação necessários para acessar a API do Google Ads e cria a ID de conexão que você usará em etapas posteriores para explorar a configuração de origem e criar um fluxo de dados.
Introdução
Este guia requer uma compreensão funcional dos seguintes componentes do Experience Platform:
- Fontes: o Experience Platform permite a assimilação de dados de várias fontes, ao mesmo tempo em que fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços do Experience Platform.
- Sandboxes: a Experience Platform fornece sandboxes virtuais que particionam uma única instância do Experience Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
As seções a seguir fornecem informações adicionais que você precisará saber para se conectar com êxito ao Google Ads usando a API Flow Service.
Uso de APIs do Experience Platform
Para obter informações sobre como fazer chamadas para APIs do Experience Platform com êxito, consulte o manual sobre introdução às APIs do Experience Platform.
Coletar valores para cabeçalhos obrigatórios
Para fazer chamadas para APIs do Experience Platform, primeiro conclua o tutorial de autenticação. Concluir o tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários em todas as chamadas de API do Experience Platform, conforme mostrado abaixo:
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 os recursos no Experience Platform são isolados em sandboxes virtuais específicas. Todas as solicitações para APIs do Experience Platform exigem um cabeçalho que especifique o nome da sandbox em que a operação ocorrerá.
Coletar credenciais necessárias
Para obter informações sobre autenticação, leia a Google Ads visão geral da origem.
Criar uma conexão básica
Uma conexão base retém informações entre sua origem e a Experience Platform, incluindo as credenciais de autenticação da origem, o estado atual da conexão e a ID de conexão base exclusiva.
Para criar uma ID de conexão base, faça uma solicitação POST para o ponto de extremidade /connections enquanto fornece suas credenciais de autenticação do Google Ads como parte dos parâmetros de solicitação.
Formato da API
POST /connections
Solicitação
A solicitação a seguir cria uma conexão básica para o 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"
}
}'
Se a sua conta de anunciante de destino estiver diretamente acessível e não exigir roteamento de conta de gerente, você poderá omitir loginCustomerID do objeto auth.params.
namedescriptionauth.specNameauth.params.clientCustomerIDauth.params.loginCustomerIDauth.params.developerTokenauth.params.refreshTokenauth.params.clientIDauth.params.clientSecretauth.params.googleAdsApiVersionv19 e mais recente. Verifique se você está usando uma dessas versões compatíveis para garantir a compatibilidade.connectionSpec.idd771e9c1-4f26-40dc-8617-ce58c4b53702.Resposta
Uma resposta bem-sucedida retorna detalhes da conexão base recém-criada, incluindo seu identificador exclusivo (id). Essa ID é necessária na próxima etapa para criar uma conexão de origem.
{
"id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
"etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}
Verifique os detalhes da sua conexão
Depois de criar a conexão básica, valide o seguinte antes de continuar:
- A conexão básica foi criada na sandbox pretendida,
- O
clientCustomerIdaponta para a conta de anunciante pretendida, - O
loginCustomerIdestá correto se a conta do anunciante for acessada por meio de um MCC, - A versão da API do Google Ads é compatível com o Experience Platform.
Se a autenticação tiver êxito, mas o acesso de dados downstream falhar, a causa mais comum é uma loginCustomerId incorreta ou desnecessária.
Próximas etapas
Seguindo este tutorial, você criou uma conexão básica do Google Ads usando a API de serviço de fluxo.
Agora você pode continuar com os seguintes tutoriais:
- Explore a configuração de origem para identificar o objeto de origem e os campos que você deseja assimilar.
- Crie um fluxo de dados para uma fonte de anúncio para trazer dados do Google Ads para a Experience Platform.
Solução de problemas
Erros de autorização para contas de anunciante filho
Se as solicitações falharem ao tentar acessar uma conta de anunciante filho, verifique se loginCustomerId está definido como a conta de gerente correta. Isso é necessário quando o acesso é mediado por uma hierarquia MCC.
Token de atualização inválido ou revogado
Se o conector não puder atualizar os tokens de acesso, autorize novamente a conta do Google Ads para gerar um novo token de atualização.
Versão de API não compatível
Se houver falha nas solicitações devido à incompatibilidade de versões, verifique se googleAdsApiVersion está definido como uma versão com suporte no Experience Platform.