DocumentaciónExperience PlatformGuía de conectores de origen

Enviar el origen

Last update: Mon Mar 13 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Desarrollador

El paso final para integrar su nueva fuente en Adobe Experience Platform mediante fuentes de autoservicio (SDK por lotes) es probar la fuente para la verificación. Una vez que lo haya conseguido, puede enviar su nueva fuente poniéndose en contacto con su representante de Adobe.

En el siguiente documento se proporcionan los pasos necesarios para probar y depurar el código fuente utilizando Flow Service API.

Primeros pasos

Prueba del origen

Para probar el origen, debe ejecutar el Recopilación y entorno de verificación de fuentes de autoservicio el Postman al tiempo que proporciona las variables de entorno adecuadas que pertenecen a su origen.

Para iniciar la prueba, primero debe configurar la colección y el entorno en Postman. A continuación, especifique el Id. de especificación de conexión que desea probar.

Especifique authSpecName

Una vez que haya introducido el ID de especificación de conexión, debe especificar el authSpecName que está utilizando para su conexión base. Según su elección, podría ser OAuth 2 Refresh Code o Basic Authentication. Una vez que haya especificado su authSpecName, debe incluir sus credenciales necesarias en el entorno. Por ejemplo, si especifica authSpecName as OAuth 2 Refresh Code, debe proporcionar las credenciales necesarias para OAuth 2, que son host y accessToken.

Especifique sourceSpec

Con los parámetros de especificación de autenticación añadidos, a continuación debe añadir las propiedades necesarias desde la especificación de origen. Puede encontrar las propiedades requeridas en sourceSpec.spec.properties. En el caso de MailChimp Members ejemplo siguiente, la única propiedad requerida es listId, lo que significa listId y su valor de ID correspondiente a su Postman entorno.

"spec": {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "description": "Define user input parameters to fetch resource values.",
  "properties": {
    "listId": {
      "type": "string",
      "description": "listId for which members need to fetch."
    }
  }
}

Una vez proporcionados los parámetros de autenticación y especificación de fuente, puede empezar a rellenar el resto de las variables de entorno; consulte la tabla siguiente para obtener una referencia:

NOTE
Todas las variables de ejemplo siguientes son valores de marcador de posición que debe actualizar, excepto para flowSpecificationId y targetConnectionSpecId, que son valores fijos.
Parámetro
Descripción
Ejemplo
x-api-key
Identificador único utilizado para autenticar llamadas a las API de Experience Platform. Consulte el tutorial sobre autenticación y acceso a las API de Experience Platform para obtener información sobre cómo recuperar su x-api-key.
c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
Una entidad corporativa que puede poseer o licenciar productos y servicios y permitir el acceso a sus miembros. Consulte el tutorial sobre configuración de la consola para desarrolladores y Postman para obtener instrucciones sobre cómo recuperar su x-gw-ims-org-id información.
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
El token de autorización necesario para completar las llamadas a las API de Experience Platform. Consulte el tutorial sobre autenticación y acceso a las API de Experience Platform para obtener información sobre cómo recuperar su authorizationToken.
Bearer authorizationToken
schemaId
Para que los datos de origen se utilicen en Platform, se debe crear un esquema de destino para estructurar los datos de origen según sus necesidades. Para ver los pasos detallados sobre cómo crear un esquema XDM de destino, consulte el tutorial sobre creación de un esquema con la API.
https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
schemaVersion
La versión única que se corresponde con el esquema.
application/vnd.adobe.xed-full-notext+json; version=1
schemaAltId
El meta:altId que se devuelve junto con el schemaId al crear un nuevo esquema.
_{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
dataSetId
Para ver los pasos detallados sobre cómo crear un conjunto de datos de destinatario, consulte el tutorial sobre creación de un conjunto de datos mediante la API.
5f3c3cedb2805c194ff0b69a
mappings
Los conjuntos de asignaciones se pueden utilizar para definir cómo se asignan los datos de un esquema de origen al de un esquema de destino. Para ver los pasos detallados sobre cómo crear una asignación, consulte el tutorial sobre creación de un conjunto de asignaciones mediante la API.
[{"destinationXdmPath":"person.name.firstName","sourceAttribute":"email.email_id","identity":false,"version":0},{"destinationXdmPath":"person.name.lastName","sourceAttribute":"email.activity.action","identity":false,"version":0}]
mappingId
ID único que corresponde al conjunto de asignaciones.
bf5286a9c1ad4266baca76ba3adc9366
connectionSpecId
El ID de especificación de conexión que corresponde con su origen. Este es el ID que generó después de creación de una nueva especificación de conexión.
2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId
El ID de especificación de flujo de RestStorageToAEP. Este es un valor fijo.
6499120c-0b15-42dc-936e-847ea3c24d72
targetConnectionSpecId
El ID de conexión de destino del lago de datos donde aterrizan los datos ingeridos. Este es un valor fijo.
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
Intervalo de tiempo designado que se debe seguir al comprobar la finalización de una ejecución de flujo.
40
startTime
La hora de inicio designada para el flujo de datos. La hora de inicio debe tener el formato unix time.
1597784298

Una vez que haya proporcionado todas las variables de entorno, puede comenzar a ejecutar la colección usando Postman interfaz. En el Postman interfaz, seleccione los puntos suspensivos (…) al lado Sources SSSs Verification Collection y luego seleccione Ejecutar colección.

corredor

El Runner , lo que le permite configurar el orden de ejecución del flujo de datos. Seleccionar Ejecutar colección de verificación de SMS para ejecutar la colección.

NOTE
Puede deshabilitar Eliminar flujo en la lista de comprobación del orden de ejecución si prefiere utilizar el panel de monitorización de fuentes en la interfaz de usuario de Platform. Sin embargo, una vez que haya terminado con la prueba, debe asegurarse de que los flujos de prueba se eliminen.

run-collection

Enviar el origen

Una vez que el origen pueda completar todo el flujo de trabajo, puede ponerse en contacto con el representante del Adobe y enviar el origen para que se integre.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089