Hallo allerseits, wenn Sie sich mit Internet-Marketing beschäftigen, müssen Sie sich wahrscheinlich jeden Tag mit vielen Werbediensten und mindestens einer Webanalyseplattform befassen, wenn Sie die Ausgaben mindestens einmal im Monat oder vielleicht sogar einmal pro Woche zusammenfassen müssen, sowie andere Statistiken Informationen aus allen Quellen sind nicht nur mit hohen Zeitkosten verbunden, sondern die Fehlerwahrscheinlichkeit bei der Konsolidierung von Daten aus mehreren Quellen im manuellen Modus ist recht hoch. In diesem Artikel werde ich Ihnen vorgefertigte Erweiterungen (Pakete) für die R-Sprache erläutern, mit denen Sie den Prozess der Datenerfassung von den gängigsten Werbesystemen und Webanalyseplattformen automatisieren können.

Inhalt

1. Welche Software brauchen wir?
2. Erste Schritte mit R-Paketen
3. CRAN oder GitHub
4. Welche Fähigkeiten sind erforderlich, um mit R-Paketen zu arbeiten?
5. ryandexdirect - Laden von Daten aus Yandex.Direct
   
   • Funktionen des ryandexdirect Pakets
   • Hauptfunktionen
   • Beispielcode zum Herunterladen von Statistiken mit dem Paket ryandexdirect
6. RAdwords - Laden von Daten aus Google Ads (ex Google AdWords)
   
   • Funktionen von RAdwords
   • RAdwords von RAdwords
   • Beispiel für die Arbeit mit dem Paket RAdwords
7. adwordsR - ein neueres und funktionaleres Paket zum Herunterladen = und Daten von Google Ads (ex Google AdWords)
   
   • AdwordsR-Paketfunktionen
   • Hauptmerkmale von adwordsR
   • Beispiel für ein AdWordsR-Paket
8. rfacebookstat - Daten von Facebook-Werbe-Dashboards herunterladen
   
   • Funktionen des Rfacebookstat-Pakets
   • Hauptmerkmale von rfacebookstat
   • Beispielcode für die Arbeit mit rfacebookstat
9. rvkstat - Laden von Daten aus der Vkontakte-API
   
   • Funktionen des Rvkstat-Pakets
   • Die Hauptfunktionen des rvkstat-Pakets
   • Beispielcode für die Arbeit mit dem Paket rvkstat
10. rmytarget - Laden von Daten aus der MyTarget-API
    
    • Funktionen des Rmytarget-Pakets
    • Die Hauptfunktionen des rmytarget-Pakets
    • Beispielcode für die Arbeit mit rmytarget
11. rym - Laden von Daten aus der Yandex.Metrica-API
    
    • Hauptmerkmale des Rym-Pakets
    • Die Hauptfunktionen des Rym-Pakets
    • Beispiel für die Arbeit mit dem Rym-Paket
12. Fazit

Welche Software brauchen wir?

Weil In diesem Artikel sprechen wir über die R-Sprache, dann benötigen Sie R selbst und die RStudio- Entwicklungsumgebung.

Sowohl die R-Sprache als auch RStudio sind kostenlose, frei verteilte Software, sodass Sie sie kostenlos von offiziellen Websites herunterladen können.

Erste Schritte mit R-Paketen

Es ist nicht kompliziert, mit R-Paketen zu arbeiten. Dies geschieht wie folgt:

1. Installieren eines Pakets, normalerweise mit dem grundlegenden Befehl install.packages ;
2. Wenn Sie das Paket verbinden, kann dieser Vorgang jedes Mal, wenn Sie eine neue Sitzung mit R starten, mithilfe der library oder require Befehl require .

Der Unterschied zwischen library und require besteht nur darin, dass die library einen Fehler ausgibt, wenn Sie versuchen, ein nicht vorhandenes Paket zu verbinden. In diesem Fall wird nur eine Warnung angezeigt, während das Skript weiterhin ausgeführt wird.

Um die im Artikel bereitgestellten Pakete mit GitHub zu installieren, müssen Sie zuerst das devtools-Paket installieren. Führen Sie dazu den Befehl install.packages("devtools") .

CRAN oder GitHub

Während Sie diesen Artikel lesen, haben Sie möglicherweise eine Frage, aus welchem ​​Repository es besser ist, dieses oder jenes Paket zu installieren. Tatsächlich gibt es auf GitHub in der Regel die relevantesten Entwicklungsversionen von Paketen von Entwicklern, d. H. Sie verfügen über alle neuen Funktionen, die möglicherweise nicht in der auf CRAN verfügbaren Paketversion verfügbar sind. Dementsprechend ist die Entwicklungsversion zum Zeitpunkt des Ladens möglicherweise nicht ausreichend getestet und enthält Fehler.

Vor dem Herunterladen wird die CRAN-Version von einem Team von Spezialisten sorgfältig geprüft und muss alle Anforderungen der Richtlinien dieses Repositorys erfüllen . Wenn Sie ein Paket von CRAN herunterladen, können Sie sicher sein, dass es Ihren Daten keinen Schaden zufügt und keine unverständlichen Dateien auf Ihrem Computer erstellt PC etc.

Welche Fähigkeiten sind erforderlich, um mit R-Paketen zu arbeiten?

In der Tat müssen Sie nur den Themenbereich Internet-Marketing verstehen, in diesem Fall sind keine Programmierkenntnisse erforderlich, weil Wir werden über vorgefertigte Pakete sprechen, die Funktionen verwenden, mit denen Sie den Ruin-Teil Ihrer Arbeit automatisieren können.

Der Artikel enthält keine detaillierte Beschreibung der Arbeit mit den einzelnen Funktionen der betreffenden Pakete, da Ein solcher Artikel wäre zu lang, aber ich werde die Funktionen jedes Pakets beschreiben, eine Liste der wichtigsten Funktionen geben, die Sie benötigen, und einen Link zur offiziellen Dokumentation geben, mit der Sie bereits alle in einem bestimmten Paket verfügbaren Funktionen detaillierter behandeln können . Außerdem werde ich für jedes Paket ein kleines Beispiel für Code geben, damit Sie die Syntax besser verstehen können.

ryandexdirect - Laden von Daten aus Yandex.Direct

Installieren eines Pakets mit CRAN: install.packages("ryandexdirect")
Installieren eines Pakets von GitHub: devtools::install_github("selesnow/ryandexdirect")
Offizielle Dokumentation: Link

Dieses Paket funktioniert mit der API einer der beliebtesten Werbeplattformen in der GUS - Yandex.Direct.

Funktionen des ryandexdirect-Pakets

1. Autorisierung in der Yandex-API;
2. Laden Sie eine Liste mit Werbekampagnen, Keywords und Anzeigen herunter.
3. Laden Sie Statistiken von Yandex.Direct-Konten mithilfe des Berichtsdienstes herunter.
4. Stoppen Sie Anzeigen auf der Ebene von Werbekampagnen, Keywords und Anzeigen und setzen Sie sie fort.
5. Antrag auf Guthaben und andere Parameter des allgemeinen Kontos.
6. Herunterladen von Referenzinformationen (Wechselkurse, geografisches Verzeichnis usw.)

Hauptfunktionen

Die wichtigsten in ryandexdirect verfügbaren Funktionen, die Sie möglicherweise benötigen, um mit der Yandex.Direct-API zu arbeiten:

• yadirAuth - Autorisierung in der API;
• yadirGetAds , yadirGetCampaignList , yadirGetKeyWords - Laden Sie eine Liste mit Anzeigen, Werbekampagnen und Keywords herunter.
• yadirGetReport - Laden Sie Statistiken von Yandex.Direct herunter.
• yadirGetDictionary - yadirGetDictionary herunterladen.
• 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") 

Weitere Informationen zu den einzelnen Argumenten erhalten Sie in der offiziellen Hilfe von ryandexdirect oder Yandex.Direct API Reports .

RAdwords - Laden von Daten aus Google Ads (ex Google AdWords)

Installieren eines Pakets mit CRAN: install.packages("RAdwords")
Installieren eines Pakets von GitHub: devtools::install_github("jburkhardt/RAdwords")
Offizielle Dokumentation: Link

Funktionen von RAdwords

Das Hauptmerkmal dieses Pakets ist die Autorisierung in der Google Ads-API und das Herunterladen von Statistiken aus allen in dieser Benutzeroberfläche verfügbaren Berichten.

Hauptmerkmale von RAdwords

Eigentlich enthält das Paket im Prinzip nicht sehr viele Funktionen, aber für die ganze Zeit habe ich nur drei verwendet:

• doAuth - Autorisierung;
• statement - Bildung des Hauptteils der Anforderung an die API;
• getData - Laden von Daten aus der 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) 

Die Liste der in der Google Ads-API und in den Feldern verfügbaren Berichte finden Sie unter dem Link in der offiziellen Hilfe.

adwordsR - ein neueres und funktionaleres Paket zum Herunterladen = und Daten von Google Ads (ex Google AdWords)

Installieren eines Pakets mit CRAN: install.packages("adwordsR")
Installieren eines Pakets mit GitHub: devtools::install_github("cran/adwordsR")

Das adwordsR-Paket hat eine ähnliche Bedeutung wie RAdwords, ist jedoch neuer und verfügt über einen viel größeren Funktionsumfang.

AdwordsR-Paketfunktionen

Zusätzlich zu den oben beschriebenen Funktionen des RAdwords-Pakets bietet Ihnen adwordsR zahlreiche Möglichkeiten, mit TargetingIdeaService zu arbeiten. Mit diesem Service können Sie Targeting-Optionen direkt von einem Tool oder einer Plattform abrufen, um die Kontooptimierung zu automatisieren.

Hauptmerkmale von adwordsR

• generateAdwordsToken - Fordern Sie ein Token für die Arbeit mit der Google Ads-API an.
• loadAdwordsToken - Laden Sie das angeforderte und zuvor gespeicherte Token herunter.
• getReportData - Laden Sie Statistiken von einem Google Ads-Konto herunter.

 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 - Daten von Facebook-Werbe- Dashboards herunterladen

Installieren eines Pakets mit CRAN: install.packages("rfacebookstat")
Installieren eines Pakets von GitHub: devtools::install_github("selesnow/rfacebookstat")
Offizielle Dokumentation: Link

Funktionen des Rfacebookstat-Pakets

1. Facebook API Login
2. Laden Sie eine Liste der Business Manager herunter, die Ihnen zur Verfügung stehen.
3. Laden Sie eine Liste der Werbekonten herunter.
4. Laden Sie eine Liste mit Werbekampagnen, Anzeigengruppen und Anzeigen herunter.
5. Laden Sie Statistiken auf der Ebene eines Werbekontos, von Werbekampagnen, Anzeigengruppen und Anzeigen herunter.
6. Laden Sie eine Liste der Benutzer herunter, die Zugriff auf ein Werbekonto haben.
7. Verwalten Sie den Zugriff auf Anzeigenkonten.

Hauptmerkmale von rfacebookstat

• fbGetToken - Autorisierung in der Facebook-API;
• fbGetBusinessManagers - Laden Sie eine Liste der Business Manager herunter.
• fbGetAdAccounts - Laden Sie eine Liste der Werbekonten herunter.
• fbGetCampaigns , fbGetAds , fbGetAdSets - Laden Sie eine Liste mit Werbekampagnen, Anzeigen und Anzeigengruppen herunter.
• fbGetMarketingStat - Laden Sie Statistiken von Facebook-Werbekonten herunter.

 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 - Laden von Daten aus der Vkontakte-API

Installieren eines Pakets von GitHub: devtools::install_github("selesnow/rvkstat")
Offizielle Dokumentation: Link

Ein ausreichend leistungsfähiges und multifunktionales Paket für die Arbeit mit der API des sozialen Netzwerks Vkontakte.

Funktionen des Rvkstat-Pakets

1. Autorisierung in der Vkontakte API;
2. Laden Sie Daten von Vkontakte-Werbekonten herunter.
3. Herunterladen von Hilfeinformationen von Vkontakte;
4. Herunterladen einiger Informationen über den Vkontakte-Benutzer;
5. Laden Sie Statistiken vom Vkontakte-Werbekonto herunter.
6. Laden Sie Statistiken über Besuche in Vkontakte-Communities herunter.

Die Hauptfunktionen des rvkstat-Pakets

Das rvkstat-Paket enthält zum Zeitpunkt des Schreibens mehr als 30 Funktionen. Hier sind die nützlichsten:

• vkAuth - Autorisierung;
• vkGetAdStatistics - Laden Sie Statistiken von einem Werbekonto herunter.
• vkGetAdCampaigns , vkGetAds - Laden Sie eine Liste mit Werbekampagnen und Anzeigen herunter.
• vkGetGroupStat - Laden Sie Statistiken über Besuche in Gruppen und Communities von Vkontakte herunter.

 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 - Laden von Daten aus der MyTarget-API

Installieren eines Pakets mit CRAN: install.packages("rmytarget")
Installieren eines Pakets von GitHub: devtools::install_github("selesnow/rmytarget")
Offizielle Dokumentation: Link

Funktionen des Rmytarget-Pakets

1. Autorisierung in der MyTarget-API mithilfe des Code Grant-Schemas;
2. Laden Sie eine Liste mit Werbekampagnen und Anzeigen herunter.
3. Laden Sie Statistiken auf der Ebene von Werbekampagnen und Anzeigen herunter.

Die Hauptfunktionen des rmytarget-Pakets

• myTarAuth - Autorisierung;
• myTarGetAdList , myTarGetCampaignList - Laden Sie eine Liste mit Anzeigen und Werbekampagnen herunter.
• myTarGetStats - Laden Sie Statistiken zu Anzeigen und Kampagnen herunter.

 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 - Laden von Daten aus der Yandex.Metrica-API

Installieren eines Pakets mit CRAN: install.packages("rym")
Installieren eines Pakets von GitHub: devtools::install_github("selesnow/rym")
Offizielle Dokumentation: Link

Hauptmerkmale des Rym-Pakets

Mit dem Rym-Paket können Sie mit allen in Yandex.Metrica verfügbaren APIs arbeiten:

1. OAuth2-Protokollautorisierung
2. Arbeiten Sie mit der Verwaltungs-API .
3. Mit Berichts-API arbeiten ;
4. Arbeiten Sie mit einer API, die mit der Core API Google Analytics v3 kompatibel ist .
5. Arbeiten Sie mit der Protokoll-API .

Die Hauptfunktionen des Rym-Pakets

• rym_auth - Autorisierung;
• rym_get_counters - Laden Sie eine Liste der Yandex.Metrica-Zähler herunter.
• rym_get_data - Laden von Daten aus den API-Berichten;
• rym_get_ga - Laden von Daten von einer API, die mit der Core API Google Analytics kompatibel ist;
• rym_get_logs - Laden von Rohdaten aus der Protokoll-API.

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

Fazit

Mithilfe der in diesem Artikel bereitgestellten Pakete können Sie die Erfassung von Daten aus Quellen wie Yandex.Direct, Google Ads, Facebook, Vkontakte, MyTarget und Yandex.Metrica gut automatisieren. Natürlich ist dies keine vollständige Liste der Dienste, die von Online-Vermarktern verwendet werden, aber es ist ziemlich problematisch, alle Tools in einen Artikel zu integrieren. Wenn dieser Artikel also positive Bewertungen erhält, werde ich eine Fortsetzung schreiben.

Darüber hinaus können die erhaltenen Daten mithilfe des dplyr Pakets konvertiert und mithilfe der DBI-Schnittstelle in verschiedene Datenbanken geschrieben werden. Dies sind jedoch bereits recht lange Themen für die nächsten Artikel.

Wenn Sie auch interessante Pakete in Ihrem Arsenal haben, mit denen Sie die Erfassung von Daten aus Werbequellen oder Webanalyseplattformen automatisieren können, lassen Sie sie in den Kommentaren zu diesem Artikel.

Abonnieren Sie meine Telegramm- und Youtube- Kanäle, von denen die meisten nützliche Materialien in der R-Sprache sind.