Voorstel ophalen (Java)

Laatst bijgewerkt: 27 juli 2023

Onderwerpen:
APIs/SDKs

Gemaakt voor:

Ontwikkelaar

Beschrijving

getOffers() wordt gebruikt om een besluit uit te voeren en een ervaring van terug te winnen Adobe Target.

Methode

getOffers

De TargetClient.getOffers De methodehandtekening wordt als volgt getoond.

Verzoek

TargetDeliveryResponse TargetClient.getOffers(TargetDeliveryRequest request)

TargetDeliveryRequest wordt gemaakt met TargetDeliveryRequest.builder.

Antwoord

TargetDeliveryRequestBuilder TargetDeliveryRequest.builder()

Parameters

De TargetDeliveryRequestBuilder object heeft de volgende structuur:

Naam

Type

Vereist

Beschrijving

context

Context

Ja

Geeft de context voor de aanvraag op

sessionId

String

Nee

thirdPartyId

String

Nee

Uw bedrijfs herkenningsteken voor de gebruiker die u met elke vraag kunt verzenden

cookies

Lijst

Nee

Lijst met cookies die zijn geretourneerd in vorige Target verzoek van dezelfde gebruiker.

customerIds

Kaart

Nee

Klant-id's in de indeling VisitorId die compatibel is met

uitvoeren

ExecuteRequest

Nee

PageLoad of vakjes verzoeken uit te voeren. Wordt meteen aan de serverzijde geëvalueerd

prefetch

PrefetchRequest

Nee

Weergaven, PageLoad of vakjes vragen om een voorvoegsel. Retourneert met berichttoken dat moet worden geretourneerd bij conversie.

meldingen

Lijst

Nee

Gebruikt om meldingen te verzenden over welke vooraf ingestelde inhoud werd weergegeven

requestId

String

Nee

De aanvraag-id die in de reactie wordt geretourneerd. Automatisch gegenereerd als dit niet het geval is.

pictureId

String

Nee

Indien aanwezig, zullen de tweede en verdere verzoeken met zelfde identiteitskaart geen impressies aan activiteiten/metriek verhogen. Automatisch gegenereerd als dit niet het geval is.

environmentId

Lang

Nee

Geldige client environment-id. Indien niet opgegeven host wordt bepaald op basis van de opgegeven host.

eigenschap

Eigenschap

Nee

Specifies the at_property via the token field. Het kan worden gebruikt om de draagwijdte voor de levering te controleren.

traceren

Traceren

Nee

Schakelt tracering voor levering-API in.

qaMode

QAMode

Nee

Gebruik dit object om de QA-modus in de aanvraag in te schakelen.

locationHint

String

Nee

Target locatiehint randcluster. Wordt gebruikt om opgegeven Edge-clusters voor deze aanvraag als doel in te stellen.

bezoeker

Bezoeker

Nee

Wordt gebruikt om een aangepast Bezoeker-API-object aan te bieden.

id

VisitorId

Nee

Object dat de id's voor de bezoeker bevat. Eg. tntId, thirdParyId, mcId, customerIds.

ExperienceCloud

Nee

Geeft integratie met Audience Manager en Analytics aan. Automatisch vullen met behulp van cookies, indien niet beschikbaar.

tntId

String

Nee

Primaire id in Target voor een gebruiker. Vanuit targetCookies gevonden. Automatisch gegenereerd als dit niet is opgegeven.

mcId

String

Nee

Wordt gebruikt om gegevens samen te voegen en te delen tussen verschillende Adobe oplossingen (ECID). Vanuit targetCookies gevonden. Automatisch gegenereerd als dit niet is opgegeven.

trackingServer

String

Nee

De Adobe Analytics-server Adobe Target en Adobe Analytics om de gegevens correct aan elkaar te koppelen.

trackingServerSecure

String

Nee

De Adobe Analytics Secure Server om Adobe Target en Adobe Analytics om de gegevens correct aan elkaar te koppelen.

determinoningMethod

DecisioningMethod

Nee

Kan worden gebruikt om de ON_DEVICE- of HYBRID-beslissingsmethode expliciet in te stellen voor apparaatbeslissingen

De waarden van elk veld moeten overeenkomen met Target View Delivery API verzoek specificeren. Meer informatie over de Target View Delivery API, zie http://developers.adobetarget.com/api/#view-delivery-overview

Antwoord

De TargetDeliveryResponse geretourneerd door TargetClient.getOffers() heeft de volgende structuur:

Naam

Type

Beschrijving

verzoek

TargetDeliveryRequest-

Target verzoek

reactie

DeliveryResponse

Target reactie

cookies

Lijst

Lijst met sessiemetagegevens voor deze gebruiker. Moet worden overgegaan in volgende doelverzoek voor deze gebruiker.

bezoekerState

Kaart

Bezoekersstatus op de client in te stellen voor gebruik door de Bezoeker-API

responseStatus

ResponseStatus

Een object dat de status van het antwoord vertegenwoordigt

De ResponseStatus in het antwoord staan de volgende velden:

Naam

Type

Beschrijving

status

int

HTTP-status geretourneerd van Target

message

String

Statusbericht als de HTTP-status niet 200 is

remoteMboxes

Lijst met tekenreeksen

Wordt gebruikt voor apparaatbeslissingen. Bevat een lijst van dozen die verre activiteiten hebben die niet volledig op-apparaat kunnen worden beslist.

remoteViews

Lijst met tekenreeksen

Wordt gebruikt voor apparaatbeslissingen. Bevat een lijst van meningen die verre activiteiten hebben die niet volledig op-apparaat kunnen worden beslist.

De TargetCookie Het object dat wordt gebruikt voor het opslaan van gegevens voor gebruikerssessie heeft de volgende structuur:

Naam

Type

Beschrijving

name

String

Naam cookie

value

String

Cookie-waarde, de waarde wordt omgezet in tekenreeks

maxAge

Getal

De optie maxAge is een handigheid voor het instellen van een vervaldatum ten opzichte van de huidige tijd in seconden

Je hoeft je geen zorgen te maken over het verlopen van de cookies. Het doel handelt maxAge binnen SDK af.

Voorbeeld

Verzoek

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();

Antwoord

TargetDeliveryResponse targetResponse = targetJavaClient.getOffers(targetDeliveryRequest);

recommendation-more-help