Connecting your Unity Ads account

How to locate the credentials required to connect your Unity Ads account to Luna Creative Suite in order to upload creatives

N
Written by Niall Jones
Updated over a week ago

You can upload creatives directly to the ad networks you wish to use them on from within the Creative Library using our Publish function. To start exporting your creatives in this way, you must first create a Connection.

A Connection is a link between Luna Creative Suite and your ad network account that allows you to directly upload creatives and track their status in Creative Library. To create a Connection you will need to enter credentials from your ad network account.

Required credentials to create a Unity Ads connection

Credential Name

Description

Why we need it

Example

Service User Key

Credentials of a service user in your Unity organization that you will need to create with the neccessary permissions

Grants permission to Luna Creative Suite to upload creatives and track their status and performance

2e8cbcb1-1f6e-48a1-ad35-2a5dac4fa345

Service User Secret

See above

See above

5FGejljdR82i3DPl_-TpDjFz5x4TRpIg

Organization Core ID

Your Unity organization's ID

Identify your organisation in Unity Ads so we can upload creatives to your account

8991188753423

Advertising Stats API Token

A token that provides read-only API access to your Advertising statistics for your Unity organisation

To track the status of the creatives you create and upload to Unity Ads as well as calculate the number of installs for optimisation and billing purposes

e551aeg234aecd7ac2b048623e31d21dc1ac464da7d2aff4f11b90b46cba4cc9

Organization ID

Your Unity organization's Advertising API ID, found in Acquire settings

Identify your organisation in Unity Ads so we can track creative status and performance

923dgg85498d3d1c73b9621f

How to obtain your Unity credentials

The credentials listed above can all be found within Unity Dashboard across multiple pages. Most of the credentials required can simply be copied from the appropriate page in Unity Dashboard, the Service User credentials however will require some extra steps.


We reccomend following the steps below in order to most easily obtain the required credentials, make a note of the IDs as you go along.

Organization Core ID

You can find your Organization Core ID by navigating to Unity Dashboard, logging in to your account and looking at the URL in your browser's address bar. You will see a URL similiar to this:

https://dashboard.unity3d.com/gaming/organizations/ORGANIZATION-CORE-ID/projects/abcdefg-1234567-abcdef/overview?viewMode=project

Your Organization's Core ID will be located within the URL in the same position as where you see ORGANIZATION-CORE-ID in our example above. It should be numeric ID.

Make a note of this ID as you will need to use it in the steps below.

Advertising Stats API Token

Navigate to the following URL, being sure to replace ORGANIZATION-CORE-ID with your own ID:

https://dashboard.unity3d.com/gaming/organizations/ORGANIZATION-CORE-ID/acquire/advertiser-api

Copy the value listed as API Key as seen here:

Organization ID

Navigate to the following URL, being sure to replace ORGANIZATION-CORE-ID with your own ID:

https://dashboard.unity3d.com/gaming/organizations/ORGANIZATION-CORE-ID/acquire/settings

Copy your Organization ID as seen here:

Service User Credentials

To obtain these credentials you will first need to create a Service Account in your Unity organisation. Service Accounts can be granted permissions and have a key and secret that are used by Luna Creative Suite to authenticate via API.

Follow these steps to create a service user and copy the required credentials

  1. Navigate to the following URL, being sure to replace ORGANIZATION-CORE-ID with your own ID: https://dashboard.unity3d.com/gaming/organizations/ORGANIZATION-CORE-ID/settings/service-accounts

  2. Click the Create service account button

  3. Name your service account, for example, 'Luna Creative Suite'

  4. Under Organization roles, click Add organization role and check the box for Advertise API Admin

  5. If the Advertise API is not listed, contact your Unity Client Partner or email us at [email protected].

  6. Under Keys, Click Create key.

  7. Copy the two values you see and note them down, once you close the modal displaying the keys you will no longer be able to view the secret key again


You now have all the credentials required to create a Unity Ads Connection.

Creating the Connection

If you haven't already, navigate to your Connections Settings in Luna Creative Suite and click Add or Connect next to Unity Ads to begin the process.

You will see the following form, simply add the credentials you gathered into this form and click Connect:

You will now be redirected back to Connections Settings where you will be asked to name your Connection and save it. If you do not name and save the connection, it will not be created and you will have to start over.

Once saved, you can now publish your creatives to Unity Ads from Creative Library.

Did this answer your question?