SendGrid es una plataforma de comunicación popular entre los clientes para correos electrónicos transaccionales y de marketing.
Esta Adobe Experience Platform destino aprovecha el SendGrid Marketing Contacts API, que le permite exportar sus perfiles de correo electrónico de origen y activarlos dentro de un nuevo segmento de SendGrid para sus necesidades comerciales.
SendGrid utiliza tokens de portador de API como mecanismo de autenticación para comunicarse con la API SendGrid.
Se requieren los siguientes elementos antes de comenzar a configurar el destino.
Antes de activar datos en el destino SendGrid, debe tener un esquema, a conjunto de datos, y segmentos creado en Experience Platform. Consulte también la límites más abajo en esta página.
La API SendGrid utilizada para crear la lista de correo a partir de perfiles de correo electrónico requiere que se proporcionen direcciones de correo electrónico únicas dentro de cada perfil. Esto ocurre independientemente de si se utiliza como valor para email o correo electrónico alternativo. Dado que la conexión SendGrid admite asignaciones tanto para valores de correo electrónico como para valores de correo electrónico alternativos, asegúrese de que todas las direcciones de correo electrónico utilizadas deban ser únicas dentro de cada perfil del Conjunto de datos. De lo contrario, cuando los perfiles de correo electrónico se envíen a SendGrid, el resultado será un error y el perfil de correo electrónico no estará presente en la exportación de datos.
Actualmente, no hay ninguna funcionalidad para quitar perfiles de SendGrid cuando se eliminan de segmentos en Experience Platform.
SendGrid admite la activación de identidades descritas en la tabla siguiente. Más información sobre identidades.
Identidad de destino | Descripción | Consideraciones |
---|---|---|
Correo electrónico Dirección | Tenga en cuenta que las direcciones de correo electrónico con hash SHA256 y texto sin formato son compatibles con Adobe Experience Platform. Si el campo Origen de Experience Platform contiene atributos sin hash, consulte la Aplicar transformación opción, para tener Platform hash automático de los datos en la activación. Tenga en cuenta que SendGrid no admite direcciones de correo electrónico con hash, por lo que solo se envían al destino datos de texto sin transformación. |
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 | Va a exportar 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), tal como se elige en la pantalla seleccionar atributos de perfil del flujo de trabajo de activación de destino. |
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 segmentos, el conector envía la actualización de forma descendente a la plataforma de destino. Más información sobre destinos de streaming. |
Para ayudarle a comprender mejor cómo y cuándo debe utilizar el destino SendGrid, aquí hay ejemplos de casos de uso que Experience Platform Los clientes de pueden resolver utilizando este destino.
Los equipos de marketing que utilizan SendGrid pueden crear una lista de correo dentro de SendGrid y rellenarla con direcciones de correo electrónico. La lista de correo ahora creada en SendGrid se puede utilizar posteriormente para varias actividades de marketing.
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.
Dentro de Adobe Experience Platform consola, vaya a Destinos.
Seleccione el Catálogo pestaña y busque SendGrid. A continuación seleccione Configuración de. Después de establecer una conexión con el destino, la etiqueta de la interfaz de usuario cambia a Activar segmentos.
Se le mostrará un asistente que le ayudará a configurar el destino de SendGrid. Cree el nuevo destino seleccionando Configurar nuevo destino.
Seleccione el Nueva cuenta y rellene el campo Token de portador valor. Este valor es SendGrid Clave de API anteriormente mencionado en la sección de requisitos previos.
Seleccionar Conectar con destino. Si la propiedad SendGrid Clave de API Si el valor proporcionado es válido, la interfaz de usuario muestra un Conectado estado con una marca de verificación verde, puede continuar con el siguiente paso para rellenar campos de información adicional.
While configuración Para este destino, debe proporcionar la siguiente información:
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.
Para activar los datos, necesita el Administrar destinos, Activar destinos, Ver perfiles, y Ver segmentos 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.
Leer Activación de perfiles y segmentos en destinos de exportación de segmentos de flujo continuo para obtener instrucciones sobre cómo activar segmentos de audiencia en este destino.
Consulte las siguientes imágenes para obtener detalles específicos sobre este destino.
Seleccione uno o varios segmentos para exportar a SendGrid.
En el Asignación paso, después de seleccionar Añadir nueva asignación A continuación, se muestra la página de asignación para asignar los campos XDM de origen a los campos de destino de la API SendGrid. Las siguientes imágenes muestran cómo asignar áreas de nombres de identidad entre Experience Platform y SendGrid. Asegúrese de que Campo de origen Correo electrónico debe asignarse al Campo de destino external_id como se muestra a continuación.
Del mismo modo, asigne los Adobe Experience Platform atributos que desea exportar al destino SendGrid.
Después de completar las asignaciones, seleccione Siguiente para avanzar a la pantalla de revisión.
Seleccionar Finalizar para completar la configuración.
La lista completa de asignaciones de atributos admitidas que se pueden configurar para la variable Contactos de marketing de SendGrid > Agregar o actualizar API de contacto es inferior a.
Campo de origen | Campo de destino | Tipo | Descripción | Límites |
---|---|---|---|---|
xdm: homeAddress.street1 |
xdm: address_line_1 |
Cadena | La primera línea de la dirección. | Longitud máxima: 100 caracteres |
xdm: homeAddress.street2 |
xdm: address_line_2 |
Cadena | Una segunda línea opcional para la dirección. | Longitud máxima: 100 caracteres |
xdm: _extconndev.alternate_emails |
xdm: alternate_emails |
Matriz de cadena | Correos electrónicos adicionales asociados con el contacto. |
|
xdm: homeAddress.city |
xdm: ciudad |
Cadena | La ciudad del contacto. | Longitud máxima: 60 caracteres |
xdm: homeAddress.country |
xdm: país |
Cadena | El país del contacto. Puede ser un nombre completo o una abreviatura. | Longitud máxima: 50 caracteres |
identityMap: Correo electrónico |
Identidad: external_id |
Cadena | Correo electrónico principal del contacto. Debe ser un correo electrónico válido. | Longitud máxima: 254 caracteres |
xdm: person.name.firstName |
xdm: first_name |
Cadena | El nombre del contacto | Longitud máxima: 50 caracteres |
xdm: person.name.lastName |
xdm: last_name |
Cadena | El apellido del contacto | Longitud máxima: 50 caracteres |
xdm: homeAddress.postalCode |
xdm: postal_code |
Cadena | El código postal del contacto u otro código postal. | |
xdm: homeAddress.stateProvince |
xdm: state_Province_region |
Cadena | El estado, la provincia o la región del contacto. | Longitud máxima: 50 caracteres |
Para comprobar que ha configurado correctamente el destino, siga los pasos a continuación:
Seleccionar Destinos > Examinar para ir a la lista de destinos.
Seleccione el destino y valide que el estado es activado.
Cambie a la Activation data y, a continuación, seleccione un nombre de segmento.
Monitorice el resumen del segmento y compruebe que el recuento de perfiles corresponde al recuento creado dentro del conjunto de datos.
El Listas de marketing de SendGrid > Crear lista API se utiliza para crear listas de contactos únicas dentro de SendGrid uniendo el valor del list_name y la marca de tiempo de la exportación de datos. Vaya al sitio SendGrid y compruebe si se ha creado la nueva lista de contactos que se ajusta al patrón de nombre.
Seleccione la lista de contactos recién creada y compruebe si el nuevo registro de correo electrónico del conjunto de datos que ha creado se está rellenando dentro de la nueva lista de contactos.
Además, compruebe también un par de correos electrónicos para validar si la asignación de campos es correcta.
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.
Este destino de SendGrid aprovecha las siguientes API: