Fichier de configuration JSON ADBMobile

Ces informations vous aideront à utiliser le fichier de configuration ADBMobile.json.

Référence du fichier de configuration ADBMobileConfig.json

Vous pouvez utiliser le même fichier de configuration pour votre application sur différentes plateformes :

• acquisition

  Permet l’acquisition des applications mobiles.

  Si cette section manque, activez l’acquisition de l’application mobile et téléchargez à nouveau le fichier de configuration du SDK. Pour plus d’informations, voir referrerTimeout ci-dessous.

  • server : serveur d’acquisition vérifié au lancement initial et devant contenir un référent d’acquisition.
  • appid : identifiant généré qui permet d’identifier de manière unique cette application sur le serveur d’acquisition.
  • Version minimale du SDK : 4.1

• analyticsForwardingEnabled

  Propriété dans l’objet audienceManager. Si Audience Manager est configuré et que analyticsForwardingEnabled est défini sur true, tout le trafic Analytics est également transféré à Audience Manager. La valeur par défaut est false.

  • Version minimale du SDK : 4.8.0

• backdateSessionInfo

  Active/désactive la capacité pour le SDK Adobe d’antidater les accès aux informations de session.

  Les accès aux informations de session comprennent actuellement les blocages et la durée de session et peuvent être activés ou désactivés.

  • Si vous définissez la valeur sur false, les accès sont désactivés.

    Le SDK reprend le même comportement qu’avant la version 4.1, ce qui consiste à regrouper les informations de session de la session précédente avec le premier accès de la session suivante. Le SDK Adobe associe également les informations de session au cycle de vie actuel, ce qui évite la création d’une visite exagérée. Comme les visites exagérées ne sont plus créées, le nombre de visites diminue immédiatement.

  • Si vous ne spécifiez aucune valeur, la valeur par défaut est true et les accès sont activés.

    Lorsque les accès sont activés, le SDK Adobe antidate l’accès aux informations de session à 1 seconde après l’accès final de la session précédente. Cela signifie que les données de blocage et de session seront corrélées avec la date correcte à laquelle elles se sont produites. Un effet secondaire est que le SDK peut créer une visite pour l’accès antidaté. Une correspondance subit un effet rétroactif à chaque nouveau lancement de l’application.

  • Version minimale du SDK : 4.6

  IMPORTANT

  Les informations d’accès aux sessions antidatées sont envoyées dans un appel de serveur d’informations de session et des appels de serveur supplémentaires peuvent être requis.

• batchLimit

  Nombre limite d’accès pouvant faire l’objet d’appels consécutifs. Si, par exemple, batchLimit est défini sur 10, chaque accès précédant le 10e accès est placé en file d’attente. Lorsque le 10e accès intervient, les 10 accès sont tous envoyés consécutivement.

  • La valeur par défaut est 0, ce qui signifie que le traitement par lot n’est pas activé.
  • Nécessite offlineEnabled = true.
  • Version minimale du SDK : 4.1

• charset

  Définit le jeu de caractères que vous utilisez pour les données envoyées à Analytics. La variable charset est utilisée pour convertir des données entrantes au format UTF-8 pour stockage et création de rapports. Pour plus d’informations, voir charSet dans la documentation Adobe Analytics.

  • Version minimale du SDK : 4.0

• clientCode

  Code client qui vous a été attribué.

  IMPORTANT

  Cette variable est requise par Target.

  • Version minimale du SDK : 4.0

• environmentId

  Identifiant de l’environnement que vous souhaitez utiliser. Vous pouvez spécifier un identifiant valide (environmentId=8) et, si environmentId n’est pas inclus, l’environnement de production par défaut est utilisé.

  • Version minimale du SDK : 4.14

• lifecycleTimeout

  La valeur par défaut est de 300 secondes.

  Spécifie la durée, en secondes, qui doit s’écouler entre le lancement de l’application et le moment où le lancement est considéré comme une nouvelle session. Ce délai d’attente s’applique également lorsque votre application est envoyée en arrière-plan et réactivée. Le temps passé par votre application en arrière-plan n’est pas inclus dans la durée de session.

  • Version minimale du SDK : 4.0

• messages

  Généré automatiquement par Adobe Mobile Services, définit les paramètres de la messagerie in-app. Pour plus d’informations, consultez la section Description des messages ci-dessous.

  • Version minimale du SDK : 4.2

• offlineEnabled

  Lorsque cette variable est activée, les accès sont placés en file d’attente pendant que l’appareil est hors ligne et envoyés ultérieurement quand l’appareil est en ligne. La suite de rapports doit prendre en charge l’horodatage pour permettre l’utilisation du suivi hors ligne. La valeur par défaut est false.

  Voici quelques informations importantes :

  • Si les horodatages sont activés sur votre suite de rapports, votre propriété de configuration offlineEnabled doit être définie sur « true ».

  • Si la suite de rapports n’est pas horodatée, la propriété de configuration offlineEnabled doit être définie sur « false ».

    En cas de configuration incorrecte, les données seront perdues. Si vous ne savez pas si une suite de rapports est horodatée, contactez l’assistance clientèle ou téléchargez le fichier de configuration depuis Adobe Mobile Services. Si vous collectez actuellement des données AppMeasurement dans une suite de rapports qui collecte également des données de JavaScript, il est possible que vous deviez configurer une suite de rapports distincte pour les données mobiles ou que vous deviez inclure un horodatage personnalisé pour tous les accès JavaScript à l’aide de la variable s.timestamp.

  • Version minimale du SDK : 4.0

• org

  Indique l’ID d’organisation Experience Cloud pour le service d’identification Adobe Experience Platform.

  • Version minimale du SDK : 4.3

• poi

  Chaque matrice de points ciblés comporte le nom, la latitude, la longitude et le rayon (en mètres) du point ciblé correspondant à la zone du point. Le nom du point ciblé peut être n’importe quelle chaîne. Lorsqu’un appel trackLocation est envoyé et que les coordonnées actuelles se trouvent dans un point ciblé défini, une variable de données contextuelle est renseignée et envoyée avec l’appel trackLocation.

  • Version minimale du SDK : 4.0

  "poi" [
          ["sanfrancisco",37.757144,-122.44812,7000]
          ["santacruz",36.972935,-122.01725,600]
        ]
  

  CONSEIL

  À partir de la version 4.2, les points ciblés sont définis dans l’interface Adobe Mobile et synchronisés dynamiquement avec les fichiers de configuration de l’application. Cette synchronisation requiert le paramètre analytics.poi :

  "analytics.poi": "`https://assets.adobedtm.com/…/yourfile.json`",
  

  Si ce paramètre n’est pas configuré, le fichier ADBMobile.json doit être mis à jour afin d’inclure cette ligne. Pour télécharger un fichier de configuration mis à jour, voir Avant de démarrer.

• postback

  La définition du modèle de message « callback » est présentée ci-dessous :

  "payload":{
      "templateurl":"",//required- will be token-expanded prior to being sent
      "templatebody":"", //optional-if this length > 0 POST will be used as transport method. This is a base-64 encoded blob,which will be decoded and token-expanded prior to being sent.
      "contenttype":"", //optional-if this is length > 0 and POST type is selected, this will be set as the Content-Typeheader. if this is not supplied for a POST request,the default will be "application/x-www-form-urlencoded"
      "timeout": 0 //optional-number of seconds to wait before timingout.Defaultis2.}
  

  L’objet payload présent dans le code est un exemple de charge utile pour la définition d’un message qui irait dans la fichier ADBMobileConfig.json. Pour en savoir plus, consultez la rubrique Postbacks.

  • Version minimale du SDK : 4.6

• privacyDefault

  • Pour optedin, les accès sont envoyés immédiatement.

  • Pour optedout, les accès sont ignorés.

  • Pour optunknown, si l’horodatage est activé pour la suite de rapports, les accès sont enregistrés jusqu’à ce que l’état de confidentialité devienne « inclusion » (les accès sont envoyés) ou « exclusion » (les accès sont ignorés).

    Si la suite de rapports ne prend pas en charge l’horodatage, les accès sont ignorés jusqu’à ce que l’état de confidentialité soit défini sur « inclusion ».

    Cela ne définit que la valeur initiale. Si cette valeur est définie ou modifiée dans le code, la nouvelle valeur est utilisée jusqu’à ce qu’elle soit à nouveau modifiée, ou lorsque l’application est désinstallée et réinstallée. La valeur par défaut est optedin.

  • Version minimale du SDK : 4.0

• referrerTimeout

  Nombre de secondes pendant lesquelles le SDK attend les données du référent d’acquisition lors du lancement initial avant d’expirer. Si vous utilisez l’acquisition, nous vous recommandons un délai d’attente de 5 secondes.

  IMPORTANT

  Cette variable est requise par Acquisition. Si la variable est définie sur 0 ou n’est pas incluse, le SDK n’attend pas les données d’acquisition et le suivi des mesures d’acquisition n’est pas effectué.

  • Version minimale du SDK : 4.1

• remotes

  Configurée automatiquement et définit les points de terminaison hébergés par Adobe pour les fichiers de configuration dynamiques. L’heure de la dernière mise à jour de chaque fichier de configuration est comparée à la version en cours à chaque lancement ; les mises à jour sont téléchargées et enregistrées.

  • analytics.poi est le point de terminaison de la configuration des points ciblés hébergés.

  • messages est le point de terminaison de la configuration des messages in-app hébergés.

  • Version minimale du SDK : 4.2

• rsids

  Une ou plusieurs suites de rapports pour recevoir des données Analytics. Plusieurs ID de suite de rapports doivent être séparés par des virgules sans espace entre eux.

  "rsids": "rsid"
  

  "rsids" : "rsid1,rsid2"
  

  IMPORTANT

  Cette variable est requise par Analytics.

  • Version minimale du SDK : 4.0

• server

  Serveur Analytics ou de la gestion de l’audience, en fonction du nœud parent.

  Cette variable doit être renseignée par le domaine du serveur, sans préfixe de protocole https:// ou https://. Ce préfixe est géré automatiquement par la bibliothèque en fonction de la variable ssl.

  Si ssl esttrue défini sur, une connexion sécurisée est établie avec le serveur. Si ssl est falsedéfini sur, une connexion non sécurisée est établie avec le serveur.

  IMPORTANT

  Cette variable est requise par Analytics et/ou la gestion de l’audience.

  • Version minimale du SDK : 4.0

• ssl

  IMPORTANT

  Depuis la version 4.10.0, SSL prend la valeur true (vrai) par défaut si l’indicateur n’est pas défini.

  Active (true) ou désactive (false) la fonctionnalité d’envoi des données de mesure en utilisant SSL (HTTPS).

  La définition du modèle de message « callback » est présentée ci-dessous :

  "payload":{
      "templateurl":"",//required-will be token-expanded prior to being sent
      "templatebody":"",//optional-if this length > 0, POST will be used as transport method. This is a base64 encoded blob,which will be decoded and token-expanded prior to being sent.
      "contenttype":"",//optional-if this is length > 0 and POST type is selected this will be set as the Content-Typeheader. if this is not supplied for a POST request,the default will be "application/x-www-form-urlencoded"
      "timeout":0//optional-numberofsecondstowaitbeforetimingout.Defaultis2.}
  

  L’objet payload du code est un exemple de charge utile pour une définition de message qui va dans le fichier ADBMobileConfig.json. Pour en savoir plus, consultez la rubrique Postbacks.

  • Version minimale du SDK : 4.0

• timeout

  Détermine le délai pendant lequel Target attend une réponse.

  • Version minimale du SDK : 4.0

Exemple de fichier ADBMobileConfig.json :

Voici un exemple de fichier ADBMobileConfig.json :

{
    "version": "2014-08-05T19:18:28.169Z",
    "marketingCloud" : {
        "org": "016D5C175213CCA80A490D05@AdobeOrg",
        "coopUnsafe": false
    },
    "target": {
        "clientCode": "",
        "timeout": 5,
        "environmentId": 8
    },
    "audienceManager": {
        "server": "",
        "analyticsForwardingEnabled": false
    },
    "acquisition": {
        "server": "c00.adobe.com",
        "appid": "10a77a60192fbb628376e1b1daeeb65debf934e2c807e067ceb2963a41b165ee"
    },
    "analytics": {
        "rsids": "coolApp",
        "server": "my.CoolApp.com",
        "ssl": true,
        "offlineEnabled": true,
        "charset": "UTF-8",
        "lifecycleTimeout": 300,
        "privacyDefault": "optedin",
        "batchLimit": 0,
        "referrerTimeout": 5,
        "poi": [
            ["san francisco",37.757144,-122.44812,7000],
            ["santa cruz",36.972935,-122.01725,600]
        ]
    },
    "messages": [
        {
            "messageId": "cb426565-a563-497a-a889-9dbeb451f8ae",
            "template": "fullscreen",
            "payload": {
                 "html": "<!DOCTYPE html><html><head><meta charset=\"utf-8\" /><title></title><style></style></head><body><iframe src=\"https://www.adobe.com/\" frameborder=\"0\"></iframe></body></html>"
            },
            "showOffline": false,
            "showRule": "always",
            "endDate": 2524730400,
            "startDate": 0,
            "audiences": [],
            "triggers": [
                {
                    "key": "pev2",
                    "matches": "eq",
                    "values": [
                        "AMACTION:custom"
                    ]
                }
            ]
        }
    ],
    "remotes": {
        "analytics.poi": "https://assets.adobedtm.com/staging/42a6fc9b77cd9f29082cf19b787bae75b7d1f9ca/scripts/satellite-53e0faadc2f9ed92bc00003b.json",
        "messages": "https://assets.adobedtm.com/staging/42a6fc9b77cd9f29082cf19b787bae75b7d1f9ca/scripts/satellite-53e0f9e2c2f9ed92bc000032.json"
    }
}

Description des messages

Le nœud de messages est généré automatiquement par Adobe Mobile Services et n’a généralement pas besoin d’être modifié manuellement. La description suivante est fournie à des fins de dépannage :

• "messageId"

  • ID généré, obligatoire

• "template"

  • "alert", "fullscreen", ou "local"
  • obligatoire

• "payload"

  • "html"

    • modèle plein écran uniquement, obligatoire
    • définition du message par html

  • "image"

    • plein écran uniquement, facultatif
    • URL de l’image à utiliser pour une image plein écran

  • "altImage"

    • plein écran uniquement, facultatif

    • nom de l’image regroupée à utiliser si l’URL spécifiée dans

      image n’est pas accessible

  • "title"

    • plein écran et alerte, obligatoire
    • texte de titre d’un message d’alerte ou plein écran

  • "content"

    • alerte et notification locale, obligatoire
    • sous-texte d’un message d’alerte ou texte de notification d’un message de notification local

  • "confirm"

    • alerte, facultatif
    • texte utilisé dans le bouton de confirmation

  • "cancel"

    • alerte, obligatoire
    • texte utilisé dans le bouton d’annulation

  • "url"

    • alerte, facultatif
    • action d’URL à charger en cas de clic sur le bouton de confirmation

  • "wait"

    • notification locale, obligatoire
    • durée d’attente (en secondes) avant de publier la notification locale après la correspondance avec ses critères

• "showOffline"

  • true ou false
  • false par défaut

• "showRule"

  • "always", "once", ou "untilClick"
  • obligatoire

• "endDate"

  • nombre de secondes depuis le 1er janvier 1970
  • La valeur par défaut est 2524730400.

• "startDate"

  • nombre de secondes depuis le 1er janvier 1970
  • La valeur par défaut est 0.

• "audiences"

  Ensemble d’objets qui définit comment le message doit être affiché :

  • "key"

    Nom de variable à rechercher dans l’accès (obligatoire).

  • "matches"

    Type de correspondance utilisé lors de la comparaison :

    • eq = est égal à
    • ne = n’est pas égal à
    • co = contient
    • nc = ne contient pas
    • sw = commence par
    • ew = finit par
    • ex = existe
    • nx = n’existe pas
    • lt = inférieur à
    • le = inférieur ou égal à
    • gt = supérieur à
    • ge = supérieur ou égal à

  • "values"

    Tableau de valeurs utilisées pour correspondre à la valeur de la variable nommée dans ce qui suit :

    • key
    • avec le type de correspondance dans
    • matches

• "triggers"

  Comme les audiences, mais il s’agit ici des actions :

  • "triggers"
  • "matches"
  • "values"

Ressources Business.Adobe.com

Email Deliverability Data Connectors Audience Segmentation Marketing Analytics Data Analytics Search Marketing Management