How to register creative content in Adfox

When setting up an ad campaign in Adfox, you can simultaneously register creative content with the Yandex advertising data operator. Each creative is assigned a unique ID (token). It is added to a click link and banner menu (if it's enabled in the banner parameters).

In the following sections, you can learn more about specific aspects of registering certain types of ad creatives:

Warning

If you register creative content with the Yandex advertising data operator in the Adfox interface, an ad register report must also be submitted in the Adfox interface.

Step 1. Create counterparties (advertising stakeholders)

  1. In the Adfox interface, go to Marking → Counterparties.

  2. Create a counterparty that will be the end advertiser:

    1. Click Create in the upper-right corner of the screen.

    2. Fill out the form that opens with information about the end advertiser, which is the customer whose products or services you'll be advertising on your resource.

      To learn how to label ads of your own products and services, see Labeling self-promotion.

    3. Press Create.

  3. Create a provider counterparty to be a party under the contract with the end advertiser:

    • If you signed the contract directly with the advertiser, enter your data.
    • If there's an intermediary (agency) in the advertising chain, specify the details of the agency that the end advertiser signed the contract with.
  4. Create the site owner counterparty whose resource you'll place ads on (if they weren't added as a provider before).

Once the changes have been saved, the counterparties are assigned IDs in the Yandex advertising data operator.

For a counterparty to have the Is an advertising distributor flag, add a website with ad labeling enabled.

Note

If you create multiple counterparties with the same TIN, make sure they have different roles. You can also create a single counterparty with a dual role: Customer and provider.

Step 2. Specify information about the contract with the end advertiser

  1. Go to Marking → Contracts.

  2. Click Create in the upper-right corner of the screen.

  3. In Contract type, select one of the options:

    • Contract
    • Additional agreement
    • Intermediary contract

    If you select the Intermediary contract type, make sure to fill in the Intermediary function field.

  4. Enter the details of the contract with the end advertiser. This contract can be concluded both directly with you and with an agency (intermediary). In the latter event, specify the details of the contract between the agency and the end advertiser.

  5. In Contract role, select one of the options:

    • Agreement between the Publisher and the Advertiser if the advertiser and the site owner (publisher) have a direct contract that doesn't involve intermediaries.

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

  6. Press Create. Once the changes are saved, the contract is assigned an ID in the Yandex ADO.

If you plan to submit ad register reports in the Adfox interface, you must also specify data about the final contract if there are agencies among advertising chain participants. You can do this at any time: before running a campaign, while it's running, or when submitting reports. Read more in Ad register reports.

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 will change the information about the contract over the entire period.

Step 3. Add the labeling data to your site structure in Adfox

Warning

This step is mandatory if:

  • At least one of the contractors added earlier is an ad distributor or advertising system operator.
  • You plan to submit ad register reports in the Adfox interface.
  1. Go to the Sites tab and click + Add or open the settings of an existing site.

  2. Enable the Transfer the site to the ERIR option. This opens the Marking section.

  3. Fill in the fields:

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

  4. If you're adding a new site, fill in the Main section and proceed to adding sections and placements.

Step 4. Add labeling data to the campaign

Note

Starting from the API version v5, you no longer need to specify the OKVED code for ERIR.

  1. Create a campaign by following the instructions or open the parameters of a created campaign.

  2. Under Settings for Russian ad register, in the Marking procedure field, select Submit data to state register.

  3. Do the following in the additional fields that open:

    • If the campaign was created as part of a direct contract between the advertiser and the placement owner that doesn't involve 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, specify the [Primary] contract.
      • In Agreement between the Publisher and the Customer (Intermediary), enter the [Final] contract.
    • In the Campaign type field, enter the payment model: CPM, CPC, CPA, or other.

    By default, labeling is disabled in the flight settings. You need to enable labeling manually for each flight. New banners inherit their labeling settings from the associated flight.

    Alert

    If you're editing a created campaign, set the ad register settings for the previously added flights and banners manually.

  4. Save changes.

Step 5. Add information about the creative to the banner

  1. Open the banner parameters: go to the Banners tab in the ad campaign parameters, find the desired banner, and click Settings.

  2. If necessary, add the “Ad” or “Social ad” label and the banner menu.

    Note

    If a banner is non-clickable (the Transition URL field is not filled in) and it is to be added to the ad register, be sure to show the banner menu. This is the only way to make the token available when serving the banner.

  3. Under Advertising labeling, check and fill in these fields:

    • Marking procedure: If the creative is to be added to the ad register, select Submit data to state register. Once you add the banner, information about the ad creative is sent to the state register via the Yandex advertising data operator.

      Note

      If the banner isn't to be added to the ad register, select Do not submit data to state register.

    • Display regions: Select what information about the banner's display regions should be sent to ERIR:

      • Do not transfer: Display region data isn't sent to ERIR (default option).
      • All of Russia: The banner is served across Russia.
      • Specify regions manually: Select one or more regions from the list.

      Warning

      All of Russia and manual region selection are different values. If you don't limit ad impressions by region, select All of Russia.

    • Description: General description of the advertised products or services. This is a required field where you should provide the names of brands and types of advertised products or services and their characteristics.

    • Ad distribution type: Format of the creative (such as banner, Text & Image ad, or video ad).

    • Target URL: Link to the advertiser's site.

  4. Make sure that data submission to the Russian state register (ERIR) is enabled for the ad content:

    • If you see the  icon next to the field for your creative, this means that information about it will be sent to ERIR automatically.

      You can set up data submission to the state register yourself for custom templates. Automatic data submission to ERIR is enabled by default for banner preset templates. If you don't see the icon next to a parameter with creative content that must be sent to ERIR, go to the template settings and enable labeling for this parameter.

      Enable data submission to ERIR
      1. Open the template parameters.
      2. In the line with the variable responsible for the creative file, select a value for the Marking parameter:
      • Use as URL: If you upload a file (image or video) to this variable.

      • Use as text data: If the variable contains text (banner title or text). For the HTML code variable, also select the Use as text data value.

        Note

        Don't enable data submission to the state register for the Click-through URL variable.

      1. Click Change at the bottom of the page.
      Disable data submission to ERIR

      To stop sending data to ERIR for a specific banner, click the  icon — it'll turn gray .

    • If the template doesn't support automatic data submission or if data submission to ERIR is disabled in the template parameters , enter information about the creative manually.

  5. Complete the required fields, which vary depending on whether data submission to ERIR is enabled or disabled:

    Data submission

    Creative media data

    Enabled 

    Select the File type value for creative media data samples to upload. Adfox may determine the file type automatically, in which case you don't need to specify it manually.

    If you're uploading an Image file, complete the Creative image description field as well.

    Disabled 

    • Creative text data: Enter text data for the ad creative. If there's a lot of data, add an additional row.

    • Creative file link: Upload a file or an archive containing samples of the creative and add a description in the Creative image description field.

      Specify the File type for the uploaded creative:

      • image;
      • video;
      • audio;
      • zip.

      Note

      The Archive (zip) type is only applicable if the HTML5 banner format is selected in the Ad distribution type field. You can send only one sample with the Archive (zip) file type.

      Requirements for creatives
      • The creative is an image, video, audio, or HTML (only as a ZIP archive).
      • Format:
        • Image: JPEG, JPG, WebP, PNG, and GIF.
        • Video: MP4, WebM, MOV, QT, FLV, and AVI.
        • Audio: MP3.
      • Size:
        • Image, ZIP archive: up to 300 KB.
        • Video, audio: up to 100 MB.
      • The video should be no longer than 120 seconds.

    You can upload multiple samples, all of them will be submitted to the state register. To do this, click Add. You'll see a new button to upload a sample.

    To replace a sample creative, click  Delete to the right of it and then click Add to make the upload button appear.

  6. Save changes.

  1. In the campaign you created, go to the Banners tab and click Create.

  2. Select the banner type that you specified when creating the placement.

  3. Select a template for your creative, such as Banner Image [context].

  4. Configure the banner settings. To learn more about the settings and requirements for creatives, see Banner requirements.

  5. If necessary, add the “Ad” or “Social ad” label and the banner menu.

    Note

    If a banner is non-clickable (the Transition URL field is not filled in) and it is to be added to the ad register, be sure to show the banner menu. This is the only way to make the token available when serving the banner.

  6. Under Advertising labeling, check and fill in these fields:

    • Marking procedure: If the creative is to be added to the ad register, select Submit data to state register. Once you add the banner, information about the ad creative is sent to the state register via the Yandex advertising data operator.

      Note

      If the banner isn't to be added to the ad register, select Do not submit data to state register.

    • Display regions: Select what information about the banner's display regions should be sent to ERIR:

      • Do not transfer: Display region data isn't sent to ERIR (default option).
      • All of Russia: The banner is served across Russia.
      • Specify regions manually: Select one or more regions from the list.

      Warning

      All of Russia and manual region selection are different values. If you don't limit ad impressions by region, select All of Russia.

    • Description: General description of the advertised products or services. This is a required field where you should provide the names of brands and types of advertised products or services and their characteristics.

    • Ad distribution type: Format of the creative (such as banner, Text & Image ad, or video ad).

    • Target URL: Link to the advertiser's site.

  7. Make sure that data submission to the Russian state register (ERIR) is enabled for the ad content:

    • If you see the  icon next to the field for your creative, this means that information about it will be sent to ERIR automatically.

      You can set up data submission to the state register yourself for custom templates. Automatic data submission to ERIR is enabled by default for banner preset templates. If you don't see the icon next to a parameter with creative content that must be sent to ERIR, go to the template settings and enable labeling for this parameter.

      Enable data submission to ERIR
      1. Open the template parameters.
      2. In the line with the variable responsible for the creative file, select a value for the Marking parameter:
      • Use as URL: If you upload a file (image or video) to this variable.

      • Use as text data: If the variable contains text (banner title or text). For the HTML code variable, also select the Use as text data value.

        Note

        Don't enable data submission to the state register for the Click-through URL variable.

      1. Click Change at the bottom of the page.
      Disable data submission to ERIR

      To stop sending data to ERIR for a specific banner, click the  icon — it'll turn gray .

    • If the template doesn't support automatic data submission or if data submission to ERIR is disabled in the template parameters , enter information about the creative manually.

  8. Complete the required fields, which vary depending on whether data submission to ERIR is enabled or disabled:

    Data submission

    Creative media data

    Enabled 

    Select the File type value for creative media data samples to upload. Adfox may determine the file type automatically, in which case you don't need to specify it manually.

    If you're uploading an Image file, complete the Creative image description field as well.

    Disabled 

    • Creative text data: Enter text data for the ad creative. If there's a lot of data, add an additional row.

    • Creative file link: Upload a file or an archive containing samples of the creative and add a description in the Creative image description field.

      Specify the File type for the uploaded creative:

      • image;
      • video;
      • audio;
      • zip.

      Note

      The Archive (zip) type is only applicable if the HTML5 banner format is selected in the Ad distribution type field. You can send only one sample with the Archive (zip) file type.

      Requirements for creatives
      • The creative is an image, video, audio, or HTML (only as a ZIP archive).
      • Format:
        • Image: JPEG, JPG, WebP, PNG, and GIF.
        • Video: MP4, WebM, MOV, QT, FLV, and AVI.
        • Audio: MP3.
      • Size:
        • Image, ZIP archive: up to 300 KB.
        • Video, audio: up to 100 MB.
      • The video should be no longer than 120 seconds.

    You can upload multiple samples, all of them will be submitted to the state register. To do this, click Add. You'll see a new button to upload a sample.

    To replace a sample creative, click  Delete to the right of it and then click Add to make the upload button appear.

  9. Save changes.

Step 6. Track ERIR statuses

Monitor the status of data transfer to the ERIR in campaign and banner lists. The status is indicated by an icon located to the right of the campaign or banner name. There are three icon statuses:

— Data has been accepted by the ERIR.

— Pending response for one or more banners.

— One or multiple banners have labeling errors.

Click the icon to view the status.

To make finding the campaigns or banners that you need more convenient (for example, to filter them by enabled or disabled labeling, labeling errors, and other parameters), you can use the Marking filter. To search for campaigns by contract type, ID, contract number, or invoice number, use the Contract and Invoice filters.

Contact support

Send an email