Adobe Target Single Profile Update API
Met Adobe Target Single Profile Update API kunt u een profielupdate voor één gebruiker verzenden. Single Profile Update API is bijna identiek aan Bulk Profile Update API, maar één bezoekersprofiel wordt tegelijkertijd bijgewerkt, inline met de API-aanroep in plaats van met een .cvs-bestand.
Single Profile Update API en wordt doorgaans gebruikt wanneer een update moet worden uitgevoerd met betrekking tot een transactie die plaatsvindt in een kanaal dat Target niet heeft geïmplementeerd. U wilt bijvoorbeeld het profiel bijwerken van één bezoeker die een offlineactie uitvoert. De acties kunnen het bereiken van een callcenter omvatten, wordt een lening gefinancierd, gebruikend een loyaliteitskaart in opslag, die tot een kiosk toegang hebben, etc.
De voordelen van Single Profile Update API zijn onder andere:
- Geen limiet voor het aantal profielkenmerken.
- Profielkenmerken die via de site worden verzonden, kunnen via de API worden bijgewerkt en omgekeerd.
Caveats
-
Single Profile Update API is beperkt tot het uitvoeren van 1 miljoen updates tijdens elke schuivende periode van 24 uur.
-
Updates vinden meestal plaats binnen een uur, maar het kan 24 uur duren voordat ze worden gereflecteerd.
Als u meer updates moet verzenden, of updates vereisen om in kortere tijdkaders worden verwerkt, denk na verzendend transactionele profielupdates via cliënt-zijupdate (aangewezen), of via Adobe Target server-kant Levering API .
-
Single Profile Update API is een server-aan-server API en is niet ontworpen om binnen een webpagina te werken. Om een bezoekersprofiel van binnen uw webpagina bij te werken, kunt u trackEvent () gebruiken functie of Levering API .
Indeling
Geef de profielparameters op in de indeling profile.paramName=value .
Als u het profiel voor een pcId wilt bijwerken, gebruikt u:
https://<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mboxPC=1368007744041-575948.01_00&profile.attr=0&profile.attr2=1...
Als u het profiel voor een mbox3rdPartyId wilt bijwerken, gebruikt u:
shell http://<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mbox3rdPartyId=123456&profile.attr=0&profile.attr2=1...
Single Profile Update API is alleen voor updates. Als er niets wordt gevonden, wordt er geen profiel gemaakt.
Notities
- Parameters en waarden moeten URL-gecodeerd zijn met UTF-8.
- De parameterindeling is
profile.paramName. - Niet alle parameterwaarden moeten voor alle pcIds en mbox3rdPartyIds bestaan.
- Parameters en waarden zijn hoofdlettergevoelig.
- Zowel GET als POST worden ondersteund.
- De huidige formaatbeperkingen voor grens zijn 8 KB voor GET en 60 KB voor POST.
Antwoord
Een voorbeeldreactie voor de bovenstaande verzoeken ziet er als volgt uit:
trueRequest successfully submitted
Dit antwoord geeft aan dat het antwoord is verzonden en binnenkort zal worden verwerkt.