Переменные события для периметра и маяка

События входа и выхода дляпериметра и маяка - это события на основе местоположения, которыми можно управлять в 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, переменная события, тип данных, вход, выход