Search query descriptionβ

Alert

We're rolling out search query descriptions gradually. You might not see this tool yet even if the new targeting setup workflow is already available in the interface.

To fine-tune where your ads appear, you can describe the queries you want to exclude in your own words.

You describe which search queries are relevant to your ads and which ones should be blocked. This description acts only as a filter, which means it doesn't broaden the semantic scope but narrows down the traffic pool created by autotargeting, keywords, and semantic matching. Even if you specify a suitable query, the system will filter it out if it doesn't fit your description.

This feature is only available on Yandex Search.

Features and limitations

  • Compatibility with autotargeting categories. Search query descriptions and autotargeting categories can't be used at the same time. The system will only apply one of these settings. If you choose a search query description and want to receive traffic from branded queries, be sure to mention your brand in the description.

  • Query matching. The system doesn't generate new queries. Instead, it checks the ones that can trigger your ads in real time:

    • For autotargeting, queries will strictly match your description.
    • For keywords and semantic matching, the description acts as a hint. Your ads will appear more often for queries that match the meaning of your text, and less often for irrelevant ones.
  • Level of application. This setting works at the ad group level and applies to all ads in the group. The description only defines search queries and ignores any additional context from your ad group settings (such as product feed data, display region, bid adjustments, audience segments, and other parameters). If you need to account for these parameters, split your campaign into smaller groups and create a separate description for each.

  • Length limit. Keep your description short and concise, with no more than 500 characters.

  • Precise wording. Write your description as a direct and clear instruction. For best results, begin your description with phrases like “Queries must contain...” or “Queries must not...”.

    • If you want queries that mention your brand, use phrases like “Queries must mention my brand [Brand Name]” or “Queries must contain [Brand Name]”.

    • To exclude impressions for certain brands, write: “Queries must not contain brand names [Brand Names]”.

  • Evaluating results. After adding your text, check the forecast and sample queries under the Selected and Excluded tabs. You'll see real-world queries that can trigger your ads. If these queries don't match your goal, adjust your description.

How to write a search query description

To help our algorithms target the right audience, describe in detail what users should be searching for and which queries to exclude. Please include the brand, model, or product features if they matter for your sales, and make sure there are no conflicting conditions.

Examples of good and bad descriptions

Good description

Bad description

  1. Be clear about what the user is looking for.

    button-ok “Queries must focus on buying an apartment in a new building, including mortgages. Rentals and resale properties aren't relevant.”

  1. Don't use descriptions with vague wording. Vague descriptions make it hard to determine which queries match your goals.

    button-cancel “Target only interested customers”

  1. Make it clear which product contexts are relevant and which ones are not.

    button-ok “Queries must focus on smart speakers with Alice: how to choose one, pricing, and where to buy. Exclude queries about Alice on mobile phones.”

  1. To avoid accidentally filtering out target traffic, don't exclude words that might appear in relevant queries.

    button-cancel “Queries should be about ophthalmologists, but they should not include the word 'doctor'” (this description may filter out target queries like “book a doctor appointment with an ophthalmologist”)

  1. Specify the product line or model within the brand.

    button-ok “Queries must be specifically about Yandex Station Mini. Generic queries about smart speakers with Alice or other models aren't relevant.”

  1. Don't list too many words at once.

    button-cancel “Queries must include the words 'buy', 'speaker', 'Alice', and 'cheap'” (this description may filter out relevant queries like “pricing of smart speakers with Alice”)

  1. If the region matters, mention it in the description.

    button-ok “Queries must mention Moscow”

  1. Don't reference autotargeting categories, ad group settings, or ad content.

    button-cancel “Show ads for queries that mention the region from the ad group”

    button-cancel “Don't select queries from the applicable autotargeting category”

Whenever you change your description, check the forecast and sample queries under the Selected and Excluded tabs. This way, you can verify that your description is clear and matches queries correctly.

How to configure

  1. On the ad group settings page, under the Exclude queries and audiences section, click Add → Search query description.
  2. Enter your description and click Apply.
  3. Check the results in the impressions forecast section under the Selected and Excluded tabs.

Note

Search query descriptions aren't supported in the Direct Commander interface. Managing this setting via XLS/XLSX files and the Yandex Direct API isn't available either.

You can manage or disable this feature in the web interface or the mobile app.

Have questions?

Alert

Our customer service department can only help you with the campaigns created under the same username you use to contact us. You can check your username by opening ya.ru in another browser tab. Our team can access your data only when processing your request.

Scan the QR code or tap it to follow the link.

If you choose Telegram or WhatsApp, keep in mind that Yandex doesn't control and takes no responsibility for how third-party messaging apps store your chats and data.

Call

You can contact us from 10:00 to 19:00 (UTC+3) by phone:

Moscow: +7 495 139-91-93

Russian regions: 8 (800) 700-47-45 (toll-free within Russia)

To access campaigns, the customer service specialist will need your PIN.

Leave a message