Apple Ads Attribution Data Reference
Apple Ads attribution fields collected by RevenueCat
Apple Ads is different from event-forwarding providers. This page maps Apple Ads source fields to the attribution data RevenueCat stores and uses. RevenueCat collects Apple Ads attribution data from the app and Apple Ads APIs; it doesn't send subscription lifecycle events to Apple Ads.
For setup steps, see Apple Ads.
How RevenueCat stores Apple Ads data
RevenueCat stores Apple Ads attribution data on the customer. It can use that customer-level context for Charts segmentation or downstream integrations that depend on Apple Ads attribution, such as Asapty and SplitMetrics Acquire. This data doesn't attribute each individual transaction.
When Apple Ads attribution is successfully collected, supported values are published as reserved customer attributes, including $mediaSource, $campaign, $adGroup, and $keyword. Not every field returned by Apple is available through public APIs.
Use the Get a list of the customer's attributes endpoint to retrieve these values for an individual customer. Customer attributes are also included with transaction data in Scheduled Data Exports.
Only fields RevenueCat receives and can resolve are populated. The absence of Apple Ads customer attributes doesn't indicate an organic install or expose an explicit negative attribution result.
Apple source fields to RevenueCat attribution data
| Apple source field | Stored as | RevenueCat behavior |
|---|---|---|
attribution | apple_attribution_has_attribution | Indicates whether Apple attributed the install to Apple Ads. |
orgId, orgName | apple_attribution_org_id, apple_attribution_org_name | Identifies the Apple Ads organization when Apple provides it. |
campaignId, campaignName | apple_attribution_campaign_id, apple_attribution_campaign_name | Available for Charts segmentation and downstream integrations. |
purchaseDate, conversionDate | Stored internally | Stored when Apple provides them, but not exposed as apple_attribution_* fields in customer data. |
adGroupId, adGroupName | apple_attribution_adgroup_id, apple_attribution_adgroup_name | Available for Charts segmentation and downstream integrations. |
keywordId, keyword, keywordMatchType | apple_attribution_keyword_id, apple_attribution_keyword, apple_attribution_keyword_match_type | Stored when available. |
creativeSetId, creativeSetName | apple_attribution_creativeset_id, apple_attribution_creativeset_name | Stored when available. |
lineItemId, lineItemName | apple_attribution_lineitem_id, apple_attribution_lineitem_name | Stored when available. |
adId | apple_attribution_ad_id | Stored when available. |
countryOrRegion | apple_attribution_country_or_region | Stores the Apple Ads country or region as an ISO 3166-1 alpha-2 code when Apple provides it. |
conversionType | apple_attribution_conversion_type | Used for reporting and downstream integration enrichment. |
claimType | apple_attribution_claim_type | Used for reporting and downstream integration enrichment. |
clickDate | Stored internally | Available only for Detailed attribution data, but not exposed as an apple_attribution_* field in customer data. |
impressionDate | apple_attribution_impression_date | Available only for Detailed attribution data. RevenueCat exposes this timestamp in milliseconds. |
supplyPlacement | Stored internally | Stores the Apple Ads placement, such as App Store search results, when available, but not exposed as an apple_attribution_* field in customer data. |