DocumentationDocumentation de Campaign Standard

Configuration des règles de balise pour la prise en charge des cas pratiques Adobe Campaign Standard. configuring-rules-launch

Last update: Tue Mar 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Experienced
  • Admin

Dans l’interface utilisateur de collecte de données, créez des éléments de données et des règles pour envoyer les informations d’identification personnelles et d’autres données depuis les applications mobiles vers Adobe Campaign Standard.

Pour que toutes les modifications apportées à la configuration de l’interface utilisateur de collecte de données prennent effet, vous devez les publier. Pour plus d'informations, voir la section Publication.

Pour créer des règles dans l’interface utilisateur de collecte de données, procédez comme suit :

  1. Création d'éléments de données

  2. Création de règles pour les cas pratiques que vous souhaitez prendre en charge :

Création d'éléments de données create-data-elements

Voici les éléments de données que nous vous recommandons de créer dans l’interface utilisateur de collecte de données.
Vous pouvez créer des éléments de données supplémentaires en fonction de vos besoins.

  • Identifiant Experience Cloud
  • Pkey
  • Serveur Campaign

Pour créer ces éléments de données, procédez comme suit :

  1. Dans l’interface utilisateur de collecte de données, dans le tableau de bord de votre application mobile, cliquez sur le bouton Éléments de données .

  2. Pour créer l’élément de données Identifiant Experience Cloud, cliquez sur Create New Data Element.

  3. Dans le champ Name, saisissez par exemple mcid.

  4. Dans la liste déroulante Extension, sélectionnez Mobile Core. Sélectionnez ensuite Experience Cloud ID dans la liste déroulante de type Data element.

  5. Pour créer l'élément de données Pkey, cliquez sur Add data element.

  6. Dans le champ Name, saisissez par exemple pkey.

  7. Dans la liste déroulante Extension, sélectionnez Adobe Campaign Standard. Sélectionnez ensuite pkey dans la liste déroulante de type Data element.

  8. Pour créer l'élément de données Serveur Campaign, cliquez sur Add data element.

  9. Dans le champ Name, saisissez un nom, par exemple, camp-server.

  10. Dans la liste déroulante Extension, sélectionnez Adobe Campaign Standard. Sélectionnez ensuite Campaign Server dans la liste déroulante de type Data element.

Création de règles creating-rules

Vous devez créer des règles pour les situations suivantes :

Postback des informations d'identification personnelles pii-postback

NOTE
Pour envoyer des informations d’identification personnelle d’une application mobile à Adobe Campaign, vous devez mettre en œuvre une API SDK. Voir à ce sujet la section CollectPII.

Pour envoyer des données de PII à Adobe Campaign Standard, créez une règle dans l’interface utilisateur de collecte de données :

  1. Dans l’interface utilisateur de collecte de données, depuis le tableau de bord de votre application mobile, cliquez sur l'onglet Règles, puis Créer une règle.

  2. Saisissez un nom, par exemple, Mobile Core - Collect PII.

  3. Dans la section Events, cliquez sur Add.

  4. Dans la liste déroulante Extension, sélectionnez Mobile Core. Sélectionnez ensuite Collect PII dans la liste déroulante Event type.

  5. Cliquez sur Keep changes.

  6. Dans la section Actions, cliquez sur Add.

  7. Dans la liste déroulante Extension, sélectionnez Mobile Core. Ensuite, sélectionnez Send PII dans la liste déroulante Action type.

  8. Dans URL, saisissez l'URL suivante :

    code language-none 
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}

  9. Cochez la case Add Post Body.

  10. Dans Post Body, saisissez ce qui suit :

    code language-none 
    {
"marketingCloudId":
"{%%mcid%%}",
"pushPlatform":
"{%contextdata.pushPlatform%}",
"cusEmail":
"{%contextdata.email%}",
"cusFirstName":
"{%contextdata.firstName%}",
"cusLastName":
"{%contextdata.lastName%}" }

    Le paramètre marketingCloudId vous permet de faire concorder les personnes abonnées à votre application avec les destinataires dans la base de données. À ce titre, il est obligatoire. Vous pouvez spécifier d'autres paires clé-valeur en fonction des besoins de votre entreprise. Dans l'exemple ci-dessus, les informations E-mail, Prénom et Nom sont transmises depuis l'application.

    Les clés (par exemple cusEmail, cusFirstName et cusLastName) doivent correspondre aux ID de champ définis dans votre ressource personnalisée dans l’instance Adobe Campaign Standard. Les variables de valeur (par exemple, e-mail, firstName et LastName) doivent correspondre aux clés contenues dans les données JSON envoyées à partir de l'application mobile lors de l'appel de l'API AMS collectPII depuis le code de l'application.

    Vous pouvez également transmettre des données de cycle de vie dans le postback Collect PII ou dans un autre postback, en fonction de vos déclencheurs d'événement. Voici un exemple des données de cycle de vie JSON :

    code language-none 
    {
"marketingCloudId":"{%%mcid%%}",
"pushPlatform":"{%contextdata.pushPlatform%}",
"cusDayslastlaunch": "{%%DaysSinceLastUse%%}",
"cusDaysfirstlaunch": "{%%DaysSinceFirstUse%%}",
"cusLaunches": "{%%Launches%%}"
}

    Les éléments de données définis dans l’interface utilisateur de collecte de données doivent être inclus entre doubles pourcentages, par exemple %%mcid%%, et les variables contextuelles de l'application doivent être incluses entre pourcentages simples, par exemple %contextdata.email%.

  11. Dans Content Type, saisissez application/json.

  12. Dans Timeout, sélectionnez 0.

Vos données utilisateur sont maintenant configurées pour être envoyées à Campaign.

Postback de tracking In-App inapp-tracking-postback

NOTE
Si vous utilisez Android ACPCore v1.4.0 ou une version ultérieure/iOS ACPCore v2.3.0 ou une version ultérieure, la configuration des postbacks de suivi n’est pas requise.

Pour envoyer des données de tracking à Adobe Campaign Standard afin d’indiquer comment vos utilisateurs interagissent avec les messages In-App dans votre application mobile, créez la règle suivante dans l’interface utilisateur de collecte de données :

  1. Dans l’interface utilisateur de collecte de données, depuis le tableau de bord de votre application mobile, sélectionnez l'onglet Règles et cliquez sur Ajouter une règle.

  2. Saisissez un nom, par exemple, Adobe Campaign - Tracking des clics In-App.

  3. Dans la section Events, cliquez sur Add.

  4. Dans la liste déroulante Extension, sélectionnez Adobe Campaign Standard. Sélectionnez ensuite Tracking des clics In-App dans la liste déroulante Event type.

  5. Cliquez sur Keep changes.

  6. Dans la section Actions, cliquez sur Add.

  7. Dans la liste déroulante Extension, sélectionnez Mobile Core. Ensuite, sélectionnez Send postback dans la liste déroulante Event type.

  8. Dans URL, renseignez l'URL suivante :

    code language-none 
    https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}

  9. Cochez la case Add post body.

  10. Dans Post Body, saisissez {}.

  11. Dans Content Type, saisissez application/json.

  12. Dans Timeout, sélectionnez 0.

Postback de tracking des notifications push push-tracking-postback

NOTE
Si vous utilisez Android ACPCore v1.4.0 ou une version ultérieure/iOS ACPCore v2.3.0 ou une version ultérieure, la configuration des postbacks de suivi n’est pas requise.

Pour envoyer des données de tracking à Adobe Campaign Standard afin de suivre vos diffusions de notifications push et l’interaction de vos utilisateurs avec votre application mobile, vous devez créer une règle dans l’interface utilisateur de collecte de données.

Pour plus d'informations sur le tracking des messages push, voir la section Tracking des messages push.

Pour tracker les actions de l'application, utilisez l'API trackAction. Pour plus d'informations, voir la section Tracker les actions de l'application.

  1. Dans l’interface utilisateur de collecte de données, depuis le tableau de bord de votre application mobile, cliquez sur l'onglet Règles, puis cliquez sur Créer une règle.

  2. Saisissez un nom, par exemple, Adobe Campaign - Tracking des clics push.

  3. Dans la section Events, cliquez sur Add.

  4. Dans la liste déroulante Extension, sélectionnez Mobile Core. Ensuite, sélectionnez Track Action dans la liste déroulante Event type.

  5. Dans la liste déroulante Action, sélectionnez Action, puis equals et saisissez tracking.

  6. Cliquez sur Keep changes. Puis, dans la section Actions, cliquez sur Add.

  7. Dans la liste déroulante Extension, sélectionnez Mobile Core. Ensuite, sélectionnez Send postback dans la liste déroulante Action type.

  8. Dans URL, saisissez l'URL suivante :

    code language-none 
    https://{%%camp-server%%}/r/?id={%contextdata.broadlogId%},{%contextdata.deliveryId%},{%contextdata.action%}&mcId={%%mcid%%}

  9. Cochez la case Add post body.

  10. Ajoutez votre corps de publication, par exemple, { }.

  11. Dans Content Type, saisissez application/json.

  12. Dans Timeout, sélectionnez 0.

Postback de l'emplacement location-postback

  1. Dans l’interface utilisateur de collecte de données, depuis le tableau de bord de votre application mobile, cliquez sur l'onglet Règles, puis cliquez sur Créer une règle.

  2. Entrez un nom, par exemple, Postback de l'emplacement.

  3. Dans la section Events, cliquez sur Add.

  4. Créez un événement, par exemple, Entrée dans un point ciblé ou Sortie d'un point ciblé. Dans la liste déroulante Extension, sélectionnez Places - Version bêta. Ensuite, Enter POI ou Exit POI dans la liste déroulante Event type.

  5. Entrez un nom, par exemple, Places - Version bêta - Entrée dans un point ciblé ou Sortie d'un point ciblé.

  6. Dans la section Actions, cliquez sur Add.

  7. Dans la liste déroulante Extension, sélectionnez Mobile Core. Ensuite, sélectionnez Send postback dans la liste déroulante Action type.

  8. Saisissez un nom, par exemple, Mobile Core - Envoyer le postback de l'emplacement.

  9. Dans URL, saisissez l'URL suivante :

    code language-none 
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/

  10. Cochez la case Add post body et ajoutez votre corps de publication, par exemple :

    code language-none 
    {
"locationData": {
    "distances": "{%%Distance%%}",
    "poiLabel": "{%%POILabel%%}",
    "latitude": "{%%Latitude%%}",
    "longitude": "{%%Longitude%%}",
    "appId": "{%%AppId%%}",
    "marketingCloudId": "{%%ECID%%}"
}
}
    note note
    NOTE
    Dans l’exemple ci-dessus, les éléments de données situés à droite doivent être configurés dans l’interface utilisateur de collecte de données en suivant les étapes requises pour la Création d’éléments de données. Les éléments de données situés à gauche sont pris en charge dans Adobe Campaign Standard et n’ont pas besoin de configuration. Si vous avez besoin de données supplémentaires, vous devez incorporer des extensions de ressources personnalisées dans Adobe Campaign Standard.

  11. Dans Content Type, saisissez application/json.

  12. Dans Timeout, sélectionnez 5.

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff