Ad register reports
How do I know if I need to submit ad register data?
Specify your role in the advertising chain and answer token-related questions to find out if you need to submit an invoice and where to send the data.
How do I submit a report if I'm...
Did you get the token yourself?
How did you get the token?
Send the data to the Yandex Advertising Data Operator (ADO) via the API. To learn more, see the documentation for the Yandex Advertising Data Operator.
Submit a report in the Adfox interface. For instructions, see Submitting a report in the Adfox interface.
Send the data to the advertising data operator you received the token from. Learn more in the advertising data operator's documentation.
You don't need to submit any data — your contractor will handle that.
Did you get the token yourself?
How did you get the token?
Send the data to the Yandex Advertising Data Operator (ADO) via the API. To learn more, see the documentation for the Yandex Advertising Data Operator.
Submit a report in the Adfox interface. For instructions, see Submitting a report in the Adfox interface.
Send the data to the advertising data operator you received the token from. Learn more in the advertising data operator's documentation.
Send the data to any advertising data operator or to your Yandex ADO account (if you have the details of the primary contract).
You don't need to submit any data — your contractor will handle that. You're only required to submit your revenue invoice.
Did you get the token yourself?
How did you get the token?
Send the data to the Yandex Advertising Data Operator (ADO) via the API. To learn more, see the documentation for the Yandex Advertising Data Operator.
Submit a report in the Adfox interface. For instructions, see Submitting a report in the Adfox interface.
Send the data to the advertising data operator you received the token from. Learn more in the advertising data operator's documentation.
Send the data to any advertising data operator or to the Yandex Advertising Data operator dashboard (if the primary contract details are available).
Send the data after Adfox generates a Self-promotion invoice. To do so, open the invoice and click Submit.
Rules for submitting ad register reports
-
Data must be submitted within 30 days of the last day of the reporting month.
-
The advertising creatives that you report on must be registered with the Yandex Advertising Data Operator via the Adfox interface.
-
All advertising chain participants are required to submit reports on their revenue invoices:
-
Each invoice should be submitted once by only one of the advertising chain participants.
-
One chain participant can delegate the responsibility to submit invoices to another participant. In that case, the legal liability to submit the data remains with the participant who issued the invoice.
Note
The advertiser may delegate both the responsibility and legal liability to submit invoices to their contractor. This must be stipulated in the contract between the advertiser and the contractor.
-
-
Ad impression reports should be submitted once by the chain participant that registered the advertising creative content and received a token from the advertising data operator. That participant should submit an invoice and statistics to the advertising data operator from which they've received the token.
Submitting invoices via the Adfox interface
Alert
Be sure to submit your ad placement reports to ERIR on time. According to the Federal Law “On Advertising”, all participants in the advertising chain must report on ad placement no later than the 30th day of the month following the month of ad launch on their placements. If you haven't received the paper invoice yet but the ERIR reporting deadline is approaching, submit the statistics without the invoice. Learn more in the Statistics without invoice section.
Step 1. Make sure that the data at all levels is correct
Site
-
Make sure to enable Transfer the site to the ERIR in the parameters of the website where the ad is placed, and fill out the labeling data section:
-
Placement type: Site, app, or information system.
-
Name: Name of the site to be added to the ad register.
-
Site URL: Site or video resource domain, blog URL, or URL for downloading an app that starts with
http://
orhttps://
.If the site is hosted on a third-party platform, please provide its exact URL. For example, the URL of a Telegram channel or blog on Zen.
-
Contractor: Contractor (domain, video resource, blog, or app owner) that you added in the Marking tab earlier.
If the contractor isn't the sole owner of the resource (for example, an aggregator site), leave the field empty.
-
-
Make sure you correctly defined the site structure. To learn more, see Add the site structure.
Contract with the advertiser (direct and primary contracts: for advertising chains with and without intermediaries)
Specify the type of your contract with the end advertiser if you haven't before:
-
Go to the list of contracts: Marking → Contracts, then open the contract with the advertiser (the primary contract).
-
In the Сontract price field, select one of the options:
-
A paid contract: The contractor is paid the amount specified in the contract. In the The amount of the contract field, specify exactly how much the contractor is to be paid.
-
Gratuitous contract: The contractor doesn't receive payment under the contract. The amount of the contract field will be hidden, and the value The amount of the contract = 0 will be passed to the ERIR. At the same time, the cost of services may be specified in the invoices.
-
There is no price in the contract: The contractor gets paid, but the amount isn't specified in the contract. The The amount of the contract field is hidden and not submitted to ERIR. Specify the cost of services under this contract in the invoice.
For the Intermediary contract type, be sure to specify the exact amount to be paid.
-
-
In the Contract role field, select one of the options:
-
Select Agreement between the Publisher and the Advertiser if the advertiser and the publisher have a direct agreement without intermediaries.
-
Select Agreement between the Advertiser and the Performer if the advertiser has a contract with an agency (performer) that ordered placement from a publisher.
-
-
Save changes.
If Adfox reports an error while saving
-
In the Campaigns or the Campaigns (NEW) tab, select the campaigns created under this contract.
-
Temporarily unlink your contract from all campaigns using one of the following methods:
- In the Marking procedure field, select Do not submit data to state register in the campaign parameters.
- Change the contract specified in the Agreement between the Advertiser and the Performer field to any other contract (for example, a self-promotion contract).
-
Save changes.
-
Change the contract type in the tab Marking → Contracts.
-
Make sure to reselect the right contract in the campaign parameters.
Contract with the publisher (final contract: for advertising chains that involve intermediaries)
If your advertising chain involves intermediaries, you need to fill in the details of the contract between the publisher and the intermediary (final contract):
- Go to Marking → Contracts.
- Click Create in the upper-right corner of the screen.
- Enter the details of the contract with the publisher (domain, video resource, blog, or app owner).
-
In the Сontract price field, select one of the options:
-
A paid contract: The contractor is paid the amount specified in the contract. In the The amount of the contract field, specify exactly how much the contractor is to be paid.
-
Gratuitous contract: The contractor doesn't receive payment under the contract. The amount of the contract field will be hidden, and the value The amount of the contract = 0 will be passed to the ERIR. At the same time, the cost of services may be specified in the invoices.
-
There is no price in the contract: The contractor gets paid, but the amount isn't specified in the contract. The The amount of the contract field is hidden and not submitted to ERIR. Specify the cost of services under this contract in the invoice.
For the Intermediary contract type, be sure to specify the exact amount to be paid.
-
- In the Contract role field, select Agreement between the Publisher and the Customer (Intermediary).
- Click Create. Once the changes are saved, the contract is assigned an ID in the Yandex ADO.
Warning
Make sure to specify this contract in the Agreement between the Publisher and the Customer (Intermediary) field for all relevant campaigns.
Ad campaigns
Make sure the contract details in your campaign parameters are correct:
-
If the campaign was created under a direct agreement between the advertiser and the platform (without intermediaries), specify the [Direct] contract in the Agreement between the Advertiser and the Performer field.
-
If your advertising chain involves intermediaries, fill in the following two fields:
- In Agreement between the Advertiser and the Performer, the [Primary] contract is specified.
- In Agreement between the Publisher and the Customer (Intermediary), the [Final] contract is specified.
If you need to change a contract or sign an additional agreement in an active advertising campaign for a new reporting period, create a new campaign. Linking a new contract to the current campaign changes the contract information for the whole period.
Tip
Under Marking → List of tagged campaigns, you can find an Excel file that combines data on all labeled campaigns.
The campaign is exported if:
- The campaign was created before the invoice end date.
- The campaign end date isn't earlier than the invoice start date.
The campaign will appear in the file even if you haven't actually run its ads.
Banners
Make sure that all banner parameter fields are filled in under Advertising labeling.
- Marking procedure: If the creative is to be added to the ad register, select Submit data to state register.
- General description of the advertised object: General description of the advertised products or services.
- Ad distribution type: Format of the creative (such as banner or video ad).
- Target URL: Link to the advertiser's website.
To learn more, see Registering ad creatives in Adfox.
Step 2. Add the invoice details for the final contract
-
Go to Marking → Invoices.
-
Click Create an act in the top right corner.
-
In the window that opens, select Statistics with invoice.
-
Select the Type of act:
-
The act of completed works — if the end contract's type is a Contract or the Additional agreement to a service contract.
-
Intermediary's Report — if the end contract's type is a Intermediary contract or the Additional agreement to an intermediary contract.
-
-
Enter the invoice data under the final contract depending on the invoice type:
- Act: Invoice name or number.
- Date of the act: Date when the invoice was issued.
- Reporting period: Start and end dates for the reporting period. This period shouldn't exceed 92 days.
-
Final agreement: Contract under which the invoice was issued.
Note
You can't create an invoice without the final contract. If you can't find the contract you're looking for in the drop-down list, check that Contract role you selected is accurate (see Step 1).
-
The role of the customer and The role of the performer: Select roles. The customer can have one of the following roles:
- Advertising agency
- Advertising distributor
- Advertising system Operator
- Advertiser
- Broker
Note
If you have a direct or intermediary contract in which an advertising agency represents an advertiser, the customer can't have the advertising distributor role.
How to choose the right roles:
When the contract party is an advertiser or advertising agency
Choose the performer's role based on the customer's role:
Customer role
Possible performer roles
Advertiser
- Advertising agency
- Advertising distributor
- Advertising system operator
Advertising agency
- Advertising agency
- Advertising distributor
- Advertising system operator
Advertising system operator
- Advertising distributor
- Advertising system operator
When the agent acts on behalf of the advertiser
Select Advertising distributor for the customer, and Advertising agency for the performer.
For self-promotion contracts
Select Advertiser for the customer, and Advertising distributor for the performer.
-
The amount of the act:
-
The amount without VAT and The amount including VAT: Specify the invoice amount in rubles manually.
-
VAT rate, % and The amount of VAT: Field values are calculated automatically. To edit the data, click the field you need and enter a new value.
-
-
Report and Date of the report: Date and number of the intermediary's report.
-
Act and Date of the act: Date and number of the Invoice if your set of documents includes Intermediary's report and Invoice.
The intermediary's report will include the data for both the report and the invoice.
-
Reporting period: Start and end dates for the reporting period. It can be no longer than 92 days.
-
Final agreement: Contract under which the invoice was issued.
Note
You can't create an invoice without the final contract. If you can't find the contract you're looking for in the drop-down list, check that Contract role you selected is accurate (see Step 1).
-
The role of the customer and The role of the performer: Select roles. The customer can have one of the following roles:
- Advertising agency
- Advertising distributor
- Advertising system Operator
- Advertiser
- Broker
Note
If you have a direct or intermediary contract in which an advertising agency represents an advertiser, the customer can't have the advertising distributor role.
How to choose the right roles:
When the contract party is an advertiser or advertising agency
Choose the performer's role based on the customer's role:
Customer role
Possible performer roles
Advertiser
- Advertising agency
- Advertising distributor
- Advertising system operator
Advertising agency
- Advertising agency
- Advertising distributor
- Advertising system operator
Advertising system operator
- Advertising distributor
- Advertising system operator
When the agent acts on behalf of the advertiser
Select Advertising distributor for the customer, and Advertising agency for the performer.
For self-promotion contracts
Select Advertiser for the customer, and Advertising distributor for the performer.
-
The amount of the act:
-
The amount without VAT and The amount including VAT: Specify the invoice amount in rubles manually.
-
VAT rate, % and The amount of VAT: Field values are calculated automatically. To edit the data, click the field you need and enter a new value.
-
-
The amount of the intermediary’s remuneration:
-
The amount without VAT and The amount including VAT: Manually specify the intermediary's revenue amount in rubles.
-
VAT rate, % and The amount of VAT: Field values are calculated automatically. To edit the data, click the field you need and enter a new value.
-
Note
Amounts for the Intermediary's Report invoice type indicate the intermediary's revenue.
-
Click Create an act. You'll see a window with the invoice details and a list of all campaigns linked to the final contract.
-
Go to Marking → Invoices.
-
Click Create an act in the top right corner.
-
In the window that opens, select Statistics without invoice.
-
Select the Type of act:
-
The act of completed works — if the end contract's type is a Contract or the Additional agreement to a service contract.
-
Intermediary's Report — if the end contract's type is a Intermediary contract or the Additional agreement to an intermediary contract.
-
-
Enter the invoice data under the final contract depending on the invoice type:
- Act: Invoice name or number.
- Date of the act: Date when the invoice was issued.
- Reporting period: Start and end dates for the reporting period. This period shouldn't exceed 92 days.
-
Final agreement: Contract under which the invoice was issued.
Note
You can't create an invoice without the final contract. If you can't find the contract you're looking for in the drop-down list, check that Contract role you selected is accurate (see Step 1).
-
The role of the customer and The role of the performer: Select roles. The customer can have one of the following roles:
- Advertising agency
- Advertising distributor
- Advertising system Operator
- Advertiser
- Broker
Note
If you have a direct or intermediary contract in which an advertising agency represents an advertiser, the customer can't have the advertising distributor role.
How to choose the right roles:
When the contract party is an advertiser or advertising agency
Choose the performer's role based on the customer's role:
Customer role
Possible performer roles
Advertiser
- Advertising agency
- Advertising distributor
- Advertising system operator
Advertising agency
- Advertising agency
- Advertising distributor
- Advertising system operator
Advertising system operator
- Advertising distributor
- Advertising system operator
When the agent acts on behalf of the advertiser
Select Advertising distributor for the customer, and Advertising agency for the performer.
For self-promotion contracts
Select Advertiser for the customer, and Advertising distributor for the performer.
-
The amount of the act:
-
The amount without VAT and The amount including VAT: Specify the invoice amount in rubles manually.
-
VAT rate, % and The amount of VAT: Field values are calculated automatically. To edit the data, click the field you need and enter a new value.
-
-
Report and Date of the report: Date and number of the intermediary's report.
-
Act and Date of the act: Date and number of the Invoice if your set of documents includes Intermediary's report and Invoice.
The intermediary's report will include the data for both the report and the invoice.
-
Reporting period: Start and end dates for the reporting period. It can be no longer than 92 days.
-
Final agreement: Contract under which the invoice was issued.
Note
You can't create an invoice without the final contract. If you can't find the contract you're looking for in the drop-down list, check that Contract role you selected is accurate (see Step 1).
-
The role of the customer and The role of the performer: Select roles. The customer can have one of the following roles:
- Advertising agency
- Advertising distributor
- Advertising system Operator
- Advertiser
- Broker
Note
If you have a direct or intermediary contract in which an advertising agency represents an advertiser, the customer can't have the advertising distributor role.
How to choose the right roles:
When the contract party is an advertiser or advertising agency
Choose the performer's role based on the customer's role:
Customer role
Possible performer roles
Advertiser
- Advertising agency
- Advertising distributor
- Advertising system operator
Advertising agency
- Advertising agency
- Advertising distributor
- Advertising system operator
Advertising system operator
- Advertising distributor
- Advertising system operator
When the agent acts on behalf of the advertiser
Select Advertising distributor for the customer, and Advertising agency for the performer.
For self-promotion contracts
Select Advertiser for the customer, and Advertising distributor for the performer.
-
The amount of the act:
-
The amount without VAT and The amount including VAT: Specify the invoice amount in rubles manually.
-
VAT rate, % and The amount of VAT: Field values are calculated automatically. To edit the data, click the field you need and enter a new value.
-
-
Click Create an act. You'll see a window with the invoice details and a list of all campaigns linked to the final contract.
Step 3. Add the breakdowns of contract amounts (for direct or primary contracts)
In this case, the breakdown operation refers to breaking down the invoice amount by original contracts with customers for the campaigns listed in the invoice.
Warning
Such breakdowns must be added for all the primary contracts in the campaigns specified in the invoice. You won't be able to submit an invoice if there's a missing contract in your breakdown or it contains an inapplicable contract.
-
Open an invoice and click Add Location in the invoice editing form.
-
In the Agreement/Addendum field, select the contract to add a breakdown for.
-
Fill in the fields:
-
The amount without VAT and The amount including VAT: Specify the invoice amount in rubles manually.
-
VAT rate, % and The amount of VAT: Field values are calculated automatically. To edit the data, click the field you need and enter a new value.
-
-
Save changes.
Step 4. Divide the invoice amount and the number of impressions across your campaigns and submit the data to the Yandex Advertising Data Operator
-
In the list, select the campaigns that are included in the invoice. An ad campaign should only refer to one invoice: you can't add one campaign to multiple invoices.
-
Make sure that the invoice amount is correctly divided between the selected campaigns. By default, the amount is divided evenly. If the campaign amounts vary in the original invoice, change the value in the Amount column to the correct one for each campaign.
The total amount for all selected campaigns appears in the Amount by campaigns field at the top of the invoice. Th total can be the same or lower (if the original invoice includes services that don't need to be labeled) than the invoice amount. The amount by campaigns can't exceed the invoice amount.
-
The actual number of impressions in the Adfox Impressions field is determined automatically based on Adfox statistics. It's also submitted to the state register.
Alert
For each campaign, be sure to specify the number of planned impressions from the invoice in the Impressions by act field. Don't leave the field empty.
-
Click Save.
-
To send the data to the Yandex ADO, click Send the act to the ORD.
Step 5. Make sure to regularly check the data for errors
-
Once the contract and contractor are created and settings for the ad register are enabled, the Yandex ADO sends all the data about these objects for verification to the state register. The objects that couldn't be validated will appear on the Errors tab.
We recommend fixing the errors in the following order before you submit reports: contractor → contract → campaign → banner → act.
Contact support
A contract between the advertiser and their contractor (the first contract in the placement chain).