This article has been updated in alignment with upcoming changes to Audience Solutions.
To adhere to the EU user consent policy and continue creating audience segments globally, publishers using batch upload must make updates to pass the required consent signals to Ad Manager by March 2024.
Vegye fel a kapcsolatot a megjelenítői ügyfélszolgálattal vagy az értékesítési csapattal a Közönségmegoldások szolgáltatás aktiválásához. Ők aktiválják a megadott listákat, ami ahhoz vezethet, hogy a megjelenítők később látják csak meg a közönségszegmenseket.
Készíthet egy azonosítókat tartalmazó fájlt, amelyet feltölthet a Google Ad Managerbe a Google Cloud szolgáltatáson keresztül. A feltöltéshez használható azonosítók közé tartoznak a cookie-k, a mobilhirdetési azonosítók (AdID vagy IDFA) és a PPID-k. Ha egyszerre sok azonosítót kell hozzáadnia, a Google Cloud szolgáltatáson keresztüli feltöltéssel időt takaríthat meg.
A cookie-k, a PPID-k és az eszközök hirdetési azonosítói csak akkor adhatók hozzá a kívánt szegmenshez, ha már részei valamelyik Ad Manager-hirdetéskérelemnek. A titkosított azonosítók listáját letöltheti az Adatátvitel-jelentésekkel (csak a Google Ad Manager 360 esetében), illetve lekérheti a nyers azonosítókat más rendszerekből (pl. az eszközök nyers hirdetési azonosítóit a mobilalkalmazás naplóiból).
A PPID-k maximális élettartama a kötegelt feltöltésnél 180 nappal az utolsó felhasználói tevékenység, illetve az utolsó aktivitás utánig tart. Eszközazonosítók esetén a maximális érték 540 nappal a létrehozást követően, azaz 540 nappal az eszköz első megjelenítése után értendő.
Vegye figyelembe, hogy az eseményping alapú kitöltési mód (pl. eseményregisztráció, előzetes kitöltés) és a cookie-feltöltés alapú kitöltési mód (azaz a megadott CSV-listák) használata ütközést eredményezhet, amelynek hatására az eltávolított PPID-k végül nem jelennek meg teljesen kizártként.
Ez a cikk a következő témákkal foglalkozik:
- Előfeltételek
- A feltöltési fájl létrehozása
- Azonosítók tömeges törlése
- Fájl feltöltése
- A tömegesen feltöltött azonosítók lejárata
- Bevált módszerek a csoportos feltöltéshez
Előfeltételek
Ahhoz, hogy feltölthesse az azonosítókat, fiókkezelője segítségével hajtsa végre a következőket:
- Keresse meg és küldje el a hálózati kódot. A hálózati kódot az Ad Manager Adminisztrálás, Globális beállítások, végül Hálózati kód menüpontjában találja.
- Győződjön meg arról, hogy létrehozta az aktív belső közönségszegmenst, amelyhez az azonosítókat kívánja társítani. Ha nem szeretné, hogy ez a szegmens a saját készletének használatával gyűjtsön felhasználókat, válassza a „Megjelenítő által kezelt” lehetőséget kitöltési módként.
Úgy számoljon, hogy a szegmens létrehozásától számítva akár 24 órát is várnia kell, hogy el tudja végezni a tömeges feltöltést. - Hozzon létre egy olyan Google-csoportot, amely a fájlok feltöltésére és megtekintésére engedéllyel rendelkező összes Google-fiókot tartalmazza.
Miután a fiókkezelő elvégezte a beállításokat, Ön létrehozhatja a feltölteni kívánt azonosítókat tartalmazó fájlt.
.fail fájlokban: „Could not find the
<type of identifier> in our server, retry is not helpful” (Az <azonosítótípus> nem található a szerverünkön, az újrapróbálkozás nem segít).A feltöltési fájl létrehozása
Szükséges beleegyezési címke
Minden megjelenítőnek módosításokat kell végeznie ahhoz, hogy az Ad Manager megkapja a szükséges hozzájárulási jeleket.
A begyűjtött beleegyezés megerősítéséhez adja hozzá a process_consent címkét a feltöltött fájlok fejlécéhez. A soroknak tartalmazniuk kell értékeket ehhez a fejlécoszlophoz a CSV-szabványoknak való megfelelés érdekében, de ezek nincsenek hatással a feldolgozásra. Javasoljuk, hogy üres karakterláncot adjon meg. Az olyan fájlokról, amelyekből hiányzik ez a kifejezés, feltételezzük, hogy nem rendelkeznek a felhasználók megfelelő beleegyezésével, és a Google nem fogja feldolgozni őket.
Erre a frissítésre van szükség:
- Technikai követelményként minden felhasználó számára, tartózkodási helytől függetlenül.
- Az EU-beli és az EGT-beli felhasználókhoz, hogy be lehessen tartani az EU-beli felhasználók hozzájárulására vonatkozó irányelveket, és folytatni lehessen a közönségszegmensek létrehozását az Európai Gazdasági Térségben (EGT) élő felhasználók számára.
Az azonosítók
A tömeges feltöltési folyamat többféle azonosítótípust támogat, ezért fontos, hogy az azonosítótípusok a megfelelő feltöltési fájlformátumban legyenek feltöltve a szegmensbe. Ezek az azonosítók két kategóriába sorolhatók:
- Titkosított azonosítók: bármi, amit a Google rendszereiből szereztek be
- Nyers azonosítók: külső rendszerből vagy forrásból származnak
A titkosított azonosítók feltöltése a cookie_encrypted fájlformátumban, míg a nyers azonosítóké a típustól függő feltöltési fájlformátumban történik.
A titkosított azonosítók és PPID-k hálózatonként eltérnek. Ezért nem adhat át PPID-ket vagy titkosított azonosítókat az egyik hálózattól a másiknak tömeges feltöltéssel. Az „A” hálózat Adatátvitel-jelentéséből származó felhasználói azonosítót például a tömeges feltöltés használatával nem töltheti fel „B” hálózatba. Az eszközazonosítók ezzel szemben nem térnek el hálózatonként.
Az alábbi táblázat tartalmazza a rendelkezésre álló azonosítókat és a feltöltésük módját:
| Azonosító | Leírás | Forrás | Feltöltés mint |
|---|---|---|---|
| Cookie | Cookie-azonosítók | AdatátvitelUserId |
cookie_encrypted |
| Nyers (külső forrás) | – (a cookie-t titkosítani kell a feltöltéshez) | ||
| PPID | Megjelenítő által biztosított azonosítók | AdatátvitelPublisherProvidedID |
cookie_encrypted |
| Nyers (külső forrás) | ppid |
||
| IDFA | A hirdetés azonosítója | AdatátvitelUserId |
cookie_encrypted |
| Nyers (külső forrás) | cookie_idfa |
||
| AdID | Android TV-azonosítók | AdatátvitelUserId |
cookie_encrypted |
| Nyers (külső forrás) | cookie_adid |
||
| Roku ID | Roku-azonosítók | AdatátvitelUserId |
cookie_encrypted |
| Nyers (külső forrás) | cookie_rida |
||
| tvOS ID | Apple TV-azonosítók | AdatátvitelUserId |
cookie_encrypted |
| Nyers (külső forrás) | cookie_tvos |
||
| Vizio IFA | Vizio-azonosítók | AdatátvitelUserId |
cookie_encrypted |
| Nyers (külső forrás) | cookie_vida |
||
| Samsung TIFA | Samsung-azonosítók | AdatátvitelUserId |
cookie_encrypted |
| Nyers (külső forrás) | cookie_tifa |
Szövegszerkesztővel hozzon létre egy egyszerű szöveges fájlt, és mentse el tetszőleges névvel. A fájlt bármilyen kiterjesztéssel, de fájlkiterjesztés nélkül is elmentheti.
A Google Cloud fájlnevei nyilvánosak. A fájlnév ne tartalmazzon bizalmas adatokat.
A fájltartalommal kapcsolatos követelmények
- A fájlban lévő tartalmakat vesszővel kell elválasztani egymástól.
- Az első sornak a következőnek kell lennie:
- A titkosított cookie-k és (csak a Google Ad Manager 360-nál) az Adatátviteli jelentésekből származó titkosított azonosítók esetében:
cookie_encrypted,list_id,process_consent - A nyers Apple IDFA-k esetében:
cookie_idfa,list_id,process_consent - A nyers Android AdID-k esetében:
cookie_adid,list_id,process_consent - A nyers PPID-k esetében:
ppid,list_id,process_consent - A nyers Roku ID-k esetében:
cookie_rida,list_id,process_consent - A nyers tvOS-azonosítók esetében:
cookie_tvos,list_id,process_consent
- A titkosított cookie-k és (csak a Google Ad Manager 360-nál) az Adatátviteli jelentésekből származó titkosított azonosítók esetében:
- Az egymást követő egyes sorok tartalmának a következőképpen kell felépülnie: egy azonosító, egy vessző és annak a közönségszegmensnek az azonosítója, amelyhez az azonosítót társítani kell.
- Minden sornak a Unix jellegű sorvégződést, a soremelést (
LF) kell használnia, NEM pedig a kocsi vissza (CR) vezérlőkaraktert. A feltöltési fájl létrehozására szolgáló módszertől függően a sorvégződés típusa a szövegszerkesztőben vagy a fájlt létrehozó programban van meghatározva. - A megjelenítők a titkosított azonosítókhoz az Adatátvitel-jelentésen keresztül férhetnek hozzá (csak a Google Ad Manager 360 esetében). A közönségszegmens azonosítóját úgy tekintheti meg, hogy bejelentkezik Google Ad Manager-fiókjába, majd a Készlet, majd a Közönségszegmensek szakaszhoz navigál.
- A „process_consent” oszlopnak kell a feltöltött fájl utolsó oszlopának lennie.
- A „process_consent” oszlop cellái üresen maradhatnak. Fontos azonban, hogy a „process_consent” értékkel rendelkező oszlopot használja fejlécként.
- A csoportos feltöltési fájl mérete nem lehet nagyobb, mint 1 GB. Az ennél nagyobb fájlok feldolgozása sikertelen lehet.
Példa – fájltartalom titkosított cookie-azonosítók esetében:
cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,
Példa – fájltartalom nyers AdID-k esetében:
cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,
Azonosítók tömeges törlése
Egy „delete” (törlés) nevű oszlop hozzáadásával az azonosítók tömeges törléséhez is ugyanaz a feltöltési fájl felhasználható. A szegmensből törölni kívánt azonosítók mellé írja a delete oszlopba, hogy 1, a szegmensben megőrizni kívánt azonosítók mellé pedig azt, hogy 0.
1 vagy 0 szerepel. Másként a feltöltés sikertelen lesz.Az alábbi példában az első cookie a szegmensben marad, a második cookie-t azonban leválasztja a rendszer az id=3153490 azonosítójú szegmensről.
cookie_encrypted,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,0,
w2gsrUcwxF-OiJTRmQswQA,3153490,1,
A következő példában az első IDFA-t a rendszer leválasztja a szegmensről, a második IDFA pedig a szegmensben marad.
cookie_idfa,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,1,
w2gsrUcwxF-OiJTRmQswQA,3153490,0,
Minden sornak annyi, vesszővel elválasztott mezőt kell tartalmaznia, ahány a fejlécben is van. Ügyeljen arra, hogy az azonosítók soha ne tartalmazzanak a CSV-formátummal össze nem egyeztethető vesszőt vagy más karaktert.
Felhívjuk figyelmét arra, hogy több órát is igénybe vehet, amíg az Ad Manager feldolgozza az azonosítófeltöltéseket, akár hozzáadásról, akár törlésről legyen szó. Ahhoz, hogy a feltöltött azonosítót egy következő feltöltés alkalmával törölni tudja, meg kell várnia az azonosító feldolgozását.
Fájl feltöltése
Miután létrehozta a fájlt, fel kell töltenie a Google Storage-csoportba (almappákat létre lehet hozni). Háromféle módon férhet hozzá az Ad Manager felhőtárhelyének csoportjaihoz. A legegyszerűbbtől kezdve:
- A weben: Keresse fel a
https://console.developers.google.com/storage/browser/gdfp_cookieupload_[Ad Manager hálózati kód]/oldalt. - A gsutil Python-alapú parancssori eszközzel, amely Unix-szerű parancsokat biztosít a tároló csoportjainak használatához. A csoport hitelesítésének kivonatolása és kezelése automatikusan történik.
- A Google Cloud Storage API-val, amely teljes értékű API a tároló csoportjainak kezeléséhez, és amely JSON vagy XML RESTful webes kezelőfelületek segítségével használható. Az API klienskönyvtárai számos népszerű programozási környezetben hozzáférhetők, beleértve a Javát, a JavaScriptet, a Pythont és az Objective-C nyelvet. Ez a megközelítés akkor hasznos igazán, ha a tároló csoportjait automatizált módon kell kezelnie a Google App Engine alkalmazás vagy valamelyik Java-alapú internetes alkalmazás integrálása érdekében.
A rendszer 24 órán belül a fájllal azonos nevű, az összes azonosító feldolgozásának sikerességét vagy sikertelenségét a nevében utótaggal jelző naplófájlt hoz létre az Ön Google Storage-fiókjában.
Például ha a fájl neve 1234_20130115_1, akkor a rendszer által létrehozott fájl neve siker esetén 1234_20130115_1.success, sikertelenség esetén pedig 1234_20130115_1.fail lesz. A fájl felsorolja a sikeresen feldolgozott azonosítók számát, a nem feldolgozható azonosítók esetében pedig részletes hibaüzenetet is tartalmaz. A naplófájl letöltésével részletesebb állapotinformációkhoz juthat.
Az eredményül kapott fájlnév a Google Storage-fiók következő mappájában fog megjelenni:
https://console.developers.google.com/storage/gdfp_cookieupload_result_[Ad Manager hálózati kód]/
Feltöltésük után a fájlban lévő, sikeresen feldolgozott azonosítókat a rendszer a hozzájuk társított szegmensek tagjaiként kezeli a készletcélzás során.
A .fail, illetve .success végű fájl csak azt jelzi, hogy sikeres volt-e a fájl szintaktikai elemzése. Nem tartalmaz használható adatokat a lista méretének nettó növekedéséről, illetve csökkenéséről. A fájl neve csak akkor tartalmazza a .success végződést, ha minden egyes azonosító feltöltése sikeres volt. A legtöbb esetben azonban legalább előfordul legalább egy hiba, ezért a kimeneti fájl végződése általában .fail.
A tömegesen feltöltött azonosítók lejárata
A tömeges feltöltési művelet részeként feltöltött azonosítók alkalmazkodnak az Ad Manager kezelőfelületén a közönségszegmensben megadott lejárati beállításokhoz.
Ha a közönségszegmens lejárata X napra van állítva, az azonosító pedig nem teljesíti a szegmens tagsági feltételeit a feltöltést követő X napon belül, akkor az X nap leteltét követően lejár a közönségszegmensben. Minden feltöltési művelet visszaállítja a szegmenstagságot és a lejárati idő visszaszámlálását a feltöltött azonosítók esetében.
Bevált módszerek a csoportos feltöltéshez
Fájlstruktúra
Csökkentse minimálisra a feltöltött fájlok számát. Ne feledje, hogy egy fájlt is használhat az azonosítók több listába történő feltöltésére, mivel a listaazonosító a fájl minden sorában meg van adva.
Feltöltési áteresztőképesség
Kérjük, tartsa be az alábbi korlátozásokat a fájlok feltöltésekor:
- 24 órás időablakonként legfeljebb 500 fájlt tölthet fel.
- A csoportosan feltöltött fájlok mérete legfeljebb 1 GB legyen.
- 24 órán belül összesen legfeljebb 5 GB-nyi csoportosan feltöltött fájlt töltsön fel.
Növekményes/teljes feltöltések
- A felesleges feldolgozás elkerülése érdekében általános gyakorlatként azt javasoljuk, hogy növekményes (delta) feltöltést használjon az azonosítók esetében. Csak olyan azonosítókat adjon hozzá vagy töröljön, amelyek szegmensbeli tagsága megváltozott az utolsó feltöltés óta; ne töltse fel a szegmens azonosítóinak teljes listáját.
- Ritkábban – legfeljebb hetente egyszer – a szegmens azonosítóira vonatkozó adatok teljes feltöltését is elvégezheti (de erre is érvényesek a fent leírt áteresztőképesség-korlátozások). A teljes feltöltés frissíti az összes olyan tag szegmenstagságát, amely korábban lejárt a közönségszegmensben.
- Érdemes egy másik rendszeren keresztül figyelemmel kísérni az azonosítók „frissességét”, ezenkívül kidolgozni egy módszert az abbahagyott (azaz várhatóan többé nem megjelenített) azonosítók kizárására a frissítésből.
Feldolgozási idő
Úgy számoljon, hogy a tömeges feltöltés időpontjától számítva akár 24 órát is várnia kell, amíg az összes módosítás tükröződni fog a hirdetésmegjelenítésben. Azaz legalább 24 órával az előtt töltse fel a fájlokat, mielőtt szüksége lenne a szegmensekre a megjelenítéshez.
Ezenkívül számoljon úgy, hogy a csoportos feltöltéstől számítva akár 48 órát is várnia kell, amíg a módosítások tükröződni fognak az Ad Manager kezelőfelületén.
