One Link Integration Type

For Publishers Adding a rewarded layer to your app/website

This guide is for publishers looking to add a rewarded layer to their website or mobile app, allowing users to earn by taking surveys and offers, and redeem rewards like gift cards.

Here, you’re just required to place an icon/banner and pass gaid/userid on url opening in iframe for web-based applications & webview/cct/ WKWebView, or SFSafariViewController for

We handle all user authentication, user account balance, user redemption on our end

Step 1 – Register an Account #

  1. Visit: https://app.pocketsfull.ai/auth/signup
  2. Fill in your details and create an account.
  3. Verify your email if required.

Step 2 – Log In and Open the Apps Section #

  1. Log in with your registered credentials.
  2. From the left-side navigation menu, click on Apps. (See reference screenshot below)

Step 3 – Create a New App #

  1. On the My Apps page, click the Create New App button at the top right. (Reference screenshot)

Step 4 – Select Account Integration Type #

  1. In the app creation form, scroll to the bottom.
  2. Under Account Integration Type, select One Link Integration. (Reference screenshot)

Please note: Make sure “Is UID parameter required” toggled ON

Step 5 – Access Integration Instructions #

  1. Save your settings.
  2. You will now land on the Instructions Page — here you will find the URL to load for each user.
  3. We provide:
    • Complete iframe tag (for web publishers).
    • Direct URL (for mobile iOS & Android using WebView, ChromeCustomTab, WKWebView, or SFSafariViewController).

Special Note – Passing User Identification

  • Mobile Publishers: You have three options to pass user authentication detals, either GAID, APPSETID or UUID

    We'll brief explain the different in all three

    IDWhat it isDependenciesProsBest for

    GAID

    Google Advertising ID (user-resettable from Play services)

    Google Play services; declare AD_ID permission on Android 13+; respects user opt-out

    Widely supported by ad partners; stable across apps; enables ads attribution/personalization

    If you can use google dependencies to send GAID!

    App Set ID

    Privacy-oriented ID linking apps in the same developer account on a device (dev-scope; app-scope fallback)

    Play services App Set ID API; no runtime permission

    Cross-app dedupe within your portfolio; privacy-friendlier than GAID; works when GAID unavailable

    IF GAID is not available, you can send APPSETID, it's widely accepted and a safer version of GAID

    App-generated UUID

    Random ID you generate and store locally (app-scoped), unique to each user

    None—generate via standard library and persist in app storage

    Easiest to implement; no Google dependencies/permissions; strong in-app privacy

    If you don't mind populating app storage on your end, it's advisable to use if you're plan not to use google dependencies/libraries to send GAID or APPSETID

    Pass GAID (Google Advertising ID), APPSETID OR UUID for user identification.

  • Apps with Internal User IDs: You can pass your own User ID instead of GAID.
    • In the URL, you will see:
      &uid = {unique_user_id}
      Replace {unique_user_id} with the actual GAID,APPSETID OR UUID.
  • Web Publishers: You can pass USERID.
  • Apps with Internal User IDs: You can pass your own User ID instead of GAID.

Step 6 – Add Placement #

  1. Place a banner/icon on your site or app to lead users to the offers/surveys.
  2. Our in-house UI team will design this placement for you — contact your Account Manager.

Step 7 – Testing & Launch #

After all is done just click on GOLIVE button on your dashboard and we’ll do few tests on your integration and make sure everything is set on our end

✅ Integration Complete!

With One Link Integration, you have not added a rewarded layer to your website & app letting users earn monetary gift-cards available in 100+ countries.