Ottieni offerte (.NET)

Ultimo aggiornamento: 2023-07-27
  • Argomenti:
  • APIs/SDKs
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Developer

Descrizione

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

Metodo

TargetClient.GetOffers firma del metodo.

.NET

TargetDeliveryResponse TargetClient.GetOffers(TargetDeliveryRequest request)

TargetDeliveryRequest viene creato utilizzando TargetDeliveryRequest.Builder.

.NET

TargetDeliveryRequest.Builder TargetDeliveryRequest.Builder()

Parametri

Il TargetDeliveryRequest.Builder L'oggetto ha la seguente struttura:

Nome Tipo Obbligatorio Descrizione
Contesto Contesto Specifica il contesto per la richiesta
sessionId Stringa No Utilizzato per il collegamento di più Target richieste
thirdPartyId Stringa No Identificatore della tua azienda per l'utente che puoi inviare con ogni chiamata
cookie Elenco No Elenco dei cookie restituiti in precedenza Target richiesta 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 Target hint di posizione cluster edge. 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 Audienci 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 per Adobe Target e Adobe Analytics per unire correttamente i dati.
trackingServerSecure Stringa No Il Adobe Analytics Secure Server affinché Adobe Target e Adobe Analytics per unire 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 a API di consegna di Target specifica della richiesta.

Risposta

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

Nome Tipo Descrizione
Richiesta TargetDeliveryRequest​ API di consegna di Target richiesta
Risposta DeliveryResponse​ API di consegna di Target* risposta
Stato HttpStatusCode Codice di stato HTTP della risposta
Messaggio stringa Messaggio di stato di risposta o messaggio di errore
Posizioni Posizioni Target nomi delle posizioni, inclusi il nome della mbox globale e mbox/viste per le quali è disponibile solo remote decisioning
GetCookies Dizionario Restituisce un dizionario di metadati di sessione per questo utente. Questo deve essere trasmesso il prossimo 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

Il TargetCookie l’oggetto utilizzato per salvare i dati per la sessione utente ha la seguente struttura:

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

Non devi preoccuparti di scadere i cookie. Target maniglie MaxAge all’interno dell’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);

In questa pagina