With Adfox, you can only place ads in Telegram channels using the direct sales model. Please note that Adfox doesn’t assist you in finding advertisers. To automate ad selection from Yandex Direct advertisers, use the Yandex Advertising Network.

To place ads delivered by Adfox:

• Add the channel in the Yandex Advertising Network interface.
• Allow a special bot to post messages on your channel.

The bot will place ads during the time slots you specified in your channel settings in the Yandex Advertising Network interface.

Ads placed through Adfox under the direct sales model take priority over those from the Yandex Advertising Network.

1. First, ads from Adfox are selected. The selection process considers your Adfox campaign settings, such as campaign duration, impression limits, frequency targeting, and time-based targeting.
2. If no ads are available in Adfox, ads from the Yandex Advertising Network will be displayed.
   If needed, you can disable ads from the Yandex Advertising Network.

What the ad looks like

Ads in Telegram channels appear as regular posts and contain:

• Image or video
• Clickable title
• Text
• Call-to-action button
• Ad labeling

Here’s an example:

Step 1. Add and configure a channel in the Yandex Advertising Network interface

1. Log in to your Yandex Advertising Network account with your Yandex ID.
2. Follow this guide that we shared in Help to add your Telegram channel.
3. Choose the time slots when a dedicated Telegram bot will publish ad posts on your channel.
4. Enable the Connect Adfox
5. Click Next.

An ad inventory for this channel will be created in the Adfox interface, including a site, section, and placement.

The channel will appear in the Adfox interface on the Sites tab.

Step 2. Add the Yandex Advertising Network bot

1. Wait until the Yandex Advertising Network selects a bot for your channel. Follow the link to the bot.
2. Open the bot’s description. Click Add to group or channel and select your channel.
3. A window with permission settings will open. Allow the bot to post messages on your channel and save changes.
4. In the Yandex Advertising Network interface, click Complete.

Campaign and banner structure

An ad campaign follows the hierarchical structure:

Supercampaign
↓
Flight (campaign)
↓
Banners

At the top of the hierarchy, the supercampaign consolidates various campaigns with their creatives and allows you to define general restrictions for them: start and end dates, schedules, and number of impressions.

A flight is an additional level between a supercampaign and banners, which allows for more granular control over impressions within the ad campaign.

The final level consists of banners. Adfox supports various ad formats with images, videos, and HTML files.

Create a supercampaign

Click Create.

In the window that opens, fill in the required fields:

• Campaign name
• Advertiser
• Impression count method

The advertiser and counting method will carry over to flights.
You can set date and impression limits for each flight group in the super campaign settings if needed.

How to fill in the required fields:

• Name. Add an arbitrary name for your ad campaign.
• Advertiser. From the list, select the Default Advertiser or the advertisers that you previously created in this account. We explained how to create a new advertiser in the ‘Understanding the Adfox interface’ module.
• Impression count method. Choose which event counts as an ad impression:
• Banner ad response: Selecting a banner from this ad campaign for placement in your Telegram channel.
• Post views (Telegram) recorded by the Yandex Advertising Network bot.

Create a flight

After creating a supercampaign, the Flights tab automatically opens. Set up the campaign.

Campaign type

• Campaign type: Choose Guarantee.
• Campaign profile: Specify ‘Direct sale’.

General settings

• Campaign name: Choose a unique name for your ad campaign.
• Status: By default, the campaign is set to Active.
  You can later pause the campaign.
  After the end date, it will automatically change to Completed.
• Advertiser: This setting is inherited from the supercampaign.
• The impression count method is inherited from the supercampaign.

General restrictions

Deliver impressions or clicks: Select As fast as possible
Banner ads are served at the highest frequency possible until the impression or click limit is reached.

Total impressions, day, hour: Specify the maximum number of impressions for this campaign within the chosen period.
Remember to specify the number of impressions based on your selected counting method. For example:

1. Counting method: ‘Banner ad response’.
   Total impressions: 2000.
   In this case, the ad post will be published during the specified time slots until it reaches 2000 banner ad responses.
2. Counting method: ‘Post views (Telegram)’.
   Total impressions: 2000.
   The ad post will be published during the selected time slots until it reaches 2000 post views.
   The post will be removed from your channel 46-48 hours after it is posted, even if it reaches the required number of views sooner. If this number is reached after the first publication, the ad post will no longer be published in the channel.

For more information about limits and impressions, see this article.

Placement

Find and select the Telegram channels where you want to serve the new ad campaign.

Targeting

determines who sees the banners and under what conditions.
For ad campaigns in Telegram channels, you can use two targeting methods:

• Frequency
  Each Telegram channel is counted as a unique visitor, not the people who follow the channel.
  For example, if you set an impression frequency of 2 times per week for a campaign, then in each channel where the campaign is placed, ad posts will be published no more than twice a week.
  However, each channel subscriber can view ad posts an unlimited number of times.
• Time: Days of the month, days of the week, hours.

Newsletter

You can set up automatic report delivery to your contracting parties (advertisers, agencies, and managers) by email. For the newsletter, you can set up a schedule, a dimension, and statistical metrics from the start of the campaign to its end.

Saving

Specify the parameters for your ad campaign and save it.

Now that you’ve created an ad campaign, add banners to it.

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

2. Then select a banner type and specify a template:

• Banner type: Telegram banner.
• Template: A post with an image and text, a post with a video and text, or a text-only post.

3. Configure the basic settings of the banner

• Name
  Specify a name for your banner. If left blank, the banner will be assigned a sequence number.
• Priority
  Enter a number to determine the banner’s priority.
  The higher the number, the higher the banner’s priority and the more often it will be displayed compared to other banners in the campaign.
• Status
  Choose the status:
  • Active: The banner is ready to be served.
  • Suspended or completed: The banner won’t be served.

4. Choose your banner content.

Example for banner template A post with an image and text

• Image (for post with an image): Add an image in GIF, PNG, JPG, or JPEG format.

  Video (for a post with video): Add a video in MP4 format.
  To maximize the probability of automatic video playback in the post, add a file up to 10 MB.

  Links to third-party resources are not supported.

• Title: The post’s title (clickable).
• Post text. A post with an image and video can contain a maximum of 764 characters. For text-only posts, the limit is 3830.
  
  What else can be added:
  — Inline HTML elements
  For example: <b>bold</b>
  — Links
  Example of link formatting:
  <a href='https://adfox.yandex.com/'>Link text</a>)
  Clicks on such links are not counted in statistics.
• Call-to-action button: Enter the text that will appear at the bottom of the post and link to your product or service.
• Click-through URL: Provide a link to the advertised product or service.
• Delete post

  True: The post will be removed 46–48 hours after publication.
  False: The post won’t be removed from your channel, but the statistics will include:

  • Post views (Telegram): Only for the first week.
  • Clicks: For as long as the ad campaign and banner are in the Active

5. Specify general restrictions on impressions and clicks.

Keep in mind that ad impressions delivered by Adfox depend on the time slots you specified in your channel settings in the Yandex Advertising Network’s interface. For example, if you select three time slots in the settings, the bot will request ads from Adfox three times a day.

Note
We recommend setting the campaign start time 10–15 minutes before the start of the time slot you specified in the channel’s settings. You need this extra time so the campaign can activate in Adfox, because the bot could ask for ads right when the time slot starts.

Choose this ad placement method:

1. Matching exact time slots.
   • Select the Custom settings for Adfox
   • Leave the Apply a limit for Adfox posts option disabled. This ensures that the Maximum number of posts per week limit doesn’t affect how ads from Adfox are published.

Example of post selection:

If you want to avoid showing the same ad post too often, here are some ways to configure your Adfox campaign:

• Limit the campaign duration.
• Limit the frequency of the campaign’s impressions across all channels.
• Limit the frequency of the campaign’s impressions in a specific channel.
• Limit the frequency of all ad campaign’s impressions in a specific channel.
• Apply time targeting by days of the week, hours, or days of the month.

  Learn more about each method in Help.

2. Matching the limit of the number of posts per week.
   • Select the section Delivery settings for Adfox and the Yandex Advertising Network.
   • Go to your channel settings and enable the option Apply a limit for Adfox posts in the Maximum number of posts per week Posts can be published in any time slot you’ve selected in your channel settings. The total number of posts from both systems will be limited to the specified number.

Example of post selection:

In this case, we cannot guarantee that Adfox will deliver ad impressions exactly within the chosen time slots. To ensure the bot can publish ads according to the impression schedule, we recommend avoiding narrow limits and targetings in Adfox.

You can track the statistics of impressions, clicks, and CTR in real time using the Adfox built-in tags.