Geekly articles weekly

Revisión de paquetes R para marketing en Internet, parte 1

Hola a todos, si se dedican al marketing en Internet, probablemente tengan que lidiar con muchos servicios de publicidad y al menos una plataforma de análisis web todos los días, si necesitan resumir los gastos al menos una vez al mes, o tal vez incluso una vez a la semana, y otras estadísticas información de todas las fuentes, esto no solo está cargado de grandes costos de tiempo, sino que la probabilidad de error al consolidar datos de múltiples fuentes en modo manual es bastante alta. En este artículo, le contaré extensiones (paquetes) listas para usar para el lenguaje R, con las cuales puede automatizar el proceso de recopilación de datos de los sistemas publicitarios y plataformas de análisis web más populares.
imagen


Contenido


  1. ¿Qué software necesitamos?
  2. Cómo comenzar con los paquetes R
  3. CRAN o GitHub
  4. Qué habilidades se necesitan para trabajar con paquetes R
  5. ryandexdirect - cargando datos de Yandex.Direct
    • Características del paquete ryandexdirect
    • Funciones principales
    • Código de muestra para descargar estadísticas usando el paquete ryandexdirect
  6. RAdwords: carga de datos de Google Ads (ex Google AdWords)
    • Características de RAdwords
    • Características clave de RAdwords
    • Ejemplo de trabajo con el paquete RAdwords
  7. adwordsR: un paquete más nuevo y más funcional para descargar = y datos de Google Ads (ex Google AdWords)
    • Características del paquete AdwordsR
    • Características clave de adwordsR
    • Ejemplo de paquete AdwordsR
  8. rfacebookstat: descargue datos de los paneles publicitarios de Facebook
    • Características del paquete Rfacebookstat
    • Características clave de rfacebookstat
    • Código de muestra para trabajar con rfacebookstat
  9. rvkstat: carga de datos desde la API de Vkontakte
    • Características del paquete rvkstat
    • Las funciones principales del paquete rvkstat
    • Código de muestra para trabajar con el paquete rvkstat
  10. rmytarget - cargando datos desde la API MyTarget
    • Características del paquete Rmytarget
    • Las funciones principales del paquete rmytarget
    • Código de muestra para trabajar con rmytarget
  11. rym - cargando datos de la API Yandex.Metrica
    • Características clave del paquete rym
    • Las funciones principales del paquete rym
    • Ejemplo de trabajo con el paquete rym
  12. Conclusión

¿Qué software necesitamos?


Porque en este artículo estamos hablando del lenguaje R, entonces necesitas R en sí y el entorno de desarrollo RStudio .


Tanto el lenguaje R como RStudio son software gratuito y de distribución gratuita, por lo que puede descargarlos libremente de los sitios oficiales.


Cómo comenzar con los paquetes R


No hay nada complicado para comenzar a trabajar con paquetes R; esto se hace de la siguiente manera:


  1. Instalar un paquete, generalmente con el comando básico install.packages ;
  2. Conectando el paquete, cada vez que inicia una nueva sesión con R, esta operación se puede realizar utilizando la library o require comando.

La diferencia entre la library y require es solo que la library dará un error si intenta conectar un paquete que no tiene, y require en este caso solo mostrará una advertencia, mientras que el script continuará ejecutándose.


Para instalar los paquetes proporcionados en el artículo con GitHub, primero debe instalar el paquete devtools. Para ello, ejecute install.packages("devtools") .


CRAN o GitHub


Al leer este artículo, es posible que tenga una pregunta desde qué repositorio es mejor instalar este o aquel paquete, de hecho, en GitHub, por regla general, existen las versiones de desarrollo más relevantes de los paquetes de los desarrolladores, es decir. tienen todas las características nuevas que pueden no estar disponibles en la versión del paquete que está disponible en CRAN, pero en consecuencia la versión de desarrollo puede no estar suficientemente probada al momento de la carga y contener errores.


Antes de la descarga, la versión CRAN es revisada cuidadosamente por un equipo de especialistas y debe cumplir con todos los requisitos de la política de este repositorio , si descarga un paquete de CRAN, puede estar seguro de que no dañará sus datos, no creará ningún archivo incomprensible en su PC etc.


Qué habilidades se necesitan para trabajar con paquetes R


De hecho, solo necesita comprender el área temática del marketing en Internet, no se requieren habilidades de programación en este caso, porque hablaremos de paquetes listos para usar, utilizando funciones desde las cuales puede automatizar la parte de ruina de su trabajo.


El artículo no tendrá una descripción detallada del trabajo con cada función de los paquetes en cuestión, porque dicho artículo sería demasiado largo, pero describiré las capacidades de cada paquete, le daré una lista de las funciones principales que necesitará, y también le daré un enlace a la documentación oficial, con la que ya puede tratar con más detalle todas las funciones disponibles en un paquete en particular . Además, daré un pequeño ejemplo de código para cada paquete, para que pueda comprender la sintaxis más claramente.


ryandexdirect - cargando datos de Yandex.Direct


Instalación de un paquete con CRAN: install.packages("ryandexdirect")
Instalación de un paquete desde GitHub: devtools::install_github("selesnow/ryandexdirect")
Documentación oficial: enlace


Este paquete está diseñado para funcionar con la API de una de las plataformas publicitarias más populares de la CEI: Yandex.Direct.


Características del paquete ryandexdirect


  1. Autorización en Yandex API;
  2. Descargue una lista de campañas publicitarias, palabras clave, anuncios;
  3. Descargue estadísticas de cuentas Yandex.Direct utilizando el servicio de Informes .
  4. Detenga y reanude los anuncios a nivel de campañas publicitarias, palabras clave y anuncios.
  5. Solicitud de saldo del fondo y otros parámetros de la cuenta general.
  6. Descarga de información de referencia (tipos de cambio, directorio geográfico, etc.)

Funciones principales


Las principales funciones disponibles en ryandexdirect, que puede necesitar para trabajar con la API Yandex.Direct:


  • yadirAuth - Autorización en la API;
  • yadirGetAds , yadirGetCampaignList , yadirGetKeyWords : descargue una lista de anuncios, campañas publicitarias, palabras clave;
  • yadirGetReport - Descargar estadísticas de Yandex.Direct.
  • yadirGetDictionary - Descargar información de ayuda.
  • yadirStartAds , yadirStartCampaigns , yadirStartKeyWords -

Código de muestra para descargar estadísticas usando el paquete 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")

Puede obtener más información sobre cada argumento con la ayuda oficial de ryandexdirect o el servicio Yandex.Direct API Reports .


RAdwords : carga de datos de Google Ads (ex Google AdWords)


Instalación de un paquete con CRAN: install.packages("RAdwords")
Instalación de un paquete desde GitHub: devtools::install_github("jburkhardt/RAdwords")
Documentación oficial: enlace


Características de RAdwords


La característica principal de este paquete es la autorización en la API de Google Ads y la descarga de estadísticas de todos los informes disponibles en esta interfaz.


Características clave de RAdwords


En realidad, el paquete, en principio, no contiene muchas funciones, pero durante todo el tiempo usé solo tres:


  • doAuth - Autorización;
  • statement - Formación del cuerpo de la solicitud a la API;
  • getData : carga de datos desde la API.

Ejemplo de trabajo con el paquete 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)

La lista de informes disponibles en la API de Google Ads y los campos se pueden encontrar en el enlace de la ayuda oficial.


adwordsR : un paquete más nuevo y más funcional para descargar = y datos de Google Ads (ex Google AdWords)


Instalación de un paquete con CRAN: install.packages("adwordsR")
Instalación de un paquete con GitHub: devtools::install_github("cran/adwordsR")


El paquete adwordsR es similar en significado a RAdwords, pero es más nuevo y tiene un conjunto mucho más amplio de funciones.


Características del paquete AdwordsR


Además de las características del paquete RAdwords descrito anteriormente, adwordsR le brinda amplias oportunidades para trabajar con TargetingIdeaService, un servicio con el que puede obtener opciones de orientación directamente desde una herramienta o plataforma, lo que ayuda a automatizar la optimización de la cuenta.


Características clave de adwordsR


  • generateAdwordsToken : solicite un token para trabajar con la API de Google Ads;
  • loadAdwordsToken : descargue el token solicitado y guardado previamente;
  • getReportData : descarga estadísticas de una cuenta de Google Ads.

Ejemplo de paquete 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 : descargue datos de los paneles publicitarios de Facebook


Instalación de un paquete con CRAN: install.packages("rfacebookstat")
Instalación de un paquete desde GitHub: devtools::install_github("selesnow/rfacebookstat")
Documentación oficial: enlace


Características del paquete Rfacebookstat


  1. Inicio de sesión API de Facebook
  2. Descargue una lista de gerentes de negocios disponibles para usted;
  3. Descargue una lista de cuentas publicitarias;
  4. Descargue una lista de campañas publicitarias, grupos de anuncios, anuncios.
  5. Descargue estadísticas a nivel de una cuenta publicitaria, campañas publicitarias, grupos de anuncios y anuncios.
  6. Descargue una lista de usuarios que tienen acceso a una cuenta publicitaria.
  7. Gestionar el acceso a las cuentas publicitarias.

Características clave de rfacebookstat


  • fbGetToken : autorización en la API de Facebook;
  • fbGetBusinessManagers : descargue una lista de gerentes de negocios;
  • fbGetAdAccounts : descargue una lista de cuentas publicitarias;
  • fbGetCampaigns , fbGetAds , fbGetAdSets : descargue una lista de campañas publicitarias, anuncios y grupos de anuncios;
  • fbGetMarketingStat : descargue estadísticas de las cuentas publicitarias de Facebook.

Código de muestra para trabajar con 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 : carga de datos desde la API de Vkontakte


Instalación de un paquete desde GitHub: devtools::install_github("selesnow/rvkstat")
Documentación oficial: enlace


Un paquete suficientemente potente y multifuncional para trabajar con la API de la red social Vkontakte.


Características del paquete rvkstat


  1. Autorización en Vkontakte API;
  2. Descargar datos de las cuentas publicitarias de Vkontakte;
  3. Descargar información de ayuda de Vkontakte;
  4. Descargar información sobre el usuario de Vkontakte;
  5. Descargar estadísticas de la cuenta de publicidad Vkontakte;
  6. Descargue estadísticas sobre visitas a las comunidades Vkontakte.

Las funciones principales del paquete rvkstat


El paquete rvkstat en el momento de la escritura contiene más de 30 funciones, estas son las más útiles:


  • vkAuth - Autorización;
  • vkGetAdStatistics : descargue estadísticas de una vkGetAdStatistics publicitaria;
  • vkGetAdCampaigns , vkGetAds : descargue una lista de campañas publicitarias y anuncios;
  • vkGetGroupStat : descargue estadísticas sobre visitas a grupos y comunidades de Vkontakte.

Código de muestra para trabajar con el paquete 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 - cargando datos desde la API MyTarget


Instalación de un paquete con CRAN: install.packages("rmytarget")
Instalación de un paquete desde GitHub: devtools::install_github("selesnow/rmytarget")
Documentación oficial: enlace


Características del paquete Rmytarget


  1. Autorización en la API MyTarget de acuerdo con el esquema de concesión de código;
  2. Descargue una lista de campañas publicitarias, anuncios.
  3. Descargue estadísticas a nivel de campañas publicitarias y anuncios.

Las funciones principales del paquete rmytarget


  • myTarAuth - Autorización;
  • myTarGetAdList , myTarGetCampaignList : descargue una lista de anuncios y campañas publicitarias;
  • myTarGetStats : descargue estadísticas sobre anuncios y campañas.

Código de muestra para trabajar con 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 - cargando datos de la API Yandex.Metrica


Instalación de un paquete con CRAN: install.packages("rym")
Instalación de un paquete desde GitHub: devtools::install_github("selesnow/rym")
Documentación oficial: enlace


Características clave del paquete rym


El paquete rym le permite trabajar con todas las API disponibles en Yandex.Metrica:


  1. Autorización de protocolo OAuth2
  2. Trabajar con API de gestión ;
  3. Trabajar con informes API ;
  4. Trabaja con API compatible con Core API Google Analytics v3 ;
  5. Trabaja con Logs API .

Las funciones principales del paquete rym


  • rym_auth - Autorización;
  • rym_get_counters - Descargar una lista de contadores Yandex.Metrica;
  • rym_get_data - Cargando datos de los informes API;
  • rym_get_ga - Carga de datos desde API compatible con Core API Google Analytics;
  • rym_get_logs : carga datos sin procesar desde la API de registros.

Ejemplo de trabajo con el paquete 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")

Conclusión


Entonces, con la ayuda de los paquetes proporcionados en este artículo, puede automatizar la recopilación de datos de fuentes como Yandex.Direct, Google Ads, Facebook, Vkontakte, MyTarget y Yandex.Metrica. Por supuesto, esta no es una lista exhaustiva de servicios que utilizan los especialistas en marketing en línea, pero ajustar todas las herramientas en un artículo es bastante problemático, por lo que si este artículo recibe críticas positivas, escribiré una secuela.


Además, los datos obtenidos se pueden convertir usando el paquete dplyr y escribir en varias bases de datos usando la interfaz DBI, pero estos son temas bastante extensos para los próximos artículos.


Si también tiene paquetes interesantes en su arsenal que pueden ayudar a automatizar la recopilación de datos de fuentes publicitarias o plataformas analíticas web, déjelos en los comentarios de este artículo.


Suscríbase a mis canales de Telegram y YouTube , la mayoría de los cuales son materiales útiles en el lenguaje R.

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

More articles:


All Articles