지오펜스 및 비콘 이벤트 변수

지오펜스비콘 시작 및 종료 이벤트는 REI에서 관리하고 프로그램에서 사용할 수 있는 위치 기반 이벤트입니다. 각 이벤트에 대해 앱 개발자는 Oracle Responsys에서 이벤트 API를 사용하여 앱에서 최대 5개의 선택적 키-값 쌍을 전달할 수 있습니다. 이러한 키-값 쌍을 통해 마케터와 앱 개발자는 표준 기본 제공 이벤트의 기능을 확장할 수 있습니다. 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자) 사용자/장치의 비콘 근접성. 가능한 값은 Immediate(I), Near(N), Far(F), Unknown(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, 이벤트 변수, 데이터 유형, 참가, 종료