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

  • 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.

Jak propojit H3.0 a DCM=DoubleClick Campaign Manager/ DFA=DoubleClick For Advertisers nebo jak se ta hovadina vlastně jmenuje – návod se screenshoty

Přinášíme aktualizovyný návod se screenshoty na to, jak do H3.0 uložit propojení na DCM tak, aby si H3.0 uměl stahovat statistiky kampaní a vy jste tak mohli kampaň sledovat v dashboardech a dělat postbuy na pár kliknutí.
Propojení je jednoduché. Potřebujeme v Google Developer konzoli nastavit napojení přes API, vypsat číslo účtu v DCM a to vše zadat do H3.0, které pak autorizujeme.
Důlěžité – celý proces (nebo alespoň poslední krok povolení práv do H3.0) je nejlepší udělat v Google Chrome, u kterého si nastavte povolit 3rd party cookies and content: “To find the setting, open Chrome settings, type “Content settings” in the search box, click the Content Settings button, and view the fourth item under Cookies.” Uncheck the box “Block third-party cookies and site data”.

  1. v H3.0 jdi do Administrace/Nastavení/Propojení s ostatními systémy. Najdi tam sekci DoubleClick for Advertisers (Oauth 2.0) a klikni na tlačítko Nový
  2. v jiném okně prohlížece jdi na https://console.developers.google.com/apis/dashboard
  3. ujisti se, že jsi přihlášen(a) jako ten DCM uživatel, kterého napojujeme. To uděláš tak, že vpravo nahoře klikneš na kulatý obrys siluety, pod ním se Ti otevře se okno, kde by měl být onen profil. Pokud není, odhlaš se od aktuálního a přihlaš se pod chtěným profilem, který propojujeme.
  4. Jdi do menu Credentials v levém sloupci a vytvoř nový projekt kliknutím na tlačítko Create.
  5. Vyplň název projektu (jaký chceš, třeba H30DCMConnection) a opět klikni na Create.
  6. V objevivším se okně APIs Credentials klikni na Create credentials. Objeví se několik možností, zvol tu OAuth Client ID.
  7. Je možné, že se objeví pokyn k definici produktu v “Consent screen”(to je informační obrazovka, která se objeví, když budeš z H3.0 povolovat přistup do DCM jako uživatel). V takovém případě klikni na Configure consent screen. Vyplň název projektu. Důležité je vyplnit i Authorized domains – sem vyplň název domény, na které vám H3.0 běží (bez http).
    Po kliknutí na Save nás to vrátí opět do vytváření Credentials.
  8. Z vybraných možností pro typ aplikace pro OAuth Credentials vyber prosím  Web application. Poté co tuto možnost zvolíš, je důležité zadat správně Authorized JavaScript origins a Authorized redirect URIs. Tyto Ti poradí správně H3.0 v nápovědě. Do Origins se dává přesná doména, na které H3.0 běží. Do Redirect URIs se dává URL složené z H3.0 domény a “/oauth2redirect.php”, tedy například, pokud by vám běželo H3.0 na http://www.h30.digital by to bylo: “http://www.h30.digital/oauth2redirect.php”.

    POZOR!!! – zadej jak do Origins, tak do Redirect obě varianty URL = s http:// i s https://

    Svou volbu potvrď kliknutím na tlačítko Create
  9. Objeví se okno oznamující client ID a client secret. To odzívni a namísto toho si klikni na stažení JSON souboru u patřičného Credentials. Ufffffff … tak a to nejtěžší máš za sebou. Ale než si oddychneš, prosimTě zapamatuj si, kam jsi uložil ten staženej soubor, jo? Dík …
  10. Nyní povolíme v Konzoli potřebné API . V levém sloupci je menu Library. Klikni a v zobrazivším se okně vyhledej “DCM/DFA Reporting and Trafficking API” (do vyhledávacího pole stačí zadat “DCM”). KLikni na čtverec s danou API a poté v detailech API ji zapni tlačítkem ENABLE.
    Tím máme aktivovanou API.
  11. Přepni si do DCM. KLikni vpravo nahoře na svůj profil. Objeví se ti všechny accounty, ke oterým máš přístup a pod každým z nich je Tvůj login, kdy kliknutím na ten login se přihlásíš do daného accountu. Nás zajímá to číslo, napravo od Tvého loginu. Tedy né to číslo napravo od názvu accountu, ale napravo od názvu Tvého loginu. To si opiš, respektive si ho dej do clipboardu.
  12. Jdi zpět do do H3.0 kde máš otevřené okno pro zadání informací pro propojení. Zadej jakýkoliv název propojení/loginu, abys ho pak mohl(a) v H3.0 lépe identifikovat.
    Do Profile User ID zadej to číslo co máš v clipboardu z DCM.
    Do API KEY FILE uploadni soubor, co sis stáhl(a) z Google Developer Console.
    Rozmysli si, zda chceš zaškrtnout Veřejné. Pokud to uděláš, budou mít všichni uživatelé H3.0 přístup k tomuto loginu. Pokud ne, bude nutné pro přístup k tomuto loginu nastavit práva pro každého uživatele zvlášť v jeho uživatelských nastavení co mu spravuje Administrátor.
    Klikni na OK pro uložení.
  13. V H3.0 si ještě jednou vyber tento login a dej Upravit. V okně co se objeví klikni na tlačítko Test vlevo nahoře. Objeví se tlačítko Login with Google Account. Na něj klikni. Když všechno dobře dopadne, objeví se Consent screen = stránka Google, která se Tě ptá, zda udělíš H3.0 patřiočná práva – to odklikni jako že ano.

Chyby, se kterými jsme se setkali a jejich řešení:

  • při finální autentifikaci mi to píše “idpiframe_initialisation_failed” => nemáš povolený 3rd party content v browseru, povol si je – viz 3. odstavec tohoto návodu.
  • prohlížeč mi píše, že stránka neexistuje nebo nemam práva => ujisti se, že jsi přihlášen(a) jako ten uživatel, kterého propojujeme. Často se stane, že je uživatel přihlášený pod jiným loginem v Consoli, pod jiným v DCM a pod jiným třeba v Gmailu
  • prohlížeč mi píše chyba OAuth redirect => zkontroluj si, zda máš v Consoli u Credentials zadané správné URL u Origins i u Redirect a že tam máš obě varianty URL – s http:// i s https://
  • po kliknutí na Test mi to píše, že jsem Connection test passed, ale v druhém kroku LOGIN je chyba – accessNotConfigured => počkej chvíli, je možné, že se Google ještě nevzpamatoval …

How to traffick campaigns for H3.0 in DoubleClick Campaign Manager

H30_HowToTraffickDCM_ver20170210 (<- PDF version of this text)
For agencies using H3.0, its extremely important to have TRAFFICKING ID implemented in adserver. Trafficking ID is used for identification of particular placement in agency H3.0 digital planning and campaign stewardship tool.
Where do I find TRAFFICKING ID?
Trafficking ID looks like “1234_website_section” and is placed in trafficking sheet table. Example below:

How do I implement trafficking ID into the DoubleClick Campaign Manager?
Within DCM, Trafficking ID shall be put into Placement COMMENTS field, within the mask “H30ID:traffickingID:H30ID”. So for example, if trafficking ID is “1234_website_section”, you shall put “H30ID:1234_website_section:H30ID” into the Placement Comments.

Rozšíření napojení na DoubleClick Campaign Manager API (adserving)

Rozšířili jsme napojení na DoubleClick DCA API pro natahování dat do Postbuy následovně:

  • natahuje se vícero klasických dat = imprese, kliknutí, visibilní imprese
  • díky napojení na Reach report se tahají i data o unikátech = unikátní reach impresí, unikátní reach kliknutí, reach CZ = unikátní reach pouze pro CZ uživatele
  • pracujeme s Motivy

Upozornění – reach report lze ze strany DoubleClicku tahat pouze na data mladší 3 měsíců, tedy pro delší kampaně toto nebude fungovat. (toto není naše, ale DC omezení)

Spousta dalších postbuy sloupců

Chtěli bychom, aby se H3.0 stalo v budoucnu centrálním místem, kde se budou sbíhat všechny výsledky kampaní. Díky tomu pak bude možné lépe plánovat, stanovovat KPIs i predikovat výsledky naplánovaných kampaní. Proto rozšiřujeme možnosti postbuy o další sloupečky, tentokrát z oblasti search a video kampaní, napárovaných přímo na míru výstupům z Sklik, Adwords a YouTube reklam.
Po prosincovém přidání metrik pro DoubleClick DCM, Facebook Page, Ads i Video metriky si troufáme tvrdit, že H3.0 postbuye dokážou pokrýt valnou většinu potřeb každého interneťáka. Pokud máte opačný pocit, dejte nám vědět.
Lednové přidávky tedy jsou:

average_position

fraud_clicks

impressions_with_clicktocall

phone_calls

PTR

video_views

viral_views

to_watch_list_added

video_likes

video_shares

video to 75%

postcall_conversions

search_impression_share

search_impression_share_exact_match

content_network_share

adwords_search_bounce_rate

adwords_partners_search_bounce_rate

adwords_GDN_bounce_rate

adwords_search_pages_per_visit

adwords_partners_search_pages_per_visit

adwords_GDN_pages_per_visit

postclick_conversions_value

postview_conversions_value

transactions

transactions_value

updated_date

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.
gaapi

Napojení na Data Sources (AdServery, Google Analytics)

Tutoriál jak napojit kampaň na různé datové zdroje jako jsou AdServery a statistiky návštěvnosti webů přináší detaily o napojení na:

  • DoubleClick Campaign Manager
  • AdForm
  • Sizmek / MediaMind
  • Gemius
  • Google Analytics
  • Meetrics

Včetně informace o tom, kam umístit trafficking ID.
UPDATE – u Adformu je Placement Name nyní reprezentováno jako Line Item name ….
H30_tutorialy_DataSources_ver20160522