iOS Attributes and Attribution

AppActor keeps customer context and attribution context separate. Use this page for custom attributes, profile helpers, integration identifiers, and campaign fields. Use the Apple Search Ads page for ASA setup and diagnostics.

Custom attributes

try await AppActor.shared.setAttributes([
    "paywall_variant": .string("hero_a"),
    "cohort": .string("spring_launch"),
])

Use:

setAttributes(_:)
setAttribute(_:value:)
unsetAttribute(_:)

Keep custom keys truly custom. Reserved or system-prefixed keys belong on dedicated helpers.

Reserved profile helpers

Use built-in helpers instead of inventing custom keys:

setEmail(_:)
setDisplayName(_:)
setPhoneNumber(_:)
setPushToken(_:)
collectDeviceIdentifiers()

Integration identifiers

Use integration IDs for tool-specific identity:

setIntegrationIdentifier(_:value:)
unsetIntegrationIdentifier(_:)
setAppsFlyerID
setAdjustID
setBranchID
setFirebaseAppInstanceID
setOneSignalID

Campaign attribution

Use updateAttribution(...) for full campaign payloads, or lighter helpers for individual fields:

setMediaSource
setCampaign
setAdGroup
setAd
setKeyword
setCreative

Attribution System

See how custom attributes, integration IDs, campaign fields, ASA, and Install Referrer fit together.

​Custom attributes

​Reserved profile helpers

​Integration identifiers

​Campaign attribution

Attribution System

Custom attributes

Reserved profile helpers

Integration identifiers

Campaign attribution