L'oggetto SupplyChain consente ad acquirenti e intermediari di vedere tutte le parti coinvolte nella vendita o nella rivendita dell'inventario pubblicitario. L'oggetto funziona assieme ad ads.txt/app-ads.txt e a sellers.json per garantire trasparenza nell'ecosistema pubblicitario.
- Il publisher invia una richiesta di offerta.
- L'acquirente riceve la richiesta di offerta e i dati dell'oggetto SupplyChain.
- L'acquirente cerca le identità di tutti gli intermediari che rivendono l'inventario.
- L'acquirente esegue la scansione e la verifica dei fornitori autorizzati a vendere l'inventario.
Se applicabile, Google crea automaticamente gli oggetti in una richiesta OpenRTB.
Funzionamento dell'oggetto SupplyChain
L'oggetto SupplyChain, denominato anche schainschain rappresenta una specifica entità che partecipa alla richiesta di offerta, che include tutte le entità coinvolte nel flusso di pagamento diretto per l'inventario.
sid) dei propri publisher secondari tramite Ad Manager o utilizzando l'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"
}
Per ulteriori dettagli, leggi la documentazione per lo sviluppo di OpenRTB e la documentazione di IAB.
L'oggetto SupplyChain avrà un aspetto diverso a seconda di come collabori con gli acquirenti.
Publisher che vendono direttamente con Google
Per i publisher che vendono l'inventario direttamente tramite Ad Manager, AdMob o AdSense, l'oggetto schain contiene solo un nodo per "google.com", con il seller_id trovato in sellers.json.
Publisher che utilizzano Open Bidding
I publisher che utilizzano Open Bidding per collaborare con piattaforme di scambio di terze parti presentano due nodi nell'oggetto schain: uno per google.com con il seller_id trovato in sellers.json e un altro per il partner di rendimento della piattaforma.
Così come Google crea il nodo per google.com prima di inviare la richiesta di offerta, la piattaforma di scambio di terze parti dovrà aggiungere il proprio nodo prima di trasmettere la richiesta.
Tutti gli intermediari che non gestiscono il pagamento
Gli intermediari che non gestiscono il pagamento non sono inclusi nell'oggetto SupplyChain. Ciò comprende header bidding lato client, header bidding non di pagamento, condivisione dell'inventario e altri tipi di mediazione.
Publisher che utilizzano intermediari di pagamento prima della richiesta (beta)
Le funzionalità in fase beta potrebbero non essere disponibili nella tua rete. Controlla le note sulla versione per sapere quando questa funzionalità sarà disponibile per tutti.
I publisher che utilizzano intermediari di pagamento prima della richiesta a Google Ad Manager sono tenuti a passare l'oggetto SupplyChain in base alle linee guida IAB. L'oggetto SupplyChain deve contenere solo gli intermediari direttamente coinvolti nel flusso di pagamento per l'inventario. Questi intermediari possono includere la tecnologia ad server di terze parti utilizzata dal publisher. L'oggetto SupplyChain può essere inviato nella richiesta di annuncio utilizzando il parametro schain.
Descrizione
Il parametro della catena di fornitura (schain) accetta un valore variabile che deve essere un oggetto SupplyChain serializzato. Quando questo parametro è incluso, Google aggiunge un nodo a tutti gli oggetti schain ricevuti prima di inviarli agli acquirenti.
Consulta la documentazione completa di IAB per comunicare le informazioni di SupplyChain tramite un tag (anziché OpenRTB).
Consulta i requisiti per l'analisi corretta dischain
In base alla documentazione di IAB, di seguito è descritta la serializzazione dell'oggetto SupplyChain:
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObjecteSupplyChainNodesono proprietà separate da virgole in modo che i campi facoltativi possano essere omessi e quelli che è possibile escludere facoltativamente separati da virgole.- Ogni elemento
SupplyChainNodeè separato da un "!". - Se il valore di una proprietà contiene caratteri che richiedono la codifica dell'URL (ad esempio "
," o "!"), il valore deve essere codificato nell'URL prima della serializzazione.
Ordine di serializzazione
Le proprietà SupplyChainObject vengono serializzate in questo ordine:
ver,complete
Le proprietà SupplyChainNode vengono serializzate in questo ordine:
asi,sid,hp,rid,name,domain,ext
ext sono specifici della piattaforma di scambio pubblicitario. Google Ad Manager non analizza questa proprietà.Esempi di come eseguire la serializzazione dell'oggetto SupplyChain
Di seguito sono riportati due esempi di metodi per serializzare l'oggetto SupplyChain riportato sopra:
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
Esempi di utilizzo
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
Se il valore di asi fosse exchange,1, la serializzazione con caratteri di escape sarebbe la seguente:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Requisiti e consigli
Sebbene questo parametro non sia necessario per pubblicare annunci per un tipo di implementazione o transazione specifico, è obbligatorio per i publisher che utilizzano intermediari di pagamento a monte della richiesta a Google Ad Manager. Sono inclusi i publisher che utilizzano la tecnologia ad server di terze parti.
SupplyChain devono essere rappresentati anche nel file ads.txt/app-ads.txt di un publisher, altrimenti gli acquirenti potrebbero considerare il traffico non autorizzato.Publisher che utilizzano Gestione di più clienti
Lo strumento Gestione di più clienti (MCM) consente di gestire gli account AdMob dei clienti con la stessa visibilità e lo stesso controllo dei publisher.
Per i publisher principali e secondari che utilizzano lo strumento MCM di AdMob, l'oggetto schain avrà un nodo con l'ID venditore del publisher secondario e un nodo per il publisher principale. La catena sarà contrassegnata come completa. Nel caso di MCM di AdMob, la monetizzazione avviene nell'account del publisher secondario. Il publisher secondario viene considerato quindi come publisher finale.