Recommendations y limitaciones

Última actualización: 11 de febrero de 2025

Creado para:

Experimentado
Desarrollador

Permisos y seguridad

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

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
Mensajes transaccionales

AVAILABILITY

Por ahora, la API de REST mensajes transaccionales no está disponible.

Las API de REST enumeradas a continuación están en desuso y no están disponibles para su uso:

Historial de marketing
Unidades organizativas
Administración de la privacidad

Filtro

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.

Escenario

Campaign Standard

Versión 8 de Campaign

Usar una clave principal no válida en el cuerpo de la solicitud

500 - Atributo 'O5iRp40EGA' desconocido (consulte la definición del esquema 'Profiles (nms:recipient)'). XTK-170036 No se ha podido analizar la expresión '@id = @O5iRp40EGA'.

404: No se puede descifrar la clave principal. (PKey=@jksad)

Usar una clave principal no válida en el URI

500 - Atributo 'O5iRp40EGA' desconocido (consulte la definición del esquema 'Profiles (nms:recipient)'). XTK-170036 No se ha podido analizar la expresión '@id = @O5iRp40EGA'.

404: No se puede descifrar la clave principal. (PKey=@jksad) Extremo no compatible. (extremo=rest/profileAndServices/profile/@jksad)

Uso de dos claves sin procesar diferentes en el URI y en el cuerpo de la solicitud

500 - RST-360011 Se ha producido un error. Póngase en contacto con el administrador. RST-360012 Operación incoherente en el recurso "servicio": no se puede actualizar la clave "SVC3" a "SVC4".

500 - Se ha producido un error - póngase en contacto con su administrador.

Uso de PKey en el URI y de una PKey sin procesar diferente en el cuerpo de la solicitud

500: ya existe un "servicio" con la misma clave "SVC4". PGS-220000 Error de PostgreSQL: ERROR: el valor de clave duplicado viola la restricción única "nmsservice_name" DETALLE: La clave (sname)=(SVC4) ya existe.

500 - Se ha producido un error - póngase en contacto con su administrador.

Uso de raw-id no existente en el URI

404 - RST-360011 Se ha producido un error. Póngase en contacto con el administrador. No se puede encontrar el documento con la ruta 'Servicio' de la clave 'adobe_nl:0' (documento con el esquema 'service' y el nombre 'adobe_nl')

404: No se puede encontrar el documento con la ruta "Servicio" de la clave "adobe_nl" (documento con el esquema "service" y el nombre "adobe_nl")

Uso de raw-id no existente en el cuerpo de la solicitud

404 - RST-360011 Se ha producido un error. Póngase en contacto con el administrador. No se pudo encontrar documento con ruta 'Servicio' de la clave 'adobe_nl' (documento con esquema 'service' y nombre 'adobe_nl')

404: No se puede encontrar el documento con la ruta "Servicio" de la clave "adobe_nl" (documento con el esquema "service" y el nombre "adobe_nl")

-

500 - RST-360011 Se ha producido un error. Póngase en contacto con el administrador.

500 - Se ha producido un error - póngase en contacto con su administrador.

Inserte un perfil o servicio con un valor de enumeración de sexo no válido (o cualquier cosa)

500 - RST-360011 Se ha producido un error. Póngase en contacto con el administrador. El valor "invalid" no es válido para la enumeración "nms

gender" del campo "@gender"

500: Se ha producido un error. Póngase en contacto con el administrador.

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.

recommendation-more-help