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 for Work Automation and Integration |
| 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 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 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:
-
En cualquier módulo, haga clic en Agregar junto al cuadro Conexión.
-
Rellene los campos siguientes:
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_sdkPrivate 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:
-
Haga clic en Extract.
-
Seleccione el tipo de archivo que va a extraer.
-
Seleccione el archivo que contiene la clave privada o el certificado.
-
Introduzca la contraseña del archivo.
-
Haga clic en Save para extraer el archivo y volver a la configuración de conexión.
-
-
Haga clic en Continuar 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.
Acciones
Crear un registro
Este módulo de acción crea una actividad, una oferta o un público AB o XT.
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
Para cada opción que desee añadir 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.
Para cada mBox que desee añadir a la actividad, haga clic en Add item y rellene los campos siguientes:
-
Audience IDs
Para cada audiencia que desee añadir 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.
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 público para la que desee ver la experiencia, haga clic en Add item e introduzca el ID del público.
-
Visitor Percentage
Introduzca o asigne el porcentaje de visitantes asignado a la experiencia
YYYY-MM-DD hh:mm:ss.z.YYYY-MM-DD hh:mm:ss.z.Introduzca o asigne el estado de la actividad.
-
Approved
-
Deactivated
-
Paused
-
Saved
-
Deleted
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.
Para cada público de informes que desee añadir 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
Realizar una llamada de API personalizada
Este módulo realiza una llamada de API personalizada a la API de Adobe Target.
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.
Añada el contenido del cuerpo para la llamada de API en forma de objeto JSON estándar.
Nota:
Cuando utilice instrucciones condicionales como if en su JSON, coloque las comillas fuera de la instrucción condicional.
Eliminar un registro
Este módulo de acción elimina una sola actividad AB, actividad XT, oferta o audiencia.
Leer un registro
Este módulo de acción recupera datos de una sola actividad, oferta, audiencia, propiedad o informe.
Leer un registro
Este módulo de acción actualiza un registro en Target.
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
Obtener registros
Este módulo de búsqueda recupera una lista de los registros del tipo seleccionado.
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.
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.
Búsqueda
Este módulo de búsqueda busca Actividades, Ofertas o Públicos basándose en los criterios especificados.
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 junto 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 en 10.
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 junto 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 en 10.