Attivazione dell’acquisizione dati tramite API

Adobe Campaign Standard consente di attivare l’assimilazione immediata delle mappature dati tramite API e di recuperare lo stato delle richieste di assimilazione.

Questa pagina descrive come attivare e recuperare lo stato di inserimento delle mappature dati. Per informazioni globali sulle API Campaign Standard, consultare questa sezione.

Prerequisiti

Prima di utilizzare le API, la mappatura dei dati deve essere stata configurata e pubblicata all'interno dell'interfaccia Campaign Standard. Per ulteriori informazioni, consulta le sezioni seguenti:

• Definizione mappature
• Attivazione mappature

Una volta creata la mappatura dei dati, devi impedirne l'esecuzione in modo da poterla attivare dalle API ogni volta che vuoi. Per farlo, esegui questi passaggi:

1. In Campaign Standard, andare al menu Administration > Development > Platform > Status of data export to platform.

2. Fare doppio clic sulla mappatura dati per aprirla, quindi fare clic sul pulsante Stop.

   

3. Salva le modifiche

L'esecuzione del mapping dei dati ora è interrotta. Potete utilizzare le API Campaign Standard per attivarle manualmente.

Avvio dell'assimilazione immediata del mapping dei dati

L'assimilazione immediata di una mappatura XDM in Adobe Experience Platform viene attivata con un'operazione POST:

POST https://mc.adobe.io/<ORGANIZATION>/campaign/dataIngestion/xdmIngestion/<XDM Mapping ID>/ingest

var sqlRoleObj = REST.head.roleBase.sql.get();
REST.head.securityGroup.Administrators.roles.post(sqlRoleObj);

L'operazione POST restituisce informazioni sullo stato della richiesta creata:

• Richiesta inviata correttamente per il mapping XDM:

{
"requestId": <value>,
"info": "Ingestion request submitted successfully for the Mapping ID: <value>",
"status":"Success"
}

• Richiesta già in corso per il mapping XDM:

{
"requestId": <value>,
"info": "Ingestion request already in progress for the Mapping ID: <value>",
"status":"In Progress"
}

• Richiesta non riuscita perché il mapping XDM non è pubblicato o è arrestato:

{
"info": "Unable to submit data ingestion request, XDM Mapping ID: <value> is not stopped",
"status": "Failed"
}
{
"info": "Unable to submit data ingestion request, XDM Mapping ID: <value> is not published",
"status": "Failed"
}

Recupero dello stato di una richiesta di assimilazione

Lo stato di una richiesta di assimilazione può essere recuperato con un’operazione di GET e l’ID richiesta desiderato nei parametri:

GET https://mc.adobe.io/<ORGANIZATION>/campaign/dataIngestion/xdmIngestion/<XDM Mapping ID>/ingest
{"requestId"="<value>"}

L'operazione di GET restituisce le informazioni seguenti:

• batchId: questo campo viene popolato solo se si è verificato un errore dopo la preparazione e il caricamento del batch,
• info: l’ID mappatura XDM,
• numRecords: il numero di record che sono stati acquisiti (solo stato di successo),
• status: stato della richiesta di caricamento (success/fail/progress)

Le possibili risposte all'operazione di GET sono:

• Richiesta di acquisizione riuscita:

  {
  "batchId": "",
  "info": "Mapping Id: <value>. ",
  "numRecords": 15,
  "requestId": 3520,
  "status": "Success"
  }
  

• Richiesta di acquisizione non riuscita con l'acquisizione di 0 record:

  {
  "batchId": "",
  "info": "Mapping Id: <value>. ACP-880056 Failed to fetch the record from the database.",
  "numRecords": 0,
  "requestId": 3520,
  "status": "Failed"
  }
  

• Richiesta di assimilazione non riuscita, con alcuni record caricati in un batch:

  {
  "batchId": "<value>",
  "info": "Mapping Id: <value>. ACP-880096 Sync Job failed to upload. Please check the error in the Platform UI.",
  "numRecords": 0,
  "requestId": <value>,
  "status": "Failed"
  }
  

• Richiesta di acquisizione interrotta dopo l’acquisizione di alcuni record (potrebbe verificarsi in scenari di arresto anomalo):

  {
  "batchId": "",
  "info": "Mapping Id: <value>. Ingestion request aborted due to some issue with data ingestion service. Please submit a new request",
  "numRecords": 0,
  "requestId": <value>,
  "status": "Aborted"
  }
  

• Richiesta di assimilazione in corso (quando la richiesta caricava i dati in un batch o quando il batch viene preparato per la richiesta):

  {
  "batchId": "",
  "info": "Mapping Id: <value>.",
  "numRecords": 0,
  "requestId": <value>,
  "status": "In Progress"
  }