LoginSign Up
← Back to all sparks
R

rfacebookstat

ANALYTICS
Velocity0.0

Load Data from Facebook API Marketing

github.com/selesnow/rfacebookstat ↗

A Facebook Marketing API client for R whose release schedule belongs to Meta, not its author.

r-packagefacebook-adsapi-migrationmarketing-analyticsattribution
◆Current state
rfacebookstat wraps the Facebook Marketing API for R analysts, and nearly every release is a migration to a newer API version — v14, v15, v16, v19, v20 all appear in this window. Feature work rides along with those migrations: fbGetAdAccounts() gained a spend_cap field, and fbGetMarketingStat() gained use_unified_attribution_setting, which switches results to the ad-set-level attribution settings and overrides the older account-level argument.
◆Where it's heading
The package's direction is set almost entirely by Meta's deprecation cycle, and the release notes read as a log of keeping up. The attribution work is the one strand with its own logic: an argument added in 2.10.0, then fixed in 2.12.1 when it turned out not to apply unless fetch_by was also used. Three versions cut within four and a half hours on one day in April 2023 show migrations being cleared in batches rather than steadily.
◆Prediction
The next release will almost certainly be a migration to a newer Marketing API version, since that has triggered every version in this history; whether anything else ships with it depends on what Meta changes.

◆Recent moves

  1. 1y ago

    Marketing API v20 support; attribution argument fix

    The package moves to Marketing API v20 and repairs use_unified_attribution_setting, which was silently ignored in fbGetMarketingStat() unless fetch_by was also supplied. It closes the loop on the attribution work opened in 2.10.0, and is the most recent sign of the API-tracking cycle continuing.

    View source ↗
  2. 2y ago

    Unified attribution settings option for marketing stats

    fbGetMarketingStat() gains use_unified_attribution_setting, which reports results using the attribution settings defined at ad-set level and overrides the older account-level argument. Bundled with the move to API v19, it is the substantive feature of this window — and the one that needed a fix a year later.

    View source ↗
  3. 3y ago

    Re-tag of the v16.0 migration, same notes as 2.9.0

    The release note is byte-identical to 2.9.0's and describes the same move to Marketing API v16.0, cut roughly four hours later the same day. It records the version bump rather than a distinct change.

    View source ↗
  4. 3y ago

    Migration to Facebook Marketing API v16.0

    The actual v16.0 migration, cut a minute after the v15.0 one and re-tagged again hours later as 2.9.2. Two API generations cleared in a single sitting is the clearest illustration of this package's batch-catch-up rhythm.

    View source ↗
  5. 3y ago

    Migration to Facebook Marketing API v15.0

    The v15.0 migration, released sixty seconds before the v16.0 one. Catching up two versions at once suggests the package had fallen behind Meta's deprecation schedule rather than tracking it release by release.

    View source ↗
  6. 3y ago

    Account spend caps exposed; vignettes restored

    fbGetAdAccounts() starts returning spend_cap, so account spending limits are readable without a separate call, alongside the API v14.0 migration and the return of the package vignettes. A representative release: one useful field, carried in on a version bump.

    View source ↗