SAP Commerce conexión

SAP Commerce, anteriormente conocido como Hybris, es una solución de plataforma de comercio electrónico basada en la nube para empresas B2B y B2C y está disponible como parte del portafolio de experiencia del cliente de SAP. SAP Facturación de suscripción es un producto del portafolio y permite administrar por completo el ciclo de vida de la suscripción con experiencias de pago y venta simplificadas mediante integraciones estandarizadas.

Este Adobe Experience Platform destino usa la SAP Subscription Billing API de administración de clientes para actualizar los detalles del cliente en SAP Commerce desde una audiencia de Experience Platform existente después de la activación.

Las instrucciones para autenticarse en su instancia de SAP Commerce se encuentran más abajo, en la sección Autenticar en destino.

Casos de uso use-cases

Para ayudarle a comprender mejor cómo y cuándo debe utilizar el destino SAP Commerce, aquí tiene un ejemplo de uso que los clientes de Adobe Experience Platform pueden solucionar mediante este destino.

SAP Commerce clientes almacenan información sobre personas o entidades organizativas que interactúan con su negocio. Su equipo usa los clientes existentes en SAP Commerce para generar las audiencias de Experience Platform. Después de enviar estas audiencias a SAP Commerce, su información se actualiza y a cada cliente se le asigna una propiedad con su valor como nombre de audiencia que indica a qué audiencia pertenece el cliente.

Requisitos previos prerequisites

Consulte las secciones siguientes para conocer los requisitos previos que debe configurar en Experience Platform y SAP Commerce y para obtener información que debe recopilar antes de trabajar con el destino SAP Commerce.

Requisitos previos del Experience Platform prerequisites-in-experience-platform

Antes de activar datos en el destino SAP Commerce, debe tener un esquema, un conjunto de datos y audiencias creados en Experience Platform.

Consulte la documentación del Experience Platform para el grupo de campos de esquema Detalles de pertenencia a audiencias si necesita instrucciones sobre los estados de audiencia.

Requisitos previos para el destino SAP Commerce prerequisites-destination

Tenga en cuenta los siguientes requisitos previos para exportar datos de Platform a su cuenta de SAP Commerce:

Debe tener una cuenta de SAP Subscription Billing prerequisites-account

Para exportar datos de Platform a su cuenta de SAP Commerce, necesita tener una cuenta de SAP Subscription Billing. Si no tiene una cuenta de facturación válida, comuníquese con el administrador de cuentas de SAP. Consulte el documento SAP Configuración de la plataforma para obtener más información.

Generación de una clave de servicio prerequisites-service-key

  • La clave de servicio SAP Commerce le permite acceder a la API SAP Subscription Billing a través del Experience Platform. Consulte SAP Commerce crear una clave de servicio con el identificador de cliente y el secreto de cliente para crear una clave de servicio. SAP Commerce requiere lo siguiente:

    • ID de cliente
    • Secreto del cliente
    • URL. El patrón de la dirección URL es el siguiente: https://subscriptionbilling.authentication.eu10.hana.ondemand.com. Este valor se utilizará más adelante para obtener los valores de Region y Endpoint.
Seleccione para ver un ejemplo de la clave de servicio
code language-json
{
    "url": "https://eu10.revenue.cloud.sap/api",
    "uaa": {
        "clientid": "XXX",
        "clientsecret": "XXX",
        "url": "https://subscriptionbilling.authentication.eu10.hana.ondemand.com",
        "identityzone": "subscriptionbilling",
        "identityzoneid": "XXX",
        "tenantid": "XXX",
        "tenantmode": "dedicated",
        "sburl": "https://internal-xsuaa.authentication.eu10.hana.ondemand.com",
        "apiurl": "https://api.authentication.eu10.hana.ondemand.com",
        "verificationkey": "XXX",
        "xsappname": "XXX",
        "subaccountid": "XXX",
        "uaadomain": "authentication.eu10.hana.ondemand.com",
        "zoneid": "XXX",
        "credential-type": "binding-secret"
    },
    "vendor": "SAP"
}

Crear referencias personalizadas en SAP Subscription Billing prerequisites-custom-reference

Para actualizar el estado de audiencia del Experience Platform en SAP Subscription Billing, necesita un campo de referencia personalizado para cada audiencia seleccionada en Platform.

Para crear las referencias personalizadas, inicia sesión en tu cuenta de SAP Subscription Billing y navega a la página [Datos maestros y configuración] > [Referencias personalizadas]. A continuación, seleccione Crear para agregar una nueva referencia a cada audiencia seleccionada en Platform. Necesitará estos nombres de campo de referencia en el siguiente paso Programar exportación de audiencias y ejemplo.

A continuación se muestra un ejemplo de cómo crear un Tipo de referencia personalizado en SAP Subscription Billing:
Imagen que muestra dónde crear una referencia personalizada en la facturación de suscripción a SAP.

Para obtener instrucciones adicionales, consulte la documentación de SAP Subscription Billing referencias personalizadas.

Recopilar credenciales necesarias gather-credentials

Para conectar SAP Commerce al Experience Platform, debe proporcionar valores para las siguientes propiedades de conexión:

Credencial
Descripción
ID de cliente
El valor de clientId de la clave de servicio.
Secreto del cliente
El valor de clientSecret de la clave de servicio.
Punto de conexión
El valor de url de la clave de servicio, es similar a https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Región
Su ubicación del centro de datos. La región está presente en url y tiene un valor similar a eu10 o us10. Por ejemplo, si url es https://eu10.revenue.cloud.sap/api, necesita eu10.

Mecanismos de protección guardrails

Las solicitudes de API para SAP Cloud Management service están sujetas a límites de tarifa. Cuando se sobrepase el límite de tasa, se encontrará con un código de estado de respuesta HTTP 429 Too Many Requests

Identidades admitidas supported-identities

SAP Commerce admite la actualización de las identidades descritas en la tabla siguiente. Más información sobre identidades.

Identidad de destino
Descripción
Consideraciones
customerNumberSAP
Ya existe un identificador de cliente para el cliente individual o corporativo en su cuenta de SAP Commerce.
Obligatorio

Audiencias compatibles supported-audiences

Esta sección describe todas las audiencias que puede exportar a este destino.

Este destino admite la activación de todas las audiencias generadas a través del Experience Platform Servicio de segmentación.

Este destino también admite la activación de las audiencias que se describen en la tabla siguiente.

Tipo de público
Admitido
Descripción
Segmentation Service
Audiencias generadas a través del Experience Platform Servicio de segmentación.
Cargas personalizadas
Las audiencias importadas en el Experience Platform desde archivos CSV.

Tipo y frecuencia de exportación export-type-frequency

Consulte la tabla siguiente para obtener información sobre el tipo y la frecuencia de exportación de destino.

Elemento
Tipo
Notas
Tipo de exportación
Basado en perfil
  • Va a exportar todos los miembros de una audiencia, junto con los campos de esquema deseados (por ejemplo: dirección de correo electrónico, número de teléfono, apellidos), según la asignación de campos.
  • Para cada audiencia seleccionada en Platform, el atributo adicional correspondiente SAP Commerce se actualiza con su estado de audiencia de Platform.
Frecuencia de exportación
Transmisión
  • Los destinos de streaming son conexiones basadas en API "siempre activadas". Cuando se actualiza un perfil en Experience Platform en función de la evaluación de audiencias, el conector envía la actualización de forma descendente a la plataforma de destino. Más información sobre destinos de streaming.

Conexión al destino connect

IMPORTANT
Para conectarse al destino, necesita el permiso Administrar destinos control de acceso. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.

Para conectarse a este destino, siga los pasos descritos en el tutorial de configuración de destino. En el flujo de trabajo de configuración de destino, rellene los campos enumerados en las dos secciones siguientes.

En destinos > catálogo, busque SAP Commerce. También puede ubicarlo en la categoría comercio electrónico.

Autenticarse en el destino authenticate

Rellene los campos obligatorios siguientes. Consulte la sección Generar una clave de servicio para obtener instrucciones.

Campo
Descripción
ID de cliente
El valor de clientId de la clave de servicio.
Secreto de cliente
El valor de clientSecret de la clave de servicio.
Extremo
El valor de url de la clave de servicio, es similar a https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Región
Su ubicación del centro de datos. La región está presente en url y tiene un valor similar a eu10 o us10. Por ejemplo, si url es https://eu10.revenue.cloud.sap/api, necesita eu10.

Para autenticarse en el destino, seleccione Conectarse al destino.
Imagen de la interfaz de usuario de Platform que muestra cómo autenticarse en el destino.

Si los detalles proporcionados son válidos, la interfaz de usuario mostrará el estado Conectado con una marca de verificación verde. A continuación, puede continuar con el paso siguiente.

Rellenar detalles de destino destination-details

Para configurar los detalles del destino, rellene los campos obligatorios y opcionales a continuación. Un asterisco junto a un campo en la interfaz de usuario indica que el campo es obligatorio.
Imagen de la interfaz de usuario de Platform que muestra los detalles de destino que se deben rellenar después de la autenticación.

  • Nombre: Un nombre por el cual reconocerá este destino en el futuro.
  • Descripción: Una descripción que le ayudará a identificar este destino en el futuro.
  • Tipo de cliente: seleccione Persona o Empresa según las entidades de la audiencia. El SAP Subscription Billing esquema cambia los campos obligatorios según esta selección asignada al atributo customerType. Si la selección es Corporativa, las asignaciones obligatorias como firstName y lastName requeridas para un cliente individual se ignorarán y company se volverá obligatorio y viceversa.

Habilitar alertas enable-alerts

Puede activar alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista a la que suscribirse para recibir notificaciones sobre el estado del flujo de datos. Para obtener más información sobre las alertas, consulte la guía sobre suscripción a alertas de destinos mediante la interfaz de usuario.

Cuando termine de proporcionar detalles para la conexión de destino, seleccione Siguiente.

Activar públicos en este destino activate

IMPORTANT
  • Para activar los datos, necesita los permisos de control de acceso, Activar destinos, Ver perfiles y Ver segmentospara. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.
  • Para exportar identidades, necesita el permiso de control de acceso de] Ver gráfico de identidad[.
    Seleccione el área de nombres de identidad resaltada en el flujo de trabajo para activar audiencias en los destinos. {width="100" modal="regular"}

Lea Activar perfiles y audiencias en destinos de exportación de audiencias de streaming para obtener instrucciones sobre cómo activar audiencias en este destino.

Asignar atributos e identidades map

Para enviar correctamente los datos de audiencia de Adobe Experience Platform al destino SAP Commerce, debe pasar por el paso de asignación de campos. La asignación consiste en crear un vínculo entre los campos de esquema del Modelo de datos de experiencia (XDM) en la cuenta de Platform y sus equivalentes correspondientes desde el destino de destino. Para asignar correctamente los campos XDM a los campos de destino SAP Commerce, siga los pasos a continuación:

Asignar la identidad customerNumberSAP

La identidad customerNumberSAP es una asignación obligatoria para este destino. Siga los pasos a continuación para asignarlo:

  1. En el paso Asignación, seleccione Agregar nueva asignación. Ahora puede ver una nueva fila de asignación en la pantalla.
    Captura de pantalla de la interfaz de usuario de Platform con el botón Agregar nueva asignación resaltado.
  2. En la ventana Seleccionar campo de origen, elija Seleccionar área de nombres de identidad y seleccione customerNumberSAP.
    Captura de pantalla de la IU de Platform seleccionando correo electrónico como atributo de origen para asignar como identidad.
  3. En la ventana Seleccionar campo de destino, elija Seleccionar área de nombres de identidad y seleccione la identidad customerNumber.
    Captura de pantalla de la IU de Platform seleccionando correo electrónico como atributo de destino para asignar como identidad.
Campo de origen
Campo de destino
Obligatorio
IdentityMap: customerNumberSAP
Identity: customerNumber

A continuación, se muestra un ejemplo con la asignación de identidad:
Imagen de la interfaz de usuario de Platform que muestra un ejemplo de asignación de identidad customerNumber.

Atributos de asignación

Para agregar cualquier otro atributo que desee actualizar entre el esquema de perfil XDM y la cuenta SAP Subscription Billing, repita los pasos a continuación:

  1. En el paso Asignación, seleccione Agregar nueva asignación. Ahora puede ver una nueva fila de asignación en la pantalla.
    Captura de pantalla de la interfaz de usuario de Platform con el botón Agregar nueva asignación resaltado.
  2. En la ventana Seleccionar campo de origen, elija la categoría Seleccionar atributos y seleccione el atributo XDM.
    Captura de pantalla de IU de Platform seleccionando Apellidos como atributo de origen.
  3. En la ventana Seleccionar campo de destino, elija la categoría Seleccionar atributos personalizados y escriba el nombre del atributo SAP Subscription Billing de la lista de atributos del cliente schema.
    Captura de pantalla de IU de Platform donde lastName se define como el atributo objetivo.
IMPORTANT
Los nombres de los campos de destino distinguen entre mayúsculas y minúsculas y deben coincidir con los nombres de atributo SAP Subscription Billing. La única excepción es country, donde debería usar countryCode en su lugar. SAP Subscription Billing admite códigos de país alfa-2 (ISO 3166). El valor distingue entre mayúsculas y minúsculas y debe tener entre 0 y 3 caracteres, por lo que asegúrese de proporcionar exactamente como se definió si no encuentra errores: The country code {} does not exist o size must be between 0 and 3.

Asignar atributos de mandatory para el tipo de cliente seleccionado

Las asignaciones de atributos obligatorias dependen del tipo de cliente que haya seleccionado. Para asignar los atributos obligatorios, seleccione una de las siguientes opciones:

Cliente individual
table 0-row-3 1-row-3 2-row-3
Campo de origen Campo de destino Obligatorio
xdm: person.lastName Attribute: lastName
xdm: workAddress.countryCode Attribute: countryCode
Cliente corporativo
table 0-row-3 1-row-3 2-row-3
Campo de origen Campo de destino Obligatorio
xdm: b2b.companyName Attribute: company
xdm: workAddress.countryCode Attribute: countryCode

Asignación de atributos adicionales

A continuación, puede agregar cualquier asignación adicional entre su esquema de perfil XDM y los atributos SAP Subscription Billing schema para un cliente, como se muestra a continuación:

Cliente individual
table 0-row-3 1-row-3 2-row-3 3-row-3
Campo de origen Campo de destino Obligatorio
xdm: person.name.firstName Attribute: firstName No
xdm: workAddress.street1 Attribute: street No
xdm: workAddress.city Attribute: city No

A continuación se muestra un ejemplo con asignaciones de atributos obligatorias y opcionales en las que el cliente es un individuo:
Imagen de la interfaz de usuario de Platform que muestra un ejemplo con asignaciones de atributos obligatorias y opcionales donde el cliente es un individuo.

Cliente corporativo
table 0-row-3 1-row-3 2-row-3
Campo de origen Campo de destino Obligatorio
xdm: workAddress.street1 Attribute: street No
xdm: workAddress.city Attribute: city No

A continuación se muestra un ejemplo con asignaciones de atributos obligatorias y opcionales en las que el cliente es una empresa:
Imagen de la interfaz de usuario de Platform que muestra un ejemplo con asignaciones de atributos obligatorias y opcionales donde el cliente es una empresa.

Cuando termine de proporcionar las asignaciones para la conexión de destino, seleccione Siguiente.

Programar exportación de audiencias y ejemplo schedule-segment-export-example

Al realizar el paso Programar exportación de audiencias, debe asignar manualmente las audiencias de Platform a los atributos en SAP Subscription Billing.

A continuación se muestra un ejemplo del paso de exportación Programar audiencia con la ubicación de SAP Commerce ID de asignación resaltada:
Imagen de Platform que muestra la exportación de audiencia programada con identificadores de asignación rellenados.

Para ello, seleccione cada segmento y, a continuación, introduzca el nombre de la referencia personalizada de SAP Subscription Billing en el campo SAP Commerce ID de asignación del conector de destino. Para obtener instrucciones sobre cómo crear referencias personalizadas, consulte la sección Crear referencias personalizadas en SAP Subscription Billing.

IMPORTANT
No utilice la etiqueta de referencia personalizada como valor.
Imagen que indica que no debe usar el valor de etiqueta de referencia personalizada para la asignación.

Por ejemplo, si la audiencia de Experience Platform seleccionada es sap_audience1 y desea que su estado se actualice a la referencia personalizada SAP_1 de SAP Subscription Billing, especifique este valor en el campo SAP_Commerce Id. de asignación.

A continuación se muestra un ejemplo Tipo de referencia de SAP Subscription Billing:
Imagen que muestra dónde crear una referencia personalizada en la facturación de suscripción a SAP.

A continuación se muestra un ejemplo del paso Programar exportación de audiencias, con una audiencia seleccionada y su correspondiente SAP Commerce ID. de asignación resaltado:
Imagen de Platform que muestra la exportación de audiencia programada con identificadores de asignación rellenados.

Como se muestra, el valor dentro del campo ID de asignación debe coincidir exactamente con el valor SAP Subscription Billing Tipo de referencia

Repita esta sección para cada audiencia de Platform activada.

En función de la imagen que se muestra arriba, donde ha seleccionado dos audiencias, la asignación sería la siguiente:
| SAP Commerce nombre de audiencia | SAP Subscription Billing Tipo de referencia | Valor de SAP Commerce ID de asignación |
| — | — | — |
| sap_audience1 | SAP_1 | SAP_1 |
| Audiencia SAP2 | SAP_2 | SAP_2 |

Validar exportación de datos exported-data

Para comprobar que ha configurado correctamente el destino, siga los pasos a continuación:

Inicie sesión en la cuenta de SAP Subscription Billing y luego vaya a la página Contactos para comprobar los estados de audiencia. La lista se puede configurar para mostrar columnas para las referencias personalizadas y mostrar los estados de audiencia correspondientes.
Imagen de facturación de suscripción a SAP que muestra la página de información general del cliente con encabezados de columna que muestran el nombre de la audiencia y las celdas y los estados de audiencia

Uso de datos y gobernanza data-usage-governance

Todos los destinos de Adobe Experience Platform cumplen con las políticas de uso de datos al administrar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica el control de datos, consulte la Información general sobre el control de datos.

Errores y solución de problemas errors-and-troubleshooting

Consulte la página de documentación de SAP Subscription Billing Tipos de error para obtener una lista de posibles tipos de error y sus códigos de respuesta.

Recursos adicionales additional-resources

A continuación encontrará información útil adicional de la documentación de SAP:

Changelog

Esta sección recoge la funcionalidad y las actualizaciones significativas de la documentación realizadas en este conector de destino.

Ver registro de cambios
table 0-row-3 1-row-3 layout-auto
Mes de lanzamiento Tipo de actualización Descripción
Enero de 2024 Versión inicial Versión de destino inicial y publicación de documentación.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6