Erbjudanden (.NET)

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

Ämnen:
APIs/SDKs

Skapat för:

Utvecklare

Beskrivning

GetOffers() används för att köra ett beslut och hämta en upplevelse från Adobe Target.

Metod

TargetClient.GetOffers-metodsignatur.

.NET

TargetDeliveryResponse TargetClient.GetOffers(TargetDeliveryRequest request)

TargetDeliveryRequest skapas med TargetDeliveryRequest.Builder.

.NET

TargetDeliveryRequest.Builder TargetDeliveryRequest.Builder()

Parametrar

Objektet TargetDeliveryRequest.Builder har följande struktur:

Namn

Typ

Obligatoriskt

Beskrivning

kontext

Kontext

Anger kontexten för begäran

sessionId

Sträng

Nej

Används för att länka flera Target-begäranden

thirdPartyId

Sträng

Nej

Ditt företags-ID för användaren som du kan skicka med varje samtal

Lista

Nej

Lista över cookies som returnerats i en tidigare Target-begäran från samma användare.

customerIds

Karta

Nej

Kund-ID i VisitorId-kompatibelt format

execute

ExecuteRequest

Nej

PageLoad eller mboxes begär att köras. Utvärderingen av servern kommer att göras omedelbart

förhämtning

PrefetchRequest

Nej

Vyer, PageLoad eller mboxes begär att få förhämtning. Returnerar med en meddelandetoken som ska returneras vid konvertering.

meddelanden

Lista

Nej

Används för att skicka meddelanden om vilket förhämtat innehåll som visades

requestId

Sträng

Nej

Begärande-ID som returneras i svaret. Genereras automatiskt om den inte finns.

scriptId

Sträng

Nej

Om det finns en andra och efterföljande begäran med samma ID ökar inte intrycket av aktiviteter/mått. Genereras automatiskt om den inte finns.

environmentId

Lång

Nej

Giltigt ID för klientmiljö. Om ingen angiven värd anges bestäms den utifrån den angivna värden.

property

Egenskap

Nej

Anger egenskapen at_property via tokenfältet. Den kan användas för att styra leveransomfånget.

trace

Kalkera

Nej

Aktiverar spårning för leverans-API.

qaMode

QAMode

Nej

Använd det här objektet för att aktivera QA-läget i begäran.

locationHint

Sträng

Nej

Tips för Target edge-klusterplats. Används för att ange angivet edge-kluster som mål för denna begäran.

besökare

Besökare

Nej

Används för att tillhandahålla anpassade Visitor API-objekt.

VisitorId

Nej

Objekt som innehåller identifierarna för besökaren. T.ex. tntId, thirdParyId, mcId, customerIds.

experienceCloud

ExperienceCloud

Nej

Anger integreringar med Audience Manager och Analytics. Fylls i automatiskt med hjälp av cookies, om detta inte anges.

tntId

Sträng

Nej

Primär identifierare i Target för en användare. Hämtat från targetCookies. Automatiskt genererad om inte.

mcId

Sträng

Nej

Används för att sammanfoga och dela data mellan olika Adobe-lösningar (ECID). Hämtat från targetCookies. Automatiskt genererad om inte.

trackingServer

Sträng

Nej

Adobe Analytics-servern för att Adobe Target och Adobe Analytics ska kunna sammanfoga data korrekt.

trackingServerSecure

Sträng

Nej

Adobe Analytics Secure Server för att Adobe Target och Adobe Analytics ska kunna sammanfoga data korrekt.

decisioningMethod

DecisioningMethod

Nej

Kan användas för att explicit ange ON_DEVICE eller HYBRID-beslutsmetod för enhetsbeslut

Värdena för varje fält ska överensstämma med förfrågningsspecifikationen Target Delivery API .

Svar

TargetDeliveryResponse som returneras av TargetClient.GetOffers() har följande struktur:

Namn

Typ

Beskrivning

Begäran

TargetDeliveryRequest

API-begäran för målleverans

Svar

DeliveryResponse

Målleverans-API* svar

Status

HttpStatusCode

HTTP-statuskod för svar

Meddelande

string

Svarsstatusmeddelande eller felmeddelande

Platser

Platsnamn för Target, inklusive globalt mbox-namn och mbox/views där endast fjärråtkomstbeslut är tillgängligt

GetCookies

Ordlista

Returnerar en ordlista med sessionsmetadata för den här användaren. Detta måste skickas i nästa Target-begäran för den här användaren.

VisitorState

IDictionary

Besökartillstånd som ska anges på klientsidan för initiering av JavaScript-bibliotek i Visitor API

Objektet TargetCookie som används för att spara data för användarsession har följande struktur:

Namn

Typ

Beskrivning

Namn

string

Kaknamn

Värde

string

Cookie-värde

MaxAge

int

Alternativet MaxAge är praktiskt om du vill ange Förfaller i förhållande till den aktuella tiden i sekunder

Du behöver inte oroa dig för att cookies ska upphöra. Target handtag MaxAge inuti SDK:n.

Exempel

.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