Documentación Guía para desarrolladores de Target

Obtener ofertas (Python)

Última actualización: 20 de julio de 2024

Temas:
APIs/SDKs

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)