Set Up
Implementing Playback Direct
Getting started with the main implementation of Playback Direct within your app
Adding Playback Directly to Your App
In order to integrate Playback Direct into your app, you simply need to direct users to the Playback Direct Offers via a URL. We suggest doing this via a button within your app. The basic structure of the URL is:
https://offers.playbackdirect.com/o/{sub_source_id}?user_id={user_id}&adid={adid}
There are parameters that should be appended by you, the developer, to make sure that a user’s experience is resumed based on their last session using Playback Direct and that they receive the appropriate rewards when tasks are completed.
Below are more details on additional (optional) parameters that you can supply if you have them available. These additional parameters can help Playback Direct to improve targeting (improving overall revenue) as well as give you better visibility into individual user behavior. All of these parameters will be saved and sent back to you when connected to a specific revenue & reward event sent via the server to server payouts API for you to better understand how different factors affect overall performance.
sub_source_id | This is a unique ID we will assign to you to identify users coming from your app. | Required |
|---|---|---|
user_id | This should be a permanent id that stays the same for the life of the user between sessions. It is the main way we maintain user permanence within Playback Direct. | Required |
adid | For Android mobile devices, this would be the GAID (google advertising ID). For iOS, this would be the IDFA. Populating this value will allow us to give the best experience to your users by unlocking and earning them rewards more reliably which in turn results in greater overall revenue. ***Find more notes on this particular parameter below | Required* |
age | Current age of the user. Must be a number 1-120 | Optional |
gender | Gender of the user. Four values are expected and processed by default male, female, other, and unknown | Optional |
network | The Advertising Network that you acquired this user through. Must be a string 512 characters or less. example: applovin | Optional |
URL Examples:
With parameter placeholders:
https://playbackdirect.com/o/{your_company_name}?user_id={user_id}&adid={adid}&gender={gender}&network={network}&info1={info}
With example data:
https://playbackdirect.com/o/gamecompany123?user_id=13xsk4s&adid=A9876543-2345-6789-0ABC-1234567890AB&gender=male&network=facebook&info=highvalue
***ADID NOTES***:
- Android devices: This should always be something that is available to you and likely already stored
- iOS devices: This is something that requires the user to have previously tapped “Allow” on the App Tracking Transparency prompt within your app (if you’ve enabled it). Otherwise, you won’t have this ID or it will be a string of 0’s
- While this id is not strictly required, it is highly recommended as it is another ID that can be uniquely helpful to check against the user_id both for user permanence as well as fraud detection
- Purely, web-based applications will not have either of these mobile app specific IDs available to them. If that is the case, you can discuss alternative IDs that you may have available to share with your Playback Direct rep
User Experience Best Practices
A few notes on how to optimize and make sure the user experience is a good as it can be for your users.Color and theme customization
In order to create a more native experience, you’re able to change the primary color, logo, and currency icon of Playback Direct to better match your brand. You can work with your Playback Direct rep to make these adjustments.
Rewards
As a player completes tasks they’ll earn rewards. You’ll receive postbacks via the server to server payouts API. You’ll then need to manage the distribution and claim flow of these rewards to the user.Terms of service Opt-In
Upon the first opening of Playback Direct, each user will be presented with a Terms of Service that they will need to agree to. The Terms of Service is required for any use of Playback Direct.