O objeto SupplyChain permite que os compradores e os intermediários vejam todas as partes que estão a vender ou a revender o inventário de anúncios. O objeto funciona em conjunto com ads.txt/app-ads.txt e sellers.json para proporcionar transparência no ecossistema dos anúncios.
- O publicador envia um pedido de lance.
- O comprador recebe o pedido de lance e os dados do objeto SupplyChain.
- O comprador procura as identidades de todos os intermediários que revendem o inventário.
- O comprador rastreia e valida os fornecedores autorizados a vender inventário.
A Google cria automaticamente os objetos num pedido do OpenRTB, se aplicável.
Como funciona o objeto SupplyChain
O objeto SupplyChain, também conhecido como schainschain representa uma entidade específica que participa no pedido de lance, que inclui todas as entidades envolvidas no fluxo de pagamento direto do inventário.
sid) dos respetivos publicadores secundários através do Ad Manager ou com 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"
}
Leia a documentação para programadores do OpenRTB e a documentação do IAB para ver mais detalhes.
O objeto SupplyChain tem um aspeto diferente consoante o modo como trabalha com os compradores.
Publicadores que vendem diretamente com a Google
Para os publicadores que vendem inventário diretamente através do Ad Manager, AdMob ou AdSense, o objeto schain contém apenas um nó para "google.com" com o seller_id encontrado em sellers.json.
Publicadores que utilizam o Open Bidding
Os publicadores que usam o Open Bidding para trabalhar com trocas de terceiros têm dois nós no objeto schain: um nó para google.com com o seller_id encontrado em sellers.json e um nó para o parceiro de rendimento de trocas.
Tal como a Google cria o nó para google.com antes de enviar o pedido de lance, a troca de terceiros é responsável por adicionar o respetivo nó antes de transmitir o pedido.
Todos os intermediários sem pagamentos
Os intermediários que não processam o pagamento não estão incluídos no objeto SupplyChain. Isto inclui lances de cabeçalho do lado do cliente, bem como lances de cabeçalho sem pagamentos, partilha de inventário e outra mediação.
Publicadores que usam intermediários de pagamento antes do pedido (Beta)
As funcionalidades na fase beta podem não estar disponíveis na sua rede. Veja as notas de lançamento para quando esta funcionalidade ficar disponível em geral.
Os publicadores que usam intermediários de pagamento upstream do pedido para o Google Ad Manager têm de 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. Estes intermediários podem incluir tecnologia de servidores de anúncios de terceiros usada pelo publicador. O objeto SupplyChain pode ser enviado no pedido de anúncio através do parâmetro schain.
Descrição
O parâmetro da cadeia de abastecimento (schain) aceita um valor variável que deve ser serializado como objeto SupplyChain. Quando este parâmetro está incluído, a Google anexa um nó a todos os objetos schain recebidos antes de os enviar aos compradores.
Consulte a documentação completa do IAB para comunicar informações do objeto SupplyChain através de uma etiqueta (em vez do OpenRTB).
Consulte os requisitos para que oschain seja analisado corretamente
Com base na documentação do IAB, o seguinte define a serialização do objeto SupplyChain:
{SupplyChainObject}!{SupplyChainNode array}. As propriedades do SupplyChainObjecte doSupplyChainNodesão delimitadas por vírgulas, de modo a que os campos opcionais possam ser omitidos e os separadores de vírgulas possam ser excluídos opcionalmente.- Cada elemento
SupplyChainNodeé separado por um "!". - Se o valor de qualquer propriedade contiver carateres que requerem codificação por URL (por exemplo, "
," ou "!"), o valor deve ser codificado por URL 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 é específico da troca. O Google Ad Manager não analisa esta propriedade.Exemplos de como serializar o objeto SupplyChain
Seguem-se 2 exemplos de formas de 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 utilização
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 carateres de escape teria o seguinte aspeto:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Requisitos e recomendações
Embora este parâmetro não seja necessário para publicar anúncios para qualquer tipo de implementação ou transação específico, é necessário para publicadores que usam intermediários de pagamento upstream do pedido para o Google Ad Manager. Isto inclui publicadores que usam tecnologia de servidores de anúncios de terceiros.
SupplyChain também devem ser representados no ficheiro ads.txt/app-ads.txt de um publicador. Caso contrário, os compradores podem considerar o tráfego não autorizado.Publicadores da Gestão de vários clientes
A Gestão de vários clientes (MCM) permite aos publicadores gerir as contas do AdMob dos respetivos clientes com a mesma visibilidade e controlo que os próprios publicadores.
Para publicadores superiores e secundários que utilizam a MCM do AdMob, o objeto schain terá um nó com o ID de vendedor do publicador secundário, um nó para o publicador superior e a cadeia será marcada como concluída. Na MCM do AdMob, a rentabilização ocorre na conta do publicador secundário. O publicador secundário é tratado como o publicador final.