DocumentaciónTargetGuía para desarrolladores de Target

Obtener ofertas (Python)

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Desarrollador

Descripción

get_offers() se usa para ejecutar una decisión y recuperar una experiencia de Adobe Target.

Método

getOffers

target_client_instance.get_offers(options)

Parámetros

El diccionario options tiene la siguiente estructura:

Nombre
Tipo
Requerido
Valor predeterminado
Descripción
de eventos
DeliveryRequest
Sí
Ninguna
Se ajusta a la solicitud Target Delivery API
target_cookie
str
no
Ninguna
Cookie Target
target_location_hint
str
no
Ninguna
Target sugerencia de ubicación
consumer_id
str
no
Ninguna
Al vincular varias llamadas, se deben proporcionar ID de consumidor diferentes
customer_ids
list[CustomerId]
no
Ninguna
Una lista de ID de cliente en formato compatible con VisitorId
session_id
str
no
Ninguna
Se utiliza para vincular varias solicitudes
callback
exigible
no
Ninguna
Si se administra la solicitud de forma asíncrona, la llamada de retorno se invoca cuando la respuesta está lista
err_callback
exigible
no
Ninguna
Si se administra la solicitud de forma asíncrona, se invoca la devolución de llamada de error cuando se produce una excepción

Devuelve

Devuelve un(a) TargetDeliveryResponse si se llama sincrónicamente (predeterminado), o un(a) AsyncResult si se llama con una llamada de retorno. TargetDeliveryResponse tiene la siguiente estructura:

Nombre
Tipo
Descripción
respuesta
DeliveryResponse
Se ajusta a la respuesta Target Delivery API
target_cookie
dict
Cookie Target
target_location_hint_cookie
dict
Target cookie de indicio de ubicación
analytics_details
list[AnalyticsResponse]
Carga útil de Analytics, en caso de uso de Analytics por parte del cliente
trazar
list[dict]
Datos de seguimiento agregados para todos los mboxes o vistas de solicitud
response_tokens
list[dict]
Lista de tokens de respuesta en línea
meta
dict
Metadatos de toma de decisiones adicionales para su uso con la toma de decisiones en el dispositivo

Los objetos target_cookie y target_location_hint_cookie utilizados para devolver datos al explorador tienen la siguiente estructura:

Nombre
Tipo
Descripción
name
str
Nombre de la cookie
value
any
Valor de la cookie, el valor se convertirá en cadena
max_age
int
max_age option es una comodidad para configurar las caducidades en relación con el tiempo actual en segundos

El objeto meta utilizado para indicar el estado de la respuesta de destino tiene la siguiente estructura:

Nombre
Tipo
Descripción
decisioning_method
str
Qué método de toma de decisiones se ha utilizado: en el dispositivo o del lado del servidor
remote_mboxes
list[str]
Cuando el método de toma de decisiones es on-device, se proporciona una matriz de nombres de mbox que no se pudieron decidir completamente en el dispositivo. En otras palabras, se necesita una solicitud Target Delivery API.
remote_views
list[str]
Cuando el método de toma de decisiones es en el dispositivo, se proporciona una matriz de nombres de vista que no se pudieron decidir completamente en el dispositivo. En otras palabras, se necesita una solicitud Target Delivery API.

Ejemplo

Python

def client_ready_callback():
    context = Context(channel=ChannelType.WEB)
    mboxes = [MboxRequest(name="a1-serverside-ab", index=1)]
    execute = ExecuteRequest(mboxes=mboxes)
    delivery_request = DeliveryRequest(context=context, execute=execute)

    get_offers_options = {
      "request": delivery_request
    }

    target_delivery_response = target_client.get_offers(get_offers_options)


client_options = {
    "client": "acmeclient",
    "organization_id": "1234567890@AdobeOrg",
    "events": {
        "client_ready": client_ready_callback
    }
}
target_client = TargetClient.create(client_options)
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3