ジオフェンスおよびビーコン・イベントの変数

ジオフェンスおよびビーコン・エントリ、そして終了イベントは、REIで管理してプログラムで使用できる場所ベースのイベントです。Oracle Responsysでは、アプリ開発者が各イベントにつき最大5つのオプションのキーと値のペアをアプリからイベントAPIを使用して渡すことができます。これらのキーと値のペアは、マーケタおよびアプリ開発者がすぐに使用できる標準イベントの機能を拡張するのに役立ちます。SDK側では、各キーと値のペアは最大256文字の文字列として渡されます。このオプションのデータをAPI呼出しの一部として渡す方法の詳細をここで参照してください。

Responsysプラットフォーム側で、必要な属性名およびタイプを持つ追加のカスタム変数を追加することにより、マーケタがREIイベントを拡張する必要があります。REIイベントが発生したときに、カスタム変数をプログラム・イベント変数としてプログラムで使用できます。

ジオフェンス・エントリ

イベントのタイムスタンプおよびソース

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_GEN_TIME 日付/時間 このイベントがトリガーされたときのデバイス上の時間(UTCタイム・ゾーン)

必須

RSYS_GEN_SOURCE テキスト(最大長256文字) イベントのソース。アプリ開発者はこの属性を使用して、統合したジオフェンスおよびビーコンSDK/ソリューションの名前やビーコン・ハードウェアの名前などの詳細を含めることを選択できます。 オプション

ゾーン

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_GEN_ZONE_ID テキスト(最大長256文字) リージョン/ゾーンのID。リージョンまたはゾーンは、マーケタがモニターするリージョンの論理的な境界を示します。場所ベースのサービス製品では、ジオフェンスおよびビーコンがリージョンまたはゾーンに含まれていることがよくあります。 オプション
RSYS_GEN_ZONE_NAME テキスト(最大長256文字) リージョン/ゾーンの名前。リージョンまたはゾーンは、マーケタがモニターするリージョンの論理的な境界を示します。場所ベースのサービス製品では、ジオフェンスおよびビーコンがリージョンまたはゾーンに含まれていることがよくあります。 オプション

ジオフェンス

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_GEN_FENCE_ID テキスト(最大長256文字) ジオフェンスのID 必須
RSYS_GEN_FENCE_NAME テキスト(最大長256文字) ジオフェンスの名前 必須

デバイス・モーション

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_GEN_DEVICE_SPEED 数字 ジオフェンス移行がトリガーされたときのデバイスの速度。単位は、アプリが使用しているジオフェンスSDK/ソリューションによって異なります。 オプション
RSYS_GEN_DEVICE_BEARING 数字 ジオフェンス移行がトリガーされたときのデバイスの移動の方位/方向。方位は、通常、移動の水平方向であり、度数で計測されます。 オプション

ジオフェンス出口

イベントのタイムスタンプおよびソース

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_GEX_TIME 日付/時間 このイベントがトリガーされたときのデバイス上の時間(UTCタイム・ゾーン) 必須
RSYS_GEX_SOURCE テキスト(最大長256文字) イベントのソースの内容。アプリ開発者はこの属性を使用して、統合したジオフェンスおよびビーコンSDK/ソリューションの名前やビーコン・ハードウェアの名前などの詳細を含めることを選択できます。 オプション

ゾーン

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_GEX_ZONE_ID テキスト(最大長256文字) リージョン/ゾーンのID。リージョンまたはゾーンは、マーケタがモニターするリージョンの論理的な境界を示します。場所ベースのサービス製品では、ジオフェンスおよびビーコンがリージョンまたはゾーンに含まれていることがよくあります。 オプション
RSYS_GEX_ZONE_NAME テキスト(最大長256文字) リージョン/ゾーンの名前。
リージョンまたはゾーンは、マーケタがモニターするリージョンの論理的な境界を示します。場所ベースのサービス製品では、ジオフェンスおよびビーコンがリージョンまたはゾーンに含まれていることがよくあります。
オプション

ジオフェンス

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_GEX_FENCE_ID テキスト(最大長256文字) ジオフェンスのID 必須
RSYS_GEX_FENCE_NAME テキスト(最大長256文字) ジオフェンスの名前 必須

休止時間

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_GEX_DWELL_TIME 整数 ジオフェンスの内側で費やされた時間(分/秒)。休止時間の単位は、アプリが使用しているソリューションによって異なります。 オプション

ビーコン・エントリ

イベントのタイムスタンプおよびソース

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEN_TIME 日付/時間 このイベントがトリガーされたときのデバイス上の時間(UTCタイム・ゾーン) 必須
RSYS_BEN_SOURCE テキスト(最大長256文字) イベントのソースの内容。アプリ開発者はこの属性を使用して、統合したジオフェンスおよびビーコンSDK/ソリューションの名前やビーコン・ハードウェアの名前などの詳細を含めることを選択できます。 オプション

ゾーン

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEN_ZONE_ID テキスト(最大長256文字) リージョン/ゾーンのID。リージョンまたはゾーンは、マーケタがモニターするリージョンの論理的な境界を示します。場所ベースのサービス製品では、ジオフェンスおよびビーコンがリージョンまたはゾーンに含まれていることがよくあります。 オプション
RSYS_BEN_ZONE_NAME テキスト(最大長256文字) リージョン/ゾーンの名前。
リージョンまたはゾーンは、マーケタがモニターするリージョンの論理的な境界を示します。場所ベースのサービス製品では、ジオフェンスおよびビーコンがリージョンまたはゾーンに含まれていることがよくあります。
オプション

ビーコン

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEN_BEACON_ID テキスト(最大長256文字) ビーコンのID 必須
RSYS_BEN_BEACON_NAME テキスト(最大長256文字) ビーコンの名前 必須
RSYS_BEN_BEACON_TAG テキスト(最大長256文字) このビーコンをさらに分類するタグ オプション

iBeaconIdentifier

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEN_IBEACON_UUID テキスト(最大長256文字) iBeacon UUID オプション
RSYS_BEN_IBEACON_MAJOR 整数 iBeaconメジャー オプション
RSYS_BEN_IBEACON_MINOR 整数 iBeaconマイナー オプション

EddystoneIdentifier

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEN_EDDY_ID1 テキスト(最大長256文字) Eddystoneまたは他のプロトコルID1 オプション
RSYS_BEN_EDDY_ID2 テキスト(最大長256文字) Eddystoneまたは他のプロトコルID2 オプション

近接性

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEN_PROXIMITY テキスト(最大長256文字) ビーコンからのユーザー/デバイスの近接性。可能な値は次のとおりです: 即時(I)、近い(N)、遠い(F)、不明(U) オプション

ビーコン出口

イベントのタイムスタンプおよびソース

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEX_TIME 日付/時間 このイベントがトリガーされたときのデバイス上の時間(UTCタイム・ゾーン) 必須
RSYS_BEX_SOURCE テキスト イベントのソースの内容。アプリ開発者はこの属性を使用して、統合したジオフェンスおよびビーコンSDK/ソリューションの名前やビーコン・ハードウェアの名前などの詳細を含めることを選択できます。 オプション

ゾーン

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEX_ZONE_ID テキスト(最大長256文字) リージョン/ゾーンのID。リージョンまたはゾーンは、マーケタがモニターするリージョンの論理的な境界を示します。場所ベースのサービス製品では、ジオフェンスおよびビーコンがリージョンまたはゾーンに含まれていることがよくあります。 オプション
RSYS_BEX_ZONE_NAME テキスト(最大長256文字) リージョン/ゾーンの名前。
リージョンまたはゾーンは、マーケタがモニターするリージョンの論理的な境界を示します。場所ベースのサービス製品では、ジオフェンスおよびビーコンがリージョンまたはゾーンに含まれていることがよくあります。
オプション

ビーコン

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEX_BEACON_ID テキスト(最大長256文字) ビーコンのID 必須
RSYS_BEX_BEACON_NAME テキスト(最大長256文字) ビーコンの名前 必須
RSYS_BEX_BEACON_TAG テキスト(最大長256文字) このビーコンをさらに分類するタグ オプション

iBeaconIdentifier

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEX_IBEACON_UUID テキスト(最大長256文字) iBeacon UUID オプション
RSYS_BEX_IBEACON_MAJOR 整数 iBeaconメジャー オプション
RSYS_BEX_IBEACON_MINOR 整数 iBeaconマイナー オプション

EddystoneIdentifier

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEX_EDDY_ID1 テキスト(最大長256文字) Eddystoneまたは他のプロトコルID1 オプション
RSYS_BEX_EDDY_ID2 テキスト(最大長256文字) Eddystoneまたは他のプロトコルID2 オプション

休止時間

プログラム・イベント変数名 プログラム・イベント変数のデータ型 説明 必須フィールド
RSYS_BEX_DWELL_TIME 整数 ビーコンの近くで費やされた時間(分/秒)。休止時間の単位は、アプリが使用しているソリューションによって異なります。 オプション

関連項目

プログラム, ジオフェンス, ビーコン, REI, Responsysイベント・インタフェース, イベント・インタフェース, geofence_entry, geofence_exit, beacon_entry, beacon_exit, イベント変数, データ型, エントリ, 出口