Installation

The TyrAds Unity SDK available from a Git URL. To install:

  1. Open the Package Manager window in Unity, if it’s not already open.

  2. Open the Add (+) menu in the Package Manager’s toolbar.

  3. Select Install package from git URL from the install menu.

  4. Enter a Git URL in the text box: https://github.com/tyrads-com/tyrads-unity-sdk-package.git

  5. Select `Install`.

If you want to check for updates and update TyrAds Unity SDK dependency to the latest version from the repository, click Update in the Package Manager window.

If you want to install a certain version of the TyrAds Unity SDK you can specified a version in the Git URL:

https://github.com/tyrads-com/tyrads-unity-sdk-package.git#3.1.0

To explore how to use the TyrAds Unity SDK, import the Demo example from the package’s Samples section in the Unity Package Manager.

Required Android Permissions

To ensure proper SDK functionality, configure your main AndroidManifest.xml at:

Assets/Plugins/Android/AndroidManifest.xml

You can either:

  • Copy the reference manifest as your main file from Assets/Plugins/TyrAdsSDK/AndroidManifestReference/AndroidManifest.xml, or

  • Add the following permissions manually to your existing manifest:

<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"
                 tools:ignore="QueryAllPackagesPermission" />
<uses-permission android:name="android.permission.PACKAGE_USAGE_STATS" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
<uses-permission android:name="com.google.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE" />
<service android:name=".BackgroundService" android:enabled="true" android:exported="false" />
    <receiver android:name="com.adjust.sdk.AdjustReferrerReceiver" android:permission="android.permission.INSTALL_PACKAGES" android:exported="true">
      <intent-filter>
        <action android:name="com.android.vending.INSTALL_REFERRER" />
      </intent-filter>
    </receiver>

Important Notes:

  • Placement: Add the permissions inside the <manifest> tag but outside the <application> tag.

  • Manual Integration: These permissions are not added automatically due to a conflict with main AndroidManifest Make sure to insert them manually.

  • Minimum SDK Requirements:

    • QUERY_ALL_PACKAGES and PACKAGE_USAGE_STATS may require your app to target API level 30+.

    • Google Play may require justification for using QUERY_ALL_PACKAGES.

Last updated