Adobe Target Single Profile Update API
De Adobe Target Single Profile Update API Hiermee kunt u een profielupdate voor één gebruiker verzenden. De 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.
De 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 niet is geïmplementeerd Target. 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 de Single Profile Update API omvatten:
- Geen limiet voor het aantal profielkenmerken.
- Profielkenmerken die via de site worden verzonden, kunnen via de API worden bijgewerkt en omgekeerd.
Caveats
-
De Single Profile Update API is beperkt tot het uitvoeren van 1 miljoen updates in om het even welke het rollen 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 moet verwerken in kortere tijdframes, kunt u overwegen updates van transactionele profielen te verzenden via een update aan de clientzijde (voorkeur) of via de Adobe Target server-kant Leverings-API.
-
De Single Profile Update API is een server-aan-server API en is niet ontworpen om binnen een webpagina te werken. Als u een bezoekersprofiel vanuit uw webpagina wilt bijwerken, kunt u de opdracht trackEvent() of de Leverings-API.
Indeling
De profielparameters in de indeling opgeven profile.paramName=value.
Het profiel bijwerken voor een pcId, gebruik:
\ 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, gebruik:
\ shell http\://\<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mbox3rdPartyId=123456\&profile.attr=0\&profile.attr2=1…\
De 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.
- 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.