Share via

.Net BingAds SDK BingAds Keyword MatchType AIOptimized causing parsing errors when reading from Bulk report

Bryan Pedlar 0 Reputation points
2026-03-12T17:23:00.5566667+00:00

Yesterday, we started receiving BulkKeyword objects with a MatchType of AIOptimized. The .Net SDK does not support reading keywords with this value. It also appears that this value does not show up in the WSDL. Does anybody have a suggested solution for this issue?

Microsoft Advertising API
Microsoft Advertising API

A Microsoft API that provides programmatic access to Microsoft Advertising to manage large campaigns or to integrate your marketing with other in-house systems.

0 comments No comments
{count} votes

1 answer

Sort by: Most helpful
  1. Q&A Assist
    2026-03-12T17:23:13.8433333+00:00
    AI generated content. This question contains an answer created with AI from Q&A Assist. Learn more

    The MatchType value set in the Microsoft Advertising APIs and Bulk schema currently only defines the following values:

    • Broad
    • Exact
    • Phrase

    In Ad Insight, there is also an Aggregate value for reporting, but AIOptimized is not part of any documented MatchType enumeration or Bulk schema in the provided references.

    Because AIOptimized is not a valid value in the published MatchType value set, the .NET Bing Ads SDK (and any code generated from the WSDL) will fail to parse it. The SDK expects only the documented enumeration values and will throw when encountering an unknown string.

    Given the available information, the only supported approach is to restrict processing to the documented MatchType values and treat any other value (such as AIOptimized) as unsupported or invalid. For example, when reading Bulk rows, custom parsing logic can:

    1. Read the raw Match Type column as a string.
    2. Map Broad, Exact, and Phrase to the corresponding enum values.
    3. For any other value (including AIOptimized), either:
      • Skip the row, or
      • Map it to a fallback value only in local code (e.g., a custom enum or string field), without attempting to bind it to the official MatchType enum.

    However, since AIOptimized is not documented in the current API or Bulk contracts, there is no supported way—based on this context—to use it as a first‑class MatchType in the .NET SDK. Any long‑term resolution would require an SDK and contract update from Microsoft Advertising so that AIOptimized is added to the official MatchType value set.


    References:

    0 comments No comments

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.