Az ajánlatok átláthatósága a SupplyChain objektummal

A SupplyChain objektum lehetővé teszi a vevőknek és a közvetítőknek az összes olyan fél megtekintését, aki hirdetéskészlet értékesítője vagy viszonteladója. Az objektum működik az ads.txt / ads.txt és ads.txt fájlokkal együtt, hogy átláthatóságot biztosítson a hirdetési ökoszisztémában.

1. A megjelenítő ajánlatkérést küld.
2. A vevő ajánlatkérést és adatokat kap a SupplyChain objektumtól.
3. A vevő kikeresi az összes olyan közvetítő kilétét, aki a készletet továbbértékesíti.
4. A vevő feltérképezi és ellenőrzi a készlet értékesítésére jogosult szolgáltatókat.

A Google automatikusan létrehozza az objektumokat egy OpenRTB-kérelmen belül (ha van).

Hogyan működik a SupplyChain objektum?

A SupplyChain objektum (más néven schain) egy OpenRTB-ajánlatkérés része, és „csomópontokból” áll.Az schain objektum minden csomópontja az ajánlatkérésben részt vevő egy adott entitást jelképez. Az ajánlatkérés tartalmaz minden olyan entitást, amely részt vesz a készletért való közvetlen fizetési folyamatban.

Tipp: Ahhoz, hogy a Google létrehozhasson egy teljes SupplyChain objektumot, a Készlet kezelése felhatalmazástípussal rendelkező fölérendelt MCM-megjelenítőknek meg kell osztaniuk az alárendelt megjelenítőik eladói azonosítóját (sid) az Ad Manageren keresztül vagy az API használatával.

 

// Példa objektum
"schain": {
    "complete": 1,
    "nodes": [{
         "asi":"google.com",
         "sid":"pub-1234567891234567", // Ugyanaz a seller_id a sellers.json fájl megjelenítőjéhez
         "hp":1
    }],
    "ver":"1.0"
}

További részleteket az OpenRTB fejlesztői dokumentációjában és az IAB dokumentációjában talál.

A SupplyChain objektum eltérően néz ki attól függően, hogy Ön hogyan dolgozik a vevőkkel.

Megjelenítők, akik közvetlenül értékesítenek a Google-lal

Azoknál a megjelenítőknél, akik közvetlenül értékesítenek készletet az Ad Manager, AdMob vagy AdSense szolgáltatáson keresztül, az schain objektum csak egy csomópontot tartalmaz a „google.com” webhelyhez, amelynél a seller_id a sellers.json fájlban található.

Megjelenítők, akik nyílt ajánlattételt használnak

Azoknál a megjelenítőknél, akik a Nyílt ajánlattétel funkciót használják arra, hogy együtt dolgozzanak harmadik felek piactereivel, két csomópont van az schain objektumban: egy csomópont a google.com webhelyhez, amelynél a seller_id a sellers.json fájlban található, valamint egy másik csomópont a piactéri hozampartnerhez.

Ahogy a Google létrehozza a csomópontot a google.com webhelyhez az ajánlatkérés elküldése előtt, úgy a harmadik fél piactér felelős azért, hogy hozzáadja a saját csomópontját, mielőtt átadná a kérelmet.

Az összes nem fizető közvetítő

Azok a közvetítők, akik nem kezelnek kifizetéseket, nem szerepelnek a SupplyChain objektumban. Ide tartozik az ügyféloldali előzetes ajánlattétel, a nem fizetési előzetes ajánlattétel, a készletmegosztás és az egyéb közvetítés is.

Azok a megjelenítők, akik a kérelem előtt fizetési közvetítőt használnak ^(Béta) 

Ez a funkció bétaverziós
Előfordulhat, hogy a bétaverziós funkciók nem állnak rendelkezésre az Ön hálózatán. A kibocsátási megjegyzésekben megtekintheti, hogy az adott funkció mikor fog általánosan rendelkezésre állni.

Azoknak a megjelenítőknek, akik a Google Ad Managerhez irányuló kérés előtt fizetési közvetítőket vesznek igénybe, kötelező a SupplyChain objektum továbbítása az IAB irányelveinek megfelelően. A SupplyChain objektumnak csak olyan közvetítőket szabad tartalmaznia, amelyek közvetlenül részt vesznek a készlet kifizetési folyamatában. Ilyen közvetítők lehetnek a megjelenítő által használt, külső hirdetésmegjelenítői technológiák. A SupplyChain objektum az schain paraméter használatával küldhető el a hirdetési kérelemben.

További információ az schain paraméterről

Leírás

A szállítói lánc (schain) paraméter változó értéket fogad el, amelynek szerializált SupplyChain objektumnak kell lennie. Ha ez a paraméter szerepel, a Google a vevőknek való elküldés előtt csomópontot fűz hozzá minden kapott schain objektumhoz.

A SupplyChain-információk címkén keresztül (OpenRTB helyett) történő kommunikációjáról a teljes IAB-dokumentációban tájékozódhat.

Tekintse át az schain megfelelő elemzésére vonatkozó követelményeket

Az IAB-dokumentáció alapján az alábbiak határozzák meg a SupplyChain objektum szerializálását:

• A {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject és a SupplyChainNode tulajdonok vesszővel vannak elválasztva, így az opcionális mezők kihagyhatók, a hozzájuk tartozó vesszőelválasztók pedig opcionálisan kihagyhatók.
• Az egyes SupplyChainNode elemeket „!” választja el egymástól.
• Ha valamelyik tulajdon értéke olyan karaktereket tartalmaz, amelyek URL-kódolást igényelnek (például „,” vagy „!”), akkor az értéket a szerializálás előtt URL-kódolással kell ellátni.

Szerializálási sorrend

A SupplyChainObject tulajdonok szerializáltsága a következő sorrendben történik:

ver,complete

A SupplyChainNode tulajdonok szerializáltsága a következő sorrendben történik:

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

Megjegyzés: Az ext tartalma piactérspecifikus. A Google Ad Manager nem elemzi szintaktikailag ezt a tulajdont.

Példák a SupplyChain objektum szerializálására

Az alábbiakban két példát láthat a fenti SupplyChain objektum szerializálására:

Szerializálás vesszőkkel az üres, nem kötelező mezők esetén

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

Szerializálás vesszők nélkül az üres, nem kötelező mezők esetén

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

További információ a SupplyChain objektumról.

Példák a használatra

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

Ha az asi értéke exchange,1 lenne, akkor a feloldójelekkel végzett szerializálás a következőképpen nézne ki:

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

Követelmények és javaslatok

Bár ez a paraméter nem szükséges a hirdetések adott megvalósításnál vagy tranzakciótípusnál való megjelenítéséhez, a Google Ad Managernek küldött kérelem előtti fizetési közvetítőket használó megjelenítők számára szükséges használni. Ide tartoznak a külső hirdetésmegjelenítői technológiát használó megjelenítők is.

 

Megjegyzés: A SupplyChain objektumhoz hozzáfűzött további csomópontoknak is szerepelniük kell a megjelenítő ads.txt/app-ads.txt fájljában, különben a vevők nem engedélyezettnek tekinthetik a forgalmat.

A Több ügyfél kezelése eszközt használó megjelenítők

A Több ügyfél kezelése eszköz lehetővé teszi a fölérendelt megjelenítők számára, hogy bevételt szerezzenek az alárendelt megjelenítők készletéből akár egyenként a „fiók kezelése” felhatalmazástípussal, akár tömegesen, a „készlet kezelése” felhatalmazástípussal.

A Készlet kezelése felhatalmazástípust használó fölérendelt és alárendelt megjelenítők esetében a rendszer egy SupplyChain objektumot hoz létre, amely egy csomóponttal rendelkezik a fölérendelt megjelenítő eladói azonosítójához, egy csomóponttal az alárendelt megjelenítőhöz, és az schain objektum készként van megjelölve.

A fiók kezelése felhatalmazástípust használó fölérendelt és alárendelt megjelenítők esetében az schain objektum egy csomóponttal fog rendelkezni az alárendelt megjelenítő eladói azonosítójával, és a lánc teljesként lesz megjelölve. A Fiók kezelése felhatalmazástípussal rendelkező megjelenítőknél a bevételszerzés az alárendelt megjelenítő fiókjában történik. Az alárendelt megjelenítő minősül a végső megjelenítőnek. A fölérendelt megjelenítő információi nem szerepelnek az schain objektumban.