Integração com o Google Ad Manager como um terceiro

Os terceiros não são usuários diretos do Ad Manager, já que talvez não tenham uma rede própria do Ad Manager. Em vez disso, eles criam serviços ou integrações com o Ad Manager para os clientes, que são clientes do Ad Manager. Este guia aborda os conceitos básicos das integrações de terceiros, oferecendo práticas recomendadas, dicas e truques.

Neste guia, pressupomos que você tenha um conhecimento prático da API Ad Manager. Se você não conhece a API Ad Manager, consulte nossa documentação de introdução.

Como começar como terceirizado

Para usar a API Ad Manager e acessar a rede de um cliente do Ad Manager, siga as diretrizes abaixo. Não é necessária nenhuma aprovação adicional do Google, mas ao acessar e/ou usar a API Ad Manager, você concorda com os termos e condições dela.

Como testar sua integração do Ad Manager como um terceiro

Como terceirizado, talvez você queira saber como testar sua integração do Ad Manager antes de executar nas redes de produção dos seus clientes. A abordagem recomendada é criar uma rede de teste. Não é necessário ser cliente do Ad Manager para fazer isso. Qualquer pessoa com uma Conta do Google pode criar uma rede de teste.

No entanto, observe as diferenças entre as redes de teste e de produção. As redes de teste não podem veicular anúncios. As redes de teste também não contêm necessariamente todos os recursos que os clientes podem ter disponíveis nas redes de produção. Se você precisar testar recursos do Ad Manager que não estão disponíveis na sua rede de teste, uma opção é comprar acesso a uma rede que não seja de teste por um revendedor do Ad Manager.

Além disso, é preciso deixar claro para os clientes quais recursos eles precisam ter disponíveis na rede de produção para que o aplicativo funcione corretamente. O aplicativo precisa processar casos em que os recursos podem não existir capturando exceções e falhando normalmente ou mantendo uma lista de seus clientes e quais recursos cada um tem ou não tem. É responsabilidade do cliente trabalhar com o contato dele no Google para gerenciar recursos na rede.

Autenticação: como acessar corretamente a rede do Ad Manager de um cliente

Para que seu aplicativo acesse a rede do Ad Manager do cliente, você precisa configurar seu fluxo de trabalho de autenticação de maneira segura.

Isso requer duas etapas:

  1. Crie um endereço de e-mail da Conta do Google que você vai usar para acessar a rede do cliente.
  2. Peça ao cliente para adicionar essa conta como usuário à rede do Ad Manager.

Na etapa 1, você pode criar uma Conta do Google separada para cada cliente ou uma principal que será usada para todos eles. A primeira opção é mais segura caso uma das suas contas seja comprometida. Isso significa que você só precisa fazer a etapa 1 uma vez.

Não importa o que você faça na etapa 1, na etapa 2, peça para cada novo cliente adicionar a Conta do Google apropriada que você criou para ele como usuário à rede do Ad Manager.

1. Como criar uma Conta do Google

Há várias maneiras de criar uma Conta do Google que pode ser adicionada a uma rede do Ad Manager.

  • Opção 1: crie uma conta de serviço do OAuth2, que gera um endereço de e-mail de conta de serviço para você que funciona como uma Conta do Google. Instruções para criar uma conta de serviço.

  • Opção 2: você pode criar uma Conta do Google comum (conta do Gmail) inscrevendo-se como um novo usuário. Se você já tiver uma Conta do Google, conclua a inscrição em uma janela anônima ou em uma nova sessão do navegador. Ou, se sua empresa usa o Google Workspace, crie uma Conta do Google no domínio da empresa e use essa conta. Para os fins deste guia, vamos nos referir a ambas como uma Conta do Google "normal".

2. Peça para o cliente adicionar sua Conta do Google à rede dele.

Depois de conseguir uma Conta do Google para acessar a rede do cliente, peça para ele adicionar a conta como um novo usuário na rede do Ad Manager.

  • Se você estiver fornecendo um endereço de e-mail de conta de serviço do OAuth2, peça para adicionar à rede.

  • Se você estiver fornecendo uma Conta do Google comum, peça para adicionar sua conta como usuário à rede dele.

Não importa qual caminho você escolha, converse com o cliente sobre as funções e permissões que sua conta precisa ter para que o aplicativo acesse os dados necessários na rede do cliente.

Agora você pode começar a fazer chamadas de API para a rede do Ad Manager do seu cliente. Defina o cabeçalho SOAP networkCode como o código de rede do cliente em que você está fazendo a chamada de API. Todas as nossas bibliotecas de cliente permitem definir isso de forma programática. Por exemplo, na biblioteca de cliente Java do Google Ads, é possível definir o código da rede de maneira programática ao criar uma instância de DfpSession.

Fique por dentro das novidades da API

É importante ficar por dentro de quais versões da API foram descontinuadas ou encerradas e quando novas versões são lançadas. Você não quer ser pego de surpresa quando uma versão for desativada e correr o risco de prejudicar seus clientes. Nem sempre podemos entrar em contato com terceiros sobre descontinuações e encerramentos iminentes, como fazemos com nossos clientes. Portanto, é sua responsabilidade se inscrever em um dos nossos três canais principais para atualizações de API e ajustar as configurações de notificação:

Também oferecemos uma programação de descontinuação no site para desenvolvedores, que você precisa monitorar regularmente.