Angebotsdeduplizierung über Angebotsattribute

Unter Verwendung der Anwendungsprogrammierschnittstelle (Application Programming Interface, API) von Unica Interact werden mit zwei API-Aufrufen Angebote bereitgestellt: getOffers und getOffersForMultipleInteractionPoints. getOffersForMultipleInteractionPoints kann die Rückgabe duplizierter Angebote auf der Ebene OfferID verhindern, kann jedoch keine Angebote über eine Angebotskategorie deduplizieren. Daher war z. B. vorher bei Unica Interact für eine Rückgabe von nur einem Angebot aus den einzelnen Angebotskategorien eine Problemumgehung erforderlich. Durch die Einführung von zwei Parametern im API-Aufruf startSession sind Angebotsdeduplizierungen über Angebotsattribute, wie z. B. die Kategorie, jetzt möglich.

In dieser Liste finden Sie eine Übersicht über die Parameter, die dem API-Aufruf startSession hinzugefügt wurden. Sie finden weitere Informationen zu diesen Parametern oder zu sonstigen Aspekten der Unica Interact-API im Unica Interact-Administratorhandbuch sowie in den Javadoc-Dateien, die in Ihrer Unica Interact-Installation enthalten sind. Sie finden diese Dateien im Pfad <Unica Interact_Home>/docs/apiJavaDoc.

  • UACIOfferDedupeAttribute. Wenn Sie einen startSession-API-Aufruf mit Angebotsdeduplizierung erstellen möchten, damit nachfolgende getOffer-Aufrufe immer nur jeweils ein Angebot aus jeder Kategorie zurückgeben, müssen Sie den Parameter UACIOfferDedupeAttribute als Bestandteil des API-Aufrufs einschließen. Sie können einen Parameter wie folgt im Format name,value,type angeben:

    UACIOfferDedupeAttribute,<attributeName>,string

    In diesem Beispiel würden Sie <attributeName> durch den Namen des Angebotsattributs ersetzen, das Sie als Kriterium für die Deduplizierung verwenden möchten (zum Beispiel "Category" (Kategorie)).

    Anmerkung: Unica Interact überprüft die Angebote, die den von Ihnen angegebenen Attributwert (zum Beispiel "Category") aufweisen. Anschließend wird eine Deduplizierung durchgeführt, damit mit Ausnahme des Angebots, das die höchste Bewertung aufweist, alle Angebote entfernt werden. Wenn die Angebote mit einem Attributduplikat auch identische Bewertungen aufweisen, trifft Unica Interact eine Zufallsauswahl unter den übereinstimmenden Angeboten und gibt diese zurück.

  • UACINoAttributeDedupeIfFewerOf. Wenn Sie den Parameter UACIOfferDedupeAttribute im startSession-Aufruf einschließen, können Sie auch den Parameter UACINoAttributeDedupeIfFewerOf festlegen. Damit geben Sie an, wie sich das Programm verhalten soll, wenn die Angebotsliste nach der Deduplizierung nicht genügend Angebote enthält, damit die ursprüngliche Anforderung erfüllt werden kann.

    Wenn Sie beispielsweise für UACIOfferDedupeAttribute die Verwendung der Angebotskategorie zur Deduplizierung von Angeboten festlegen und Ihr nachfolgender getOffers-Aufruf die Rückgabe von acht Angeboten anfordert, kann es sein, dass aufgrund der Deduplizierung weniger als acht auswählbare Angebote verfügbar sind. Wenn Sie den Parameter UACINoAttributeDedupeIfFewerOf auf "true" setzen, werden in diesem Fall einige der deduplizierten Angebote zur Kandidatenliste hinzugefügt, damit die angeforderte Anzahl der Angebote erfüllt wird. Wenn Sie in diesem Beispiel den Parameter auf "false" setzen, wird die angeforderte Anzahl nicht durch die zurückgegebene Anzahl an Angeboten erreicht.

    UACINoAttributeDedupeIfFewerOf Die Standardeinstellung ist "true".

Angenommen, Sie haben wie folgt als Parameter für startSession die Angebotskategorie (Category) als Deduplizierungskriterium angegeben:

UACIOfferDedupeAttribute, Category, string;UACINoAttributeDedupeIfFewerOffer, 0, string

Diese Parameterkombination bewirkt, dass Unica Interact Angebote auf Basis des Angebotsattributs "Category" dedupliziert und selbst dann nur die deduplizierten Angebote zurückgibt, wenn die resultierende Anzahl der Angebote die angeforderte Anzahl unterschreitet (da der Parameter UACINoAttributeDedupeIfFewerOffer auf "false" gesetzt ist).

Wenn Sie einen getOffers-API-Aufruf ausgeben, könnte die ursprüngliche Gruppe der auswählbaren Angebote die folgenden Angebote enthalten:

  • Category=Electronics: Angebot A1 mit einer Bewertung von 100 und Angebot A2 mit einer Bewertung von 50.
  • Category=Smartphones: Angebot B1 mit einer Bewertung von 100, Angebot B2 mit einer Bewertung von 80 und Angebot B3 mit einer Bewertung von 50.
  • Category=MP3Players: Angebot C1 mit einer Bewertung von 100, Angebot C2 mit einer Bewertung von 50.

In diesem Fall gab es zwei doppelte Angebote, die mit der ersten Kategorie übereinstimmen, drei doppelte Angebote, die mit der zweiten Kategorie übereinstimmen, und zwei doppelte Angebote, die mit der dritten Kategorie übereinstimmen. Als Angebote werden die Angebote mit der höchsten Bewertung aus jeder Kategorie zurückgegeben, also Angebot A1, Angebot B1 und Angebot C1.

Obwohl der getOffers-API-Aufruf sechs Angebote angefordert hat, werden nur drei Angebote zurückgegeben, da der Parameter UACINoAttributeDedupeIfFewerOffer in diesem Beispiel auf "false" gesetzt ist.

Wenn der getOffers-API-Aufruf sechs Angebote angefordert hat und in diesem Beispiel keine Angabe für den Parameter UACINoAttributeDedupeIfFewerOffer gemacht oder der Parameter explizit auf "true" gesetzt wurde, werden einige der doppelten Angebote in das Ergebnis aufgenommen, damit die angeforderte Anzahl erfüllt wird.