Kainos pasiūlymo skaidrumas naudojant „SupplyChain“ objektą

Naudodami „SupplyChain“ objektą pirkėjai ir tarpininkai gali matyti visas šalis, parduodančias ar perparduodančias skelbimų vietas. Objektas veikia su ads.txt ir (arba) app-ads.txt ir sellers.json, kad būtų užtikrintas skelbimų ekosistemos skaidrumas.

1. Leidėjas siunčia kainos pasiūlymo užklausą.
2. Pirkėjas gauna kainos pasiūlymo užklausą ir duomenis iš „SupplyChain“ objekto.
3. Pirkėjas randa visus tarpininkus, kurie perparduoda skelbimų vietas.
4. Pirkėjas tikrina ir patvirtina paslaugų teikėjus, kurie įgalioti parduoti skelbimų vietas.

„Google“ automatiškai sukurs objektus pagal „OpenRTB“ užklausą arba „Google“ KSRL protokolą (jei taikoma).

Kaip veikia „SupplyChain“ objektas

„SupplyChain“ objektas (taip pat vadinamas schain) yra „OpenRTB“ kainos pasiūlymo užklausos dalis ir jį sudaro mazgai. Kiekvienas schain objekto mazgas nurodo konkretų subjektą, dalyvaujantį teikiant kainos pasiūlymų užklausas, apimančias visus subjektus, susijusius su tiesioginiu mokėjimo už skelbimų vietas srautu.

Patarimas: kad „Google“ galėtų sukurti visą „SupplyChain“ objektą, KKV skelbimų vietų valdymo pirminiai leidėjai turi bendrinti antrinių leidėjų pardavėjo ID (sid) per „Ad Manager“ arba naudodami API.

 

// Objekto pavyzdys
"schain": {
    "complete": 1,
    "nodes": [{
         "asi":"google.com",
         "sid":"pub-1234567891234567", // Tas pats „seller_id“ nurodomas leidėjui faile „sellers.json“
         "hp":1
    }],
    "ver":"1.0"
}

Jei reikia daugiau išsamios informacijos, skaitykite „OpenRTB“ kūrėjo dokumentus ir IAB dokumentus.

„SupplyChain“ objektas skiriasi atsižvelgiant į tai, kaip dirbate su pirkėjais.

Leidėjai, kurie parduoda tiesiogiai per „Google“

Leidėjų, kurie skelbimų vietas parduoda tiesiai per „Ad Manager“, „AdMob“ ar „AdSense“, schain objekte yra tik vienas „google.com“ mazgas, kurio seller_id randamas faile „seller.json“.

Leidėjai, naudojantys atvirą kainų siūlymą

Leidėjų, kurie naudoja atviro kainų siūlymo funkciją dirbdami su trečiųjų šalių mainų sistemomis, schain objekte yra du mazgai: vienas mazgas, skirtas google.com, kurio seller_id randamas faile „seller.json“, ir kitas – skirtas mainų pajamų partneriui.

Kai „Google“ sukuria google.com mazgą prieš išsiųsdama kainos pasiūlymo užklausą, trečiosios šalies mainų sistema turi pridėti savo mazgą, kad būtų galima perduoti užklausą.

Visi ne mokėjimo tarpininkai

Tarpininkai, kurie neapdoroja mokėjimo, neįtraukiami į „SupplyChain“ objektą. Tai apima klientų pusės antraštės kainų siūlymą, ne mokėjimo antraštės kainų siūlymą, skelbimų vietų bendrinimą ir kito tipo tarpininkavimą.

Leidėjai, kurie prieš pateikdami užklausą naudoja mokėjimų tarpininkus ^{(Beta versija)} 

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.

Leidėjai, naudojantys mokėjimų tarpininkus prieš pateikdami užklausą „Google Ad Manager“, turi perduoti objektą SupplyChain pagal IAB gaires. SupplyChain objekte turėtų būti tik tarpininkai, kurie tiesiogiai susiję su mokėjimo už skelbimų vietas srautu. Tokie tarpininkai gali apimti trečiosios šalies skelbimų serverio technologiją, kurią naudoja leidėjas. Objektą SupplyChain galima siųsti skelbimo užklausoje naudojant parametrą schain.

Sužinokite daugiau apie parametrą „schain“

Aprašas

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.

 

Pastaba: visi papildomi objektai, pridėti prie objekto SupplyChain, taip pat turėtų būti pateikti leidėjo faile ads.txt/app-ads.txt, nes kitaip pirkėjai gali laikyti srautą neteisėtu.

Kelių klientų valdymo leidėjai

Naudodami kelių klientų valdymo (KKV) įrankį, leidėjai gali valdyti klientų „AdMob“ paskyras ir viską matyti bei kontroliuoti taip, kaip tai gali daryti patys leidėjai.

Jei pirminiai ir mažieji leidėjai naudoja „AdMob“ KKV įrankį, schain objektas apima vieną mazgą su mažojo leidėjo pardavėjo ID, o rodinių grandinė pažymima kaip užbaigta. „AdMob“ KKV paskyros pajamų gavimo procesas vyksta mažojo leidėjo paskyroje. Mažasis leidėjas laikomas galutiniu leidėju. Pirminio leidėjo informacija neįtraukiama į objektą schain.