Summary Reference Table
Open Beta Documentation Amazon offers this technical
documentation as part of a pre-release, open beta. The features described might change as Amazon receives feedback
and iterates on the features. For the most current feature information, see the Release
Notes.
Trigger from Customer | Basic Instructions | SDK Function Calls |
---|---|---|
Signs into the app | Share all customer entitlements through the ContentPersonalizationServer . |
- ContentPersonalizationServer.reportRefreshedContentEntitlements(...) - ContentPersonalizationServer.reportRefreshedCustomerList(..., CustomerListType.Watchlist) |
Signs out of the app | Do not share data when customer signs out. | N/A |
Switches profiles | Share any profile specific information not previously shared. | - ContentPersonalizationServer.reportRefreshedCustomerList(..., CustomerListType.Watchlist) - ContentPersonalizationServer.reportNewPlaybackEvent(...) |
Opens app while signed in | Share updated information, which may have occurred on another device, since the last time the customer opened the app. This includes: - Content entitlements - Watchlist - Playback ( eventsPlayback events must be marked as Off-Device). |
- ContentPersonalizationServer.reportRefreshedContentEntitlements(...) - ContentPersonalizationServer.reportRefreshedCustomerList(..., CustomerListType.Watchlist) - ContentPersonalizationServer.reportNewPlaybackEvent(...) |
Watches content | Share a message using the reportNewPlaybackEvent SDK function in the ContentPersonalizationServer class, indicating that the content is playing. Mark these events as Active . Continue making calls to reportNewPlaybackEvent when the customer’s playback state changes. For example:- The customer pauses playback. - An advertisement (interstitial) starts playing. - The customer exits playback so that content is no longer in view. - The customer completes the content.- Once every 60 seconds of playback. |
- ContentPersonalizationServer.reportNewPlaybackEvent(...) |
Adds or removes items from watchlist | When the customer adds items to their watchlist, invoke the reportNewCustomerListEntry function on the ContentPersonalizationServer .When they remove items, invoke the reportRemovedCustomerListEntry function on the ContentPersonalizationServer . |
- ContentPersonalizationServer.reportNewCustomerListEntry(..., CustomerListType.Watchlist) - ContentPersonalizationServer.reportRemovedCustomerListEntry(..., CustomerListType.Watchlist) |
Purchases, rents, or records content | Share by invoking the ContentPersonalizationServer .If individual content entitlements are lost due to complex expiration rules, use reportRemovedContentEntitlement to indicate. We will handle all time-based expirations. |
- ContentPersonalizationServer.reportNewContentEntitlement(...) - ContentPersonalizationServer.reportRemovedContentEntitlement(...) |
Watches trailer, views content detail page, or likes or dislikes content | Share through the ContentPersonalizationServer class. |
- ContentPersonalizationServer.reportNewContentInteraction(...) |
Last updated: Sep 30, 2025