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 catálogo de productos de SAP Customer Experience. SAP Facturación de suscripción es un producto incluido en la cartera de productos y permite una administración completa del ciclo de vida de las suscripciones con experiencias de venta y pago simplificadas mediante integraciones estandarizadas.

Esta Adobe Experience Platform destino utiliza el 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.

Instrucciones para autenticarse en su SAP Commerce más abajo, en la sección Autenticar en el destino sección.

Casos de uso use-cases

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

SAP Commerce Los clientes almacenan información sobre personas o entidades organizativas que interactúan con su empresa. Su equipo utiliza los clientes existentes en SAP Commerce para crear audiencias de Experience Platform. Después de enviar estas audiencias a SAP CommerceSin embargo, 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 todos los requisitos previos que debe configurar en Experience Platform y SAP Commerce y para la información que debe recopilar antes de trabajar con SAP Commerce destino.

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

Antes de activar los datos en SAP Commerce destino, debe tener un esquema, a conjunto de datos, y audiencias creado en Experience Platform.

Consulte la documentación del Experience Platform para Grupo de campos de esquema Detalles de pertenencia a audiencia si necesita orientación sobre los estados de audiencia.

Requisitos previos para la SAP Commerce destino prerequisites-destination

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

Debe tener un SAP Subscription Billing account prerequisites-account

Para exportar datos de Platform a su SAP Commerce cuenta, necesita tener un SAP Subscription Billing cuenta. Si no tiene una cuenta de facturación válida, póngase en contacto con su SAP administrador de cuentas. Consulte la SAP Configuración de plataforma para obtener más información.

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

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

    • ID de cliente
    • Secreto de cliente
    • URL. El patrón de URL es el siguiente: https://subscriptionbilling.authentication.eu10.hana.ondemand.com. Este valor se utilizará más adelante para obtener valores para 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"
}

Creación de referencias personalizadas en SAP Subscription Billing prerequisites-custom-reference

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

Para crear las referencias personalizadas, inicie sesión en su SAP Subscription Billing y vaya a la [Datos maestros y configuración] > [Referencias personalizadas] página. A continuación, seleccione Crear para añadir una nueva referencia a cada audiencia seleccionada en Platform. Necesitará estos nombres de campo de referencia en los siguientes Programar exportación de audiencias y ejemplo paso.

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

Para obtener más información, consulte la SAP Subscription Billing referencias personalizadas documentación.

Recopilar credenciales necesarias gather-credentials

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

Credencial
Descripción
ID de cliente
El valor de clientId desde la clave de servicio.
Secreto de cliente
El valor de clientSecret desde la clave de servicio.
Extremo
El valor de url desde 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 el url y tiene un valor similar al siguiente eu10 o us10. Por ejemplo, si la variable url es https://eu10.revenue.cloud.sap/api necesita eu10.

Mecanismos de protección guardrails

Solicitudes de API a SAP Cloud Management service están sujetos a Límites de velocidad. Cuando se supera el límite de tasa, se encontrará con un HTTP 429 Too Many Requests código de estado de respuesta

Identidades admitidas supported-identities

SAP Commerce admite la actualización de identidades que se describe en la tabla siguiente. Más información sobre identidades.

Identidad de destino
Descripción
Consideraciones
customerNumberSAP
Un identificador de cliente del cliente individual o corporativo ya presente en su SAP Commerce cuenta.
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 audiencia
Descripción
Segmentation Service
Cargas personalizadas

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 perfiles
  • Está exportando 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 campo.
  • Para cada audiencia seleccionada en Platform, la correspondiente SAP Commerce Un atributo adicional 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 Administrar destinos permiso de control de acceso. Lea el información general de 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 la sección 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, buscar SAP Commerce. También puede encontrarlo en la sección eCommerce categoría.

Autenticarse en el destino authenticate

Rellene los campos obligatorios siguientes. Consulte la Generación de una clave de servicio para obtener cualquier guía.

Campo
Descripción
ID de cliente
El valor de clientId desde la clave de servicio.
Secreto de cliente
El valor de clientSecret desde la clave de servicio.
Extremo
El valor de url desde 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 el url y tiene un valor similar al siguiente eu10 o us10. Por ejemplo, si la variable url es https://eu10.revenue.cloud.sap/api necesita eu10.

Para autenticarse en el destino, seleccione Conectar con 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 muestra un Conectado estado 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 con el que 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 una de las siguientes opciones Individual o Corporativo según las entidades de la audiencia. El SAP Subscription Billing esquema cambia los campos obligatorios en función de esta selección, que se asigna al customerType atributo. Si la selección es Corporativo, luego las asignaciones obligatorias como firstName y lastName requerido para un cliente individual se ignorará y company se convierte en 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 de suscripción a alertas de destinos mediante la IU.

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

Activar públicos en este destino activate

IMPORTANT

Leer Activación de perfiles y audiencias en destinos de exportación de audiencia 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 a SAP Commerce destino, 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 SAP Commerce campos de destino, siga los pasos a continuación:

Asignar el customerNumberSAP identidad

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

  1. En el Asignación paso, seleccione Añadir nueva asignación. Ahora puede ver una nueva fila de asignación en la pantalla.
    Captura de pantalla de la IU de Platform con el botón Añadir nueva asignación resaltado.
  2. En el Seleccionar campo de origen , seleccione la Seleccionar área de nombres de identidad y seleccione customerNumberSAP.
    Captura de pantalla de la IU de Platform seleccionando el correo electrónico como atributo de origen para asignarlo como identidad.
  3. En el Seleccionar campo de destino , seleccione la Seleccionar área de nombres de identidad y seleccione la customerNumber identidad.
    Captura de pantalla de la IU de Platform seleccionando el correo electrónico como atributo de destino para asignarlo 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 IU 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 variable SAP Subscription Billing Cuenta de, repita los pasos siguientes:

  1. En el Asignación paso, seleccione Añadir nueva asignación. Ahora puede ver una nueva fila de asignación en la pantalla.
    Captura de pantalla de la IU de Platform con el botón Añadir nueva asignación resaltado.
  2. En el Seleccionar campo de origen , seleccione la Seleccionar atributos y seleccione el atributo XDM.
    Captura de pantalla de la IU de Platform seleccionando Apellidos como atributo de origen.
  3. En el Seleccionar campo de destino ventana, elija Seleccionar atributos personalizados categoría y escriba el nombre de la SAP Subscription Billing atributo de la lista de clientes esquema atributos.
    Captura de pantalla de la 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 el SAP Subscription Billing nombres de atributos. La única excepción es country dónde debe utilizar 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ó. De lo contrario, encontrará errores: The country code {} does not exist o size must be between 0 and 3.

Mapa mandatory atributos del tipo de cliente seleccionado

Las asignaciones de atributos obligatorias dependen del Tipo de cliente que ha 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 el esquema de perfil XDM y la variable SAP Subscription Billing esquema atributos 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 IU de Platform que muestra un ejemplo con asignaciones de atributos obligatorias y opcionales en el que 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 IU de Platform que muestra un ejemplo con asignaciones de atributos obligatorias y opcionales en el que el cliente es una empresa.

Cuando haya terminado 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 la Programar exportación de audiencias , debe asignar manualmente las audiencias de Platform a la variable atributos in SAP Subscription Billing.

Ejemplo del paso Programar exportación de audiencias, con la ubicación del SAP Commerce ID de asignación resaltado, se muestra a continuación:
Imagen de Platform que muestra la exportación de audiencia de programación con los ID de asignación rellenados.

Para ello, seleccione cada segmento e introduzca el nombre de la referencia personalizada desde SAP Subscription Billing en el SAP Commerce ID de asignación campo conector de destino. Para obtener instrucciones sobre la creación de referencias personalizadas, consulte la Creación de referencias personalizadas en SAP Subscription Billing sección.

IMPORTANT
No utilice la etiqueta de referencia personalizada como valor.
Imagen que indica que no se debe utilizar 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 SAP Subscription Billing referencia personalizada SAP_1, especifique este valor en SAP_Commerce ID de asignación field.

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

Ejemplo del paso Programar exportación de audiencias, con una audiencia seleccionada y su correspondiente SAP Commerce ID de asignación resaltado, se muestra a continuación:
Imagen de Platform que muestra la exportación de audiencia de programación con los ID de asignación rellenados.

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

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 | SAP Commerce ID de asignación valor | | — | — | — | | 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 SAP Subscription Billing y, a continuación, vaya a la 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 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

Todo Adobe Experience Platform Los destinos de cumplen con las políticas de uso de datos al gestionar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica la gobernanza de datos. Consulte la Resumen de gobernanza de datos.

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

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

Recursos adicionales additional-resources

Información útil adicional del SAP Esta documentación es:

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