getOffers

getOffers(String sessionID, String interactionPoint, int numberOfOffers)

Mit der getOffers-Methode können Sie Angebote vom Laufzeitserver anfordern.

sessionID - eine Zeichenfolge, die die aktuelle Sitzung angibt.

interactionPoint - eine Zeichenfolge, die den Namen des Interaktionspunkts angibt, auf den diese Methode verweist.

Dieser Name muss exakt mit dem Namen des im interaktiven Kanal definierten Interaktionspunkts übereinstimmen.

numberOfOffers - eine Ganzzahl, die die Anzahl der angeforderten Angebote angibt.

Bevor die getOffers-Methode ausgeführt wird, wartet sie so viele Millisekunden, wie in der segmentationMaxWaitTimeInMS-Eigenschaft angegeben sind, um die erneute Segmentierung abzuschließen. Daher kann es zu einer Verzögerung kommen, wenn Sie eine postEvent-Methode aufrufen, die sofort eine erneute Segmentierung oder eine setAudience-Methode auslöst, bevor ein getOffers-Aufruf erfolgt.

Rückgabewert

Der Laufzeitserver beantwortet getOffers mit einem Response-Objekt, das die folgenden Attribute enthält:

Dieses Beispiel zeigt, wie Sie ein einzelnes Angebot für den Interaktionspunkt "Overview Page Banner 1" anfordern und danach die Antwort bearbeiten können.

sessionId ist die gleiche Zeichenfolge zur Identifizierung, die beim Start der Laufzeitsitzung mit dem startSession-Aufruf verwendet wurde.

String interactionPoint = "Overview Page Banner 1";
int numberRequested=1;

/** Aufruf durchführen */
response = api.getOffers(sessionId, interactionPoint, numberRequested);

/** Antwort entsprechend verarbeiten */
// Prüfung, ob die Antwort erfolgreich ist oder nicht
if(response.getStatusCode() == Response.STATUS_SUCCESS)
{
System.out.println("getOffers-Aufruf ohne Warnungen oder Fehler verarbeitet");

/** Prüfung, ob Angebote vorhanden sind */
OfferList offerList=response.getOfferList();

if(offerList.getRecommendedOffers() != null)
{
for(Offer offer : offerList.getRecommendedOffers())
{
// Angebot drucken
System.out.println("Angebotsname:"+offer.getOfferName());
}
}
else // auf die Zeichenfolge für das Standardangebot zählen System.out.println("Standardangebot:"+offerList.getDefaultString());
}
else if(response.getStatusCode() == Response.STATUS_WARNING)
{
System.out.println("getOffers-Aufruf mit einer Warnung verarbeitet");
}
else
{
System.out.println("getOffers-Aufruf mit einem Fehler verarbeitet");
}
// Für alle fehlgeschlagenen Aktionen sollten Advisory Messages die Ursache erklären
if(response.getStatusCode() != Response.STATUS_SUCCESS)
printDetailMessageOfWarningOrError("getOffers",
response.getAdvisoryMessages());