How to submit an ad register report in Adfox

Attention. Before you submit a report via Adfox, check that all the conditions are met:
  • The advertising creatives that you report on were registered with the Yandex advertising data operator in the Adfox interface.
  • The report is submitted on behalf of the advertising chain participant that registered the creatives.
  • There are statistics on the impressions of these creatives. If there were no impressions, you won't be able to submit an invoice report.
  1. Submitting a report in the Adfox interface
  2. Frequently asked questions

Submitting a report in the Adfox interface

Step 1. Make sure the data at all levels is correct
  1. Make sure Transfer the site to the ERIR is enabled in the parameters of the site where the ad is placed and that the labeling data is filled out:
    • 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://.
    • Contractor: Contractor (domain, video resource, blog, or app owner) that you added in the Marking tab earlier.
  2. Make sure you correctly defined the site structure. For more information, see Add the site structure and Add the app structure.

Specify the type of contract you have with the end advertiser if you haven't before:

  1. Go to the list of contracts: Marking → Contracts.
  2. Open your contract with the advertiser (primary contract). In Contract role, select one of the options:
    • Select Agreement between the Publisher and the Advertiser if the advertiser and the publisher have a direct contract that doesn't involve any intermediaries.

    • Select Agreement between the Advertiser and the Performer if the advertiser has a contract with an agency (provider) that ordered placement from a publisher.

  3. Save your changes.
If Adfox reports an error while saving
  1. On the Campaigns or Campaigns (NEW) tab, select the campaigns created under this contract.
  2. Temporarily unlink your contract from all campaigns using one of the following methods:
    • Select Do not submit data to state register in the Submission to ad register field, which you'll find in the campaign parameters.
    • Change the selected option in Agreement between the Advertiser and the Performer from the current contract to any other one (for example, a self-promotion contract).
  3. Save your changes.
  4. Change the contract type in the Marking → Contracts tab.
  5. Make sure you reselect the right contract in the campaign parameters.

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.
  3. Enter the details of the contract with the publisher (domain, video resource, blog, or app owner).
  4. In Contract role, select Agreement between the Publisher and the Customer (Intermediary).
  5. Click Create. Once the changes have been saved, the contract is assigned an ID in the Yandex advertising data operator.
Important. Make sure to specify that contract in the Agreement between the Publisher and the Customer (Intermediary) field for all relevant campaigns.

Make sure the contract details in your campaign parameters are correct:

  • If the campaign was created as part of a direct contract between the advertiser and the placement owner that doesn't involve intermediaries, enter the [Direct] contract in the Agreement between the Advertiser and the Performer field.
  • If your advertising chain involves intermediaries, fill out the following two fields:
    • In Agreement between the Advertiser and the Performer, enter the [Primary] contract.
    • In Agreement between the Publisher and the Customer (Intermediary), enter the [Final] contract.

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.


Make sure all banner parameter fields under Settings for Russian ad register are filled out.

  • Submission to ad register: If the creative content is going to be added to the ad register, select Submit data to state register.
  • Description: General description of the advertised products or services.
  • Ad distribution type: Creative format (banner, video, or other).
  • Target URL: Link to the advertiser site.
  • OKVED: OKVED codes for the product or service being advertised.

To learn more, see Transferring data and getting a token.


Step 2. Add the details of the invoice for the final contract
  1. Go to Marking → Invoices.
  2. In the upper-right corner, click Create an act.
  3. In the window that opens, enter the details of the invoice for the final contract:
    • Act: Invoice name or number.
    • Reporting period: Start and end date of the reporting period.
    • Date of the act: Invoice date.
    • Final agreement: Contract under which the invoice was issued.

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

      For contracts with an advertiser or an 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
      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
      For contracts in which the advertiser's interests are represented by an agent

      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: Enter the total amount of the invoice. If the amount includes VAT, select The amount is inclusive of VAT.
  4. 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. Divide the invoice amount and the number of impressions between your campaigns and submit the data to the Yandex advertising data operator
  1. In the list, select the campaigns that are included in the invoice. A 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 original invoice has different campaign amounts, change the value in the Amount column to the correct one for each campaign.

    The total amount for all selected campaigns is shown in the field Amount by campaigns at the top of the invoice. This total can be the same or lower (if the original invoice includes services that aren't subject to labeling) than the invoice amount. The amount by campaigns can't exceed the invoice amount.

  3. Specify the number of impressions for each campaign as stated in the invoice. The actual number of impressions (Adfox Impressions) is determined automatically based on Adfox statistics. It's also submitted to the state register.
  4. Click Save.
  5. To send the data to the Yandex advertising data operator, click Send the act to the ORD.
Step 4. Check report statuses on a regular basis
The Yandex advertising data operator sends the received data to the state register. The state register verifies new reports within 24 hours. If the verification is successful, the report status in the Adfox interface changes to Sent to ERIR.

Reports on past periods can be verified again if the state register changes the criteria for data verification. In that case, the report status in the Adfox interface may change.

If a status with information about errors in the report appears in the Adfox interface, fix them.

Frequently asked questions

Can the amount in the Report differ from the total amount for my campaigns when I submit labeling reports using the Adfox interface?
The amount in the Report can be greater than the total amount for Adfox campaigns if the publisher provided other services under their contract.

Contact support