Are ChatGPT ad context hints exact-match keywords?

The Citead team, updated

In short. ChatGPT ad context_hints describe when an ad may be useful, while campaign targeting controls eligibility.

Definition: ChatGPT ad context_hints are free-form strings attached to an ad group to describe products, use cases, needs, or situations in which the ads may be useful. OpenAI's targeting documentation separates these contextual descriptions from exact-match keywords and from explicit geographic, platform, and audience targeting.

Key facts

  • OpenAI describes context hints as additional information about an ad group's ads when the creative and landing page leave a relevant product, use case, or need implicit in its targeting documentation.
  • The Ads API reference defines context_hints as an optional string[] field containing free-form audience or placement hints.
  • The same API reference says the hints provide extra information about when an ad may be useful and help guide when it appears.
  • OpenAI's targeting page allows up to 2,000 hints in an ad group and says that updating the field replaces the current list.

What does context_hints describe?

OpenAI places context_hints on an ad group. The field supplies descriptive context around the offering, such as a product, a use case, or a need that the ad creative and landing page may leave implicit. The API reference describes the values as a list of descriptions or keywords for when the product or service might be useful to show.

The examples show the intended level of detail. OpenAI contrasts the broad hint Shoes with Lightweight trail running shoes for rocky terrain, and Outdoors with Water-resistant footwear for wet-weather hiking. The examples are guidance about writing context; the page leaves activation of a particular conversation unspecified.

Are the hints an exact-match control?

No. OpenAI explicitly says that hints are not exact-match keywords. The field is a contextual description supplied to the ad system, rather than a documented rule that requires a user's wording to equal a supplied string.

The targeting page also separates context hints from campaign controls. Geographic, platform, and audience settings determine who is eligible to receive a campaign's ads. These settings remain the place for delivery restrictions. For example, a location restriction belongs in campaign targeting, while a product's use case belongs in the ad group's hints.

What are the field's limits?

The targeting documentation says an ad group can contain up to 2,000 hints and that the list can be shorter. It recommends information that describes the ads accurately. The API reference makes the field optional and identifies its type as string[], so an ad group can be created with or without context hints.

An update has list semantics. OpenAI says that sending context_hints replaces the current list. To add one hint, retrieve the ad group, append the new value to the existing list, and send the complete intended list. Omitting the field leaves it unchanged, while sending an empty array clears it.

curl -X POST "https://api.ads.openai.com/v1/ad_groups/adgrp_123" \\
  -H "Authorization: Bearer ${OPENAI_ADS_API_KEY}" \\
  -H "Content-Type: application/json" \\
  -d '{
    "context_hints": [
      "Lightweight trail running shoes for rocky terrain",
      "Water-resistant footwear for wet-weather hiking"
    ]
  }'

After an update, OpenAI recommends retrieving the ad group to confirm the saved list. Restrictions for geography or audience remain campaign settings, so they are configured separately from this field.

FAQ

Should a hint contain the exact wording a person might use?

OpenAI documents context hints as free-form descriptions or keywords about when an ad may be useful. It also states that they are not exact-match keywords, so the documentation defines no required wording match.

Where should a geographic restriction be configured?

Configure it in the campaign's geographic targeting. OpenAI places geographic, platform, and audience targeting at campaign level, separate from context hints.

What happens when one hint is added to an existing list?

Retrieve the ad group, append the new hint to the existing list, and submit the complete list. Sending the field replaces the current list; an empty array clears it.

Sources

  1. OpenAI, "Targeting", undated
  2. OpenAI, "Ad Groups", undated

Check how a page reads to answer engines. Open the GEO score analyzer

Test a page and see what to fix first

The analysis usually takes less than 10 seconds and needs no account.

400,000+ pages scored in the public benchmark