Os terceiros não são usuários diretos do Ad Manager e podem não ter uma rede própria do Ad Manager. Em vez disso, eles criam serviços ou integrações com o Ad Manager para os clientes do Ad Manager. Neste guia, apresentamos os conceitos básicos das integrações de terceiros e fornecemos práticas recomendadas, dicas e truques.
Este guia pressupõe que você tenha conhecimento prático sobre a API Ad Manager. Se você não conhece a API Ad Manager, consulte nossa documentação para iniciantes.
Como começar como terceiro
Para usar a API Ad Manager para acessar a rede de um cliente do Ad Manager, basta seguir as diretrizes abaixo. Nenhuma aprovação adicional do Google é necessária. No entanto, ao acessar e/ou usar a API Ad Manager, você concorda com os Termos e Condições dela.
Como testar a integração do Ad Manager como um terceiro
Como terceiro, talvez você esteja se perguntando como testar a integração do Ad Manager antes de executá-la nas redes de produção dos seus clientes. A abordagem recomendada é criar uma rede de teste. Você não precisa ser cliente do Ad Manager para fazer isso. Qualquer pessoa com uma Conta do Google pode criar uma rede de teste.
Observe, no entanto, 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 deles. Se você precisar testar os recursos do Ad Manager que não estão disponíveis na rede de teste, uma opção é comprar o acesso a uma rede que não seja de teste de um revendedor do Ad Manager.
Além disso, é necessário ser claro com os clientes sobre 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 seus clientes e quais recursos cada um tem ou não. Deve ser responsabilidade do 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 o aplicativo acesse a rede do Ad Manager do seu cliente, é necessário 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ê usará para acessar a rede do seu cliente.
- Peça para o cliente adicionar essa conta como um usuário à rede do Ad Manager.
Na etapa 1, é possível 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. No último caso, você só precisa executar a etapa 1 uma vez.
Independentemente do que você fizer na etapa 1, será necessário solicitar que cada novo cliente adicione a Conta do Google que você criou para ele como usuário na rede do Ad Manager.
1. Como criar uma Conta do Google
Existem 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 OAuth2, que gera um endereço de e-mail de conta de serviço para você que funcionará como uma Conta do Google. Instruções para criar uma nova conta de serviço.
Opção 2: é possível criar uma Conta do Google normal (conta do Gmail) se inscrevendo como um novo usuário. Se você já tem uma Conta do Google, conclua o processo de inscrição em uma janela anônima ou em uma nova sessão do navegador. Ou, se sua empresa usa o Google Workspace, é possível criar uma Conta do Google no domínio da empresa e usá-la. Para os fins deste guia, vamos nos referir a ambas como Contas do Google "comuns".
2. Peça ao cliente para adicionar sua Conta do Google à rede dele
Depois de criar uma Conta do Google para acessar a rede do seu cliente, peça que ele adicione a conta como um novo usuário na rede do Ad Manager.
Se você estiver fornecendo a eles um endereço de e-mail da conta de serviço OAuth2, peça que eles adicionem-o à rede.
Se você estiver fornecendo a eles uma Conta do Google normal, peça para eles adicionarem sua conta como um usuário à rede dele.
Seja qual for a rota, converse com o cliente sobre quais papéis e permissões sua conta precisa ter para que o aplicativo possa acessar os dados necessários na rede dele.
Agora você pode começar a fazer chamadas de API para a rede do Ad Manager do seu cliente. Lembre-se de definir o cabeçalho comercial do 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 configurar esse recurso de maneira programática. Por exemplo, na biblioteca de cliente Java de anúncios, é possível definir programaticamente o código de rede ao criar uma instância DfpSession.
Ficar por dentro da API
É importante saber quais versões da API foram descontinuadas ou desativadas e quando novas versões são lançadas. Evite ser pego de surpresa quando uma versão for desativada e você corre o risco de prejudicar seus clientes. Nem sempre podemos entrar em contato com terceiros sobre descontinuações e desativações iminentes como fazemos para nossos clientes. Portanto, é sua responsabilidade se inscrever em um dos nossos três canais principais para atualizações da API e ajustar suas configurações de notificação:
Além disso, oferecemos um cronograma de descontinuação no site do desenvolvedor que precisa ser monitorado regularmente.
Como receber suporte
Se você tiver problemas com a integração do Ad Manager, oferecemos os canais de suporte a seguir, dependendo do problema. Se você tiver alguma dúvida sobre o produto, escreva para os fóruns de produto do Ad Manager. Se você tiver dúvidas específicas sobre a API, consulte os fóruns da API Ad Manager. Consulte esta postagem do blog (em inglês) para dicas sobre como distinguir se algo é uma pergunta no nível do produto ou uma pergunta específica da API.