FAQ

Playtime SDK

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 Offerwall 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.

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 using Flutter or React Native - how 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}`);
    });
  }
};

Using the Playtime Offerwall

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

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 (Playtime), 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 Advance, Advance+, and Playtime 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?

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

Why does the user need to accept TOS?

We have more information about this in our docs. Please refer to them here. This is what the users sees in the TOS page:

We hereby inform you that adjoe GmbH processes the following personal data within the framework of the use of Playtime:

  • Installed apps (including the use duration and use history)

The data will be connected to your end device via the device ID and sent, encrypted, to our servers. In order for app providers to finance our app suggestions, we must send them the device ID for billing purposes.

The processing of the above data is necessary to be able to recommend, via system messages, the installation of apps available in Playtime that match your interests, and calculate the bonuses acquired as a result of your use of the corresponding apps.

Consent

By clicking on ACCEPT, I give adjoe GmbH my consent to process my above-mentioned personal data and transmit it to other app providers so that I can use Playtime as described.

I am aware that a profile of interests will be generated using the above data, and depending on the types of apps I use, this may contain particularly sensitive personal data (e.g. health-related data or data about my sexual orientation, and any other data in special categories pursuant to Art. 9[1] GDPR). For that reason my consent also applies explicitly to the processing of this data. The full links to our Data Privacy Statement and Terms and Conditions of use are available here and here respectively.

https://adjoe.zone/legal/en/data_privacy.html

https://adjoe.zone/legal/en/terms_of_use.html

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 Offerwall?

Most parts of the Playtime Offerwall 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 Publisher Dashboard. They are also available via API.

Last updated