Unity SDK Setup

The Reteno Unity Plugin for Mobile Customer Engagement and Analytics solutions

Overview

Reteno is a lightweight Plugin for Unity platform that helps mobile teams integrate Reteno into their mobile apps. The server-side library makes it easy to call the Reteno API.

The SDK supports:
  • Unity 2021.3 or newer
  • iOS 12.0 or later
  • Android 8.0 or later (minSdk = 26)

Getting started with Reteno SDK / Setup guide

Install via Package Manager

Please follow the instructions:

  1. Open Edit/Project Settings/Package Manager.
  2. Add a new Scoped Registry (or edit the existing OpenUPM entry):
Package Manager
   Name: package.openupm.com
   URL: https://package.openupm.com
   Scope(s): com.reteno.core
  1. Click Save or Apply.
  2. Open Window/Package Manager.
  3. Click +.
  4. Select Add package by name....
Add package by name
  1. Paste com.reteno.core into the name field.
  2. Paste 1.0.2 into the version field.
  3. Click Add.

Now your Unity project is configured to use the specified package.

Install via Package Manifest

Alternatively, merge this snippet to Packages/manifest.json:

{
  "scopedRegistries": [
    {
      "name": "package.openupm.com",
      "url": "https://package.openupm.com",
      "scopes": [
        "com.reteno.core"
      ]
    }
  ],
  "dependencies": {
    "com.reteno.core": "1.0.2"
  }
}

Step 2: Set up a Firebase Cloud Messaging client app with Unity

If you do not have Firebase project

If you do not have Firebase project yet, you will have to set it up.
We suggest following official setup guide .

If you already have Firebase project

If you already have Firebase project, you have to add Firebase configuration files to your Unity app:

  • For iOS — GoogleService-Info.plist.
  • For Android — google-services.json.
    They can be placed anywhere in Assets folder.

Also you have to download Firebase Unity SDK from Add Unity SDKs section in official setup guide page or by a direct link .

After this return to Unity and follow these steps:

  1. Click Assets → Import package → Custom package...
  2. Pick Firebase Unity SDK which you downloaded
  3. Choose FirebaseMessaging.unitypackage and import all assets from this package.

Initialization of RetenoSDK

We highly recommend to initialize RetenoSDK as soon as possible after the start of your application.
To initialize the SDK you need to retrieve an access key from Reteno admin panel.
In your C# script call RetenoSDK.Initialize(...) and pass the key as the parameter:

RetenoSDK.Initialize("your_access_key");

The Core RetenoSDK setup is done, now you can navigate to specific platform setup:

  • iOS (Not available in current RetenoSDK version)
  • Android
Licence

Reteno Unity Plugin is released under the MIT license. See LICENSE for details.