DocumentaçãoGuia do desenvolvedor do Target

Obter Ofertas (Python)

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

Criado para:

  • undefined

Descrição

get_offers() é usado para executar uma decisão e recuperar uma experiência de Adobe Target.

Método

getOffers

target_client_instance.get_offers(options)

Parâmetros

O diretório options tem a seguinte estrutura:

Nome
Tipo
Obrigatório
Padrão
Descrição
solicitação
DeliveryRequest
Sim
None
Está em conformidade com a solicitação Target Delivery API
target_cookie
str
não
None
Target cookie
target_location_hint
str
não
None
Target dica de localização
consumer_id
str
não
None
Ao compilar várias chamadas, IDs de consumidor diferentes devem ser fornecidas
customer_ids
list[CustomerId]
não
None
Uma lista de IDs de cliente em formato compatível com a ID de visitante
session_id
str
não
None
Usado para vincular várias solicitações
callback
chamável
não
None
Se manipular a solicitação de forma assíncrona, o retorno de chamada será chamado quando a resposta estiver pronta
err_callback
chamável
não
None
Se estiver tratando a solicitação de forma assíncrona, o retorno de chamada de erro é chamado quando a exceção é gerada

Devoluções

Retorna TargetDeliveryResponse se for chamado de forma síncrona (padrão), ou AsyncResult se for chamado com um retorno de chamada. TargetDeliveryResponse tem a seguinte estrutura:

Nome
Tipo
Descrição
resposta
DeliveryResponse
Está em conformidade com a resposta Target Delivery API
target_cookie
dict
Target cookie
target_location_hint_cookie
dict
Cookie de dica de localização Target
analytics_details
list[AnalyticsResponse]
Carga do Analytics, em caso de uso do Analytics no lado do cliente
trace
lista[dica]
Dados de rastreamento agregados para todas as mboxes/exibições de solicitação
response_tokens
lista[dica]
Uma lista de ​Tokens de Resposta
meta
dict
Metadados de decisão adicionais para uso com decisão no dispositivo

Os objetos target_cookie e target_location_hint_cookie usados para transmitir dados de volta ao navegador têm a seguinte estrutura:

Nome
Tipo
Descrição
name
str
Nome do cookie
value
any
Valor do cookie, o valor será convertido em string
max_age
int
O max_age option é uma conveniência para que a configuração expire em relação ao tempo atual em segundos

O objeto meta usado para indicar o status da resposta de destino tem a seguinte estrutura:

Nome
Tipo
Descrição
método_de_decisão
str
Qual método de decisão foi usado: no dispositivo ou no servidor
remote_mboxes
lista[str]
Quando o Método de Decisão é on-device, uma matriz de nomes de mbox que não puderam ser totalmente decididos no dispositivo é fornecida. Em outras palavras, uma solicitação Target Delivery API é necessária.
remote_views
lista[str]
Quando o método de decisão é no dispositivo, uma matriz de nomes de visualização que não puderam ser totalmente decididos no dispositivo é fornecida. Em outras palavras, uma solicitação Target Delivery API é necessária.

Exemplo

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