adserving – H3.0 wiki

Propojení H3.0 s Google Campaign Manager 360 2024 – část 1 – loginy

Osvěžili jsme napojení na adserving od Google, dříve zvaný DoubleClick Campaign Manager, nyní známý pod názvem Google Campaign Manager 360 (GCM)

V tomto návodu si řekneme, jak zadat do H3.0 loginy do GCM, aby bylo možné z H3.0 do GCM přistupovat a tahat z něj statistiky ať již pro samostatné zobrazení, nebo do postbuy kampaní.

Vesměs půjde o následující 3 kroky:

v Google Consoli si vytvoříme API napojení a API uživatele
tomuto API uživateli dáme přístup do GCM
H3.0 napojíme na Google Consoli API

Krok 1 – napojení API v Google Consoli

běžte na https://console.cloud.google.com/ a založte nový projekt, stačí vyplnit akorát jméno

Do vytvořeného projektu se přepněte (SELECT PROJECT) buď odkazem zobrazeným po jeho vytvoření, nebo jeho vybráním v PullDown menu vlevo nahoře
ve vytvořeném projektu musíme nyní aktivovat GCM API, běžte tedy přes hamburger menu do APIs & Services / Library

vyhledejte “campaign manager” a vyberte “Campaign Manager 360 API”

klikněte na tlačítko ENABLE

nyní potřebujeme vytvořit přístupy = Credentials. Klikněte na odkaz CREATE CREDENTIALS, objevil se vám jako tlačítko v pravé části, nebo běžte přes znémé hamburger menu / APIs & Services / Credentials

pro náš účel potřebujeme takzvané Service account credentials, tedy založíme nový Service account kliknutím na Manage service accounts

klikněte na tlačítko CREATE SERVICE ACCOUNT v horní části

a poté stačí vyplnit akorát jméno tohoto Service accountu a potvrdit kliknutím na tlačítko DONE
zobrazí se vám založený Service account

ve sloupci E-mail máte e-mail service accountu. Ten si zkopírujte, nechte si v jednom okně tuto stránku Console otevřenou a v jiném okně běžte do GCM 360
V GCM 360 přidejte práva přístupu k reklamnímu účtu co chcete napojit na H3.0 přávě na tento e-mail Service accountu. Je to levé menu Admin / User profiles – New. Vyplňte e-mail ze Service accountu a pod user role vyberte Agency Media Planner.

nově vytvořeného uživatele v GCM uložte, nechte si okno s GCM ještě otevřené a nyní pojďme do H3.0
v Administrace/Nastavení/Propojení s ostatními systémy nascrollujte dolů k oddílu Google Campaign Manager 360 a klikněte na tlačítko Nový

V objevivším okně dejte do kolonky E-mail (service account) onen e-mail ze Service accountu, kterů jsme právě přidávali do GCM.
Vyplňte i Název loginu (libovolně) a v případě, že chcete, aby k loginu měli přístup všichni uživatelé systému, zaškrtněte přepínátko “Veřejné”
nyní si přepněte zpět do GCM, které snad máte stále v Admin / User profiles. Najděte řádek s naším vloženým Service account uživatelem a nakopírujte si číslo, které je hned napravo od e-mailu tohoto uživatele v řádce s informacemi o uživateli.

Toto číslo vložte do H3.0 do pole formuláře Profile ID
Nyní se vraťte do Google Console do stránky se service accountem a klikněte na tři tečky ve sloupci Actions a vyberte Manage keys

klikněte na tlačítko ADD KEY a zvolte Create new key
vyberte možnost JSON a klikněte na CREATE
vytvoří se vám privátní klíč, který se vám zýroveň stáhne do počítače jako soubor. Tento soubor my potřebujeme – přepneme se naposledy do H3.0, klikneme na VLožit soubor a uploadneme náš privátní klíč k ostantím informacím o loginu v H3.0
Klikněte na tlačítko Save v H3.0
pro otestování funkčnosti loginu klikněte na tlačítko Edit v sekci loginu a poté v objevivším se okně na tlačítko TEST. Pokud bude výsledek krásně zelený jako je náš obrázek níže, povedlo se a máte propojeno. GRATULUJEME!!

A to je vše. Jak login využijete se dozvíte v dalších dílech našeho seriálu.

Souhrn toho kam v jakém systému zadávat trafficking ID

Toto je souhrnný dokument, kam ve kterém systému zadávat trafficking ID, aby fungovalo automatické propojení mezi statistikami daného systému a H3.0:

DoubleClick Campaign Manager (DCM)

Trafficking ID se zadává do pole Komentář v detailech placementu v masce “H30ID:traffickingID:H30ID”. Více informací je ve speciálním článku o tomto tématu: http://wiki.h30.digital/how-to-traffick-campaigns-for-h3-0-in-doubleclick-campaign-manager/data-connections/

Facebook Ads

Trafficking ID se zadává kamkoliv do názvu kampaně v masce “H30ID:traffickingID:H30ID”. Více informací je ve speciálním článku zde: http://wiki.h30.digital/jak-propojit-h3-0-a-statistiky-facebook-ads/data-connections/

AdForm

Trafficking ID se zadává jako Placement / LineItem name.

Gemius

Trafficking ID se zadává jako Comment k Placementu

Sizmek

Trafficking ID se zadává u placementu buď do pole placement Classification, nebo do pole placement Classification 2. To, které pole budete používat je nutné označit u daného loginu do Sizmeku v Administracei H3.0. Více informací o tomto je ve speciálním článku zde: http://wiki.h30.digital/trafficking-id-v-sizmeku/administration/

Meetrics

Trafficking ID se zadává jako Placement ID

Google Analytics UA

Trafficking ID se zadává do utm_source

Starší verze tohoto návodu je zde: http://wiki.h30.digital/napojeni-na-data-sources-adservery-google-analytics/data-connections/

Nová funkce Finalise for adserving

Kampaně “these days” vyžadují mnoho informací, jedna úroveň je ta ukazující co všechno v kampani u jednotlivých pozic chceme měřit. Pro to máme novou funkcionalitu Finalise for adserving. Ta spočívá v procesu, kdy kontrolujeme, zda plánovač vyplnil všechny informace pro lidi, co zadávají kampaně do reklamních systémů.

Jak na to?

1) Definice toho, co všechno chceme pro adserving vyplnit

V tomto prvním kroku si zadáme do Custom Fields (CF) pole a jejich hodnoty, které chceme mít pro adserving k dispozici.

Tyto pole pak označíme novým checkboxem Related to adserving, který zaškrtneme.

Takto můžeme například udělat:
– CF s názvem “Tracking type” s hodnotami (adserving, adtracking, click tracking, nothing) – pro sledování, co chce plánovač u dané pozice trackovat
– CF s názvem “Use brand safety?” s hodnotami (yes, no) – pro sledování, zda tuto pozici budeme zadávat do brand safety nástroje

Více o Custom Fields zde.

2) Funkcionalita v kampani

Pokud máme CF zadané dle bodu 1), pak již jenom stačí u kampaně mít zaškrtnuté použití nějaké technologie (zadává se v sekci MEASURE WITH při zakládání / editaci kampaně).

Ve Správě kampaně je pak umístěné tlačítko Finalise for adserving, které se chová tak, že pokud nejsou v kampani vyplněné všechny hodnoty CF co jsou Related to adserving, je tlačítko zvýrazněné. V opačném případě je normální.

V obou případech vede tlačítko do záložky CustomF, kde zvýrazní položky Related to adserving, které mají být vyplněny.

Příklad: bezchybný výpočet nákladů na technologii pomocí Adserving Cost a nových Custom Fields

Jak to udělat?

Založím si Custom Field s názvem Typ měření. Dám mu hodnoty AdServing, AdTracking, Click Tracking, Bez Měření. Dám tento Custom Field povinný a nutnost ho zvolit při vkládání pozice do kampaně. Tím pádem mám zajištěno, že plánovač tuto hodnotu vyplní.

Založím si ceník technologie XXX, do kterého dám položky s prioritou shora dolů stejně, jako je píšu zde:

AdServing Big – podmínky Condition kb From = 350, Custom Field Typ měření = AdServing, cena AAA
AdServing Standard – podmínky Custom Field Typ měření = AdServing, cena BBB
AdTracking – podmínky Custom Field Typ měření = AdTracking, cena CCC
Click Tracking – podmínky Custom Field Typ měření = AdServing, Condition Buying model = CPC, cena DDD

Na kampaň, kterou chci měřit a automaticky zjistit náklady na technologie aplikuji danou technologii XXX (zaškrtnu ji v editaci kampaně) a výpočet nákladů na technologii mám v dolní tabulce pod plánem ve sloupečku AdCost.

Samozřejmě – nezapomenu říct H3.0 teamu jak a kde chci, aby mi AdCost vyjížděly v exportech mediaplánů a pro fakturační systémy.

Rozšíření možností modulu Adserving Cost

Modul Adserving Cost umožňuje do H3.0 zadat různé ceníky technologií a ty pak aplikovat na kampaně a automaticky počítat náklady na tyto technologie pomocí polointeligentního odhadování toho, co je pozice zač a jakou cenu na ní aplikovat. Systém tak umí odhadnout klasický CPM adserving, adserving velkých bannerů, CPC adserving apod …

Detailní informace o modulu Adserving Cost jsou zde.

Nyní jsme dosti rozšířili možnosti tohoto modulu tak, že pro stanovení ceny se může využívat velké množství dalších sloupců. Jedná se zejména o:

sloupce věnující se přímo adservingu a trackingu: Primary Adserving, Adserving TAG, Use Adserving, Visibility Tracking, Is Programmatic
všechny sloupce Custom Fields, které jsou díky jejich rozšířeným hodnotám fenomenální
všechny Kategorizační sloupce, které mají taktéž brutální nové možnosti automatické kategorizace

Stále platí základní systém práce tohoto modulu, tedy:

systém jde v ceníku shora dolů a hledá, zda najde vyhovující set podmínek ceníku. Pokud je najde, končí v hledání a naaplikuje na položku cenu technologie a způsob jejího výpočtu (CPC/CPM)
v jedné řádce ceníku funguje mezi jednotlivými podmínkami parametr AND = aby se ceník přiřadil položce, musí být všechny stanovené hodnoty ceníku splněny zároveň

UPDATE 6.7.2019 – možnost ovlivnit zobrazování a předzaškrtnutí jednotlivým klientům

Ceníků adserving cost může být nepřeberné množství a je potřeba se v nich trošku vyznat. Zároveň chceme, aby plánovači nezapomínali tyto ceníky vybírat. Máme tedy dvě nové možnosti, obě jsou v editaci klientů, tedy menu Klienti – vybrat klienta v tabulce a v dolní souvztažné tabulce vybrat záložku Technology Cost.

Zde jsou vypsány všechny dostupné ceníky technologií a u každého je možné zaškrtnout dva checkboxy:

Hide = po jeho zaškrtnutí nebude tato technologie zobrazována patřičnému klientovi. Tak je možné si nastavit, že některým klientům budou zobrazovány pouze některé technologie. (Připomínáme, že pokud je technologie pouze pro jednoho klienta, je možné toto nastavit už v administraci, tedy toto je další funkce, která ovlivňuje viditelnost pro jednotlivé klienty.

Shall be Applied – pokud bude tento checkbox zaškrtnutý, bude při vytváření nové kampaně pro patřičného klienta předzaškrtnuto, že se má použít tato technologie.

Kopírování Adserving cost mezi jednotlivými instalacemi H3.0

Toto je velmi pokročilý návod, radši na něj ani nekoukejte.
Pokud by někdo náhodou chtěl přesunout Adserving cost z jedné H3.0 instalace do druhé, je možné to udělat následovně. V té cílové instalaci ale NESMÍ být žádný AdServing ceník zanešený.
Nejdriv se zkopiruje tabulka `edge_h20_adserving_technology` a pak `edge_h20_adserving_technology_pricelist` a vse by melo byt ok

Možnosti evidence měření u pozice plánu/placementu

V editaci placementu/line item/pozice mediaplánu je nyní možné evidovat co vše se bude u dané položky měřit. Mohou to být:
imprese
kliknutí
akce v banneru
návštěvnost webu
konverze
možnost nelze měřit
Tyto možnosti je zatím možné evidovat po kliknutí na ikonku tužky u dané pozice, v sekci MĚŘÍME.

Pozice v Gemiusu s více placementy

Pokud máte v Gemiusu zadáno více placementů, které jsou v H3.0 reprezentovány pouze jednou řádkou a chcete, aby se statistiky všech těchto placementů sčítaly, nastavte to v gemiu následovně:

v Gemiusu je vytvořena složka, která má v komentářích H3.0 trafficking ID dané pozice
v této složce jsou všechny placementy pod ní patřící. Tyto placementy pak NESMÍ mít H3.0 trafficking ID

Složka je v Gemiusu tváří, jako že má statistiky za všechny její placementy, takže se vám do H3.0 natáhnou tyto statistiky souhrnné za pozice ve složce.

Nová Doubleclick + Google Analytics API

Vzhledem k tomu, že Google updatoval APIpro načítání dat z DoubleClicku a Google Analytics, přizpůsobili jsme tomu i H3.0. Co je ale nutné uzpůsbit je přihlašování se, protože ho Google poněkud změnil.
Podrobný návod k tomu co nově vyplnit máte pro DoubleClick (DCM) i pro Google Analytics (GA) přímo v editaci jednotlivých loginů pro každý ze systémů. Povětšinou se jedná o to, že je třeba zadávat méně informací, zato se nově importuje takzvaný JSON soubor. Ten nahradil některé kolonky v loginech i .p12 soubor, který se používal dříve.
Prosím, po update (2016-08-05-0) tedy projděte všechny loginy pro DCM i GA, zkontrolujte je, případně v Google consoli požádejte o stažení JSON souboru a ten uploadněte do H3.0.
Návod jak stáhnout nový JSON soubor je v editaci loginů pri DCM i GA.

Nejdou mi načíst data do Postbuy – troubleshooting

Co dělat, když se vám nenačítají statistiky do Postbuy, nebo nejsou vidět v dashboardu kampaně? Připravili jsme zde pro vás takový malý postup jak přijít případným problémům na kloub.
1 – máte propojenou kampaň v adservingu s kampaní v H3.0? – Běžte do seznamu kampaní v H3.0 a klikněte na ikonku propojení kampaně s datovými zdroji.

Objeví se okno, ve kterém by v pravé části měla být adserving kampaň, se kterou má být H3.0 kampaň propojena. Zkontrolujte, zda se jedná opravu o správnou kampaň. Pokud tam žádná napojená kampaň není, prosím napojte kampaň výběrem adservingu, účtu a tlačítkem propojení kampaně.

2 – Kampaň je správně propojená, ale statistiky se stále nenačítají – Běžte prosím do správy kampaně. V plánu kampaně je sloupec Traff. ID. Ten obsahuje takzvané trafficking ID, které pomáhá H3.0 k identifikaci jaká řádká plánu je jaká řádka v adserveru. Toto trafficking ID si zapamatujte.

U pozice, u které se nenačítají statistiky klikněte na tlačítko napojení na datové zdroje. To umožňuje zjistit, jaké placementy jsou v připojené adserver kampani a umožňuje tyto adserving placementy připojit k H3.0 pozici kampaně manuálně.

Okno, které se objeví, má dvě části. V té pravé jsou placementy adserveru, které jsou manuálně napojeny na danou pozici H3.0 kampaně. Nemusí tam být nic. V levé části okna jsou všechny datové zdroje napojené na naši kampaň. U adserveru, který chcete manuálně propojit klikněte na CONNECT PLACEMENT.

Objeví se seznam placementů kampaně tak jak jsou zadány v adserveru. Porovnejte H3.0 trafficking ID naší pozice s adserver trafficking ID pozice, které se zobrazí ve sloupci trafficking_id[remote]. Pokud je tam shoda, měly by se statistiky načítat správně. Pokud tam shoda není, máte dvě možnosti:
a) upravit trafficking ID v adserveru na správné podle H3.0
b) manuálně propojit danou pozici – do uděláte tak, ze kliknete na řádek, který odpovídá pozici kampaně a poté stisknete tlačítko OK. A hotovo :o)

3 – komplikovanější hledání kampaně v adservingu – pokud si nejste jisti kampaní a placementy, které chcete s H3.0 kampaní propojit, můžete se dostat do dat adservingu pomocí menu Statistiky a data / název adservingu. Po výběru loginu (účet nastavení), který chcete použít se vám zobrazí seznam všech kampaní, které pod daným loginem v daném adserveru jsou.

Když kliknete na název kampaně v seznamu kampaní, objeví se v tabulce pod tímto seznamem seznam placementů = pozic kampaně tak, jak jsou zadány v adserveru, spolu se statistikami těchto pozic. Ve sloupci trafficking_id[remote] jsou trafficking ID tak jak jsou zadány v adserveru.

Hezký den, H3.0 vás miluje! 🙂