Adobe Target Bulk Profile Update API
Med Adobe Target Bulk Profile Update API kan du uppdatera användarprofiler för flera besökare till en webbplats i grupp med hjälp av en gruppfil.
Med hjälp av Bulk Profile Update API kan du enkelt skicka detaljerade data om besökarprofiler 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.
http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/profile/batchUpdate
http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate
- Skapa profil om den inte hittas.
- Statusuppdatering per rad.
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 gruppprofildata kommer att sparas i Target och därmed vara tillgängliga för användning i målgrupper. 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\
batch=
är obligatorisk och måste anges i början av filen.Du refererar till den här filen i serveranropet till Target POSTER 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
pcId
ellerthirdPartyId
. Marketing Cloud visitor ID stöds inte. pcId är ett Target-genererat besökar-ID.thirdPartyId
är ett ID som anges av klientprogrammet, som skickas till Target via ett mbox-anrop sommbox3rdPartyId
. Den måste här kallasthirdPartyId
. - 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 får endast ha formatet
paramName
. Parametrar visas i Target somprofile.paramName
. - Om du använder Bulk Profile Update API v2 behöver du inte ange alla parametervärden för varje
pcId
. Profiler skapas för allapcId
ellermbox3rdPartyId
som inte hittas 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 begränsning för hur många attribut du kan överföra. Den totala storleken på externa profildata, som innehåller kundattribut, profil-API, parametrar för in-Mbox-profiler och profilskript, får dock inte överstiga 64 kB.
- 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 klientkoden Target.
Om du inte känner till din klientkod klickar du på Administration > Implementation i användargränssnittet för Target. Klientkoden visas i avsnittet Account Details.
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 meddelande för felet.
Standardbatchstatussvar
Ett lyckat standardsvar när någon klickar på URL-länken ovan batchStatus
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:
Detaljerat svar på batchstatus-URL
Ett mer detaljerat svar kan hämtas genom att en parameter showDetails=true
skickas 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>