Obtener ofertas (Java)
Última actualización: 20 de julio de 2024
- Temas:
- APIs/SDKs
Creado para:
- Desarrollador
Descripción
getOffers() se usa para ejecutar una decisión y recuperar una experiencia de Adobe Target.
Método
getOffers
La firma del método TargetClient.getOffers se muestra de la siguiente manera.
Solicitud
TargetDeliveryResponse TargetClient.getOffers(TargetDeliveryRequest request)
TargetDeliveryRequest se creó con TargetDeliveryRequest.builder.
Respuesta
TargetDeliveryRequestBuilder TargetDeliveryRequest.builder()
Parámetros
El objeto TargetDeliveryRequestBuilder tiene la siguiente estructura:
Nombre
Tipo
Requerido
Descripción
el contexto
Contexto
Sí
Especifica el contexto de la solicitud
sessionId
Cadena
No
thirdPartyId
Cadena
No
El identificador de su empresa del usuario que puede enviar con cada llamada
cookies
Lista
No
Lista de cookies devueltas en la solicitud Target anterior del mismo usuario.
customerIds
Mapa
No
ID de cliente en formato compatible con VisitorId
ejecutar
ExecuteRequest
No
Solicitud PageLoad o mboxes para ejecutar. Se evaluará inmediatamente en el servidor
recuperación previa
PrefetchRequest
No
Solicitud de vistas, carga de página o mboxes para recuperación previa. Devuelve con el token de notificación que se devolverá en la conversión.
notificaciones
Lista
No
Se utiliza para enviar notificaciones sobre el contenido recuperado previamente que se ha mostrado
requestId
Cadena
No
El ID de solicitud que se devolverá en la respuesta. Se genera automáticamente si no está presente.
impressionId
Cadena
No
Si están presentes, la segunda y las solicitudes posteriores con el mismo ID no incrementarán las impresiones en las actividades/métricas. Se genera automáticamente si no está presente.
environmentId
Largo
No
ID de entorno de cliente válido. Si no se especifica, el host se determinará en función del host proporcionado.
propiedad
Propiedad
No
Especifica la at_property a través del campo de token. Se puede utilizar para controlar el ámbito del envío.
trazar
Seguimiento
No
Habilita el seguimiento para la API de envío.
qaMode
QAMode
No
Utilice este objeto para activar el modo de control de calidad en la solicitud.
locationHint
Cadena
No
Target sugerencia de ubicación de clúster de Edge. Se utiliza para dirigirse al clúster de Edge especificado para esta solicitud.
visitante
API
No
Se utiliza para proporcionar un objeto de API de visitante personalizado.
id
VisitorId
No
Objeto que contiene los identificadores del visitante. P. ej. tntId, thirdPartyId, mcId, customerIds.
experienceCloud
Experience Cloud
No
Especifica integraciones con Audience Manager y Analytics. Se rellena automáticamente con cookies, si no se proporciona.
tntId
Cadena
No
Identificador principal en Target de un usuario. Se obtuvo de targetCookies. Se genera automáticamente si no se proporciona.
mcId
Cadena
No
Se usa para combinar y compartir datos entre distintas soluciones de Adobe (ECID). Se obtuvo de targetCookies. Se genera automáticamente si no se proporciona.
trackingServer
Cadena
No
El servidor de Adobe Analytics para que Adobe Target y Adobe Analytics unan correctamente los datos.
trackingServerSecure
Cadena
No
El Adobe Analytics Secure Server para que Adobe Target y Adobe Analytics unan correctamente los datos.
decisioningMethod
DecisioningMethod
No
Se puede utilizar para establecer explícitamente el método de toma de decisiones ON_DEVICE o HYBRID para la toma de decisiones en el dispositivo
Los valores de cada campo deben cumplir con la especificación de solicitud Target View Delivery API. Para obtener más información acerca de Target View Delivery API, consulte http://developers.adobetarget.com/api/#view-delivery-overview
Respuesta
El TargetDeliveryResponse devuelto por TargetClient.getOffers() tiene la siguiente estructura:
Nombre
Tipo
Descripción
de eventos
TargetDeliveryRequest
Target solicitud
respuesta
DeliveryResponse
Target respuesta
cookies
Lista
Lista de metadatos de sesión para este usuario. Se debe pasar en la siguiente solicitud de destino para este usuario.
visitorState
Mapa
El estado del visitante se establecerá en el lado del cliente para que lo utilice la API de visitante
responseStatus
ResponseStatus
Un objeto que representa el estado de la respuesta
El(la) ResponseStatus de la respuesta contiene los siguientes campos:
Nombre
Tipo
Descripción
status
int
Estado HTTP devuelto desde Target
message
Cadena
Mensaje de estado en caso de que el estado HTTP no sea 200
remoteMboxes
Lista de cadenas
Se utiliza para la toma de decisiones en el dispositivo. Contiene una lista de mboxes que tienen actividades remotas que no se pueden decidir completamente en el dispositivo.
remoteViews
Lista de cadenas
Se utiliza para la toma de decisiones en el dispositivo. Contiene una lista de vistas que tienen actividades remotas que no se pueden decidir completamente en el dispositivo.
El objeto TargetCookie utilizado para guardar datos para la sesión de usuario tiene la siguiente estructura:
Nombre
Tipo
Descripción
name
Cadena
Nombre de la cookie
value
Cadena
Valor de la cookie, el valor se convertirá en cadena
maxAge
Número
La opción maxAge es una comodidad para configurar las caducidades en relación con el tiempo actual en segundos
No tiene que preocuparse por la caducidad de las cookies. Target administra maxAge dentro del SDK.
Ejemplo
Solicitud
ClientConfig clientConfig = ClientConfig.builder()
.client("acmeclient")
.organizationId("1234567890@AdobeOrg")
.build();
TargetClient targetJavaClient = TargetClient.create(clientConfig);
List<MboxRequest> mboxRequests = new ArrayList<>();
mboxRequests.add((MboxRequest) new MboxRequest().name("a1-serverside-ab").index(1));
TargetDeliveryRequest targetDeliveryRequest = TargetDeliveryRequest.builder()
.context(new Context().channel(ChannelType.WEB))
.execute(new ExecuteRequest().setMboxes(mboxRequests))
.build();
Respuesta
TargetDeliveryResponse targetResponse = targetJavaClient.getOffers(targetDeliveryRequest);
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3