Locate advertiser credentials

• Game ID
• Secret key and Key ID
• Organization core ID
• Product page credentials

Game ID

1. Go to Apps from the left navigation menu of the dashboard. The provided table lists each of your organization's apps.
2. Scroll or search to locate the desired app.
3. Select Settings () at the end of the app row to open the app details page.
4. Go to the MMP settings section.
5. Select copy () next to Game ID to copy the ID to your clipboard.

Secret key and Key ID

1

Create or open your service account

To generate API keys, you need a service account. To access your service account, follow these steps:

1. Go to Settings > API management.

2. On the API management page, select Service account from either of the API cards. Both cards open the same Service accounts page.

The Organization role you assign to your service account determines which API endpoints it can call. For a description of the APIs and their reference information, refer to the following table:

API	Description	API reference
Advertiser Public API	Manage campaigns, creatives, creative packs, and bids programmatically.	Ads Unified Platform Advertiser API
Stats API v2.0	Retrieve acquisition statistics and integrate an MMP. This API is read-only.	Advertising Statistics API

3. On the Service accounts page, select your account from the table. If you don't have a service account, select + New to create one.

2

Generate keys

To generate a secret key and key ID, follow these steps:

1. From your service account page, go to the Keys section.
2. Select + Add key to generate a Key ID and Secret key. You can't view previously-generated keys.
3. Select the copy buttons following the Key ID and the Secret key to copy both credentials.

Important

The dashboard displays the Secret key only once. Store the Key ID and Secret key together somewhere secure. If you lose the Secret key, you must create a new key.

3

Assign an organization role

A service account with no role assigned can still authenticate, but every request it makes fails with a

403

error and an Invalid Credentials message. You must assign a role to your service account before you use its credentials. Each role grants one permission.

To assign a role, follow these steps from your service account:

1. In the Organization roles section, select + Manage organization roles.
2. Open the User Acquisition category and select the roles you need:

Role	Use case	Details
Advertise Stats API MMP Viewer	MMP integration	Assign this role to the service account you set up for your MMP. You enter that account's Key ID and Secret key in your MMP's dashboard. With this role, your MMP can call the /reports/mmp Stats API endpoint. Important This role is required for MMP integrations.
Advertise Stats API Viewer	Reporting	Assign this role to query your own acquisition data. With this role, you can call the following Stats API endpoints: /reports/acquisitions /reports/skan
Advertise API roles	Advertising management	Assign this role to manage your User Acquisition campaigns and resources. Select each Advertise API role for the resources you want to manage, such as the following: Apps Bids Budgets Campaigns Creative packs Targeting Note Because each role grants one permission, managing multiple resources requires multiple roles. Requests for a resource that your service account has no role for fail with a 403 error, even when requests for other resources succeed.

3. Select Save.

Organization core ID

1. Go to the Settings > Organization page.
2. On the Organization settings page, go to the Organization section.
3. Select copy () next to Organization core ID to copy the ID to your clipboard.

Product page credentials

Product page ID

To copy your PPID from your app's Apple App Store listing, follow these steps:

1. Open your Custom product page in a web browser.
2. Locate the PPID at the end of the URL. The ID is the string of characters following

   ?ppid=

   in the URL.

3. Copy the product page ID. Refer to the following examples to verify you have copied the correct part of the URL:

Correct PPID	Incorrect PPID
12a4f019-tmc3-5t3f-a5ej-edafee17a	1234567=4?ppid=12a4f019-tmc3-5t3f-a5ej-edafee17a

Unique URL parameter

To copy your unique URL parameter from your app's Google Play listing, follow these steps:

1. Open your Custom store listing in a web browser.
2. Locate the Unique URL Parameter at the end of the URL. The parameter is the string of characters following

   &listing=)

   in the URL.

3. Copy the Unique URL Parameter. Refer to the following examples to verify you copy the correct part of the URL:

Correct URL parameter	Incorrect URL parameter
halloween1	id=com.unity.app&listing=halloween1