Acionando a assimilação de dados por meio de APIs

O Adobe Campaign Standard permite acionar a assimilação imediata de mapeamentos de dados por meio de APIs e recuperar o status das solicitações de assimilação.

Esta página descreve como acionar e recuperar o status de assimilação de seus mapeamentos de dados. Para obter informações globais sobre APIs do Campaign Standard, consulte esta seção.

Pré-requisitos

Antes de usar as APIs, o mapeamento de dados deve ter sido configurado e publicado primeiro na interface do Campaign Standard. Para obter mais informações, consulte estas seções:

• Definição de mapeamento
• Ativação de mapeamento

Depois que o mapeamento de dados for criado, é necessário impedi-lo de ser executado para que possa acioná-lo a partir das APIs sempre que desejar. Para fazer isso, siga estes passos:

1. No Campaign Standard, vá para o menu Administration > Development > Platform > Status of data export to platform.

2. Clique duas vezes no mapeamento de dados para abri-lo, depois clique no botão Stop.

   

3. Salve as alterações

A execução do mapeamento de dados agora está interrompida. Você pode usar as APIs do Campaign Standard para acioná-las manualmente.

Iniciando a assimilação imediata de mapeamento de dados

A assimilação imediata de um mapeamento XDM no Adobe Experience Platform é acionada com uma operação de 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);

A operação POST retorna informações sobre o status da solicitação criada:

• Solicitação enviada com êxito para o Mapeamento XDM:

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

• Solicitação já em andamento para o Mapeamento XDM:

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

• A solicitação falhou porque o mapeamento XDM não foi publicado ou está parado:

{
"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"
}

Recuperar o status de uma solicitação de assimilação

O status de uma solicitação de assimilação pode ser recuperado com uma operação GET e a ID de solicitação desejada nos parâmetros:

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

A operação GET retorna as informações abaixo:

• batchId: este campo é preenchido somente se ocorrer uma falha após a preparação e o upload do lote,
• informações: a ID de mapeamento XDM,
• numRecords: o número de registros que foram assimilados (somente status de sucesso),
• status: o status da solicitação de assimilação (sucesso/falha/em andamento)

As possíveis respostas para a operação do GET são:

• Solicitação de assimilação bem-sucedida:

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

• Falha na solicitação de assimilação com registro 0 assimilado:

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

• Falha na solicitação de assimilação, com alguns registros carregados em um lote:

  {
  "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"
  }
  

• Solicitação de assimilação abortada após a assimilação de alguns registros (isso pode ocorrer em cenários de falha):

  {
  "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"
  }
  

• Solicitação de assimilação em andamento (quando a solicitação carregou os dados em um lote ou quando o lote está sendo preparado para a solicitação):

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