Skip to main content

Installation

This guide matches AdScope Unity SDK v1.0.0 (beta). Released builds are distributed as a binary Unity package (.tgz): compiled assemblies, no .cs sources in the package.

Download the release​

The current release is hosted on this documentation site:

Download com.adscope.sdk-1.0.0.tgz (binary UPM package)

The same file is available at:

https://docs.ad-scope.com/unity-sdk/com.adscope.sdk-1.0.0.tgz

Requirements​

Unity​

Use Unity 2021.3 LTS or newer unless your AdScope release notes specify otherwise.

Unity modules​

The SDK loads configuration over HTTP. Add this dependency in Packages/manifest.json if it is not already present:

"com.unity.modules.unitywebrequest": "1.0.0"

Other software​

KindNotes
Mediation / ad SDKWhatever stack you use for revenue and fill callbacks (e.g. AppLovin MAX).

Follow AdScope’s onboarding for credentials, configuration delivery, and any required companion services.

Add the package to your project​

Option A — Install from URL (recommended)​

Point Unity Package Manager at the tarball on this site:

{
  "dependencies": {
    "com.adscope.sdk": "https://docs.ad-scope.com/unity-sdk/com.adscope.sdk-1.0.0.tgz",
    "com.unity.modules.unitywebrequest": "1.0.0"
  }
}

Return to the Editor; Package Manager will fetch and import the package. You should see AdScope SDK under Packages.

If URL install is not supported on your Unity version, use Option B.

Option B — Download, then file:​

  1. Download com.adscope.sdk-1.0.0.tgz.
  2. Place it on disk (e.g. vendor/com.adscope.sdk-1.0.0.tgz next to your game project).
  3. Add to Packages/manifest.json. Paths are relative to Packages/manifest.json:
{
  "dependencies": {
    "com.adscope.sdk": "file:../../vendor/com.adscope.sdk-1.0.0.tgz",
    "com.unity.modules.unitywebrequest": "1.0.0"
  }
}

Alternative (UI): Window → Package Manager → + → Install package from tarball… and select the downloaded file.

What you are installing​

The release tarball is a binary package: AdScope.Runtime.dll and AdScope.Editor.dll plus package metadata (no .cs sources in the package).

Use the API in your scripts​

After import:

using AdScope;

Scripts in the default Assembly-CSharp assembly can call AdScopeAPI without extra setup.

Custom assembly definitions​

If your game code lives in a .asmdef assembly, add a reference to AdScope.Runtime (the runtime assembly from the package) in that asmdef’s Assembly Definition References, same as any third-party plugin.

Verify​

  1. Package Manager lists com.adscope.sdk without errors.
  2. A script with using AdScope; compiles.
  3. Follow Integration to configure credentials, fetch configuration, and read a key-value after reporting test revenue.

Next steps​