Ads and mailings
Ad accounts and mailing services are connected under Integrations, the Services tab. The general rules (card statuses, the Changes line, a second account, disconnecting) are on the Connecting services page. Bids, budgets and mailings spend money and reach people, so what the agent does on its own and what it sends as a card for approval is described in Approving actions. Catalog: Ads.
Marketplace advertising: Ozon Ads is described on the Marketplaces and Avito page, Avito Ads below.
Yandex Direct
Search ads: campaigns, ads, keywords, bids and analytics. Scenarios are on the integration page.
What the agent can do
Read campaigns, ads and statistics, change bids and ads if the login has edit rights.
Before you start
A login registered in Direct: a business representative, an agency or an agency's client. The agreement terms accepted on the API settings page.
Steps
Pick the login
Sign in as the advertiser's login that holds the campaigns, and sign out of extra Yandex accounts in the browser.
Accept the API terms
On Direct's API settings page accept the agreement terms. On the parameters tab the list of allowed IP addresses must be empty.
Confirm the code
Click Connect, then Copy the code and open, and enter the code with this login. Advertiser login is filled in when the campaigns belong to an agency's client.
Permissions to grant
Rights from the web interface carry over to the API one to one. With read-only access the agent only gets data; edit rights are granted by the agency.
Limitations
Under an agency login, client campaigns are not pulled.
How to revoke access
Click Disconnect on the connection card and revoke the app's access in the Yandex account.
Troubleshooting
- No campaigns: signed in with an agency login, or the agreement is not accepted on the API settings page.
- Refused by IP: the list of allowed IP addresses on the parameters tab is filled in.
VK Ads
Campaigns, ads, targeting, audiences and statistics. Scenarios are on the integration page.
What the agent can do
Read campaigns, ads, audiences and statistics and change them within the access.
Steps
Open API access
In the ads.vk.ru account find API access in the settings and fill in the details of the employee the access is issued to.
Copy the client_id
It is shown in the same section. Paste it into Client ID.
Generate the client_secret
The secret is shown by a button for a short time and is not issued again. Paste it into Client Secret right away.
Limitations
The old VKontakte ad account is a different system: its key does not fit.
How to revoke access
Click Disconnect on the card and revoke access in the API access section of the ads.vk.ru account.
Troubleshooting
- The secret is lost: generate a new one and click Re-enter credentials.
Avito Ads
The Avito advertising account: campaigns, groups, creatives, statistics and balances. It is connected with its own tile and its own keys, separately from Avito listings and messages. About Avito: the integration page and Marketplaces and Avito.
What the agent can do
Read the advertising account's campaigns, groups, creatives, statistics and balance.
Steps
Sign in at ads.avito.ru
As the user who manages the advertising account you need.
Create keys
In the advertising account settings open the API access section and create keys.
Carry three values
Fill in Advertising account Client ID, Client Secret and Advertising account ID (the account's numeric ID).
Limitations
Avito listing keys do not fit here, and the other way round.
How to revoke access
Click Disconnect on the card and delete the keys in the advertising account's API access section.
Troubleshooting
- No campaigns: check the advertising account's numeric ID.
1ORD (Beeline)
The ad data registry: creatives, contracts, platforms, participants, acts and reporting. Scenarios are on the integration page.
What the agent can do
Register creatives, contracts and platforms and prepare reporting in the ORD.
Before you start
An activated organization account at ord.beeline.ru with the offer accepted.
Steps
Register the organization
At ord.beeline.ru open registration and send the request. The login and password arrive by email after activation.
Accept the offer
It is accepted at first sign-in by the organization's admin.
Add an API user
In the users section add a user with the API user role. If there is no such role, write to support@1ord.ru.
Paste the sign-in
Sign in with the new pair at ord.beeline.ru and paste it into Username and Password. The login from the email may differ from the email address.
Permissions to grant
The API user role.
How to revoke access
Click Disconnect on the card and delete the API user in the users section of the 1ORD account.
Troubleshooting
- Sign-in fails: the login differs from the email; use the login from the email or password recovery.
Unisender
Email and SMS mailings: contact lists, templates, campaigns and statistics. Scenarios are on the integration page.
What the agent can do
Manage contact lists and templates, prepare campaigns and read statistics.
Steps
Open settings
At app.unisender.com click your email at the bottom left and pick settings.
Enable API access
On the integration and API tab turn API access on.
Copy the key
Click show in full, confirm the password and paste the whole key into API Key. The sign-in email can go into Unisender Login to tell several accounts apart.
How to revoke access
Click Disconnect on the card and turn API access off on the integration and API tab.
Troubleshooting
- The key is not accepted: a truncated key was copied. Click show in full and copy the whole line.
Sendsay
Email marketing: campaigns, subscribers, segments, templates, triggers and A/B tests. Scenarios are on the integration page.
What the agent can do
Manage subscribers and segments, prepare campaigns and automations.
Before you start
A sublogin: the account owner is not issued an API key.
Steps
Add a sublogin
In the account menu open system settings, users, add a user.
Give it the Manager role
Do not turn on two-factor authentication for this sublogin.
Create an API key
In the user's card open user settings, API key, generate key. The key is shown once; paste it into API Key.
Enter the account name
Into Account name put the main login from the account menu, not the sublogin's login.
Permissions to grant
The Manager role: subscribers, campaigns and automations.
Limitations
With two-factor authentication on, requests by key do not go through.
How to revoke access
Click Disconnect on the card and delete the sublogin or its key in Sendsay's users section.
Troubleshooting
- The key does not work: two-factor authentication is on for the sublogin, or the sublogin's login is in Account name.
SMS Aero
SMS, WhatsApp, Viber and Telegram codes, contacts, statuses and balance. Scenarios are on the integration page.
What the agent can do
Send messages, manage contacts, check delivery statuses and the balance.
Steps
Sign in to the account
At smsaero.ru/cabinet as the company account. Put its email into Email.
Copy the key
In the account settings open the API section (smsaero.ru/cabinet/settings/apikey) and paste the key into API Key.
Optionally a sender name
Add a sender name in the account and wait for moderation, then enter it into Sender Name.
Limitations
SMS Aero works on prepayment: with insufficient funds a message is not sent. An unapproved sender name is refused.
How to revoke access
Click Disconnect on the card and change the key in the API section of the SMS Aero account.
Troubleshooting
- Payment error: top up the balance in the account.
- Sender name refused: wait for moderation or leave the field empty.
Frequently asked questions
Why does the agent not see campaigns in Yandex Direct?
Under an agency login, client campaigns are not pulled. Connect under the advertiser's login that holds the campaigns, and check that the agreement terms are accepted on the API settings page.
Does a key from the old VKontakte ad account work for VK Ads?
No. VK Ads at ads.vk.ru is a new account with its own API, and a key from the old VKontakte ad account does not fit. Grant access in the API access section at ads.vk.ru.
Is Ozon advertising connected here?
Ozon Ads is connected with its own tile and its own keys; the steps are on the Marketplaces and Avito page.
Why does Sendsay not give an API key to the account owner?
The owner gets no key. Create a sublogin with the Manager role and without two-factor authentication, and generate the key for it.
See also
Didn't find an answer? How to reach us