Adobe Target Single Profile Update API
Die Adobe Target Single Profile Update API ermöglicht den Versand einer Profilaktualisierung an einen einzelnen Benutzer. Die Single Profile Update API ist fast identisch mit dem Bulk-Profil-Update-API, jedoch wird jeweils ein Besucherprofil aktualisiert, und zwar entsprechend dem API-Aufruf und nicht mit einer .cvs-Datei.
Die Single Profile Update API und wird im Allgemeinen verwendet, wenn eine Aktualisierung für eine Transaktion vorgenommen werden muss, die in einem Kanal erfolgt, der nicht implementiert wurde Target. Sie möchten beispielsweise das Profil eines einzelnen Besuchers aktualisieren, der eine Offline-Aktion ausführt. Zu den Aktionen gehören das Erreichen eines Callcenters, die Finanzierung eines Darlehens, die Verwendung einer Treuekarte im Geschäft, der Zugriff auf einen Kiosk usw.
Vorteile der Single Profile Update API include:
- Keine Begrenzung der Anzahl der Profilattribute.
- Profilattribute, die über die Site gesendet werden, können über die API aktualisiert werden und umgekehrt.
Einschränkungen
-
Die Single Profile Update API ist auf die Durchführung von 1 Million Aktualisierungen in einem beliebigen rollierenden 24-Stunden-Zeitraum beschränkt.
-
Aktualisierungen treten in der Regel in weniger als einer Stunde auf, können jedoch bis zu 24 Stunden dauern, bis sie angezeigt werden.
Wenn Sie weitere Aktualisierungen senden oder die Verarbeitung von Aktualisierungen in kürzeren Zeitrahmen erfordern, sollten Sie in Erwägung ziehen, Transaktionsprofilaktualisierungen über eine clientseitige Aktualisierung (empfohlen) oder über die Variable Adobe Target serverseitig Bereitstellungs-API.
-
Die Single Profile Update API ist eine Server-zu-Server-API und nicht für die Arbeit auf einer Webseite konzipiert. Um ein Besucherprofil über Ihre Webseite zu aktualisieren, können Sie die Variable trackEvent() oder Bereitstellungs-API.
Format
Geben Sie die Profilparameter im Format an profile.paramName=value.
So aktualisieren Sie das Profil für eine pcIdverwenden:
\ https\://\<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mboxPC=1368007744041-575948.01\_00\&profile.attr=0\&profile.attr2=1…\
So aktualisieren Sie das Profil für eine mbox3rdPartyIdverwenden:
\ shell http\://\<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mbox3rdPartyId=123456\&profile.attr=0\&profile.attr2=1…\
Die Single Profile Update API ist nur für Aktualisierungen vorgesehen. Wenn nichts gefunden wird, wird kein Profil erstellt.
Hinweise
- Parameter und Werte müssen mit UTF-8 URL-kodiert werden.
- Das Parameterformat ist
profile.paramName. - Es müssen nicht alle Parameterwerte für alle pcIds und mbox3rdPartyIds vorhanden sein.
- Bei Parametern und Werten wird zwischen Groß- und Kleinschreibung unterschieden.
- Sowohl GET als auch POST werden unterstützt.
- Die aktuellen Größenbeschränkungen für Limit sind 8 KB für GET und 60 KB für POST.
Antwort
Eine Beispielantwort für die oben genannten Anforderungen sieht wie folgt aus:
trueRequest successfully submitted
Diese Antwort gibt an, dass die Antwort gesendet wurde und bald verarbeitet wird.