Prostřednictvím objektu SupplyChain si kupující a prostředníci mohou prohlédnout všechny strany, které prodávají nebo přeprodávají reklamní inventář. Objekt ve spojení se soubory ads.txt / ads.txt a ads.txt zprostředkovává transparentní informace o reklamním ekosystému.
- Majitel stránek odešle žádost o nabídku.
- Kupující obdrží žádost o nabídku a data z objektu SupplyChain.
- Kupující vyhledá identity všech zprostředkovatelů, kteří přeprodávají inventář.
- Kupující projde a ověří dodavatele, kteří jsou oprávněni prodávat inventář.
Pokud je to možné, vytváří Google tyto objekty u žádostí OpenRTB automaticky.
Fungování objektů SupplyChain
SupplyChain, známý také jako schainschain představuje konkrétní subjekt, který je do žádosti o nabídku zapojen. Účastní se všechny subjekty, které jsou součástí přímého toku platby za inventář.
sid) svých podřízených majitelů stránek prostřednictvím služby Ad Manager nebo pomocí rozhraní API.
// Příklad objektu
"schain": {
"complete": 1,
"nodes": [{
"asi":"google.com",
"sid":"pub-1234567891234567", // Stejné jako seller_id majitele obsahu v souboru sellers.json
"hp":1
}],
"ver":"1.0"
}
Další podrobnosti najdete v dokumentaci žádostí OpenRTB pro vývojáře a v dokumentaci organizace IAB.
Objekt SupplyChain se liší v závislosti na tom, jak s kupujícími pracujete.
Majitelé stránek, kteří inventář prodávají přímo prostřednictvím služeb Google
U majitelů stránek, kteří inventář prodávají přímo prostřednictvím služby Ad Manager, AdMob či AdSense, objekt schain obsahuje pouze jeden uzel „google.com“ s identifikátorem seller_id uvedeným v souboru sellers.json.
Majitelé stránek, kteří používají otevřené nabídky
Majitelé stránek, kteří prostřednictvím Otevřených nabídek spolupracují s burzami třetích stran, mají v objektu schain dva uzly: jeden pro google.com s identifikátorem seller_id ze souboru sellers.json a jeden pro burzu, kterou využívají jako partnera ve výtěžcích.
Uzel pro google.com vytváří Google ještě před odesláním žádosti o nabídku. Externí burza by měla přidat svůj vlastní uzel a teprve poté žádost předat dál.
Všichni zprostředkovatelé, kteří nezpracovávají platby
Zprostředkovatelé, kteří nezpracovávají platby, v objektu SupplyChain zahrnuti nejsou. Týká se to header biddingu na straně klienta, header biddingu bez plateb, sdílení inventáře a jiných zprostředkování.
Majitelé stránek, kteří využívají zprostředkovatele plateb před žádostí (Beta)
Funkce ve fázi beta nemusí být ve vaší síti dostupné. Až tato funkce bude všeobecně dostupná, budeme o tom informovat v poznámkách k vydání.
Majitelé stránek, kteří využívají zprostředkovatele plateb před odesláním žádosti do služby Google Ad Manager, musí předávat objekt SupplyChain v souladu s pokyny organizace IAB. Objekt SupplyChain by měl obsahovat pouze zprostředkovatele, kteří jsou přímo zapojeni do procesu plateb za inventář. Mezi takové zprostředkovatele může patřit i reklamní server třetí strany používaný majitelem stránek. Objekt SupplyChain lze v žádosti o reklamu odeslat pomocí parametru schain.
Popis
Pomocí parametru dodavatelského řetězce (schain) se předává proměnná hodnota, která by měla být serializovaným objektem SupplyChain. Pokud je tento parametr zahrnut, před odesláním kupujícím připojí Google k přijatým objektům schain svůj uzel.
Přečtěte si úplnou dokumentaci organizace IAB k předávání informací o dodavatelském řetězci prostřednictvím značky (nikoli prostřednictvím protokolu OpenRTB).
Požadavky na správné zpracování poleschain
Podle dokumentace IAB definuje serializaci objektu SupplyChain následující kód:
{SupplyChainObject}!{SupplyChainNode array}. VlastnostiSupplyChainObjectaSupplyChainNodejsou odděleny čárkami. Volitelná pole lze vynechat a prázdné oddělovací čárky na konci lze vynechat.- Jednotlivé prvky
SupplyChainNodejsou odděleny znakem!. - Pokud hodnota některé vlastnosti obsahuje znaky, které je potřeba zakódovat pro URL (například „
,“ nebo „!“), je hodnotu před serializací potřeba zakódovat pro URL.
Pořadí serializace
Vlastnosti SupplyChainObject se serializují v tomto pořadí:
ver,complete
Vlastnosti SupplyChainObject se serializují v tomto pořadí:
asi,sid,hp,rid,name,domain,ext
ext se liší podle burzy. Služba Google Ad Manager tuto vlastnost neanalyzuje.Příklady serializace objektu SupplyChain
Níže uvádíme dva příklady serializace výše uvedeného objektu SupplyChain:
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
Příklady použití
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
Pokud by hodnota asi byla exchange,1, serializace s escapovanými znaky by vypadala takto:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Požadavky a doporučení
Ačkoli tento parametr není u žádné konkrétní implementace ani typu transakce k zobrazování reklam vyžadován, je vyžadován u majitelů stránek, kteří využívají zprostředkovatele plateb před žádostí do služby Google Ad Manager. Týká se to i majitelů stránek, kteří používají reklamní servery třetích stran.
SupplyChain musí být uvedeny i v souboru ads.txt/app-ads.txt majitele stránek, jinak by kupující mohli návštěvnost považovat za neautorizovanou.Majitelé stránek se správou více zákazníků
Správa více zákazníků (MCM) umožňuje spravovat účty AdMob klientů se stejnou mírou kontroly a přístupu, jakou mají samotní majitelé stránek.
U nadřazených a podřízených majitelů stránek, kteří používají funkci MCM služby AdMob, bude mít objekt schain jeden uzel zahrnující ID prodejce podřízeného majitele stránek a jeden uzel pro nadřazeného majitele stránek a bude označen jako úplný. V případě funkce MCM služby AdMob probíhá zpeněžování v účtu podřízeného majitele stránek. Za koncového majitele stránek se považuje podřízený majitel stránek.