Jak si nechat schválit nové povolení od Facebooku pro čtení statistik

Tento článek je pokračováním článku
http://www.hondzyk.com/wiki/2017/02/09/jak-propojit-facebook-ad-account-s-h3-0/
který ukazuje základy napojení H3.0 na Facebook statistiky.
V tomto pokračování si ukážeme jak požádat o povolení pro čtení statistik a jaké texty tam máte vyplnit, aby to FB zkousl. Texty i video byly použity pro několik našich aplikací, které spravujeme a všechno prošlo. Nemůžeme však vyloučit, že se lidem v FB něco pohne v hlavě – v takovém případě budeme rádi k dispozici pro pomoc se řešením.

  1. je nutné požádat o Ads Management Standard Access – v patřičné appce menu Marketing API / Settings – nascrollujte dolů a u Ads Management Standard Access klikněte na Add to Submission
  2. Vyplňte informace pro submission – tlačítko Edit Details v otevřeném okně u Ads Management Standard Access
  3. V “Tell us how youre using this permission or feature” vyplňte, jak používáte H3.0 ve spojení s Facebookem. Rozhodně se vyhněte slovům o vytváření kampaní apod. Používejte jenom stahování reportů. Nám fungoval tento text: “The application uses Facebook Ads access to download reports for digital campaigns and put the into the agency postbuys and its templates.
  4. Zaklikněte, že je platformou Web
  5. Objeví se okno Web, do kterého je nutné vyplnit “Step by Step” návod jak se s FB pracuje. Nám fungoval tento návod: ”
    The tool is closed behind the agencies firewalls, but you can reach the functions as follows:
    Connect to your Facebook Ad Account:
    • menu Administration/Settings/Other Systems Connection – Facebook
    • Create New Facebook connection
    • insert App ID, App secret and Ad Account ID
    • Generate token – Facebook asks you for permissions
    After this, you can access Facebook statistics through menu Statistics and data / Facebook Ads. In pulldown, please select Facebook Ads connection you want to use. In the table, the list of campaigns is displayed. After clicking at particular campaign, detailed AdSets statistics are shown. You can export these data.

  6. Uploadněte screencast – chce ukázat jak se propojí v H3.0 appka s FB. My jsme si to natočili zde: Video
  7. Klikněte na Save – okno se zavře
  8. U App Verification nemusíte klikat na Edit Details (je to Optional)
  9. kliněte na Submit for Review
  10. odsouhlaste podmínky
  11. čekejte, nám to obvykle odsouhlasili do 7-14 dní, někdy chtěli ještě propojit Appku s Business Managerem a přiložit například účet od telefonu apod …

Obsah update 2018-02-21-0 – 2018-03-21-0

Nová možnost propojení s Buyingem (with validity check) pro potřeby GDPR – více informací zde: Nové propojení s Buyingem – with validity check.
Pokud skončí první pokus o odeslání e-mailu z H3.0 chybou, pokusí se nyní systém odeslat mail po chvíli ještě jednou.
Kódovník FeeBase pro XML export je nyní dostupný v Administrace/Nastavení/Odborné info, tato informace je v XML export, verze 2018 popis
Byla provedena optimalizace odesílání Alertů – odesílání mailů při příležitosti začátku/konce kampaně.
Vylepšené kopírování položky včetně BB. Kopírování položky kampaně včetně Building Blocku
Nastavení pojmenovávání souborů jsou dostupné nové tagy pro pojmenovávání exportních souborů:  “[%RESERVATION_CODE%], [%VERSION_CUSTOM_NAME%], [%YY_START%], [%MM_START%], [%YY_END%], [%MM_END%] ”
Máme novou slevu – Sleva prodej, více informací zde: Sleva nákup versus Sleva prodej
U pozice kampaně je možné evidovat, co vše se pro danou pozici bude měřit. Viz: Možnosti evidence měření u pozice plánu/placementu
 

AdForm troubleshoting

Protože je API AdFormu taková nepředvídatelná, máme možnost pokročilého troubleshotingu, abychom věděli, jaká data AdForm poskytuje a mohli je zanalyzovat.
Pokud se tedy ADForm chová podivně (v H3.0 jsou jiná data, než byste očekávali), udělejte prosím následující postup:

  • menu Statistiky a data / Adform – vyberte patřičný účet v PullDown menu Účet nastavení propojení
  • najděte a jednou klikněte na řádku kampaně v horní tabulce seznamu kampaní (té kampaně, která zlobí)
  • nad dolní tabulkou je tlačítko RAW data dump – klikněte na něj a data, která se zobrazí nám pošlete k analýze

Obsah update – 2017-07-20-0

  • nyní je možné odesílat rezervace a objednávky na vybraného dodavatele včetně fee [LINK]
  • modul Fakturace změnil granularitu na Placementy a má vlastní popis [LINK]
  • jak jsme tuhle upravili, aby k příplatkům mohl být dán i Web, tak na příplatky fungují i dynamické proměnné, které se k danému webu vážou.
  • máme novou strukturu Trafficking IDs [LINK]
  • v záložce Trafficking ve Správě kampaně to házelo chybu a nezobrazil se seznam placementů. Chyba byla odstraněna z povrchu.

Jak propojit Facebook Ad Account s H3.0

Propojení H3.0 a Facebooku sice může vypadat náročně, ale ve skutečnosti je to pár kroků, které
 
Pro propojení účtu ve Facebook Ads s H3.0 je nutné vykonat následující postup:
1. Vytvoření Facebook aplikace, přes kterou bude H3.0 komunikovat s Facebookem

  • pro celou agenturu stačí udělat jednu aplikaci. Do této aplikace poté můžete zadávat práva různým uživatelům, kteří mají různá práva k AdAccountům v Business manageru.
  • běžte na https://developers.facebook.com/ a (po registraci) v pravém horním rohu klikněte na menu My Apps a vyberte volbu Add a New App (tím si vytvoříte novou aplikaci)
  • zadejte název nové aplikace a kontaktní mail “správce” aplikace a vyberte kategorii (například Business). Poté klikněte na Create App ID
  • dostanete se na výběr produktů, které do aplikace můžete přidat. Vyberte Facebook login a klikněte na tlačítko Get Started. Poté vyberte z menu vpravo položku “+ Add Product, najděte a Marketing API a opět ho přidejte pomocí Get Started
  • Facebook Login i Marketing API se vám dostali do levého sloupcového menu
  • Klikněte na Facebook Login / Settings a do pole “Valid OAuth redirect URIs” vložte doménu Vaší instalace H3.0, tedy něco jako “http://www.hondzykagentura.cz/”. Potvrďte vložení kliknutím na Save changes vpravo dole
  • Pokud nejste administrátorem vašeho business accountu, klikněte na Roles / Roles a v sekci Administrators klikněte na Add Administrators a přidejte podle FB uživatelského jména vašeho Business Account admina (musíte být přátelé na FB), nebo jeho FB ID. Tento musí poté pozvánku k Administraci této aplikace přijmout a poté přidat AdAccounty do Aplikace on
  • Následující kroky může udělat pouze administrátor Business Accountu
  • Klikněte na Marketing API a vyberte Settings této položky
  • v pravém hlavním sloupci vyberte Business Manager, ze kterého chcete do aplikace přidat Ad Accounty
  • poté vložte do pole Ad Account ID patřičnou hodnotu Ad Account ID a klikněte na tlačítko Add. Toto opakujte pro včechny Ad Accounty, které chcete do této aplikace vložit
  • v levém sloupci klikněte na menu Settings / Basic. Vpravo máte hodnotu App ID a po kliknutí na tlačítko Show se vám zobrazí i hodnota App Secret. Tyto hodnoty budete kopírovat do H3.0, stejně jako Ad Account ID

Poznámky k aplikaci – když vytvoříte aplikaci, je ve verzi “development” = může na ní být navázáno max 5 Ad Accountů. Poté co splní podmínky Facebooku (link), může na ní být navázáno neomezené množství Ad Accountů.
 
2. Přiřazení práv uživatelům do této aplikace (a do Business Manageru)

  • Abyste mohli pro H3.0 autorizovat aplikaci vytvořenou v bodě 1 = vytvořili přístupový token, je nutné, abyste byli administrátoři této aplikace. To se stane tak, že současný Administrátor aplikace ve facebook Developers správě této appky použije menu Roles v levém sloupci a v sekci Administrators klikne na Add Administrators. Poté může přidat nového admina podle jeho Facebook jména (musí ho mít v přátelích), nebo e-mailu.

 
3. Zadání údajů do H3.0 a vygenerování tokenu

  • v H3.0 běžte do menu Administrace / Nastavení / Propojení s ostatními systémy
  • nascrollujte až uvidíte položku Facebook (OAuth 2.0). Klikněte na tlačítko Nový
  • Zadejte veškeré údaje:
    • Název si vymyslete – měj by být poplatný k patřičnému Ad Accountu
    • APP ID a APP SECRET zjistíte ze Settings aplikace – viz bod 1)
    • ADACCOUNT ID zadejte podle toho jaký account chcete k patřičnému loginu přidat
  • Klikněte na OK pro uložení
  • Následují kroky obnovení Tokenu, ke kterým musíte být Administrátor propojující aplikace
  • Poté dejte ještě jednou Edit pro tento login a v dolní části u Access token expiration klikněte na tlačítko Refresh. Systém vás nechá přihlásit se do Facebooku a když všechno dobře dopadne, tak vám dá token a všechno bude nádherný a hotový
  • Tento vygenerovaný Token platí cca 2 měsíce. Proto doporučujeme nastavit si připomínátko a každých několik týdnů tento Token obnovit tlačítkem Refresh v editaci daneho FB API loginu.

UPDATE: od podzimu 2018 vyžaduje Facebook další povolení, o které je nutné žádat zvlášť a je popsáno ve zvláštním článku zde: http://www.hondzyk.com/wiki/2018/10/16/jak-si-nechat-schvalit-nove-povoleni-od-facebooku-pro-cteni-statistik/