Adobe Target Bulk Profile Update API

The Adobe Target Bulk Profile Update API Med kan du uppdatera användarprofiler för flera besökare på en webbplats i grupp med hjälp av en gruppfil.

Använda Bulk Profile Update APIkan du enkelt skicka detaljerade besökarprofildata i form av profilparametrar för många användare till Target från valfri extern källa. Externa källor kan vara CRM- eller POS-system (Point of Sale) som vanligtvis inte finns på en webbsida.

Version
URL-exempel
Funktioner
v1
http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/profile/batchUpdate
Stöd endast för bulkprofiluppdatering.
v2
http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate
  • Skapa profil om den inte hittas.
  • Statusuppdatering per rad.
NOTE
Version 2 (v2) av Bulk Profile Update API är den aktuella versionen. Men Target stöder fortfarande version 1 (v1).

Fördelar med API:t för gruppprofilsuppdatering

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

Caveats

  • Batchfilens storlek måste vara mindre än 50 MB. Dessutom bör det totala antalet rader inte överstiga 500 000 rader per överföring.
  • Uppdateringar sker vanligtvis på mindre än en timme, men kan ta så lång tid som 24 timmar att reflektera.
  • Det finns ingen gräns för hur många rader du kan överföra under 24 timmar i efterföljande batchar. Intag kan dock begränsas under kontorstid för att säkerställa att andra processer körs effektivt.
  • Flera anrop till efterföljande v2-batchuppdatering utan mbox-anrop däremellan för samma thirdPartyIds åsidosätter egenskaperna som uppdaterades i det första batchuppdateringsanropet.
  • Adobe garanterar inte att 100 % av gruppprofilsdata kommer att inkluderas och behållas i Target och därmed vara tillgängliga för användning vid målgruppsanpassning. I den aktuella designen finns det en möjlighet att en liten andel data (upp till 0,1 % av stora tillverkningssatser) inte tas med eller behålls.

Gruppfil

Om du vill uppdatera flera profildata samtidigt skapar du en gruppfil. Gruppfilen är en textfil med värden som avgränsas med kommatecken som liknar följande exempelfil.

\ batch=pcId, param1, param2, param3, param4 123, value1 124, value1, value4 125, value2 126, value1, value2, value3, value4\

Du refererar till den här filen i POSTENS anrop till Target servrar för att bearbeta filen. Tänk på följande när du skapar gruppfilen:

  • Den första raden i filen måste ange kolumnrubriker.
  • Den första rubriken ska antingen vara en pcId eller thirdPartyId. The Marketing Cloud visitor ID stöds inte. pcId är en Target-genererad visitorID. thirdPartyId är ett ID som anges av klientprogrammet, som skickas till Target via ett mbox-anrop som mbox3rdPartyId. Här anges den som thirdPartyId.
  • Parametrar och värden som du anger i gruppfilen måste vara URL-kodade med UTF-8 av säkerhetsskäl. Parametrar och värden kan vidarebefordras till andra kantnoder för bearbetning via HTTP-begäranden.
  • Parametrarna måste ha formatet paramName endast. Parametrar visas i Target as profile.paramName.
  • Om du använder Bulk Profile Update API v2, du behöver inte ange alla parametervärden för varje pcId. Profiler skapas för alla pcId eller mbox3rdPartyId som inte finns i Target. Om du använder v1 skapas inte profiler för pcIds som saknas eller mbox3rdPartyIds.
  • Batchfilens storlek måste vara mindre än 50 MB. Dessutom bör det totala antalet rader inte överstiga 500 000. Den här gränsen gör att servrarna inte översvämmas av för många förfrågningar.
  • Du kan skicka flera filer. Summan av raderna i alla filer som du skickar en dag får dock inte överstiga en miljon för varje kund.
  • Det finns ingen gräns för hur många attribut du överför. Den totala storleken på en profil, inklusive systemdata, bör dock inte överstiga 2000 kB. Adobe rekommenderar att du använder mindre än 1 000 kB lagringsutrymme för profilattribut.
  • Parametrar och värden är versalkänsliga.

Begäran om HTTP-POST

Gör en HTTP-POST-förfrågan till Target edge-servrar för att bearbeta filen. Här följer ett exempel på en HTTP-POST-begäran för filen batch.txt med kommandot curl:

\ curl -X POST --data-binary @BATCH.TXT http\://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate\

Var:

BATCH.TXT är filnamnet. CLIENTCODE är Target klientkod.

Om du inte känner till din klientkod går du till Target användargränssnitt klicka Administration > Implementation. Klientkoden visas i Account Details -avsnitt.

Inspect svar

Profiles API returnerar batchjobbets överföringsstatus för bearbetning tillsammans med en länk under"batchStatus" till en annan URL som visar det aktuella batchjobbets övergripande status.

Exempel på API-svar

Följande kod är ett exempel på ett Profiles API-svar:

<response>
    <success>true</success>
    <batchStatus>http://mboxedge45.tt.omtrdc.net/m2/demo/profile/batchStatus?batchId=demo-1701473848678-13029383</batchStatus>
    <message>Batch submitted for processing</message>
</response>

Om ett fel uppstår innehåller svaret success=false och ett detaljerat felmeddelande.

Standardbatchstatussvar

Ett lyckat standardsvar när ovanstående batchStatus URL-länken som klickas ser ut så här:

<response><batchId>demo4-1701473848678-13029383</batchId><status>complete</status><batchSize>1</batchSize></response>

Förväntade värden för statusfälten är:

Status
Information
complete
Begäran om uppdatering av profilbatch har slutförts.
incomplete
Begäran om uppdatering av profilbatch bearbetas fortfarande och slutförs inte.
stuck
Begäran om uppdatering av profilgrupp har fastnat och kunde inte slutföras.

Detaljerat svar på batchstatus-URL

Ett mer detaljerat svar kan hämtas genom att en parameter skickas showDetails=true till batchStatus url ovan.

Exempel:

http://mboxedge45.tt.omtrdc.net/m2/demo/profile/batchStatus?batchId=demo-1701473848678-13029383&showDetails=true

Detaljerat svar

<response>
    <batchId>demo4-1701473848678-13029383</batchId>
    <status>complete</status>
    <batchSize>1</batchSize>
    <consumedCount>1</consumedCount>
    <successfulUpdates>1</successfulUpdates>
    <profilesNotFound>0</profilesNotFound>
    <failedUpdates>0</failedUpdates>
</response>
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3