Configuración de una acción

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, aquí es donde puede configurar su conexión a recorrido. La acción personalizada definida por los usuarios técnicos estará disponible en la paleta izquierda del recorrido, en la Action categoría (consulte esta página. A continuación se muestran algunos ejemplos de sistemas a los que puede conectarse con acciones personalizadas: Epsilon, Slack, Adobe.io, Firebase, etc.

Las limitaciones se enumeran en esta página.

Puede pasar colecciones dinámicamente mediante acciones personalizadas. Consulte esta caso de uso.

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.

  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. Más informació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

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