Módulos de Adobe Target

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 sobre cómo crear un escenario, vea los artículos en Crear un escenario: índice de artículos.

Para obtener información acerca de los módulos, vea los artículos en Módulos: índice de artículos.

Requisitos de acceso

Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:

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

Requisito de licencia actual: no se requiere ninguna 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 Ultimate Workfront.

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 de 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 a 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 antes de enero de 2024.
  • Debe ser un desarrollador de 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 Add 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
    Connection name Introduzca un nombre para esta conexión.
    Connection type

    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 antes de enero de 2024.

    Environment Seleccione si desea conectarse a un entorno de producción o de no producción.
    Type Seleccione si desea conectarse a una cuenta de servicio o a una personal.
    Client ID Escriba su ID de cliente de Adobe. Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.
    Client Secret Escriba su secreto de cliente de Adobe. Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.
    Technical account ID Escriba su ID de cuenta técnica de Adobe. Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.
    Organization ID Introduzca el ID de organización de Adobe. Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.
    Tenant

    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 URL al iniciar sesión en Adobe Target es <https://mycompany.experiencecloud.adobe.com/...>, el identificador de inquilino es “mycompany”.

    Meta Scopes Introduzca ent_marketing_sdk
    Private key

    Introduzca la clave privada que se generó cuando se crearon sus 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 va a extraer.

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

    4. Introduzca la contraseña del archivo.

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

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

Módulos de Adobe Target y sus campos

Al configurar módulos de Adobe Target, 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. El 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.

Conmutador Asignar

Acciones

Create a record

Este módulo de acción crea una actividad, una oferta o un público AB o XT.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Target, consulte Crear una conexión con Adobe Target en este artículo.
Record type

Seleccione el tipo de registro que desea crear.

  • Propiedad

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

  • Oferta de recomendación

    Para obtener información detallada sobre los campos, consulte Crear una nueva oferta de recomendación en la documentación de la API de Adobe Target.

  • Offer JSON

    Continúe hasta Campos de oferta.

  • Offer Content

    Continúe hasta Campos de oferta.

  • Entorno

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

  • Audience

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

  • AB Activity

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

  • XT Activity

    Continúe hasta Campos de actividad XT.

  • AP Activity

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

  • Response Token

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

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

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

  • Option local ID

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

  • Name

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

  • Offer ID

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

Locations

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

  • Audience IDs

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

  • Location local ID

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

  • Name

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

Experiences

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

  • Experience local ID

    Introduzca o asigne el ID de la experiencia

  • Name

    Introduzca o asigne el nombre de la experiencia

  • Audience IDs

    Para cada audiencia para la que quiera ver la experiencia, haga clic en Add item e introduzca el ID de audiencia.

  • Visitor Percentage

    Introduzca o asigne el porcentaje de visitantes asignado a la experiencia

Metrics
Third Party ID
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.
Starts at
Escriba o asigne la fecha y la hora de inicio de la actividad en el formato YYYY-MM-DD hh:mm:ss.z.
Ends at
Introduzca o asigne la fecha y la hora de finalización de la actividad en el formato YYYY-MM-DD hh:mm:ss.z.
State

Introduzca o asigne el estado de la actividad.

  • Approved

  • Deactivated

  • Paused

  • Saved

  • Deleted

Priority
Introduzca un número que defina la prioridad de la actividad. Los números más altos tienen mayor prioridad. Este valor debe estar comprendido entre 0 y 999. El valor predeterminado es 5.
Auto-allocate traffic

Habilite esta opción para asignar automáticamente el tráfico. La asignación automática envía más tráfico a una experiencia con más éxito.

Seleccione o asigne los criterios de evaluación con los que juzgar qué experiencia tiene más éxito.

Workspace
Introduzca o asigne el espacio de trabajo con el que está asociada la actividad
Property IDs
Para cada propiedad que desee agregar a la actividad, haga clic en Add item 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 Add item e introduzca la siguiente información:

  • Reporting Audience local ID

    Introduzca o asigne una cadena que se utilizará para realizar un seguimiento del público de informes a través de las solicitudes de API.

  • Audience ID

    Introduzca o asigne el segmento que se utilizará en los informes

  • Metric local ID

    Introduzca o asigne una cadena que se utilizará para realizar un seguimiento de la métrica a través de las solicitudes de API.

Campos de oferta
Name
Introduzca o asigne un nombre para esta actividad. El nombre no puede tener más de 250 caracteres.
Content
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 cuentas Premium de Target.
Workspace
Introduzca o asigne la fecha y la hora de modificación de esta oferta.

Make a custom API call

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

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

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

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

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

Query String
Introduzca la cadena de consulta de la solicitud.
Body

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.

Delete a record

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

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

Read a record

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

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

Update a record

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

Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Target, consulte Crear una conexión con Adobe Target en este artículo.
Record type
Seleccione el tipo de registro que desee actualizar.
Field names

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

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

Búsquedas

Get records

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

Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Target, consulte Crear una conexión con Adobe Target en este artículo.
Record type
Seleccione el tipo de registro que desee actualizar.
Sort by
Para cada campo por el que desee ordenar, haga clic en Add item y seleccione el campo y si los resultados devueltos deben ser ascendentes o descendentes.
Starts At

Introduzca la fecha más antigua cuyos registros desea recuperar.

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

Ends At

Introduzca la fecha más reciente cuyos registros desea recuperar.

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

Este módulo de búsqueda busca Actividades, Ofertas o Públicos basándose en los criterios especificados.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Target, consulte Crear una conexión con Adobe Target en este artículo.
Record type
Seleccione el tipo de registro que desee actualizar.
Sort by
Para cada campo por el que desee ordenar, haga clic en Add item y seleccione el campo y si los resultados devueltos deben ser ascendentes o descendentes.
Search criteria
Para cada regla que desee configurar, seleccione el campo, el operador y el valor. Haga clic en Add AND rule para crear reglas adicionales.
Offset

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 Maximum number of returned results para paginar las respuestas.

Por ejemplo, para ver la tercera página de respuestas, cuando cada página tenga diez respuestas, establezca Offset en 20 y Maximum number of returned resultados en 10.

Limit

Introduzca o asigne el número máximo de registros que desea que el módulo devuelva 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 Offset en 20 y Maximum number of returned resultados en 10.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3