DocumentazioneGuida per gli sviluppatori di Target

Ottieni offerte (Python)

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

Descrizione

get_offers() viene utilizzato per eseguire una decisione e recuperare un'esperienza da Adobe Target.

Metodo

getOffers

target_client_instance.get_offers(options)

Parametri

La dipendenza options ha la seguente struttura:

Nome
Tipo
Obbligatorio
Predefinito
Descrizione
richiesta
DeliveryRequest
Sì
None (Nessuno)
Conforme alla richiesta Target Delivery API
target_cookie
str
no
None (Nessuno)
Cookie Target
target_location_hint
str
no
None (Nessuno)
Target hint di posizione
consumer_id
str
no
None (Nessuno)
Quando si uniscono più chiamate, è necessario fornire diversi ID consumer
customer_ids
list[CustomerId]
no
None (Nessuno)
Elenco di ID cliente in formato compatibile con VisitorId
session_id
str
no
None (Nessuno)
Utilizzato per collegare più richieste
callback
richiamabile
no
None (Nessuno)
Se gestisci la richiesta in modo asincrono, il callback viene richiamato quando la risposta è pronta
err_callback
richiamabile
no
None (Nessuno)
Se gestisci la richiesta in modo asincrono, il callback di errore viene richiamato quando viene generata l'eccezione

Restituisce

Restituisce un valore TargetDeliveryResponse se chiamato in modo sincrono (impostazione predefinita) o un valore AsyncResult se chiamato con un callback. TargetDeliveryResponse ha la seguente struttura:

Nome
Tipo
Descrizione
risposta
DeliveryResponse
Conforme alla risposta Target Delivery API
target_cookie
dict
Cookie Target
target_location_hint_cookie
dict
Cookie dell'hint di posizione Target
dettagli_analisi
list[AnalyticsResponse]
Payload di Analytics, in caso di utilizzo di Analytics lato client
traccia
list[dict]
Dati di trace aggregati per tutte le mbox/visualizzazioni di richiesta
response_tokens
list[dict]
Elenco di ​Token di risposta
meta
dict
Metadati decisionali aggiuntivi da utilizzare con le decisioni sul dispositivo

target_cookie e target_location_hint_cookie oggetti utilizzati per restituire dati al browser hanno la seguente struttura:

Nome
Tipo
Descrizione
name
str
Nome cookie
value
qualsiasi
Valore cookie, il valore verrà convertito in stringa
max_age
int
max_age option è una comodità per impostare le scadenze relative all'ora corrente in secondi

L'oggetto meta utilizzato per indicare lo stato della risposta di destinazione ha la seguente struttura:

Nome
Tipo
Descrizione
decisioning_method
str
Quale metodo di decisione è stato utilizzato: su dispositivo o lato server
remote_mboxes
list[str]
Quando il metodo di decisione è on-device, viene fornito un array di nomi mbox che non è stato possibile decidere completamente sul dispositivo. In altre parole, è necessaria una richiesta Target Delivery API.
remote_views
list[str]
Quando il metodo di decisione è su dispositivo, viene fornito un array di nomi di visualizzazione che non è stato possibile decidere completamente sul dispositivo. In altre parole, è necessaria una richiesta Target Delivery API.

Esempio

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