Yandex/AiX Setup

Step 1 - Select an Authorization Channel

a. Select either access portal

• Click "Setting" --> "AD Accounts" --> "Add Accounts" .

• Click "Setting" -->"AD Channels" --> "Select the Media".

Step 2 - Account Login

a. Select the channel and click "Sign in".

b. Log in to your account.

Step 3 - Create an app in the developer backend

a. Open the Developer Console.Please access from here.oauth ：yandex.com/client/new/

b. Click Leave Organization.

c. Create App.

d. Confirm permission selection:Direct:api permission, search by manual input. Passport: business permission

e. Click the created App in My Apps.

f. Confirm the permission information and extract the Client ID.

g. Locate Tool - API.

h. Fill in the API request form

i. Enter the Client ID. Enter the Client ID generated by the newly created App.

j. Submit the access application for Direct API.
The review is expected to take 2h to 24h. Contact your agent promptly if the request is not approved after 48h.
A green "approved" status will be displayed upon approval, and you may proceed to obtain the token.
A red "Rejected" status will be shown for failed applications. Revise the form according to the Comments and resubmit for review.

Step 4 - Obtain Token

a. After submitting the application and getting approved, you can obtain the token.
First, log in to the authorized email account XXXXXXX@XXXX.com in your browser as normal.

b. Click the link below to obtain the token: https://oauth.yandex.ru/authorize?response_type=token&client_id=APP_IDENTIFIER
or
https://oauth.yandex.ru/authorize?response_type=code&client_id=APP_IDENTIFIER.

c. Replace APP_IDENTIFIER with your applied application ID.

d. The option "Log in as an employee" pops up.

e. What to do if the prompt "Log in as an employee" fails to pop up?
If the "Log in as an employee" prompt does not appear under any circumstances: go to the Yandex ID page and open the settings of the created app (As shown in the figure below).

First, remove the passport:business permission and save.
Then re-add the passport:business permission and save again.
After completing these operations, retry the authorization link flow; you should be able to obtain the token normally.

f. Get the temporary code from the link.

g. Request this link to exchange for token and refresh token.

h. You have successfully created the API and pulled Campaign data. Values are rounded to 2 decimal places by default. Contact your agent if you need to adjust the decimal precision.

Step 5 - Obtain Counter

a. Open this link：https://metrika.yandex.ru/

b. As shown below.Open Tag Manager in Settings.

c. As shown below.Click the upper right corner.

Step 6 - Account Info providing to AiX

Enter the Token and Counter，Finally, click Save.