Adobe Target Single Profile Update API
L’Adobe Target API de mise à jour de profil individuel vous permet d’envoyer une mise à jour de profil à un seul utilisateur. L’API Single Profile Update API est presque identique à l’API Bulk Profile Update API, mais un profil de visiteur est mis à jour à la fois, en ligne avec l’appel API plutôt qu’avec un fichier .cvs.
L’API Single Profile Update API et est généralement utilisée lorsqu’une mise à jour doit se produire en relation avec une transaction se produisant dans un canal qui n’a pas implémenté Target. Par exemple, vous souhaitez mettre à jour le profil d’un seul visiteur qui effectue une action hors ligne. Il peut s’agir de contacter un centre d’appel, d’obtenir un prêt, d’utiliser une carte de fidélité en magasin, d’accéder à un kiosque, etc.
Les avantages de l’API de mise à jour de profil unique sont les suivants :
- Nombre d’attributs de profil illimité.
- Les attributs de profil envoyés via le site peuvent être mis à jour via l’API et inversement.
Avertissements
-
L’API de mise à jour de profil unique est limitée à l’exécution d’un million de mises à jour sur une période mobile de 24 heures.
-
Les mises à jour se produisent généralement en moins d’une heure, mais leur prise en compte peut prendre jusqu’à 24 heures.
Si vous devez envoyer d’autres mises à jour ou si vous souhaitez que les mises à jour soient traitées dans des délais plus courts, pensez à envoyer des mises à jour de profil transactionnel par le biais d’une mise à jour côté client (recommandé) ou via l’API de diffusion côté serveur Adobe Target.
-
L’API Single Profile Update API est une API serveur à serveur et n’est pas conçue pour fonctionner dans une page web. Pour mettre à jour un profil du visiteur à partir de votre page web, vous pouvez utiliser la fonction trackEvent() ou l’API Delivery.
Format
Spécifiez les paramètres de profil au format profile.paramName=value.
Pour mettre à jour le profil d’un pcId, utilisez :
https://<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mboxPC=1368007744041-575948.01_00&profile.attr=0&profile.attr2=1...
Pour mettre à jour le profil d’un mbox3rdPartyId, utilisez :
shell http://<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mbox3rdPartyId=123456&profile.attr=0&profile.attr2=1...
L’API de mise à jour de profil unique est réservée aux mises à jour. Si rien n’est trouvé, aucun profil n’est créé.
Remarques
- Les paramètres et les valeurs doivent être encodés en URL à l’aide d’UTF-8.
- Le format des paramètres est
profile.paramName. - Toutes les valeurs de paramètre ne doivent pas exister pour tous les pcIds et mbox3rdPartyIds.
- Les paramètres et les valeurs sont sensibles à la casse.
- GET et POST sont pris en charge.
- La limite de taille actuelle est de 8 Ko pour GET et de 60 Ko pour POST.
Réponse
Voici un exemple de réponse pour les requêtes ci-dessus :
trueRequest successfully submitted
Cette réponse indique que la réponse a été envoyée et sera bientôt traitée.