Adobe Target Single Profile Update API

The Adobe Target Single Profile Update API Med kan du skicka en profiluppdatering för en enskild användare. The Single Profile Update API är nästan identisk med Bulk Profile Update API, men en besökarprofil uppdateras åt gången, i linje med API-anropet i stället för med en .cvs-fil.

The Single Profile Update API och används vanligtvis när en uppdatering måste ske i relation till en transaktion som inträffar i en kanal som inte har implementerats Target. Du vill till exempel uppdatera profilen för en enskild besökare som utför en offlineåtgärd. Åtgärderna kan omfatta att nå en kundtjänst, ett lån finansieras, använda ett förmånskort i butik, få tillgång till en kioskdator och så vidare.

Fördelar med Single Profile Update API inkludera:

  • Det finns ingen gräns för antalet profilattribut.
  • Profilattribut som skickas via webbplatsen kan uppdateras via API och tvärtom.

Caveats

  • The Single Profile Update API begränsas till att utföra 1 miljon uppdateringar under en 24-timmarsperiod.

  • Uppdateringar sker vanligtvis på mindre än en timme, men kan ta så lång tid som 24 timmar att reflektera.

    Om du måste skicka fler uppdateringar, eller begära att uppdateringar ska behandlas inom kortare tidsramar, kan det vara bra att skicka uppdateringar av transaktionsprofiler via uppdatering på klientsidan (standard) eller via Adobe Target server-side Leverans-API.

  • The Single Profile Update API är ett server-till-server-API och är inte utformat för att fungera inom en webbsida. Om du vill uppdatera en besökarprofil inifrån webbsidan kan du använda trackEvent() funktionen eller Leverans-API.

Format

Ange profilparametrarna i formatet profile.paramName=value.

Så här uppdaterar du profilen för en pcId, använd:

\ https\://\<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mboxPC=1368007744041-575948.01\_00\&profile.attr=0\&profile.attr2=1…\

Så här uppdaterar du profilen för en mbox3rdPartyId, använd:

\ shell http\://\<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mbox3rdPartyId=123456\&profile.attr=0\&profile.attr2=1…\

The Single Profile Update API endast för uppdateringar. Om inget hittas skapas ingen profil.

Anteckningar

  • Parametrar och värden måste vara URL-kodade med UTF-8.
  • Parameterformatet är profile.paramName.
  • Alla parametervärden måste inte finnas för alla pcIds och mbox3rdPartyIds.
  • Parametrar och värden är versalkänsliga.
  • Både GET och POST stöds.
  • Begränsningen för GET är för närvarande 8 kB och 60 kB för POST.

Svar

Ett exempelsvar för ovanstående begäranden ser ut så här:

trueRequest successfully submitted

Detta svar anger att svaret har skickats och kommer att behandlas snart.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3