Show Menu
ARGOMENTI×

Attivazione dell’acquisizione dati tramite API

Adobe Experience Platform Data Connector è attualmente in fase beta, che potrebbe essere soggetto a frequenti aggiornamenti senza preavviso. I clienti devono essere ospitati in Azure (attualmente nella versione beta solo per il Nord America) per accedere a tali funzionalità. Per accedere, contatta Assistenza clienti di Adobe.
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, consultate 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:
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, selezionate il Administration > Development > Platform > Status of data export to platform menu.
  2. Fare doppio clic sulla mappatura dati per aprirla, quindi fare clic sul Stop pulsante.
  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 della mappatura 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
Per eseguire la chiamata API POST ingerest, l'utente deve avere un ruolo di esecuzione della funzione SQL, che può essere fornito da un amministratore Campaign Standard mediante l'esecuzione sotto lo script JS:
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>"}

Informazioni dettagliate sullo stato della richiesta di mappatura XDM e i processi correlati sono disponibili nell'interfaccia Campaign Standard, nel Status of data export to platform menu (consultate Attivazione della mappatura).
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 assimilazione completata:
    {
    "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 acquisizione 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"
    }