Overview

adduck docs

adduck is a CLI for managing ad campaigns across Apple Search Ads, Reddit, Meta, AppLovin, Unity, and ironSource. One command for spend reports. Pause, resume, and change budgets without opening six dashboards.

Install

npm install -g adduck

Requires Node.js 18 or later.

Create a project

A project is a named collection of connected ad accounts. You can have multiple projects (one per app, one per team, etc.).

adduck init

This creates adduck.json in the current directory. You can also run adduck from any directory by pointing it at a config file:

adduck spend --config ~/work/myapp/adduck.json

Connect your first platform

adduck auth login apple

Each platform has different credentials. See the platforms section for what each one needs.

Once a platform is connected, its credentials are stored in adduck.json (or in environment variables if you prefer -- see projects).

Run your first spend report

adduck spend --days 7

This pulls 7 days of spend, installs, and CPI from every connected platform and prints them side by side. Sorted by CPI by default.

$ adduck spend --days 7

  NETWORK    CAMPAIGN              SPEND    INSTALLS    CPI
  ───────────────────────────────────────────────────────
  META       Lookalike 1%          $203          71    $2.86
  APPLE      iOS App: Exact Match  $142          47    $3.02
  UNITY      Banner + Interstitial  $41          12    $3.41
  IRONSRC   Rewarded 30s            $55          16    $3.44
  APPLOVIN  Rewarded Video          $67          18    $3.72
  REDDIT     App Awareness Q3        $89          22    $4.05
  ───────────────────────────────────────────────────────
  total                             $597         186    $3.21

What's next