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 su conexión con el 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 especialistas en marketing. Una vez configurados, aparecen en la paleta izquierda del recorrido, en la Action 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 sobre 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: string, decimal, etc.). Debe tener cuidado de respetar estos formatos esperados. Obtenga más información en esta caso de uso.

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 Configurations. En el Actions , haga clic en Manage. Haga clic en Create Action para crear una nueva acción. El panel de configuración de acciones 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 Used in campo . Puede hacer clic en el botón View journeys para mostrar la lista de recorridos que utilizan esta acción.

  5. Defina los diferentes URL Configuration parámetros. Consulte esta página.

  6. Configure las variables Authentication para obtener más información. Esta configuración es la misma que para las fuentes de datos. Consulte esta sección.

  7. Defina el Action parameters. Consulte esta página.

  8. Haga clic en Save.

    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 el Name, Description, URL y Authentication para obtener más información.

Configuración de URL

Al configurar una acción personalizada, debe definir lo siguiente URL Configuration 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 únicamente 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/

      Al agregar la acción personalizada a un recorrido, especificará la ruta dinámica de la dirección URL. Más información.

    NOTA

    Por motivos de seguridad, 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 Method: puede ser POST o PUT.

    NOTA

    La variable DELETE no es compatible. Si necesita actualizar un recurso existente, seleccione la opción PUT método.

  3. En el Headers , defina los encabezados HTTP del mensaje de solicitud que se enviarán al servicio externo:

    1. Para añadir un campo de encabezado, haga clic en Add a header field.

    2. Introduzca la clave del campo de encabezado.

    3. Para establecer un valor dinámico para el par clave-valor, seleccione Variable. De lo contrario, seleccione Constant.

      Por ejemplo, para una marca de tiempo, puede establecer un valor dinámico.

    4. Si ha seleccionado Constant y, a continuación, introduzca el valor constante.

      Si ha seleccionado Variable, especificará esta variable al agregar la acción personalizada a un recorrido. Más información.

    5. Para eliminar un campo de encabezado, elija el campo de encabezado y haga clic en el botón Delete icono.

    La variable Content-Type y Charset los campos de encabezado se establecen de forma predeterminada. Estos campos no se pueden modificar ni eliminar.

    Después de agregar la acción personalizada a un recorrido, puede agregarle campos de encabezado si el recorrido está en estado de borrador. Si no desea que el recorrido se vea afectado por los cambios de configuración, duplique la acción personalizada y añada los campos del encabezado a la nueva acción personalizada.

    NOTA

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

Definir los parámetros de acción

En el Action parameters , pegue un ejemplo de la carga útil JSON para enviarla al servicio externo.

NOTA

El ejemplo de carga útil no puede contener valores nulos. Los nombres de campo de la carga útil no pueden contener "." carácter. No pueden empezar con un carácter "$".

Puede definir el tipo de parámetro (p. ej.: string, integer, etc.).

También tendrá la opción de especificar si un parámetro es una constante o una variable:

  • Constante significa que el valor del parámetro se define en el panel de configuración de acciones mediante un perfil técnico. El valor siempre será el mismo en todos los recorridos. No variará y el especialista en marketing no lo verá al utilizar la acción personalizada en el recorrido. Podría ser, por ejemplo, un ID que el sistema de terceros espera. En ese caso, el campo a la derecha de la constante o 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 pasar 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 o variable de alternancia es la etiqueta que los especialistas en marketing verán en el recorrido para asignar un nombre a este parámetro.

En esta página