--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.ru/support/adfox/en/quickstart.md - https://yandex.ru/support/adfox/ru/quickstart.md - href: en/quickstart.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/adfox/en/llms.txt # Quick start ## Step 1. Log in to Adfox A new Adfox account is created automatically when you register in the [Yandex Advertising Network](https://yandex.com/support/partner/?lang=en) and accept the service's single electronic offer. {% cut "If you don't have a Yandex Advertising Network account" %} 1. Log in with [Yandex ID](https://passport.yandex.com/) or [register](https://yandex.com/support/passport/authorization/registration.html). {% note warning %} Do not use employees' personal or work accounts to register in Adfox. Instead, create a fresh Yandex ID account for your company. This ensures you still have access to the account even if the employees responsible for it change. {% endnote %} 1. On the [Adfox home page](https://adfox.yandex.com/promo/en), click **Join**. 1. Fill out the [application](https://yandex.com/support2/partner/en/joining/application-form#application) and click **Send application**. You get access to the Yandex Advertising Network and Adfox interface. {% endcut %} You get **Administrator** access immediately after registering. The administrator has the full set of rights to manage account settings. They can also create users and manage their access rights. You can't transfer administrator rights to another user. You can access Adfox the following ways: - Log in to your [Adfox](https://adfox.yandex.com/promo/en) account. - Log in to your [Yandex Advertising Network](https://partner.yandex.com/) account and select **Adfox** in the left menu. ![](_images/adfox-quickstart.png) ## Step 2. Banner types and templates You can use a banner type to mark up ad placements on your website, in a video player, or in an app. For example: Fullscreen, 240 × 400, 300 × 600, stretching banner, pre-roll. Each banner type contains a set of templates which determine the appearance and functionality of an ad creative. You should add custom banner types if you're going to place ads on your site (including its mobile version). For other cases, banner types and templates are already set. {% cut "How to determine banner types and templates" %} The banner type and the templates it has available depend on the ad format and placement: #| || **Placement** | **Format** | **How to add a banner type and a template** || || Website (desktop and mobile version) | Banner ad, Video ad | 1. Go to **Settings** → **Banner types** → **Custom** → **Nondimensional**. 1. Click **+ Add**, enter a name for the banner type, then click **Add**. The **Templates** tab opens. 1. Add a template: use a [preset](https://yandex.ru/support/adfox/en/ad-inventory/settings/template.md#predefined-template) template or create a [custom](https://yandex.ru/support/adfox/en/ad-inventory/settings/template.md#custom-template) one. || || AMP pages | Banner ads | Added by default. To enable available banner types and templates: 1. Go to **Settings** → **Banner types** → **Predefined** → **Nondimensional**. Banner types for AMP pages have **AMP** in their names. 1. Click the ![](_images/banner-types.svg)**Templates** icon next to the name of the banner type to open the list of templates. || || Mobile apps for iOS and Android | Banner ads | Added by default. Located in the **Settings** → **Banner types** → **Predefined** → **Nondimensional** tab. Banner types for apps have **App Mobile** in their names. || || | Video ad | Added by default. Located in the **Settings** → **Banner types** → **Predefined** → **XML** tab. || || Video resource | Video in video content | Added by default. To enable available banner types and templates: 1. Go to **Settings** → **Banner types** → **Predefined** → **XML**. 1. Click the ![](_images/banner-types.svg)**Templates** icon next to the name of the banner type to open the list of templates. || || — | [Tracking pixel](https://yandex.ru/support/adfox/en/banners/pixel1x1.md) | Added by default. To enable the **1 × 1** banner type, go to **Settings** → **Banner types** → **Predefined** → **Nondimensional**. || |# {% endcut %} ## Step 3. Add contractors and a contract This step is necessary if you place ads under a contract for displaying ads in Russia signed directly with an advertiser or through an agency and want to report these ad impressions to the state register through the Yandex advertising data operator. For more information about transferring data to the state register, see [Settings for Russian ad register](https://yandex.ru/support/adfox/en/labeling/about.md). {% cut "When you don't need to specify the contractor and contract data" %} You don't need to add contractors and an contract if at least one of the following conditions is met: - You don't have a direct contract for placing ads with an advertiser. - Ads will be displayed outside of Russia. - You place a token in a creative on your own and transfer data to the Russian state register via a different advertising data operator. {% endcut %} ## Step 4. Add a site, sections, and placement A site in Adfox is a resource where ads are placed. It can be a regular or mobile website, a mobile app, or a video resource. Each site (website, app, video resource) is divided into sections and placements. A site section is a part of a site that's logically distinct in terms of topic, method of selling banner placements, subdomain, or any other characteristic. A placement is the direct ad placement on the site. To learn how to add a website, sections, and sites, see [Add a site, section, and platform](https://yandex.ru/support/adfox/en/ad-inventory/sites.md#site-zone-place). {% note info %} To place banners for direct sales in your mobile app, add the app in the Yandex Advertising Network interface, create an ad unit, and [connect it to Adfox](https://ads.yandex.com/helpcenter/en/monetization/adfox/connection). If you use [Mobile Mediation](https://ads.yandex.com/helpcenter/en/monetization/yandex-mediation/), Adfox is already enabled by default. You can find your app in the Adfox interface on the **Inventory** tab. It will have the same name as in the Yandex Advertising Network. {% endnote %} ## Step 5. Get and place the ad tag on the resource {% list tabs %} - Site You should obtain the [site-level ad tag](https://yandex.ru/support/adfox/en/ad-inventory/codes/get-code.md#site-code) for the ad placement once and install it on all the pages of your site. To get the ad tag to install on your site: 1. Open the **Inventory** tab and click ![](_images/code.svg)**Ad tag** next to the name of the site. The **Ad tag** tab with the ad loader code and the ad block code opens. 1. Choose **Banner type** and **Position**, corresponding to the site where you are planning to place the ad tag. 1. Add the ad loader code to the `` of each page where your ads are served. Add the ad unit tag between the `` and `` tags where the ad unit should be displayed. - App Integrate the Yandex Mobile Ads SDK into the app and connect an R-M ad unit. For more information, see the [Help section on in-app advertising](https://ads.yandex.com/helpcenter/en/monetization/adfox/connection#step-3-integrate-the-unit-into-the-app). - Video resource 1. Open the **Inventory** tab and click ![](_images/code.svg)**Ad tag** next to the name of the video resource. The **Ad tag** tab opens. 1. Choose **Banner type** and **Position**, corresponding to the site where you are planning to place the ad tag. 1. The ad request link appears. 1. Afterwards, integrate [Video Ads SDK](https://yandex.com/dev/video-sdk/doc/dg/sdk-html5/adfox.html?lang=en) into the player and paste the link. Learn more about [ads in the video player](https://yandex.ru/support/adfox/en/ad-inventory/video.md). {% endlist %} ## Step 6. Create an advertiser An [advertiser](https://yandex.ru/support/adfox/en/settings/users/advertiser.md) is a user who can access statistics of campaigns that they are indicated as the advertiser for. An account administrator can also allow an advertiser to add, edit, or delete banners in their campaign. If you are not planning to grant other users access to statistics, you can select a pre-installed advertiser in the ad campaign settings. {% cut "How to create an advertiser" %} 1. Go to **Users** → **Participants** → **Advertisers** and click **+ Create new**. 1. Enter the advertiser's login and email address. The advertiser will be sent an email with a link to register in Adfox. {% note info %} You can only use Latin letters, numbers, dashes, underscores, and periods to create a login. The login must contain from 1 to 32 characters and be unique within the Adfox system. If you enter an existing username, a warning appears. {% endnote %} {% endcut %} ## Step 7. Add an ad campaign 1. Go to **Campaigns** and click **Create**. 1. Specify the advertiser created earlier, the [campaign type](https://yandex.ru/support/adfox/en/campaigns/rotation-method.md#types), and the [impression count method](https://yandex.ru/support/adfox/en/campaigns/impressions-method.md). 1. Select what data to submit to the [ad register](https://yandex.ru/support/adfox/en/labeling/about.md): - **Submit data to state register**: Select this option to get a token and transfer data to the Russian state register (ERIR) [via the Adfox interface](https://yandex.ru/support/adfox/en/labeling/token.md). - **Do not submit data to state register**: If at least one of the following is true: - You don't have a direct contract for placing ads with contractors. - Ads will be displayed outside of Russia. - You place a token in a creative on your own and transfer data to the Russian state register via a different advertising data operator. 1. Select a site, section, or placement where you want to run your campaign. 1. Save the campaign. ## Step 8. Add banners to the ad campaign A banner is an advertising creative. 1. In the campaign you created, go to the **Banners** tab and click **Create**. 1. Select the banner type that you specified when creating the placement. 1. Select a template for your creative, such as **Banner Image [context]**. 1. Configure the banner settings. To learn more about the settings and requirements for creatives, see [Banner requirements](https://yandex.ru/support/adfox/en/banners/specs/index.md). 1. If you chose to **Submit data to state register** at the ad campaign level, add the creative data in the **Advertising labeling** section. For more information, see [How to register creative content in Adfox](https://yandex.ru/support/adfox/en/labeling/token.md). 1. Click **Add**. Now the advertising creatives are displayed on your site. Detailed information about ad requests, impressions, and clicks can be found in the **Reports** tab. ## Step 9. Enable monetization with the Yandex Advertising Network or via Header Bidding Monetization enables you to sell traffic on placements through the Yandex Advertising Network or other external monetizers using Real Time Bidding technology. You can find the list of external monetizers that can be connected to Adfox in [Header Bidding](https://yandex.ru/support/adfox/en/monetization/hb-about.md#bidders). {% list tabs %} - Monetization with the Yandex Advertising Network Monetization with the Yandex Advertising Network can be enabled for both regular websites (mobile and desktop versions) and for sites created using AMP technology. 1. [Add a website](https://yandex.com/support2/partner/en/joining/application-form#add-resource) in the Yandex Advertising Network interface. Once added, the resource is automatically sent for [moderation](https://yandex.com/support2/partner/en/joining/moderation). After your resource passes moderation, you can connect the Advertising Network to Adfox. 1. In the [Adfox interface](https://adfox.yandex.com/), go to **Monetization** → **Display Advertising**, and hover over the platform to connect to the Yandex Advertising Network. A plus sign appears in the **YAN block ID** column, click it. 1. In the window that opens, select the site added to the Yandex Advertising Network in the first step. This will create a special ad unit that you can work with in Adfox. 1. The YAN interface opens: add advertising formats to the block and set up an impression strategy. To learn more about setting up ad units, see [Yandex Advertising Network Help](https://yandex.com/support2/partner/en/web/units). - External Header Bidding monetization Header Bidding is a technology that lets multiple monetizers connected to a site bid on a placement when a user loads a site page, enabling you to get the highest price. Before you start connecting any third-party monetizer: 1. Sign a separate contract with each monetizer that competes in Header Bidding auctions. 1. In the monetizer's personal account, create an ad unit for the desired placement on your site and save its ID — you'll need it to create a configuration script. **Step 1. Add a template labeled Header Bidding for the banner used on the placement** Determine the banner type used on the placement where you want to enable external monetization. Let's say this is a **240 × 400** predefined banner type. Add a special template to this banner type: 1. Go to **Settings** → **Predefined** and open the templates in the desired banner type. 1. Find the template with the monetizer's name that's labeled **Header Bidding** from the list of templates (for example, **Header Bidding myTarget**) and click **Select (>>)**. 1. The desired template is added to the banner type. Click **Change**. **Step 2. Create an ad campaign for an external monetizer** 1. Go to **Campaigns** and click **Create**. 1. Enter the name, advertiser, and the external monetizer you selected. 1. Select a site, section, or placement where you want to enable external monetization. 1. Save the campaign. **Step 3. Add a banner** 1. In the campaign you created, go to the **Banners** tab and click **Create**. 1. Select the banner type used on the placement where you want to enable external monetization. 1. Select the template that you added in step 1. In our example, it is **Header Bidding myTarget**. 1. If necessary, change the banner settings. To learn more about banner parameters, see [Adding banners](https://yandex.ru/support/adfox/en/sites/add-banner-new.md). 1. Click **Add**. **Step 4. Create and connect a configuration script** 1. Go to **Monetization** → **HB configurator**. 1. Click **Add container** and specify the **Container ID**. 1. Click **Add monetizer**. 1. Select a monetizer (in our case it's **myTarget**) and specify the **Monetizer's placement ID**, which is an ad placement ID in the account of the selected external monetizer. 1. Click **Generate**. Copy the ad tag and add it to the HTML code of the site (or selected pages) inside the `` tag. Afterwards, Header Bidding external monetization for Adfox placement is enabled. {% endlist %} To learn more about monetization, see [Monetization in Adfox](https://yandex.ru/support/adfox/en/monetization/index.md). #### Related information - [Getting started with Adfox: site monetization](https://yandex.com/adv/edu/publishers/adfox-start-working) - [Getting started with Adfox App monetization](https://yandex.com/adv/edu/publishers/adfox-start-working-app-monetization) - [Getting started with Adfox Configuring direct placements and ad labeling in Telegram channels](https://yandex.com/adv/edu/publishers/adfox-start-working-telegram-channels) ## Contact support Send an email