Salesforce CRM connection

Información general

Salesforce CRM es una plataforma popular de administración de la relación con los clientes (CRM) y es compatible con lo siguiente:

  • Posibles clientes - Un posible cliente es el nombre de una persona o empresa que puede (o no) estar interesada en los productos o servicios que vende.
  • Contactos - Un contacto es una persona con la que uno de sus representantes ha establecido una relación y ha sido calificado como cliente potencial.

Esta Adobe Experience Platform destino aprovecha el Salesforce composite API, que admite ambos tipos de perfiles descritos anteriormente.

When activación de segmentos, puede seleccionar entre posibles clientes o contactos y actualizar atributos y segmentar datos en Salesforce CRM.

Salesforce CRM utiliza OAuth 2 con Concesión de contraseña como mecanismo de autenticación para comunicarse con la API de REST de Salesforce. Instrucciones para autenticarse en su Salesforce CRM más abajo, en la Autenticar en destino para obtener más información.

Casos de uso

Como especialista en marketing, puede ofrecer experiencias personalizadas a los usuarios en función de los atributos de sus perfiles de Adobe Experience Platform. Puede generar segmentos a partir de los datos sin conexión y enviarlos a Salesforce CRM para que se muestren en las fuentes de los usuarios en cuanto los segmentos y perfiles se actualicen en Adobe Experience Platform.

Requisitos previos

Requisitos previos en el Experience Platform

Antes de activar los datos en el destino de Salesforce CRM, debe tener una esquema, conjunto de datosy segmentos creado en Experience Platform.

Requisitos previos en Salesforce CRM

Tenga en cuenta los siguientes requisitos previos en Salesforce CRM, para exportar datos de Platform a su cuenta de Salesforce:

Necesita una cuenta de Salesforce

Vaya a Salesforce prueba para registrar y crear una cuenta de Salesforce, si todavía no la tiene.

Configurar una aplicación conectada

A continuación, debe configurar un aplicación conectada en su cuenta de Salesforce, si todavía no tiene una.

Dentro de la aplicación conectada, asegúrese de que Configuración de OAuth está activada.

Asegúrese también de que la variable ámbitos a continuación se seleccionan.

  • chatter_api
  • lightning
  • visualforce
  • content
  • openid
  • full
  • api
  • web
  • refresh_token
  • offline_access

Crear campo personalizado en Salesforce

Cree el campo personalizado de tipo Text Area Long, que el Experience Platform utilizará para actualizar el estado del segmento en Salesforce CRM.
Consulte la documentación de Salesforce para crear campos personalizados si necesita más instrucciones.

IMPORTANTE

Asegúrese de que no haya caracteres de espacio en blanco en el nombre del campo. En su lugar, utilice el guión bajo (_) como separador.

NOTA
  • Los objetos de Salesforce están restringidos a 25 campos externos, consulte Atributos de campo personalizados.
  • Esta restricción implica que solo puede tener un máximo de 25 miembros de segmentos de Experience Platform activos en cualquier momento.
  • Si ha alcanzado este límite en Salesforce, debe eliminar el atributo personalizado de Salesforce que se utilizó para almacenar el estado del segmento en segmentos antiguos dentro de Experience Platform antes de una nueva ID de asignación se puede usar.

Consulte la documentación de Adobe Experience Platform para Grupo de campos de esquema Detalles de pertenencia a segmentos si necesita instrucciones sobre los estados de los segmentos.

Recopilar credenciales de Salesforce

Tenga en cuenta los elementos siguientes antes de autenticarse en la variable Salesforce CRM destino:

Credencial Descripción Ejemplo
  • Prefijo de dominio de Salesforce
Consulte Prefijo de dominio de Salesforce para obtener más información.
  • Si su dominio es el siguiente, necesita el valor resaltado.
    d5i000000isb4eak-dev-ed.my.salesforce.com
  • Clave del consumidor
  • Secreto del consumidor
Consulte la Documentación de Salesforce si necesita más instrucciones.
  • r23kxxxxxxx0z05xxxxxx
  • ipxxxxxxxxxxT4xxxxxxxxx

Límites de protección

Salesforce equilibra las cargas de transacciones imponiendo límites de solicitud, tasa y tiempo de espera. Consulte la Límites y asignaciones de solicitudes de API para obtener más información.

IMPORTANTE

When activación de segmentos debe seleccionar entre Contacto o Posible cliente tipos. Debe asegurarse de que los segmentos tengan la asignación de datos adecuada según el tipo seleccionado.

Identidades compatibles

Salesforce CRM admite la actualización de identidades descritas en la siguiente tabla. Más información sobre identidades.

Identidad de Target Descripción Consideraciones
SalesforceId La variable Salesforce CRM identificador de las identidades de contacto o posible cliente que exporta o actualiza a través del segmento. Obligatorio

Tipo de exportación y frecuencia

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 un segmento, 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.
  • Cada estado de segmento en Salesforce CRM se actualiza con el estado del segmento correspondiente de Platform, en función de la variable ID de asignación valor proporcionado durante el programación de segmentos paso a paso.
Frecuencia de exportación Transmisión
  • Los destinos de flujo continuo son conexiones basadas en API "siempre activadas". Tan pronto como un perfil se actualiza en el Experience Platform en función de la evaluación de segmentos, el conector envía la actualización descendente a la plataforma de destino. Más información sobre destinos de flujo continuo.

Conectarse al destino

IMPORTANTE

Para conectarse al destino, necesita la variable Administrar destinos permiso de control de acceso. Lea el información general sobre el 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 que aparecen en las dos secciones siguientes.

Within Destinos > Catálogo buscar Salesforce CRM. También puede localizarlo en la sección CRM categoría.

Autenticar en destino

Para autenticarse en el destino, rellene los campos obligatorios y seleccione Conectarse al destino.

Captura de pantalla de la interfaz de usuario de Platform que muestra cómo autenticarse.

  • Contraseña: La contraseña de su cuenta de Salesforce.
  • Dominio personalizado: Su dominio de Salesforce.
  • ID de cliente: La clave de consumidor de la aplicación conectada a Salesforce.
  • Secreto del cliente: El Secreto del consumidor de la aplicación conectada de Salesforce.
  • Nombre de usuario: El nombre de usuario de su cuenta de Salesforce.

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

Rellenar detalles de destino

Para configurar los detalles del destino, rellene los campos opcionales y requeridos a continuación. Un asterisco junto a un campo en la interfaz de usuario indica que el campo es obligatorio.
Captura de pantalla de la interfaz de usuario de Platform que muestra los detalles del destino.

  • Nombre: Un nombre por el cual reconocerá este destino en el futuro.
  • Descripción: Descripción que le ayudará a identificar este destino en el futuro.
  • Tipo de ID de Salesforce: Select Contacto si las identidades que desea exportar o actualizar son del tipo Contacto. Select Posible cliente si las identidades que desea exportar o actualizar son del tipo Posible cliente.

Habilitar alertas

Puede activar las alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista para suscribirse y recibir notificaciones sobre el estado de su 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 interfaz de usuario.

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

Activar segmentos en este destino

IMPORTANTE

Para activar los datos, necesita la variable Administrar destinos, Activar destinos, Ver perfiles y Ver segmentos permisos de control de acceso. Lea el información general sobre el control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.

Lectura Activar perfiles y segmentos en destinos de exportación de segmentos de flujo continuo para obtener instrucciones sobre la activación de segmentos de audiencia en este destino.

Consideraciones de asignación y ejemplo

Para enviar correctamente los datos de audiencia de Adobe Experience Platform a Salesforce CRM destino, debe pasar por el paso de asignación de campos. La asignación consiste en la creación de 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 la variable Salesforce CRM campos de destino, siga estos pasos:

  1. En el Asignación paso, seleccione Añadir nueva asignación, verá una nueva fila de asignación en la pantalla .
    Ejemplo de captura de pantalla de la interfaz de usuario de Platform para Añadir nueva asignación.

  2. En el Seleccionar campo de origen , seleccione Seleccionar área de nombres de identidad o Seleccionar atributos categoría y seleccione crmID.
    Ejemplo de captura de pantalla de la interfaz de usuario de Platform para la asignación de origen.

  3. En el Seleccionar campo de destino , seleccione Seleccionar área de nombres de identidad categoría y seleccione SalesforceId.
    Captura de pantalla de la interfaz de usuario de Platform que muestra la asignación de Target para SalesforceId.

    • Añada la siguiente asignación entre el esquema de perfil XDM y el Salesforce CRM instancia:
    Esquema de perfil XDM Salesforce CRM Instancia Obligatorio
    crmID SalesforceId
    • Seleccionar atributos personalizados: seleccione esta opción para asignar el campo de origen a un atributo personalizado que haya definido en la variable Nombre del atributo campo . Consulte la Salesforce CRM documentación para obtener instrucciones sobre los atributos admitidos.

      Captura de pantalla de la interfaz de usuario de Platform que muestra la asignación de Target para LastName.

    • Si está trabajando con Contactos dentro del segmento, consulte la Referencia de objeto en Salesforce para Contacto para definir asignaciones para los campos que se van a actualizar.

    • Puede identificar los campos obligatorios buscando la palabra Requerido, que se menciona en las descripciones de campo en el vínculo anterior.

    • En función de los campos que desee exportar o actualizar, agregue asignaciones entre el esquema de perfil XDM y el Salesforce CRM instancia:

    Esquema de perfil XDM Salesforce CRM Instancia Notas
    person.name.lastName LastName Required. Apellido del contacto de hasta 80 caracteres.
    person.name.firstName FirstName El nombre del contacto puede contener hasta 40 caracteres.
    personalEmail.address Email La dirección de correo electrónico del contacto.
    • A continuación se muestra un ejemplo con estas asignaciones:

      Captura de pantalla de la interfaz de usuario de Platform que muestra asignaciones de Target.

    • Si está trabajando con Posibles clientes dentro del segmento, consulte la Referencia de objeto en Salesforce para Posible cliente para definir asignaciones para los campos que se van a actualizar.

    • Puede identificar los campos obligatorios buscando la palabra Requerido, que se menciona en las descripciones de campo en el vínculo anterior.

    • En función de los campos que desee exportar o actualizar, agregue asignaciones entre el esquema de perfil XDM y el Salesforce CRM instancia:

    Esquema de perfil XDM Salesforce CRM Instancia Notas
    person.name.lastName LastName Required. Apellido del contacto de hasta 80 caracteres.
    b2b.companyName Company Required. La compañía del líder.
    personalEmail.address Email La dirección de correo electrónico del contacto.
    • A continuación se muestra un ejemplo con estas asignaciones:

      Captura de pantalla de la interfaz de usuario de Platform que muestra asignaciones de Target.

Programar exportación de segmentos y ejemplo

Al realizar el Programar exportación de segmentos debe asignar manualmente los segmentos de Platform al atributo de campo personalizado en Salesforce.

Para ello, seleccione cada segmento e introduzca el atributo de campo personalizado correspondiente de Salesforce en la ID de asignación campo .

IMPORTANTE
  • El valor utilizado para la variable ID de asignación debe coincidir exactamente con el nombre del atributo de campo personalizado creado en Salesforce.
  • Asegúrese de que el nombre del atributo de campo personalizado que ha creado en Salesforce no utilice el carácter de espacio en blanco.

A continuación se muestra un ejemplo:
Captura de pantalla de la interfaz de usuario de Platform que muestra Programar exportación de segmentos.

Validación de la exportación de datos

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

  1. Select Destinos > Examinar para navegar a la lista de destinos.
    Captura de pantalla de la interfaz de usuario de Platform que muestra los destinos de exploración.

  2. Seleccione el destino y valide que el estado es enabled.
    Captura de pantalla de la interfaz de usuario de Platform que muestra la ejecución del flujo de datos de Destinations.

  3. Cambie a la Datos de activación y, a continuación, seleccione un nombre de segmento.
    Captura de pantalla de la interfaz de usuario de Platform que muestra los datos de activación de destinos.

  4. Monitorice el resumen del segmento y asegúrese de que el recuento de perfiles corresponde al recuento creado dentro del segmento.
    Captura de pantalla de la interfaz de usuario de Platform que muestra el segmento.

  5. Finalmente, inicie sesión en el sitio web de Salesforce y valide si los perfiles del segmento se han agregado o actualizado.

    • Si Contactos dentro del segmento Plataforma , vaya a la Apps > Contacts página.

      Captura de pantalla de Salesforce CRM que muestra la página Contactos con los perfiles del segmento.

    • Seleccione un Contacto y compruebe si los campos se actualizan. Puede ver cada estado de segmento en Salesforce CRM se actualizó con el estado del segmento correspondiente de Platform, en función de la variable ID de asignación valor proporcionado durante el programación de segmentos.

      Captura de pantalla de Salesforce CRM que muestra la página Detalles de contacto con estados de segmento actualizados.

    • Si Posibles clientes dentro del segmento Plataforma y, a continuación, vaya a la Apps > Leads página.

      Captura de pantalla de Salesforce CRM que muestra la página Posibles clientes con los perfiles del segmento.

    • Seleccione un Posible cliente y compruebe si los campos se actualizan. Puede ver cada estado de segmento en Salesforce CRM se actualizó con el estado del segmento correspondiente de Platform, en función de la variable ID de asignación valor proporcionado durante el programación de segmentos.

      Captura de pantalla de Salesforce CRM que muestra la página Detalles del posible cliente con estados de segmento actualizados.

Uso y gobernanza de los datos

Todo Adobe Experience Platform Los destinos de cumplen las políticas de uso de datos al administrar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform exige el control de datos; consulte Información general sobre la administración de datos.

Errores y solución de problemas

Se han encontrado errores desconocidos al insertar eventos en el destino

Al comprobar la ejecución de un flujo de datos, si obtiene el siguiente mensaje de error: Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.

Captura de pantalla de la interfaz de usuario de Platform que muestra el error.

Para solucionar este error, compruebe que la variable ID de asignación ha proporcionado Salesforce CRM para su segmento de Platform es válido y existe dentro de Salesforce CRM.

Recursos adicionales

Información útil adicional de Portal para desarrolladores de Salesforce a continuación:

En esta página