Skip to content

revises user identity section in apple server notifications doc#663

Merged
rglanz-rc merged 3 commits intomainfrom
rglanz/warn-about-uuid-in-apple-track-new-subscriptions
Feb 27, 2025
Merged

revises user identity section in apple server notifications doc#663
rglanz-rc merged 3 commits intomainfrom
rglanz/warn-about-uuid-in-apple-track-new-subscriptions

Conversation

@rglanz-rc
Copy link
Collaborator

@rglanz-rc rglanz-rc commented Feb 26, 2025

Motivation / Description

The 'User Identity' section of the Apple Server Notifications doc was a bit unclear, and did not mention that we don't set the appAccountToken in StoreKit 2 when the App User Id is not a valid UUID.

Changes introduced

New text:

User identity

New purchases are associated with the App User ID that matches the appAccountToken field of the transaction. If you are using RevenueCat's SDK to track purchases, we will set the appAccountToken for you. The appAccountToken will not be set if:

  1. You are using something other than a valid UUID for the App User ID (RevenueCat iOS SDK v5.0+ only—previous versions will set the App User ID as the appAccountToken)

  2. We receive the notification directly from the store before we receive it from the SDK

If the transaction's appAccountToken is not set, or if the appAccountToken does not match with an existing subscriber, RevenueCat will generate an anonymous App User ID to associate that purchase with. We will then proceed with your transfer behavior for the new App User ID set by the SDK.

Linear ticket (if any)

Additional comments

@rglanz-rc rglanz-rc requested a review from a team as a code owner February 26, 2025 19:23
@github-actions
Copy link

Preview this PR here: https://dev-docs.revenuecat.com/pr-663/

- If the `appAccountToken` is set and matches with an existing subscriber: No new subscriber will be created, and the purchase will be linked to that existing subscriber.
- If the `appAccountToken` is not set: RevenueCat will generate an anonymous app user ID to associate that purchase with.
- If you are using RevenueCat's SDK to track purchases, we may receive the notification directly from the store before the SDK. When this happens, we will follow the app user ID logic as described in the bullet point above, and then proceed with your [transfer behavior](/getting-started/restoring-purchases) for the new app user ID sent by the SDK.
New purchases are associated with the [App User ID](/customers/identifying-customers/) that matches the [`appAccountToken`](https://developer.apple.com/documentation/appstoreserverapi/appaccounttoken) field of the transaction. If you are using RevenueCat's SDK to track purchases, we will set the appAccountToken for you. The appAccountToken will **_not_** be set if:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
New purchases are associated with the [App User ID](/customers/identifying-customers/) that matches the [`appAccountToken`](https://developer.apple.com/documentation/appstoreserverapi/appaccounttoken) field of the transaction. If you are using RevenueCat's SDK to track purchases, we will set the appAccountToken for you. The appAccountToken will **_not_** be set if:
New purchases are associated with the [App User ID](/customers/identifying-customers/) that matches the [`appAccountToken`](https://developer.apple.com/documentation/appstoreserverapi/appaccounttoken) field of the transaction. If you are using RevenueCat's SDK to track purchases, we will set the `appAccountToken` for you. The `appAccountToken` will **_not_** be set if:

@rglanz-rc rglanz-rc merged commit 08db576 into main Feb 27, 2025
4 checks passed
@rglanz-rc rglanz-rc deleted the rglanz/warn-about-uuid-in-apple-track-new-subscriptions branch February 27, 2025 18:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants