Obter Ofertas (.NET)
Descrição
GetOffers() é usado para executar uma decisão e recuperar uma experiência de Adobe Target.
Método
Assinatura do método TargetClient.GetOffers.
.NET
TargetDeliveryResponse TargetClient.GetOffers(TargetDeliveryRequest request)
TargetDeliveryRequest é criado usando TargetDeliveryRequest.Builder.
.NET
TargetDeliveryRequest.Builder TargetDeliveryRequest.Builder()
Parâmetros
O objeto TargetDeliveryRequest.Builder tem a seguinte estrutura:
Nome
Tipo
Obrigatório
Descrição
contexto
Contexto
Sim
Especifica o contexto da solicitação
sessionId
String
Não
Usado para vincular várias solicitações Target
thirdPartyId
String
Não
O identificador de sua empresa para o usuário que você pode enviar com cada chamada
cookies
Lista
Não
Lista de cookies retornados na solicitação Target anterior do mesmo usuário.
customerIds
Mapa
Não
IDs de cliente em formato compatível com VisitorId
executar
ExecuteRequest
Não
Solicitação de PageLoad ou mboxes para execução. Será avaliado no lado do servidor imediatamente
pré-busca
PrefetchRequest
Não
Exibições, Carregamento de página ou solicitação de mboxes para realizar a busca prévia. Retorna com o token de notificação a ser retornado na conversão.
notificações
Lista
Não
Usado para enviar notificações sobre qual conteúdo previamente buscado era exibido
requestId
String
Não
A ID da solicitação que será retornada na resposta. Gerado automaticamente se não estiver presente.
impressionId
String
Não
Se presentes, a segunda e as solicitações subsequentes com a mesma id não incrementarão impressões para atividades/métricas. Gerado automaticamente se não estiver presente.
environmentId
Longo
Não
ID de ambiente de cliente válida. Se não for especificado, o host será determinado com base no host fornecido.
propriedade
Propriedade
Não
Especifica at_property por meio do campo de token. Ela pode ser usada para controlar o escopo do delivery.
trace
Trace
Não
Habilita o rastreamento para a API de Entrega.
qaMode
QAMode
Não
Use esse objeto para ativar o modo de QA na solicitação.
locationHint
String
Não
Dica de local do cluster de borda Target. Usado para direcionar determinado cluster de borda para esta solicitação.
visitante
Visitante
Não
Usado para fornecer o objeto de API do visitante personalizado.
id
VisitorId
Não
Objeto que contém os identificadores do visitante. P. ex. tntId, thirdParyId, mcId, customerIds.
experienceCloud
Experience Cloud
Não
Especifica integrações com o Audience Manager e o Analytics. Preenchido automaticamente usando cookies, se não fornecido.
tntId
String
Não
Identificador principal em Target de um usuário. Obtido de targetCookies. Gerado automaticamente se não fornecido.
mcId
String
Não
Usado para mesclar e compartilhar dados entre diferentes soluções de Adobe (ECID). Obtido de targetCookies. Gerado automaticamente se não fornecido.
trackingServer
String
Não
O Servidor do Adobe Analytics para que Adobe Target e Adobe Analytics unam corretamente os dados.
trackingServerSecure
String
Não
O Adobe Analytics Secure Server para que Adobe Target e Adobe Analytics unam corretamente os dados.
decisioningMethod
DecisioningMethod
Não
Pode ser usado para definir explicitamente o método de decisão ON_DEVICE ou HYBRID para a decisão no dispositivo
Os valores de cada campo devem estar em conformidade com a especificação de solicitação da API de entrega do Target.
Resposta
O TargetDeliveryResponse retornado por TargetClient.GetOffers() tem a seguinte estrutura:
Nome
Tipo
Descrição
Status
HttpStatusCode
Código de status HTTP de resposta
Mensagem
string
Mensagem de status de resposta ou mensagem de erro
Localizações
Localizações
Target nomes de locais, incluindo nome de mbox global e mboxes/modos de exibição para os quais somente a decisão remota está disponível
GetCookies
Dicionário
Retorna um dicionário de metadados da sessão para este usuário. Isto precisa ser passado na próxima solicitação Target para este usuário.
VisitorState
IDictionary
Estado do visitante a ser definido no lado do cliente para a inicialização da biblioteca JavaScript da API do visitante
O objeto TargetCookie usado para salvar dados para a sessão de usuário tem a seguinte estrutura:
Nome
Tipo
Descrição
Nome
string
Nome do cookie
Valor
string
Valor do cookie
MaxAge
int
A opção
MaxAge é uma conveniência para definir Expira em relação ao tempo atual em segundosVocê não precisa se preocupar em expirar os cookies. Target manipula MaxAge dentro do SDK.
Exemplo
.NET
var targetClientConfig = new TargetClientConfig.Builder("acmeClient", "ABCDEF012345677890ABCDEF0@AdobeOrg")
.Build();
var targetClient = TargetClient.Create(targetClientConfig);
var mboxRequests = new List<MboxRequest> { new (index: 1, name: "a1-serverside-ab") };
var targetDeliveryRequest = new TargetDeliveryRequest.Builder()
.SetExecute(new ExecuteRequest(mboxes: mboxRequests))
.Build();
var targetResponse = targetClient.GetOffers(targetDeliveryRequest);
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3