Salesforce CRM conexión

Información general overview

Salesforce CRM es una popular plataforma de administración de la relación con los clientes (CRM) y admite los tipos de perfiles que se describen a continuación:

  • 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.

Cuándo activar segmentos, puede seleccionar entre posibles clientes o contactos y actualizar los atributos y los datos de audiencia 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 sección Autenticar en el destino sección.

Casos de uso use-cases

Como experto en marketing, puede ofrecer experiencias personalizadas a los usuarios en función de los atributos de sus perfiles de Adobe Experience Platform. Puede crear audiencias a partir de los datos sin conexión y enviarlas a Salesforce CRM para actualizar la pertenencia a CRM en cuanto se actualicen las audiencias y los perfiles en Adobe Experience Platform.

Requisitos previos prerequisites

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

Antes de activar datos en el destino de Salesforce CRM, debe tener un esquema, a conjunto de datos, y segmentos creado en Experience Platform.

Requisitos previos en Salesforce CRM prerequisites-destination

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

Necesita tener un Salesforce account prerequisites-account

Vaya a la Salesforce prueba página para registrarse y crear una Salesforce cuenta, si aún no dispone de una.

Configuración de una aplicación conectada en Salesforce prerequisites-connected-app

En primer lugar, debe configurar una Salesforce aplicación conectada dentro de su Salesforce cuenta, si aún no dispone de una. Salesforce CRM aprovechará la aplicación conectada para conectarse a Salesforce.

A continuación, habilite OAuth Settings for API Integration para el Salesforce connected app. Consulte la Salesforce documentación para obtener instrucciones.

Además, asegúrese de que las variables ámbitos Las que se mencionan a continuación están seleccionadas para la Salesforce connected app.

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

Por último, asegúrese de que la variable password la concesión está habilitada dentro de su Salesforce cuenta. Consulte la Salesforce Flujo de nombre de usuario y contraseña de OAuth 2.0 para escenarios especiales documentación de si necesita ayuda.

IMPORTANT
Si su Salesforce El administrador de la cuenta ha restringido el acceso a rangos de IP de confianza. Debe ponerse en contacto con ellos para obtener IP del Experience Platform incluido en la lista de permitidos. Consulte la Salesforce Restringir el acceso a intervalos de IP fiables para una aplicación conectada documentación de si necesita instrucciones adicionales.

Creación de campos personalizados dentro de Salesforce prerequisites-custom-field

Al activar audiencias en Salesforce CRM destino, debe introducir un valor en la variable ID de asignación para cada audiencia activada, en el campo Programación de audiencia paso.

Salesforce CRM requiere este valor para leer e interpretar correctamente las audiencias que llegan desde Experience Platform y actualizar su estado de audiencia en Salesforce. 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.

Para cada audiencia que active desde Platform a Salesforce CRM, debe crear un campo personalizado del tipo Text Area (Long) dentro Salesforce. Puede definir la longitud de caracteres de campo de cualquier tamaño entre 256 y 131 072 caracteres según sus necesidades comerciales. Consulte la Salesforce Tipos de campos personalizados para obtener más información sobre los tipos de campos personalizados. Consulte también la Salesforce documentación para crear campos personalizados si necesita ayuda para la creación de campos.

IMPORTANT
No incluya espacios en blanco en el nombre del campo. En su lugar, utilice el guion bajo (_) como separador.
En Salesforce debe crear campos personalizados con una Nombre de campo que coincide exactamente con el valor especificado en ID de asignación para cada segmento de Platform activado. Por ejemplo, la captura de pantalla siguiente muestra un campo personalizado denominado crm_2_seg. Al activar una audiencia en este destino, añada crm_2_seg as ID de asignación para rellenar audiencias de audiencia de Experience Platform en este campo personalizado.

Ejemplo de creación de campos personalizados en Salesforce, Paso 1: Selección del tipo de datos, se muestra a continuación:
Captura de pantalla de la interfaz de usuario de Salesforce que muestra la creación de campos personalizados, Paso 1: Selección del tipo de datos.

Ejemplo de creación de campos personalizados en Salesforce, Paso 2: Introduzca los detalles del campo personalizado, se muestra a continuación:
Captura de pantalla de la interfaz de usuario de Salesforce que muestra la creación de campos personalizados, paso 2: introduzca los detalles del campo personalizado.

TIP
  • Para distinguir entre campos personalizados utilizados para audiencias de Platform y otros campos personalizados dentro de Salesforce puede incluir un prefijo o un sufijo reconocible al crear el campo personalizado. Por ejemplo, en lugar de test_segment, use Adobe_test_segment o test_segment_Adobe
  • Si ya ha creado otros campos personalizados en Salesforce, puede utilizar el mismo nombre que el segmento de Platform para identificar fácilmente la audiencia en Salesforce.
NOTE
  • 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 suscripciones a la audiencia de Experience Platform activas en cualquier momento.
  • Si ha alcanzado este límite en Salesforce, debe eliminar de Salesforce los atributos personalizados que se utilizaron para almacenar el estado de audiencia en audiencias antiguas de Experience Platform antes que una nueva ID de asignación se puede utilizar.

Reunir Salesforce CRM credenciales gather-credentials

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

Credencial
Descripción
Ejemplo
Username
Su Salesforce nombre de usuario de cuenta.
Password
Su Salesforce contraseña de la cuenta.
Security Token
Su Salesforce token de seguridad que adjuntará más adelante al final de su Salesforce Contraseña para crear una cadena concatenada para utilizarla como Contraseña cuando autenticación en el destino.
Consulte la Salesforce documentación para restablecer el token de seguridad para aprender a regenerarlo desde el Salesforce si no dispone del token de seguridad.
Custom Domain
Su Salesforce prefijo de dominio.
Consulte la Salesforce documentación para obtener información sobre cómo obtener este valor de Salesforce interfaz.
Si su Salesforce el dominio es
d5i000000isb4eak-dev-ed.my.salesforce.com,
usted necesitará d5i000000isb4eak-dev-ed como el valor.
Client ID
Su Salesforce Consumer Key.
Consulte la Salesforce documentación para obtener información sobre cómo obtener este valor de Salesforce interfaz.
Client Secret
Su Salesforce Consumer Secret.
Consulte la Salesforce documentación para obtener información sobre cómo obtener este valor de Salesforce interfaz.

Mecanismos de protección guardrails

Salesforce equilibra las cargas de transacción mediante la imposición de 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.

Si su Salesforce el administrador de la cuenta ha impuesto restricciones de IP, deberá agregar lo siguiente Direcciones IP del Experience Platform a su Salesforce rangos de IP de confianza de las cuentas. Consulte la Salesforce Restringir el acceso a intervalos de IP fiables para una aplicación conectada documentación de si necesita instrucciones adicionales.

IMPORTANT
Cuándo activar segmentos debe seleccionar entre Contacto o Posible cliente tipos. Debe asegurarse de que las audiencias tengan la asignación de datos adecuada según el tipo seleccionado.

Identidades admitidas supported-identities

Salesforce CRM 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
SalesforceId
El Salesforce CRM identificador de las identidades de contacto o posible cliente que exporta o actualiza a través del segmento.
Obligatorio

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 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 campo.
  • Cada estado de audiencia en Salesforce CRM se actualiza con el estado de audiencia correspondiente de Platform, en función de la variable ID de asignación valor proporcionado durante la programación de audiencia paso.
Frecuencia de exportación
Transmisión
  • Los destinos de streaming son conexiones basadas en API "siempre activadas". Tan pronto como se actualiza un perfil en Experience Platform según 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 Ver destinos y Administrar destinos permisos 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 Salesforce CRM. También puede encontrarlo en la sección CRM categoría.

Autenticarse en el destino authenticate

Para autenticarse en el destino, rellene los campos obligatorios a continuación y seleccione Conectar con destino. Consulte la Reunir Salesforce CRM credenciales para obtener cualquier guía.
| Credencial | Descripción | | — | — | | Nombre de usuario | Su Salesforce nombre de usuario de cuenta. | | Contraseña | Una cadena concatenada compuesta por su Salesforce contraseña de la cuenta adjunta a su Salesforce Token de seguridad.
El valor concatenado adopta la forma de {PASSWORD}{TOKEN}.
Tenga en cuenta que no utilice llaves ni espacios.
Por ejemplo, si su Salesforce La contraseña es MyPa$$w0rd123 y Salesforce El token de seguridad es TOKEN12345....0000, el valor concatenado que utilizará en el Contraseña el campo es MyPa$$w0rd123TOKEN12345....0000. | | Dominio personalizado | Su Salesforce prefijo de dominio.
Por ejemplo, si el dominio es d5i000000isb4eak-dev-ed.my.salesforce.com, debe proporcionar lo siguiente d5i000000isb4eak-dev-ed como el valor. | | ID de cliente | Su Salesforce aplicación conectada Consumer Key. | | Secreto del cliente | Su Salesforce aplicación conectada Consumer Secret. |

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

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

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.

  • 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 ID de Salesforce:

    • Seleccionar Contacto si las identidades que desea exportar o actualizar son del tipo Contacto.
    • Seleccionar Posible cliente si las identidades que desea exportar o actualizar son del tipo Posible cliente.

Captura de pantalla de la IU de Platform que muestra los detalles del destino.

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.

Consideraciones sobre asignación y ejemplo mapping-considerations-example

Para enviar correctamente los datos de audiencia de Adobe Experience Platform a Salesforce CRM destino, debe ir a través del 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.

Atributos especificados en la variable Campo de destino debe tener exactamente el nombre descrito en la tabla de asignaciones de atributos, ya que estos atributos formarán el cuerpo de la solicitud.

Atributos especificados en la variable Campo de origen no siga ninguna de estas restricciones. Puede asignarlo en función de sus necesidades, pero asegúrese de que el formato de los datos de entrada sea válido según el Salesforce documentación. Si los datos de entrada no son válidos, la llamada de actualización a Salesforce fallará y sus contactos o posibles clientes no se actualizarán.

Para asignar correctamente los campos XDM a (API) 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 IU de Platform para Añadir nueva asignación.

  2. En el Seleccionar campo de origen , seleccione la Seleccionar atributos y seleccione el atributo XDM o elija el Seleccionar área de nombres de identidad y seleccione una identidad.

  3. En el Seleccionar campo de destino , seleccione la Seleccionar área de nombres de identidad y seleccione una identidad o elija Seleccionar atributos personalizados y seleccione un atributo o defina uno con la variable Nombre de atributo según sea necesario. Consulte la Salesforce CRM documentación para obtener instrucciones sobre los atributos admitidos.

    • Repita estos pasos para agregar las siguientes asignaciones entre el esquema de perfil XDM y (API) Salesforce CRM:

    Trabajar con contactos

    • 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 los campos en el vínculo anterior.

    • Según los campos que desee exportar o actualizar, agregue asignaciones entre el esquema de perfil XDM y (API) Salesforce CRM: |Campo de origen|Campo de destino| Notas | | — | — | — | |IdentityMap: crmID|Identity: SalesforceId|Mandatory| |xdm: person.name.lastName|Attribute: LastName| Mandatory. Apellidos del contacto de hasta 80 caracteres. |\

      |xdm: person.name.firstName|Attribute: FirstName| Nombre del contacto de hasta 40 caracteres. | |xdm: personalEmail.address|Attribute: 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 IU de Platform que muestra asignaciones de Target.

    Uso de posibles clientes

    • 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 los campos en el vínculo anterior.

    • Según los campos que desee exportar o actualizar, agregue asignaciones entre el esquema de perfil XDM y (API) Salesforce CRM: |Campo de origen|Campo de destino| Notas | | — | — | — | |IdentityMap: crmID|Identity: SalesforceId|Mandatory| |xdm: person.name.lastName|Attribute: LastName| Mandatory. Apellidos del posible cliente de hasta 80 caracteres. |\

      |xdm: b2b.companyName|Attribute: Company| Mandatory. La compañía del líder. | |xdm: personalEmail.address|Attribute: Email| La dirección de correo electrónico del posible cliente. |

    • A continuación se muestra un ejemplo con estas asignaciones:

      Captura de pantalla de la IU de Platform que muestra asignaciones de Target.

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 Este paso requiere asignar manualmente las audiencias activadas desde Platform a su campo personalizado correspondiente en Salesforce.

Para ello, seleccione cada segmento y, a continuación, introduzca el nombre del campo personalizado en Salesforce en el Salesforce CRM ID de asignación field. Consulte la Creación de campos personalizados dentro de Salesforce para obtener instrucciones y prácticas recomendadas sobre la creación de campos personalizados en Salesforce.

Por ejemplo, si su Salesforce el campo personalizado es crm_2_seg, especifique este valor en Salesforce CRM ID de asignación para rellenar audiencias de audiencia de Experience Platform en este campo personalizado.

Un campo personalizado de ejemplo de Salesforce se muestra a continuación:
Salesforce Captura de pantalla de IU que muestra el campo personalizado.

Ejemplo que indica la ubicación del Salesforce CRM ID de asignación se muestra a continuación:
Captura de pantalla de la IU de Platform que muestra Programar exportación de audiencias.

Como se muestra arriba, Salesforce Nombre de campo coincide exactamente con el valor especificado en Salesforce CRM ID de asignación.

Según el caso de uso, todas las audiencias activadas se pueden asignar a la misma Salesforce campo personalizado o a diferentes Nombre de campo in Salesforce CRM. Un ejemplo típico basado en la imagen mostrada arriba podría ser.
| Salesforce CRM nombre del segmento | Salesforce Nombre de campo | Salesforce CRM ID de asignación | | — | — | — | | crm_1_seg | crm_1_seg | crm_1_seg | | crm_2_seg | crm_2_seg | crm_2_seg |

Repita esta sección para cada segmento de Platform activado.

Validar exportación de datos exported-data

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

  1. Seleccionar Destinos > Examinar para ir a la lista de destinos.
    Captura de pantalla de la IU de Platform que muestra destinos de exploración.

  2. Seleccione el destino y valide que el estado es activado.
    Captura de pantalla de la IU de Platform que muestra Destinations Dataflow Run.

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

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

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

    Trabajar con contactos

    • Si ha seleccionado Contactos en el segmento de Platform, vaya a Apps > Contacts página.

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

    • Seleccione una Contacto y compruebe si los campos se han actualizado. Puede ver que cada estado de la audiencia en Salesforce CRM se ha actualizado con el estado de audiencia correspondiente de Platform, según el ID de asignación valor proporcionado durante la programación de audiencia.

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

    Uso de posibles clientes

    • Si ha seleccionado Posibles clientes en el segmento de Platform y, a continuación, vaya a Apps > Leads página.

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

    • Seleccione una Posible cliente y compruebe si los campos se han actualizado. Puede ver que cada estado de la audiencia en Salesforce CRM se ha actualizado con el estado de audiencia correspondiente de Platform, según el ID de asignación valor proporcionado durante la programación de audiencia.

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

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

Se detectaron errores desconocidos al insertar eventos en el destino unknown-errors

  • Al comprobar la ejecución de un flujo de datos, puede encontrar 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 IU de Platform que muestra un error.

    • Para corregir este error, compruebe que la variable ID de asignación que ha proporcionado en el flujo de trabajo de activación a la Salesforce CRM el destino coincide exactamente con el valor del tipo de campo personalizado que ha creado en Salesforce. Consulte la Creación de campos personalizados dentro de Salesforce para obtener instrucciones.
  • Al activar un segmento, puede obtener un mensaje de error: The client's IP address is unauthorized for this account. Allowlist the client's IP address...

Recursos adicionales additional-resources

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

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6