Activación de la ingesta de datos mediante API

IMPORTANTE

Adobe Experience Platform Data Connectors se encuentra actualmente en fase beta, por lo que puede estar sujeto a actualizaciones frecuentes sin previo aviso. Es necesario que los clientes estén alojados en Azure (actualmente en versión beta solo para Norteamérica) para acceder a estas capacidades. Si desea acceder, póngase en contacto con el Servicio de atención al cliente de Adobe.

Adobe Campaign Standard le permite realizar el déclencheur de la ingesta inmediata de asignaciones de datos mediante API y recuperar el estado de sus solicitudes de ingesta.

En esta página se describe cómo almacenar en déclencheur y recuperar el estado de ingesta de sus asignaciones de datos. Para obtener información global sobre las API de Campaign Standard, consulte esta sección.

Requisitos previos

Antes de utilizar las API, la asignación de datos debe haberse configurado y publicado en la interfaz de Campaign Standard. Para obtener más información, consulte estas secciones:

Una vez creada la asignación de datos, debe evitar que se ejecute para que pueda realizar el déclencheur desde las API cuando lo desee. Para ello, siga estos pasos:

  1. En el Campaign Standard, vaya a la Administration > Development > Platform > Status of data export to platform para abrir el Navegador.

  2. Haga doble clic en la asignación de datos para abrirla y, a continuación, haga clic en el botón Stop botón.

  3. Guarde los cambios

La ejecución de la asignación de datos ahora está detenida. Puede utilizar las API de Campaign Standard para realizar el déclencheur manualmente.

Inicio de la ingesta inmediata de asignación de datos

La ingesta inmediata de una asignación XDM en Adobe Experience Platform se activa con una operación de POST:

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

NOTA

Para ejecutar la llamada a la API del POST de ingesta, el usuario debe tener una Ejecución de funciones SQL , que puede proporcionar un administrador de Campaign Standards ejecutando a continuación el script de JS:

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

La operación POST devuelve información sobre el estado de la solicitud creada:

  • Solicitud enviada correctamente para la asignación XDM:
{
"requestId": <value>,
"info": "Ingestion request submitted successfully for the Mapping ID: <value>",
"status":"Success"
}
  • Solicitud ya en curso para la asignación XDM:
{
"requestId": <value>,
"info": "Ingestion request already in progress for the Mapping ID: <value>",
"status":"In Progress"
}
  • La solicitud ha fallado porque la asignación XDM no se ha publicado o se ha detenido:
{
"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"
}

Recuperación del estado de una solicitud de ingesta

El estado de una solicitud de ingesta se puede recuperar con una operación de GET y el ID de solicitud deseado en los parámetros :

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

La información detallada sobre el estado de la solicitud de asignación XDM y sus trabajos relacionados está disponible en la interfaz de Campaign Standard, en la Status of data export to platform (consulte Activación de la asignación).

La operación de GET devuelve la siguiente información:

  • batchId: este campo solo se rellena si se ha producido un error tras la preparación y carga del lote,
  • información: el ID de asignación XDM,
  • numRecords: el número de registros que se han introducido (solo estado de éxito),
  • status: el estado de la solicitud de ingesta (success/failed/in progress)

Las posibles respuestas a la operación de GET son:

  • Solicitud de ingesta correcta:

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

  • Error en la solicitud de ingesta con el registro 0 introducido:

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

  • Error en la solicitud de ingesta, con algunos registros cargados en un 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"
}

  • La solicitud de ingesta se anuló después de ingerir algunos registros (esto puede ocurrir en situaciones de bloqueo):

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

  • Solicitud de ingesta en curso (cuando la solicitud se ha cargado en un lote o cuando el lote se está preparando para la solicitud):

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

En esta página