Questo documento fornisce una guida completa all’utilizzo di endpoint API per acquisizione batch in Adobe Experience Platform. Per una panoramica delle API di acquisizione batch, inclusi i prerequisiti e le best practice, leggi panoramica dell’API per l’acquisizione batch.
L'appendice del presente documento fornisce informazioni per formattazione dei dati da utilizzare per l’acquisizione, inclusi file di dati CSV e JSON di esempio.
Gli endpoint API utilizzati in questa guida fanno parte del API di acquisizione in batch. L’acquisizione in batch viene fornita tramite un’API RESTful in cui puoi eseguire operazioni CRUD di base sui tipi di oggetto supportati.
Prima di continuare, controlla panoramica dell’API per l’acquisizione batch e guida introduttiva.
I seguenti passaggi sono applicabili ai file di piccole dimensioni (256 MB o meno). Se si riscontra un timeout del gateway o si richiedono errori di dimensioni del corpo, è necessario passare al caricamento di file di grandi dimensioni.
Innanzitutto, devi creare un batch, con JSON come formato di input. Durante la creazione del batch, dovrai fornire un ID set di dati. È inoltre necessario assicurarsi che tutti i file caricati come parte del batch siano conformi allo schema XDM collegato al set di dati fornito.
Gli esempi seguenti sono per JSON a riga singola. Per acquisire JSON su più righe, isMultiLineJson
sarà necessario impostare il flag. Per ulteriori informazioni, leggere guida alla risoluzione dei problemi di acquisizione batch.
Formato API
POST /batches
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"datasetId": "{DATASET_ID}",
"inputFormat": {
"format": "json"
}
}'
Parametro | Descrizione |
---|---|
{DATASET_ID} |
ID del set di dati di riferimento. |
Risposta
{
"id": "{BATCH_ID}",
"imsOrg": "{ORG_ID}",
"updated": 0,
"status": "loading",
"created": 0,
"relatedObjects": [
{
"type": "dataSet",
"id": "{DATASET_ID}"
}
],
"version": "1.0.0",
"tags": {},
"createdUser": "{USER_ID}",
"updatedUser": "{USER_ID}"
}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch appena creato. |
{DATASET_ID} |
ID del set di dati di riferimento. |
Dopo aver creato un batch, puoi utilizzare l’ID batch dalla risposta di creazione del batch per caricare i file nel batch. Puoi caricare più file nel batch.
Vedere la sezione dell'appendice per un esempio di file di dati JSON formattato correttamente.
Formato API
PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch in cui desideri caricare. |
{DATASET_ID} |
ID del set di dati di riferimento del batch. |
{FILE_NAME} |
Nome del file da caricare. Assicurati di utilizzare un nome file univoco in modo che non si scontri con un altro file per il batch di file da inviare. |
Richiesta
L’API supporta il caricamento in una sola parte. Assicurati che il tipo di contenuto sia application/octet-stream.
curl -X PUT https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.json \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/octet-stream' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
--data-binary "@{FILE_PATH_AND_NAME}.json"
Parametro | Descrizione |
---|---|
{FILE_PATH_AND_NAME} |
Percorso e nome completi del file che stai tentando di caricare. Questo è il percorso del file locale, ad esempio acme/customers/campaigns/summer.json . |
Risposta
200 OK
Una volta completato il caricamento di tutte le diverse parti del file, dovrai segnalare che i dati sono stati completamente caricati e che il batch è pronto per la promozione.
Formato API
POST /batches/{BATCH_ID}?action=COMPLETE
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch in cui desideri caricare. |
Richiesta
curl -X POST "https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=COMPLETE" \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
200 OK
I seguenti passaggi sono applicabili ai file di piccole dimensioni (256 MB o meno). Se si riscontra un timeout del gateway o si richiedono errori di dimensioni del corpo, sarà necessario passare al caricamento di file di grandi dimensioni.
In primo luogo, è necessario creare un batch, con Parquet come formato di input. Durante la creazione del batch, dovrai fornire un ID set di dati. È inoltre necessario assicurarsi che tutti i file caricati come parte del batch siano conformi allo schema XDM collegato al set di dati fornito.
Richiesta
curl -X POST "https://platform.adobe.io/data/foundation/import/batches" \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-H "x-gw-ims-org-id: {ORG_ID}" \
-H "x-api-key: {API_KEY}" \
-H "x-sandbox-name: {SANDBOX_NAME}"
-d '{
"datasetId": "{DATASET_ID}",
"inputFormat": {
"format": "parquet"
}
}'
Parametro | Descrizione |
---|---|
{DATASET_ID} |
ID del set di dati di riferimento. |
Risposta
201 Created
{
"id": "{BATCH_ID}",
"imsOrg": "{ORG_ID}",
"updated": 0,
"status": "loading",
"created": 0,
"relatedObjects": [
{
"type": "dataSet",
"id": "{DATASET_ID}"
}
],
"version": "1.0.0",
"tags": {},
"createdUser": "{USER_ID}",
"updatedUser": "{USER_ID}"
}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch appena creato. |
{DATASET_ID} |
ID del set di dati di riferimento. |
{USER_ID} |
ID dell’utente che ha creato il batch. |
Dopo aver creato un batch, puoi utilizzare batchId
da prima di per caricare i file nel batch. Puoi caricare più file nel batch.
Formato API
PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch in cui desideri caricare. |
{DATASET_ID} |
ID del set di dati di riferimento del batch. |
{FILE_NAME} |
Nome del file da caricare. Assicurati di utilizzare un nome file univoco in modo che non si scontri con un altro file per il batch di file da inviare. |
Richiesta
Questa API supporta il caricamento in una sola parte. Assicurati che il tipo di contenuto sia application/octet-stream.
curl -X PUT https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.parquet \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/octet-stream' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
--data-binary "@{FILE_PATH_AND_NAME}.parquet"
Parametro | Descrizione |
---|---|
{FILE_PATH_AND_NAME} |
Percorso e nome completi del file che stai tentando di caricare. Questo è il percorso del file locale, ad esempio acme/customers/campaigns/summer.parquet . |
Risposta
200 OK
Una volta completato il caricamento di tutte le diverse parti del file, dovrai segnalare che i dati sono stati completamente caricati e che il batch è pronto per la promozione.
Formato API
POST /batches/{BATCH_ID}?action=complete
Parametro | Descrizione |
---|---|
{BATCH_ID} |
L’ID del batch che desideri segnalare è pronto per il completamento. |
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=COMPLETE \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
200 OK
Questa sezione descrive come caricare file di dimensioni superiori a 256 MB. I file di grandi dimensioni vengono caricati in blocchi e quindi uniti tramite un segnale API.
In primo luogo, è necessario creare un batch, con Parquet come formato di input. Durante la creazione del batch, dovrai fornire un ID set di dati. È inoltre necessario assicurarsi che tutti i file caricati come parte del batch siano conformi allo schema XDM collegato al set di dati fornito.
Formato API
POST /batches
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
-d '{
"datasetId": "{DATASET_ID}",
"inputFormat": {
"format": "parquet"
}
}'
Parametro | Descrizione |
---|---|
{DATASET_ID} |
ID del set di dati di riferimento. |
Risposta
201 Created
{
"id": "{BATCH_ID}",
"imsOrg": "{ORG_ID}",
"updated": 0,
"status": "loading",
"created": 0,
"relatedObjects": [
{
"type": "dataSet",
"id": "{DATASET_ID}"
}
],
"version": "1.0.0",
"tags": {},
"createdUser": "{USER_ID}",
"updatedUser": "{USER_ID}"
}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch appena creato. |
{DATASET_ID} |
ID del set di dati di riferimento. |
{USER_ID} |
ID dell’utente che ha creato il batch. |
Dopo aver creato il batch, sarà necessario inizializzare il file di grandi dimensioni prima di caricare i blocchi nel batch.
Formato API
POST /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch appena creato. |
{DATASET_ID} |
ID del set di dati di riferimento. |
{FILE_NAME} |
Nome del file che sta per essere inizializzato. |
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.parquet?action=INITIALIZE \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
201 Created
Una volta creato il file, è possibile caricarne tutti i blocchi successivi effettuando ripetute richieste PATCH, una per ogni sezione del file.
Formato API
PATCH /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch in cui desideri caricare. |
{DATASET_ID} |
ID del set di dati di riferimento del batch. |
{FILE_NAME} |
Nome del file da caricare. Assicurati di utilizzare un nome file univoco in modo che non si scontri con un altro file per il batch di file da inviare. |
Richiesta
Questa API supporta il caricamento in una sola parte. Assicurati che il tipo di contenuto sia application/octet-stream.
curl -X PATCH https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.parquet \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/octet-stream' \
-H 'Content-Range: bytes {CONTENT_RANGE}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
--data-binary "@{FILE_PATH_AND_NAME}.parquet"
Parametro | Descrizione |
---|---|
{CONTENT_RANGE} |
In numeri interi, l’inizio e la fine dell’intervallo richiesto. |
{FILE_PATH_AND_NAME} |
Percorso e nome completi del file che stai tentando di caricare. Questo è il percorso del file locale, ad esempio acme/customers/campaigns/summer.json . |
Risposta
200 OK
Dopo aver creato un batch, puoi utilizzare batchId
da prima di per caricare i file nel batch. Puoi caricare più file nel batch.
Formato API
POST /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch di cui desideri segnalare il completamento. |
{DATASET_ID} |
ID del set di dati di riferimento del batch. |
{FILE_NAME} |
Nome del file di cui si desidera segnalare il completamento. |
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.parquet?action=COMPLETE \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
201 Created
Una volta completato il caricamento di tutte le diverse parti del file, dovrai segnalare che i dati sono stati completamente caricati e che il batch è pronto per la promozione.
Formato API
POST /batches/{BATCH_ID}?action=COMPLETE
Parametro | Descrizione |
---|---|
{BATCH_ID} |
L’ID del batch che desideri segnalare è completo. |
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=COMPLETE \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
200 OK
Per acquisire i file CSV, devi creare una classe, uno schema e un set di dati che supporti CSV. Per informazioni dettagliate su come creare la classe e lo schema necessari, segui le istruzioni fornite nella tutorial sulla creazione di schemi ad hoc.
I seguenti passaggi sono applicabili ai file di piccole dimensioni (256 MB o meno). Se si riscontra un timeout del gateway o si richiedono errori di dimensioni del corpo, sarà necessario passare al caricamento di file di grandi dimensioni.
Dopo aver seguito le istruzioni precedenti per creare la classe e lo schema necessari, dovrai creare un set di dati che possa supportare CSV.
Formato API
POST /catalog/dataSets
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/catalog/dataSets \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
-d '{
"name": "{DATASET_NAME}",
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed+json;version=1"
}
}'
Parametro | Descrizione |
---|---|
{TENANT_ID} |
Questo ID viene utilizzato per garantire che le risorse create abbiano uno spazio dei nomi corretto e siano contenute all’interno dell’organizzazione. |
{SCHEMA_ID} |
ID dello schema creato. |
Successivamente, dovrai creare un batch con CSV come formato di input. Durante la creazione del batch, dovrai fornire un ID set di dati. È inoltre necessario assicurarsi che tutti i file caricati come parte del batch siano conformi allo schema collegato al set di dati fornito.
Formato API
POST /batches
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
-d '{
"datasetId": "{DATASET_ID}",
"inputFormat": {
"format": "csv"
}
}'
Parametro | Descrizione |
---|---|
{DATASET_ID} |
ID del set di dati di riferimento. |
Risposta
201 Created
{
"id": "{BATCH_ID}",
"imsOrg": "{ORG_ID}",
"updated": 0,
"status": "loading",
"created": 0,
"relatedObjects": [
{
"type": "dataSet",
"id": "{DATASET_ID}"
}
],
"version": "1.0.0",
"tags": {},
"createdUser": "{USER_ID}",
"updatedUser": "{USER_ID}"
}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch appena creato. |
{DATASET_ID} |
ID del set di dati di riferimento. |
{USER_ID} |
ID dell’utente che ha creato il batch. |
Dopo aver creato un batch, puoi utilizzare batchId
da prima di per caricare i file nel batch. Puoi caricare più file nel batch.
Vedere la sezione dell'appendice per un esempio di file di dati CSV formattato correttamente.
Formato API
PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch in cui desideri caricare. |
{DATASET_ID} |
ID del set di dati di riferimento del batch. |
{FILE_NAME} |
Nome del file da caricare. Assicurati di utilizzare un nome file univoco in modo che non si scontri con un altro file per il batch di file da inviare. |
Richiesta
Questa API supporta il caricamento in una sola parte. Assicurati che il tipo di contenuto sia application/octet-stream.
curl -X PUT https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.csv \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/octet-stream' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
--data-binary "@{FILE_PATH_AND_NAME}.csv"
Parametro | Descrizione |
---|---|
{FILE_PATH_AND_NAME} |
Percorso e nome completi del file che stai tentando di caricare. Questo è il percorso del file locale, ad esempio acme/customers/campaigns/summer.csv . |
Risposta
200 OK
Una volta completato il caricamento di tutte le diverse parti del file, dovrai segnalare che i dati sono stati completamente caricati e che il batch è pronto per la promozione.
Formato API
POST /batches/{BATCH_ID}?action=COMPLETE
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=COMPLETE \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
200 OK
Durante l’elaborazione, il batch può comunque essere annullato. Tuttavia, una volta finalizzato un batch (ad esempio in caso di esito positivo o negativo), il batch non può essere annullato.
Formato API
POST /batches/{BATCH_ID}?action=ABORT
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch da annullare. |
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=ABORT \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
200 OK
È possibile eliminare un batch eseguendo la seguente richiesta POST con action=REVERT
parametro di query per l’ID del batch da eliminare. Il batch è contrassegnato come "inattivo", rendendolo idoneo per la raccolta di oggetti inattivi. Il batch verrà raccolto in modo asincrono e contrassegnato come "eliminato".
Formato API
POST /batches/{BATCH_ID}?action=REVERT
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch da eliminare. |
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=REVERT \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
200 OK
A volte può essere necessario aggiornare i dati nell’archivio profili della tua organizzazione. Ad esempio, potrebbe essere necessario correggere i record o modificare un valore di attributo. Adobe Experience Platform supporta l’aggiornamento o la patch dei dati dell’archivio profili tramite un’azione upsert o "l’applicazione di patch a un batch".
Questi aggiornamenti sono consentiti solo sui record di profilo, non sugli eventi di esperienza.
Per applicare la patch a un batch è necessario quanto segue:
isUpsert:true
aggiunta al tag unifiedProfile
array. Per i passaggi dettagliati che mostrano come creare un set di dati o configurare un set di dati esistente per l’upsert, segui l’esercitazione per abilitazione di un set di dati per gli aggiornamenti del profilo.Dopo aver abilitato un set di dati per Profilo e upsert e un file Parquet contenente i campi a cui desideri applicare la patch e i campi di identità necessari, puoi seguire i passaggi per acquisizione dei file Parquet al fine di completare la patch tramite l’acquisizione in batch.
Se desideri sostituire un batch già acquisito, puoi farlo con "ripetizione batch": questa azione equivale all’eliminazione del batch precedente e all’acquisizione di un nuovo batch.
Innanzitutto, devi creare un batch, con JSON come formato di input. Durante la creazione del batch, dovrai fornire un ID set di dati. È inoltre necessario assicurarsi che tutti i file caricati come parte del batch siano conformi allo schema XDM collegato al set di dati fornito. Inoltre, devi fornire i vecchi batch come riferimento nella sezione di ripetizione. Nell’esempio seguente, stai riproducendo i batch con ID batchIdA
e batchIdB
.
Formato API
POST /batches
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
-d '{
"datasetId": "{DATASET_ID}",
"inputFormat": {
"format": "json"
},
"replay": {
"predecessors": ["${batchIdA}","${batchIdB}"],
"reason": "replace"
}
}'
Parametro | Descrizione |
---|---|
{DATASET_ID} |
ID del set di dati di riferimento. |
Risposta
201 Created
{
"id": "{BATCH_ID}",
"imsOrg": "{ORG_ID}",
"updated": 0,
"status": "loading",
"created": 0,
"relatedObjects": [
{
"type": "dataSet",
"id": "{DATASET_ID}"
}
],
"replay": {
"predecessors": [
"batchIdA", "batchIdB"
],
"reason": "replace"
},
"version": "1.0.0",
"tags": {},
"createdUser": "{USER_ID}",
"updatedUser": "{USER_ID}"
}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch appena creato. |
{DATASET_ID} |
ID del set di dati di riferimento. |
{USER_ID} |
ID dell’utente che ha creato il batch. |
Dopo aver creato un batch, puoi utilizzare batchId
da prima di per caricare i file nel batch. Puoi caricare più file nel batch.
Formato API
PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch in cui desideri caricare. |
{DATASET_ID} |
ID del set di dati di riferimento del batch. |
{FILE_NAME} |
Nome del file da caricare. Assicurati di utilizzare un nome file univoco in modo che non si scontri con un altro file per il batch di file da inviare. |
Richiesta
Questa API supporta il caricamento in una sola parte. Assicurati che il tipo di contenuto sia application/octet-stream. Non utilizzare l’opzione curl -F, poiché per impostazione predefinita le richieste in più parti sono incompatibili con l’API.
curl -X PUT https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.json \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/octet-stream' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
--data-binary "@{FILE_PATH_AND_NAME}.json"
Parametro | Descrizione |
---|---|
{FILE_PATH_AND_NAME} |
Percorso e nome completi del file che stai tentando di caricare. Questo è il percorso del file locale, ad esempio acme/customers/campaigns/summer.json . |
Risposta
200 OK
Una volta completato il caricamento di tutte le diverse parti del file, dovrai segnalare che i dati sono stati completamente caricati e che il batch è pronto per la promozione.
Formato API
POST /batches/{BATCH_ID}?action=COMPLETE
Parametro | Descrizione |
---|---|
{BATCH_ID} |
ID del batch da completare. |
Richiesta
curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=COMPLETE \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
200 OK
La sezione seguente contiene informazioni aggiuntive per l’acquisizione di dati in Experience Platform tramite l’acquisizione batch.
Per acquisire un file di dati in Experience Platform, la struttura gerarchica del file deve essere conforme alla Experience Data Model (XDM) schema associato al set di dati in fase di caricamento in.
Le informazioni su come mappare un file CSV in modo che sia conforme a uno schema XDM sono disponibili nella sezione trasformazioni campione insieme a un esempio di un file di dati JSON formattato correttamente. I file di esempio forniti nel documento sono disponibili qui: