Tag: API

Připojení Meta dat k H3.0 pro H3.0 METRICS a Meta Ad Transparency dat

K tomuto kroku musíte mít dobře založenou Meta Developers Applikaci. Návod k tomuto je například zde.

Z vaší Meta Developers App budete potřebovat dva údaje:
App ID = ID aplikace
App secret = tajný kód, který slouží k autentifikaci přístupu k aplikaci

Zároveň je důležíté, abyste byli adminem té aplikace, kterou chcete připojovat, protože musíte vygenerovat token.

A naposledy je důležité, aby osoba, která bude generovat token, byla ověřenou osobou u Facebooku pro pouštění reklam na social issues, elections or politics, což se dělá na https://www.facebook.com/ID

App ID a App secret zjistíte na https://developers.facebook.com/ v sekci My Apps. Kliknete na název aplikace a jdete do menu App settings / Basic. Obe hodnoty jsou vpravo hned nahoře. App secret se zobrazí po kliknutí na tlačítko Show.

V H3.0 běžte do Administrace / Nastavení / Propojení s ostatními systémy a nascrollujte dolů až k sekci Facebook (Oauth 2.0). Klikněte na tlačítko Nový.

Vyplňte Název připojení (libovolný) a vložte App ID a App Secret získané v předchozím kroce. Add account ID pro připojení k Ad Transparency dat vyplňovat nepotřebujete. Zvažte zda bude připojení Veřejné nebo jenom pro vás. Klikněte na OK.

Ještě musíme ale vygenerovat token. Otevřete si znovu editaci připojení kliknutím na tlačítko Upravit u patřičného loginu v Facebook (Oauth 2.0) a v dolní části formuláře klikněte na tlačítko Refresh v sekci Access token expiration. Projděte si FAcebook přihlášením a povolením přístupu. Výsledkem je, že v Access token expiration se vám objeví nějaké budoucí datum.

Nezapomeňte, že před uplynutím datumu v Access token expiration je dobré ten token obnovit, aby nevyprchal, čímž by se H3.0 nemohlo připojit k API.

Adform API loginy – co je potřeba

Pro to, abyste mohli H3.0 propojit s Adformem je třeba požádat u Adform supportu o to, aby vám na váš agenturní přístup aktivovali API loginy a oni to udělají. Nezapomeňte je požádat, aby u těch API loginů povolili následující “scopes” :

Scopes:
https://api.adform.com/scope/eapi
https://api.adform.com/scope/buyer.media
https://api.adform.com/scope/buyer.media.readonly
https://api.adform.com/scope/buyer.stats
https://api.adform.com/scope/buyer.campaigns.api.readonly
https://api.adform.com/scope/buyer.rtb.lineitem
https://api.adform.com/scope/buyer.rtb.lineitem.readonly
https://api.adform.com/scope/buyer.direct.lineitems.readonly
https://api.adform.com/scope/buyer.direct.lineitems

Loginy, které se sestávají z Client ID a Client Secret a můžete tahat data z Adformu do Postbuy v H3.0, nebo posílat data z Adformu přes H3.0 do Google Big Query přes modul H3.0 METRICS.

Loginy se zadávají v Administrace/Nastavení/Propojení s ostatními systémy – kde v sekci Adform kliknete na tlačítko Nový a vyplníte přihlašovací údaje.

Nezapomeňte i těmto API loginům přiřadit patřičné klienty, aby se pod nimi zobrazovaly jejich kampaně.

XML export, verze 2018 – popis

V H3.0 je možné si data kampaně vyexportovat do XML, tedy podoby srozumitelné jiným strojům. Níže uvádíme popis struktury XML, které si můžete stáhnout kliknutím na tlačítko Stáhnout XML, které je u tlačítek exportu ve Správě kampaně.

Struktura XML exportu kampaně z H3.0:
<CAMPAIGNS>
// zde jsou všechny kampaně obsažené v exportu
   <CAMPAIGN>
// zde jsou informace o jedné kampani
      <DESCRIPTION>
// popisné informace týkající se dané kampaně jako její ID, název klienta
// pozn.: CURRENCY nabývá přesně hodnot zadaných v Administraci, tedy například “Kč”, nebo “CZK”
      </DESCRIPTION>
      <PLACEMENTS>
// popisné informace týkající se dané kampaně jako její ID, název klienta
         <TIMEPLANS>
// jednotlive umisteni jednotek v case
            <TIMEPLAN>
//jedno umisteni jednotek v case, definovane zacatkem, koncem a poctem jednotek. Co jednotka znamena se da odvodit z BUYINGMETHOD na urovni PLACEMENT. Datumy jsou ve formatu YYYY-MM-DD
            </TIMEPLAN>
         </TIMEPLANS>
      </POSITIONS>
   </CAMPAIGN>
</CAMPAIGNS>
Vzorový soubor XML exportu je možné si zobrazit zde.
Dodatečné informace:
1) Kódovník Buying modelů, index pole je to co je v databázi

[
'cpt'=>'CPT',
'cpc'=>'CPC',
'cpa'=>'CPA',
'cpx'=>'CPX',
'cpemail'=>'Cost Per E-mail',
'cpperiod'=>'Cost Per Period (guaranteed)',
'cpplay'=>'Cost Per Play',
'cpsmsmms'=>'Cost per SMS/MMS',
'cpv'=>'CPV',
'cpperiod_ng'=>'Cost Per Period (not guaranteed)',
'cpvimp'=>'Cost Per Visible Impressions',
'cpmauct'=>'CPM auction',
'cpcauct'=>'CPC auction',
'cpvauct'=>'CPV auction',
'cpiauct'=>'CPI auction',
'budget'=>'Budget',
]

2) Kódovník Feebase je pro každou instalaci jiný, je možné ho získat v Administrace/Nastavení/Odborné info, nebo přímo vyjetím z databáze ”

SELECT `id_feefrom` AS FEEBASE, `name` AS NAME FROM
`edge_h20_campaign_feefrom`;

”
 

Jak zažádat o Basic Access u Adwords MCC účtu

AdWords mají několik úrovní takzvaných Vývojáčských přístupů. Pro H3.0 nás zajímají následující:
Testing access je takový, který máte hned, ale umožňuje se tak akorát zalogovat.
Basic access vám již umožní stahovat reporty a to je to co potřebujeme. O tento přístup je ale nutné zažádat samotný Google. Není to ale nic složitého a upgrade z Testing na Basic trvá tak 1-2 dny, obvykle to bylo do druhého dne hotové. Tento access potřebujete k propojení s H3.0.
Google se nejvíc bojí, že jim budete chtít hrabat do kampaní a že budete statistiky nějak agregovat a pouštět ven nebo ke klientům. Takže pokud potvrdíte, že H3.0 pouze stahuje statistiky a používáte ho pro interní potřebu, bude vše OK.
Jak tedy zažádat o Basic access?
Ve vašem AdWords API Center (Nastavení / Account settings) kliněte u Access level na odkaz Apply for Basic Access. Dostanete se na formulář Basic Access Application, který je jediné co vás dělí od kýženého přístupu. Musíte zde vyplnit spousty kravin, vše je dobře popsáno. Musíte zde i zopakovat ID vašeho AdWords MCC, nebo e-mail a zařazení vašeho MCC. Tedy informace, které se z MCC dozvíte, ale Google je tam prostě chce zopakovat.
Z dalších otázek dáváme jako vzor odpovědi, které nám fungovaly:

  • Does your company manage ad campaigns for clients – Yes, we manage campaigns for our clients we have agreement on such service.
  • List the websites for which you advertise – zde stačil seznam URL několika TOP klientů, pro které agentura pracuje
  • Describe your company’s business model – we are paid per work hours spent when managing our clients campaigns
  • Do you use your AdWords API token with a tool developed by someone else? – Yes
  • Please list the tool you use – H3.0 – Digital Campaign Stewardship System
  • Upload design documentation of your tool – pouzijte tento soubor: H30_AdWrods-connection_ver03PDF
  • Is your tool related to AdWords ads? – Yes, the tool is able to get reports from AdWords
  • Who will have access to your API tool? – only the people who have rights to H3.0 = our internal staff, who have access to AdWords too
  • If you have clients, will they have LOGIN access to your tool to view reports? – No, the tool is internal only and clients don’t have access to it.
  • Do you plan to make any mutate calls to the API, or create/manage campaigns via the API? – no, the tool is reporting only, no campaign management functions are available
  • Do you plan to make reporting calls to the API? – Yes, the tool does make reporting calls to the API, mostly the AWQL Campaign Performance Reports.
  • Do you plan to do any keyword research via the API? Specifically … – not yet

No a to je vsechno .. tedy vsechno se da odpovedet tak nejak z hlavy, krome te dokumentace H3.0 kterou naleznete na odkazu vyse.
Kdyby cokoliv, jsme zde :o)
Team H3.0

Upozorneni – nacitani AdFormu do H3.0

Ahoj vsem,

rad bych upozornil na jedno chovani statistik AdFormu, ktere pozorujeme u vice loginu. AdForm ma jiz nejaky cas novou API, postupne migruje vsechny ucty a loginy, nicmene u tech loginu zapomina povolit pristup pres API, takze si H3.0 nemuze tahat data.

Jak se to projevuje:

A) pri nacitani statistik AdFormu se nenactou zadna data

B) ve Statistiky a data / AdForm po vyberu patricneho loginu + kampane to hodi chybu

C) ve Statistiky a data / AdForm po vyberu patricneho loginu + kampane to nacte placementy, ale ty nemaji zadne statistiky

Co s tim delat?

Pokud pozorujete A), zkuste jit do Statistiky a data / AdForm a podivat se na statistiky nejake kampane

Pokud pozorujete B), mate pravdepodobne nastavenou v H3.0 starou API, ale vas login uz jede pod novou – bezte do Administrace / Nastaveni / Propojeni s ostatnimi systemy – sekce AdForm – vyberte v PullDownu patricny login a kliknete na tlacitko Upravit. Pravdepodobne mate v horni casti objevivsiho se formulare vybrano API older than 2016. Prekliknete na 2017 API a ulozte pomoci OK. Bezte pote prosim opet do Statistiky a data / AdForm a zkuste se podivat do nejake kampane zda se nactou statistiky. Je mozne ze se dostanete k chybe C).

Pokud pozorujete C), napiste do AdFormu, at vam na patricny login aktivuji API. Pote by vse melo fungovat.

Diky a preju hezky den :o)

H.)

zrychleni propojeni Facebook Marketing API

Trošku jsme zapracovali na zlepšení i zrychlení propojení s Facebook API. Jsou zprovozněny následující

  • data se přes noc cachují = statistiky nemusí čekat na Facebook odpověď a tím pádem se zobrazují opravdu rychle
  • možnost exportu dat – ve Statistiky a data / Facebook Ads přibyla v patičce tabulky seznamu kampaní i spodní tabulky s výjezdem AdSetů z kampaně vybrané v seznamu kampaní ikonka exportu do excelu – zatím bez nějakých grafik a podobných kravinek

Lepší chybová hláška AdForm – uživatel co nemá API

Připojení k AdForm adserver API se v případě, že uživatel sice existuje ale nemá povolení k API, se chovalo jakoby krachlo a neukázalo žádná data.
Vychytali jsme nyní hlášku, která řekne, že uživatel nemá povolení k API. V takovém případě stačí napsat na support AdFormu aby vám API pro daného uživatele aktivovali.

Jak propojit H3.0 a statistiky Facebook Ads?

Propojení s Facebook Ads funguje na podobném principu jako propojení s ostatními datovými zdroji. Automatické propojení je možné přes Trafficking ID pozice v H3.0, které se uloží do datového zdroje = FAcebook Ads. Nebo je možné udělat manuální propojení, díky kterému je možné pozice kampaně v H3.0 ručně napojit na placementy nebo kampaně ve zdroji dat (v tomto případě Facebooku). Tedy konkrétně:
1) Automatické propojení H3.0 a Facebook Ads
Trafficking ID pozice zadejte kamkoliv do názvu Facebook kampaně tak, že kampaň se může jmenovat jakkoliv, ale někde v názvu bude trafficking ID mezi znaky “H30ID:” a “”H30ID”, tedy například “1785_facebook-com_apps”. (nezapomeňte že “0” v názvu “H30ID” je nula). Název kampaně pak tedy může vypadat nějak takto: “Porsche Cayenne jaro M35-50 v krizi  // H30ID:1785_facebook-com_apps:H30ID”
2) Manuální propojení H3.0 a FAcebook Ads
Pokud nemůžete nebo nechcete zadávat trafficking ID do názv kampaní, můžete napojit FB kampaně na pozice H3.0 kampaně ručně. Díky našim novým úpravám v použitelnosti propojovacího modulu to bude hračka. Napojte kampaň na potřebný účet ve Facebook Ads kliknutím na tlačítko Napojení na datový zdroj v Seznamu kampaní. Poté stejným tlačítkem (vypadá jako palačinky), ale v Seznamu pozic kampaně ve Správě kampaně připojíte Facebook kampaně na daný placement. Můžete jich napojit i více, v takovém případě se statistiky za jednotlivé kampaně sečtou.
Jednotlivé AdSety je pak možné načíst i vyexportovat jako motivy kampaně.

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í)

Nová AdForm API

AdForm má od prosince novou inovovanou API pro přístup ke statistikám. Nová API má lepší práci s datovými rozmezími i s motivy kampaně.
Přechod na novou API je jednoduchý – v Administrace/Nastavení/Propojení s ostatními systémy si v sekci AdForm naeditujte nebo vytvořte login, který je kompatibilní s novou API (děcka z AdFormu vám řeknou jestli jo nebo ne) a u něj naleznete nové přepínátko, které přepněte do polohy 2017 API.
A hotovo 🙂
adformapi