Megvalósítási útmutató a tartalomfeltérképezéshez

A hirdetést körülvevő tartalom feltérképezése minden hirdetési egységnél egyenként elvégezhető a setContentUrl() vagy a setNeighboringContentUrls() metódussal. Vegye figyelembe azonban, hogy minden hirdetési egység csak az egyik tartalomfeltérképezési módszert használhatja, a kettőt együtt nem.

A tartalomfeltérképezés használatához:

1. Telepítse a Google mobilhirdetések SDK megfelelő verzióját:
   • Android: 19.0.0 vagy újabb az AdMob, illetve 19.5.0 az Ad Manager használata esetén
   • iOS: 7.67.0-ás vagy újabb
2. Határozza meg, hogy milyen fajta tartalomfeltérképezést szeretne használni az egyes hirdetési egységekhez. 
3. Gondoskodjon róla, hogy az átadni kívánt URL-ek nyilvánosak (a feltérképező robot által hozzáférhetők). További információ arról, hogyan teheti teljes mértékben feltérképezhetővé a webhelyet az AdMob vagy az Ad Manager számára. Ne feledje, hogy az URL-nek nem szükséges hozzáférhetőnek a felhasználók számára.

A tartalom teljes és pontos feltérképezése

Gondoskodjon arról, hogy minden tartalom olyan URL-hez legyen társítva, amely rögzíti, hogy a felhasználó mit lát az alkalmazásban. Az átadott URL-nek teljes és pontos képet kell tartalmaznia a hirdetést körülvevő tartalomról.

Megjegyzés: Bár a tartalomfeltérképezéshez elfogadunk képernyőképeket az alkalmazásról, a HTML a preferált módszer.

Az alábbi példákból többet is megtudhat arról, hogy mit értünk teljességen és pontosságon.

1. példa: Teljes feltérképezés (tartalmazza a hirdetés körül található összes tartalmat)

Az Ön által átadott URL-eknek a hirdetést körülvevő tartalom teljes reprezentációját kell biztosítaniuk. Ez azt jelenti, hogy az URL-nek tartalmaznia kell minden olyan elemet, amely a hirdetés mellett található, beleértve azokat az elemeket is, amelyek a hirdetéssel azonos képernyőn jelenhetnek meg.

Az 1. ábrán egy kezdőlapon megjelenő hírcsatorna látható, amely két tartalomelemet jelenít meg: az A tartalmat és a B tartalmat, amelyek feltérképezését külön-külön kell elvégezni. Az A tartalomhoz 3 feltérképezési példát mutatunk be: két megfelelőt és egy nem megfelelőt.

Az A1 feltérképezés esetében az A tartalom feltérképezése teljes körű, mert az URL átadja a fejlécet, a képet és azt a bekezdést, amelyet a felhasználó közvetlenül a hirdetés felett lát. Ez a feltérképezés teljes mértékben megegyezik a felhasználó által az alkalmazásban látott tartalommal.

Az A2 feltérképezésben az A tartalom feltérképezése „még teljesebb”, mivel az URL átadja a bekezdés teljes változatát (például a hírcsatorna egy hír összegzését jeleníti meg, de Ön átadhatja a teljes cikket is). Az összes információ továbbítása a legjobb módszer a hirdetést körülvevő tartalom teljes körű reprezentációjának biztosításához.

Az A3 feltérképezésben az A tartalom feltérképezése nem teljes, mivel az URL csak a fejlécet és azt a bekezdést adja át, amelyet a felhasználó közvetlenül a hirdetés felett lát. Ez a feltérképezés nem tartalmazza a képet, így nem reprezentálja teljes mértékben a hirdetést körülvevő tartalmat.

Megjegyzés: Nem adhat át személyazonosításra alkalmas adatokat és olyan információkat, amelyek sértik a felhasználókkal kötött adatvédelmi megállapodást. Az AdMob és az Ad Manager esetében eltávolíthatja a Google-nak elküldött tartalmi URL-ekből származó személyazonosításra alkalmas adatokat (például teljes neveket, e-mail-címeket vagy földrajzihely-paramétereket).

 

Az alkalmazás tartalmának teljes és pontos feltérképezésére van szükségünk, azonban a tartalom URL-jeinek elküldése előtt a személyazonosításra alkalmasnak minősülő összes adatot eltávolíthatjuk vagy egyedi azonosítóval lehet helyettesíteni.

^{1. ábra}

A B tartalom feltérképezése ugyanazt a mintát követi, mint az A tartalomé.

2. példa – Pontos feltérképezés

Az átadott URL-eknek pontosan kell reprezentálniuk a hirdetést körülvevő tartalmat. Ne feledje, hogy a tartalom csak akkor lehet pontos, ha teljes.

A 2. ábrán ismét megpróbáljuk feltérképezni a kezdőlap hírcsatornáját. Most két példát mutatunk be az A tartalomhoz a hírcsatornában végzett feltérképezésre.

Az A1 feltérképezésben az A tartalom feltérképezése pontos, mert az alkalmazás tartalmának megfelelő elemeket küldi át.

Az A2 feltérképezésben az A tartalom feltérképezése nem pontos, mert a Z tartalmat térképezzük fel, amely nem kapcsolódik az A tartalomhoz. Ez nem biztosítja a hirdetést körülvevő tartalom pontos ábrázolását.

^{2. ábra}

Példák a használati esetekre

A legjobb teljesítmény elérése érdekében fontos, hogy olyan URL-eket adjon át, amelyek részletesen leírják a felhasználók által a hirdetés körül látott tartalmakat. Elsőként a megjelenített hirdetés típusát kell figyelembe vennie annak lehető legpontosabb meghatározásához, hogy milyen URL-t vagy URL-eket adjon át a tartalomfeltérképezéshez.

A következő használati esetek például szolgálnak ahhoz, hogy meghatározhassa: hogyan alkalmazható a tartalomfeltérképezés.

Szalaghirdetések

Szalaghirdetés egyetlen oldalon

A szalaghirdetések az alkalmazás tartalmának egyetlen oldalán jelenhetnek meg, például egy hírben.

Ebben a példában a szalaghirdetés egyetlen oldalon van megvalósítva, a környező tartalom pedig statikus. Ez azt jelenti, hogy a tartalom csak egyetlen URL-en adható át. 

Ebben az esetben a setContentURL() metódussal adhat át egyetlen URL-t a hirdetési kérelem betöltése előtt.

Szalaghirdetés rögzítése egy oldalon

A rögzített szalaghirdetések mindig megjelennek a képernyőn, amikor a felhasználó görget, és a képernyő tetejéhez vagy aljához vannak rögzítve.

Ebben a példában a rögzített szalaghirdetés egyetlen oldalon van megvalósítva, a környező tartalom pedig statikus. Ez azt jelenti, hogy a tartalom csak egyetlen URL-en adható át. Az oldalon esetlegesen megtalálható összes tartalmat el kell küldenie, miközben a rögzített szalaghirdetés látható marad.

Ebben az esetben a setContentURL() metódussal adhat át egyetlen URL-t a hirdetési kérelem betöltése előtt.

Szalaghirdetés rögzítése a feedben 

A rögzített szalaghirdetések mindig megjelennek a képernyőn, amikor a felhasználó görget, és a képernyő tetejéhez vagy aljához vannak rögzítve.

Ebben a példában a rögzített szalaghirdetés egy feedben van megvalósítva. Ha olyan képernyőn helyez el rögzített szalaghirdetést, amelyen több tartalom is szerepel, akkor a hirdetést körülvevő minden egyes tartalomelemhez (legfeljebb 4 URL-hez) át kell adnia egy-egy URL-t. Az oldalon esetlegesen megtalálható összes tartalmat el kell küldenie, miközben a rögzített szalaghirdetés látható marad.

Ebben az esetben a hirdetési kérelem betöltése előtt használja a setNeighboringContentUrls() metódust.

Natív hirdetések

Natív hirdetés (a képernyő egy részét elfoglaló) tartalom között

A natív hirdetések illeszkednek az alkalmazás felhasználói élményéhez és vizuális kialakításához. A natív hirdetések az alkalmazás képernyőjének egy részét foglalják el, és különböző tartalmak között jelenhetnek meg (például cikkek vagy bevásárlólisták között), miközben a felhasználó görget vagy lapoz. 

Ebben a példában a natív hirdetés az alkalmazás tartalmával egy vonalban jelenik meg, miközben a felhasználó görget. Ez azt jelenti, hogy a hirdetés előtt és után más tartalom jelenik meg. 

Ha a natív hirdetést így implementálja, akkor át kell adnia a hirdetés előtt és után megjelenő tartalom URL-jeit. Ebben az esetben a hirdetési kérelem betöltése előtt használja a setNeighboringContentUrls() metódust.

Megjegyzés: Ha a hirdetésmegvalósításban kettőnél több tartalom jelenik meg a hirdetés közelében, akkor ezeket az URL-eket is át kell adnia. Legfeljebb négy olyan URL-t adhat át, amelyek a hirdetés mellett a képernyőn megjelenő összes többi tartalomelemet jelölik.

Natív hirdetés (teljes képernyő) a tartalmak között

A natív hirdetések illeszkednek az alkalmazás felhasználói élményéhez és vizuális kialakításához. A natív hirdetések elfoglalhatnak teljes képernyőt, és az alkalmazás tartalmai között jelenhetnek meg, miközben a felhasználó görget vagy csúsztat. 

Ebben a példában a natív hirdetés két különböző tartalom között jelenik meg, miközben a felhasználó görget. Ha a natív hirdetést így implementálja, akkor át kell adnia a hirdetés előtt és után megjelenő tartalom URL-jeit. 

Ebben az esetben a hirdetési kérelem betöltése előtt használja a setNeighboringContentUrls() metódust.

Megjegyzés: Ha a hirdetésmegvalósításban kettőnél több tartalom jelenik meg a hirdetés közelében, akkor ezeket az URL-eket is át kell adnia. Legfeljebb négy olyan URL-t adhat át, amelyek a hirdetés mellett a képernyőn megjelenő összes többi tartalomelemet jelölik.

Íme egy másik példa, amelyen a natív hirdetés látható, miközben egy felhasználó csúsztatja az ujját. Függetlenül attól, hogy a felhasználó hogyan görget, a natív hirdetés előtt és után is át kell adnia a tartalmat.

Közbeiktatott hirdetések

Közbeiktatott hirdetés egyetlen oldalon

A közbeiktatott hirdetések akár a teljes képernyőt is elfoglalhatják, miközben a felhasználó egy oldalon van, például egy vásárlási alkalmazásban tekinti meg a termékadatokat. 

Ebben a példában a közbeiktatott hirdetés egyetlen oldalon van megvalósítva, a környező tartalom pedig statikus. Ez azt jelenti, hogy a tartalom csak egyetlen URL-en adható át. 

Ebben az esetben a setContentURL() metódussal adhat át egyetlen URL-t a hirdetési kérelem betöltése előtt.

Közbeiktatott hirdetés tartalmak között

A közbeiktatott hirdetések elfoglalhatják a teljes képernyőt, miközben a felhasználó a tartalmak között navigál, például miközben a felhasználó az alkalmazás részei között vált. 

Ebben a példában a közbeiktatott hirdetés különböző tartalmi oldalak között jelenik meg. Ha a közbeiktatott hirdetést így implementálja, át kell adnia a hirdetés előtt és után megjelenő tartalom URL-jeit. 

Ebben az esetben a hirdetési kérelem betöltése előtt használja a setNeighboringContentUrls() metódust.

Megjegyzés: Ha a hirdetésmegvalósításban kettőnél több tartalom jelenik meg a hirdetés közelében, akkor ezeket az URL-eket is át kell adnia. Legfeljebb négy olyan URL-t adhat át, amelyek a hirdetés mellett a képernyőn megjelenő összes többi tartalomelemet jelölik.

Jutalommal járó hirdetések

A jutalommal járó hirdetések lehetővé teszik, hogy alkalmazáson belüli elemekkel jutalmazza a hirdetéssel interakcióba lépő felhasználókat. Például a felhasználók jutalommal járó hirdetések videójának megtekintésével feloldhatnak egy fizetőfal mögötti újságcikket. 

Ebben a példában a jutalommal járó hirdetés egyetlen oldalon jelenik meg (például amikor a felhasználó egy hír előnézetét tekintette meg, és a jutalommal járó hirdetéssel interakcióba lépett a teljes cikk feloldásához). 

Ebben az esetben a tartalom egyetlen URL-en adható át a setContentURL() metódus segítségével. 

Alkalmazásmegnyitási hirdetések

Az alkalmazásmegnyitási hirdetések az alkalmazás betöltőképernyőjén jelennek meg, amikor a felhasználó megnyitja az alkalmazást, vagy visszavált rá. 

Ebben a példában az alkalmazásmegnyitási hirdetés egyetlen oldalon van megvalósítva, a környező tartalom pedig statikus. Ez azt jelenti, hogy a tartalom csak egyetlen URL-en adható át. 

Ebben az esetben a setContentURL() metódussal adhat át egyetlen URL-t a hirdetési kérelem betöltése előtt.

URL-re vonatkozó követelmények

A tartalomfeltérképezéshez használni kívánt URL-ek kiválasztásakor az alábbiakat vegye figyelembe:

• Az URL-eknek mindig meg kell egyezniük a felhasználó által az alkalmazásban látott tartalommal. További információ a megtévesztő tartalmakra vonatkozó irányelveinkről.
• Ne adjon át személyazonosításra alkalmas adatokat és olyan információkat, amelyek sértik a felhasználókkal kötött adatvédelmi megállapodást.
  • A Google-nak küldött tartalmi URL-ekből eltávolíthat minden személyazonosításra alkalmas adatot (például teljes nevet, e-mail-címet, földrajzihely-paramétert). Az alkalmazás tartalmának teljes és pontos feltérképezésére van szükségünk, azonban a tartalom URL-jeinek elküldése előtt a személyazonosításra alkalmasnak minősülő összes adatot eltávolíthatjuk vagy egyedi azonosítóval lehet helyettesíteni.
• A Google-nak fel kell tudnia térképezni az URL-eket.
  • Ha a tartalom megtekintéséhez be kell jelentkezni, kövesse a robotok bejelentkezésének konfigurálására vonatkozó utasításokat. 
• Az URL-eket nem szabad rövidíteni (például: goo.gl/MyContent).
• Az URL-eknek egyedi módon azonosítaniuk kell a felhasználó által az alkalmazásban látott tartalmat.
  • Ne adjon meg egyetlen általános, az egész alkalmazáshoz használt URL-t.
  • Ne adja át az alkalmazás Play Áruházban, App Store-ban vagy más alkalmazásboltban megjelenő oldalának URL-címét.
  • Ne fűzzön hozzá felesleges URL-paramétereket vagy követőazonosítókat.
• Ha számítógépre optimalizált (például example.com) és külön mobilwebhellyel (például m.example.com) is rendelkezik, válassza azt az URL-t, amely az alkalmazástartalom legteljesebb reprezentációját biztosítja. 

Ne használja a tartalomfeltérképezést, ha az Ön tartalmai nem szerepelnek a használati esetekre adott példákban. Ha az implementáció nem szerepel a leírásunkban, ezt a visszajelző űrlapot kitöltve mutathatja be nekünk.