Création de règles d’entrée et de sortie

Avec l'extension Places et les extensions Places Monitor installées dans votre application mobile, vous pouvez créer des règles en Adobe Experience Platform Launch qui sont des données d'emplacement déclenchées ou conditionnées, y compris les événements d'entrée et de sortie d'emplacement.

Règles

Vous pouvez configurer une règle composée d’un événement, d’une condition et d’une action. Chaque règle est composée des éléments suivants :

  • Un ou plusieurs événements
  • (Facultatif) conditions
  • Une ou plusieurs actions

Événements du service Places

Place les offres de service sur lesquelles vous pouvez exécuter une règle les événements suivants :

  • Saisissez l’API, qui est déclenchée par le SDK Places lorsque votre client entre dans l’API que vous avez configuré.
  • Quittez l’API, qui est déclenché par le SDK Places lorsque votre client quitte l’API que vous avez configuré.

Conditions du service Places

Les conditions définissent les critères que les données associées au événement, ou l’état partagé d’une extension à cette instance, doivent respecter pour que l’action soit entreprise. Par exemple, vous pouvez définir une condition pour déclencher une action sur une entrée dans un café uniquement dans la ville de San Francisco.

Le SDK Places conserve les états suivants :

  • IPE actuelle, qui fait référence à l’IPE dans laquelle se trouve actuellement votre client.
  • Dernier point d’intérêt de sortie, qui fait référence au point d’intérêt le plus récent que votre client a quitté.
  • Dernier POI saisi, qui fait référence au dernier POI saisi par votre client.

Chaque POI contient les éléments de données suivants :

  • Identifiant
  • Nom
  • Latitude/longitude
  • Rayon
  • Métadonnées telles que ville, pays, état, catégorie

Actions

Les actions définissent ce que l’application fera en réponse à la condition que la règle soit satisfaite pour le événement déclenché. Par exemple, lorsque votre client entre dans votre point d’accès, vous pouvez configurer un message de bienvenue pour qu’il s’affiche sur son périphérique mobile.

Créez une règle : un exemple

ATTENTION

Cet exemple implique que vous ayez créé une bibliothèque POI de tous les cafés aux États-Unis. For more information about creating POIs and libraries, see Create a POI and Create a Library in Manage multiple libraries.

La procédure suivante est un exemple de création d’une règle qui renvoie une publication au Slack lorsque vous entrez dans un café de San Francisco.

Le événement, la condition et l’action sont définis comme suit :

  • Événement: Place le événement d'entrée.
  • Condition : la ville du Point ciblé actuel est San Francisco
  • Action: Envoyez un postback au Slack le nom du café que votre client a entré.

Condition requise

Avant de créer une règle, vous devez créer un élément de données dans Adobe Experience Platform Launch. Les éléments de données renseignent automatiquement les informations nécessaires sur votre point d’intérêt dans le message postback.

Pour créer un élément de données dans l’Experience Platform Launch :

  1. Cliquez sur l’onglet Eléments de données.
  2. Click Add Data Element.
  3. Entrez un nom, par exemple, Current coffee shop name.
  4. In the Extension drop-down list, select Places – Beta.
  5. Dans Élément de données, sélectionnez Ville.
  6. Dans le volet de droite, sélectionnez Actuelle API.
  7. Cliquez sur Enregistrer.

Création d’une règle dans l’Experience Platform Launch pour le service Lieux

création d’une règle

  1. In Experience Platform Launch, click the Rules tab.
  2. Cliquez sur Add Rule.
  3. Tapez le nom de la règle, par exemple Track entry for coffee shop in SF.

Créez un événement

  1. In the Events section, click + Add. Les événements déterminent à quel moment la règle doit se déclencher.
  2. Dans la liste Extension déroulante, sélectionnez Places – Beta.
  3. Dans la liste Event Type déroulante, sélectionnez Enter POI.
  4. Dans Name, saisissez un nom pour le événement, par exemple Entering a coffee shop.
  5. Cliquez sur Keep Changes.

Créer une condition

  1. Dans la section Conditions, cliquez sur +Add. Les conditions déterminent quels critères doivent être respectés pour que l'action soit entreprise.
  2. In Logic Type, select Regular, which allows actions to execute if the condition is met.
  3. Dans la liste Extension déroulante, sélectionnez Places – Beta.
  4. In Condition Type, select City.
  5. Entrez un nom de condition, par exemple Coffee shop in SF.
  6. In the right pane, click Current POI, and in the drop-down list, select San Francisco as one of your cities.
  7. Cliquez sur Keep Changes.

Créer une action

  1. In the Actions section, click + Add.

  2. Dans la liste Extension déroulante, laissez l’ Mobile Core option par défaut sélectionnée.

  3. Sélectionnez un type d’action, par exemple Send Postback.

    a. Dans URL, saisissez l’URL de postback pour le Slack, par exemple https://hooks.slack.com/services/.

    b. Pour envoyer un corps de publication, cochez la Add Post Body case.

    c. Dans Post Body la section, ajoutez le corps de la poste, par exemple : { "text": "A customer has entered" }

    c. Entrez un type de contenu, par exemple application/json.

    d. Sélectionnez une valeur de délai d’expiration, par exemple 5.

  4. Cliquez sur Keep Changes.

Publier la règle

  1. Pour activer la règle, vous devez la publier. Pour plus d’informations sur la publication de votre règle dans l’Experience Platform Launch, voir Publication.

Penser au-delà des entrées et des sorties

L'utilisation d'entrées et de sorties de géolocalisation du service Places pour déclencher des règles dans l'Experience Platform Launch est incroyablement puissante, mais vous pouvez également utiliser les données d'emplacement comme condition pour que d'autres événements puissent se déclencher. Par exemple, vous pouvez avoir un déclencheur Mobile Core Track Action événement prêt à se déclencher en fonction d’un événement d’appel trackAction particulier dans votre application. En fonction de ce événement, vous pouvez placer des conditions d’emplacement supplémentaires dans le événement avant qu’une action ne soit exécutée. Par exemple, ouvrez un questionnaire intégré à l’application lorsqu’un trackAction événement d’achat se produit, mais ​uniquement si l’emplacement actuel de l’utilisateur inclut des métadonnées spécifiques du service Lieux.

créer une condition

Sur cette page