Hromadné nahrání identifikátorů do segmentů publika

Můžete vytvořit soubor s identifikátory a nahrát ho do služby Google Ad Manager prostřednictvím služby Google Cloud. Nahrát lze tyto typy identifikátorů: soubory cookie, mobilní inzertní ID (AdID nebo IDFA) a PPID. Nahráním prostřednictvím služby Google Cloud ušetříte čas, pokud potřebujete nahrát mnoho identifikátorů najednou.

Tento článek pojednává o následujících tématech:

• Předpoklady
• Vytvoření souboru k nahrání
• Hromadné smazání identifikátorů
• Nahrání souboru
• Vypršení členství hromadně nahraných identifikátorů
• Doporučené postupy při hromadném nahrávání

Předpoklady

Před nahráním identifikátorů proveďte ve spolupráci se správcem účtu následující úkony:

• Vyhledejte a odešlete kód sítě. Kód své sítě naleznete ve službě Ad Manager v sekci Administrátor, poté Globální nastavení a poté Kód sítě.
• Vytvořte aktivní segment publika první strany, ke kterému chcete identifikátory přiřadit. Pokud nechcete, aby tento segment shromažďoval uživatele pomocí vašeho vlastního inventáře, vyberte metodu vyplňování Spravováno majitelem stránek.
  Poznámka: Po vytvoření segmentu může trvat až 24 hodin, než budete moci hromadné nahrání provést.
  Tip: V názvech souborů hromadného nahrávání můžete používat pouze znaky ASCII. U názvů souborů, které obsahují trojité podtržítko (___), nebudou výsledky uvedeny správně.

  Přečtěte si další informace o omezeních názvů souborů podle doporučení pro pojmenování objektů v Cloud Storage.
• Vytvořte skupinu Google, která bude obsahovat všechny účty Google s přístupem k nahrávání a zobrazení souborů.

Jakmile správce účtu toto nastavení dokončí, budete moci vytvořit soubor s identifikátory, které chcete nahrát.

Vytvoření souboru k nahrání

Povinná značka souhlasu

Všichni majitelé stránek musí provést takové změny, aby do služby Ad Manager předávali požadované signály souhlasu.

Na znamení, že byl získán souhlas, přidejte do záhlaví všech nahraných souborů štítek process_consent. Aby řádky odpovídaly standardu CSV, musejí pro tento sloupec záhlaví obsahovat hodnoty. Tyto hodnoty však nebudou mít vliv na zpracování. Doporučujeme použít prázdný řetězec. U souborů bez této fráze se bude předpokládat, že nemají řádný souhlas od uživatelů, a Google je nebude zpracovávat.

Tato aktualizace je povinná:

• Pro všechny uživatele bez ohledu na lokalitu (jako technický požadavek).
• Pro uživatele z EU/EHP, aby byly dodrženy zásady pro souhlas uživatele z EU a bylo možné pokračovat ve vytváření segmentů publika pro uživatele z Evropského hospodářského prostoru (EHP).

Identifikátory

Proces hromadného nahrání podporuje několik různých typů identifikátorů. Každý typ identifikátorů je do segmentu potřeba nahrát pomocí souboru ve správném formátu. Tyto identifikátory spadají do dvou kategorií:

• šifrované identifikátory: vše, co jste získali ze systémů Google,
• nezašifrované identifikátory: identifikátory získané z externího systému nebo zdroje.

Šifrované identifikátory se nahrávají pomocí souborů ve formátu cookie_encrypted, u nezašifrovaných identifikátorů se formát souboru liší podle typu identifikátoru.

Šifrované identifikátory a PPID jsou specifické pro síť. Identifikátory PPID či šifrované identifikátory získané z jedné sítě proto nelze nahrát do jiné sítě. Identifikátor uživatele získaný z přehledu Přenosu dat sítě A tedy nelze hromadně nahrát do sítě B. Identifikátory zařízení naopak nejsou specifické pro konkrétní síť.

V následující tabulce jsou popsány dostupné identifikátory a způsob jejich nahrání:

Pomocí textového editoru vytvořte soubor ve formátu prostého textu, uložte jej a dejte mu libovolný název. Při uložení můžete použít libovolnou příponu souboru, nebo také žádnou.

Požadavky na obsah souboru

• Zajistěte, aby byl obsah souboru oddělen čárkami.
• Na prvním řádku musí být podle typu identifikátorů uveden jeden z následujících řetězců:
  • Šifrované soubory cookie a šifrované identifikátory z přehledů Přenosu dat (pouze Google Ad Manager 360): cookie_encrypted,list_id,process_consent
  • Nešifrovaná IDFA Apple: cookie_idfa,list_id,process_consent
  • Nešifrovaná AdID Android: cookie_adid,list_id,process_consent
  • Nešifrovaná PPID: ppid,list_id,process_consent
  • Nešifrovaná Roku ID: cookie_rida,list_id,process_consent
  • Nešifrovaná tvOS ID: cookie_tvos,list_id,process_consent
• Každý další řádek musí obsahovat identifikátor, čárku a poté ID segmentu publika, ke kterému má být identifikátor přidružen.
• Každý řádek musí být ukončen řetězcem LF (linefeed), který se používá jako konec řádku v Unixu, NIKOLIV řetězcem CR (carriage return). Podle toho, jakou metodou soubor k nahrání vytváříte, se typ ukončení řádku nastavuje buď v textovém editoru, nebo v programu, pomocí kterého soubor generujete.
• Šifrované identifikátory mohou majitelé stránek získat prostřednictvím přehledu Přenosu dat (pouze Google Ad Manager 360). ID segmentu publika zjistíte tak, že se přihlásíte k účtu služby Google Ad Manager a vyberete Inventář a potom Segmenty publika.
• Sloupec „process_consent“ by měl být posledním sloupcem v nahrávaném souboru.
• Buňky ve sloupci „process_consent“ mohou být ponechány prázdné. Je však důležité sloupec záhlavím „process_consent“ zahrnout.
• Velikost hromadně nahrávaných souborů nesmí přesáhnout 1 GB. Větší soubory se nemusejí zpracovat správně.

Příklad obsahu souboru se zašifrovanými ID souborů cookie:

cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,

Příklad obsahu souboru s nezašifrovanými identifikátory AdID:

cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,

Hromadné smazání identifikátorů

Identifikátory můžete hromadně smazat pomocí stejného souboru, který jste nahráli. Stačí do něj přidat sloupec s názvem „delete“ (smazat). U identifikátorů, které ze segmentu chcete smazat, do tohoto sloupce zadejte hodnotu 1. U identifikátorů, které v něm chcete ponechat, zadejte hodnotu 0.

V příkladu níže je první soubor cookie v segmentu ponechán a druhý je ze segmentu s id=3153490 odebrán.

cookie_encrypted,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,0,
w2gsrUcwxF-OiJTRmQswQA,3153490,1,

V následujícím příkladu je první identifikátor IDFA ze segmentu odebrán a druhý je v něm ponechán.

cookie_idfa,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,1,
w2gsrUcwxF-OiJTRmQswQA,3153490,0,

Každý řádek musí obsahovat tolik polí oddělených čárkou, kolik jich je uvedeno v záhlaví. Identifikátory nikdy neobsahují čárky ani jiné znaky, které nejsou konzistentní s formátem CSV.

Připomínáme, že zpracování nahraných identifikátorů může službě Google Ad Manager trvat několik hodin, ať už je přidáváte, nebo mažete. Když identifikátor přidáte, je nutné počkat, až bude zpracován. Až poté jej bude možné pomocí dalšího nahraného souboru smazat.

Nahrání souboru

Až soubor vytvoříte, bude třeba jej nahrát do segmentu Úložiště Google (podsložky jsou povoleny). K segmentům služby Ad Manager v cloudovém úložišti lze získat přístup třemi způsoby. V pořadí podle složitosti:

• Na webu: Navštivte stránku https://console.developers.google.com/storage/browser/gdfp_cookieupload_[kód sítě Ad Manager]..
• gsutil je na Pythonu založený nástroj příkazového řádku, který umožňuje interakci se segmenty v úložišti prostřednictvím příkazů podobných Unixu. Ověření pro segmenty je abstrahováno a provádí se automaticky.
• Google Cloud Storage API je úplné rozhraní API k manipulaci se segmentem úložiště dostupné prostřednictvím RESTful webových rozhraní JSON a XML. Klientské knihovny rozhraní API jsou k dispozici pro mnoho oblíbených programovacích prostředí, včetně Javy, JavaScriptu, Pythonu a Objective-C. Tento přístup je nejužitečnější, pokud se segmenty úložiště potřebujete manipulovat programaticky kvůli integraci s aplikací Google App Engine nebo webovou aplikací v jazyce Java.

V účtu Úložiště Google bude do 24 hodin vygenerován soubor protokolu se stejným názvem. Jeho přípona poskytuje informace o tom, zda byly úspěšně zpracovány všechny identifikátory v souboru.

Jestliže má váš soubor například název 1234_20130115_1, vygenerovaný soubor bude mít název 1234_20130115_1.success (úspěšné zpracování) nebo 1234_20130115_1.fail (neúspěšné zpracování). Soubor protokolu bude obsahovat počet identifikátorů, které byly zpracovány úspěšně, a podrobné chybové zprávy ohledně identifikátorů, jejichž zpracování se nezdařilo. Pokud chcete o stavu získat podrobnější informace, tento soubor protokolu si stáhněte.

Název souboru s výsledky se zobrazí v následující složce ve vašem účtu Úložiště Google:

https://console.developers.google.com/storage/gdfp_cookieupload_result_[kód sítě Ad Manager]/

Po nahrání jsou úspěšně zpracovávané identifikátory ve vašem souboru při cílení na inventář považovány za členy přidružených segmentů.

Soubor s příponou .fail nebo .success pouze uvádí, zda byl soubor úspěšně analyzován. Neposkytuje smysluplné informace o čistém nárůstu nebo poklesu velikosti seznamu. Soubor má příponu .success pouze v případě, že byly úspěšně nahrány všechny identifikátory. Ve většině případů však dojde k alespoň jedné chybě, a výstupní soubor proto obvykle mívá příponu .fail.

Vypršení členství hromadně nahraných identifikátorů

Pro identifikátory nahrané hromadně platí skončení platnosti, která jsou pro příslušný segment publika nakonfigurovaná pomocí uživatelského rozhraní služby Google Ad Manager.

Pokud je u segmentu publika nakonfigurováno, že u něj má členství vypršet za X dní, a identifikátor během X dní po nahrání nesplní kritéria členství, po X dnech členství identifikátoru v segmentu vyprší. Při každé operaci nahrání se členství v segmentu a odpočítávání doby členství pro nahrané identifikátory resetuje.

Doporučené postupy při hromadném nahrávání

Struktura souboru

Nahrávejte souborů co nejméně. Pomocí jednoho souboru lze identifikátory nahrát do několika seznamů, protože v souboru je na každém řádku uvedeno ID seznamu.

Kapacita nahrávání

Při nahrávání souborů vyžadujeme dodržení následujících limitů:

• Během 24 hodin můžete nahrát maximálně 500 souborů.
• Soubor pro hromadné nahrání nesmí být větší než 1 GB.
• Za 24 hodin lze nahrát soubory pro hromadné nahrání o celkové velikosti maximálně 5 GB.

Přírůstkové/úplné nahrání

• Z důvodu eliminace zbytečného zpracovávání doporučujeme běžně používat přírůstkové nahrávání identifikátorů. Neměli byste nahrávat úplný seznam identifikátorů v segmentu, ale pouze ty identifikátory, jejichž členství v segmentu se od posledního nahrání změnilo.
• Méně často (maximálně jednou týdně) můžete nahrát úplná data identifikátorů v segmentech. (I pro toto nahrání platí výše uvedené kapacitní limity.) Toto úplné nahrání obnoví členství v segmentech u členů, jejich členství v segmentu publika vypršelo.
  • Aktuálnost identifikátorů byste měli sledovat nějakým jiným systémem a vylučovat z obnovovacího nahrávání identifikátory, které již nepoužíváte (které by již při zobrazování reklam neměly být uváděny).

Doba zpracování

Očekávejte, že může trvat až 24 hodin, než se všechny hromadně provedené změny projeví při zobrazování reklam. Jinak řečeno, soubory je potřeba nahrát alespoň 24 hodin předtím, než budete segmenty při zobrazování reklam potřebovat.

Kromě toho může po hromadném nahrání trvat až 48 hodin, než se změny projeví v uživatelském rozhraní služby Ad Manager.