Initialization

Integrating the Tyrads offerwall functionality into your application is a straightforward process that involves a few key steps. By following these integration steps, you can seamlessly incorporate the offerwall feature, enhancing user engagement and potentially generating revenue for your application.

1. Initialization

SDK Initialization best practices:

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.

Tyrads.getInstance().init(context, apiKey: "xyz", apiSecret:"abc123");

1.1 Advanced Practices for intialization for personalized rewards

To maximize the value of our Tyr 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

2. User Login

Upon initializing the SDK, the mandatory step is to log in the user. However, passing a user ID is optional and is only necessary when the publisher operates its own user system. This login process ensures that user interactions with the offerwall are accurately tracked and attributed within the application.

await Tyrads.getInstance().loginUser(userID: "xxx");//userID is optional 

3. Show Offerwall

Once the SDK is initialized and the user is logged in (if applicable), you can display the offerwall to the user. This typically involves calling a function provided by the Tyrads SDK, such as showOffers. The offerwall is where users can engage with various offers, advertisements, or promotions provided by Tyrads, potentially earning rewards or incentives in the process.

Tyrads.getInstance().showOffers();

Deeplinking Routes

Min SDK version required: v1.1.8

The Tyrads SDK supports deeplinking to specific sections of the offerwall. When initializing or interacting with the SDK, you can specify a route to open a particular page. For campaign-specific routes, you'll need to provide the campaignID as well.

Available routes and their usage:

  • campaigns - opens the Campaigns Page

  • campaigns-activated - opens the Activated Campaigns Page

  • campaign-details - opens the Campaign Details Page (requires campaignID)

  • campaign-tickets - opens the Campaign Tickets Page (requires campaignID)


// Note: CAMPAIGNS is the default route when no specific route is provided
Tyrads.getInstance().showOffers();

// Explicitly specifying the Campaigns Page
Tyrads.getInstance().showOffers("campaigns");

// Activated Campaigns Page
Tyrads.getInstance().showOffers("campaigns-activated");

// Campaign Details Page (requires campaignID)
Tyrads.getInstance().showOffers("campaign-details", "your_campaign_id_here");

// Campaign Tickets Page (requires campaignID)
Tyrads.getInstance().showOffers("campaign-tickets", "your_campaign_id_here");

TopPremiumOffers Composable Function

Overview

The TopPremiumOffers composable function is designed to display top premium offers within the application. It utilizes the TopOffers composable to render the offers with specific settings.

Parameters

This function accepts the following parameters with default values:

  • showMore: A boolean indicating whether to display a "show more" option. Defaults to true.

  • showMyOffers: A boolean indicating whether to show the user's personal offers. Defaults to true.

  • showMyOffersEmptyView: A boolean indicating whether to display an empty view when there are no personal offers. Defaults to false.

  • style: An integer specifying the visual style or layout for the offers. Defaults to 2. Available styles are:

    • Available Style options

      • Style 1: Default style.

      • Style 2: Currently used.

      • Style 3: Alternate layout.

      • Style 4: Advanced layout.

Configuration

The TopOffers composable is configured using the provided parameters, except for the style which is always set to 2 regardless of the input.

  • showMore: Set based on the showMore parameter.

  • showMyOffers: Set based on the showMyOffers parameter.

  • showMyOffersEmptyView: Set based on the showMyOffersEmptyView parameter.

  • style: Always set to 2, regardless of the input.

Usage

To use this composable, you can call it through the Tyrads instance like this:

Tyrads.getInstance().TopPremiumOffers(
    showMore = true,
    showMyOffers = true,
    showMyOffersEmptyView = false,
    style = 2,
)

Or, use the default values:

Tyrads.getInstance().TopPremiumOffers()

Notes

  • Style Parameter: The style parameter is not currently used to change the style of the offers; it always defaults to 2. Consider updating the function to use this parameter effectively.

Last updated