Adobe Target módulos

En un escenario de Adobe Workfront Fusion, puede automatizar los flujos de trabajo que utilizan Adobe Target, así como conectarlo a varias aplicaciones y servicios de terceros. Los módulos de Adobe Target le permiten crear, leer, actualizar o eliminar registros, enumerar todos los registros de un tipo determinado, buscar registros basados en los criterios especificados o realizar una llamada de API personalizada a la API de Adobe Target.

Si necesita instrucciones para crear un escenario, consulte Crear un escenario.

Para obtener información acerca de los módulos, vea Módulos en Adobe Workfront Fusion.

Requisitos de acceso

Debe tener el siguiente acceso para utilizar la funcionalidad de este artículo:

Adobe Workfront plan*
Pro o superior
Adobe Workfront licencia*
Plan, Trabajo
Adobe Workfront Fusion licencia**

Requisito de licencia actual: no se requiere licencia de Workfront Fusion.

O

Requisito de licencia heredado: Workfront Fusion para automatización e integración de trabajo

Producto

Requisito de producto actual: si tiene el plan Select o Prime Adobe Workfront, su organización debe adquirir Adobe Workfront Fusion así como Adobe Workfront para utilizar la funcionalidad descrita en este artículo. Workfront Fusion está incluido en el plan Workfront de Ultimate.

O

Requisito de productos heredados: su organización debe comprar Adobe Workfront Fusion y Adobe Workfront para utilizar la funcionalidad descrita en este artículo.

Para saber qué plan, tipo de licencia o acceso tiene, póngase en contacto con el administrador de Workfront.

Para obtener información sobre Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias.

Requisitos previos

Antes de poder usar el conector Adobe Target, debe asegurarse de que se cumplen los siguientes requisitos previos:

  • Debe tener una cuenta de Adobe Target activa.

Información de API de Adobe Target

El conector de Adobe Target utiliza lo siguiente:

Etiqueta de API
Versión 1.7.33

Crear una conexión con Adobe Target

IMPORTANT
Las conexiones creadas después del 3 de junio de 2024 requieren una conexión de servidor a servidor de Adobe Target.
  • Las conexiones de cuenta de servicio existentes seguirán funcionando hasta enero de 2025. Debe reemplazar las conexiones de su cuenta de servicio con las conexiones de servidor a servidor de Adobe Target para enero de 2024.
  • Debe ser un desarrollador para su organización para crear una conexión de servidor a servidor de Adobe Target. La función de desarrollador se establece en Adobe Admin Console.

Para crear una conexión para los módulos de Adobe Target:

  1. Haga clic en Agregar junto al cuadro Conexión.

  2. Rellene los campos siguientes:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto html-authored no-header
    Nombre de conexión Escriba un nombre para esta conexión.
    Tipo de conexión

    Seleccione si va a crear una conexión de cuenta de servicio o una conexión de servidor a servidor de Adobe Target.

    IMPORTANTE: Las conexiones creadas después del 3 de junio de 2024 requieren una conexión de servidor a servidor de Adobe Target. Las conexiones de cuenta de servicio existentes seguirán funcionando hasta enero de 2025. Debe reemplazar las conexiones de su cuenta de servicio con las conexiones de servidor a servidor de Adobe Target para enero de 2024.

    Entorno Seleccione si desea conectarse a un entorno de producción o de no producción.
    Tipo Seleccione si desea conectarse a una cuenta de servicio o a una cuenta personal.
    ID de cliente Escriba su ID de cliente Adobe. Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.
    Secreto de cliente Escriba el secreto de cliente de Adobe. Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.
    ID de cuenta técnica Escriba su ID de cuenta técnica de Adobe. Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.
    ID de organización Escriba su ID de organización Adobe. Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.
    Inquilino

    Para localizar a su inquilino, inicie sesión en Adobe Experience Cloud, abra Target y haga clic en la tarjeta Target. Utilice el valor ID de inquilino como se indica en el subdominio URL.

    Por ejemplo, si la dirección URL cuando inició sesión en Adobe Target es <https://mycompany.experiencecloud.adobe.com/...>, el identificador de inquilino es "mycompany".

    MetaÁmbitos Ingresar ent_marketing_sdk
    Clave privada

    Escriba la clave privada que se generó cuando se crearon las credenciales en Adobe Developer Console.

    Para extraer la clave privada o el certificado:

    1. Haga clic en Extract.

    2. Seleccione el tipo de archivo que está extrayendo.

    3. Seleccione el archivo que contiene la clave privada o el certificado.

    4. Introduzca la contraseña del archivo.

    5. Haga clic en Guardar para extraer el archivo y volver a la configuración de conexión.

  3. Haga clic en Continuar para guardar la conexión y volver al módulo.

Adobe Target módulos y sus campos

Al configurar Adobe Target módulos, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse Adobe Target campos adicionales, según factores como el nivel de acceso en la aplicación o el servicio. Un título en negrita en un módulo indica un campo obligatorio.

Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, vea Asignar información de un módulo a otro en Adobe Workfront Fusion.

Acciones

Crear un registro

Este módulo de acción crea una actividad AB o XT, una oferta o una audiencia.

Conexión
Para obtener instrucciones sobre cómo crear una conexión con Adobe Target, vea Crear una conexión con Adobe Target en este artículo.
Tipo de registro

Seleccione el tipo de registro que desea crear.

  • Propiedad

    Para obtener más información sobre los campos, consulte Crear una propiedad en la documentación de la API de Adobe Target.

  • Recomendación de oferta

    Para obtener más información sobre los campos, consulte Crear una nueva oferta de recomendaciones en la documentación de la API de Adobe Target.

  • Oferta JSON

    Continuar a Campos de oferta.

  • Contenido de la oferta

    Continuar a Campos de oferta.

  • Entorno

    Para obtener más información sobre los campos, consulte Crear entorno en la documentación de la API de Adobe Target.

  • Audience

    Para obtener más información sobre los campos, consulte Crear audiencia en la documentación de la API de Adobe Target.

  • AB Activity

    Para obtener más información sobre los campos, consulte Crear actividad AB en la documentación de la API de Adobe Target.

  • XT Activity

    Continuar a campos de actividad XT.

  • Actividad de AP

    Para obtener más información sobre los campos, consulte Crear actividad AP en la documentación de la API de Adobe Target.

  • Token de respuesta

    Para obtener más información sobre los campos, consulte Crear token de respuesta en la documentación de la API de Adobe Target.

Campos de actividad XT
Nombre
Introduzca o asigne un nombre para esta actividad. El nombre no puede tener más de 250 caracteres.
Opciones

Para cada opción que desee agregar a la actividad, haga clic en Agregar elemento y rellene los campos siguientes:

  • Option local ID

    Introduzca o asigne una cadena para utilizar en el seguimiento de la opción entre solicitudes de API.

  • Nombre

    Introduzca o asigne un nombre para la opción. El nombre no debe tener más de 250 caracteres.

  • ID de oferta

  • Seleccione o asigne la opción Oferta asociada a.

Ubicaciones

Para cada Mbox que desee agregar a la actividad, haga clic en Agregar elemento y rellene los campos siguientes:

  • ID de audiencia

    Para cada audiencia que desee agregar al mbox, haga clic en Agregar elemento y seleccione el ID de audiencia.

  • Id. local de ubicación

    Introduzca o asigne una cadena para utilizarla para rastrear la ubicación en varias solicitudes de API.

  • Nombre

    Introduzca o asigne un nombre para la ubicación. El nombre no debe tener más de 250 caracteres.

Experiencias

Una lista de ubicaciones en la página donde se sirve la oferta de contenido. Una ubicación contiene lo siguiente:

  • ID local de experiencia

    Introduzca o asigne el ID de la experiencia

  • Nombre

    Introduzca o asigne el nombre de la experiencia

  • Audience IDs

    Para cada audiencia para la que desee ver la experiencia, haga clic en Agregar elemento e introduzca el ID de audiencia.

  • Porcentaje de visitantes

    Introduzca o asigne el porcentaje de visitantes asignado a la experiencia

Métricas
ID de terceros
Introduzca o asigne un ID para identificar esta actividad. Puede elegir este ID. Este ID no debe ser el mismo que otra actividad y no puede tener más de 250 caracteres.
Empieza en
Escriba o asigne la fecha y la hora de inicio de la actividad con el formato YYYY-MM-DD hh:mm:ss.z.
Finaliza en
Escriba o asigne la fecha y la hora de finalización de la actividad con el formato YYYY-MM-DD hh:mm:ss.z.
Estado

Introduzca o asigne el estado de la actividad.

  • Aprobado

  • desactivado

  • En pausa

  • Guardado

  • eliminado

Prioridad
Introduzca un número que defina la prioridad de la actividad. Los números más altos tienen mayor prioridad. Este valor debe estar entre 0 y 999. El valor predeterminado es 5.
Tráfico de asignación automática

Active esta opción para asignar automáticamente el tráfico. La asignación automática envía más tráfico a una experiencia más exitosa.

Seleccione o asigne los criterios de evaluación según los cuales se juzgará qué experiencia tiene más éxito.

Workspace
Introduzca o asigne el espacio de trabajo al que está asociada la actividad
Id. de propiedad
Para cada propiedad que desee agregar a la actividad, haga clic en Agregar elemento y seleccione o asigne el ID de la propiedad.
Reporting audiences

Para cada audiencia de informes que desee agregar a la actividad, haga clic en Agregar elemento e introduzca la siguiente información:

  • Reporting ID local de audiencia

    Introduzca o asigne una cadena para utilizar en el seguimiento de la audiencia de informes en las solicitudes de API.

  • ID de audiencia

    Introduzca o asigne el segmento que se utilizará en el sistema de informes

  • ID local de métrica

    Introduzca o asigne una cadena para utilizarla para rastrear la métrica en varias solicitudes de API.

Campos de oferta
Nombre
Introduzca o asigne un nombre para esta actividad. El nombre no puede tener más de 250 caracteres.
Contenido
Introduzca o asigne el contenido de la oferta que se mostrará al usuario.
Workspace
Introduzca o asigne el ID del espacio de trabajo asociado a la oferta. Si se deja en blanco, la oferta se asocia al espacio de trabajo predeterminado de la cuenta. Esta funcionalidad se aplica solamente a Target cuentas de Premium.
Workspace
Introduzca o asigne la fecha y la hora de modificación de esta oferta.

Realizar una llamada de API personalizada

Este módulo realiza una llamada de API personalizada a la API Adobe Target.

Conexión
Para obtener instrucciones sobre cómo crear una conexión con Adobe Target, vea Crear una conexión con Adobe Target en este artículo.
Target URL base
Escriba o asigne la dirección URL base Target.
Ruta
Escriba una ruta relativa a {baseURL}/
Método
Seleccione el método de solicitud HTTP que necesita para configurar la llamada de API. Para obtener más información, vea Métodos de solicitud HTTP en Adobe Workfront Fusion.
Encabezados

Añada los encabezados de la solicitud en forma de objeto JSON estándar.

Por ejemplo, {"Content-type":"application/json"}

Workfront Fusion agrega automáticamente encabezados de autorización y encabezados x-api-key.

Cadena de consulta
Introduzca la cadena de consulta de solicitud.
Cuerpo

Añada el contenido del cuerpo para la llamada de API en forma de objeto JSON estándar.

Nota:

Cuando utilice afirmaciones condicionales como if en su JSON, coloque las comillas fuera de la afirmación condicional.

Eliminar un registro

Este módulo de acción elimina una sola actividad AB, actividad XT, oferta o audiencia.

Conexión
Para obtener instrucciones sobre cómo crear una conexión con Adobe Target, vea Crear una conexión con Adobe Target en este artículo.
Tipo de registro
Seleccione el tipo de registro que desea eliminar.
ID de registro
Introduzca o asigne el ID del registro que desea eliminar.

Leer un registro

Este módulo de acción recupera datos de una sola actividad, oferta, audiencia, propiedad o informe.

Conexión
Para obtener instrucciones sobre cómo crear una conexión con Adobe Target, vea Crear una conexión con Adobe Target en este artículo.
Tipo de registro
Seleccione el tipo de registro que desea leer.
ID de registro
Introduzca o asigne el ID del registro que desea leer.

Actualizar un registro

Este módulo de acción actualiza un registro en Target.

Conexión
Para obtener instrucciones sobre cómo crear una conexión con Adobe Target, vea Crear una conexión con Adobe Target en este artículo.
Tipo de registro
Seleccione el tipo de registro que desea actualizar.
Nombres de campos

Seleccione los campos que desea actualizar. Los campos aparecen a continuación.

Para obtener detalles sobre los campos, consulte la documentación de la API de Adobe Target.

Búsquedas

Obtener registros

Este módulo de búsqueda recupera una lista de registros del tipo seleccionado.

Conexión
Para obtener instrucciones sobre cómo crear una conexión con Adobe Target, vea Crear una conexión con Adobe Target en este artículo.
Tipo de registro
Seleccione el tipo de registro que desea actualizar.
Ordenar por
Para cada campo por el que desee ordenar, haga clic en Agregar elemento y seleccione el campo y si los resultados devueltos deben ser ascendentes o descendentes.
Comienza En

Introduzca la fecha más temprana para la que desea recuperar registros.

Para obtener una lista de los formatos de fecha y hora admitidos, vea Coerción de tipos en Adobe Workfront Fusion.

Finaliza En

Introduzca la última fecha para la que desea recuperar registros.

Para obtener una lista de los formatos de fecha y hora admitidos, vea Coerción de tipos en Adobe Workfront Fusion.

Búsqueda

Este módulo de búsqueda busca Actividades, Ofertas o Audiencias en función de los criterios especificados.

Conexión
Para obtener instrucciones sobre cómo crear una conexión con Adobe Target, vea Crear una conexión con Adobe Target en este artículo.
Tipo de registro
Seleccione el tipo de registro que desea actualizar.
Ordenar por
Para cada campo por el que desee ordenar, haga clic en Agregar elemento y seleccione el campo y si los resultados devueltos deben ser ascendentes o descendentes.
Criterios de búsqueda
Para cada regla que desee configurar, seleccione el campo, el operador y el valor. Haga clic en Agregar regla AND para crear reglas adicionales.
Desplazamiento

Introduzca el número de la primera respuesta que desea que devuelva el módulo. La primera respuesta devuelta tiene un desplazamiento de 0. Utilice este campo en combinación con el campo Número máximo de resultados devueltos para paginar las respuestas.

Por ejemplo, para ver la tercera página de respuestas, cuando cada página tenga diez respuestas, establezca Desplazamiento en 20 y Número máximo de resultados devueltos en 10.

Límite

Introduzca o asigne el número máximo de registros que desea que devuelva el módulo durante cada ciclo de ejecución de escenario. Utilice este campo en combinación con el campo Offset para paginar las respuestas.

Por ejemplo, para ver la tercera página de respuestas, cuando cada página tenga diez respuestas, establezca Desplazamiento en 20 y Número máximo de resultados devueltos en 10.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43