Key-Value を追加する際、キーの名前と値の指定方法にはいくつか制限があります。
有効なキーの名前
- 大文字と小文字は区別されません
- 数字で始めることはできません
- スペースを含めることはできません
パターン一致マクロと動画メタデータ マクロで使用するキーには、英数字とアンダースコア（_）のみを使用できます。
オーディエンス セグメントのカスタムキーには、英数字とアンダースコア（_）のみを使用できます。オーディエンス セグメントのカスタムキーの先頭文字には数字以外を指定する必要があります。たとえば、abc123 は有効ですが、123abc は無効です。オーディエンス セグメントについて詳しくはこちらをご覧ください。
有効な値の名前
- 大文字と小文字は区別されません
- 数字で始めることができ、数字のみを含めることも、数字と文字の組み合わせにすることもできます
- スペースを含めることができます
スペースは、値の名前に含めることはできますが、キーの名前には使用できません。たとえば、次の Key-Value ペアは、キーの名前にスペースを含んでいるので無効です。
sports car=aston-martin-db5
一方、次の Key-Value ペアは、値の名前にスペースを含んでいるので有効です。
car="aston martin db5"
スペースを含む値の名前は必ず二重引用符で囲みます
スペースを含む値の名前を広告タグに追加する場合や高度な式のターゲティング機能で使用する場合は、二重引用符で囲む必要があります。
値は数字で指定した場合でも文字列として扱われます。つまり、その数字の評価や計算はできません。たとえば、次の式は有効ではなく、18 歳以上 32 歳未満のユーザーの結果は生成されません。
age >= 18 AND age <= 32
代わりに、次のような 1 つの Key-Value ペアでこの年齢層を取得する必要があります。
age=18-32
キーと値に使用できない文字
次の文字は予約されており、キーの名前や値では使用できません。アスタリスク（*）とチルダ（~）の文字は、「動的」Key-Value で使用して、マッチタイプのターゲティング機能に利用できます。
| 文字 | 説明 | 文字 | 説明 |
|---|---|---|---|
| " | 二重引用符 | ; | セミコロン |
| ' | 一重引用符（アポストロフィ） | ^ | キャレット |
| = | 等号 | () | 丸かっこ |
| ! | 感嘆符 | < > | 山かっこ |
| + | プラス記号 | [ ] | 角かっこ |
| # | ポンド記号（ハッシュ記号） | , | カンマ |
| * | アスタリスク | & | アンパサンド |
| ~ | Tilde |
