Send追加イベントデータ

::::タブ:::tab{title="2.1"}

extデータ拡張オブジェクトを使うことで、イベントに追加データを提供できます。

以下はイベントデータ拡張の使用に関するガイドラインの一覧です:

• イベントタイプごとにサポートされるデータ拡張は1つだけです。
• イベントデータ拡張オブジェクトの名前は extでなければなりません。
• イベントデータ拡張オブジェクトは最大50の属性を持つことができます。

以下は、extデータ拡張オブジェクトで属性を使用する際のガイドラインの一覧です。

• 属性名はJSON RFC 7159仕様に従い、英数字A-Z,a-z,0-9でなければなりません。

• データ拡張の属性名はキャメルケースで書かなければなりません。

• 属性名はイベントタイプ全体の中で一意でなければなりません。

• 属性名を意味のあるものにすることをおすすめします。

  friendlyIDの使用を検討してみてください。

• グループ化が必要な場合は、共通の接頭辞を使用してください。

以下の表は必要なクエリパラメータを示しています:

属性

概要

ext

イベント拡張データのJSONオブジェクトです。

ext.attribute

カスタムデータ用の名前と値のペア。名前は指定された属性命名ガイドラインに従う必要があります。以下のデータ型がサポートされています:

• 文字列: "Hello"
• ブール値: true または false
• 整数: 9
• フロート: 99.9

!警告特定のイベントタイプ(例

)を送信する際、異なるデータ型で同じ属性名を使ってはいけません。

例えば、VIEWイベントを送信する場合は、extオブジェクトの属性値に使うデータ型がすべてのVIEWイベントで一貫していることを確認してください。

例57。 extオブジェクトを含むイベントデータを表示します

{ "type": "VIEW", "channel": "WEB", "pos": "myretailsite/ireland", "browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​", "language": "EN", "currency": "EUR", "page": "home page", "ext": { "tileRef": 17 } }

例58。VIEWイベントを送信時の競合

これら2つの例は、VIEWイベントを送信する際の競合を表しています。この衝突は、同じ属性名(status)が最初の例では整数値を含むが、2つ目の例では文字列値が含まれているため発生します。

{ "type":"VIEW", "ext":{ "status": 0 } }

{ "type":"VIEW", "ext":{ "status": "OK" } }