Crear un flujo de datos para orígenes de comercio electrónico mediante la API Flow Service
Este tutorial trata los pasos para recuperar datos de una fuente de comercio electrónico y llevarlos a Experience Platform mediante Flow Service API.
NOTA- Para crear un flujo de datos, ya debe tener un ID de conexión base válido con un origen de comercio electrónico. Si no tiene este identificador, vea la descripción general de orígenes para obtener una lista de orígenes de comercio electrónico con los que puede crear una conexión base.
- Para que Experience Platform pueda introducir datos, las zonas horarias de todos los orígenes de lotes basados en tablas deben configurarse en UTC.
Introducción
Este tutorial requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:
-
Experience Data Model (XDM) System: el marco estandarizado mediante el cual Experience Platform organiza los datos de experiencia del cliente.
- Aspectos básicos de la composición de esquemas: obtenga información sobre los componentes básicos de los esquemas XDM, incluidos los principios clave y las prácticas recomendadas en la composición de esquemas.
- API de Registro de esquemas: Aprenda a realizar llamadas correctamente a la API de Registro de esquemas. Esto incluye su
{TENANT_ID}, el concepto de "contenedores" y los encabezados necesarios para realizar solicitudes (con especial atención al encabezado Aceptar y sus posibles valores).
-
Catalog Service: el catálogo es el sistema de registro para la ubicación y el linaje de datos dentro de Experience Platform.
-
Batch ingestion: la API de ingesta por lotes le permite ingerir datos en Experience Platform como archivos por lotes.
-
Sandboxes: Experience Platform proporciona zonas protegidas virtuales que dividen una sola instancia de Experience Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.
Uso de API de Experience Platform
Para obtener información sobre cómo realizar llamadas correctamente a las API de Experience Platform, consulte la guía sobre introducción a las API de Experience Platform.
Crear una conexión de origen
Puede crear una conexión de origen realizando una petición POST a la API Flow Service. Una conexión de origen consta de un identificador de conexión, una ruta de acceso al archivo de datos de origen y un identificador de especificación de conexión.
Para crear una conexión de origen, también debe definir un valor de enumeración para el atributo de formato de datos.
Utilice los siguientes valores de enumeración para los conectores basados en archivos:
| Formato de datos | Valor de enumeración |
|---|---|
| Delimitado | delimited |
| JSON | json |
| Parquet | parquet |
Para todos los conectores basados en tablas, establezca el valor en tabular.
Formato de API
POST /sourceConnections
Solicitud
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/sourceConnections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Shopify source connection",
"baseConnectionId": "582f4f8d-71e9-4a5c-a164-9d2056318d6c",
"description": "Shopify source connection",
"data": {
"format": "tabular"
},
"params": {
"tableName": "Shopify.Orders",
"columns": [
{
"name": "Email",
"type": "string"
},
{
"name": "Phone",
"type": "string"
},
]
},
"connectionSpec": {
"id": "4f63aa36-bd48-4e33-bb83-49fbcd11c708",
"version": "1.0"
}
}'
| Propiedad | Descripción |
|---|---|
baseConnectionId | El ID de conexión del origen de comercio electrónico. |
params.path | Ruta del archivo de origen. |
connectionSpec.id | Id. de especificación de conexión del origen de comercio electrónico. |
Respuesta
Una respuesta correcta devuelve el identificador único (id) de la conexión de origen recién creada. Este ID es necesario en pasos posteriores para crear una conexión de destino.
{
"id": "c278ab14-acdf-440b-b67f-1265d15a7655",
"etag": "\"10007c3f-0000-0200-0000-5fa9be720000\""
}