Adobe Target Bulk Profile Update API

Dernière mise à jour : 18 septembre 2024

Créé pour :

  • Développeur

Le Adobe Target Bulk Profile Update API permet de mettre à jour en masse les profils utilisateur de plusieurs visiteurs d’un site web à l’aide d’un fichier de commandes.

Grâce à Bulk Profile Update API, vous pouvez facilement envoyer des données détaillées sur le profil du visiteur sous la forme de paramètres de profil pour de nombreux utilisateurs à Target à partir de n’importe quelle source externe. Les sources externes peuvent inclure des systèmes de gestion de la relation client (CRM) ou de point de vente (POS), qui ne sont généralement pas disponibles sur une page web.

VersionExemple d’URLFonctionnalités
v1http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/profile/batchUpdatePrise en charge de la mise à jour des profils en masse uniquement.
v2http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate
  • Créez un profil s’il est introuvable.
  • Mise à jour de l’état par ligne.
NOTE
La version 2 (v2) de Bulk Profile Update API est la version actuelle. Cependant, Target prend toujours en charge la version 1 (v1).

Avantages de l’API de mise à jour du profil en bloc

  • Nombre d’attributs de profil illimité.
  • Les attributs de profil envoyés via le site peuvent être mis à jour via l’API et de la manière inverse.

Avertissements

  • La taille du fichier de traitement par lot doit être inférieure à 50 Mo. En outre, le nombre total de lignes ne doit pas dépasser 500 000 lignes par téléchargement.
  • Les mises à jour surviennent généralement en moins d’une heure, mais peuvent prendre jusqu’à 24 heures pour être répercutées.
  • Le nombre de lignes que vous pouvez transférer sur une période de 24 heures dans les lots suivants n’est pas limité. Cependant, le processus d’assimilation peut être ralenti pendant les heures ouvrables pour s’assurer que les autres processus s’exécutent efficacement.
  • Les appels de mise à jour de lots v2 consécutifs sans appels de mbox intermédiaires pour le même thirdPartyIds remplacent les propriétés mises à jour lors du premier appel de mise à jour de lots.
  • Adobe ne garantit pas que 100 % des données de profil de lot seront intégrées et conservées dans Target et, par conséquent, seront disponibles pour une utilisation dans le ciblage. Dans la conception actuelle, il est possible qu’un faible pourcentage de données (jusqu’à 0,1 % des grands lots de production) ne soient pas intégrées ou conservées.

Fichier batch

Pour mettre à jour les données de profil en bloc, créez un fichier de commandes. Le fichier de commandes est un fichier texte dont les valeurs sont séparées par des virgules, comme dans l’exemple de fichier suivant.

\ batch=pcId,param1,param2,param3,param4\ 123,value1\ 124,value1,value4\ 125,value2\ 126,value1,value2,value3,value4\

NOTE
Le paramètre batch= est requis et doit être spécifié au début du fichier.

Vous référencez ce fichier dans l’appel du POST aux serveurs Target pour traiter le fichier. Lors de la création du fichier de commandes, tenez compte des points suivants :

  • La première ligne du fichier doit spécifier les en-têtes de colonne.
  • Le premier en-tête doit être pcId ou thirdPartyId. Marketing Cloud visitor ID n’est pas pris en charge. pcId est un identifiant visiteur généré par Target. thirdPartyId est un identifiant spécifié par l’application cliente, qui est transmis à Target par le biais d’un appel de mbox en tant que mbox3rdPartyId. Il doit être désigné ici sous le nom thirdPartyId.
  • Pour des raisons de sécurité, les paramètres et valeurs que vous spécifiez dans le fichier de lot doivent être codés au format URL à l’aide du codage UTF-8. Les paramètres et valeurs peuvent être transférés vers d’autres noeuds périphériques pour traitement via des requêtes HTTP.
  • Les paramètres doivent être au format paramName uniquement. Les paramètres sont affichés dans Target sous la forme profile.paramName.
  • Si vous utilisez Bulk Profile Update API v2, vous n’avez pas besoin de spécifier toutes les valeurs de paramètre pour chaque pcId. Les profils sont créés pour tout pcId ou mbox3rdPartyId introuvable dans Target. Si vous utilisez la version 1, les profils ne sont pas créés pour les pcIds manquants ou mbox3rdPartyIds.
  • La taille du fichier de traitement par lot doit être inférieure à 50 Mo. En outre, le nombre total de lignes ne doit pas dépasser 500 000. Cette limite garantit que les serveurs ne sont pas inondés de requêtes trop nombreuses.
  • Vous pouvez envoyer plusieurs fichiers. Cependant, la somme totale des lignes de tous les fichiers que vous envoyez par jour ne doit pas dépasser un million pour chaque client.
  • Il n’existe aucune restriction quant au nombre d’attributs que vous pouvez transférer. Toutefois, la taille totale des données de profil externes, qui incluent les attributs du client, l’API de profil, les paramètres de profil internes à la mbox et la sortie du script de profil, ne doit pas dépasser 64 Ko.
  • Les paramètres et valeurs sont sensibles à la casse.