DocumentationGuide du développeur de Target

Adobe Target Bulk Profile Update API

Last update: Wed May 29 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Developer

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

En utilisant la variable 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 à de nombreux utilisateurs. Target 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.

Version
Exemple d’URL
Fonctionnalités
v1
http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/profile/batchUpdate
Prise en charge de la mise à jour des profils en masse uniquement.
v2
http://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
Version 2 (v2) du 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
La variable batch= est obligatoire et doit être spécifié au début du fichier.

Vous référencez ce fichier dans l’appel du POST à Target serveurs 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 un pcId ou thirdPartyId. La variable Marketing Cloud visitor ID n’est pas prise en charge. pcId est un TargetvisitorID généré. thirdPartyId est un identifiant spécifié par l’application cliente, qui est transmis à Target par le biais d’un appel de mbox comme mbox3rdPartyId. Il doit être appelé ici 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 affichés dans Target as 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 tous les pcId ou mbox3rdPartyId qui est 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.
  • Le nombre d’attributs que vous chargez n’est pas limité. Toutefois, la taille globale d’un profil, y compris les données système, ne doit pas dépasser 2 000 Ko. Adobe recommande d’utiliser moins de 1 000 Ko de stockage pour les attributs de profil.
  • Les paramètres et valeurs sont sensibles à la casse.

requête de POST HTTP

Envoyez une requête de POST HTTP à Target serveurs Edge pour traiter le fichier. Voici un exemple de requête de POST HTTP pour le fichier batch.txt à l’aide de la commande curl :

\ curl -X POST --data-binary @BATCH.TXT http\://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate\

Où :

BATCH.TXT est le nom du fichier. CLIENTCODE est la variable Target code client.

Si vous ne connaissez pas votre code client, dans la variable Target clic sur l’interface utilisateur Administration > Implementation. Le code client s’affiche dans la variable Account Details .

Inspect de la réponse

L’API Profiles renvoie l’état d’envoi du lot à traiter avec un lien sous "batchStatus" vers une URL différente qui indique l’état global de la tâche par lots spécifique.

Exemple de réponse API

Le code ci-dessous est un exemple de réponse de l’API Profiles :

<response>
    <success>true</success>
    <batchStatus>http://mboxedge45.tt.omtrdc.net/m2/demo/profile/batchStatus?batchId=demo-1701473848678-13029383</batchStatus>
    <message>Batch submitted for processing</message>
</response>

En cas d’erreur, la réponse contient success=false et un message d’erreur détaillé.

Réponse d’état du lot par défaut

Une réponse par défaut réussie lorsque la valeur ci-dessus batchStatus L’utilisateur clique sur un lien d’URL qui ressemble à ce qui suit :

<response><batchId>demo4-1701473848678-13029383</batchId><status>complete</status><batchSize>1</batchSize></response>

Les valeurs attendues pour les champs d’état sont les suivantes :

État
Détails
complete
La requête de mise à jour du lot de profils a été effectuée avec succès.
incomplete
La demande de mise à jour du lot de profils est toujours en cours de traitement et n’est pas terminée.
stuck
La demande de mise à jour du lot de profils est bloquée et n’a pas pu être exécutée.

Réponse détaillée à l’URL d’état du lot

Une réponse plus détaillée peut être récupérée en transmettant un paramètre . showDetails=true à la fonction batchStatus url ci-dessus.

Par exemple :

http://mboxedge45.tt.omtrdc.net/m2/demo/profile/batchStatus?batchId=demo-1701473848678-13029383&showDetails=true

Réponse détaillée

<response>
    <batchId>demo4-1701473848678-13029383</batchId>
    <status>complete</status>
    <batchSize>1</batchSize>
    <consumedCount>1</consumedCount>
    <successfulUpdates>1</successfulUpdates>
    <profilesNotFound>0</profilesNotFound>
    <failedUpdates>0</failedUpdates>
</response>
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3