FAQ


Playtime SDK for Android

Is it necessary to provide the userId at app start-up with the init method?

No. Since the init method should happen at app start-up, there are circumstances where you don’t yet have this data. For example, if the user hasn’t signed in yet. In these cases, it’s still critical to init at the app start up, but you can pass in the UA Params or User ID in an OnResume / AppState / didChangeAppLifecycleState function when you have the data.

Remember that the userId is critical for doing S2S payouts, without it your users will not be able to get their rewards. It is also important to note that whatever the last supplied userId was is what will be sent in the S2S payout URL. Therefore, the last supplied User ID was is what will be sent in the S2S payout URL.

Do I need to do anything with the Playtime SDK after the user logs out?

No. But if the user can only access the Playtime Catalog after logging-in, then you should remove any calls to init when they log out.

What is the size of SDK?

SDK size depends on the wrapper, but it is roughly <0.5MB.

Can I show the adjoeActivity in a Fragment?

No, this is not supported.

How often is the SDK updated?

The SDK is updated every couple of months. Please keep an eye out on our changelog.

What kind of data does the SDK track? I need to share this information with the Google Play Store.

All of the data that we collect can be found in the AndroidManifest.xml of the SDK.

How do users know that they are able to receive a reward?

For Android users, we show a toast message on the top of the screen whenever a user is able to receive a reward.

I'm not seeing campaigns/games in the catalog?

The most common reason this happens is because of VPN usage. If you use a VPN, you might not see any campaigns, even if you set yourself as a test user. We still filter out IP addresses that are anonymous.

After playing some time-based reward games, I stopped receiving rewards after 15 mins. Why?

It can happen because you stopped progressing through the game. To fix this, please keep playing and progressing through the game.

What's the difference between time-based and event-based campaigns?

We have more information about this in our docs. Please refer to them here.

What is the use of the GAID?

We use GAID to identify users. We provide these data to MMPs so they can count attribution.

Why does the user need to accept Access to Advertising Info?


PlaytimeWeb for iOS

Does the the PlaytimeWeb use cookies?

We only keep cookies in the page during the session. It allows us to keep track of the user (like after authentication) and make sure that they get their rewards.

What is the use of the IDFA?

We use the IDFA to identify users and to accurately identify the user for rewarding purposes, ensuring any currency earned via PlaytimeWeb is promptly paid out. We provide the IDFA to MMPs so they can count attribution.

Why does the user need to accept App Tracking?

Why does the user need to accept TOS?

We have more information about this in our docs. Please refer to them here.


React Native / Flutter

I'm using Flutter or React Native - can I use your Android SDK and iOS solution together?

Yes, you can use the Platform properties provided by the Flutter and React Native libraries to set up the code in a way to conditionally execute certain code blocks based on the platform the app is running on. Since we only have an SDK on Android, you may need to use platform-based imports for RN or add platform-specific dependencies in the pubspec.yaml for Flutter.

Example for React Native:

const showAdjoeOfferwall = async () => {
  if (Platform.OS === 'ios') {
    return navigation.navigate('InAppBrowser', {
      url: `https://{your_company_name}.playtimeweb.com/play?user_id={user_id}&idfa={IDFA}`
    });
  }

  if (adjoeInitialized && Platform.OS === 'android') {
    return await Adjoe.showOfferwall().catch(err => {
      console.error(`Could not show Adjoe offerwall: ${err}`);
    });
  }
};

Business

How do I give one of my coworkers access to the dashboard?

You should reach out to your Account Manager. They can provide them with access.

What customization options do you provide for the Playtime Catalog?

Most parts of the Playtime Catalog can be customized so that it fits your branding - including images, colors, texts, fonts, and currency. Your Account Manager will reach out to you separately to set up these customizations.

Where can I track KPIs like Revenue or Active User Rates?

These KPIs can be tracked in the Monetize Dashboard. They are also available via API.


Get Further Support

Still need help with something? Have an idea for a Feature Request? Please use this template to reach out to your Account Manager for help.

  • Issue Type: [Bug/Feature Request]

  • Framework: [iOS/Android/Flutter/React Native/Unity/Cordova]

  • SDK Version:

  • Priority: [High/Medium/Low]

  • Crash: [Yes/No]

    • Devices Affected: (e.g., Samsung, Pixel. iPhone 12)

    • User Impact: Number or percentage

    • Environment: [Production/Test]

  • Issue/Feature Description: Provide a detailed description. For feature requests, explain the necessity and potential business impact.

  • Reproduction Steps:

  • Expected Behavior:

  • Actual Behavior:

Please include any relevant logs, crash reports, API calls, or screenshots to support your query.

Last updated