Erbjudanden (Java)

Beskrivning

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

Metod

getOffers

TargetClient.getOffers-metodsignaturen visas enligt följande.

Begäran

TargetDeliveryResponse TargetClient.getOffers(TargetDeliveryRequest request)

TargetDeliveryRequest skapas med TargetDeliveryRequest.builder.

Svar

TargetDeliveryRequestBuilder TargetDeliveryRequest.builder()

Parametrar

Objektet TargetDeliveryRequestBuilder har följande struktur:

Namn
Typ
Obligatoriskt
Beskrivning
kontext
Kontext
Ja
Anger kontexten för begäran
sessionId
Sträng
Nej
thirdPartyId
Sträng
Nej
Ditt företags-ID för användaren som du kan skicka med varje samtal
cookies
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.
id
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 Target View Delivery API-begärandespecifikationen. Mer information om Target View Delivery API finns på http://developers.adobetarget.com/api/#view-delivery-overview

Svar

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

Namn
Typ
Beskrivning
förfrågan
TargetDeliveryRequest ​
Target begäran
svar
Leveranssvar
Target svar
cookies
Lista
Lista över sessionsmetadata för den här användaren. Måste skickas i nästa målbegäran för den här användaren.
visitorState
Karta
Besökartillstånd som ska anges på klientsidan och användas av Visitor API
responseStatus
Status för svar
Ett objekt som representerar svarsstatus

ResponseStatus i svaret innehåller följande fält:

Namn
Typ
Beskrivning
status
int
HTTP-status returnerades från Target
message
Sträng
Statusmeddelande om HTTP-statusen inte är 200
remoteMboxes
Lista över strängar
Används för enhetsbeslut. Innehåller en lista med kryssrutor som har fjärraktiviteter som inte kan bestämmas helt på enheten.
remoteViews
Lista över strängar
Används för enhetsbeslut. Innehåller en lista med vyer som har fjärraktiviteter som inte kan bestämmas helt på enheten.

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

Namn
Typ
Beskrivning
name
Sträng
Kaknamn
value
Sträng
Cookie-värde, värdet konverteras till sträng
maxAge
Nummer
Alternativet maxAge är ett bekvämt sätt att ange förfallodatum i förhållande till den aktuella tiden i sekunder

Du behöver inte oroa dig för att cookies ska upphöra. Målet hanterar maxAge inuti SDK.

Exempel

Begäran

ClientConfig clientConfig = ClientConfig.builder()
        .client("acmeclient")
        .organizationId("1234567890@AdobeOrg")
        .build();

TargetClient targetJavaClient = TargetClient.create(clientConfig);

List<MboxRequest> mboxRequests = new ArrayList<>();
mboxRequests.add((MboxRequest) new MboxRequest().name("a1-serverside-ab").index(1));

TargetDeliveryRequest targetDeliveryRequest = TargetDeliveryRequest.builder()
        .context(new Context().channel(ChannelType.WEB))
        .execute(new ExecuteRequest().setMboxes(mboxRequests))
        .build();

Svar

TargetDeliveryResponse targetResponse = targetJavaClient.getOffers(targetDeliveryRequest);
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3