Variables des événements Limite virtuelle et Beacon

Les événements d'entrée et de sortie de limite virtuelle et de beacon sont des événements basés sur la localisation, que vous pouvez gérer sur l'interface REI et utiliser dans Program. Pour chaque événement, Oracle Responsys permet au développeur de l'application de transmettre jusqu'à 5 paires clé-valeur facultatives depuis l'application à l'aide des API d'événement. Ces paires clé-valeur permettent aux spécialistes marketing et aux développeurs d'applications d'étendre la fonctionnalité des événements standard prêts à l'emploi. Côté SDK, chaque paire clé-valeur est transmise sous la forme d'une chaîne composée de 256 caractères maximum. Pour en savoir plus sur l'envoi de ces données facultatives dans le cadre des appels d'API, cliquez ici.

Côté plate-forme Responsys, les spécialistes marketing peuvent étendre l'événement REI en ajoutant des variables personnalisées supplémentaires avec le nom et le type d'attribut souhaités. Lorsqu'un événement REI est déclenché, les variables personnalisées sont disponibles dans Program sous forme de variables d'événement de programme.

Entrée dans une limite virtuelle

Horodatage et source de l'événement

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_GEN_TIME Date/heure Date et heure, sur l'appareil, auxquelles cet événement a été déclenché (UTC)

Obligatoire

RSYS_GEN_SOURCE Texte (256 caractères maximum) Source de l'événement. Les développeurs d'applications peuvent choisir d'utiliser cet attribut pour inclure des détails comme le nom de la solution ou du SDK de limite virtuelle et de beacon intégré(e), ou le nom de l'équipement de beacon. Facultatif

Zone

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_GEN_ZONE_ID Texte (256 caractères maximum) ID de la région/zone. Une région ou une zone représente la frontière logique d'une région qu'un spécialiste marketing souhaite surveiller. Souvent, dans les produits/services basés sur la localisation, les limites virtuelles et les beacons sont inclus dans les régions ou zones. Facultatif
RSYS_GEN_ZONE_NAME Texte (256 caractères maximum) Nom de la région/zone. Une région ou une zone représente la frontière logique d'une région qu'un spécialiste marketing souhaite surveiller. Souvent, dans les produits/services basés sur la localisation, les limites virtuelles et les beacons sont inclus dans les régions ou zones. Facultatif

Limite virtuelle

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_GEN_FENCE_ID Texte (256 caractères maximum) ID de la limite virtuelle Obligatoire
RSYS_GEN_FENCE_NAME Texte (256 caractères maximum) Nom de la limite virtuelle Obligatoire

Vitesse de l'appareil

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_GEN_DEVICE_SPEED Nombre Vitesse de l'appareil au moment du déclenchement de l'événement de limite virtuelle. Les unités dépendent de la solution ou du SDK de limite virtuelle utilisé(e) par l'application. Facultatif
RSYS_GEN_DEVICE_BEARING Nombre Azimut / direction de déplacement de l'appareil au moment du déclenchement de l'événement de limite virtuelle. L'azimut correspond généralement à la direction déplacement horizontale et est mesuré en degrés. Facultatif

Sortie d'une limite virtuelle

Horodatage et source de l'événement

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_GEX_TIME Date/heure Date et heure, sur l'appareil, auxquelles cet événement a été déclenché (UTC) Obligatoire
RSYS_GEX_SOURCE Texte (256 caractères maximum) Source de l'événement. Les développeurs d'applications peuvent choisir d'utiliser cet attribut pour inclure des détails comme le nom de la solution ou du SDK de limite virtuelle et de beacon intégré(e), ou le nom de l'équipement de beacon. Facultatif

Zone

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_GEX_ZONE_ID Texte (256 caractères maximum) ID de la région/zone. Une région ou une zone représente la frontière logique d'une région qu'un spécialiste marketing souhaite surveiller. Souvent, dans les produits/services basés sur la localisation, les limites virtuelles et les beacons sont inclus dans les régions ou zones. Facultatif
RSYS_GEX_ZONE_NAME Texte (256 caractères maximum) Nom de la région/zone.
Une région ou une zone représente la frontière logique d'une région qu'un spécialiste marketing souhaite surveiller. Souvent, dans les produits/services basés sur la localisation, les limites virtuelles et les beacons sont inclus dans les régions ou zones.
Facultatif

Limite virtuelle

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_GEX_FENCE_ID Texte (256 caractères maximum) ID de la limite virtuelle Obligatoire
RSYS_GEX_FENCE_NAME Texte (256 caractères maximum) Nom de la limite virtuelle Obligatoire

Temps de séjour

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_GEX_DWELL_TIME Nombre entier Temps passé à l'intérieur de la limite virtuelle (en minutes/secondes). Les unités du temps de séjour dépendent de la solution utilisée par l'application. Facultatif

Entrée dans un beacon

Horodatage et source de l'événement

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEN_TIME Date/heure Date et heure, sur l'appareil, auxquelles cet événement a été déclenché (UTC) Obligatoire
RSYS_BEN_SOURCE Texte (256 caractères maximum) Source de l'événement. Les développeurs d'applications peuvent choisir d'utiliser cet attribut pour inclure des détails comme le nom de la solution ou du SDK de limite virtuelle et de beacon intégré(e), ou le nom de l'équipement de beacon. Facultatif

Zone

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEN_ZONE_ID Texte (256 caractères maximum) ID de la région/zone. Une région ou une zone représente la frontière logique d'une région qu'un spécialiste marketing souhaite surveiller. Souvent, dans les produits/services basés sur la localisation, les limites virtuelles et les beacons sont inclus dans les régions ou zones. Facultatif
RSYS_BEN_ZONE_NAME Texte (256 caractères maximum) Nom de la région/zone.
Une région ou une zone représente la frontière logique d'une région qu'un spécialiste marketing souhaite surveiller. Souvent, dans les produits/services basés sur la localisation, les limites virtuelles et les beacons sont inclus dans les régions ou zones.
Facultatif

Beacon

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEN_BEACON_ID Texte (256 caractères maximum) ID du beacon Obligatoire
RSYS_BEN_BEACON_NAME Texte (256 caractères maximum) Nom du beacon Obligatoire
RSYS_BEN_BEACON_TAG Texte (256 caractères maximum) Balise qui permet de classer ce beacon Facultatif

iBeaconIdentifier

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEN_IBEACON_UUID Texte (256 caractères maximum) UUID du iBeacon Facultatif
RSYS_BEN_IBEACON_MAJOR Nombre entier Valeur majeure du iBeacon Facultatif
RSYS_BEN_IBEACON_MINOR Nombre entier Valeur mineure du iBeacon Facultatif

EddystoneIdentifier

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEN_EDDY_ID1 Texte (256 caractères maximum) ID1 Eddystone ou autre protocole Facultatif
RSYS_BEN_EDDY_ID2 Texte (256 caractères maximum) ID2 Eddystone ou autre protocole Facultatif

Proximité

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEN_PROXIMITY Texte (256 caractères maximum) Proximité de l'utilisateur/appareil par rapport au beacon. Les valeurs possibles sont : Immediate (I), Near (N), Far (F), Unknown (U) Facultatif

Sortie d'un beacon

Horodatage et source de l'événement

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEX_TIME Date/heure Date et heure, sur l'appareil, auxquelles cet événement a été déclenché (UTC) Obligatoire
RSYS_BEX_SOURCE Texte Source de l'événement. Les développeurs d'applications peuvent choisir d'utiliser cet attribut pour inclure des détails comme le nom de la solution ou du SDK de limite virtuelle et de beacon intégré(e), ou le nom de l'équipement de beacon. Facultatif

Zone

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEX_ZONE_ID Texte (256 caractères maximum) ID de la région/zone. Une région ou une zone représente la frontière logique d'une région qu'un spécialiste marketing souhaite surveiller. Souvent, dans les produits/services basés sur la localisation, les limites virtuelles et les beacons sont inclus dans les régions ou zones. Facultatif
RSYS_BEX_ZONE_NAME Texte (256 caractères maximum) Nom de la région/zone.
Une région ou une zone représente la frontière logique d'une région qu'un spécialiste marketing souhaite surveiller. Souvent, dans les produits/services basés sur la localisation, les limites virtuelles et les beacons sont inclus dans les régions ou zones.
Facultatif

Beacon

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEX_BEACON_ID Texte (256 caractères maximum) ID du beacon Obligatoire
RSYS_BEX_BEACON_NAME Texte (256 caractères maximum) Nom du beacon Obligatoire
RSYS_BEX_BEACON_TAG Texte (256 caractères maximum) Balise qui permet de classer ce beacon Facultatif

iBeaconIdentifier

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEX_IBEACON_UUID Texte (256 caractères maximum) UUID du iBeacon Facultatif
RSYS_BEX_IBEACON_MAJOR Nombre entier Valeur majeure du iBeacon Facultatif
RSYS_BEX_IBEACON_MINOR Nombre entier Valeur mineure du iBeacon Facultatif

EddystoneIdentifier

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEX_EDDY_ID1 Texte (256 caractères maximum) ID1 Eddystone ou autre protocole Facultatif
RSYS_BEX_EDDY_ID2 Texte (256 caractères maximum) ID2 Eddystone ou autre protocole Facultatif

Temps de séjour

Nom de la variable d'événement de programme Type de données de la variable d'événement de programme Description Champ obligatoire
RSYS_BEX_DWELL_TIME Nombre entier Temps passé à proximité du beacon (en minutes/secondes). Les unités du temps de séjour dépendent de la solution utilisée par l'application. Facultatif

Documentation connexe

Program, limite virtuelle, beacon, REI, responsys event interface, event interface, geofence_entry, geofence_exit, beacon_entry, beacon_exit, variable d'événement, type de données, entrée, sortie