Attivazione dell’acquisizione dati tramite API

IMPORTANTE

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, 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:

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

NOTA

Per eseguire la chiamata API POST ingerest, l'utente deve disporre di un ruolo Esecuzione 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>"}
NOTA

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

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free