Recommendations y limitaciones limitations
Permisos y seguridad permissions
Asignación de perfiles de producto
En Campaign Standard, se le otorgó un acceso elevado a la función de administrador a las API independientemente del perfil de producto asignado. La versión 8 de Campaign presenta un conjunto diferente de perfiles de producto, que requieren la asignación de perfiles de producto de Campaign Standard a Campaign v8.
Con la migración, se añaden dos perfiles de producto a las cuentas técnicas existentes o creadas previamente: Administrador y Centro de mensajes (para acceder a las API transaccionales). Revise la asignación de perfiles de producto y asigne el perfil de producto necesario si no desea que el perfil de producto de administrador se asigne con su cuenta técnica.
ID de inquilino
Después de la migración, para cualquier integración futura, se recomienda usar su ID de inquilino de Campaign v8 en las URL de REST, reemplazando su ID de inquilino de Campaign Standard anterior.
Uso de claves
La administración de los valores de PKey difiere entre Campaign Standard y Campaign v8. Si almacenaba claves principales con Campaign Standard, asegúrese de que la implementación forme dinámicamente llamadas de API posteriores mediante claves principales o href obtenidas de llamadas de API anteriores.
API disponibles deprecated
Por ahora, las API de REST enumeradas a continuación están disponibles para su uso:
- Perfiles
- Servicios y suscripciones
- Recursos personalizados
- Flujos de trabajo
- Historial de marketing
- Unidades organizativas
- Administración de la privacidad
Filtrado
-
Para utilizar los filtros en las cargas útiles de API REST, debe editarlos en Campaign v8 y proporcionar un nombre para utilizarlo en las cargas útiles. Para ello, obtenga acceso a los parámetros adicionales del filtro desde la ficha Parámetros y proporcione el nombre que desee en el campo Nombre del filtro en la API de REST.
-
El prefijo "by" necesario para utilizar filtros personalizados ya no es necesario. El nombre del filtro debe usarse tal cual en sus solicitudes.
Por ejemplo:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/<resourceName>/<customFilterName>?<customFilterparam>=<customFilterValue>
Campos de base de datos descartados
Algunos campos de la base de datos se pierden durante la migración. Al utilizar un campo colocado, las API de REST devolverán valores en blanco. En el futuro, todos los campos perdidos quedarán obsoletos y se eliminarán.
POST con recursos vinculados
Cuando se utiliza el siguiente formato de cuerpo de solicitud, con "propietario del vehículo" representando el vínculo a "nms:destinatario":
{
"vehicleNumber": "20009",
"vehicleName": "Model E",
"vehicleOwner":{
"firstName":"tester 11",
"lastName":"Smith 11"
}
}
Se ignora la información del vínculo. En consecuencia, se genera un nuevo registro en "cusVehicle" que contiene solo los valores de "número de vehículo" y "nombre de vehículo". Sin embargo, el vínculo sigue siendo nulo, lo que hace que "excipientePropietario" se establezca en nulo.
En Campaign v8, cuando se utiliza la misma estructura de cuerpo de solicitud y el "vehículo" está vinculado a un perfil, se produce un error. Este error se produce porque la propiedad "firstName" no se reconoce como válida para "cusVehicle". Sin embargo, un cuerpo de solicitud que incluye solo los atributos sin el vínculo funciona sin ningún problema.
operaciones del PATCH
- La versión 8 de Campaign no admite PATCH con un cuerpo de solicitud vacío: devuelve el estado 204 Sin contenido.
- Aunque Campaign Standard admite PATCH en elementos/atributos dentro de un esquema, tenga en cuenta que las operaciones de PATCH en la ubicación no son compatibles con Campaign v8. Si se intenta un PATCH en una ubicación, se producirá un error de servidor interno 500 con un mensaje de error que indica que la propiedad "zipCode" no es válida para el recurso "perfil".
Respuestas REST
La sección siguiente enumera diferencias menores entre las respuestas de Campaign Standard y REST v8.
- Para registros de GET únicos, la respuesta incluye el href en la respuesta.
- Cuando se consulta con el atributo, Campaign v8 proporciona Recuento y Paginación en la respuesta.
- Después de las operaciones del POST, los valores de los recursos vinculados se devuelven en la respuesta.
Códigos de error y mensajes
La sección siguiente enumera las diferencias entre los códigos de error y los mensajes de Campaign Standard y Campaign v8.
Perfil: zona horaria
Con el Campaign Standard, la zona horaria se muestra como parte de la respuesta JSON de profileAndServices/profile llamadas a la API de REST.
Con Campaign v8, la zona horaria solo se muestra al usuario como parte de las llamadas a la API REST profileAndServicesExt/profile. No forma parte de las llamadas a la API REST profileAndServices/profile porque se está agregando en un esquema extendido.
Flujos de trabajo: activación de señal externa
La API de flujo de trabajo de Campaign Standard GET devuelve nombres de parámetros como las variables de instancia de flujo de trabajo y sus tipos de datos (booleano, cadena, etc.). Se utiliza para crear un cuerpo de solicitud JSON con el formato adecuado al activar la señal a través de una llamada de API de POST.
Campaign v8 no admite variables de instancia de flujo de trabajo de publicidad, pero espera que los desarrolladores sepan cuáles son. Como tal, después de la migración, la información de parámetros en el cuerpo de solicitud del POST deberá construirse sin la disponibilidad de la información de parámetros en la respuesta de la API de GET.