Как да заредим статистиката от рекламни кампании във Facebook с помощта на API и езика за програмиране R

Популярността на Facebook като рекламоносител стремително расте, но анализирането на статистиката в рекламния профил е неудобно. Един от алтернативните начини е да се изтеглят статистическите данни в R и да се визуализират. В тази статия подробно ще разкажа как да получите данни от Facebook API и да работите с тях в R.

Написах редица функции за работа с Facebook API и ги събрах в пакет rfacebookstat, който е достъпен свободно на GitHub.

1. Създайте приложение във Facebook

1.1. За да започнете работа с Facebook API, трябва да добавите ново приложение. За целта отидете в лявото меню и в раздел «Разработчик» изберете команда «Manage Apps».

1.2. В профила на разработчика натиснете бутон «+ Add a New App».

Попълнете полето «Видимо име на приложение», «Е-адрес за връзка», «Категория» и натиснете «Създайте ID на приложението».

1.3. По-нататък попадате в меню «Product Setup». Кликнете върху бутона «Get Started» срещу позицията «Facebook Login».

1.4. Преминете към настройките на приложението. Във вложката «Basic» се намира информация за ID и App Secret на приложението, което ще е нужно за работа с API.

На тази вложка също така запълнете полетата:

• «Видимо име»;
• «Домейни на приложението»;
• «Е-адрес за връзка»;
• «URL- адреса на политиката за конфиденциалност»;
• «URL- адрес на Потребителското споразумение».

Можете да въведете произволно име на приложението, а останалите полета да попълните, както е показано в примера по-долу.

1.5. В долната част на прозореца натиснете «+ Add Platform».

От списъка с предложени платформи изберете уеб-сайт.

В полето «Site URL» въведете «https://github.com/selesnow/rfacebookstat» и натиснете «Save Changes».

1.6. В менюто на приложението преминете към раздела «Facebook Login». В полето «Valid OAuth redirect URIs» въведете «https://www.facebook.com/connect/login_success.html».

1.7. След това трябва да изберете, от какви рекламни акаунти ще получавате статистиката през API и да копирате техните ID.

Преминете в раздел «Настройки» —> «Допълнително» и в блока «Рекламни акаунти» натиснете бутона «API Ads».

В отворения прозорец въведете ID на избраните рекламни акаунти.

На този етап получихте ниво на достъп до API «Development» и можете да работите с максимум пет рекламни акаунта.

2. Инсталирайте пакета rfacebookstat

Пакета rfacebookstat е достъпен свободно в хранилището GitHub.

2.1. За да инсталирате пакети от GitHub предварително инсталирайте пакета devtools с помощта на стандартната команда install.packages.

install.packages("devtools")

2.2. Включете пакета devtools и го инсталирайте с помощта на пакета rfacebookstat.

library(devtools)install_github('selesnow/rfacebookstat')library(rfacebookstat)

3. Получете токен за работа с API Facebook

За да започнете работа с Facebook API, остава да получите токен за достъп. За целта използвайте функцията fbGetToken в пакета rfacebookstat.

3.1. На вложката «Настройки» —> «Основно» получете ID на Вашето приложение и го въведете в примера по-долу вместо 00000000000000.

token <- fbGetToken(app_id = 00000000000000)

3.2. Възможно е, когато получавате токен, да попаднете на страница с предупреждение, че някои разрешения още не са одобрени за използване от Facebook. Пропуснете това предупреждение с помощта на бутона «Продължете като, ...».

Потвърдете входа чрез Facebook.

3.3. След това копирайте генерирания токен за достъп до API. Той ще се появи в адресния ред на Вашия браузър в параметъра access_token.

Вмъкнете токена в R конзолата, като отговор на запитването «Enter your token».

Получения токен ще действа в течение на няколко часа, но Вие можете да го смените на дългосрочен токен с помощта на функцията fbGetLongTimeToken.

3.4. Въведете вашия ClientID и App Secret за приложението, а също така обекта, в който сте съхранили получения токен. В показания пример създадох обект token.

longtime_token <- fbGetLongTimeToken(                                                               
 client_id = 00000000000000,                                                                
client_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",                                                                
fb_exchange_token = token)

Дългосрочният токен ще е действителен за срок от два месеца.

4. Получете статистика от рекламните акаунти във Facebook

Ние приключихме подготвителния етап и можем да преминем директно към импорта на данни.

Основната функция на пакета rfacebookstat е fbGetMarketingStat. Да разгледаме по-подробно работата с тази функция, защото с нейна помощ могат да се получат всякакви данни за рекламния акаунт.

4.1. Синтаксис

stat <- fbGetMarketingStat(accounts_id = "act_0000000000",                                          
sorting = NULL,                                          
level = "account",                                          
breakdowns = NULL,                                            
fields = 
"account_id,account_name,campaign_name,impressions,unique_impressions,clicks,unique_clicks,reach,spend",                                           filtering = NULL,                                           date_start = Sys.Date() — 30,                                           date_stop = Sys.Date(),                                           
api_version = "v2.8",                                           
access_token = NULL)

4.2. Аргументи на функции

4.2.1. accounts_id — ID на рекламния акаунт. Това е задължителен аргумент. Вие можете да го получите от URL, ако преминете в нужния рекламен Facebook акаунт.

Въвеждайте ID на акаунта с приставка «act_», както е в примера: accounts_id = "act_000000000000".

4.2.2. sorting — cортиране на данни. Незадължителен аргумент. На входа приема списък полета и направлението на сортиране (по нарастване или по намаляване). Пример: reach_descending, impressions_ascending.

4.2.3. level — ниво на детайлизация на данните. Задължителен аргумент. Приема значения ad, adset, campaign, account. Пример — level = "account".

4.2.4. fields — списък полета, по които Вие планирате да получите данни. Задължителен аргумент. Пример: fields = "account_id,account_name,campaign_name,impressions,unique_impressions,clicks,unique_clicks,reach,spend".

Списъка с достъпни полета във версия API 2.8. вижте в таблицата по-долу или в официалната документация.

Покажи таблицата

4.2.5. breakdowns — аргумент, с чиято помощ може да получите данни в разбивка на различни сегменти. Може да се разделя информацията по следните срезове:

• age;
• country;
• gender;
• frequency_value;
• hourly_stats_aggregated_by_advertiser_time_zone;
• hourly_stats_aggregated_by_audience_time_zone;
• impression_device;
• place_page_id;
• placement;
• device_platform;
• product_id;
• region;
• actions;
• publisher_platform;
• platform_position;
• impression_device.

В едно запитване може да се комбинират няколко среза. В този момент са достъпни следните комбинации:

• action_type *;
• action_target_id *;
• action_device *;
• action_device, placement *;
• action_device, placement, impression_device *;
• action_device, publisher_platform *;
• action_device, publisher_platform, impression_device *;
• action_device, publisher_platform, platform_position *;
• action_device, publisher_platform, platform_position, impression_device *;
• action_reaction;
• action_type, action_reaction; age *;
• gender *;
• age, gender *;
• country *;
• region *;
• placement *;
• placement, impression_device *;
• publisher_platform *;
• publisher_platform, impression_device *;
• publisher_platform, platform_position *;
• publisher_platform, platform_position, impression_device *;
• product_id *;
• hourly_stats_aggregated_by_advertiser_time_zone *;
• hourly_stats_aggregated_by_audience_time_zone *;
• action_carousel_card_id / action_carousel_card_name; action_carousel_card_id / action_carousel_card_name, placement;
• action_carousel_card_id / action_carousel_card_name, placement, impression_device;
• action_carousel_card_id / action_carousel_card_name, country;
• action_carousel_card_id / action_carousel_card_name, age;
• action_carousel_card_id / action_carousel_card_name, gender;
• action_carousel_card_id / action_carousel_card_name, age, gender.

Пример: breakdowns = "region"

4.2.6. filtering — филтър за данни. Незадължителен аргумент. Филтрите се задават във вид на JSON обекти «ключ:значение». Трябва да се запишат три свойства:

• field — поле, по което ще се извършва филтрация;
• operator — логически оператор ('EQUAL', 'NOT_EQUAL', 'GREATER_THAN', 'GREATER_THAN_OR_EQUAL', 'LESS_THAN', 'LESS_THAN_OR_EQUAL', 'IN_RANGE', 'NOT_IN_RANGE', 'CONTAIN', 'NOT_CONTAIN', 'IN', 'NOT_IN', 'ANY', 'ALL', 'NONE');
• value — значения, по което ще се филтрира посоченото поле.

Пример: filtering = "[{'field':'publisher_platform','operator':'IN','value':['instagram']}]

4.2.7. date_start — начална дата на отчетния период във формат YYYY-MM-DDD.

4.2.8. date_stop — крайна дата на отчетния период във формат YYYY-MM-DDD.

4.2.9. api_version — версия на Facebook API.

4.2.10. access_token — токен за достъп.

5. Примери на използване на функции fbGetMarketingStat

5.1. Преди да стартирате описаните по-долу примери, генерирайте API-токен и го съхранете в обект token.

token <- fbGetToken(app_id = 00000000000000)

5.2. За да получите статистика за броя показвания, кликове и разходи за реклама на ниво акаунт и в разрез по региони, въведете следния код:

AccStat <- fbGetMarketingStat( accounts_id = «act_0000000000»,                                                       
level = "account",                                                       
fields = "account_id,account_name,impressions,clicks,spend",                                                       
breakdowns = "region",                                                       
date_start = "2016-11-01",                                                       
date_stop = "2016-11-30",                                                       
api_version = "v2.8",                                                       
access_token = token)

5.3. Получете статистика за количество уникални показвания и уникални кликове, с филтър по нарастване за групи «18-24», «25-34» и сортиране на данни, подредени по намаляване на броя уникални показвания (поле unique_impressions).

CampStat <-     fbGetMarketingStat(accounts_id = "act_0000000000",                          
level = "campaign",                          
fields = "campaign_name,unique_impressions,unique_clicks",                          
breakdowns = "age",                          
sorting = "unique_impressions_descending",                          
filtering = "[{'field':'age','operator':'IN','value':['18-24','25-34']}]",                          
date_start = "2016-10-01",                          
date_stop = "2016-10-10",                          
api_version = "v2.8",                          
access_token = token)

6. Изводи

Използвайки Facebook API и пакета с функции на език R rfacebookstat, Вие можете да:

• получите данни от своите рекламни акаунти, кампании, рекламии така нататък в множество различни разрези;
• строите, въз основа на получени данни, всякакви визуализации, използвайки цялата мощ на езика R;
• предавате получените данни в произволна база данни или да ги съхранявате във вид на CSV-файл.