Skip to main content
When Apple AdServices is enabled in RevenueCat, attributed installs write reserved customer attributes such as media source, campaign, ad group, and keyword. Appeeky reads these attributes through the RevenueCat API so you can tie subscription revenue back to paid acquisition — without exporting files manually. Use this alongside Apple Search Ads Profitability, which joins spend from Apple with revenue from RevenueCat charts. Attribution endpoints complement that view with customer-level dimensions, including country.

​
What This Answers

  • Which keywords drove paying customers, not just chart-level revenue segments?
  • How does attributed revenue break down by campaign and country?
  • Is Apple Search Ads attribution actually flowing into RevenueCat?
Customer attributes are fetched per customer. The summary endpoint samples recent customers for responsiveness. For large-scale historical analysis, RevenueCat Scheduled Data Exports remain the right tool inside RevenueCat; Appeeky focuses on live optimization workflows.

​
Prerequisites

  1. An Appeeky API key.
  2. A RevenueCat secret API key (sk_…) via X-RC-Key.
  3. Apple AdServices enabled in RevenueCat → Integrations.
  4. Installs with attribution data — attributes appear after attributed users are recorded.
Optional: X-RC-Project when your API key accesses multiple RevenueCat projects.

​
Attribution Summary

Aggregates a sample of customers who have attribution attributes, grouped by media source, campaign, keyword, and customer country. Includes total attributed revenue per group. 
GET /v1/connect/revenuecat/attribution-summary
The same endpoint is also available at: 
GET /v1/revenuecat/attribution-summary
Both paths behave identically. Connect-prefixed routes work with the Appeeky Connect client and dashboard proxy.

​
Query parameters

ParameterDefaultDescription
limit50Max customers to sample (1–100)

​
Example

curl
curl "https://api.appeeky.com/v1/connect/revenuecat/attribution-summary?limit=50" \
  -H "X-API-Key: YOUR_APPEEKY_KEY" \
  -H "X-RC-Key: sk_YOUR_REVENUECAT_SECRET_KEY" \
  -H "X-RC-Project: proj_YOUR_PROJECT_ID"

​
Response

{
  "data": {
    "sampleSize": 50,
    "customersWithAttribution": 14,
    "appleSearchAdsAttributed": 9,
    "attributionEnabled": true,
    "rows": [
      {
        "mediaSource": "Apple Search Ads",
        "campaign": "US Competitors",
        "adGroup": "Exact match",
        "keyword": "rival app",
        "country": "US",
        "customerCount": 4,
        "totalRevenue": 63.96
      }
    ]
  }
}

​
Fields

FieldDescription
sampleSizeCustomers scanned in this request
customersWithAttributionCustomers with at least one attribution attribute
appleSearchAdsAttributedCustomers whose media source indicates Apple Search Ads
attributionEnabledWhether any attribution data was found in the sample
rowsAggregated groups sorted by totalRevenue descending

​
Row dimensions

FieldRevenueCat attribute
mediaSource$mediaSource
campaign$campaign
adGroup$adGroup
keyword$keyword
countryCustomer’s last-seen country from RevenueCat
Revenue per row is summed from each customer’s subscription proceeds in USD.

​
Customer Attributes

Read the full attribute list for a single RevenueCat customer, including parsed attribution fields. 
GET /v1/connect/revenuecat/customers/:customerId/attributes
Also available at: 
GET /v1/revenuecat/customers/:customerId/attributes

​
Example

curl
curl "https://api.appeeky.com/v1/connect/revenuecat/customers/cust_abc123/attributes" \
  -H "X-API-Key: YOUR_APPEEKY_KEY" \
  -H "X-RC-Key: sk_YOUR_REVENUECAT_SECRET_KEY"

​
Response

{
  "data": {
    "customerId": "cust_abc123",
    "attributes": [
      {
        "name": "$mediaSource",
        "value": "Apple Search Ads",
        "updatedAt": 1719590400
      },
      {
        "name": "$campaign",
        "value": "US Competitors",
        "updatedAt": 1719590400
      },
      {
        "name": "$keyword",
        "value": "rival app",
        "updatedAt": 1719590400
      }
    ],
    "attribution": {
      "mediaSource": "Apple Search Ads",
      "campaign": "US Competitors",
      "adGroup": null,
      "ad": null,
      "keyword": "rival app",
      "creative": null
    }
  }
}

​
Reserved attribution keys

KeyParsed field
$mediaSourcemediaSource
$campaigncampaign
$adGroupadGroup
$adad
$keywordkeyword
$creativecreative
Other custom attributes on the customer are returned in attributes but not mapped into attribution.

​
How This Fits With Profitability

ViewSourceGranularityBest for
ProfitabilityApple Ads reports + RevenueCat chartsKeyword / campaign / ad groupSpend, ROAS, and rule-based insights in one table
Attribution summaryRevenueCat customer APIKeyword × campaign × country (sample)Confirm attribution is live; see revenue by acquisition dimensions
ROAS workflowBundles both + review gateEnd-to-end recommendationsWeekly optimization review
Chart-based profitability matches revenue to segment names from RevenueCat. Customer attributes expose the same acquisition dimensions at the user level, which is useful when chart segments lag or you need country alongside keyword.

​
MCP Tools

ToolDescription
rc_attribution_summarySample and aggregate attributed customers
rc_customer_attributesFull attribute list for one customer
See MCP for parameter details.

​
Errors

StatusCodeWhen
400MISSING_RC_KEYX-RC-Key not provided
400MULTIPLE_PROJECTSMultiple RC projects; specify X-RC-Project
401UNAUTHORIZEDInvalid RevenueCat API key
404NO_PROJECTSNo projects for this key