Os terceiros não são usuários diretos do Ad Manager, ou seja, 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 deles, que são clientes do Ad Manager. Este guia aborda os conceitos básicos das integrações de terceiros, com práticas recomendadas, dicas e sugestões.
Este guia pressupõe que você tenha 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 terceiro
Para usar a API Ad Manager e acessar a rede de um cliente do Ad Manager, basta seguir as diretrizes abaixo. Não é necessária nenhuma outra aprovação 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 com o Ad Manager como terceiro
Como terceiro, talvez você queira saber como testar sua integração com o 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 seus 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 o acesso a uma rede que não seja de teste por meio de 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. Seu aplicativo precisa lidar com casos em que os recursos podem não existir, capturando exceções e falhando normalmente ou mantendo uma lista de clientes e quais recursos cada um tem ou não. É responsabilidade do seu cliente trabalhar com o contato dele no Google para gerenciar os 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 o fluxo de trabalho de autenticação de maneira segura.
Isso requer duas etapas:
- Crie um endereço de e-mail da Conta do Google que você vai usar para acessar a rede do seu cliente.
- Peça para o cliente adicionar essa conta como usuário à rede do Ad Manager dele.
Na etapa 1, você pode criar uma Conta do Google separada para cada cliente ou uma principal que será usada para todos os clientes. A primeira opção é mais segura caso uma das suas contas seja comprometida. Isso significa que você só precisa realizar a etapa 1 uma vez.
Independentemente do que você fizer na etapa 1, na etapa 2, será necessário pedir que cada novo cliente adicione 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: criar uma conta de serviço do OAuth2, que gera um endereço de e-mail de conta de serviço que funciona como uma Conta do Google. Instruções para criar uma nova conta de serviço.
Opção 2: você pode criar uma Conta do Google comum (uma conta do Gmail) se inscrevendo como um novo usuário. Se você já tiver uma Conta do Google, conclua essa inscrição em uma janela anônima ou em uma nova sessão do navegador. Se sua empresa usa o Google Workspace, você pode criar uma Conta do Google no domínio da empresa e usá-la. Para os fins deste guia, vamos nos referir a ambas como uma Conta do Google "normal".
2. Peça ao cliente para 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 que eles o adicionem à rede.
Se você estiver fornecendo uma Conta do Google comum, peça para que eles adicionem sua conta como usuário à rede deles.
Não importa qual caminho você escolha, converse com o cliente sobre quais papéis e permissões sua conta deve ter para que o aplicativo possa acessar 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 de rede de forma programática ao criar uma instância de DfpSession.
Mantenha-se atualizado com a API
É importante que você se mantenha atualizado sobre 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 suas configurações de notificação:
- Nosso grupo de avisos de desativação da API Ad Manager.
- Nosso blog para desenvolvedores do Google Ads.
Também fornecemos um cronograma de descontinuação no nosso site para desenvolvedores que você deve monitorar regularmente.