Unity Ads
Unity Ads uses service account authentication. You create a service account in the Unity Dashboard, assign it the right role, and generate a key pair. Takes about 2 minutes if you have admin access to your Unity organization.
Required credentials
| Field | Description |
|---|---|
| organizationId | Your Unity organization ID. Found in the Unity Dashboard under Organization settings. |
| serviceAccountKeyId | The key ID of the service account you create in the Unity Dashboard. |
| serviceAccountSecret | The secret value generated when you create the service account key. You only see this once. |
Step 1: Find your organization ID
Log in to dashboard.unity3d.com.
Click on your organization name in the top navigation. Your organization ID appears in the URL: dashboard.unity3d.com/organizations/123456/...
Step 2: Create a service account
In the Unity Dashboard, go to Settings then Service accounts.
Click Add service account. Give it a name (e.g., "adduck") and assign it the Ad Monetization Reporting role at minimum. For campaign management (pause, resume, budget), also assign Ad Monetization Campaign Management.
After creating the service account, click Generate key. Copy the Key ID and Secret Key -- you won't be able to view the secret again.
Step 3: Connect to adduck
Manual config
{
"accounts": {
"unity": {
"organizationId": "123456",
"serviceAccountKeyId": "key-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"serviceAccountSecret": "yyyyyyyyyyyyyyyyyyyyyyyyyyyyyy"
}
}
}Roles and permissions
Unity service account roles are hierarchical. Assign based on what you need:
| Role | Enables |
|---|---|
| Ad Monetization Reporting | spend reports, campaign listings, inspect |
| Ad Monetization Campaign Management | pause, resume, budget changes (includes reporting) |
API endpoint
adduck uses the Unity Advertising Statistics API and Campaign Management API, both hosted at services.api.unity.com. No additional setup required -- the service account credentials authenticate against both.