R este un limbaj de programare pentru prelucrarea datelor statistice și grafică, precum și un mediu liber de calcul open source în cadrul proiectului GNU. Utilizatorii zilnice oferă noi pachete utile pentru accesul liber, astfel încât biblioteca pachetelor R este bogată și extinde semnificativ capacitățile de bază ale limbii.
Am scris o serie de funcții pentru a lucra cu API-ul Facebook și le-am colectat în pachetul rfacebookstat. Disponibil în acces gratuit pe GitHub.
1. Creați o aplicație pe Facebook
1.1. Pentru a începe cu API-ul Facebook, trebuie să adăugați o nouă aplicație. Pentru a face acest lucru, mergeți la meniul din partea stângă și în secțiunea "Dezvoltator" selectați comanda "Gestionați aplicațiile".
1.2. În biroul dezvoltatorului, faceți clic pe butonul "+ Adăugați o aplicație nouă".
1.3. Apoi, veți merge la meniul "Instalarea și configurarea produsului". Faceți clic pe butonul "Start" de lângă "Logați-vă prin Facebook".
1.4. Accesați setările aplicației. În fila "De bază" există informații despre ID-ul și secretul aplicației care vor fi necesare pentru a lucra cu API-ul.
În această filă, completați și câmpurile:
Puteți specifica un nume arbitrar pentru aplicație și completați restul câmpurilor ca în exemplul de mai jos.
1.5. În partea de jos a ferestrei, dați clic pe Adăugați platformă.
Din lista de platforme propuse, selectați un site Web.
Dacă aveți nevoie de acces complet la API, aici este o instrucțiune detaliată.
2. Instalați pachetul rfacebookstat
Pachetul rfacebookstat este disponibil gratuit în depozitul GitHub.
2.1. Pentru a instala pachetele cu GitHub, instalați mai întâi pachetul devtools utilizând comanda standard install.packages.
2.2. Conectați pachetul devtools și îl instalați utilizând pachetul rfacebookstat.
3. Obțineți un jeton pentru a lucra cu API-ul Facebook
Pentru a începe cu API-ul Facebook, rămâne să obțineți un jeton de acces. Pentru aceasta, utilizați funcția fbGetToken din pachetul rfacebookstat.
3.1. În fila "Setări" -> "General", obțineți ID-ul aplicației dvs. și introduceți-o în exemplul de mai jos, în loc de 00000000000000.
3.2. Poate că pentru prima dată când primiți un jeton, veți fi dus la o pagină de avertizare că anumite permisiuni nu au fost încă aprobate pentru utilizarea de către Facebook. Săriți acest avertisment cu butonul "Continuați ca. “.
Confirmați datele de conectare prin Facebook.
Introduceți tokenul în consola R ca răspuns la promptul "Introduceți tokenul".
Tokenul primit va funcționa câteva ore, dar îl puteți modifica pe un token pe termen lung utilizând funcția fbGetLongTimeToken.
3.4. Înlocuiți ClientID-ul și secretul aplicației, precum și obiectul la care a fost salvat jetonul primit. În acest exemplu, am creat un obiect token.
Tokenul pe termen lung va fi valabil timp de două luni.
Am finalizat faza pregătitoare și putem continua direct la importul de date.
4.1. sintaxă
4.2. Argumente funcționale
4.2.2. sortarea - sortarea datelor. Argument opțional. La intrare se ia o listă de câmpuri și direcția de sortare (în ordine ascendentă sau descendentă). Exemplu: reach_descending, impressions_ascending.
4.2.3. nivel - nivelul detaliat al datelor. Argumentul necesar. Este nevoie de anunțuri, anunțuri, campanii, valori ale contului. Exemplu - nivel = "cont".
4.2.4. câmpuri - lista câmpurilor pentru care intenționați să primiți date. Argumentul necesar. Exemplu: fields = "account_id, account_name, campaign_name, impressions, unique_impressions, clicks, unique_clicks, reach, spend".
Lista câmpurilor disponibile în versiunea API 2.8. consultați tabelul de mai jos sau documentația oficială.
4.2.5. defalcarea este un argument prin care puteți obține date defalcate pe segmente diferite. Puteți sparge informațiile în următoarele secțiuni:
- vârstă;
- țară;
- gen;
- frequency_value;
- hourly_stats_aggregated_by_advertiser_time_zone;
- hourly_stats_aggregated_by_audience_time_zone;
- impression_device;
- place_page_id;
- plasare;
- DEVICE_PLATFORM;
- product_id;
- regiune;
- acțiuni;
- publisher_platform;
- platform_position;
- impression_device.
Într-o interogare, puteți combina mai multe felii. În prezent sunt disponibile următoarele combinații:
Câmpurile marcate cu un asterisc "*" pot fi solicitate împreună cu action_type, action_target_id și destinație_acțiune.
- action_type *;
- action_target_id *;
- action_device *;
- acțiune_devineală, plasare *;
- acțiune_dezvoltare, plasare, afișare_dezvoltare *;
- 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;
- vârsta *;
- sex *;
- vârstă, sex *;
- țară *;
- regiunea *;
- plasare *;
- plasarea, afișarea_dezvoltării *;
- 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, destinație de plasare;
- action_carousel_card_id / action_carousel_card_name, destinație de plasare, opțiune de afișare;
- action_carousel_card_id / action_carousel_card_name, țară;
- action_carousel_card_id / action_carousel_card_name, vârstă;
- action_carousel_card_id / action_carousel_card_name, sex;
- action_carousel_card_id / action_carousel_card_name, vârstă, sex.
Exemplu: defalcări = "regiune"
4.2.6. filtrare - filtru de date. Argument opțional. Filtrele sunt specificate ca obiecte JSON "cheie: valoare". Este necesar să scrieți trei proprietăți:
- câmpul - câmpul prin care se filtrează;
- operatorul - operatorul boolean (, 'NOT_EQUAL', 'GREATER_THAN' 'EGAL',, 'LESS_THAN_OR_EQUAL', 'IN_RANGE' 'GREATER_THAN_OR_EQUAL', 'LESS_THAN', 'NOT_IN_RANGE', 'CONȚINE', 'NOT_CONTAIN', 'IN', 'NOT_IN', 'orice', 'toate', 'Niciuna');
- valoare - valoarea prin care câmpul specificat va fi filtrat.
4.2.7. date_start - data de începere a perioadei de raportare în formatul YYYY-MM-DDD.
4.2.8. date_stop - data de încheiere a perioadei de raportare în formatul AAAA-MM-DDD.
4.2.9. api_version este versiunea API-ului Facebook.
4.2.10. access_token - jet de acces.
5. Exemple de utilizare a funcției fbGetMarketingStat
5.1. Înainte de a rula exemplele de mai jos, generați un jeton API și salvați-l în obiectul token.
5.3. Obține statistici privind numărul de afișări unice, clicuri unice, filtru după grupa de vârstă „18-24“, „25-34“, și sorta datele în ordinea numărului de accesări unice (câmp) unique_impressions descendent.
Folosind API-ul Facebook și un pachet de funcții din R-bookbookstat, veți putea:
Buna ziua Alexey. Multumesc pentru articol. Doar master studio R.Podskazhite vă rog. Cum obtin datele de conversie?
De exemplu, pe site există un pixel Facebook și există deja evenimente în el, totul fiind urmărit cu succes. Dar nu înțeleg cum să obțin datele de la API.
Iată o funcție de exemplu
CampaignStat <- fbGetMarketingStat( accounts_id = "act_00000000000",
access_token = long_token)
Un mic google mi-am dat seama că trebuie să iei date ca asta prin action_type sau prin acțiuni: offsite_conversion.fb_pixel_purchase
În general, aș fi foarte recunoscător dacă îmi spui o bucată de cod în care trebuie să introduci pentru a trage conversia.
O zi bună, cu conversii acolo este mult mai dificil dacă trebuie să le rupeți după tip, adică dacă doriți să obțineți toate conversiile, adăugați doar câmpul de acțiuni în argumentul câmpurilor.
Pentru a putea întrerupe conversia de tip prin defalcări, trebuie să modificați funcția, poate pentru că va fi un timp liber pe care îl voi face.
Vă mulțumim pentru articolul excelent. La mine o astfel de întrebare, Managerul anunțurilor scrie că ctr = 7,45%, iar în rtudio ctr a aceleiași эдсета este egal cu 9%. Pe cine să credem?