1. Create Service Account

1. Log in to Google Cloud Console
2. From the left-hand menu, click on “IAM & Admin”.
3. Select your organization from the dropdown.
4. From the left-hand menu, click on Service Accounts.
5. Click the Create Service Account button.
6. Name the service account Metriqus – [GameName] Integration, then click “Create and Continue”.
7. Add these roles:
   • Project > Viewer
   • Cloud Storage > Storage Object Viewer
8. Copy the generated service account email address.

2. Authorize Service Account

1. Log in to your Google Play Console account where your game is published.
2. In the left-hand menu of the Google Play Console, go to "Users and Permissions"
3. Click the “Invite New User” button at the top right of the Users and Permissions page.
4. Paste the copied service account email into the Email address field.
5. Under Permissions tab, grant access to:
   • Account access → View app information and download bulk reports (read-only)
   • Financial data → View financial data, orders, and cancellation survey responses
   • Financial data → Manage orders and subscriptions
6. Click Invite User

3. Download Private Key

1. Go to Google Cloud Console
2. Navigate to “IAM & Admin” section.
3. Choose your organization and find the created service account
4. Click the service account you created at the previous step.
5. Open the KEYS tab
6. Click Add Key > Create New Key
7. Select "JSON" and click "Create".
8. Upload the downloaded JSON key file to the relevant upload modal in the Metriqus dashboard.

4. Get Package Name

1. Go to Google Play Console
2. Choose Home from the menu
3. Select your app and copy the package name under the title (e.g. com.gamename.app)

5. Get Cloud Storage URI

1. Go to Google Play Console
2. In the Google Play Console, go to "Download Reports" then select the "Statistics" tab.
3. Select the relevant app if prompted
4. Click "Copy Cloud Storage URI" next to the Downloads row under the Statistics tab.

1. Select Your App

From the “Apps” tab in the Metriqus platform, select the app you want to integrate with a channel/platform, then click the relevant section for AdMob integration.

2. Choose AdMob Account

Select the account you want to integrate.

3. Grant Permissions

Click the “Select all” button to grant the necessary permissions, then click “Continue”.

4. Submit Publisher Account

On the screen that appears, select the relevant Publisher account and click the “Submit” button.

5. Finish

Congratulations, you have successfully completed the AdMob integration! You can click “Go to Apps” button.

1. Retrieve Report Key

1. Log in to your AppLovin account at https://dash.applovin.com/login
2. In the AppLovin dashboard, go to the "Account" section from the top menu.
3. Navigate to the "Keys" section under "Account" to access your "Report Key"
4. Copy the "Report Key"

1. Select Your App

From the “Apps” tab in the Metriqus platform, select the app you want to integrate with a channel/platform, then click the relevant section for Google Ads integration.

2. Choose Google Ads Account

Select the account you want to integrate.

3. Continue

Click the “Continue” button.

4. Select Customer

Please select customer.

5. Finish

Congratulations, you have successfully completed the Google Ads integration! You can click “Go to Apps” button.

1. Select Your App

From the “Apps” tab in the Metriqus platform, select the app you want to integrate with a channel/platform, then click the relevant section for TikTok Ads integration.

2. Confirm Integration

On the screen that appears, click the “Confirm” button.

3. Choose TikTok Ads Account

Select the relevant account.

4. Finish

Congratulations, you have successfully completed the TikTok Ads integration! You can click “Go to Apps” button.

1. Select Your App

From the “Apps” tab in the Metriqus platform, select the app you want to integrate with a channel/platform, then click the relevant section for Meta Ads integration.

2. Choose Meta Ads Account

Select the account you want to integrate.

3. Finish

Congratulations, you have successfully completed the Meta Ads integration! You can click “Go to Apps” button.

1. Compatibility

• iOS 12 or later
• Android API level 21 (Lollipop) or later
• Unity Editor 2019 or later

2. Installation

Option 1: Unity Package

1. Download the SDK from GitHub releases.
2. In Unity Editor: Assets → Import Package → Custom Package.
3. Select and import the downloaded SDK.

Option 2: Unity Package Manager

1. Open Unity Package Manager
2. Select "Add package from git URL"
3. Use: https://github.com/Metriqus-SDK/unity_sdk.git
4. Import examples from: Window → Package Manager → Metriqus Unity SDK → Samples

3. Integration Setup

1. Add the Metriqus.prefab to your first scene from: Assets/Samples/Metriqus Unity SDK/{version}/Samples/Prefabs/Metriqus.prefab
2. Open the prefab in Inspector to configure settings
3. Set the following:
   • Client Key: from your Metriqus dashboard
   • Client Secret: from your Metriqus dashboard
   • Environment: Sandbox (test) or Production (live)
   • Log Level: optional debugging logs
4. To initialize manually, use:

   Metriqus.InitSdk(metriqusSettings);

4. Tracking API

Event Tracking Functions

• TrackIAPEvent(MetriqusInAppRevenue metriqusEvent)
  Tracks in-app purchase (IAP) events.
• TrackCustomEvent(MetriqusCustomEvent _event)
  Tracks custom events with user-defined parameters.
• TrackPerformance(int fps, List<TypedParameter> parameters = null)
  Tracks FPS and other performance-related metrics.
• TrackItemUsed(MetriqusItemUsedEvent _event)
  Tracks when an item (currency, equipment, etc.) is used.
• TrackLevelStarted(MetriqusLevelStartedEvent _event)
  Tracks when a level starts.
• TrackLevelCompleted(MetriqusLevelCompletedEvent _event)
  Tracks when a level is completed.
• TrackCampaignAction(MetriqusCampaignActionEvent _event)
  Tracks campaign-related actions such as "Showed", "Clicked", "Closed", or "Purchased".
• TrackScreenView(string screenName, List<TypedParameter> parameters = null)
  Tracks when a user views a specific screen in the app.
• TrackButtonClick(string buttonName, List<TypedParameter> parameters = null)
  Tracks button click events.

Ad Revenue Tracking Functions

• TrackApplovinAdRevenue(MetriqusApplovinAdRevenue matriqusAdRevenue)
  Tracks ad revenue from Applovin.
• TrackAdmobAdRevenue(MetriqusAdmobAdRevenue matriqusAdRevenue)
  Tracks ad revenue from AdMob.
• TrackAdRevenue(MetriqusAdRevenue matriqusAdRevenue)
  Tracks general ad revenue.

User Attribute Functions

• SetUserAttribute(TypedParameter parameter)
  Sets a user attribute.
• GetUserAttributes()
  Retrieves all user attributes.
• RemoveUserAttribute(string key)
  Removes a specific user attribute by key.

Device and Geolocation Functions

• GetAdid()
  Retrieves the Advertising ID (AdID) of the user.
• GetMetriqusSettings()
  Retrieves the Metriqus SDK settings.
• GetGeolocation()
  Retrieves geolocation data.
• GetDeviceInfo()
  Retrieves device information.
• GetUniqueUserId()
  Retrieves the unique user identifier.

SDK State and Tracking Control

• IsInitialized()
  Checks whether the Metriqus SDK is initialized.
• IsTrackingEnabled()
  Checks whether tracking is enabled.

5. Notes

• The Metriqus SDK is designed exclusively for Unity projects targeting Android and iOS platforms.
• Calling outside those platforms will result in an error log
• Make sure to initialize the SDK before calling any tracking or analytics functions. Initialization ensures that all events are properly attributed and transmitted.