Geekly articles weekly

Revisão dos Pacotes R para Marketing na Internet, Parte 1

Olá pessoal, se você está envolvido em marketing na Internet, provavelmente precisará lidar com muitos serviços de publicidade e pelo menos uma plataforma de análise da web todos os dias, se precisar resumir as despesas pelo menos uma vez por mês ou talvez até uma vez por semana e outras estatísticas informações de todas as fontes, isso não é apenas um grande custo de tempo, mas a probabilidade de erro ao consolidar dados de várias fontes no modo manual é bastante alta. Neste artigo, mostrarei extensões (pacotes) prontas para a linguagem R, com as quais você pode automatizar o processo de coleta de dados dos sistemas de publicidade e plataformas de análise da web mais populares.
imagem


Conteúdo


  1. De que software precisamos
  2. Como começar com pacotes R
  3. CRAN ou GitHub
  4. Quais habilidades são necessárias para trabalhar com pacotes R
  5. ryandexdirect - carregando dados do Yandex.Direct
    • Recursos do pacote ryandexdirect
    • Funções principais
    • Código de amostra para baixar estatísticas usando o pacote ryandexdirect
  6. RAdwords - carregando dados do Google Ads (ex Google AdWords)
    • Recursos do RAdwords
    • Principais recursos do RAdwords
    • Exemplo de trabalho com o pacote RAdwords
  7. adwordsR - um pacote mais novo e mais funcional para download = e dados do Google Ads (ex Google AdWords)
    • Recursos do pacote AdwordsR
    • Principais recursos do adwordsR
    • Exemplo de pacote AdwordsR
  8. rfacebookstat - baixar dados dos painéis de publicidade do Facebook
    • Recursos do pacote Rfacebookstat
    • Principais recursos do rfacebookstat
    • Código de exemplo para trabalhar com rfacebookstat
  9. rvkstat - carregando dados da API do Vkontakte
    • Recursos do pacote Rvkstat
    • As principais funções do pacote rvkstat
    • Código de amostra para trabalhar com o pacote rvkstat
  10. rmytarget - carregando dados da API MyTarget
    • Recursos do pacote Rmytarget
    • As principais funções do pacote rmytarget
    • Código de amostra para trabalhar com rmytarget
  11. rym - carregando dados da API Yandex.Metrica
    • Principais recursos do pacote rym
    • As principais funções do pacote rym
    • Exemplo de trabalho com o pacote rym
  12. Conclusão

De que software precisamos


Porque Neste artigo, estamos falando sobre a linguagem R, então você precisa do próprio R e do ambiente de desenvolvimento do RStudio .


Tanto o idioma R quanto o RStudio são softwares gratuitos e distribuídos gratuitamente, para que você possa baixá-los gratuitamente de sites oficiais.


Como começar com pacotes R


Não há nada complicado para começar a trabalhar com pacotes R; isso é feito da seguinte maneira:


  1. Instalando um pacote, geralmente com o comando install.packages básico;
  2. Conectando o pacote, toda vez que você inicia uma nova sessão com R, esta operação pode ser executada usando a library ou require comando.

A diferença entre a library e o require é apenas que a library apresentará um erro se você tentar conectar um pacote que não possui e, nesse caso, o requerimento mostrará apenas um aviso, enquanto o script continuará sendo executado.


Para instalar os pacotes fornecidos no artigo com o GitHub, você primeiro precisa instalar o pacote devtools, para isso, execute o install.packages("devtools") .


CRAN ou GitHub


Ao ler este artigo, você pode ter uma pergunta em qual repositório é melhor instalar este ou aquele pacote; de ​​fato, no GitHub, como regra, existem as versões dev de pacotes mais relevantes dos desenvolvedores, ou seja, eles têm todos os novos recursos que podem não estar disponíveis na versão do pacote disponível no CRAN, mas, portanto, a versão do desenvolvedor pode não ser suficientemente testada no momento do carregamento e conter erros.


Antes do download, a versão do CRAN é cuidadosamente verificada por uma equipe de especialistas e deve atender a todos os requisitos da política deste repositório.Se você baixar um pacote do CRAN, pode ter certeza de que isso não prejudicará seus dados, nem criará arquivos incompreensíveis no seu computador. PC etc.


Quais habilidades são necessárias para trabalhar com pacotes R


Na verdade, você só precisa entender a área de assunto do marketing na Internet; nesse caso, não são necessárias habilidades de programação, porque falaremos sobre pacotes prontos, usando funções nas quais você pode automatizar a parte arruinada do seu trabalho.


O artigo não terá uma descrição detalhada do trabalho com cada função dos pacotes em questão, porque esse artigo seria muito longo, mas descreverei os recursos de cada pacote, darei uma lista das principais funções necessárias e também darei um link para a documentação oficial, com a qual você já pode lidar com mais detalhes com todas as funções disponíveis em um pacote específico . Além disso, darei um pequeno exemplo de código para cada pacote, para que você possa entender a sintaxe mais claramente.


ryandexdirect - carregando dados do Yandex.Direct


Instalando um pacote com CRAN: install.packages("ryandexdirect")
Instalando um pacote no GitHub: devtools::install_github("selesnow/ryandexdirect")
Documentação oficial: link


Este pacote foi projetado para funcionar com a API de uma das plataformas de publicidade mais populares no CIS - Yandex.Direct.


Recursos do pacote ryandexdirect


  1. Autorização na API Yandex;
  2. Faça o download de uma lista de campanhas publicitárias, palavras-chave, anúncios;
  3. Baixe estatísticas das contas Yandex.Direct usando o serviço Relatórios .
  4. Interrompa e retome os anúncios no nível de campanhas publicitárias, palavras-chave e anúncios.
  5. Solicitação de saldo do fundo e outros parâmetros da conta geral.
  6. Download de informações de referência (taxas de câmbio, diretório geográfico etc.)

Funções principais


As principais funções disponíveis no ryandexdirect, que podem ser necessárias para trabalhar com a API Yandex.Direct:


  • yadirAuth - autorização na API;
  • yadirGetAds , yadirGetCampaignList , yadirGetKeyWords - Faça o download de uma lista de anúncios, campanhas publicitárias, palavras-chave;
  • yadirGetReport - Faça o download de estatísticas do Yandex.Direct.
  • yadirGetDictionary - Baixar informações de ajuda.
  • yadirStartAds , yadirStartCampaigns , yadirStartKeyWords -

Código de amostra para baixar estatísticas usando o pacote 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")

Você pode aprender mais sobre cada argumento com a ajuda oficial do serviço ryandexdirect ou Yandex.Direct API Reports .


RAdwords - carregando dados do Google Ads (ex Google AdWords)


Instalando um pacote com CRAN: install.packages("RAdwords")
Instalando um pacote no GitHub: devtools::install_github("jburkhardt/RAdwords")
Documentação oficial: link


Recursos do RAdwords


O principal recurso deste pacote é a autorização na API do Google Ads e o download de estatísticas de todos os relatórios disponíveis nessa interface.


Principais recursos do RAdwords


Na verdade, o pacote, em princípio, não contém muitas funções, mas durante todo o tempo eu usei apenas três:


  • doAuth - autorização;
  • statement - Formação do corpo da solicitação para a API;
  • getData - Carregando dados da API.

Exemplo de trabalho com o pacote 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)

A lista de relatórios disponíveis na API e nos campos do Google Ads pode ser encontrada no link na ajuda oficial.


adwordsR - um pacote mais novo e mais funcional para download = e dados do Google Ads (ex Google AdWords)


Instalando um pacote com CRAN: install.packages("adwordsR")
Instalando um pacote com o GitHub: devtools::install_github("cran/adwordsR")


O pacote adwordsR tem significado semelhante ao RAdwords, mas é mais recente e possui um conjunto muito maior de funções.


Recursos do pacote AdwordsR


Além dos recursos do pacote RAdwords descritos acima, o adwordsR oferece amplas oportunidades para trabalhar com o TargetingIdeaService, um serviço com o qual você pode obter opções de segmentação diretamente de uma ferramenta ou plataforma, que ajuda a automatizar a otimização da conta.


Principais recursos do adwordsR


  • generateAdwordsToken - solicite um token para trabalhar com a API do Google Ads;
  • loadAdwordsToken - Faça o download do token solicitado e salvo anteriormente;
  • getReportData - Faça o download de estatísticas de uma conta do Google Ads.

Exemplo de pacote 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 - baixar dados dos painéis de publicidade do Facebook


Instalando um pacote com CRAN: install.packages("rfacebookstat")
Instalando um pacote no GitHub: devtools::install_github("selesnow/rfacebookstat")
Documentação oficial: link


Recursos do pacote Rfacebookstat


  1. Login da API do Facebook
  2. Faça o download de uma lista de gerentes de negócios disponíveis para você;
  3. Faça o download de uma lista de contas de publicidade;
  4. Faça o download de uma lista de campanhas publicitárias, grupos de anúncios, anúncios.
  5. Faça o download de estatísticas no nível de uma conta de publicidade, campanhas publicitárias, grupos de anúncios e anúncios.
  6. Baixe uma lista de usuários que têm acesso a uma conta de publicidade.
  7. Gerenciar o acesso a contas de anúncios.

Principais recursos do rfacebookstat


  • fbGetToken - Autorização na API do Facebook;
  • fbGetBusinessManagers - Faça o download de uma lista de gerentes de negócios;
  • fbGetAdAccounts - Faça o download de uma lista de contas de publicidade;
  • fbGetCampaigns , fbGetAds , fbGetAdSets - Faça o download de uma lista de campanhas publicitárias, anúncios e grupos de anúncios;
  • fbGetMarketingStat - Faça o download de estatísticas das contas de publicidade do Facebook.

Código de exemplo para trabalhar com 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 - carregando dados da API do Vkontakte


Instalando um pacote no GitHub: devtools::install_github("selesnow/rvkstat")
Documentação oficial: link


Um pacote suficientemente poderoso e multifuncional para trabalhar com a API da rede social Vkontakte.


Recursos do pacote Rvkstat


  1. Autorização na API Vkontakte;
  2. Faça o download dos dados das contas de publicidade da Vkontakte;
  3. Baixando informações de ajuda do Vkontakte;
  4. Baixando algumas informações sobre o usuário Vkontakte;
  5. Faça o download das estatísticas da conta de publicidade da Vkontakte;
  6. Faça o download de estatísticas sobre visitas às comunidades Vkontakte.

As principais funções do pacote rvkstat


O pacote rvkstat no momento da redação contém mais de 30 funções, eis as mais úteis:


  • vkAuth - autorização;
  • vkGetAdStatistics - Faça o download de estatísticas de uma vkGetAdStatistics publicidade;
  • vkGetAdCampaigns , vkGetAds - Faça o download de uma lista de campanhas e anúncios publicitários;
  • vkGetGroupStat - Faça o download de estatísticas sobre visitas a grupos e comunidades de Vkontakte.

Código de amostra para trabalhar com o pacote 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 - carregando dados da API MyTarget


Instalando um pacote com CRAN: install.packages("rmytarget")
Instalando um pacote no GitHub: devtools::install_github("selesnow/rmytarget")
Documentação oficial: link


Recursos do pacote Rmytarget


  1. Autorização na API MyTarget de acordo com o esquema de Concessão de Código;
  2. Baixe uma lista de campanhas publicitárias, anúncios.
  3. Faça o download de estatísticas no nível de campanhas e anúncios de publicidade.

As principais funções do pacote rmytarget


  • myTarAuth - Autorização;
  • myTarGetAdList , myTarGetCampaignList - Faça o download de uma lista de anúncios e campanhas publicitárias;
  • myTarGetStats - Faça o download de estatísticas sobre anúncios e campanhas.

Código de amostra para trabalhar com 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 - carregando dados da API Yandex.Metrica


Instalando um pacote com CRAN: install.packages("rym")
Instalando um pacote no GitHub: devtools::install_github("selesnow/rym")
Documentação oficial: link


Principais recursos do pacote rym


O pacote rym permite que você trabalhe com todas as APIs disponíveis no Yandex.Metrica:


  1. Autorização de protocolo OAuth2
  2. Trabalhar com API de gerenciamento ;
  3. Trabalhar com API de relatórios ;
  4. Trabalhe com API compatível com a API principal do Google Analytics v3 ;
  5. Trabalhe com a API de logs .

As principais funções do pacote rym


  • rym_auth - autorização;
  • rym_get_counters - Faça o download de uma lista de contadores Yandex.Metrica;
  • rym_get_data - Carregando dados dos relatórios da API;
  • rym_get_ga - carregamento de dados da API compatível com a API principal do Google Analytics;
  • rym_get_logs - Carregando dados brutos da API de logs.

Exemplo de trabalho com o pacote 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")

Conclusão


Portanto, com a ajuda dos pacotes fornecidos neste artigo, você pode automatizar a coleta de dados de fontes como Yandex.Direct, Google Ads, Facebook, Vkontakte, MyTarget e Yandex.Metrica. Obviamente, essa não é uma lista exaustiva de serviços usados ​​pelos profissionais de marketing on-line, mas reunir todas as ferramentas em um artigo é bastante problemático; portanto, se este artigo receber críticas positivas, escreverei uma sequência.


Além disso, os dados obtidos podem ser convertidos usando o pacote dplyr e gravados em vários bancos de dados usando a interface DBI, mas esses já são tópicos bastante longos para os próximos artigos.


Se você também possui pacotes interessantes em seu arsenal que podem ajudar a automatizar a coleta de dados de fontes de publicidade ou plataformas de análise da Web, deixe-os nos comentários deste artigo.


Assine meus canais de telegrama e youtube , a maioria dos quais são materiais úteis na linguagem R.

Source: https://habr.com/ru/post/pt425425/

More articles:


All Articles