Content.kwarray

Keywords describing the content as an array of strings, the structured alternative to Content.keywords. Added in OpenRTB 2.6; only one of the two may be present.

Currentstring arrayOptionalSince 2.6-202204

Field facts

Path
app.content.kwarray, dooh.content.kwarray, site.content.kwarray
Object
Content
Type
string array
Requirement
Optional
Added
OpenRTB 2.6-202204
Spec section
3.2.16

How it is used

The spec text for 2.6-202210 to 2.6-202303 misspelled the field as kwarry in the Content table, and 2.6-202309 corrected it. Payloads should always use kwarray.

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "app": {
    "content": {
      "kwarray": [
        "cooking",
        "documentary",
        "travel"
      ]
    }
  }
}

Common mistakes

  • Sending kwarray alongside keywords. The validator reports the pair as mutually exclusive.
  • Generating the misspelled kwarry from a schema built on those snapshots. Buyers read only kwarray.

Version history

Added in OpenRTB 2.6-202204, and present in the latest snapshot. The spec text for 2.6-202210 to 2.6-202303 spelled it kwarry; payloads use kwarray. The table shows how each version's spec text types the field.

VersionsType in the specRequiredDeprecated
2.6-202204Added in the first 2.6 release, published without a structured text archive; the 2.6-202210 republication is the first tagged text.
2.6-202210 to 2.6-202303string arrayNoNo
2.6-202309 to 2.6-202606string arrayNoNo

Related fields

Other Content fields

For a walkthrough of the whole object, read CTV and ad pods.