追加のイベントデータSend
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
イベントで追加のデータを提供するには、extデータエクステンションオブジェクトを使用します。
次に、イベント データ拡張機能の使用に関するガイドラインの一覧を示します。
-
イベントタイプごとにサポートされるデータエクステンションは1つだけです。
-
イベントデータエクステンションオブジェクトの名前はextにする必要があります。
-
イベントデータエクステンションオブジェクトには、最大50個の属性を含めることができます。
次に、extデータエクステンションオブジェクトで属性を使用するためのガイドラインを示します。
-
属性名は、JSON RFC 7159仕様に従って、英数字 A-Z、a-z、0-9 である必要があります。
-
データエクステンションの属性名はキャメルケースで記述する必要があります。
-
属性名は、イベントタイプ全体で一意である必要があります。
-
属性名は意味のあるものにすることをお勧めします。
friendlyIDの使用を検討してください。
-
グループ化が必要な場合は、共通のプレフィックスを使用します。
次の表に、必要なクエリ パラメーターを示します。
|
属性 |
形容 |
|---|---|
|
ext |
イベント拡張データのJSONオブジェクト。 |
|
ext.attribute |
カスタムデータの名前と値のペア。名前は、指定された属性命名ガイドラインに従う必要があります。値でサポートされているデータ型は次のとおりです。
|
特定のイベント・タイプ (VIEWとIDENTITYなど) を送信するときに、異なるデータ・タイプで同じ属性名を使用しないでください。
たとえば、VIEWイベントを送信する場合は、extオブジェクトの属性値に使用するデータ型がすべてのVIEWイベントで一貫していることを確認します。
{ "type": "VIEW", "channel": "WEB", "pos": "myretailsite/ireland", "browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925", "language": "EN", "currency": "EUR", "page": "home page", "ext": { "tileRef": 17 } }
この2つの例は、VIEWイベントを送信するときの競合を示しています。競合が発生するのは、同じ属性名 (status) に最初の例には整数値が含まれ、2番目の例には文字列値が含まれているためです。
{ "type":"VIEW", "ext":{ "status": 0 } }
{ "type":"VIEW", "ext":{ "status": "OK" } }
2.0データ モデル では、この機能はサポートされていません。