Bonjour à tous, si vous êtes engagé dans le marketing Internet, vous devrez probablement faire face à de nombreux services publicitaires et au moins une plate-forme d'analyse Web chaque jour, si vous avez besoin de résumer les dépenses au moins une fois par mois, voire une fois par semaine, et d'autres statistiques informations provenant de toutes les sources, cela est non seulement lourd de coûts en temps, mais la probabilité d'erreur lors de la consolidation des données de plusieurs sources en mode manuel est assez élevée. Dans cet article, je vais vous dire des extensions (packages) prêtes à l'emploi pour le langage R, avec lesquelles vous pouvez automatiser le processus de collecte de données à partir des systèmes publicitaires et des plateformes d'analyse Web les plus populaires.

Le contenu

1. De quel logiciel avons-nous besoin
2. Comment démarrer avec les packages R
3. CRAN ou GitHub
4. Quelles compétences sont nécessaires pour travailler avec les packages R
5. ryandexdirect - chargement de données depuis Yandex.Direct
   
   • Caractéristiques du package ryandexdirect
   • Fonctions principales
   • Exemple de code pour télécharger des statistiques à l'aide du package ryandexdirect
6. RAdwords - chargement de données à partir de Google Ads (ex Google AdWords)
   
   • Caractéristiques de RAdwords
   • Caractéristiques clés de RAdwords
   • Exemple de travail avec le package RAdwords
7. adwordsR - un package plus récent et plus fonctionnel pour le téléchargement = et les données de Google Ads (ex Google AdWords)
   
   • Caractéristiques du package AdwordsR
   • Fonctionnalités clés d'AdWordsR
   • Exemple de package AdwordsR
8. rfacebookstat - télécharger des données à partir des tableaux de bord publicitaires Facebook
   
   • Caractéristiques du package Rfacebookstat
   • Principales fonctionnalités de rfacebookstat
   • Exemple de code pour travailler avec rfacebookstat
9. rvkstat - chargement de données à partir de l'API Vkontakte
   
   • Fonctionnalités du package Rvkstat
   • Les principales fonctions du package rvkstat
   • Exemple de code pour travailler avec le package rvkstat
10. rmytarget - chargement de données depuis l'API MyTarget
    
    • Caractéristiques du package Rmytarget
    • Les principales fonctions du package rmytarget
    • Exemple de code pour travailler avec rmytarget
11. rym - chargement de données à partir de l'API Yandex.Metrica
    
    • Fonctionnalités clés du package rym
    • Les principales fonctions du package rym
    • Exemple de travail avec le package rym
12. Conclusion

De quel logiciel avons-nous besoin

Parce que dans cet article, nous parlons du langage R, alors vous avez besoin de R lui-même et de l'environnement de développement RStudio .

Le langage R et RStudio sont des logiciels gratuits et librement distribués, vous pouvez donc les télécharger librement à partir des sites officiels.

Comment démarrer avec les packages R

Il n'y a rien de compliqué pour commencer à travailler avec les paquets R; cela se fait comme suit:

1. Installer un package, généralement avec la commande basique install.packages ;
2. En connectant le package, chaque fois que vous démarrez une nouvelle session avec R, cette opération peut être effectuée à l'aide de la library ou require commande.

La différence entre library et require est seulement que la library donnera une erreur si vous essayez de connecter un package que vous n'avez pas, et require dans ce cas affichera juste un avertissement, tandis que le script continuera à s'exécuter.

Pour installer les packages fournis dans l'article avec GitHub, vous devez d'abord installer le package devtools. Pour ce faire, exécutez la commande install.packages("devtools") .

CRAN ou GitHub

En lisant cet article, vous pouvez vous demander à partir de quel référentiel il est préférable d'installer tel ou tel package, en fait, sur GitHub, en règle générale, il existe les versions de développement les plus pertinentes des packages des développeurs, c'est-à-dire ils ont toutes les nouvelles fonctions qui peuvent ne pas être disponibles dans la version de package disponible sur CRAN, mais en conséquence, la version de développement peut ne pas être suffisamment testée au moment du chargement et contenir des erreurs.

Avant le téléchargement, la version de CRAN est soigneusement vérifiée par une équipe de spécialistes et doit respecter toutes les exigences de la politique de ce référentiel . Si vous téléchargez un package à partir de CRAN, vous pouvez être sûr qu'il ne nuira pas à vos données, ne créera aucun fichier incompréhensible sur votre PC etc.

Quelles compétences sont nécessaires pour travailler avec les packages R

En fait, il vous suffit de comprendre le domaine du marketing Internet, aucune compétence en programmation n'est requise dans ce cas, car nous allons parler de packages prêts à l'emploi, en utilisant des fonctions à partir desquelles vous pouvez automatiser la partie ruine de votre travail.

L'article n'aura pas de description détaillée de l'utilisation de chaque fonction des packages en question, car un tel article serait trop long, mais je décrirai les capacités de chaque paquet, je donnerai une liste des principales fonctions dont vous aurez besoin, et je donnerai également un lien vers la documentation officielle, avec laquelle vous pouvez déjà traiter plus en détail toutes les fonctions disponibles dans un paquet particulier . De plus, je vais donner un petit exemple de code pour chaque paquet, afin que vous puissiez comprendre la syntaxe plus clairement.

ryandexdirect - chargement de données depuis Yandex.Direct

Installation d'un package avec CRAN: install.packages("ryandexdirect")
Installer un paquet depuis GitHub: devtools::install_github("selesnow/ryandexdirect")
Documentation officielle: lien

Ce package est conçu pour fonctionner avec l'API de l'une des plateformes publicitaires les plus populaires du CIS - Yandex.Direct.

Caractéristiques du package ryandexdirect

1. Autorisation dans l'API Yandex;
2. Téléchargez une liste de campagnes publicitaires, mots clés, annonces;
3. Téléchargez des statistiques à partir des comptes Yandex.Direct à l'aide du service Rapports .
4. Arrêtez et reprenez les annonces au niveau des campagnes publicitaires, des mots clés et des annonces.
5. Demande de solde de fonds et autres paramètres du compte général.
6. Téléchargement des informations de référence (taux de change, annuaire géographique, etc.)

Fonctions principales

Les principales fonctions disponibles dans ryandexdirect, dont vous pourriez avoir besoin pour travailler avec l'API Yandex.Direct:

• yadirAuth - Autorisation dans l'API;
• yadirGetAds , yadirGetCampaignList , yadirGetKeyWords - Téléchargez une liste d'annonces, de campagnes publicitaires, de mots clés;
• yadirGetReport - Téléchargez les statistiques de Yandex.Direct.
• yadirGetDictionary - Téléchargez les informations d'aide.
• yadirStartAds , yadirStartCampaigns , yadirStartKeyWords -

 library(ryandexdirect) stat <- yadirGetReport(ReportType = "ACCOUNT_PERFORMANCE_REPORT", DateRangeType = "CUSTOM_DATE", DateFrom = "2018-01-01", DateTo = "2018-05-10", FieldNames = c("AdNetworkType", "Impressions", "Clicks", "Cost"), FilterList = c("CampaignId IN 123456 ,987654","Clicks GREATER_THAN 100"), IncludeVAT = "YES", IncludeDiscount = "NO", Login = " ", TokenPath = "C:/token_yandex") 

Vous pouvez en savoir plus sur chaque argument à l'aide de l'aide officielle du service Rapports d'API ryandexdirect ou Yandex.Direct.

RAdwords - chargement de données à partir de Google Ads (ex Google AdWords)

Installation d'un package avec CRAN: install.packages("RAdwords")
Installer un paquet depuis GitHub: devtools::install_github("jburkhardt/RAdwords")
Documentation officielle: lien

Caractéristiques de RAdwords

La principale caractéristique de ce package est l'autorisation dans l'API Google Ads et le téléchargement des statistiques de tous les rapports disponibles dans cette interface.

Caractéristiques clés de RAdwords

En fait, le package, en principe, ne contient pas beaucoup de fonctions, mais pour le moment, je n'en ai utilisé que trois:

• doAuth - Autorisation;
• statement - Formation du corps de la demande à l'API;
• getData - Chargement des données à partir de l'API.

 library(RAdwords) #   adw_token <- doAyth() #   body <- statement(select=c('AccountDescriptiveName', 'ExternalCustomerId', 'AccountCurrencyCode', 'AdNetworkType1', 'RegionCriteriaId', 'CountryCriteriaId', 'CityCriteriaId', 'Device', 'Month', 'Year', 'Impressions', 'Clicks', 'Interactions', 'VideoViews', 'Cost', 'Conversions' ), report="GEO_PERFORMANCE_REPORT", start="2018-09-01", end="2018-09-20") my_data <- getData(clientCustomerId = "000-000-0000", google_auth = adw_token , statement = body, transformation = T) 

La liste des rapports disponibles dans l'API et les champs Google Ads se trouve sur le lien dans l'aide officielle.

adwordsR - un package plus récent et plus fonctionnel pour le téléchargement = et les données de Google Ads (ex Google AdWords)

Installation d'un package avec CRAN: install.packages("adwordsR")
Installer un paquet avec GitHub: devtools::install_github("cran/adwordsR")

Le package adwordsR a une signification similaire à RAdwords, mais il est plus récent et possède un ensemble de fonctions beaucoup plus large.

Caractéristiques du package AdwordsR

En plus des fonctionnalités du package RAdwords décrites ci-dessus, adwordsR vous offre de nombreuses opportunités de travailler avec TargetingIdeaService, un service avec lequel vous pouvez obtenir des options de ciblage directement à partir d'un outil ou d'une plateforme, ce qui permet d'automatiser l'optimisation de compte.

Fonctionnalités clés d'AdWordsR

• generateAdwordsToken - Demandez un jeton pour travailler avec l'API Google Ads;
• loadAdwordsToken - Téléchargez le jeton demandé et précédemment enregistré;
• getReportData - Téléchargez des statistiques à partir d'un compte Google Ads.

 library(adwordsR) #   adw_token <- generateAdwordsToken(saveNewToken = TRUE, addGitignore = FALSE) #     adw_token <- loadAdwordsToken() #   AdWordsData <- getReportData(reportType = "CAMPAIGN_PERFORMANCE_REPORT", startDate = "2018-08-01", endDate = "2018-08-15", clientCustomerId = "000-000-0000", credentials = adw_token, attributes = "CampaignName,CampaignStatus", segment = "Date,AdNetworkType1", metrics = "AverageCost,Clicks,Conversions", includeZeroImpressions = TRUE, useRequestedHeaders = FALSE) 

rfacebookstat - télécharger des données à partir des tableaux de bord publicitaires Facebook

Installation d'un package avec CRAN: install.packages("rfacebookstat")
Installer un paquet depuis GitHub: devtools::install_github("selesnow/rfacebookstat")
Documentation officielle: lien

Caractéristiques du package Rfacebookstat

1. Connexion à l'API Facebook
2. Téléchargez la liste des chefs d'entreprise à votre disposition;
3. Téléchargez une liste de comptes publicitaires;
4. Téléchargez une liste de campagnes publicitaires, de groupes d'annonces et d'annonces.
5. Téléchargez des statistiques au niveau d'un compte publicitaire, des campagnes publicitaires, des groupes d'annonces et des annonces.
6. Téléchargez une liste d'utilisateurs ayant accès à un compte publicitaire.
7. Gérez l'accès aux comptes publicitaires.

Principales fonctionnalités de rfacebookstat

• fbGetToken - Autorisation dans l'API Facebook;
• fbGetBusinessManagers - Télécharger une liste de chefs d'entreprise;
• fbGetAdAccounts - Télécharger une liste de comptes publicitaires;
• fbGetCampaigns , fbGetAds , fbGetAdSets - Télécharger une liste de campagnes publicitaires, annonces et groupes d'annonces;
• fbGetMarketingStat - Téléchargez les statistiques des comptes publicitaires Facebook.

 library(rfacebookstat) token <- fbGetToken(app_id = 00000000000000) fb_data <- fbGetMarketingStat(accounts_id = "act_00000000000000", level = "campaign", fields = "campaign_name,actions", action_breakdowns = "action_link_click_destination", date_start = "2017-11-01", date_stop = "2017-11-20", interval = "day", access_token = token) 

rvkstat - chargement de données à partir de l'API Vkontakte

Installer un paquet depuis GitHub: devtools::install_github("selesnow/rvkstat")
Documentation officielle: lien

Un package suffisamment puissant et multifonctionnel pour travailler avec l'API du réseau social Vkontakte.

Fonctionnalités du package Rvkstat

1. Autorisation dans Vkontakte API;
2. Téléchargez les données des comptes publicitaires de Vkontakte;
3. Téléchargement des informations d'aide de Vkontakte;
4. Télécharger des informations sur l'utilisateur Vkontakte;
5. Téléchargez les statistiques du compte publicitaire de Vkontakte;
6. Téléchargez des statistiques sur les visites dans les communautés Vkontakte.

Les principales fonctions du package rvkstat

Le paquet rvkstat au moment de l'écriture contient plus de 30 fonctions, voici les plus utiles d'entre elles:

• vkAuth - Autorisation;
• vkGetAdStatistics - Télécharger des statistiques à partir d'un vkGetAdStatistics publicitaire;
• vkGetAdCampaigns , vkGetAds - Téléchargez une liste de campagnes publicitaires et d'annonces;
• vkGetGroupStat - Téléchargez des statistiques sur les visites aux groupes et communautés de Vkontakte.

 library(rvkstat) my_tok <- vkAuth(app_id = 111,app_secret = "efbscuyewb7cb4ru4bj") #    camp <- vkGetAdCampaigns(account_id = 1, access_token = my_tok$access_token) #     vk_stat_by_campaign <- vkGetAdStatistics(account_id = 1, ids_type = "campaign", ids = camp$id , period = "day", date_from = "2010-01-01", date_to = "2017-09-10", access_token = my_tok$access_token) 

rmytarget - chargement de données depuis l'API MyTarget

Installation d'un package avec CRAN: install.packages("rmytarget")
Installer un paquet depuis GitHub: devtools::install_github("selesnow/rmytarget")
Documentation officielle: lien

Caractéristiques du package Rmytarget

1. Autorisation dans l'API MyTarget selon le schéma d'attribution de code;
2. Téléchargez une liste de campagnes publicitaires, annonces.
3. Téléchargez des statistiques au niveau des campagnes publicitaires et des publicités.

Les principales fonctions du package rmytarget

• myTarAuth - Autorisation;
• myTarGetAdList , myTarGetCampaignList - Téléchargez une liste d'annonces et de campagnes publicitaires;
• myTarGetStats - Téléchargez des statistiques sur les annonces et les campagnes.

 library(rmytarget) #    Ads <- myTarGetAdList(login = " ") #     a_stat <- myTarGetStats(date_from = "2016-08-01", date_to = "2016-08-10", object_type = "banners", object_id = Ads$id, stat_type = "day", login = " ") 

rym - chargement de données à partir de l'API Yandex.Metrica

Installation d'un package avec CRAN: install.packages("rym")
Installer un paquet depuis GitHub: devtools::install_github("selesnow/rym")
Documentation officielle: lien

Fonctionnalités clés du package rym

Le package rym vous permet de travailler avec toutes les API disponibles dans Yandex.Metrica:

1. Autorisation du protocole OAuth2
2. Travailler avec l' API de gestion ;
3. Travailler avec l'API de rapports ;
4. Travailler avec une API compatible avec l'API principale Google Analytics v3 ;
5. Travailler avec l' API Logs .

Les principales fonctions du package rym

• rym_auth - Autorisation;
• rym_get_counters - Télécharge une liste de compteurs Yandex.Metrica;
• rym_get_data - Chargement des données à partir des rapports API;
• rym_get_ga - Chargement des données depuis l'API compatible avec l'API principale Google Analytics;
• rym_get_logs - Chargement de données brutes à partir de l'API Logs.

 reporting.api.stat <- rym_get_data(counters = "00000000,111111111", date.from = "2018-08-01", date.to = "yesterday", dimensions = "ym:s:date,ym:s:lastTrafficSource", metrics = "ym:s:visits,ym:s:pageviews,ym:s:users", filters = "ym:s:trafficSourceName=='   ' AND ym:s:isNewUser=='Yes'", sort = "-ym:s:date", accuracy = "full", login = " ", token.path = "metrica_token", lang = "ru") 

Conclusion

Ainsi, à l'aide des packages fournis dans cet article, vous pouvez bien automatiser la collecte de données à partir de sources telles que Yandex.Direct, Google Ads, Facebook, Vkontakte, MyTarget et Yandex.Metrica. Bien sûr, il ne s'agit pas d'une liste exhaustive des services utilisés par les spécialistes du marketing en ligne, mais pour intégrer tous les outils dans un seul article est assez problématique, donc si cet article obtient des critiques positives, j'écrirai une suite.

De plus, les données obtenues peuvent être converties à l'aide du package dplyr et écrites dans diverses bases de données à l'aide de l'interface DBI, mais ce sont déjà des sujets assez longs pour les prochains articles.

Si vous avez également des packages intéressants dans votre arsenal qui peuvent aider à automatiser la collecte de données à partir de sources publicitaires ou de plateformes d'analyse Web, laissez-les dans les commentaires de cet article.

Abonnez-vous à mes chaînes de télégramme et youtube , dont la plupart du contenu sont des documents utiles sur la langue R.