Ad register reports

How do I know if I need to submit ad register data?

advertising-chain-svg

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 on how to do this, see Submitting invoices 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 counterparty 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 on how to do this, see Submitting invoices 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 counterparty 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 on how to do this, see Submitting invoices 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.

    • A stakeholder may delegate the responsibility to submit invoices to another stakeholder. In that case, the legal liability to submit the data remains with the stakeholder who issued the invoice.

      Note

      The advertiser may delegate both the responsibility and legal liability to submit invoices to their counterparty. This must be stipulated in the contract between the advertiser and the counterparty.

  • 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 advertising stakeholders 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
  1. 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:// or https://.

      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.

  2. 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:

  1. Go to the list of contracts: MarkingContracts, then open the contract with the advertiser (the primary contract).

  2. 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 Mediation agreement type, be sure to specify the exact amount to be paid.

  3. 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.

  4. Save changes.

If Adfox reports an error while saving
  1. In the Campaigns or the Campaigns (NEW) tab, select the campaigns created under this contract.

  2. 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).
  3. Save changes.

  4. Change the contract type in the MarkingContracts tab.

  5. 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):

  1. Go to Marking → Contracts.
  2. Click Create in the upper-right corner of the screen.
  3. Enter the details of the contract with the publisher (domain, video resource, blog, or app owner).
  4. 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 Mediation agreement type, be sure to specify the exact amount to be paid.

  5. In the Contract role field, select Agreement between the Publisher and the Customer (Intermediary).
  6. 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:

  1. The campaign was created before the invoice end date.
  2. 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.

For more information, see Registering ad creatives in Adfox.

Step 2. Add the invoice details for the final contract

  1. Go to Marking → Invoices.

  2. Click Create an act in the top right corner.

  3. In the window that opens, select Statistics with invoice.

  4. Select Type of act:

    • The act of completed works — if the end contract's type is a Service agreement or the Additional agreement to a service contract.

    • Intermediary's Report — if the end contract's type is a Mediation agreement or the Additional agreement to an intermediary contract.

  5. Enter the invoice data under the final contract depending on the invoice type:

    • Act: Invoice name or number.
    • Date of the act: Invoice date.
    • 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. 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.

    • 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.

  6. Click Create an act. You'll see a window with the invoice details and a list of all campaigns linked to the final contract.

  1. Go to Marking → Invoices.

  2. Click Create an act in the top right corner.

  3. In the window that opens, select Statistics without invoice.

  4. Select Type of act:

    • The act of completed works — if the end contract's type is a Service agreement or the Additional agreement to a service contract.

    • Intermediary's Report — if the end contract's type is a Mediation agreement or the Additional agreement to an intermediary contract.

  5. Enter the invoice data under the final contract depending on the invoice type:

    • Act: Invoice name or number.
    • Date of the act: Invoice date.
    • 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. 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.

  6. 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.

  1. Open the invoice and click Add Location in the invoice editing form.

  2. In the Agreement/Addendum field, select the contract to add a breakdown for.

  3. Enter the amount (the share of the invoice amount that is attributable to the contract with the end advertiser):

    • 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.

  4. Save changes.

Step 4. Add campaigns, download the file with preliminary statistics, review it, fill out the missing data, then upload the file to the invoice and send it to the advertising data operator.

  1. 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.

  2. 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.

  3. 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.

  4. Click Save.

  5. In the bar, click Download a file with preliminary statistics.

  6. Make sure that all rows with statistics were collected correctly and that all data in the required columns is accurate. Required columns appear in bold. Optional columns, which are uploaded for convenience and are NOT sent to the advertising data operator, appear in italics.

    How to fill out the columns:

    You can add and delete rows and edit cell data. You can't modify the columns.

    • Кампания (optional, can be empty): Name of the campaign as it appears in Adfox.

    • ID кампании (optional, can be empty): ID of the campaign as it appears in Adfox.

    • Баннер (optional, can be empty): Name of the banner as it appears in Adfox.

    • ID баннера: Specify the ID of the banner for which you obtained the token and for which you're sending statistics.

    • Сайт (optional, can be empty): Name of the site where the banner was served, as it appears in Adfox.

    • ID сайта: Specify the ID of the site where the banner was served.

    • Плановые показы: Specify the number of planned impressions.

    • Фактические показы: Specify the number of actual impressions.

    • Сумма (рубли), Сумма НДС (рубли), Сумма без НДС (рубли): Specify the totals by banner and site. You can round the values to whole numbers or include kopecks. When specifying kopecks, use a period or a comma as the separator. You can specify up to three digits after the decimal point. For example: 74443.9, 74443.86, 74443,865.

    • Ставка НДС: Specify the VAT rate as a whole number.

    • Стоимость единицы оказания услуг (рубли): Specify the cost in rubles.

    • Тип кампании: This field is pre-filled using information from the campaign parameters. Acceptable values: other cpm cpc cpa

    • Фактическая дата начала показов, Фактическая дата окончания показов, Плановая дата начала показов, Плановая дата окончания показов: Specify the banner impression period in YYYY-MM-DD format.

    If everything is correct, upload the statistics file to the invoice.

    Otherwise, make the necessary changes, then upload the updated file.

    You can download and re-upload the file as many times as you need.

  7. The Send the invoice and statistics to the advertising data operator button becomes available only after you've uploaded the file.

Contact support

Send an email

A contract between the advertiser and their contractor (the first contract in the placement chain).