Skip to main content

AttributionResult

Contains information about how the user discovered and installed your app.

Properties

id

A unique identifier for this attribution record.

status

The attribution status. See AttributionStatus below.

campaignId

The Apple Search Ads campaign ID.
Only available when status is .attributed.

campaignName

The Apple Search Ads campaign name.

adGroupId

The ad group ID within the campaign.

adGroupName

The ad group name.

keywordId

The keyword ID that triggered the ad.

keyword

The keyword text that the user searched for.

countryOrRegion

The two-letter country or region code (ISO 3166-1 alpha-2). Examples: "US", "GB", "JP", "DE"

clickDate

The date and time when the user clicked the ad.
Only available when the user has opted into tracking.

conversionType

The type of conversion.

supplyPlacement

The ad placement where the user saw the ad.

Usage Example


AttributionStatus

The attribution status indicating how the user acquired the app.

Cases

attributed

The user installed the app after clicking an Apple Search Ads advertisement. When attributed, the AttributionResult contains campaign, ad group, and keyword data.

organic

The user found and installed the app organically (not through ads). Organic installs don’t have campaign or keyword data.

unknown

The attribution status could not be determined. Possible reasons:
  • Attribution data is still being processed
  • The device doesn’t support attribution
  • An error occurred during attribution lookup

Usage Example

Status Comparison

Attribution Guide

Learn about attribution

SpendOwlError

Error handling