Переменные события для периметра и маяка
События входа и выхода дляпериметра и маяка - это события на основе местоположения, которыми можно управлять в 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 символов) |
Идентификатор региона/зоны. Регион или зона представляет собой логическую границу региона для отслеживания маркетологом. Часто в продуктах на основе определения местоположения периметры и маяки включаются в регионы или зоны. |
Необязательно |
| RSYS_GEN_ZONE_NAME |
Текст (максимальная длина 256 символов) |
Имя региона/зоны. Регион или зона представляет собой логическую границу региона для отслеживания маркетологом. Часто в продуктах на основе определения местоположения периметры и маяки включаются в регионы или зоны. |
Необязательно |
Периметр
| RSYS_GEN_FENCE_ID |
Текст (максимальная длина 256 символов) |
Идентификатор для периметра |
Обязат. |
| 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 символов) |
Идентификатор региона/зоны. Регион или зона представляет собой логическую границу региона для отслеживания маркетологом. Часто в продуктах на основе определения местоположения периметры и маяки включаются в регионы или зоны. |
Необязательно |
| RSYS_GEX_ZONE_NAME |
Текст (максимальная длина 256 символов) |
Имя региона/зоны.
Регион или зона представляет собой логическую границу региона для отслеживания маркетологом. Часто в продуктах на основе определения местоположения периметры и маяки включаются в регионы или зоны. |
Необязательно |
Периметр
| RSYS_GEX_FENCE_ID |
Текст (максимальная длина 256 символов) |
Идентификатор для периметра |
Обязат. |
| RSYS_GEX_FENCE_NAME |
Текст (максимальная длина 256 символов) |
Имя периметра |
Обязат. |
Время пребывания
| RSYS_GEX_DWELL_TIME |
Целое |
Время пребывания внутри периметра (в минутах/секундах). Единицы времени пребывания зависят от решения, используемого приложением. |
Необязательно |
Появление в диапазоне маяка
Источник и штамп времени события
| RSYS_BEN_TIME |
Дата/время
|
Время на устройстве, когда это событие было инициировано (часовой пояс UTC) |
Обязат. |
| RSYS_BEN_SOURCE |
Текст (максимальная длина 256 символов) |
Источник события. Разработчики приложений могут использовать этот атрибут для включения таких сведений, как имя SDK/решения для периметра и маяка, с которым они интегрированы, или название оборудования маяка. |
Необязательно |
Зона
| RSYS_BEN_ZONE_ID |
Текст (максимальная длина 256 символов) |
Идентификатор региона/зоны. Регион или зона представляет собой логическую границу региона для отслеживания маркетологом. Часто в продуктах на основе определения местоположения периметры и маяки включаются в регионы или зоны. |
Необязательно |
| RSYS_BEN_ZONE_NAME |
Текст (максимальная длина 256 символов) |
Имя региона/зоны.
Регион или зона представляет собой логическую границу региона для отслеживания маркетологом. Часто в продуктах на основе определения местоположения периметры и маяки включаются в регионы или зоны. |
Необязательно |
Маяк
| RSYS_BEN_BEACON_ID |
Текст (максимальная длина 256 символов) |
Идентификатор для маяка |
Обязат. |
| RSYS_BEN_BEACON_NAME |
Текст (максимальная длина 256 символов) |
Имя маяка |
Обязат. |
| RSYS_BEN_BEACON_TAG |
Текст (максимальная длина 256 символов) |
Любой тег для дальнейшей классификации этого маяка |
Необязательно |
iBeaconIdentifier
| RSYS_BEN_IBEACON_UUID |
Текст (максимальная длина 256 символов) |
UUID iBeacon |
Необязательно |
| RSYS_BEN_IBEACON_MAJOR |
Целое |
iBeacon Major |
Необязательно |
| RSYS_BEN_IBEACON_MINOR |
Целое |
iBeacon Minor |
Необязательно |
EddystoneIdentifier
| RSYS_BEN_EDDY_ID1 |
Текст (максимальная длина 256 символов) |
Eddystone или другой идентификатор 1 протокола |
Необязательно |
| RSYS_BEN_EDDY_ID2 |
Текст (максимальная длина 256 символов) |
Eddystone или другой идентификатор 2 протокола |
Необязательно |
Близость
| RSYS_BEN_PROXIMITY |
Текст (максимальная длина 256 символов) |
Близость по расстоянию устройства/пользователя от маяка. Возможные значения: рядом (I), близко (N), далеко (F), неизвестно (U) |
Необязательно |
Выход из диапазона маяка
Источник и штамп времени события
| RSYS_BEX_TIME |
Дата/время
|
Время на устройстве, когда это событие было инициировано (часовой пояс UTC) |
Обязат. |
| RSYS_BEX_SOURCE |
Текст |
Источник события. Разработчики приложений могут использовать этот атрибут для включения таких сведений, как имя SDK/решения для периметра и маяка, с которым они интегрированы, или название оборудования маяка. |
Необязательно |
Зона
| RSYS_BEX_ZONE_ID |
Текст (максимальная длина 256 символов) |
Идентификатор региона/зоны. Регион или зона представляет собой логическую границу региона для отслеживания маркетологом. Часто в продуктах на основе определения местоположения периметры и маяки включаются в регионы или зоны. |
Необязательно |
| RSYS_BEX_ZONE_NAME |
Текст (максимальная длина 256 символов) |
Имя региона/зоны.
Регион или зона представляет собой логическую границу региона для отслеживания маркетологом. Часто в продуктах на основе определения местоположения периметры и маяки включаются в регионы или зоны. |
Необязательно |
Маяк
| RSYS_BEX_BEACON_ID |
Текст (максимальная длина 256 символов) |
Идентификатор для маяка |
Обязат. |
| RSYS_BEX_BEACON_NAME |
Текст (максимальная длина 256 символов) |
Имя маяка |
Обязат. |
| RSYS_BEX_BEACON_TAG |
Текст (максимальная длина 256 символов) |
Любой тег для дальнейшей классификации этого маяка |
Необязательно |
iBeaconIdentifier
| RSYS_BEX_IBEACON_UUID |
Текст (максимальная длина 256 символов) |
UUID iBeacon |
Необязательно |
| RSYS_BEX_IBEACON_MAJOR |
Целое |
iBeacon Major |
Необязательно |
| RSYS_BEX_IBEACON_MINOR |
Целое |
iBeacon Minor |
Необязательно |
EddystoneIdentifier
| RSYS_BEX_EDDY_ID1 |
Текст (максимальная длина 256 символов) |
Eddystone или другой идентификатор 1 протокола |
Необязательно |
| RSYS_BEX_EDDY_ID2 |
Текст (максимальная длина 256 символов) |
Eddystone или другой идентификатор 2 протокола |
Необязательно |
Время пребывания
| RSYS_BEX_DWELL_TIME |
Целое |
Время, проведенное в непосредственной близости от маяка (в минутах/секундах). Единицы времени пребывания зависят от решения, используемого приложением. |
Необязательно |
См. также
Программа, периметр, маяк, REI, интерфейс событий responsys, интерфейс событий, geofence_entry, geofence_exit, beacon_entry, beacon_exit, переменная события, тип данных, вход, выход