Configurar una acción personalizada

Si utiliza un sistema de terceros para enviar mensajes o si desea que los recorridos envíen llamadas de API a un sistema de terceros, utilice acciones personalizadas para configurar la conexión a su recorrido. Por ejemplo, puede conectarse a los siguientes sistemas con acciones personalizadas: Epsilon, Slack, Adobe Developer, Firebase, etc.

Las acciones personalizadas son acciones adicionales definidas por usuarios técnicos y que se ponen a disposición de los expertos en marketing. Una vez configuradas, aparecen en la paleta izquierda del recorrido, en la Acción categoría. Obtenga más información en esta página.

Limitaciones

Las acciones personalizadas incluyen algunas limitaciones enumeradas en esta página.

En los parámetros de acción personalizados, puede pasar una colección simple, así como una colección de objetos. Obtenga más información acerca de las limitaciones de recopilación en esta página.

Tenga en cuenta también que los parámetros de acciones personalizadas tienen un formato esperado (por ejemplo: cadena, decimal, etc.). Debe tener cuidado de respetar estos formatos esperados. Obtenga más información en esta caso de uso.

Prácticas recomendadas

Se define un límite de 5000 llamadas/s para todas las acciones personalizadas. Este límite se ha establecido en función del uso de los clientes para proteger los extremos externos dirigidos por acciones personalizadas. Debe tener esto en cuenta en los recorridos basados en audiencias definiendo una tasa de lectura adecuada (5000 perfiles/s cuando se utilizan acciones personalizadas). Si es necesario, puede anular esta configuración definiendo un límite o restricción mayor mediante nuestras API de límite/restricción. Consulte esta página.

No debe segmentar los extremos públicos con acciones personalizadas por varios motivos:

• Sin un límite o una restricción adecuados, existe el riesgo de enviar demasiadas llamadas a un punto final público que puede no admitir ese volumen.
• Los datos de perfil se pueden enviar mediante acciones personalizadas, por lo que la segmentación de un extremo público podría llevar a compartir información personal de forma involuntaria de forma externa.
• No tiene control sobre los datos que devuelven los extremos públicos. Si un extremo cambia su API o comienza a enviar información incorrecta, esta estará disponible en las comunicaciones enviadas, con posibles impactos negativos.

Consentimiento y control de datos

En Journey Optimizer, puede aplicar políticas de gobernanza de datos y consentimiento a sus acciones personalizadas para evitar que campos específicos se exporten a sistemas de terceros o excluyan a los clientes que no hayan aceptado recibir comunicaciones por correo electrónico, push o SMS. Para obtener más información, consulte las siguientes páginas:

• Gobernanza de datos.
• Consentimiento.

Pasos de configuración

Estos son los pasos principales necesarios para configurar una acción personalizada:

1. En la sección del menú ADMINISTRACIÓN, seleccione Configuraciones. En el Acciones , haga clic en Administrar. Clic Crear acción para crear una acción nueva. El panel de configuración de acción se abre en el lado derecho de la pantalla.

   

2. Escriba un nombre para la acción.

   NOTA

   No utilice espacios ni caracteres especiales. No utilice más de 30 caracteres.

3. Añada una descripción a la acción. Este paso es opcional.

4. El número de recorridos que utilizan esta acción se muestra en la variable Utilizado en field. Puede hacer clic en Ver recorridos para mostrar la lista de recorridos con esta acción.

5. Defina los diferentes Configuración de URL parámetros. Consulte esta página.

6. Configure las variables Autenticación sección. Esta configuración es la misma que para las fuentes de datos. Consulte esta sección.

7. Defina el Parámetros de acción. Consulte esta página.

8. Haga clic en Guardar.

   La acción personalizada ahora está configurada y lista para utilizarse en sus recorridos. Consulte esta página.

   NOTA

   Cuando se utiliza una acción personalizada en un recorrido, la mayoría de los parámetros son de solo lectura. Solo puede modificar la variable Nombre, Descripción, URL y el Autenticación sección.

Configuración de extremo

Al configurar una acción personalizada, debe definir lo siguiente Configuración de extremo parámetros:

1. En el URL , especifique la URL del servicio externo:

   • Si la dirección URL es estática, introduzca la dirección URL en este campo.

   • Si la dirección URL incluye una ruta dinámica, introduzca solo la parte estática de la dirección URL, es decir, el esquema, el host, el puerto y, opcionalmente, una parte estática de la ruta.

     Ejemplo: https://xxx.yyy.com/somethingstatic/

     Especifique la ruta dinámica de la URL al agregar la acción personalizada a un recorrido. Más información.

   NOTA

   Por motivos de seguridad, le recomendamos encarecidamente que utilice el esquema HTTPS para la dirección URL. No permitimos el uso de direcciones de Adobe que no sean públicas ni de direcciones IP.

   Solo se permiten los puertos predeterminados al definir una acción personalizada: 80 para http y 443 para https.

2. Seleccione la llamada Método: puede ser cualquiera de las siguientes POST, GET o PUT.

   NOTA

   El DELETE no se admite el método. Si necesita actualizar un recurso existente, seleccione la PUT método.

3. Defina los encabezados y los parámetros de consulta:

   • En el Encabezados , haga clic en Añadir un campo de encabezado para definir los encabezados HTTP del mensaje de solicitud que se va a enviar al servicio externo. El Content-Type y Charset los campos de encabezado están configurados de forma predeterminada. Estos campos no se pueden modificar ni eliminar.

   • En el Parámetros de consulta , haga clic en Agregar un campo de parámetro de consulta para definir los parámetros que desea añadir en la dirección URL.

   

4. Introduzca la etiqueta o el nombre del campo.

5. Seleccione el tipo: Constante o Variable. Si ha seleccionado Constante, luego introduzca el valor constante en Valor field. Si ha seleccionado Variable, entonces especificará esta variable al agregar la acción personalizada a un recorrido. Más información.

   

   NOTA

   Después de agregar la acción personalizada a un recorrido, aún puede agregarle campos de encabezado o de parámetros de consulta si el recorrido está en estado de borrador. Si no desea que los cambios de configuración afecten al recorrido, duplique la acción personalizada y agregue los campos a la nueva acción personalizada.

   Los encabezados se validan según las reglas de análisis de campos. Obtenga más información en esta documentación.

Definición de los parámetros de carga útil

1. En el Solicitud , pegue un ejemplo de la carga útil JSON para enviar al servicio externo. Este campo es opcional y solo está disponible para los métodos de llamada de POST y PUT.

2. En el Respuesta , pegue un ejemplo de la carga útil devuelta por la llamada. Este campo es opcional y está disponible para todos los métodos de llamada. Para obtener información detallada sobre cómo aprovechar las respuestas de llamadas de API en las acciones del cliente, consulte esta página.

Podrá definir el tipo de parámetro (por ejemplo, cadena, entero, etc.).

También puede elegir entre especificar si un parámetro es una constante o una variable:

• Constante significa que el valor del parámetro lo define una persona técnica en el panel de configuración de acciones. El valor siempre será el mismo en todos los recorridos. No variará y el experto en marketing no lo verá al utilizar la acción personalizada en el recorrido. Podría ser, por ejemplo, un ID que espere el sistema de terceros. En ese caso, el campo a la derecha de la constante/variable de alternancia es el valor pasado.
• Variable significa que el valor del parámetro variará. Los especialistas en marketing que utilicen esta acción personalizada en un recorrido podrán transferir el valor que deseen o especificar dónde recuperar el valor de este parámetro (por ejemplo, desde el evento, desde Adobe Experience Platform, etc.). En ese caso, el campo a la derecha de la constante/variable de alternancia es el que los especialistas en marketing verán en el recorrido para asignar un nombre a este parámetro.

Recursos de Business.Adobe.com