Jak vkládat data z H3.0 do Google Big Query – H3.0 metrics (H3.0 -> GBQ)

Nový zásadní pilíř H3.0 nazvaný “H3.0 metrics” umožňuje přesouvat různá data pomocí H3.0 do jiných databází, aby s nimi bylo možné pracovat například při datové vizualizaci.

Jedním z modulů H3.0 metrics je H3.0 -> GBQ, tedy modul umožňující pravidelně aktualizovat data o kampaních v H3.0 do Google Big Query databáze.

Jak se takové propojení nastaví?

Nejdříve si nastavíme Google Big Query (GBQ), poté s GBQ propojíme H3.0 a nakonec řekneme H3.0, aby do GBQ pravidelně posílal data.

GOOGLE BIG QUERY

  1. založte nový projekt v Google Big Query
  2. V GBQ / SQL workspace si otevřete data projektu a založte Data set pro H3.0 data, papříklad (H30metrics)
  3. v Datasetu su vytvořte tabulku. Můžete si je vytvořit rovnou 3, protože máme 3 typy tabulek: kampaně celkem, placementy celkem a pokud jste opravdu blázni a chcete riskovat obrovské množství dat a všechny problémy, které s tím mohou nastat, tak i placementy daily. Tedy v našem testovacím případě vytváříme 3 tabulky:
    – h30campaignstotal
    – h30placementstotal
    – h30placementsdaily
  4. A tím pádem máte nastavení GBQ hotové.

PROPOJENÍ H3.0 A GBQ

Do H3.0 vložíme loginy do Google Big Query, aby se systémy mohly domlouvat.

V Administrace/nastavení/Propojení s ostatními systémy nascrollujeme dolů až na oddíl Google Big Query a klikneme na Nový. V otevřivším se okně je vždy alespoň nějak aktualizovaný návod, nicméně je třeba:

  1. V Google Consoli v daném projektu v IAM and admin / Service account vytvořit Service Account, dát mu patřičná práva (potřebuje i zápis, takže optimálně všechny). Tento account bude potřebovat H3.0 pro přístup.
  2. E-mail tohoto service accountu vložte do pole GBQ login formuláře e-mail v H3.0
  3. Pro Service account vytvořte “Key”, typ .json a ten si stáhněte a vložte ho do H3.0 formuláře.
  4. Zvažte, jestli login budou mít přístupni všichni H3.0 uživatelé s povoleními pro GBQ loginy a pokud ano, tak v H3.0 ještě vlevo nahoře zaškrtněte přepínač Veřejné.
  5. Klikněte na Save, poté si ten login přes Open znovu otevřete a vlevo nahoře klikněte na tlačítko Test. H3.0 se zkusí připojit do GBQ a pokud bude vše OK, nahlásí 2x zelené OK. Pokud tam bude něco červeně, udělali jste někde chybu. Nezoufejte a napište nám, zkusíme vám poradit.

A teď už nám jenom zbývá nastavit proudy dat z H3.0 do GBQ

H3.0 -> GBQ

V modulu Administrace/H3.0METRICS se nastavují takzvané DataTasky, tedy úkoly pro H3.0, aby posílalo nějaká data jinam. V našem případě nastavíme 3 datatasky pro posílání Kampaní celkem, Placementů celkem a Placementů po dnech, pokaždé do jiné tabulky v GBQ, kterou jsme si předtím nastavili.

Klikněte na tlačítko Vytvořit nový DataTask

V okně, které se otevře je možné DataTask nastavit. Je tam toho hodně, ale to nejdůležitější co potřebujete je:

  1. Zdroj dat vyberte jako H3.0: Campaigns and Placements
  2. Cílové propojení vyberte ten login, co jste si teď zadali
  3. Vyberte Typ dat podle toho, jaká data chcete posílat (Kampaně celkem, Placementy celkem, Placementy po dnech)
  4. Do Tabulka vyplňte název patřičné GBQ tabulky pro daný Typ dat. POZOR!! ve formátu dataset.table, tedy pro náš příklad třeba “H30metrics.h30campaignstotal”
  5. Můžete si kliknout na tlačítko Test cílového propojení, abyste zjistili, že máte loginy i Tabulku napsané správně
  6. Zaškrtněte Vyprázdnit tabulku před každým vložením dat
  7. Nastavte správně Frekvenci spouštění, pokud chcete každý den v nějakou hodinu, musí být v DAY, MONTH i WEEKDAY hvězdička a v MINUTE a HOUR patřičná hodina a minuta dne v kolik se to má spouštět
  8. Pro úvodní odlaďování si nechte Odesílat reporty jak po úspěšném, tak po neúspěšném provedení
  9. Nastavte správný datum Od a Do, pro vhodný časový úsek dat, která se budou posílat.

Klikněte na Save a nyní jenom zbývá počkat, až nastane patřičný okamžik, který jste nastavili v Data Tasku, aby se spustil.

Pokud byste nechtěli čekat, můžete Data Task spustit ručně kliknutím na tlačítko Spustit v řádku DataTasku v seznamu DataTasků.

Pozor – DataTasky se spouštjí “asynchronně”, tedy může trvat, než doběhnou, i když se vám třeba může zdát, že už proběhly. Výsledek toho jak DT proběhlo je v pravých sloupcích tabulky se seznamem DataTasků

A co dál? Můžete si vytvořit vlastní dashboard s daty z H3.0, například v Looker Studio (bývalé Google Data Studio).

Nové tagy do mailů a exportů – informace o agentuře

Pro instalace, které jsou nativně propojeny s mediaystémem (v CZ BuyIn2) je možné zadávat do textu mailů a exportů následující tagy:

Pro vložení informací o agentuře KSV:
[%AGENCY_KSV_NAME_COMPANYINFO%]
Pro vložení názvu agentury KSV
[%AGENCY_KSV_NAME%]

Pro vložení informací o mateřské agentuře:
[%AGENCY_NAME_COMPANYINFO%]
Pro vložení názvu mateřské agentury
[%AGENCY_NAME%]

Tagy NAME jsou jasné a tahají se z databáze.

Tagy COMPANYINFO si agentura musí zadat přes tagy exportu. Zadávají se v Administrace/Nastaveni/Nastaveni exportu – Tagy exportu, kde se patřičná infomrace zadá jako tag s názvem
AGENCY_NAME_COMPANYINFO_idagenturyvmediasystemu
respektive
AGENCY_KSV_NAME_COMPANYINFO_idagenturyvmediasystemu

kde to “idagenturyvmediasystemu” je ID agentury v mediasystému, které lze zjistit v Administrace/Mediasystems/Agentury (nebo Agentury KSV), takže to bude vypadat například takhle:

AGENCY_KSV_NAME_COMPANYINFO_4

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/

Dodatečné informace o kampani 2023

Tento báječný modul umožňuje přidat ke kampani jakékoliv množství dalších informací a navíc k nim nastavit různé vychytávky jako třeba že budou povinné při zakládání kampaně, nebo že se spustí jejich vyplňování před odesláním objednávky.

Takto můžete zajistit evidenci různých objednávkových čísel kampaní či briefů, kódů kampaní či nějaké speciální kampaňové kategorizace.

V menu Kampaně naleznete submenu Dodatečné informace a pod ním záložka Nastavení proměnných. Zde můžete takovou Dodatečnou informaci nastavit.

Kliknutím na tlačítko Nová proměnná se vám zobrazí nový řádek, u kterého můžete zadat novou proměnnou Dodatečných informací a detaily toho, jak bude fungovat:

Název – takto se proměnná bude reprezentovat v systému

Povinná – zaškrtnutí zařídí, aby bylo vyplnění informace povinné při zakládání i editaci kampaně povinné

Povinná pro odeslání objednávky – taková informace nebude sice povinná hned při založení kampaně, ale poté co kliknete na tlačítko Objednat se zkontroluje jestli je vyplněná a pokud ne, bude nutné ji vyplnit.

Informaci je možné propsat i do exportů pro BuyIn a to zajistí další dva checkboxy tomu věnované.

Danou informaci můžete použít například i v objednávkových e-mailech či exportech. K tomu vám dopomůže tag v posledním pravém sloupci.

Dodatečná informace se zadává při vkládání kampaně v dolní části formuláře v sekci OSTATNÍ.

Pokud si chcete vypsat seznam kampaní a jejich dodatečných informací, využijte menu Kampaně / Dodatečné informace / Přehled.

a to je vše, hezký den