Geekly articles weekly

审查用于Internet营销的R包，第1部分

大家好，如果您从事互联网营销，可能需要每天处理许多广告服务和至少一个Web分析平台，如果您需要每月至少一次，甚至每周一次汇总费用以及其他统计信息，来自所有来源的信息，这不仅耗费大量时间，而且以手动模式合并来自多个来源的数据时出错的可能性非常高。 在本文中，我将为您介绍R语言的现成扩展（程序包），您可以使用这些扩展自动执行从最流行的广告系统和Web分析平台收集数据的过程。
图片


内容内容


  1. 我们需要什么软件
  2. 如何开始使用R软件包
  3. CRAN或GitHub
  4. 使用R包需要哪些技能
  5. ryandexdirect-从Yandex.Direct加载数据
    • ryandexdirect软件包的功能
    • 主要功能
    • 使用ryandexdirect软件包下载统计信息的示例代码
  6. RAdwords-从Google Ads（以前为Google AdWords）加载数据
    • RAdwords
    • RAdwords主要功能
    • 使用包RAdwords
  7. adwordsR-一种更新且功能更强大的软件包，用于从Google Ads（原Google AdWords）下载=和数据
    • AdwordsR套件功能
    • adwordsR的主要功能
    • AdwordsR包示例
  8. rfacebookstat-从Facebook广告仪表板下载数据
    • Rfacebookstat软件包功能
    • rfacebookstat的主要功能
    • 使用rfacebookstat的示例代码
  9. rvkstat-从Vkontakte API加载数据
    • Rvkstat软件包功能
    • rvkstat软件包的主要功能
    • 使用rvkstat软件包的示例代码
  10. rmytarget-从MyTarget API加载数据
    • Rmytarget软件包功能
    • rmytarget软件包的主要功能
    • 使用rmytarget的示例代码
  11. rym-从Yandex.Metrica API加载数据
    • rym软件包的主要功能
    • rym软件包的主要功能
    • 使用rym软件包的示例
  12. 结论

我们需要什么软件


因为 在本文中，我们谈论的是R语言，那么您需要R本身和RStudio开发环境。


R语言和RStudio都是免费的，免费分发的软件，因此您可以从官方网站免费下载它们。


如何开始使用R软件包


开始使用R数据包并没有什么复杂的事情；这可以通过以下步骤完成：


  1. 安装软件包，通常使用基本的install.packages命令；
  2. 连接软件包时，每次使用R启动新会话时，都可以使用library或require命令执行此操作。

library和require之间的区别仅在于，如果您尝试连接不存在的程序包，则library将显示错误；在这种情况下， require仅显示警告，而脚本将继续执行。


要使用GitHub安装本文提供的软件包，首先需要安装devtools软件包，为此，请运行install.packages("devtools") 。


CRAN或GitHub


在阅读本文的过程中，您可能会遇到一个问题，最好从哪个存储库安装一个或另一个软件包，实际上是在GitHub上，通常，开发人员会提供最相关的软件包开发版本，即 它们具有CRAN上可用的软件包版本中可能不提供的所有新功能，但是相应地，开发版本在加载时可能未经过充分测试并包含错误。


在下载之前，CRAN版本经过专家团队的仔细检查，并且必须符合该存储库政策的所有要求 。如果您从CRAN下载软件包，则可以确保它不会损害您的数据，不会在您的文件上创建任何难以理解的文件PC等


使用R包需要哪些技能


实际上，您只需要了解Internet营销的主题领域，在这种情况下就不需要编程技能，因为 我们将使用功能来讨论现成的软件包，通过这些函数您可以自动完成工作的一部分。


本文将不会对使用相关软件包的每个功能进行详细说明，因为 这样的文章太长了，但是我将描述每个软件包的功能，给出您将需要的主要功能的列表，并且还将给出一个指向官方文档的链接，您已经可以使用它来更详细地处理特定软件包中的所有可用功能。 。 另外，我将为每个软件包提供一个小的代码示例，以便您可以更清楚地理解语法。


ryandexdirect-从Yandex.Direct加载数据


使用CRAN安装软件包： install.packages("ryandexdirect")
从GitHub安装软件包： devtools::install_github("selesnow/ryandexdirect")
官方文件： 链接


此软件包旨在与CIS中最流行的广告平台之一-Yandex.Direct的API配合使用。


ryandexdirect软件包的功能


  1. Yandex API授权；
  2. 下载广告系列，关键字，广告列表；
  3. 使用Reports服务从Yandex.Direct帐户下载统计信息。
  4. 在广告系列，关键字和广告级别停止和恢复广告。
  5. 要求资金余额和一般帐户的其他参数。
  6. 下载参考信息（汇率，地理目录等）

主要功能


ryandexdirect中可用的主要功能，您可能需要使用Yandex.Direct API：


  • yadirAuth -API中的授权；
  • yadirGetAds ， yadirGetCampaignList ， yadirGetKeyWords下载广告，广告系列，关键字的列表；
  • yadirGetReport从Yandex.Direct下载统计信息。
  • yadirGetDictionary下载帮助信息。
  • yadirStartAds ， yadirStartCampaigns ， yadirStartKeyWords

使用ryandexdirect软件包下载统计信息的示例代码
 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")

您可以从ryandexdirect或Yandex.Direct API Reports服务的官方帮助中了解有关每个参数的更多信息。


RAdwords-从Google Ads（以前为Google AdWords）加载数据


使用CRAN安装软件包： install.packages("RAdwords")
从GitHub安装软件包： devtools::install_github("jburkhardt/RAdwords")
官方文件： 链接


RAdwords的功能


此软件包的主要功能是Google Ads API中的授权以及从该界面中所有可用报告中下载统计信息。


RAdwords的主要功能


实际上，该软件包原则上不包含很多功能，但是一直以来我只使用三个：


  • doAuth授权；
  • statement对API的请求主体的形成；
  • getData从API加载数据。

使用包RAdwords的示例
 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)

您可以在官方帮助中的链接中找到Google Ads API和字段中可用的报告列表。


adwordsR-一种更新且功能更强大的软件包，用于从Google Ads（原Google AdWords）下载=和数据


使用CRAN安装软件包： install.packages("adwordsR")
使用GitHub安装软件包： devtools::install_github("cran/adwordsR")


adwordsR软件包的含义与RAdwords相似，但它是较新的并且具有更多功能。


AdwordsR套件功能


除了上述RAdwords软件包的功能之外，adwordsR还为您提供了很多与TargetingIdeaService一起使用的机会，TargetingIdeaService是一项服务，您可以通过该服务直接从工具或平台获取定位选项，从而帮助自动进行帐户优化。


adwordsR的主要功能


  • generateAdwordsToken请求令牌以使用Google Ads API;
  • loadAdwordsToken下载请求的和先前保存的令牌；
  • getReportData从Google Ads帐号下载统计信息。

AdwordsR包示例
 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-从Facebook广告仪表板下载数据


使用CRAN安装软件包： install.packages("rfacebookstat")
从GitHub安装软件包： devtools::install_github("selesnow/rfacebookstat")
官方文件： 链接


Rfacebookstat软件包功能


  1. Facebook API登录
  2. 下载可供您使用的业务经理列表；
  3. 下载广告帐户列表；
  4. 下载广告系列，广告组，广告的列表。
  5. 在广告帐户，广告系列，广告组和广告级别下载统计信息。
  6. 下载有权访问广告帐户的用户列表。
  7. 管理对广告帐户的访问权限。

rfacebookstat的主要功能


  • fbGetToken -Facebook API中的授权；
  • fbGetBusinessManagers下载业务经理列表；
  • fbGetAdAccounts下载广告帐户列表；
  • fbGetCampaigns ， fbGetAds ， fbGetAdSets下载广告系列，广告和广告组的列表；
  • fbGetMarketingStat从Facebook广告帐户下载统计信息。

使用rfacebookstat的示例代码
 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-从Vkontakte API加载数据


从GitHub安装软件包： devtools::install_github("selesnow/rvkstat")
官方文件： 链接


一个足够强大和多功能的软件包，可用于社交网络Vkontakte的API。


Rvkstat软件包功能


  1. Vkontakte API中的授权；
  2. 从Vkontakte广告帐户下载数据；
  3. 从Vkontakte下载帮助信息；
  4. 下载有关Vkontakte用户的信息；
  5. 从Vkontakte广告帐户下载统计信息；
  6. 下载有关访问Vkontakte社区的统计信息。

rvkstat软件包的主要功能


撰写本文时，rvkstat软件包包含30多个函数，以下是其中最有用的函数：


  • vkAuth授权；
  • vkGetAdStatistics从广告vkGetAdStatistics下载统计信息；
  • vkGetAdCampaigns ， vkGetAds下载广告活动和广告列表；
  • vkGetGroupStat下载有关访问Vkontakte的团体和社区的统计信息。

使用rvkstat软件包的示例代码
 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-从MyTarget API加载数据


使用CRAN安装软件包： install.packages("rmytarget")
从GitHub安装软件包： devtools::install_github("selesnow/rmytarget")
官方文件： 链接


Rmytarget软件包功能


  1. 根据代码授予方案在MyTarget API中进行授权；
  2. 下载广告活动列表，广告。
  3. 在广告系列和广告级别下载统计信息。

rmytarget软件包的主要功能


  • myTarAuth授权；
  • myTarGetAdList ， myTarGetCampaignList下载广告和广告系列列表；
  • myTarGetStats下载有关广告和广告系列的统计信息。

使用rmytarget的示例代码
 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-从Yandex.Metrica API加载数据


使用CRAN安装软件包： install.packages("rym")
从GitHub安装软件包： devtools::install_github("selesnow/rym")
官方文件： 链接


rym软件包的主要功能


rym软件包允许您使用Yandex.Metrica中可用的所有API：


  1. OAuth2协议授权
  2. 使用管理API ;
  3. 使用报告API ;
  4. 使用与Core API Google Analytics v3兼容的API ；
  5. 使用Logs API 。

rym软件包的主要功能


  • rym_auth授权；
  • rym_get_counters下载Yandex.Metrica计数器列表；
  • rym_get_data从API报告中加载数据；
  • rym_get_ga从与Core API Google Analytics（分析）兼容的API加载数据；
  • rym_get_logs从Logs API加载原始数据。

使用rym软件包的示例
 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")

结论


因此，借助本文提供的软件包，您可以很好地自动化从Yandex.Direct，Google Ads，Facebook，Vkontakte，MyTarget和Yandex.Metrica等来源收集数据。 当然，这并不是在线营销人员使用的服务的详尽列表，但是将所有工具整合到一篇文章中是很成问题的，因此，如果这篇文章受到好评，我将撰写续集。


此外，可以使用dplyr包转换获取的数据，并使用DBI接口将其写入各种数据库，但是这些对于下一篇文章已经是相当冗长的主题。


如果您的武器库中还有一些有趣的软件包可以帮助自动从广告来源或网络分析平台收集数据，请将其留在本文的评论中。


订阅我的电报和youtube频道，其中大部分内容都是有关R语言的有用材料。

Source: https://habr.com/ru/post/zh-CN425425/

More articles:


All Articles