Voorstel ophalen (Java)

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
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
6906415f-169c-422b-89d3-7118e147c4e3