{"Package":"rgoogleads","Title":"Loading Data from 'Google Ads API'","Version":"0.12.0","Authors@R":"c(person(given = \"Alexey\",\nfamily = \"Seleznev\",\nrole = c(\"aut\", \"cre\"),\nemail = \"selesnow@gmail.com\",\ncomment = c(ORCID = \"0000-0003-0410-7385\")),\nperson(given = \"Netpeak\",\nrole = c(\"cph\")))","Description":"Interface for loading data from 'Google Ads API',\nsee .\nPackage provide function for authorization and loading reports.","License":"MIT + file LICENSE","BugReports":"https://github.com/selesnow/rgoogleads/issues","URL":"https://selesnow.github.io/rgoogleads/,\nhttps://selesnow.github.io/rgoogleads/docs/,\nhttps://github.com/selesnow/rgoogleads","Encoding":"UTF-8","Imports":"gargle (>= 1.2.0), httr, stringr, rlang, dplyr (>= 1.0.0),\ntidyr (>= 1.0.0), jsonlite, snakecase, cli (>= 3.0.0), pbapply,\npurrr, withr, rlist, rvest (>= 1.0.0), memoise, cachem,\nrappdirs, utils, lifecycle","RoxygenNote":"7.2.3","Suggests":"rmarkdown, knitr, DT","VignetteBuilder":"knitr","NeedsCompilation":"no","Packaged":"2025-01-10 15:37:52 UTC; User","Author":"Alexey Seleznev [aut, cre] (),\nNetpeak [cph]","Maintainer":"Alexey Seleznev ","Repository":"CRAN","Date/Publication":"2025-01-10 16:30:02 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/rgoogleads_0.12.0.tar.gz","jsonAuthors":[{"name":"Alexey Seleznev","email":"selesnow@gmail.com","maintainer":true},{"name":"Netpeak ","email":null,"maintainer":false}],"readme":"# rgoogleads: R package for work with Google Ads API\n\n\n[![](https://cranlogs.r-pkg.org/badges/grand-total/rgoogleads)](https://cran.r-project.org/package=rgoogleads)\n[![](https://cranlogs.r-pkg.org/badges/rgoogleads?color=lightgrey)](https://cran.r-project.org/package=rgoogleads)\n[![](https://cranlogs.r-pkg.org/badges/last-week/rgoogleads?color=lightgrey)](https://cran.r-project.org/package=rgoogleads)\n[![CRAN\nstatus](https://www.r-pkg.org/badges/version-ago/rgoogleads)](https://CRAN.R-project.org/package=rgoogleads)\n[![R-CMD-check](https://github.com/selesnow/rgoogleads/workflows/R-CMD-check/badge.svg)](https://github.com/selesnow/rgoogleads/actions)\n[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)\n\n\n\n## Table of Contents\n\n+ [Links](#links)\n+ [Install](#install)\n+ [Attach rgoogleads](#attach-rgoogleads)\n+ [Main goal and capabilities of rgoogleads](#main-goal-and-capabilities-of-rgoogleads)\n+ [Privacy Policy](#privacy-policy)\n + [Authorization process](#authorization-process)\n + [Key points](#key-points)\n + [Use own OAuth client](#use-own-oauth-client)\n+ [Obtain Own Developer Token and create own OAuth client](#obtain-own-developer-token-and-create-own-oauth-client)\n+ [Example of use rgoogleads](#example-of-use-rgoogleads)\n+ [Package help](#package-help)\n+ [Package chage log, news and updates](#package-chage-log-news-and-updates)\n+ [Bug report and support](#bug-report-and-support)\n+ [Tutorials](#tutorials)\n+ [Author](#author)\n\n## Links\n\nThis section contains links to the package documentation, as well as other useful links that may be useful to the package users.\n\n* [rgoogleads package documentation site](https://selesnow.github.io/rgoogleads/docs/)\n* [CRAN page](https://cran.r-project.org/package=rgoogleads)\n* [Google Ads API documentation](https://developers.google.com/google-ads/api/docs/start)\n* [Официальный плейлист с видео уроками по работе с rgoogleads](https://www.youtube.com/playlist?list=PLD2LDq8edf4qprTxRcflDwV9IvStiChHi)\n\n## Install\n\nYou can install `rgoogleads` from [CRAN](https://cran.r-project.org/package=rgoogleads) or [GitHub](https://github.com):\n\n```r\n# install from CRAN\ninstall.packages('rgoogleads')\n```\n\n```r\n# install from github\ndevtools::install_github('selesnow/rgoogleads')\n```\n\n## Attach rgoogleads\n\n```r\nlibrary(rgoogleads)\n```\n\n## Main goal and capabilities of rgoogleads\n\n`rgoogleads` is R client for work with Google Ads API v8. Main goal of `rgoogleads` - load report data from Google Ads client account into R for analysis and visualizations.\n\nCapabilities of `rgoogleads`:\n\n* Authorization in the Google Ads API\n* Loading a list of top-level accounts\n* Loading the entire hierarchy of accounts from manager accounts\n* Loading list of Google Ads client account objects: campaigns, ad groups, ads, etc.\n* Loading statistics from Google Ads client account\n* Loading resource metadata, resource fields, segments and metrics\n* Loading forecast and historical metrics from Keyword Planning.\n\n## Privacy Policy\n\nThe `rgoogleads` package for authorization uses the [gargle](https://gargle.r-lib.org/) package, the credentials obtained during authorization are stored exclusively on your local PC, you can find out the folder into which the credentials are cached using the `gads_auth_cache_path()` function.\n\nFor loading data from Google Ads Account `rgoogleads` needs `https://www.googleapis.com/auth/adwords` scope (Manage Your Google AdWords Campaigns), see [official Google Ads API documentation](https://developers.google.com/google-ads/api/docs/oauth/internals#scope). \n\nThe package does not transfer your credentials or data obtained from your advertising accounts to third parties, however, the responsibility for information leakage remains on the side of the package user. The author does not bear any responsibility for their safety, be careful when transferring cached credentials to third parties.\n\nFor more details, I recommend that you read the following articles from the official documentation of the gargle package:\n\n* [Stewarding the cache of user tokens](https://www.tidyverse.org/blog/2021/07/gargle-1-2-0/)\n* [Auth when using R in the browser](https://cran.r-project.org/package=gargle/vignettes/auth-from-web.html)\n* [How gargle gets tokens](https://cran.r-project.org/package=gargle/vignettes/how-gargle-gets-tokens.html)\n\n### Authorization process\n\nYou run `gads_auth('me@gmail.com')` and start [OAuth Dance](https://medium.com/typeforms-engineering-blog/the-beginners-guide-to-oauth-dancing-4b8f3666de10) in the browser:\n\n![Typical OAuth dance in the browser, when initiated from within R](http://img.netpeak.ua/alsey/1OE9JZ2.png)\n\nUpon success, you see this message in the browser:\n\n`Authentication complete. Please close this page and return to R.`\n\nAnd you credentials cached locally on your PC in the form of RDS files.\n\n### Key points\n* By default, gargle caches user tokens centrally, at the user level, and their keys or labels also convey which Google identity is associated with each token.\n* Token storage relies on serialized R objects. That is, tokens are stored locally on your PC in the form of RDS files.\n\n### Use own OAuth client\nYou can use own OAuth app:\n\n```r\napp <- httr::oauth_app(appname = \"app name\", key = \"app id\", secret = \"app secret\")\ngads_auth_configure(app = app)\n\n# or from json file \ngads_auth_configure(path = 'D:/ga_auth/app.json')\n\n# run authorization\ngads_auth('me@gmail.com')\n```\n\n## Obtain Own Developer Token and create own OAuth client\n\nFor obtain own developer token and OAuth client read the following documentation:\n\n* [Obtain Your Developer Token](https://developers.google.com/google-ads/api/docs/get-started/dev-token)\n* [Configure a Google API Console Project for the Google Ads API](https://developers.google.com/google-ads/api/docs/get-started/oauth-cloud-project)\n\n## Example of use rgoogleads\n\n```r\nlibrary(rgoogleads)\n\n# set own oauth app\ngads_auth_configure(path = 'C:/auth/app.json')\n# set your developer token if needed, or use default developer token\ngads_auth(email = 'me@gmail.com', developer_token = \"own developer token\")\n\n# get list of accessible accounts\nmy_accounts <- gads_get_accessible_customers()\n\n# set manager account id (options)\ngads_set_login_customer_id('xxx-xxx-xxxx')\n\n# set client account id\ngads_set_customer_id('xxx-xxx-xxxx')\n\n# load report data\nad_group_report <- gads_get_report(\n resource = \"ad_group\",\n fields = c(\"ad_group.campaign\",\n \"ad_group.id\",\n \"ad_group.name\",\n \"ad_group.status\",\n \"metrics.clicks\",\n \"metrics.cost_micros\"),\n date_from = \"2021-06-10\",\n date_to = \"2021-06-17\",\n where = \"ad_group.status = 'ENABLED'\",\n order_by = c(\"metrics.clicks DESC\", \"metrics.cost_micros\")\n)\n```\n\n## Package help\nFor get help of `rgoogleads` use `?rgoogleads` or `?gads_get_report`.\n\n## Package chage log, news and updates\nYou can follow the package updates at the [link](https://github.com/selesnow/rgoogleads/blob/master/NEWS.md).\n\n## Bug report and support\nIf you encounter an error in the package, or you have suggestions for improving its functionality, you can create a issue using the [link](https://github.com/selesnow/rgoogleads/issues).\n\n## Tutorials\n\nThis section contains links to articles dedicated to `rgoogleads`.\n\n* Русскоязычные материалы\n * [Официальный плейлист с видео уроками](https://www.youtube.com/playlist?list=PLD2LDq8edf4qprTxRcflDwV9IvStiChHi)\n * [Авторизация в Google Ads API и запрос иерархии аккаунтов](https://www.youtube.com/watch?v=nYak5sVj07k&list=PLD2LDq8edf4qprTxRcflDwV9IvStiChHi&index=1), *Alexey Seleznev*\n * [Запрос отчётов из Google Ads API](https://www.youtube.com/watch?v=np67MNj2-JU), *Alexey Seleznev*\n * [Миграция с Google AdWords API на Google Ads API: подробный мануал](https://netpeak.net/ru/blog/migratsiya-s-google-adwords-api-na-google-ads-api-podrobnyy-manual/), *Alexey Seleznev*\n * [Как визуализировать показатель качества ключевых слов — рецепт скрипта на языке R](https://netpeak.net/ru/blog/kak-vizualizirovat-pokazatel-kachestva-klyuchevyh-slov-retsept-skripta-na-yazyke-r/), *Alexey Seleznev*\n * [Как оценить потерянный доход в Google Ads с помощью языка R](https://netpeak.net/ru/blog/kak-otsenit-poteryannyi-dokhod-v-google-adwords-s-pomoshch-yu-yazyka-r/), *Alexey Seleznev*\n * [Доклад: Зачем интернет маркетологу понимать что такое API. Разбираем устройство API Google Ads (Конференция 8P 2021)](https://youtu.be/wtXVwOBo518), *Alexey Seleznev*\n* English\n * [Migrating from AdWords API to Google Ads API. A Comprehensive Guideline](https://netpeak.net/blog/migrating-from-adwords-api-to-google-ads-api-a-comprehensive-guideline/), *Alexey Seleznev*\n\nIf you have published an article about `rgoogleads` let me know about it in [telegram](https://t.me/AlexeySeleznev) or [email](mailto:selesnow@gmail.com) and I will add it to the list of links.\n\n## Author\nAlexey Seleznev, Head of analytics dept. at [Netpeak](https://netpeak.us/)\n
Telegram Channel: [R4marketing](https://t.me/R4marketing)\n
email: selesnow@gmail.com\n
facebook: [facebook.com/selesnow](https://www.facebook.com/selesnow)\n
blog: [alexeyseleznev.wordpress.com](https://alexeyseleznev.wordpress.com/)","jobInfo":{"package":"rgoogleads","version":"0.12.0","parsingStatus":"success","parserVersion":2,"parsedAt":"2025-01-10T18:30:15+0000"}}

Description

Usage

Arguments

Value

See Also