Tudásbázis
Customtarget
Szerző: Barbara Liza Walcz on 2023 March 2. 12:34

Működési elv

A customtarget funkcióval a weboldal bármilyen adatot át tud adni az AdServernek. Ez lehet egyedi felhasználói adatbázis, vagy bármilyen olyan adat, ami a weboldal rendelkezésére áll. Egy, a customtarget leírását tartalmazó xml átadása után az AdServer adminfelületén, a targetálási kifejezésszerkesztőben megjelennek az egyes mezők (pl. életkor, szem színe stb.) amelyekre targetált kampányt lehet indítani. A targetálás akkor fog működni, ha a leíró xml-nek megfelelő, az adott userre jellemző adatok - az AdServer beépítési kódot dinamikusan kiegészítve - eljutnak az AdServerhez. Ha az AdServer nem kapja meg ezt a kiegészítő adatot, akkor a customtarget szerint célzott terveket nem fogja megjeleníteni.

Adatvédelem

A customtarget adatokat az Adverticum AdServer külön megrendelés és szerződéskötés esetén képes tárolni. Statisztikát az adatokról nem készít.

Használható adattípusok

A forrásadatbázis mezőit a minta XML-ben “param” tag-ek jelölik. A param tag-ek “name” attribútumainak meg kell egyezniük a base64 encode-olt egyedi taregetálási paraméterben szereplő változónevekkel. Ezt a base64 encode-olt paramétert beépítési kódtól függően kell az adserverhez eljuttatni. A desc a mi admin felületünkön fog megjelenni a mező nevénél. A type a változó típusa, ami a következők valamelyike lehet (ami nem egyértelmű, vagy nincs rá példa az xmlben, ahhoz van egy kis leírás):

  • text
  • integer
  • float (Értékét tizedespont elválasztással várjuk. pl: 15.5)
  • intselect
  • stringselect
  • bitselect
    Ez egy “multiple select”, amiben a select optionjei egy kettes számrendszerbeli szám helyiértékeit jelölik. Az értékük, ha az adott option ki van választva, akkor 1, ha nincs kiválasztva, akkor 0. Így a select elemei összeadnak egy integert, és a Partnerünk csak ezt a számot küldi el nekünk az ADV kéréskor. Egy bitselectet egy 32 bites integer reprezentál. 32-nél több option esetén további bitselectek használata lehetséges.
  • boolean

Az aktuális felhasználó adatait az adatbázis tulajdonos rendszerének kell előallítania, és minden ADV kérésekor base64 encode-olva átadnia az adservernek. Abban az esetben, ha ezek az adatok GET paraméterként adódnak át, urlencode-olni is kell őket.

:!: A customtarget string-et mindenképpen a userdb_id-val kell kezdeni.

Goa3 esetében a customtarget értékét úgy kell előállítani, hogy az átadni kívánt változókat base64 encode-olni kell, például így:

base64encode( "userdb_id=0&age=21&sex=2&hair=0")

 

Egy oldalon belül több userDB használata esetén a customtarget stringben a különböző adatbázisok értékeit egymás után kell megadni. Az azonos userDB-hez tartozó paraméterek értékei a megfelelő userdb_id-t kell kövessék.

base64encode( "userdb_id=0&age=21&sex=2&hair=0&userdb_id=1&type=1&color=2")

 

:!: A kiszolgálórendszer a customtarget értékét UTF-8 karakterkódolással kezeli, így csak akkor képes a rendszer megfelelően feldolgozni azt, ha a weboldal is ezzel a karakterkódolással küldi.

userdb_id változó értékét az Adverticum adja meg.

 

Minta XML

Az adatbázis leírását az alábbi formában kérjük leadni. Az XML fájlok frissítése hétfőnként történik, amennyiben az Adverticum részére az XML fájl legkésőbb előző szerdáig megfelelő formátumban átadásra került, és a teszteléseken is megfelel.

 

<category name="sampledb" desc="sample user database">
    <params>
     <param name="server" desc="E-mail domain">
         <value type="text"/>
     </param>
     <param name="locale" desc="Nyelvi beállítások">
         <value type="stringselect">
             <option value="hu_HU">magyar</option>
             <option value="en_EN">angol</option>
             <option value="de_DE">német</option>
         </value>
     </param>
     <param name="sex" desc="A személy neme">
         <value type="intselect">
             <option value="1">férfi</option>
             <option value="2"></option>
         </value>
     </param>
     <param name="birth_year" desc="A személy születési év">
         <value type="integer"/>
     </param>
     <param name="height" desc="A személy magassága">
         <value type="float"/>
     </param>
     <param name="occup" desc="Foglalkozás">
         <value type="text"/>
     </param>
     <param name="regdate_year" desc="A regisztráció éve">
         <value type="integer"/>
     </param>
     <param name="regdate_month" desc="A regisztráció hónapja">
         <value type="integer"/>
     </param>
     <param name="regdate_day" desc="A regisztráció napja">
         <value type="integer"/>
     </param>
     <param name="interest" desc="A személy érdeklődési köre">
         <value type="bitselect">
             <option value="0">sport</option>
             <option value="1">zene</option>
             <option value="2">politika</option>
         </value>
     </param>
    </params>
</category>

 

Beépítés

Bármely beépítési kód kiegészíthető a customtarget targetálási információkkal.:

A customtarget string átadására a goa3-mal kétféle megoldás van. Átadható az adott oldalra vonatkozóan ill. zónánként is. A customtarget stringet a goa3 kód esetében csak base64 encode-olni kell (URL encode-olni nem). A zónaszintű customtarget paraméter átadásra akkor van szükség, ha az adott oldalon egyes zónáknak plussz paramétereket kell átadni, ha a metás megoldást használják, akkor az oldalon lévő összes zóna megkapja a CT paramétert.

 

A globális/oldalankénti átadás a head-ben történik:

<html> 
<head> 
<!-- Custom targeting parameter megadása -->
 <meta name="customtarget" content="..."/> 
<!-- [...] -->

 

A zónánkénti átadás a div-en belül történik:

<div id="zone1105669" class="goAdverticum"> 
 <var class="customtarget" style="display:none;">...</var> 
</div>

 

Ajax-os beépítés esetén a customtarget használatáról itt talál példákat, míg Doc.Write-os kód esetén itt talál.

 

Egy módosított beépítési kód segítségével megoldható, hogy a paraméterként az AdServernek átadandó customtarget stringet a site domainje alá elhelyezett cookie-ból olvassuk be.

:!: A példákban “test” a cookie neve, amelyet átalakítunk customtarget alakká. Ezt tetszőlegesen módósítani lehet!

 

Goa3 beépítési kód

<script type="text/javascript" charset="utf-8" src="http://ad.adverticum.net/scripts/cookie2customtarget/cookie2customtarget.js"></script> 
<script type="text/javascript"> Cookie2CustomTarget.CreateMetaTagFromCookie("test");</script> 
<div id="zone1105669" class="goAdverticum"> </div>
<script type="text/javascript" src="http://ad.adverticum.net/g3.js"></script> 

 

Goa3 kódnál ha a site-nak van saját customtarget paramétere, és nem csak a cookie-ból jön a customtarget, akkor ez a helyes paraméterezése a CreateMetaTagFromCookie() függvénynek (ahol a [site customtarget] helyére az eddigi base64 kódolt site oldali customtarget kerül).

<script type="text/javascript" charset="utf-8" src="http://ad.adverticum.net/scripts/cookie2customtarget/cookie2customtarget.js"></script> 
<script type="text/javascript"> Cookie2CustomTarget.CreateMetaTagFromCookie("test", "[site customtarget]"); 
<div id="zone1105669" class="goAdverticum"> </div>
<script type="text/javascript" src="http://ad.adverticum.net/g3.js"></script> 
</script>

 

Ajax-os és Doc.Write-os beépítési kód esetén is használható ez a módszer. Arra kell figyelni, hogy a CreateMetaTagFromCookie mindenképp a g3.js előtt fusson le.

(0 szavazat)
Ez a bejegyzés hasznos volt
Ez a bejegyzés nem volt hasznos

Hozzászólások (0)
Help Desk Software by Kayako case