From 3713c0791bd93e047e861d4e3ede45234e41084d Mon Sep 17 00:00:00 2001 From: favstats Date: Fri, 27 Dec 2024 13:17:33 +0100 Subject: [PATCH] add metatargetr page --- .Rbuildignore | 4 + .github/.gitignore | 1 + .github/workflows/pkgdown.yaml | 49 +++++++++++ .gitignore | 1 + DESCRIPTION | 2 +- NAMESPACE | 11 +++ R/data.R | 97 +++++++++++++++++----- R/get_page_insights.R | 21 ----- README.Rmd | 26 ++++++ README.md | 52 +++++++++++- _pkgdown.yml | 47 +++++++++++ man/figures/README-unnamed-chunk-10-1.png | Bin 0 -> 17328 bytes man/figures/metatargetr_logo.png | Bin 54855 -> 68306 bytes man/get_report_db.Rd | 18 ---- man/retrieve_targeting_metadata.Rd | 33 ++++++++ vignettes/.gitignore | 1 + vignettes/google-transparency-report.qmd | 69 +++++++++++++++ vignettes/introduction.qmd | 47 +++++++++++ vignettes/retrieve-historical-data.qmd | 61 ++++++++++++++ vignettes/retrieve-targeting-metadata.qmd | 63 ++++++++++++++ vignettes/retrieving-targeting-data.qmd | 59 +++++++++++++ 21 files changed, 596 insertions(+), 66 deletions(-) create mode 100644 .github/.gitignore create mode 100644 .github/workflows/pkgdown.yaml create mode 100644 _pkgdown.yml create mode 100644 man/figures/README-unnamed-chunk-10-1.png create mode 100644 man/retrieve_targeting_metadata.Rd create mode 100644 vignettes/.gitignore create mode 100644 vignettes/google-transparency-report.qmd create mode 100644 vignettes/introduction.qmd create mode 100644 vignettes/retrieve-historical-data.qmd create mode 100644 vignettes/retrieve-targeting-metadata.qmd create mode 100644 vignettes/retrieving-targeting-data.qmd diff --git a/.Rbuildignore b/.Rbuildignore index c52aaf0..e397e84 100644 --- a/.Rbuildignore +++ b/.Rbuildignore @@ -3,3 +3,7 @@ ^LICENSE\.md$ ^README\.Rmd$ ^cran-comments\.md$ +^_pkgdown\.yml$ +^docs$ +^pkgdown$ +^\.github$ diff --git a/.github/.gitignore b/.github/.gitignore new file mode 100644 index 0000000..2d19fc7 --- /dev/null +++ b/.github/.gitignore @@ -0,0 +1 @@ +*.html diff --git a/.github/workflows/pkgdown.yaml b/.github/workflows/pkgdown.yaml new file mode 100644 index 0000000..bfc9f4d --- /dev/null +++ b/.github/workflows/pkgdown.yaml @@ -0,0 +1,49 @@ +# Workflow derived from https://github.com/r-lib/actions/tree/v2/examples +# Need help debugging build failures? Start at https://github.com/r-lib/actions#where-to-find-help +on: + push: + branches: [main, master] + pull_request: + release: + types: [published] + workflow_dispatch: + +name: pkgdown.yaml + +permissions: read-all + +jobs: + pkgdown: + runs-on: ubuntu-latest + # Only restrict concurrency for non-PR jobs + concurrency: + group: pkgdown-${{ github.event_name != 'pull_request' || github.run_id }} + env: + GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }} + permissions: + contents: write + steps: + - uses: actions/checkout@v4 + + - uses: r-lib/actions/setup-pandoc@v2 + + - uses: r-lib/actions/setup-r@v2 + with: + use-public-rspm: true + + - uses: r-lib/actions/setup-r-dependencies@v2 + with: + extra-packages: any::pkgdown, local::. + needs: website + + - name: Build site + run: pkgdown::build_site_github_pages(new_process = FALSE, install = FALSE) + shell: Rscript {0} + + - name: Deploy to GitHub pages ๐Ÿš€ + if: github.event_name != 'pull_request' + uses: JamesIves/github-pages-deploy-action@v4.5.0 + with: + clean: false + branch: gh-pages + folder: docs diff --git a/.gitignore b/.gitignore index 57a0904..ebda0e0 100644 --- a/.gitignore +++ b/.gitignore @@ -4,3 +4,4 @@ .httr-oauth .DS_Store data +docs diff --git a/DESCRIPTION b/DESCRIPTION index 9be02e9..b5fe5b8 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -28,5 +28,5 @@ Suggests: OpenImageR, testthat (>= 3.0.0), arrow -URL: https://github.com/favstats/metatargetr +URL: https://github.com/favstats/metatargetr, https://favstats.github.io/metatargetr/ BugReports: https://github.com/favstats/metatargetr/issues diff --git a/NAMESPACE b/NAMESPACE index d5376db..d198a9f 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -12,15 +12,23 @@ export(get_targeting_db) export(ggl_get_spending) export(map_dfr_progress) export(parse_location) +export(retrieve_targeting_metadata) export(stupid_conversion) export(unnest_and_fix_dups) export(walk_progress) importFrom(arrow,read_parquet) +importFrom(dplyr,arrange) importFrom(dplyr,bind_cols) +importFrom(dplyr,filter) importFrom(dplyr,left_join) +importFrom(dplyr,mutate) importFrom(dplyr,mutate_all) +importFrom(dplyr,rename) importFrom(dplyr,select) importFrom(dplyr,slice) +importFrom(dplyr,transmute) +importFrom(httr,GET) +importFrom(httr,content) importFrom(httr2,req_body_raw) importFrom(httr2,req_headers) importFrom(httr2,req_perform) @@ -34,7 +42,10 @@ importFrom(purrr,is_empty) importFrom(purrr,map_dfr) importFrom(purrr,set_names) importFrom(rvest,html_element) +importFrom(rvest,html_elements) importFrom(rvest,html_text) importFrom(stringr,str_remove) importFrom(stringr,str_split) importFrom(tibble,as_tibble) +importFrom(tibble,tibble) +importFrom(tidyr,separate) diff --git a/R/data.R b/R/data.R index d910cc6..99b5d46 100644 --- a/R/data.R +++ b/R/data.R @@ -72,29 +72,6 @@ get_targeting_db <- function(the_cntry, tf, ds, remove_nas = T, verbose = F) { # latest_data %>% filter(is.na(no_data)) - -#' Retrieve Report Data from GitHub Repository -#' -#' This function retrieves a report for a specific country and timeframe -#' from a GitHub repository hosting RDS files. The file is downloaded -#' to a temporary location, read into R, and then deleted. -#' -#' @param the_cntry Character. The ISO country code (e.g., "DE", "US"). -#' @param timeframe Character. One of "-yesterday", "-last_7_days", "-last_30_days", "-last_90_days", or "-lifelong". -#' @param file_name Character. The name of the RDS file to download (e.g., "report_2024-12-25.rds"). -#' @param verbose Logical. Whether to print messages about the process. Default is `FALSE`. -#' @return A data frame or object read from the RDS file. -#' @export -#' -#' @examples -#' # Example usage -#' report_data <- get_report_db( -#' the_cntry = "DE", -#' timeframe = "-last_30_days", -#' file_name = "report_2024-12-25.rds", -#' verbose = TRUE -#' ) -#' print(head(report_data)) #' Retrieve Report Data from GitHub Repository #' #' This function retrieves a report for a specific country and timeframe @@ -185,3 +162,77 @@ get_report_db <- function(the_cntry, timeframe, ds, verbose = FALSE) { # ds = "2024-10-25", # verbose = TRUE # ) + + +#' Retrieve Metadata for Targeting Data +#' +#' This function retrieves metadata for targeting data releases for a specific +#' country and timeframe from a GitHub repository. +#' +#' @param country_code Character. The ISO country code (e.g., "DE", "US"). +#' @param timeframe Character. The timeframe to filter (e.g., "7", "30", or "90"). +#' @param base_url Character. The base URL for the GitHub repository. Defaults to +#' `"https://github.com/favstats/meta_ad_targeting/releases/"`. +#' @return A data frame containing metadata about available targeting data, +#' including file names, sizes, timestamps, and tags. +#' @importFrom httr GET content +#' @importFrom rvest html_elements html_text +#' @importFrom dplyr transmute mutate filter rename arrange +#' @importFrom tidyr separate +#' @importFrom tibble tibble +#' @export +#' +#' @examples +#' # Retrieve metadata for Germany for the last 30 days +#' metadata <- retrieve_targeting_metadata("DE", "30") +#' print(metadata) +retrieve_targeting_metadata <- function(country_code, + timeframe, + base_url = "https://github.com/favstats/meta_ad_targeting/releases/expanded_assets/") { + # Validate inputs + if (missing(country_code)) { + stop("Parameter `country_code` is required.") + } + + if (missing(timeframe) || !timeframe %in% c("7", "30", "90")) { + stop("`timeframe` must be one of: '7', '30', or '90'.") + } + + # Timeframe suffix for filtering + timeframe_suffix <- paste0("-last_", timeframe, "_days") + + # Construct the full URL + url <- paste0(base_url, country_code, timeframe_suffix) + + # Fetch the data + response <- httr::GET(url) + + if (httr::status_code(response) != 200) { + stop("Failed to retrieve metadata from: ", url, ". Status code: ", httr::status_code(response)) + } + + html_content <- xml2::read_html(httr::content(response, as = "text", encoding = "UTF-8")) + + raw_elements <- rvest::html_elements(html_content, ".Box-row") %>% + rvest::html_text() + + metadata <- tibble::tibble(raw = raw_elements) %>% + dplyr::mutate(raw = strsplit(as.character(raw), "\n")) %>% + dplyr::transmute( + filename = sapply(raw, function(x) trimws(x[3])), + file_size = sapply(raw, function(x) trimws(x[6])), + timestamp = sapply(raw, function(x) trimws(x[7])) + ) %>% + dplyr::filter(filename != "Source code") %>% + dplyr::mutate(release = paste0(country_code, timeframe_suffix)) %>% + dplyr::mutate_all(as.character) %>% + dplyr::rename(tag = release, file_name = filename) %>% + dplyr::arrange(desc(tag)) %>% + tidyr::separate(tag, into = c("cntry", "tframe"), sep = "-", remove = FALSE) %>% + dplyr::mutate(ds = stringr::str_remove(file_name, "\\.rds|\\.zip|\\.parquet")) %>% + dplyr::distinct(cntry, ds, tframe) %>% + tidyr::drop_na(ds) %>% + dplyr::arrange(desc(ds)) + + return(metadata) +} diff --git a/R/get_page_insights.R b/R/get_page_insights.R index 6dff14b..794ba76 100644 --- a/R/get_page_insights.R +++ b/R/get_page_insights.R @@ -53,9 +53,6 @@ if("page_info" %in% include_info ){ ua <- sample(ua_list, 1) # print(ua) -# pageid <- "7860876103" -# timeframe <- "90" - # Define static parameters static_params <- list( av = "0", # Likely application version; may not change often. Optional. @@ -64,20 +61,8 @@ static_params <- list( a = "1", # Arbitrary request parameter; purpose unclear but likely required. req = "3", # Request parameter; often a sequence or batch request identifier. Likely required. hs = "19797.BP%3ADEFAULT.2.0..0.0", # Host session or configuration metadata; required for server-side routing. - # dpr = "1", # Device Pixel Ratio; reflects screen resolution. Optional but often included. ccg = "EXCELLENT", # Connection grade; describes network quality. Optional but useful for server-side optimizations. - # rev = "1012093869", # Revision/version number; likely application or API version. Required. - # s = "sbbnic%3Awquopy%3A7r1j3c", # Session token or tracking identifier; unique to the visitor. Required. - # hsi = "7346737420686302672", # Hashed Session ID; unique to the visitor. Required. - # dyn = "7xe6Eiw_K9zo5ObwKBAgc9o2exu13wqojyUW3qi4EoxW4E7SewXwCwfW7oqx60Vo1upEK12wvk1bwbG78b87C2m3K2y11wBw5Zx62G3i1ywdl0Fw4Hwp8kwyx2cU8EmwoHwrUcUjwVw9O7bK2S2W2K4EG1Mxu16wciaw4JwJwSyES0gq0K-1LwqobU2cwmo6O1Fw44wt8", - # Dynamic parameters encoded in a proprietary format; likely unique to each request. Required. - csr = "", # CSRF token; placeholder here, likely required in some contexts. - # lsd = "AVo6-wl7l1Q", # Login session data; required for session validation. - # jazoest = "2881", # CSRF-related field; required for security checks. - # spin_r = "1012093869", # Spin-related metadata (server-specific session management). Required. - # spin_b = "trunk", # Backend branch/version. Required for routing to the correct API version. - # spin_t = "1710545602", # Server timestamp. Required for ensuring request freshness. `_jssesw` = "1", # Encoded session value. Required for session management. fb_api_caller_class = "RelayModern", # API metadata describing the client. Required. fb_api_req_friendly_name = "AdLibraryMobileFocusedStateProviderQuery", # API-friendly name for request logging. Optional. @@ -97,9 +82,6 @@ variables <- jsonlite::toJSON( active_status = "ALL", # Filter for active/inactive ads. Required. ad_type = "POLITICAL_AND_ISSUE_ADS", # Type of ads (repeated for clarity). Required. bylines = list(), # List of bylines to filter ads. Optional. - # collation_token = "7ca3912f-0148-43ce-83e4-9a68ef656e4d", - # Unique token for grouping or collation; may be session-based. Likely required. - content_languages = list(), # Filter for content languages. Optional. count = 30, # Number of results to fetch. Optional but usually required for pagination. countries = list(iso2c), # List of countries for filtering (repeated for clarity). Required. @@ -107,9 +89,6 @@ variables <- jsonlite::toJSON( full_text_search_field = "ALL", # Full-text search field filter. Optional. group_by_modes = list(), # Grouping modes for results. Optional. search_type = "PAGE", # Type of search (e.g., by page). Required. - # session_id = "1678877b-700b-485a-abb0-60efcb6b4019", - # Unique session identifier for the query. Required for tracking. - sort_data = list( mode = "SORT_BY_RELEVANCY_MONTHLY_GROUPED", # Sorting mode. Required. direction = "ASCENDING" # Sorting direction. Required. diff --git a/README.Rmd b/README.Rmd index 518868b..47ae173 100644 --- a/README.Rmd +++ b/README.Rmd @@ -115,6 +115,32 @@ page_info <- get_page_insights("121264564551002", include_info = "page_info") str(page_info) ``` +## `retrieve_targeting_metadata()` + +The `retrieve_targeting_metadata` function is designed to retrieve metadata about targeting data releases from a GitHub repository to see which data is present (or not). It extracts and organizes information such as file names, sizes, timestamps, and tags for a specified country and timeframe. **This metadata provides an overview of the available targeting data without downloading the actual files.** + +- `country_code` (*Character*): + The ISO country code (e.g., `"DE"` for Germany, `"US"` for the United States). + +- `timeframe` (*Character*): + The timeframe for the targeting data. Acceptable values are: + - `"7"`: Last 7 days. + - `"30"`: Last 30 days. + - `"90"`: Last 90 days. + +- `base_url` (*Character*, default: `"https://github.com/favstats/meta_ad_targeting/releases/expanded_assets/"`): + The base URL for the GitHub repository hosting the targeting data. + + +```{r} + +# Retrieve metadata for Germany for the last 30 days +metadata <- retrieve_targeting_metadata("DE", "30") + +print(metadata) + +``` + ## Get Images and Videos diff --git a/README.md b/README.md index 66031f0..718695f 100644 --- a/README.md +++ b/README.md @@ -182,17 +182,63 @@ str(page_info) #> $ page_verification : chr "BLUE_VERIFIED" #> $ entity_type : chr "PERSON_PROFILE" #> $ page_alias : chr "VVD" -#> $ likes : chr "108141" +#> $ likes : chr "108142" #> $ page_category : chr "Political party" #> $ ig_verification : chr "TRUE" #> $ ig_username : chr "vvd" -#> $ ig_followers : chr "42144" +#> $ ig_followers : chr "42145" #> $ shared_disclaimer_info: chr "[]" #> $ about : chr "Doe mee en word lid van de VVD! ๐Ÿ’™๐Ÿงก " #> $ event : chr "CREATION: 2010-04-23 21:05:02" #> $ no_address : logi TRUE ``` +## `retrieve_targeting_metadata()` + +The `retrieve_targeting_metadata` function is designed to retrieve +metadata about targeting data releases from a GitHub repository to see +which data is present (or not). It extracts and organizes information +such as file names, sizes, timestamps, and tags for a specified country +and timeframe. **This metadata provides an overview of the available +targeting data without downloading the actual files.** + +- `country_code` (*Character*): + The ISO country code (e.g., `"DE"` for Germany, `"US"` for the United + States). + +- `timeframe` (*Character*): + The timeframe for the targeting data. Acceptable values are: + + - `"7"`: Last 7 days. + - `"30"`: Last 30 days. + - `"90"`: Last 90 days. + +- `base_url` (*Character*, default: + `"https://github.com/favstats/meta_ad_targeting/releases/expanded_assets/"`): + The base URL for the GitHub repository hosting the targeting data. + +``` r + +# Retrieve metadata for Germany for the last 30 days +metadata <- retrieve_targeting_metadata("DE", "30") + +print(metadata) +#> # A tibble: 313 ร— 3 +#> cntry ds tframe +#> +#> 1 DE 2024-12-25 last_30_days +#> 2 DE 2024-12-24 last_30_days +#> 3 DE 2024-12-23 last_30_days +#> 4 DE 2024-12-22 last_30_days +#> 5 DE 2024-12-21 last_30_days +#> 6 DE 2024-12-20 last_30_days +#> 7 DE 2024-12-19 last_30_days +#> 8 DE 2024-12-18 last_30_days +#> 9 DE 2024-12-17 last_30_days +#> 10 DE 2024-12-16 last_30_days +#> # โ„น 303 more rows +``` + ## Get Images and Videos The following code downloads the images and videos of a Meta ad. It also @@ -276,4 +322,4 @@ timeseries_dat %>% ggplot2::theme_minimal() ``` - + diff --git a/_pkgdown.yml b/_pkgdown.yml new file mode 100644 index 0000000..39acd4f --- /dev/null +++ b/_pkgdown.yml @@ -0,0 +1,47 @@ +template: + bootstrap: 5 + bootswatch: yeti # A modern theme with clean design + bslib: + bg: "#ffffff" # Page background color + fg: "#000000" # Default text color + primary: "#007bff" # Modern blue color for links and accents + base_font: {google: "Roboto"} + heading_font: {google: "Roboto Slab"} + code_font: {google: "JetBrains Mono"} + light-switch: true # Enable light/dark mode switching + +navbar: + bg: "#007bff" # Modern blue background color + type: dark # Black text for a light-themed navbar + structure: + left: [intro, reference, articles, news] + right: [search, github, lightswitch] + components: + github: + icon: fa-github + href: https://github.com/favstats/metatargetr + aria-label: GitHub + +articles: + - title: "Get Started" + contents: + - introduction + - title: "Working with Targeting Data" + contents: + - retrieving-targeting-data + - retrieve-historical-data + - retrieve-targeting-metadata + - title: "Google Transparency Integration" + contents: + - google-transparency-report + +news: + one_page: true + +footer: + structure: + left: developed_by + right: built_with + components: + developed_by: "Developed by Fabio Votta and Philipp Mendoza." + built_with: "Built with โค๏ธ and pkgdown." diff --git a/man/figures/README-unnamed-chunk-10-1.png b/man/figures/README-unnamed-chunk-10-1.png new file mode 100644 index 0000000000000000000000000000000000000000..699867a772de47347ef72177bf9d091179db06c7 GIT binary patch literal 17328 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 literal 0 HcmV?d00001 diff --git a/man/figures/metatargetr_logo.png b/man/figures/metatargetr_logo.png index a58de41682ab76e54f2afdd1ac01f21d12b62c82..00c22599123dcc35bad7293e1fafc89ab36b5845 100644 GIT binary patch literal 68306 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 literal 54855 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 diff --git a/man/get_report_db.Rd b/man/get_report_db.Rd index 9d9ed83..6716416 100644 --- a/man/get_report_db.Rd +++ b/man/get_report_db.Rd @@ -14,12 +14,8 @@ get_report_db(the_cntry, timeframe, ds, verbose = FALSE) \item{ds}{Character. A timestamp or identifier used to construct the file name (e.g., "2024-12-25").} \item{verbose}{Logical. Whether to print messages about the process. Default is \code{FALSE}.} - -\item{file_name}{Character. The name of the RDS file to download (e.g., "report_2024-12-25.rds").} } \value{ -A data frame or object read from the RDS file. - A data frame or object read from the RDS file. } \description{ @@ -28,20 +24,6 @@ from a GitHub repository hosting RDS files. The file is downloaded to a temporary location, read into R, and then deleted. } \examples{ -# Example usage -report_data <- get_report_db( - the_cntry = "DE", - timeframe = "-last_30_days", - file_name = "report_2024-12-25.rds", - verbose = TRUE -) -print(head(report_data)) -Retrieve Report Data from GitHub Repository - -This function retrieves a report for a specific country and timeframe -from a GitHub repository hosting RDS files. The file is downloaded -to a temporary location, read into R, and then deleted. - # Example usage report_data <- get_report_db( the_cntry = "DE", diff --git a/man/retrieve_targeting_metadata.Rd b/man/retrieve_targeting_metadata.Rd new file mode 100644 index 0000000..7c1ad99 --- /dev/null +++ b/man/retrieve_targeting_metadata.Rd @@ -0,0 +1,33 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/data.R +\name{retrieve_targeting_metadata} +\alias{retrieve_targeting_metadata} +\title{Retrieve Metadata for Targeting Data} +\usage{ +retrieve_targeting_metadata( + country_code, + timeframe, + base_url = "https://github.com/favstats/meta_ad_targeting/releases/expanded_assets/" +) +} +\arguments{ +\item{country_code}{Character. The ISO country code (e.g., "DE", "US").} + +\item{timeframe}{Character. The timeframe to filter (e.g., "7", "30", or "90").} + +\item{base_url}{Character. The base URL for the GitHub repository. Defaults to +\code{"https://github.com/favstats/meta_ad_targeting/releases/"}.} +} +\value{ +A data frame containing metadata about available targeting data, +including file names, sizes, timestamps, and tags. +} +\description{ +This function retrieves metadata for targeting data releases for a specific +country and timeframe from a GitHub repository. +} +\examples{ +# Retrieve metadata for Germany for the last 30 days +metadata <- retrieve_targeting_metadata("DE", "30") +print(metadata) +} diff --git a/vignettes/.gitignore b/vignettes/.gitignore new file mode 100644 index 0000000..075b254 --- /dev/null +++ b/vignettes/.gitignore @@ -0,0 +1 @@ +/.quarto/ diff --git a/vignettes/google-transparency-report.qmd b/vignettes/google-transparency-report.qmd new file mode 100644 index 0000000..22f8f92 --- /dev/null +++ b/vignettes/google-transparency-report.qmd @@ -0,0 +1,69 @@ +--- +title: "Google Transparency Report Integration" +description: > + Learn how to access and analyze data from the Google Transparency Report. +vignette: > + %\VignetteIndexEntry{Google Transparency Report Integration} + %\VignetteEngine{quarto::html} + %\VignetteEncoding{UTF-8} +knitr: + opts_chunk: + collapse: true + comment: '#>' +--- + +## Accessing Google Transparency Data + +metatargetr provides integration with the Google Transparency Report through the `ggl_get_spending()` function: + +```{r} +#| eval: false +library(metatargetr) +library(ggplot2) + +# Get aggregated spending data +spending_data <- ggl_get_spending( + advertiser_id = "AR18091944865565769729", + start_date = "2023-10-24", + end_date = "2023-11-22", + cntry = "NL" +) +``` + +## Time-Based Analysis + +For temporal analysis, use the `get_times` parameter: + +```{r} +#| eval: false +# Get time-series data +timeseries_data <- ggl_get_spending( + advertiser_id = "AR18091944865565769729", + start_date = "2023-10-24", + end_date = "2023-11-22", + cntry = "NL", + get_times = TRUE +) + +# Create visualization +ggplot(timeseries_data, aes(x = date, y = spend)) + + geom_col() + + theme_minimal() + + labs( + title = "Ad Spending Over Time", + x = "Date", + y = "Spend Amount" + ) +``` + +## Understanding the Metrics + +The Google Transparency Report provides: + +- Total spending amounts + +- Ad type distribution + +- Temporal patterns + +- Regional variations diff --git a/vignettes/introduction.qmd b/vignettes/introduction.qmd new file mode 100644 index 0000000..2e8d03f --- /dev/null +++ b/vignettes/introduction.qmd @@ -0,0 +1,47 @@ +--- +title: "Introduction to metatargetr" +description: > + Get started with metatargetr, learn about its core functionality and basic usage. +vignette: > + %\VignetteIndexEntry{Introduction to metatargetr} + %\VignetteEngine{quarto::html} + %\VignetteEncoding{UTF-8} +knitr: + opts_chunk: + collapse: true + comment: '#>' +--- + +## Overview + +metatargetr is an R package designed to parse and analyze targeting information from the Meta Ad Library dataset and retrieve data from the Audience tab. It provides tools for working with Meta ad library data and includes integration with the Google Transparency Report. + +## Installation + +You can install the development version of metatargetr from GitHub: + +```{r} +#| eval: false +# install.packages("remotes") +remotes::install_github("favstats/metatargetr") +``` + +## Basic Usage + +First, load the package: + +```{r} +#| warning: false +#| message: false +library(metatargetr) +``` + +The package provides several core functions: + +1. `get_targeting()`: Retrieve recent targeting data +2. `get_targeting_db()`: Access historical targeting data +3. `get_page_insights()`: Get page information +4. `get_ad_snapshots()`: Download ad creatives +5. `ggl_get_spending()`: Access Google Transparency Report data + +Each of these functions is documented in detail in the following sections. diff --git a/vignettes/retrieve-historical-data.qmd b/vignettes/retrieve-historical-data.qmd new file mode 100644 index 0000000..9f22d0f --- /dev/null +++ b/vignettes/retrieve-historical-data.qmd @@ -0,0 +1,61 @@ +--- +title: "Retrieve Historical Data" +description: > + Learn how to access and work with historical Meta Ad targeting data from the archive. +vignette: > + %\VignetteIndexEntry{Retrieve Historical Data} + %\VignetteEngine{quarto::html} + %\VignetteEncoding{UTF-8} +knitr: + opts_chunk: + collapse: true + comment: '#>' +--- + +## Accessing Historical Data + +While Meta's API only provides recent targeting data, metatargetr maintains an archive of historical targeting data. Access this using `get_targeting_db()`: + +```{r} +#| eval: false +library(metatargetr) + +# Set parameters +country_code <- "DE" +timeframe <- 30 +date <- "2024-10-25" + +# Retrieve historical data +historical_data <- get_targeting_db(country_code, timeframe, date) +``` + +## Understanding Historical Data + +The historical data includes: +- Daily targeting snapshots +- Spending information +- Page details +- Targeting criteria used + +## Getting Report Data + +For broader historical analysis, use `get_report_db()`: + +```{r} +#| eval: false +report_data <- get_report_db( + country_code = "DE", + timeframe = 30, + date = "2024-10-25" +) +``` + +This provides aggregated advertising reports including: + +- Total spending + +- Number of ads + +- Page information + +- Temporal data diff --git a/vignettes/retrieve-targeting-metadata.qmd b/vignettes/retrieve-targeting-metadata.qmd new file mode 100644 index 0000000..982a8d0 --- /dev/null +++ b/vignettes/retrieve-targeting-metadata.qmd @@ -0,0 +1,63 @@ +--- +title: "Retrieve Targeting Metadata" +description: > + Understand how to work with targeting metadata and check data availability. +vignette: > + %\VignetteIndexEntry{Retrieve Targeting Metadata} + %\VignetteEngine{quarto::html} + %\VignetteEncoding{UTF-8} +knitr: + opts_chunk: + collapse: true + comment: '#>' +--- + +## Overview of Targeting Metadata + +The `retrieve_targeting_metadata()` function helps you understand what targeting data is available in the archive. It provides information about: + +- Available dates + +- File sizes + +- Data completeness + +- Country coverage + + +## Basic Usage + +```{r} +#| eval: false +library(metatargetr) + +# Get metadata for Germany's 30-day data +metadata <- retrieve_targeting_metadata("DE", "30") + +# View the metadata +print(metadata) +``` + +## Understanding the Output + +The metadata includes: + +- Country code + +- Date stamps + +- Timeframe information + +- Data availability flags + +## Using Metadata for Data Validation + +```{r} +#| eval: false +# Check data availability before retrieval +metadata <- retrieve_targeting_metadata("DE", "30") + +if (nrow(metadata) > 0) { + # Data is available, proceed with retrieval + historical_data <- get_targeting_db("DE", 30, metadata$ds[1]) +} diff --git a/vignettes/retrieving-targeting-data.qmd b/vignettes/retrieving-targeting-data.qmd new file mode 100644 index 0000000..fd508a7 --- /dev/null +++ b/vignettes/retrieving-targeting-data.qmd @@ -0,0 +1,59 @@ +--- +title: "Retrieving Targeting Data" +description: > + Learn how to retrieve and analyze Meta Ad targeting data for different time periods. +vignette: > + %\VignetteIndexEntry{Retrieving Targeting Data} + %\VignetteEngine{quarto::html} + %\VignetteEncoding{UTF-8} +knitr: + opts_chunk: + collapse: true + comment: '#>' +--- + +## Getting Recent Targeting Data + +The `get_targeting()` function allows you to retrieve targeting data for specific time windows: + +```{r} +#| eval: false +library(metatargetr) + +# Last 7 days +last7 <- get_targeting("121264564551002", timeframe = "LAST_7_DAYS") + +# Last 30 days +last30 <- get_targeting("121264564551002", timeframe = "LAST_30_DAYS") + +# Last 90 days +last90 <- get_targeting("121264564551002", timeframe = "LAST_90_DAYS") +``` + +## Understanding the Output + +The function returns a data frame containing: + +- Basic targeting information (gender, age, location) +- Detailed targeting options (interests, behaviors) +- Custom audience information +- Spending and reach metrics + +## Getting Page Information + +Use `get_page_insights()` to retrieve additional page information: + +```{r} +#| eval: false +page_info <- get_page_insights("121264564551002", include_info = "page_info") +``` + +This returns details such as: + +- Page name and verification status + +- Follower counts + +- Page category + +- Creation date