Partiellt batchintag

Partiell batchförbrukning är möjligheten att importera data som innehåller fel, upp till en viss tröskel. Med den här funktionen kan användare importera alla korrekta data till Adobe Experience Platform samtidigt som alla felaktiga data grupperas separat, tillsammans med information om varför de är ogiltiga.

Det här dokumentet innehåller en självstudiekurs för hantering av partiell batchimport.

Komma igång

Den här självstudiekursen kräver en fungerande kunskap om de olika Adobe Experience Platform-tjänster som är involverade i partiell batchförbrukning. Innan du börjar med den här självstudiekursen bör du läsa dokumentationen för följande tjänster:

I följande avsnitt finns ytterligare information som du behöver känna till för att kunna ringa Platform API:er.

Läser exempel-API-anrop

Den här guiden innehåller exempel på API-anrop som visar hur du formaterar dina begäranden. Det kan vara sökvägar, obligatoriska rubriker och korrekt formaterade begärandenyttolaster. Ett exempel på JSON som returneras i API-svar finns också. Information om konventionerna som används i dokumentationen för exempel-API-anrop finns i avsnittet om läsa exempel-API-anrop i Experience Platform felsökningsguide.

Samla in värden för obligatoriska rubriker

För att ringa Platform API:er måste du först slutföra självstudiekurs om autentisering. När du är klar med självstudiekursen för autentisering visas värdena för var och en av de obligatoriska rubrikerna i alla Experience Platform API-anrop enligt nedan:

  • Behörighet: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Alla resurser i Experience Platform isoleras till specifika virtuella sandlådor. Alla förfrågningar till Platform API:er kräver en rubrik som anger namnet på sandlådan som åtgärden ska utföras i:

  • x-sandbox-name: {SANDBOX_NAME}
NOTE
Mer information om sandlådor i Platform, se översiktsdokumentation för sandlåda.

Aktivera en batch för partiell batchimport i API enable-api

NOTE
I det här avsnittet beskrivs hur du aktiverar en batch för partiell batchimport med API:t. Instruktioner om hur du använder användargränssnittet finns i aktivera en batch för partiell batchförbrukning i användargränssnittet steg.

Du kan skapa en ny grupp med partiellt intag aktiverat.

Så här skapar du en ny grupp: Utvecklarhandbok för batchintag. När du har nått Create batch lägger du till följande fält i begärandetexten:

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}
Egenskap
Beskrivning
enableErrorDiagnostics
En flagga som tillåter Platform för att generera detaljerade felmeddelanden om din grupp.
partialIngestionPercent
Procentandelen godtagbara fel innan hela gruppen misslyckas. I det här exemplet kan alltså maximalt 5 % av batchen vara fel, innan den misslyckas.

Aktivera en batch för partiell batchförbrukning i användargränssnittet enable-ui

NOTE
I det här avsnittet beskrivs hur du aktiverar en batch för partiell batchförbrukning med användargränssnittet. Om du redan har aktiverat en batch för partiell gruppinmatning med API:t kan du hoppa fram till nästa avsnitt.

Aktivera en batch för partiellt intag via Platform I användargränssnittet kan du skapa en ny grupp via källanslutningar, skapa en ny grupp i en befintlig datauppsättning eller skapa en ny grupp viaMap CSV to XDM flow".

Skapa en ny källanslutning new-source

Om du vill skapa en ny källanslutning följer du stegen i listan i dialogrutan Översikt över källor. När du har nått Dataflow detail notera Partial ingestion och Error diagnostics fält.

The Partial ingestion kan du aktivera eller inaktivera användning av partiell gruppinmatning.

The Error diagnostics växlingsknappen visas endast när Partial ingestion växlingen är inaktiverad. Den här funktionen tillåter Platform för att generera detaljerade felmeddelanden om dina inkapslade batchar. Om Partial ingestion växeln är aktiverad, förbättrad feldiagnostik används automatiskt.

The Error threshold gör att du kan ange procentandelen godtagbara fel innan hela gruppen misslyckas. Som standard är värdet 5 %.

Använd en befintlig datauppsättning existing-dataset

Om du vill använda en befintlig datauppsättning börjar du med att välja en datauppsättning. Sidlisten till höger innehåller information om datauppsättningen.

The Partial ingestion kan du aktivera eller inaktivera användning av partiell gruppinmatning.

The Error diagnostics växlingsknappen visas endast när Partial ingestion växlingen är inaktiverad. Den här funktionen tillåter Platform för att generera detaljerade felmeddelanden om dina inkapslade batchar. Om Partial ingestion växeln är aktiverad, förbättrad feldiagnostik används automatiskt.

The Error threshold gör att du kan ange procentandelen godtagbara fel innan hela gruppen misslyckas. Som standard är värdet 5 %.

Nu kan du överföra data med Lägg till data och kommer att förtäras med partiellt intag.

Använd "Map CSV to XDM schema" flöde map-flow

Så här använder duMap CSV to XDM schema", följ stegen i listan i Mappa en CSV-fil, genomgång. När du har nått Add data notera Partial ingestion och Error diagnostics fält.

The Partial ingestion kan du aktivera eller inaktivera användning av partiell gruppinmatning.

The Error diagnostics växlingsknappen visas endast när Partial ingestion växlingen är inaktiverad. Den här funktionen tillåter Platform för att generera detaljerade felmeddelanden om dina inkapslade batchar. Om Partial ingestion växeln är aktiverad, förbättrad feldiagnostik används automatiskt.

Error threshold gör att du kan ange procentandelen godtagbara fel innan hela gruppen misslyckas. Som standard är värdet 5 %.

Nästa steg next-steps

I den här självstudiekursen beskrivs hur du skapar eller ändrar en datauppsättning för att aktivera partiell gruppinmatning. Mer information om batchintag finns i Utvecklarhandbok för batchintag.

Mer information om övervakning av partiella intag finns i diagnostikguide för batchmatningsfel.

recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a