AppsFlyer · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Aggregate Pull API V1 Token Aggregate (user acquisition and…

6 actions 6 updates phrasing extends openapi/appsflyer-aggregate-user-acquisition-and-retargeting-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for AppsFlyer's API. It is a proposal applied on top of the contract, not a document AppsFlyer publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 6

$.info
$.paths['/{app-id}/daily_report/v5'].get
$.paths['/{app-id}/geo_by_date_report/v5'].get
$.paths['/{app-id}/geo_report/v5'].get
$.paths['/{app-id}/partners_by_date_report/v5'].get
$.paths['/{app-id}/partners_report/v5'].get

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Aggregate Pull API V1 Token Aggregate (user acquisition and…
  version: 1.0.0
extends: openapi/appsflyer-aggregate-user-acquisition-and-retargeting-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/{app-id}/daily_report/v5'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the daily aggregate performance report
      effect: read
      questions:
      - How do I get day-by-day installs and cost per campaign, without in-app events?
      - Can I see daily LTV performance by media source in the app's timezone?
      instructions:
      - text: Get the daily report for {app} from {from} to {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
      - text: Get the daily retargeting report for {app} from {from} to {to} with reattr {reattr}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
          reattr: query.reattr
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{app-id}/geo_by_date_report/v5'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the geo-by-date aggregate report
      effect: read
      questions:
      - Can I break down campaign performance by country for each day?
      - Which countries drove installs on each date of a campaign?
      instructions:
      - text: Break down {app} installs by country for each day from {from} to {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
      - text: Get the per-country daily report for {app} from {from} to {to} for media source {media_source}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
          media_source: query.media_source
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{app-id}/geo_report/v5'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the geo aggregate report
      effect: read
      questions:
      - What is campaign performance per country across a whole date range?
      - Can I get country totals by media source without a per-day split?
      instructions:
      - text: Get the geo report totals for {app} from {from} to {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
      - text: Get country-level totals for {app} from {from} to {to} in currency {currency}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
          currency: query.currency
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{app-id}/partners_by_date_report/v5'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the partners-by-date aggregate report
      effect: read
      questions:
      - How did each ad partner perform on each day of the period?
      - Can I get partner performance per day including view-through attribution?
      instructions:
      - text: Show each ad partner's day-by-day results for {app} from {from} to {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
      - text: Get the partners-by-date report for {app} from {from} to {to} with touch type {touch}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
          touch: query.attribution_touch_type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{app-id}/partners_report/v5'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the partners aggregate report
      effect: read
      questions:
      - Which media sources and campaigns delivered the best LTV overall?
      - Can I pull partner totals for a date range in a single summary?
      instructions:
      - text: Get the partners summary report for {app} from {from} to {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
      - text: Get partner totals for {app} from {from} to {to} in category {category}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
          category: query.category
      method: generated
      generated: '2026-10-01'