Zaistenie transparentnosti ponúk vďaka objektu SupplyChain

Prostredníctvom objektu SupplyChain si kupujúci a sprostredkovatelia môžu pozrieť všetky strany, ktoré priamo alebo sprostredkovane predávajú reklamný inventár. Tento objekt spolupracuje so súbormi ads.txt, app-ads.txt a sellers.json a poskytuje transparentné informácie o reklamnom ekosystéme.

1. Vlastník odošle žiadosť o ponuku.
2. Kupujúci dostane žiadosť o ponuku a údaje z objektu SupplyChain.
3. Kupujúci vyhľadá identity všetkých sprostredkovateľov, ktorí predávajú inventár.
4. Kupujúci prehľadá a overí dodávateľov, ktorí sú oprávnení predávať inventár.

Ak je to možné, Google automaticky vytvorí tieto objekty v rámci žiadosti OpenRTB alebo protokolu Google RTB.

Ako funguje objekt SupplyChain

Objekt SupplyChain, známy tiež ako schain, je súčasťou žiadosti o ponuku OpenRTB a pozostáva z uzlov. Každý uzol v objekte schain predstavuje konkrétny subjekt zapojený do žiadosti o ponuku. Zúčastňujú sa všetky subjekty, ktoré sú súčasťou priameho toku platby za inventár.

Tip: Ak chce Google vytvoriť úplný objekt SupplyChain, nadradené položky správy inventára v nástroji MCM musia zdieľať identifikátor predajcu (sid) podriadených vlastníkov prostredníctvom služby Ad Manager alebo pomocou rozhrania API.

 

// Príklad objektu
"schain": {
    "complete": 1,
    "nodes": [{
         "asi":"google.com",
         "sid":"pub-1234567891234567", // Rovnaké ako seller_id vlastníka v súbore sellers.json
         "hp":1
    }],
    "ver":"1.0"
}

Viac podrobností nájdete v dokumentácii k žiadostiam OpenRTB pre vývojárov a dokumentácii združenia IAB.

Objekt SupplyChain sa líši v závislosti od spôsobu, akým spolupracujete s kupujúcimi.

Vlastníci, ktorí predávajú priamo cez Google

V prípade vlastníkov, ktorí predávajú inventár priamo cez Ad Manager, AdMob alebo AdSense, obsahuje objekt schain iba jeden uzol pre google.com s identifikátorom seller_id uvedeným v súbore sellers.json.

Vlastníci, ktorí používajú otvorené ponuky

Vlastníci, ktorí prostredníctvom otvorených ponúk spolupracujú s burzami tretích strán, majú v objekte schain dva uzly: jeden pre google.com s identifikátorom seller_id uvedeným v súbore sellers.json a jeden pre burzu, ktorú využívajú ako partnera pri výnosoch.

Podobne, ako Google vytvorí uzol pre google.com pred odoslaním žiadosti o ponuku, aj burza tretej strany by mala pridať svoj uzol ešte pred odovzdaním žiadosti ďalej.

Všetci sprostredkovatelia, ktorí nespracúvajú platby

Sprostredkovatelia, ktorí nespracúvajú platby, nie sú v objekte SupplyChain zahrnutí. Týka sa to klientskeho vytvárania ponúk pre hlavičku, vytvárania ponúk pre hlavičku bez platieb, zdieľania inventára a ďalších sprostredkovaní.

Vlastníci, ktorí pred podaním žiadosti používajú sprostredkovateľov platieb ^(beta) 

This feature is in Beta
Features in Beta phase might not be available in your network. Watch the release notes for when this feature becomes generally available.

Vlastníci využívajúci sprostredkovateľov platieb pred odoslaním žiadosti do služby Google Ad Manager musia odovzdať objekt SupplyChain podľa pokynov združenia IAB. Objekt SupplyChain by mal obsahovať iba sprostredkovateľov, ktorí sú priamo zapojení do toku platby za inventár. Medzi takých sprostredkovateľov môže patriť technológia reklamného servera tretej strany používaná vlastníkom. Objekt SupplyChain môžete odoslať v požiadavke na reklamu pomocou parametra schain.

Ďalšie informácie o parametri schain

Opis

The supply chain (schain) parameter accepts a variable value which should be serialized SupplyChain object. When this parameter is included, Google appends a node to any received schain objects prior to sending to buyers.

See the full IAB documentation for communicating SupplyChain information via a tag (rather than OpenRTB).

See requirements for schain to be parsed correctly

Based on the IAB documentation, the following defines the serialization for the SupplyChain object:

• {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject and SupplyChainNode properties are comma delimited such that optional fields can be omitted and comma separators for which can be optionally excluded.
• Each SupplyChainNode element is separated by a "!".
• If the value of any property contains characters that require URL encoding (for example "," or "!"), the value should be URL encoded before serialization.

Serialization order

SupplyChainObject properties are serialized in this order:

ver,complete

SupplyChainNode properties are serialized in this order:

asi,sid,hp,rid,name,domain,ext

Note: The contents of ext are exchange specific. Google Ad Manager does not parse this property.

Examples of how to serialize the SupplyChain object

Below are two examples of ways to serialize the above SupplyChain object:

Serialize with commas for empty optional fields

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Serialize without commas for empty optional fields

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Learn more about the SupplyChain object.

Usage examples

schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

If the value for asi were exchange,1, then the serialization with escaped characters would look like:

1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Requirements and recommendations

While this this parameter is not required to serve ads to any specific implementation or transaction type, it is required for publishers leveraging payment intermediaries upstream of the request to Google Ad Manager. This includes publishers who use third-party ad server technology.

 

Poznámka: Všetky ďalšie uzly pripojené k objektu SupplyChain by mali byť uvedené aj v súbore ads.txt alebo app-ads.txt vlastníka. Inak by kupujúci mohli považovať návštevnosť za neoprávnenú.

Multiple Customer Management publishers

Multiple Customer Management (MCM) enables parent publishers to monetize child publishers’ inventory either individually with the Manage Account delegation type, or at scale with the Manage Inventory delegation type .

For parent and child publishers using Manage Inventory, there is now one SupplyChain Object created with one node for the parent publisher’s seller ID, one node for the child publisher, and the schain object is marked complete.

For parent and child publishers using Manage Account, the schain object will have one node with the child publisher’s seller ID and the chain will be marked as complete. For Manage Account publishers, monetization occurs in the child publisher’s account. The child publisher is treated as the end publisher. The parent publisher’s information is not included in the schain object.