Attribution

Attribution tells you where your players came from: which ad, campaign, or channel caused each install. You select a provider under Playtolia → Data & Diagnostics in Project Settings. The SDK then resolves attribution at startup. You can read the result from C#, or save it to the account of the player.

Providers

Provider	What it does	Platforms
None	Attribution is off.	Any
System	Reads the Google Play install referrer (UTM parameters with the click and install timestamps). No third-party SDK or token is necessary.	Android
Airbridge	The Airbridge MDP SDK for full attribution and deferred deep links. An app name and a token are necessary.	Android, iOS

The System provider has no iOS equivalent, so GetInstallReferrer() returns null on iOS. The Airbridge provider gives cross-platform attribution.

Enable attribution

Go to Edit → Project Settings → Playtolia → Data & Diagnostics. Open the Attribution section. Then select a provider. The changes take effect with the next build. When you select a provider, the SDK shows its settings:

Store as Account Attribute (all providers): read the section below.
Airbridge App Name / App Token / Sandbox (Airbridge only): your Airbridge credentials.

Reading attribution in Unity

using PlaytoliaSDK.Runtime;
using Playtolia.Entity.Attribution;

// Google Play install referrer (Android, System provider)
InstallReferrerInfo referrer = PlaytoliaAttribution.GetInstallReferrer();
if (referrer != null)
{
    Debug.Log(referrer.ReferrerUrl); // "utm_source=google-play&utm_medium=organic&..."
}

// Parsed campaign data (works for any provider)
AttributionData data = PlaytoliaAttribution.GetAttributionData();
if (data != null)
{
    Debug.Log($"{data.Source} / {data.Medium} / {data.Campaign}");
}

Both methods return null if attribution is not resolved, or if the provider does not apply to the current platform. InstallReferrerInfo

Field	Description
`ReferrerUrl`	The raw referrer query string, for example `utm_source=google-play&utm_medium=organic`
`ReferrerClickTimestampSeconds`	The time when the player clicked the referrer link (epoch seconds)
`InstallBeginTimestampSeconds`	The time when the install started (epoch seconds)
`GooglePlayInstant`	Shows if the player came through Google Play Instant

AttributionData

Field	Parsed from
`Source`	`utm_source`
`Medium`	`utm_medium`
`Campaign`	`utm_campaign`
`Term`	`utm_term`
`Content`	`utm_content`

Store as account attribute

If Store as Account Attribute is on (the default), the SDK saves the resolved attribution to the account of the player. It uses the install_referrer key, at the first sign-in of that player. The SDK writes this value one time for each player. Thus later logins do not overwrite the acquisition source. Attribution is then available on the server for segmentation and reporting, even if you never read it in the game.

The SDK can save the attribute only after the player authenticates. If attribution resolves before sign-in, the SDK stores it automatically at the next login.

Using Airbridge

To use the Airbridge provider:

Add the Airbridge SDK to your project (Android: io.airbridge:sdk-android, iOS: the Airbridge pod).
Select Airbridge under Playtolia → Data & Diagnostics. Then enter your App Name and App Token.
Enable Sandbox only during tests.

CAUTION: Make sure that the App Name and the App Token are not empty before you ship. If a field is empty, the SDK skips attribution at runtime.

Promotions

Review prompts and engagement

Push Notifications

Cross-platform notifications

Get Started

Features

Billing

Advanced

Providers

Enable attribution

Reading attribution in Unity

Store as account attribute

Using Airbridge

Promotions

Push Notifications

​Providers

​Enable attribution

​Reading attribution in Unity

​Store as account attribute

​Using Airbridge

Promotions

Push Notifications

Providers

Enable attribution

Reading attribution in Unity

Store as account attribute

Using Airbridge