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.

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. Target stöder dock 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 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\

NOTE
Parametern 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 eller thirdPartyId. 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 som mbox3rdPartyId. Den måste här kallas 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 får endast ha formatet paramName. Parametrar visas i Target som profile.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 alla pcId eller mbox3rdPartyId 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 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 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:

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 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>
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3