Com o objeto SupplyChain, compradores e intermediários podem ver todas as partes que estão vendendo ou revendendo inventário de anúncios. O objeto trabalha com ads.txt / app-ads.txt e sellers.json para dar transparência ao ecossistema de anúncios.
- O publisher envia uma solicitação de lance.
- O comprador recebe a solicitação de lance e os dados do objeto SupplyChain.
- O comprador procura pelas identidades de todos os intermediários que revendem inventário.
- O comprador rastreia e verifica os fornecedores autorizados a vender inventário.
O Google cria automaticamente os objetos dentro de uma solicitação do OpenRTB ou no próprio protocolo RTB, se aplicável.
Como o objeto SupplyChain funciona
O objeto SupplyChain, também conhecido como schainschain representa uma entidade específica que participa da solicitação de lance, que inclui todas as entidades envolvidas no fluxo direto de pagamento do inventário.
sid) dos publishers secundários pelo Ad Manager ou usando a API.
// Example object
"schain": {
"complete": 1,
"nodes": [{
"asi":"google.com",
"sid":"pub-1234567891234567", // Same seller_id for the publisher in sellers.json
"hp":1
}],
"ver":"1.0"
}
Para saber mais, leia a documentação para desenvolvedores do OpenRTB e a documentação do IAB (em inglês).
O objeto SupplyChain tem aparência diferente dependendo da forma como você trabalha com os compradores.
Publishers que vendem diretamente com o Google
Para publishers que vendem inventário diretamente pelo Ad Manager, pela AdMob ou pelo Google AdSense, o objeto schain contém somente um nó para "google.com" com o seller_id encontrado no sellers.json.
Publishers que usam o Open Bidding
Os publishers que usam o Open Bidding para trabalhar com trocas de terceiros têm dois nós no objeto schain: um para "google.com" com o seller_id encontrado no sellers.json e outro para o parceiro de rendimento da troca.
Assim como o Google cria o nó para "google.com" antes de enviar a solicitação de lance, a troca de terceiros é responsável por adicionar o próprio nó antes de encaminhar a solicitação.
Todos os intermediários que não processam pagamentos
Os intermediários que não processam pagamentos não estão no objeto SupplyChain. Isso inclui lances de cabeçalho do lado do cliente, lances de cabeçalho que não envolvem pagamentos, compartilhamento de inventário e outras mediações.
Publishers que usam intermediários de pagamento antes da solicitação (Beta)
Talvez os recursos na fase Beta não estejam disponíveis na sua rede. Consulte as notas da versão para saber quando esse recurso vai estar disponível para todo mundo.
Os publishers que usam intermediários de pagamento antes da solicitação para o Google Ad Manager precisam transmitir o objeto SupplyChain de acordo com as diretrizes do IAB. O objeto SupplyChain só deve conter intermediários diretamente envolvidos no fluxo de pagamento do inventário. Esses intermediários podem incluir tecnologia de servidor de anúncios de terceiros usada pelo publisher. O objeto SupplyChain pode ser enviado na solicitação de anúncio usando o parâmetro schain.
Descrição
O parâmetro de cadeia de suprimentos (schain) aceita um valor variável que precisa ser serializado como objeto SupplyChain. Quando esse parâmetro é incluído, o Google adiciona um nó ao final de todos os objetos schain recebidos antes de enviar aos compradores.
Consulte a documentação completa do IAB para comunicar informações do SupplyChain por uma tag (em vez do OpenRTB).
Conferir os requisitos para queschain seja analisado corretamente
Com base na documentação do IAB, o exemplo a seguir define a serialização do objeto SupplyChain:
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObjecteSupplyChainNodesão propriedades delimitadas por vírgulas para que os campos opcionais possam ser omitidos e os separadores possam ser excluídos.- Cada elemento
SupplyChainNodeé separado por uma!. - Se o valor de qualquer propriedade contiver caracteres que exigem codificação de URL (por exemplo,
,ou!), o valor precisa ser codificado antes da serialização.
Ordem de serialização
As propriedades do SupplyChainObject são serializadas nesta ordem:
ver,complete
As propriedades do SupplyChainNode são serializadas nesta ordem:
asi,sid,hp,rid,name,domain,ext
ext são específicos à troca. O Google Ad Manager não analisa essa propriedade.Exemplos de como serializar o objeto SupplyChain
Confira abaixo dois exemplos de como serializar o objeto SupplyChain acima:
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Exemplos de uso
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
Se o valor de asi fosse exchange,1, a serialização com caracteres de escape seria assim:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Requisitos e recomendações
Esse parâmetro não é necessário para veicular anúncios em nenhuma implementação ou tipo de transação específico, mas é obrigatório para publishers que usam intermediários de pagamento antes da solicitação para o Google Ad Manager. Isso inclui publishers que usam tecnologia de servidor de anúncios de terceiros.
SupplyChain também precisam ser representados em um arquivo ads.txt/app-ads.txt do publisher. Caso contrário, os compradores podem considerar o tráfego como não autorizado.Editores de Gerenciamento de múltiplos clientes
O Gerenciamento de múltiplos clientes (GMC) permite que os editores gerenciem contas da AdMob de clientes com a mesma visibilidade e controle dos próprios editores.
Para editores pais e filhos que usam o GMC da AdMob, o objeto schain terá um nó com o ID de vendedor do editor filho, um nó para o editor pai, e a cadeia será marcada como concluída. No GMC da AdMob, a monetização ocorre na conta do editor filho. O editor filho é tratado como o editor final.