Ottieni offerte (.NET)

Descrizione

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

Metodo

Firma del metodo TargetClient.GetOffers.

.NET

TargetDeliveryResponse TargetClient.GetOffers(TargetDeliveryRequest request)

TargetDeliveryRequest è stato creato utilizzando TargetDeliveryRequest.Builder.

.NET

TargetDeliveryRequest.Builder TargetDeliveryRequest.Builder()

Parametri

L'oggetto TargetDeliveryRequest.Builder ha la seguente struttura:

Nome
Tipo
Obbligatorio
Descrizione
Contesto
Contesto
Specifica il contesto per la richiesta
sessionId
Stringa
No
Utilizzato per collegare più richieste Target
thirdPartyId
Stringa
No
Identificatore della tua azienda per l'utente che puoi inviare con ogni chiamata
cookie
Elenco
No
Elenco di cookie restituiti nella precedente richiesta Target dello stesso utente.
customerIds
Mappa
No
ID cliente in formato compatibile con VisitorId
esegui
ExecuteRequest
No
Richiesta PageLoad o mboxes da eseguire. Verrà immediatamente valutato sul lato server
preacquisizione
PrefetchRequest
No
Visualizzazioni, PageLoad o mbox richiedono la preacquisizione. Restituisce con il token di notifica da restituire al momento della conversione.
Notifiche
Elenco
No
Utilizzato per inviare notifiche relative al contenuto prerecuperato visualizzato
requestId
Stringa
No
L’ID della richiesta che verrà restituito nella risposta. Generato automaticamente se non presente.
impressionId
Stringa
No
Se presente, la seconda e le richieste successive con lo stesso ID non incrementeranno le impression ad attività/metriche. Generato automaticamente se non presente.
environmentId
Lungo
No
ID ambiente client valido. Se non viene specificato, l’host verrà determinato in base all’host fornito.
proprietà
Proprietà
No
Specifica la at_property tramite il campo token. Può essere utilizzato per controllare l’ambito della consegna.
traccia
Traccia
No
Abilita la traccia per l’API di consegna.
qaMode
QAMode
No
Utilizza questo oggetto per abilitare la modalità di controllo qualità nella richiesta.
locationHint
Stringa
No
hint posizione cluster edge Target. Utilizzato per eseguire il targeting di un determinato cluster Edge per questa richiesta.
visitatore
Visitatore
No
Utilizzato per fornire un oggetto API visitatore personalizzato.
ID
VisitorId
No
Oggetto contenente gli identificatori del visitatore. Esempio: tntId, thirdParyId, mcId, customerIds.
experienceCloud
Experience Cloud
No
Specifica le integrazioni con Audience Manager e Analytics. Compilato automaticamente utilizzando i cookie, se non fornito.
tntId
Stringa
No
Identificatore primario in Target per un utente. Recuperato da targetCookies. Generato automaticamente se non specificato.
mcId
Stringa
No
Utilizzato per unire e condividere dati tra diverse soluzioni Adobe (ECID). Recuperato da targetCookies. Generato automaticamente se non specificato.
trackingServer
Stringa
No
Il server Adobe Analytics affinché Adobe Target e Adobe Analytics uniscano correttamente i dati.
trackingServerSecure
Stringa
No
Adobe Analytics Secure Server affinché Adobe Target e Adobe Analytics uniscano correttamente i dati.
decisioningMethod
DecisioningMethod
No
Può essere utilizzato per impostare in modo esplicito il metodo di decisione ON_DEVICE o HYBRID per le decisioni sul dispositivo

I valori di ciascun campo devono essere conformi alla specifica della richiesta API di consegna Target.

Risposta

TargetDeliveryResponse restituito da TargetClient.GetOffers() ha la seguente struttura:

Nome
Tipo
Descrizione
Richiesta
TargetDeliveryRequest​
Richiesta API di consegna Target
Risposta
DeliveryResponse​
Risposta API di consegna Target*
Stato
HttpStatusCode
Codice di stato HTTP della risposta
Messaggio
stringa
Messaggio di stato di risposta o messaggio di errore
Posizioni
Posizioni
Nomi di posizione Target, inclusi il nome della mbox globale e mbox/visualizzazioni per cui è disponibile solo il decisioning remoto
GetCookies
Dizionario
Restituisce un dizionario di metadati di sessione per questo utente. Questo deve essere passato nella prossima richiesta Target per questo utente.
VisitorState
Icona ID
Stato del visitatore da impostare sul lato client per l'inizializzazione della libreria JavaScript dell'API del visitatore

L'oggetto TargetCookie utilizzato per il salvataggio dei dati per la sessione utente ha la seguente struttura:

Nome
Tipo
Descrizione
Nome
stringa
Nome cookie
Valore
stringa
Valore cookie
MaxAge
int
L'opzione MaxAge è utile per impostare le scadenze relative al tempo corrente in secondi

Non devi preoccuparti di scadere i cookie. Target gestisce MaxAge nell'SDK.

Esempio

.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