SendGrid connection

Información general

SendGrid es una plataforma de comunicación popular para clientes que envía correos electrónicos de marketing y transaccionales.

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 en 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 de SendGrid.

Requisitos previos

Los siguientes elementos son necesarios antes de empezar a configurar el destino.

  1. Debe tener una cuenta de SendGrid.
    • Ir a SendGrid signup para registrar y crear una cuenta de SendGrid, si todavía no la tiene.
  2. Después de iniciar sesión en el portal de SendGrid, también debe generar un token de API.
  3. Vaya al sitio web de SendGrid y acceda al Settings > API Keys página. También puede consultar la Documentación de SendGrid para acceder a la sección correspondiente de la aplicación SendGrid.
  4. Finalmente, seleccione la Create API Key botón.

Antes de activar los datos en el destino de SendGrid, debe tener una esquema, conjunto de datosy segmentos creado en Experience Platform. Consulte también la límites más abajo en esta página.

IMPORTANTE
  • 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 es independientemente de si se utiliza como valor para email o correo electrónico alternativo. Dado que la conexión SendGrid admite asignaciones para valores de correo electrónico y de correo electrónico alternativo, asegúrese de que todas las direcciones de correo electrónico utilizadas sean únicas dentro de cada perfil del Conjunto de datos. De lo contrario, cuando los perfiles de correo electrónico se envían a SendGrid, el resultado es un error y ese perfil de correo electrónico no estará presente en la exportación de datos.

  • Actualmente, no hay ninguna funcionalidad para eliminar perfiles de SendGrid cuando se eliminan de segmentos en el Experience Platform.

Identidades compatibles

SendGrid admite la activación de identidades descritas en la siguiente tabla. Más información sobre identidades.

Identidad de Target Descripción Consideraciones
email Correo electrónico Dirección Tenga en cuenta que tanto el texto sin formato como las direcciones de correo electrónico con hash SHA256 son compatibles con Adobe Experience Platform. Si el campo de origen de Experience Platform contiene atributos sin hash, marque la casilla de verificación Aplicar transformación para Platform hash automático de los datos al activarlos.

Tenga en cuenta que SendGrid no admite direcciones de correo electrónico con hash, por lo que solo se envían al destino los datos de texto sin formato sin transformación.

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), 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 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.

Casos de uso

Para ayudarle a comprender mejor cómo y cuándo debe utilizar el destino SendGrid, estos son ejemplos de casos de uso que Experience Platform los clientes de pueden resolver utilizando este destino.

Crear una lista de marketing para varias actividades de marketing

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 creada en SendGrid puede utilizarse posteriormente para varias actividades de marketing.

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.

Autenticar en destino

  1. Dentro de Adobe Experience Platform consola, vaya a Destinos.

  2. Seleccione el Catálogo y busque SendGrid. A continuación, seleccione Configuración. Después de establecer una conexión con el destino, la etiqueta de la interfaz de usuario cambia a Activar segmentos.

  3. Se le muestra un asistente que le ayuda a configurar el destino de SendGrid. Cree el nuevo destino seleccionando Configurar nuevo destino.

  4. Seleccione el Nueva cuenta y rellene la Token del portador valor. Este valor es SendGrid Clave de API mencionado anteriormente en la sección sección de requisitos previos.

  5. Select Conectarse al destino. Si el objeto SendGrid Clave de API la interfaz de usuario que ha proporcionado es válida, muestra una Conectado con una marca de verificación verde, puede continuar con el siguiente paso para rellenar campos de información adicionales.

Rellenar detalles de destino

While configuración Para este destino, debe proporcionar la siguiente información:

  • Nombre: El nombre por el que reconocerá este destino en el futuro.
  • Descripción: Una descripción opcional que le ayudará a identificar este destino en el futuro.

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.

Consulte las siguientes imágenes para obtener detalles específicos sobre este destino.

  1. Seleccione uno o varios segmentos para exportar a SendGrid.

  2. En el Asignación paso, después de seleccionar Añadir nueva asignació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 imágenes siguientes muestran cómo asignar áreas de nombres de identidad entre Experience Platform y SendGrid. Asegúrese de que la variable Campo de origen Correo electrónico debe asignarse a la variable Campo de destino external_id como se muestra a continuación.



  3. Del mismo modo, asigne el Adobe Experience Platform atributos que desea exportar al destino de SendGrid.

  4. Después de completar las asignaciones, seleccione Siguiente para pasar a la pantalla de revisión.

  5. Select Finalizar para completar la configuración.

La lista completa de asignaciones de atributos compatibles que se pueden configurar para la variable Contactos de marketing de SendGrid > Agregar o actualizar la API de contacto a continuación.

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.alternative_emails
xdm:
alternative_emails
Matriz de cadena Correos electrónicos adicionales asociados al contacto.
  • Máx.: 5 elementos
  • Mínimo: 0 artículos
xdm:
homeAddress.city
xdm:
city
Cadena La ciudad del contacto. Longitud máxima:
60 caracteres
xdm:
homeAddress.country
xdm:
country
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 El 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.
xdm:
homeAddress.stateProvincia
xdm:
state_provincia_región
Cadena Estado, provincia o región del contacto. Longitud máxima:
50 caracteres

Validación de la exportación de datos dentro de SendGrid

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.

  2. Seleccione el destino y valide que el estado es enabled.

  3. Cambie a la Activation data y, a continuación, seleccione un nombre de segmento.

  4. Monitorice el resumen del segmento y compruebe el recuento de perfiles correspondientes al recuento creado dentro del conjunto de datos.

  5. La variable Listas de marketing de SendGrid > Crear API de lista se utiliza para crear listas de contactos únicas dentro de SendGrid uniendo el valor de list_name y la marca de tiempo de la exportación de datos. Vaya al sitio SendGrid y compruebe si se crea la nueva lista de contactos que se ajusta al patrón de nombres.

  6. 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 en la nueva lista de contactos.

  7. Además, compruebe también un par de correos electrónicos para validar si la asignación de campos es correcta.

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.

Recursos adicionales

Este destino de SendGrid aprovecha las siguientes API:

Límites

En esta página