SDK
v1.1
v1.1
  • Getting Started
    • Welcome
    • Start Here
    • Postback Payout (S2S)
    • Advanced options
      • Sending Media Source Data
      • Sending User Segments / User Info
  • Unity
    • Installation
    • Initialization
    • Obtaining Advertising ID's
    • Payout via SDK
  • Android
    • Prerequisite
    • Installation
    • Initialization
    • Obtaining Adverstising ID's
  • Flutter
    • Prerequisite
    • Installation
    • Initialization
    • Obtaining Advertising ID's
  • REACT NATIVE
    • Prerequisites
    • Installation
    • Initialization
    • Obtaining Advertising ID's
  • Web / Iframe
    • Initialization
Powered by GitBook
On this page
  • 1. Setting Up
  • 2. Initialization
  • 2.1 Advanced Practices for initialization for personalized rewards
  • 3. User Login
  • 4. Player Profile
  1. Unity

Initialization

PreviousInstallationNextObtaining Advertising ID's

Last updated 10 months ago

1. Setting Up

Drag and drop the TyrAds SDK prefab that you imported previously to your main menu scene. Location: Assets/TyrAdsSDK/TyrAdsSDK.prefab

  • Api Key: The API key (32 hexadecimal string)

  • Api Secret: The API secret (92 hexadecimal string)

2. Initialization

SDK Initialization best practices:

  • Initiate early: It's advisable to initialize the SDK promptly after your app launches to ensure that all Tyr SDK functionalities are accessible when needed.

  • Initiate post-app authentication: Re-initiate the SDK with current user details immediately after your user signs up or signs in to the app to update the userId.

  • Initiate periodically: To optimize user experience, we strongly suggest invoking this method each time your app is brought to the forefront. This shouldn't impact your app's performance noticeably.

This step initializes the Tyrads SDK within your application. You need to provide the API key and API secret obtained from the Tyrads platform. This allows your app to communicate securely with Tyrads' servers.

2.1 Advanced Practices for initialization for personalized rewards

To maximize the value to the user sending us more data about the user and where they came from allow us to customize the reward experience. This can be used to provide feedback of quality of users aswell as customize the earnings journey of different segments of users.

To maximize the value of our TyrAds SDK please follow the advanced options for intialization. This will allow us to personalize the rewards for the user event further and maximize the earnings for you as publisher.

Sending Media Source Data

Sending User Segments / User Info

3. User Login

Upon initializing the SDK, it is mandatory to save the user data in app storage to retain the user data. A unique GAID is generated the first time the user installs the SDK, and this GAID is passed to the initialize() method in TA_API. This method checks if the user is new to create a new user or update an existing one. This login process ensures that user interactions with the offer wall are accurately tracked and attributed within the application.

  • it will generate its own device identifier and store it in the app storage. If this is the case, your app user will lose the progress data when the user uninstalls the app

  • If you send us your userId within userId field from your backened we will save this and even if the user changes their device ID we will keep their progress.

4. Player Profile

Set your player profile at the app launch

TyrAds.SetProfile(string userId, int gender, int yearOfBirth)

The parameter of this call:

  • userID: A custom string identifier that you can assign to the user. If you don't already have one for the user, set this parameter as an empty string "", the SDK will generate it automatically.

  • gender: The gender of the user. Enum: 0 for male, 1 for female

  • yearOfBirth: The year of the user's birthday. Format: YYYY

The generated user ID from the SDK is based on the device identifier (GAID/OAID/IDFA)

  • If your app user resets the device identifier, your user will lose the progress data

  • If the SDK can't access the device identifier, it will generate its own device identifier and store it in the app storage. If this is the case, your app user will lose the progress data when the user uninstalls the app

  • If you send us your userId within userId field from your backened we will save this and even if the user changes their device ID we will keep their progress.