Gestión de metadatos de audiencia
Utilice plantillas de metadatos de audiencia para crear, actualizar o eliminar audiencias en el destino mediante programación. Adobe proporciona una plantilla de metadatos de audiencia ampliable que puede configurar en función de las especificaciones de su API de marketing. Después de definir, probar y enviar la configuración, se utilizará por Adobe para estructurar las llamadas de API a su destino.
Puede configurar la funcionalidad descrita en este documento mediante el extremo de la API /authoring/audience-templates
. Lea crear una plantilla de metadatos para obtener una lista completa de las operaciones que puede realizar en el extremo.
Cuándo usar el punto de conexión de gestión de metadatos de audiencia :headding-anchor:when-to-use
Según la configuración de la API, puede que necesite o no utilizar el punto de conexión de gestión de metadatos de audiencia al configurar el destino en Experience Platform. Utilice el diagrama de árbol de decisión que aparece a continuación para comprender cuándo utilizar el extremo de metadatos de audiencia y cómo configurar una plantilla de metadatos de audiencia para su destino.
Casos de uso admitidos por la gestión de metadatos de audiencia :headding-anchor:use-cases
Con la compatibilidad con los metadatos de audiencia en Destination SDK, al configurar el destino del Experience Platform, puede proporcionar a los usuarios de Platform una de las varias opciones al asignar y activar audiencias en el destino. Puede controlar las opciones disponibles para el usuario mediante los parámetros de la sección Configuración de metadatos de audiencia de la configuración de destino.
Caso de uso 1: Tiene una API de terceros y los usuarios no necesitan introducir ID de asignación
Si tiene un punto final de API para crear, actualizar o eliminar audiencias o audiencias, puede utilizar plantillas de metadatos de audiencia para configurar Destination SDK de modo que coincida con las especificaciones de su punto final de creación, actualización o eliminación de audiencia. El Experience Platform puede crear, actualizar o eliminar audiencias mediante programación y sincronizar los metadatos con el Experience Platform.
Al activar audiencias en el destino en la interfaz de usuario (IU) de Experience Platform, los usuarios no necesitan rellenar manualmente un campo de ID de asignación de audiencia en el flujo de trabajo de activación.
Caso de uso 2: Los usuarios deben crear primero una audiencia en el destino y deben introducir manualmente el ID de asignación
Si los socios o usuarios deben crear audiencias y otros metadatos manualmente en el destino, los usuarios deben rellenar manualmente el campo ID de asignación de audiencia en el flujo de trabajo de activación para sincronizar los metadatos de audiencia entre el destino y el Experience Platform.
Caso de uso 3: Su destino acepta el ID de audiencia de Experience Platform, los usuarios no necesitan introducir manualmente el ID de asignación
Si el sistema de destino acepta el ID de audiencia de Experience Platform, puede configurarlo en la plantilla de metadatos de audiencia. Los usuarios no tienen que rellenar un ID de asignación de audiencia al activar un segmento.
Plantilla de audiencia genérica y ampliable :headding-anchor:generic-and-extensible
Para admitir los casos de uso enumerados anteriormente, Adobe proporciona una plantilla genérica que se puede personalizar para ajustarla a las especificaciones de la API.
Puede usar la plantilla genérica para crear una nueva plantilla de audiencia si su API admite:
- Los métodos HTTP: POST, GET, PUT, DELETE, PATCH
- Los tipos de autenticación: OAuth 1, OAuth 2 con token de actualización, OAuth 2 con token de portador
- Las funciones: crear una audiencia, actualizar una audiencia, obtener una audiencia, eliminar una audiencia, validar credenciales
El equipo de ingeniería de Adobes puede trabajar con usted para expandir la plantilla genérica con campos personalizados si sus casos de uso lo requieren.
Eventos de plantilla admitidos :headding-anchor:supported-events
En la tabla siguiente se describen los eventos admitidos por las plantillas de metadatos de audiencia.
create
update
delete
validate
notify
createDestination
updateDestination
deleteDestination
Ejemplos de configuración :headding-anchor:configuration-examples
Esta sección incluye ejemplos de configuraciones de metadatos de audiencia genéricas, para su referencia.
Observe cómo la dirección URL, los encabezados y los cuerpos de solicitud difieren entre las tres configuraciones de ejemplo. Esto se debe a las diferentes especificaciones de la API de marketing de las tres plataformas de ejemplo.
Tenga en cuenta que en algunos ejemplos se usan campos de macro como {{authData.accessToken}}
o {{segment.name}}
en la dirección URL, y en otros ejemplos se usan en los encabezados o en el cuerpo de la solicitud. Su uso depende de las especificaciones de la API de marketing.
code language-json |
---|
|
code language-json |
---|
|
code language-json |
---|
|
code language-json |
---|
|
Busque descripciones de todos los parámetros en la plantilla en la referencia de API Crear una plantilla de audiencia.
Macros utilizadas en plantillas de metadatos de audiencia :headding-anchor:macros
Para pasar información como ID de audiencia, tokens de acceso, mensajes de error y mucho más entre Experience Platform y la API, las plantillas de audiencia incluyen macros que puede utilizar. Lea a continuación una descripción de las macros que se utilizan en los tres ejemplos de configuración de esta página:
{{segment.alias}}
{{segment.name}}
{{segment.id}}
{{customerData.accountId}}
{{oauth2ServiceAccessToken}}
{{authData.accessToken}}
{{authData.accessToken}}
si el Experience Platform debe usar tokens que no caduquen para conectarse a su destino; de lo contrario, use {{oauth2ServiceAccessToken}}
para generar un token de acceso.{{body.segments[0].segment.id}}
externalAudienceId
.{{error.message}}
{{{segmentEnrichmentAttributes}}}
create
, update
y delete
admiten esta macro. Los atributos de enriquecimiento solo están disponibles para audiencias de carga personalizadas. Consulte la guía de activación de audiencia por lotes para ver cómo funciona la selección de atributos de enriquecimiento.{{destination.name}}
{{destination.sandboxName}}
{{destination.id}}
{{destination.imsOrgId}}
{{destination.enrichmentAttributes}}
createDestination
, updateDestination
y deleteDestination
admiten esta macro. Los atributos de enriquecimiento solo están disponibles para audiencias de carga personalizadas. Consulte la guía de activación de audiencia por lotes para ver cómo funciona la selección de atributos de enriquecimiento.{{destination.enrichmentAttributes.<namespace>.<segmentId>}}