Extremo de audiencias
Una audiencia es un conjunto de personas que comparten comportamientos o características similares. Estas colecciones de personas se pueden generar mediante Adobe Experience Platform o desde fuentes externas. Puede usar el extremo /audiences
en la API de segmentación, que le permite recuperar, crear, actualizar y eliminar audiencias mediante programación.
Introducción
Los extremos utilizados en esta guía forman parte de la API Adobe Experience Platform Segmentation Service. Antes de continuar, revisa la guía de introducción para obtener información importante que necesitas conocer para poder realizar llamadas a la API correctamente, incluidos los encabezados requeridos y cómo leer llamadas de API de ejemplo.
Recuperación de una lista de audiencias list
Puede recuperar una lista de todas las audiencias de su organización realizando una solicitud de GET al extremo /audiences
.
Formato de API
El extremo /audiences
admite varios parámetros de consulta para filtrar los resultados. Aunque estos parámetros son opcionales, se recomienda encarecidamente su uso para ayudar a reducir la costosa sobrecarga al enumerar recursos. Si realiza una llamada a este extremo sin parámetros, se recuperarán todas las audiencias disponibles para su organización. Se pueden incluir varios parámetros, separados por el símbolo et (&
).
GET /audiences
GET /audiences?{QUERY_PARAMETERS}
property=audienceId
, se devolverán las audiencias inactivas will.Al recuperar una lista de audiencias, se pueden utilizar los siguientes parámetros de consulta:
start
start=5
limit
limit=10
sort
attributeName:[desc/asc]
.sort=updateTime:desc
property
property=
property=audienceId==test-audience-id
name
name=Sample
description
description=Test Description
Solicitud
La siguiente solicitud recupera las dos últimas audiencias creadas en su organización.
code language-shell |
---|
|
Respuesta
Una respuesta correcta devuelve el estado HTTP 200 con una lista de audiencias creadas en su organización como JSON.
code language-json |
---|
|
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 | ||
---|---|---|
Propiedad | Tipo de público | Descripción |
id |
Ambos | Un identificador de solo lectura generado por el sistema para la audiencia. |
audienceId |
Ambos | Si la audiencia es una audiencia generada por Platform, este es el mismo valor que id . Si la audiencia se genera externamente, el cliente proporciona este valor. |
schema |
Ambos | El esquema Experience Data Model (XDM) de la audiencia. |
imsOrgId |
Ambos | El ID de la organización a la que pertenece la audiencia. |
sandbox |
Ambos | Información sobre la zona protegida a la que pertenece la audiencia. Encontrará más información sobre las zonas protegidas en la descripción general de las zonas protegidas. |
name |
Ambos | Nombre de la audiencia. |
description |
Ambos | Una descripción de la audiencia. |
expression |
Generado por Platform | La expresión Profile Query Language (PQL) de la audiencia. Encontrará más información sobre las expresiones PQL en la guía de expresiones PQL. |
mergePolicyId |
Generado por Platform | El ID de la política de combinación a la que está asociada la audiencia. Encontrará más información sobre las políticas de combinación en la guía de políticas de combinación. |
evaluationInfo |
Generado por Platform | Muestra cómo se evaluará la audiencia. Los posibles métodos de evaluación incluyen por lotes, sincrónico (streaming) o continuo (edge). Encontrará más información sobre los métodos de evaluación en la descripción general de la segmentación |
dependents |
Ambos | Una matriz de ID de audiencia que dependen de la audiencia actual. Se utilizaría si va a crear una audiencia que sea un segmento de un segmento. |
dependencies |
Ambos | Una matriz de ID de audiencia de los que depende la audiencia. Se utilizaría si va a crear una audiencia que sea un segmento de un segmento. |
type |
Ambos | Campo generado por el sistema que muestra si la audiencia es generada por Platform o por un público generado externamente. Los valores posibles incluyen SegmentDefinition y ExternalSegment . Un SegmentDefinition hace referencia a una audiencia que se generó en Platform, mientras que un ExternalSegment hace referencia a una audiencia que no se generó en Platform. |
originName |
Ambos | Campo que hace referencia al nombre del origen de la audiencia. Para audiencias generadas por Platform, este valor será REAL_TIME_CUSTOMER_PROFILE . Para las audiencias generadas en Audience Orchestration, este valor será AUDIENCE_ORCHESTRATION . Para las audiencias generadas en Adobe Audience Manager, este valor será AUDIENCE_MANAGER . Para otras audiencias generadas externamente, este valor será CUSTOM_UPLOAD . |
createdBy |
Ambos | El ID del usuario que creó la audiencia. |
labels |
Ambos | Etiquetas de uso de datos a nivel de objeto y de control de acceso basadas en atributos que son relevantes para la audiencia. |
namespace |
Ambos | El área de nombres al que pertenece la audiencia. Los valores posibles incluyen AAM , AAMSegments , AAMTraits y AEPSegments . |
linkedAudienceRef |
Ambos | Un objeto que contiene identificadores de otros sistemas relacionados con la audiencia. |
Crear una audiencia nueva create
Puede crear una audiencia nueva realizando una solicitud de POST al extremo /audiences
.
Formato de API
POST /audiences
Solicitud
code language-shell |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
---|---|
Propiedad | Descripción |
name |
Nombre de la audiencia. |
description |
Una descripción de la audiencia. |
type |
Campo que muestra si la audiencia es una audiencia generada por Platform o por un generador externo. Los valores posibles incluyen SegmentDefinition y ExternalSegment . Un SegmentDefinition hace referencia a una audiencia que se generó en Platform, mientras que un ExternalSegment hace referencia a una audiencia que no se generó en Platform. |
expression |
La expresión Profile Query Language (PQL) de la audiencia. Encontrará más información sobre las expresiones PQL en la guía de expresiones PQL. |
schema |
El esquema Experience Data Model (XDM) de la audiencia. |
labels |
Etiquetas de uso de datos a nivel de objeto y de control de acceso basadas en atributos que son relevantes para la audiencia. |
Respuesta
Una respuesta correcta devuelve el estado HTTP 200 con información sobre la audiencia recién creada.
code language-json |
---|
|
Búsqueda de una audiencia especificada get
Puede buscar información detallada sobre una audiencia específica realizando una solicitud de GET al extremo /audiences
y proporcionando el ID de la audiencia que desea recuperar en la ruta de solicitud.
Formato de API
GET /audiences/{AUDIENCE_ID}
{AUDIENCE_ID}
id
y es no el campo audienceId
.Solicitud
code language-shell |
---|
|
Respuesta
Una respuesta correcta devuelve el estado HTTP 200 con información sobre la audiencia especificada.
code language-json |
---|
|
Actualización de una audiencia put
Puede actualizar (sobrescribir) una audiencia específica realizando una solicitud de PUT al extremo /audiences
y proporcionando el ID de la audiencia que desea actualizar en la ruta de solicitud.
Formato de API
PUT /audiences/{AUDIENCE_ID}
{AUDIENCE_ID}
id
y es no el campo audienceId
.Solicitud
code language-shell |
---|
|
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 | |
---|---|
Propiedad | Descripción |
audienceId |
El ID de la audiencia. Para audiencias generadas externamente, este valor lo puede proporcionar el usuario. |
name |
Nombre de la audiencia. |
namespace |
El área de nombres de la audiencia. |
description |
Una descripción de la audiencia. |
type |
Campo generado por el sistema que muestra si la audiencia es generada por Platform o por un público generado externamente. Los valores posibles incluyen SegmentDefinition y ExternalSegment . Un SegmentDefinition hace referencia a una audiencia que se generó en Platform, mientras que un ExternalSegment hace referencia a una audiencia que no se generó en Platform. |
lifecycleState |
El estado de la audiencia. Los valores posibles incluyen draft , published y inactive . draft representa cuándo se creó la audiencia, published cuándo se publicó la audiencia y inactive cuándo la audiencia ya no está activa. |
datasetId |
El ID del conjunto de datos en el que se pueden encontrar los datos de audiencia. |
labels |
Etiquetas de uso de datos a nivel de objeto y de control de acceso basadas en atributos que son relevantes para la audiencia. |
Respuesta
Una respuesta correcta devuelve el estado HTTP 200 con detalles de la audiencia recién actualizada. Tenga en cuenta que los detalles de la audiencia variarán según se trate de una audiencia generada por Platform o por un público generado externamente.
code language-json |
---|
|
Eliminar una audiencia delete
Puede eliminar una audiencia específica realizando una solicitud de DELETE al extremo /audiences
y proporcionando el ID de la audiencia que desea eliminar en la ruta de solicitud.
Formato de API
DELETE /audiences/{AUDIENCE_ID}
{AUDIENCE_ID}
id
y es no el campo audienceId
.Solicitud
code language-shell |
---|
|
Respuesta
Una respuesta correcta devuelve el estado HTTP 204 sin mensaje.
Recuperar varias audiencias bulk-get
Puede recuperar varias audiencias realizando una solicitud de POST al extremo /audiences/bulk-get
y proporcionando los ID de las audiencias que desea recuperar.
Formato de API
POST /audiences/bulk-get
Solicitud
code language-shell |
---|
|
Respuesta
Una respuesta correcta devuelve el estado HTTP 207 con información sobre las audiencias solicitadas.
code language-json |
---|
|
Pasos siguientes
Después de leer esta guía, ahora comprende mejor cómo crear, administrar y eliminar audiencias mediante la API de Adobe Experience Platform. Para obtener más información acerca de la administración de audiencias mediante la interfaz de usuario, lea la guía de segmentación de la interfaz de usuario.