Recommendations et limitations limitations
Autorisations et sécurité permissions
Mappage des profils de produit
Dans Campaign Standard, un accès aux API avec un rôle d’administrateur élevé vous a été accordé, quel que soit votre profil de produit attribué. Campaign v8 introduit un ensemble différent de profils de produit, nécessitant un mappage de Campaign Standard aux profils de produit Campaign v8.
Avec la migration, deux profils de produit sont ajoutés à vos comptes techniques existants ou précréés : Administrateur et Message Center (pour l’accès aux API transactionnelles). Passez en revue le mappage de profil de produit et attribuez le profil de produit nécessaire si vous ne souhaitez pas que le profil de produit administrateur soit mappé à votre compte technique.
Identifiant du client
Après la migration, pour les intégrations futures, il est recommandé d’utiliser votre ID de tenant Campaign v8 dans les URL REST, en remplaçant votre identifiant de client Campaign Standard précédent.
Utilisation des clés
La gestion des valeurs PKey diffère entre Campaign Standard et Campaign v8. Si vous stockiez des PKeys avec Campaign Standard, assurez-vous que votre mise en oeuvre forme dynamiquement les appels d’API suivants à l’aide de PKeys ou de hrefs obtenus à partir d’appels d’API précédents.
API disponibles deprecated
Pour l’instant, les API REST répertoriées ci-dessous sont disponibles :
- Profils
- Services et abonnements
- Ressources personnalisées
- Workflows
- Historique marketing
- Entités organisationnelles
- Gestion de la confidentialité
Filtrage
-
Pour utiliser vos filtres dans les payloads de l’API REST, vous devez les modifier dans Campaign v8 et donner un nom à utiliser dans les payloads. Pour ce faire, accédez aux paramètres supplémentaires du filtre à partir de l’onglet Paramètres et indiquez le nom de votre choix dans le champ Nom du filtre dans l’API REST.
-
Le préfixe "by" requis pour utiliser des filtres personnalisés n’est plus nécessaire. Le nom du filtre doit être utilisé tel quel dans vos requêtes.
Exemple :
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/<resourceName>/<customFilterName>?<customFilterparam>=<customFilterValue>
Champs de base de données supprimés
Certains champs de la base de données sont supprimés lors de la migration. Lors de l’utilisation d’un champ déposé, les API REST renvoient des valeurs vides. À l’avenir, tous les champs déposés seront abandonnés et supprimés.
POST avec ressources liées
Lors de l’utilisation du format de corps de requête suivant, avec "véhiculeOwner" représentant le lien vers "nms:recipient" :
{
"vehicleNumber": "20009",
"vehicleName": "Model E",
"vehicleOwner":{
"firstName":"tester 11",
"lastName":"Smith 11"
}
}
Les informations sur le lien sont ignorées. Par conséquent, un nouvel enregistrement est généré sous "cusVehicle" contenant uniquement les valeurs "véhiculeNumber" et "véhiculeName". Cependant, le lien reste nul, ce qui entraîne la définition de "véhiculeOwner" sur null.
Dans Campaign v8, lorsque la même structure de corps de requête est utilisée et que le "véhicule" est lié à un profil, une erreur se produit. Cette erreur se produit car la propriété "firstName" n’est pas reconnue comme valide pour "cusVehicle". Cependant, un corps de requête comprenant uniquement les attributs sans fonctions de lien ne présente aucun problème.
Opérations PATCH
- Campaign v8 ne prend pas en charge le PATCH avec un corps de requête vide : il renvoie un état 204 No Content .
- Bien que Campaign Standard prenne en charge le PATCH sur les éléments/attributs d’un schéma, notez que les opérations de PATCH à l’emplacement ne sont pas prises en charge dans Campaign v8. La tentative d’un PATCH sur l’emplacement entraînera une erreur interne 500 du serveur avec un message d’erreur indiquant que la propriété 'zipCode' n’est pas valide pour la ressource 'profile'.
Réponses REST
La section ci-dessous répertorie les différences mineures entre les réponses REST Campaign Standard et v8.
- Pour les enregistrements de GET unique, la réponse inclut le href dans la réponse.
- Lors de l’interrogation de l’attribut , Campaign v8 fournit le décompte et la pagination dans la réponse.
- Après les opérations de POST, les valeurs des ressources liées sont renvoyées dans la réponse.
Codes d’erreur et messages
La section ci-dessous répertorie les différences entre les codes et les messages d’erreur de Campaign Standard et de Campaign v8.
Profil - Fuseau horaire
Avec Campaign Standard, le fuseau horaire s’affiche dans le cadre de la réponse JSON des appels d’API REST profileAndServices/profile.
Avec Campaign v8, le fuseau horaire s’affiche uniquement pour l’utilisateur dans le cadre des appels d’API REST profileAndServicesExt/profile. Il ne fait pas partie des appels d’API REST profileAndServices/profile puisqu’il est ajouté à un schéma étendu.
Workflows - Déclenchement de signaux externes
L’API Campaign Standard Workflow GET renvoie les noms des paramètres tels que les variables d’instance de workflow et leurs types de données (booléen, chaîne, etc.). Il est utilisé pour créer le corps de requête JSON correctement formaté lors du déclenchement du signal via un appel API de POST.
Campaign v8 ne prend pas en charge les variables d’instance de workflow publicitaire, mais attend des développeurs qu’ils sachent ce qu’elles sont. Par conséquent, les informations de paramètres post-migration dans le corps de la requête du POST devront être construites sans la disponibilité des informations de paramètres dans la réponse de l’API GET.