標準型およびシリアル型のキー値ペア standard-and-serial-key-value-pairs

キー値ペアは関連する要素(キーと値)で構成されます。キーは、データセットを定義する定数(例:性別、色、価格など)です。値は、そのセットに属する変数(例:男性/女性、緑、100 など)です。 Destination Builder では、キー値ペアの形式でデータを送信します。

基本的なキーと値のペア basic-key-value-pairs

完全な形式の、基本的なキーと値のペアは次のようになります。

  • gender = male
  • color = green
  • price > 100

標準型およびシリアル型のキー値ペア standard-serial-key-value-pairs

宛先はキーと値のデータを standard または serialized 形式で受け取ります。

  • 標準型のキーと値のペア: ​宛先データをそれぞれ別個のキーと値のペアとして設定します。各キーは、明示的に指定されます(異なる値を定義するために再利用される場合でも)。
  • シリアル型の値のペア: ​複数の値が 1 つのキーと値のペアにまとめられます。シリアル型のキーと値のペアでは、特殊なインジケーターにより、このキーと値のセットの中にある値が区切られます。

標準型とシリアル型のどちらのキーと値のペアでも、1 つ以上の値を受け入れることができます。標準およびシリアル化されたキー値形式の例を次の表に示します。

フォーマット
1 つのキーと値のペア
複数のキーと値のペア
標準
x = 1 & x = 2
x = 1 & x = 2 & y = 3 & y = 4
シリアル型
x = 1 ; 2
x = 1 ; 2 & y = 3 ; 4

デリミターとセパレーター delimiters-separators

キーと値の中間の値と、キーと値の間を区切る文字は、delimiters および separators です。これは、セグメントをシリアル形式で宛先に送信する場合に特に重要です。シリアル化により、複数の値を 1 つのキーで渡し、キーと値のペアを結合できるようになります。デリミターとセパレーターは次のように定義されます。

  • キーと値のセパレーター: ​キーと値のペアの中のキーと値を区切ります。
  • キーと値のデリミター: ​キーと値のペアの組を区切ります。
  • シリアルセパレーター: ​シリアル型のキーと値のペアの組の中にある複数の値を区切ります。

examples

Destination Builderでは、キーと値のデータを複数の形式で設定できます。各タイプの例を紹介します。

キーと値のペアの例
説明
標準的な単一キー
X = 1 & X = 2

キーと値のペアの単純なセット。この例には次の要素があります。

  • キー:X
  • 値:1、2
  • セパレーター:=
  • キーと値のデリミター:&
複数のキーと値のペア(非シリアル型)
X = 1 & X = 2 & Y = 3 & Y = 4

複数のキーと値の組。個別のキーと値の組で値を渡します。この例には次の要素があります。

  • キー:X、Y
  • 値:1、2、3、4
  • セパレーター:=
  • キーと値のデリミター:&
シリアル型の単一キー
X = 1 ; 2 ; 3

1 つのキーと値の組。複数の値を 1 つのキーで渡します。このキーには複数の値があるので、「シリアル化されたキーと値のペア」と呼ばれています。この例には次の要素があります。

  • キー:X
  • 値:1、2、3
  • セパレーター:=
  • シリアル区切り文字:セミコロン
複数のキーと値のペア(シリアル型)
X = 1 ; 2 & Y = 3 ; 4

複数のキーと値のペアのセット。複数の値を個別のキーで渡します。この例には次の要素があります。

  • キー:X、Y
  • 値:1、2、3、4
  • セパレーター:=
  • 区切り:&
  • シリアル区切り文字:セミコロン

宛先のシリアル化 destination-serialized

宛先のシリアル化では、複数の特性を結合して単一の文字列にし、その情報を宛先に送信します。

シリアル化されたデータの送信は、複数の特性が同時にではなく連続して処理されるので、効率性の向上に役立ちます。これにより、追加のリクエストに応答する前に、データを受信し処理して返すのに十分な時間が宛先サーバーに提供されます。

サポートされる宛先

Audience Manager では、データをシリアル化して、対象となるほとんどあらゆる宛先に送信できます。ただし、この機能を使用する前に、宛先 URL と、必須またはオプションのマクロの挿入位置を知っておく必要があります。宛先パートナーから、マクロの位置に関する情報を入手します。詳しくは、宛先マクロの定義を参照してください。

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695