Integración de Recommendations con el correo electrónico
Adobe Target admite la personalización en tiempo de envío de recomendaciones en correos electrónicos.
Están disponibles tres métodos para integrar Target Recommendations con su proveedor de servicios de correo electrónico (ESP). Las capacidades de su ESP determinan qué método utilizar. Su administrador de cuentas o asesor puede ayudarle a elegir la opción más adecuada para usted.
El uso del método 1 o el método 2 requiere que su ESP realice llamadas a una API externa por cliente o por correo electrónico y espere a que se devuelva el contenido. Estos métodos no son compatibles con todos los ESP; póngase en contacto con su ESP para determinar si es compatible con este patrón de integración.
El uso del método 3 requiere que su ESP adjunte una lista de recomendaciones por ID de producto o ID de categoría a su lista de correos electrónicos. Este método se puede basar en un atributo como el último producto visualizado del cliente, el último producto comprado o la categoría más visitada. Sin embargo, su ESP debe tener acceso a estos datos en su perfil de cliente para poder realizar la unión. Póngase en contacto con su ESP para determinar si tiene acceso a estos datos y si es compatible con este patrón de integración.
La personalización en tiempo abierto de recomendaciones no es compatible con Adobe Target.
- Las solicitudes deben estar limitadas a una tasa menor de 1000 solicitudes por segundo o 25 veces el tráfico diario máximo.
- Tráfico de rampa en pasos de 200 solicitudes por segundo cada minuto.
Método 1: usar la API de entrega (preferido) delivery-api
La API de envío es una solicitud POST que funciona con la hora de creación de correo electrónico. Esta opción es el método preferido para la hora de creación de correo electrónico.
La mayoría de los clientes de correo electrónico no aceptan solicitudes POST; por tanto, no se recomienda esta API para los casos de uso de hora de apertura. Algunos clientes de correo electrónico, como Gmail o Outlook, podrían guardar el contenido en caché o bloquear la imagen y exigir al destinatario que permita activamente que se muestre la imagen.
No se puede devolver contenido predeterminado mediante la API de envío.
El siguiente código es un ejemplo de solicitud de envío mediante API:
curl -X POST \
'https://clientcode.tt.omtrdc.net/rest/v1/mbox/?client=clientcode' \
-H 'authorization: Bearer 3423614b-4843-4664-83c4-c6c3f6c8869b' \
-H 'cache-control: no-cache' \
-H 'content-type: application/json' \
-d '{
"mbox" : "email-mbox",
"tntId" : "111499796294071-449025.28_44",
"requestLocation" : {
"host" : "prod"
},
"profileParameters" : {
},
"mboxParameters" : {
"at_property": "b468a242-64a4-32a0-ca0c-890bddd78789",
"entity.id": "article-123",
"entity.event.detailsOnly" : "true"
}
"contentAsJson": true
}'
El elemento clientcode
es su código de cliente de Target
sessionId
y uno para tntId
o thirdPartyId
para cada destinatario de correo electrónico (por ejemplo, para cada llamada de API). Si no proporciona valores únicos en estos campos, la respuesta de la API puede ralentizarse o dar error debido al gran número de eventos generados dentro de un solo perfil.Consulte la documentación de la API de entrega para obtener más información.
Método 2: usar una plantilla de correo electrónico de rawbox rawbox
Un rawbox es parecido a una solicitud de mbox, pero para entornos que no son de web, como los proveedores de servicios de correo electrónico (ESP). Dado que no tiene Adobe Experience Platform Web SDK o at.js para utilizarlos en las solicitudes rawbox, debe crear las solicitudes manualmente. Los siguientes ejemplos explican cómo trabajar con las solicitudes rawbox en los correos electrónicos.
Este método permite rastrear el rendimiento de las recomendaciones en los mensajes de correo electrónico, probarlos de manera normal con una recomendación y continuar el rastreo en el sitio.
Configure una actividad de Recommendations en Target utilizando la opción del compositor de experiencias basado en formularios. Para la ubicación, seleccione el nombre del mbox que quiera utilizar en la solicitud rawbox proveniente del ESP. Seleccione un diseño con el aspecto que desee para su correo electrónico. A la hora de crear un correo electrónico, el ESP hace una llamada a los servidores de Target para cada rawbox de los mensajes de correo electrónicos que se generan. Su ESP debe tener algún modo de incluir el HTML devuelto en el correo electrónico cuando este se envía.
El sistema de correo electrónico que utilice debe ser capaz de gestionar las siguientes situaciones:
Se recibe una respuesta, pero no hay ninguna recomendación
- En este caso, la respuesta será la que esté establecida como valor del parámetro
mboxDefault
. Consulte la explicación sobre este parámetro más abajo. - El proveedor de correo electrónico debe tener un bloqueo HTML predeterminado de recomendaciones para utilizarlo en este caso.
El servidor de Target agota el tiempo de espera y vuelve sin datos
-
En este caso, el servidor de Target devolverá el siguiente contenido:
//ERROR: application server timeout
-
La aplicación del correo electrónico debe buscar ese texto y poder gestionar el error. El proveedor de correo electrónico tiene varias opciones para solventar este problema:
- Intente realizar otra llamada del servidor inmediatamente (recomendado, tal vez con un contador de intentos).
- Envíe ese correo electrónico en concreto y continúe con el siguiente.
- Ponga en cola ese correo electrónico en concreto y vuelva ejecutar los correos electrónicos erróneos como un lote al final de la primera ejecución.
URL de solicitud de ejemplo
https://client_code.tt.omtrdc.net/m2/client_code/ubox/raw?mbox=mbox_name&mboxSession=1396032094853-955654&mboxPC=1396032094853-955654&mboxXDomain=disabled&entity.event.detailsOnly=true&mboxDefault=nocontent&mboxNoRedirect=1&entity.id=2A229&entity.categoryId=5674
Parámetros necesarios: reqparams
entity.id
, entity.categoryId
o ambos, según el tipo de criterios de recomendación. La llamada de ejemplo anterior incluye ambos.client_code
mbox
Límite de 250 caracteres.
No puede contener ninguno de los siguientes caracteres:
', ", %22, %27, <, >, %3C, %3E
mboxXDomain
entity.id
(Necesario para determinados tipos de criterio: visualización/visualización, visualización/compra, compra/compra)
Si el criterio lo requiere, la llamada de rawbox debe incluir el
entity.id
.entity.event.detailsOnly
entity.id
, se recomienda pasar también este parámetro para evitar que la solicitud incremente el número de visualizaciones escrutadas de la página para un elemento y para no distorsionar los algoritmos de productos basados en visualizaciones.entity.categoryId
(Necesario para determinados tipos de criterio: más vistos por categoría y más vendidos por categoría)
Si el criterio lo requiere, la llamada de rawbox debe incluir el
entity.categoryId
.mboxDefault
https://www.default.com
mboxNoRedirect
no está presente, mboxDefault
debe ser una URL absoluta que devuelva el contenido predeterminado si no hay recomendaciones disponibles. Esta URL puede ser una imagen u otro contenido estático.Si el parámetro
mboxNoRedirect
está presente, mboxDefault
puede ser cualquier texto que indique que no hay recomendaciones, por ejemplo no_content
.El proveedor de correo electrónico debe procesar el caso en el que se devuelve este valor e insertar el HTML predeterminado en el correo electrónico.
Práctica recomendada de seguridad: Tenga en cuenta que si el dominio que se usa en la URL
mboxDefault
no está incluido en la lista de permitidos, se expone a una posible vulnerabilidad de redireccionamiento abierto. Para evitar el uso no autorizado de vínculos de redirector o mboxDefault
de terceros, Adobe le recomienda utilizar “hosts autorizados” en la lista de permitidos de los dominios de URL de redireccionamiento predeterminados. Target usa hosts para la lista de permitidos de dominios a los que desea permitir redirecciones. Para obtener más información, consulte Creación de listas de permitidos que especifiquen hosts con autorización para enviar llamadas de mbox a Target en Hosts.mboxHost
mboxPC
Si no se proporcionó el valor "thirdPartyId", se genera un nuevo tntId que se devuelve como parte de la respuesta. En caso contrario, permanece vacío.
Nota: Asegúrese de proporcionar un valor exclusivo de
mboxSession
y mboxPC
para cada destinatario del correo electrónico (es decir, para cada llamada a la API). Si no proporciona valores únicos en estos campos, la respuesta de la API puede ralentizarse o dar error debido al gran número de eventos generados dentro de un solo perfil.No puede contener más de un “.” (punto).
El único punto permitido es el del sufijo de ubicación del perfil.
Parámetros opcionales
mboxPC
(Opcional)
Este valor debe ser el PCID de Adobe Target real del usuario, que se exportaría desde el sitio web a su CRM. El proveedor de correo electrónico recuperaría este ID desde su CRM o desde el Data Warehouse, y lo usaría para el valor de este parámetro.
El valor
mboxPC
solo es útil para rastrear el comportamiento de visitantes en el sitio en varias visitas para métricas que rastrean si una recomendación es parte de una actividad A/B.Nota: Asegúrese de proporcionar un valor exclusivo de
mboxSession
y mboxPC
para cada destinatario del correo electrónico (es decir, para cada llamada a la API). Si no proporciona valores únicos en estos campos, la respuesta de la API puede ralentizarse o dar error debido al gran número de eventos generados dentro de un solo perfil.No puede contener más de un “.” (punto).
El único punto permitido es el del sufijo de ubicación del perfil.
mboxNoRedirect
(Opcional)
mbox3rdPartyId
Posibles respuestas del servidor de Target
mboxNoRedirect
se establece en “true” y el servidor no devuelve ninguna recomendación (es decir, no hay coincidencia con el mbox o el caché del servidor no se ha iniciado).Falta el parámetro mbox
.
- No se ha especificado el parámetro
mboxDefault
o elmboxNoRedirect
. - Se ha especificado el parámetro de solicitud
mboxTrace
pero no el parámetromboxNoRedirect
. - No se ha especificado el parámetro
mboxTarget
cuando los nombres de mbox terminan con el sufijo-clicked
.
Cannot redirect to default content, please specify mboxDefault parameter
mboxDefault
cuando no existe coincidencia con la solicitud y el parámetro mboxNoRedirect
no se ha especificado.Invalid mbox name:= MBOX_NAME
mbox
contiene caracteres no válidos.Mbox name [MBOX_NAME] is too long
mbox
sobrepasa los 250 caracteres.Método 3: usar la API de descarga de Recommendations download-api
Configure una recomendación como de costumbre pero elija descargar solamente en la sección de presentación en lugar de una combinación de plantilla y mbox. Luego en ESP, indíquele al ESP qué ID de recomendación creó. El ESP accede a los datos de la recomendación a través de la API. Estos datos muestran los artículos que deben recomendarse para un artículo clave o una categoría en particular, como los artículos abandonados en el carro de compras. A continuación, el ESP almacena estos datos, los conecta con su propio aspecto y presentación, muestra la información sobre cada artículo y la envía en los mensajes de correo electrónico.
Con esta opción, el servidor de Recommendations no puede rastrear directamente el rendimiento de una recomendación o dividir el tráfico en múltiples combinaciones de algoritmo y plantilla. Además, las recomendaciones no están asociadas a un perfil del visitante.
Para obtener más información sobre la API de descarga, consulte API heredadas > Descargar.