Punto de conexión de API: platform.adobe.io/data/core/activation/authoring/destinations
En esta página se enumeran y describen todas las operaciones de API que puede realizar mediante la /authoring/destinations
extremo de API. Para obtener una descripción de la funcionalidad admitida por este extremo, lea configuración de destino.
Antes de continuar, revise la guía de introducción para obtener información importante que debe conocer para realizar llamadas correctamente a la API de , incluido cómo obtener el permiso de creación de destino requerido y los encabezados necesarios.
Puede crear una nueva configuración de destino realizando una solicitud de POST al /authoring/destinations
punto final.
Formato de API
POST /authoring/destinations
Solicitud
La siguiente solicitud crea una nueva configuración de destino de flujo continuo, configurada por los parámetros proporcionados en la carga útil. La carga útil siguiente incluye todos los parámetros para los destinos de flujo continuo aceptados por el /authoring/destinations
punto final. Tenga en cuenta que no es necesario agregar todos los parámetros en la llamada de y que la plantilla se puede personalizar, según los requisitos de la API.
curl -X POST https://platform.adobe.io/data/core/activation/authoring/destinations \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"name":"Moviestar",
"description":"Moviestar is a fictional destination, used for this example.",
"status":"TEST",
"customerAuthenticationConfigurations":[
{
"authType":"BEARER"
}
],
"customerDataFields":[
{
"name":"endpointsInstance",
"type":"string",
"title":"Select Endpoint",
"description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
"isRequired":true,
"enum":[
"US",
"EU",
"APAC",
"NZ"
]
},
{
"name":"customerID",
"type":"string",
"title":"Moviestar Customer ID",
"description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
"isRequired":true,
"pattern":"^[A-Za-z]+$"
}
],
"uiAttributes":{
"documentationLink":"https://www.adobe.com/go/destinations-moviestar-en",
"category":"mobile",
"connectionType":"Server-to-server",
"frequency":"Streaming"
},
"identityNamespaces":{
"external_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"Email":{
}
}
},
"another_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true
}
},
"segmentMappingConfig":{
"mapExperiencePlatformSegmentName":false,
"mapExperiencePlatformSegmentId":false,
"mapUserInput":false,
"audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
},
"schemaConfig":{
"profileFields":[
{
"name":"a_custom_attribute",
"title":"a_custom_attribute",
"description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the phoneNumber value in Experience Platform could be phoneNo on your side.",
"type":"string",
"isRequired":false,
"readOnly":false,
"hidden":false
}
],
"profileRequired":true,
"segmentRequired":true,
"identityRequired":true
},
"aggregation":{
"aggregationType":"BEST_EFFORT",
"bestEffortAggregation":{
"maxUsersPerRequest":10,
"splitUserById":false
}
},
"destinationDelivery":[
{
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
}
],
"backfillHistoricalProfileData":true
}
Parámetro | Tipo | Descripción |
---|---|---|
name |
Cadena | Indica el título del destino en el catálogo de Experience Platform |
description |
Cadena | Proporcione una descripción que el Adobe utilizará en el catálogo de destinos del Experience Platform para su tarjeta de destino. Apunte a no más de 4-5 frases. |
status |
Cadena | Indica el estado del ciclo vital de la tarjeta de destino. Los valores aceptados son TEST , PUBLISHED y DELETED . Uso TEST la primera vez que configure el destino. |
customerAuthenticationConfigurations |
Cadena | Indica la configuración utilizada para autenticar a los clientes Experience Platform en el servidor. Consulte authType abajo para los valores aceptados. |
customerAuthenticationConfigurations.authType |
Cadena | Los valores admitidos para los destinos de flujo continuo son:
|
customerDataFields.name |
Cadena | Proporcione un nombre para el campo personalizado que está introduciendo. |
customerDataFields.type |
Cadena | Indica qué tipo de campo personalizado está introduciendo. Los valores aceptados son string , object , integer |
customerDataFields.title |
Cadena | Indica el nombre del campo, tal como lo ven los clientes en la interfaz de usuario del Experience Platform |
customerDataFields.description |
Cadena | Proporcione una descripción para el campo personalizado. |
customerDataFields.isRequired |
Booleano | Indica si este campo es necesario en el flujo de trabajo de configuración de destino. |
customerDataFields.enum |
Cadena | Representa el campo personalizado como un menú desplegable y enumera las opciones disponibles para el usuario. |
customerDataFields.pattern |
Cadena | Aplica un patrón para el campo personalizado, si es necesario. Utilice expresiones regulares para aplicar un patrón. Por ejemplo, si los ID de cliente no incluyen números o guiones bajos, introduzca ^[A-Za-z]+$ en este campo. |
uiAttributes.documentationLink |
Cadena | Se refiere a la página de documentación de la Catálogo de destinos para su destino. Uso https://www.adobe.com/go/destinations-YOURDESTINATION-en , donde YOURDESTINATION es el nombre de su destino. Para un destino llamado Moviestar, debe usar https://www.adobe.com/go/destinations-moviestar-en . Tenga en cuenta que este vínculo solo funciona después de que el Adobe establezca el destino en vivo y la documentación se publique. |
uiAttributes.category |
Cadena | Se refiere a la categoría asignada a su destino en Adobe Experience Platform. Para obtener más información, lea Categorías de destino. Utilice uno de los siguientes valores: adobeSolutions, advertising, analytics, cdp, cloudStorage, crm, customerSuccess, database, dmp, ecommerce, email, emailMarketing, enrichment, livechat, marketingAutomation, mobile, personalization, protocols, social, streaming, subscriptions, surveys, tagManagers, voc, warehouses, payments . |
uiAttributes.connectionType |
Cadena | Server-to-server actualmente es la única opción disponible. |
uiAttributes.frequency |
Cadena | Streaming actualmente es la única opción disponible. |
identityNamespaces.externalId.acceptsAttributes |
Booleano | Indica si los clientes pueden asignar atributos de perfil estándar a la identidad que está configurando. |
identityNamespaces.externalId.acceptsCustomNamespaces |
Booleano | Indica si los clientes pueden asignar identidades que pertenecen a áreas de nombres personalizadas a la identidad que está configurando. |
identityNamespaces.externalId.transformation |
Cadena | No se muestra en la configuración de ejemplo. Se utiliza, por ejemplo, cuando la variable Platform El cliente tiene direcciones de correo electrónico simples como atributo y la plataforma solo acepta correos electrónicos con hash. Aquí es donde proporcionaría la transformación que debe aplicarse (por ejemplo, transformar el correo electrónico a minúsculas y luego a hash). |
identityNamespaces.externalId.acceptedGlobalNamespaces |
- | Indica qué áreas de nombres de identidad estándar (por ejemplo, IDFA) Los clientes pueden asignarse a la identidad que está configurando. Cuando utilice acceptedGlobalNamespaces , puede usar "requiredTransformation":"sha256(lower($))" a direcciones de correo electrónico en minúsculas y hash o números de teléfono. |
destinationDelivery.authenticationRule |
Cadena | Indica cómo Platform los clientes se conectan a su destino. Los valores aceptados son CUSTOMER_AUTHENTICATION , PLATFORM_AUTHENTICATION , NONE .
|
destinationDelivery.destinationServerId |
Cadena | La variable instanceId del plantilla de servidor de destino para este destino. |
backfillHistoricalProfileData |
Booleano | Controla si los datos del perfil histórico se exportan cuando los segmentos se activan en el destino.
|
segmentMappingConfig.mapUserInput |
Booleano | Controla si el usuario introduce el ID de asignación de segmentos en el flujo de trabajo de activación de destino. |
segmentMappingConfig.mapExperiencePlatformSegmentId |
Booleano | Controla si el ID de asignación de segmentos en el flujo de trabajo de activación de destino es el ID de segmento del Experience Platform. |
segmentMappingConfig.mapExperiencePlatformSegmentName |
Booleano | Controla si el id. de asignación de segmentos en el flujo de trabajo de activación de destino es el nombre del segmento del Experience Platform. |
segmentMappingConfig.audienceTemplateId |
Booleano | La variable instanceId del plantilla de metadatos de audiencia para este destino. |
schemaConfig.profileFields |
Matriz | Al agregar una profileFields como se muestra en la configuración anterior, los usuarios tendrán la opción de asignar atributos de Experience Platform a los atributos predefinidos en el lado del destino. |
schemaConfig.profileRequired |
Booleano | Uso true si los usuarios deben poder asignar atributos de perfil de Experience Platform a atributos personalizados en el lado del destino, como se muestra en el ejemplo de configuración anterior. |
schemaConfig.segmentRequired |
Booleano | Utilice siempre segmentRequired:true . |
schemaConfig.identityRequired |
Booleano | Uso true si los usuarios deben poder asignar áreas de nombres de identidad desde el Experience Platform al esquema deseado. |
aggregation.aggregationType |
- | Seleccione BEST_EFFORT o CONFIGURABLE_AGGREGATION . La configuración de ejemplo anterior incluye BEST_EFFORT agregación. Para ver un ejemplo de CONFIGURABLE_AGGREGATION , consulte la configuración de ejemplo en la configuración de destino documento. Los parámetros relevantes para la agregación configurable se documentan a continuación en esta tabla. |
aggregation.bestEffortAggregation.maxUsersPerRequest |
Número entero | El Experience Platform puede acumular varios perfiles exportados en una sola llamada HTTP. Especifique el número máximo de perfiles que su extremo debe recibir en una sola llamada HTTP. Tenga en cuenta que esta es una agregación de mejor esfuerzo. Por ejemplo, si especifica el valor 100, Platform podría enviar cualquier número de perfiles menores que 100 en una llamada. Si el servidor no acepta varios usuarios por solicitud, establezca este valor en 1. |
aggregation.bestEffortAggregation.splitUserById |
Booleano | Utilice este indicador si la llamada al destino debe dividirse por identidad. Establezca este indicador como true si el servidor solo acepta una identidad por llamada, para un área de nombres determinada. |
aggregation.configurableAggregation.splitUserById |
Booleano | Consulte parámetro en configuración de ejemplo here. Utilice este indicador si la llamada al destino debe dividirse por identidad. Establezca este indicador como true si el servidor solo acepta una identidad por llamada, para un área de nombres determinada. |
aggregation.configurableAggregation.maxBatchAgeInSecs |
Número entero |
|
aggregation.configurableAggregation.maxNumEventsInBatch |
Número entero |
|
aggregation.configurableAggregation.aggregationKey |
Booleano | Consulte parámetro en configuración de ejemplo here. Permite acumular los perfiles exportados asignados al destino según los parámetros siguientes:
|
aggregation.configurableAggregation.aggregationKey.includeSegmentId |
Booleano | Consulte parámetro en configuración de ejemplo here. Configure esto como true si desea agrupar perfiles exportados a su destino por ID de segmento. |
aggregation.configurableAggregation.aggregationKey.includeSegmentStatus |
Booleano | Consulte parámetro en configuración de ejemplo here. Debe configurar ambas includeSegmentId:true y includeSegmentStatus:true si desea agrupar perfiles exportados a su destino por ID de segmento Y estado de segmento. |
aggregation.configurableAggregation.aggregationKey.includeIdentity |
Booleano | Consulte parámetro en configuración de ejemplo here. Configure esto como true si desea agrupar perfiles exportados al destino por el área de nombres de identidad. |
aggregation.configurableAggregation.aggregationKey.oneIdentityPerGroup |
Booleano | Consulte parámetro en configuración de ejemplo here. Utilice este parámetro para especificar si desea que los perfiles exportados se agreguen en grupos de una sola identidad (GAID, IDFA, números de teléfono, correo electrónico, etc.). |
aggregation.configurableAggregation.aggregationKey.groups |
Cadena | Consulte parámetro en configuración de ejemplo here. Cree listas de grupos de identidad si desea agrupar perfiles exportados a su destino por grupos de área de nombres de identidad. Por ejemplo, puede combinar perfiles que contengan los identificadores móviles IDFA y GAID en una llamada a su destino y correos electrónicos en otra utilizando la configuración del ejemplo. |
Respuesta
Una respuesta correcta devuelve el estado HTTP 200 con detalles de la configuración de destino recién creada.
Puede crear una nueva configuración de destino realizando una solicitud de POST al /authoring/destinations
punto final.
Formato de API
POST /authoring/destinations
Solicitud
La siguiente solicitud crea un nuevo Amazon S3 configuración de destino basada en archivos, configurada por los parámetros proporcionados en la carga útil. La carga útil siguiente incluye todos los parámetros para los destinos basados en archivos aceptados por el /authoring/destinations
punto final. Tenga en cuenta que no es necesario agregar todos los parámetros en la llamada de y que la plantilla se puede personalizar, según los requisitos de la API.
curl -X POST https://platform.adobe.io/data/core/activation/authoring/destinations \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"name": "S3 Destination with CSV Options",
"description": "S3 Destination with CSV Options",
"releaseNotes": "S3 Destination with CSV Options",
"status": "TEST",
"customerAuthenticationConfigurations": [
{
"authType": "S3"
}
],
"customerEncryptionConfigurations": [
{
"encryptionAlgo": ""
}
],
"customerDataFields": [
{
"name": "bucket",
"title": "Select S3 Bucket",
"description": "Select S3 Bucket",
"type": "string",
"isRequired": true,
"readOnly": false,
"hidden": false
},
{
"name": "path",
"title": "S3 path",
"description": "Select S3 Bucket",
"type": "string",
"isRequired": true,
"pattern": "^[A-Za-z]+$",
"readOnly": false,
"hidden": false
},
{
"name": "sep",
"title": "Select separator for each field and value",
"description": "Select for each field and value",
"type": "string",
"isRequired": false,
"readOnly": false,
"hidden": false
},
{
"name": "encoding",
"title": "Specify encoding (charset) of saved CSV files",
"description": "Select encoding of csv files",
"type": "string",
"enum": ["UTF-8", "UTF-16"],
"isRequired": false,
"readOnly": false,
"hidden": false
},
{
"name": "quote",
"title": "Select a single character used for escaping quoted values",
"description": "Select single charachter for escaping quoted values",
"type": "string",
"isRequired": false,
"readOnly": false,
"hidden": false
},
{
"name": "quoteAll",
"title": "Quote All",
"description": "Select flag for escaping quoted values",
"type": "string",
"enum" : ["true","false"],
"default": "true",
"isRequired": true,
"readOnly": false,
"hidden": false
},
{
"name": "escape",
"title": "Select a single character used for escaping quotes",
"description": "Select a single character used for escaping quotes inside an already quoted value",
"type": "string",
"isRequired": false,
"readOnly": false,
"hidden": false
},
{
"name": "escapeQuotes",
"title": "Escape quotes",
"description": "A flag indicating whether values containing quotes should always be enclosed in quotes",
"type": "string",
"enum" : ["true","false"],
"isRequired": false,
"default": "true",
"readOnly": false,
"hidden": false
},
{
"name": "header",
"title": "header",
"description": "Writes the names of columns as the first line.",
"type": "string",
"isRequired": false,
"enum" : ["true","false"],
"readOnly": false,
"default": "true",
"hidden": false
},
{
"name": "ignoreLeadingWhiteSpace",
"title": "Ignore leading white space",
"description": "A flag indicating whether or not leading whitespaces from values being written should be skipped.",
"type": "string",
"isRequired": false,
"enum" : ["true","false"],
"readOnly": false,
"default": "true",
"hidden": false
},
{
"name": "nullValue",
"title": "Select the string representation of a null value",
"description": "Sets the string representation of a null value. ",
"type": "string",
"isRequired": false,
"readOnly": false,
"hidden": false
},
{
"name": "dateFormat",
"title": "Date format",
"description": "Select the string that indicates a date format. ",
"type": "string",
"default": "yyyy-MM-dd",
"isRequired": false,
"readOnly": false,
"hidden": false
},
{
"name": "charToEscapeQuoteEscaping",
"title": "Char to escape quote escaping",
"description": "Sets a single character used for escaping the escape for the quote character",
"type": "string",
"isRequired": false,
"readOnly": false,
"hidden": false
},
{
"name": "emptyValue",
"title": "Select the string representation of an empty value",
"description": "Select the string representation of an empty value",
"type": "string",
"isRequired": false,
"readOnly": false,
"default": "",
"hidden": false
},
{
"name": "compression",
"title": "Select compression",
"description": "Select compressiont",
"type": "string",
"isRequired": true,
"readOnly": false,
"enum" : ["SNAPPY","GZIP","DEFLATE", "NONE"]
},
{
"name": "fileType",
"title": "Select a fileType",
"description": "Select fileType",
"type": "string",
"isRequired": true,
"readOnly": false,
"hidden": false,
"enum" :["csv", "json", "parquet"],
"default" : "csv"
}
],
"uiAttributes": {
"documentationLink": "https://www.adobe.io/apis/experienceplatform.html",
"category": "S3",
"iconUrl": "https://dc5tqsrhldvnl.cloudfront.net/2/90048/da276e30c730ce6cd666c8ca78360df21.png",
"connectionType": "S3",
"flowRunsSupported": true,
"monitoringSupported": true,
"frequency": "Batch"
},
"destinationDelivery": [
{
"deliveryMatchers" : [
{
"type" : "SOURCE",
"value" : [
"batch"
]
}
],
"authenticationRule": "CUSTOMER_AUTHENTICATION",
"destinationServerId": "{{destinationServerId}}"
}
],
"schemaConfig" : {
"profileRequired" : true,
"segmentRequired" : true,
"identityRequired" : true
},
"batchConfig":{
"allowMandatoryFieldSelection": true,
"allowJoinKeyFieldSelection": true,
"defaultExportMode": "DAILY_FULL_EXPORT",
"allowedExportMode":[
"DAILY_FULL_EXPORT",
"FIRST_FULL_THEN_INCREMENTAL"
],
"allowedScheduleFrequency":[
"DAILY",
"EVERY_3_HOURS",
"EVERY_6_HOURS",
"EVERY_8_HOURS",
"EVERY_12_HOURS",
"ONCE",
"EVERY_HOUR"
],
"defaultFrequency":"DAILY",
"defaultStartTime":"00:00"
},
"backfillHistoricalProfileData": true
}
Para obtener descripciones detalladas de todos los parámetros anteriores, consulte configuración de destino basada en archivos.
Respuesta
Una respuesta correcta devuelve el estado HTTP 200 con detalles de la configuración de destino recién creada.
Puede recuperar una lista de todas las configuraciones de destino para su organización IMS realizando una solicitud de GET al /authoring/destinations
punto final.
Formato de API
GET /authoring/destinations
Solicitud
La siguiente solicitud recuperará la lista de configuraciones de destino a la que tiene acceso, según la configuración de la organización y el entorno limitado de IMS.
curl -X GET https://platform.adobe.io/data/core/activation/authoring/destinations \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Respuesta
La siguiente respuesta devuelve el estado HTTP 200 con una lista de configuraciones de destino a las que tiene acceso, según el ID de organización de IMS y el nombre del simulador de pruebas que ha utilizado. One instanceId
corresponde a la plantilla de un destino. La respuesta se trunca para su brevedad.
{
"items":[
{
"instanceId":"b0780cb5-2bb7-4409-bf2c-c625ca818588",
"createdDate":"2020-10-28T06:14:09.784471Z",
"lastModifiedDate":"2021-06-28T06:14:09.784471Z",
"imsOrg":"AC3428435BF324E90A49402A@AdobeOrg",
"sandboxName":"prod",
"sandboxId":"r5g6660-c5da-11e9-93d4-6d5fc3a66a8e",
"name":"Moviestar",
"description":"Moviestar is a fictional destination, used for this example.",
"status":"TEST",
"customerAuthenticationConfigurations":[
{
"authType":"BEARER"
}
],
"customerDataFields":[
{
"name":"endpointsInstance",
"type":"string",
"title":"Select Endpoint",
"description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
"isRequired":true,
"enum":[
"US",
"EU",
"APAC",
"NZ"
]
},
{
"name":"customerID",
"type":"string",
"title":"Moviestar Customer ID",
"description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
"isRequired":true,
"pattern":"^[A-Za-z]+$"
}
],
"uiAttributes":{
"documentationLink":"https://www.adobe.com/go/destinations-moviestar-en",
"category":"mobile",
"connectionType":"Server-to-server",
"frequency":"Streaming"
},
"identityNamespaces":{
"external_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"Email":{
}
}
},
"another_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true
}
},
"segmentMappingConfig":{
"mapExperiencePlatformSegmentName":false,
"mapExperiencePlatformSegmentId":false,
"mapUserInput":false,
"audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
},
"schemaConfig":{
"profileFields":[
{
"name":"a_custom_attribute",
"title":"a_custom_attribute",
"description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the phoneNumber value in Experience Platform could be phoneNo on your side.",
"type":"string",
"isRequired":false,
"readOnly":false,
"hidden":false
}
],
"profileRequired":true,
"segmentRequired":true,
"identityRequired":true
},
"aggregation":{
"aggregationType":"BEST_EFFORT",
"bestEffortAggregation":{
"maxUsersPerRequest":10,
"splitUserById":false
}
},
"destinationDelivery":[
{
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
}
],
"destConfigId":"410631b8-f6b3-4b7c-82da-7998aa3f327c",
"backfillHistoricalProfileData":true
}
]
}
Parámetro | Tipo | Descripción |
---|---|---|
name |
Cadena | Indica el título del destino en el catálogo de Experience Platform. |
description |
Cadena | Proporcione una descripción que el Adobe utilizará en el catálogo de destinos del Experience Platform para su tarjeta de destino. Apunte a no más de 4-5 frases. |
status |
Cadena | Indica el estado del ciclo vital de la tarjeta de destino. Los valores aceptados son TEST , PUBLISHED y DELETED . Uso TEST la primera vez que configure el destino. |
customerAuthenticationConfigurations |
Cadena | Indica la configuración utilizada para autenticar a los clientes Experience Platform en el servidor. Consulte authType abajo para los valores aceptados. |
customerAuthenticationConfigurations.authType |
Cadena | Los valores aceptados son OAUTH2, BEARER . |
customerDataFields.name |
Cadena | Proporcione un nombre para el campo personalizado que está introduciendo. |
customerDataFields.type |
Cadena | Indica qué tipo de campo personalizado está introduciendo. Los valores aceptados son string , object , integer |
customerDataFields.title |
Cadena | Indica el nombre del campo, tal como lo ven los clientes en la interfaz de usuario del Experience Platform |
customerDataFields.description |
Cadena | Proporcione una descripción para el campo personalizado. |
customerDataFields.isRequired |
Booleano | Indica si este campo es necesario en el flujo de trabajo de configuración de destino. |
customerDataFields.enum |
Cadena | Representa el campo personalizado como un menú desplegable y enumera las opciones disponibles para el usuario. |
customerDataFields.pattern |
Cadena | Aplica un patrón para el campo personalizado, si es necesario. Utilice expresiones regulares para aplicar un patrón. Por ejemplo, si los ID de cliente no incluyen números o guiones bajos, introduzca ^[A-Za-z]+$ en este campo. |
uiAttributes.documentationLink |
Cadena | Se refiere a la página de documentación de la Catálogo de destinos para su destino. Uso https://www.adobe.com/go/destinations-YOURDESTINATION-en , donde YOURDESTINATION es el nombre de su destino. Para un destino llamado Moviestar, debe usar https://www.adobe.com/go/destinations-moviestar-en . Tenga en cuenta que este vínculo solo funciona después de que el Adobe establezca el destino en vivo y la documentación se publique. |
uiAttributes.category |
Cadena | Se refiere a la categoría asignada a su destino en Adobe Experience Platform. Para obtener más información, lea Categorías de destino. Utilice uno de los siguientes valores: adobeSolutions, advertising, analytics, cdp, cloudStorage, crm, customerSuccess, database, dmp, ecommerce, email, emailMarketing, enrichment, livechat, marketingAutomation, mobile, personalization, protocols, social, streaming, subscriptions, surveys, tagManagers, voc, warehouses, payments |
uiAttributes.connectionType |
Cadena | Server-to-server actualmente es la única opción disponible. |
uiAttributes.frequency |
Cadena | Streaming actualmente es la única opción disponible. |
identityNamespaces.externalId.acceptsAttributes |
Booleano | Indica si los clientes pueden asignar atributos de perfil estándar a la identidad que está configurando. |
identityNamespaces.externalId.acceptsCustomNamespaces |
Booleano | Indica si los clientes pueden asignar identidades que pertenecen a áreas de nombres personalizadas a la identidad que está configurando. |
identityNamespaces.externalId.transformation |
Cadena | No se muestra en la configuración de ejemplo. Se utiliza, por ejemplo, cuando la variable Platform El cliente tiene direcciones de correo electrónico simples como atributo y la plataforma solo acepta correos electrónicos con hash. Aquí es donde proporcionaría la transformación que debe aplicarse (por ejemplo, transformar el correo electrónico a minúsculas y luego a hash). |
identityNamespaces.externalId.acceptedGlobalNamespaces |
- | Indica qué áreas de nombres de identidad estándar (por ejemplo, IDFA) Los clientes pueden asignarse a la identidad que está configurando. Cuando utilice acceptedGlobalNamespaces , puede usar "requiredTransformation":"sha256(lower($))" a direcciones de correo electrónico en minúsculas y hash o números de teléfono. |
destinationDelivery.authenticationRule |
Cadena | Indica cómo Platform los clientes se conectan a su destino. Los valores aceptados son CUSTOMER_AUTHENTICATION , PLATFORM_AUTHENTICATION , NONE .
|
destinationDelivery.destinationServerId |
Cadena | La variable instanceId del plantilla de servidor de destino para este destino. |
destConfigId |
Cadena | Este campo se genera automáticamente y no requiere la introducción de datos. |
backfillHistoricalProfileData |
Booleano | Controla si los datos del perfil histórico se exportan cuando los segmentos se activan en el destino.
|
segmentMappingConfig.mapUserInput |
Booleano | Controla si el usuario introduce el ID de asignación de segmentos en el flujo de trabajo de activación de destino. |
segmentMappingConfig.mapExperiencePlatformSegmentId |
Booleano | Controla si el ID de asignación de segmentos en el flujo de trabajo de activación de destino es el ID de segmento del Experience Platform. |
segmentMappingConfig.mapExperiencePlatformSegmentName |
Booleano | Controla si el id. de asignación de segmentos en el flujo de trabajo de activación de destino es el nombre del segmento del Experience Platform. |
segmentMappingConfig.audienceTemplateId |
Booleano | La variable instanceId del plantilla de metadatos de audiencia para este destino. Para configurar una plantilla de metadatos de audiencia, lea la referencia de API de metadatos de audiencia. |
Puede actualizar una configuración de destino existente realizando una solicitud de PUT al /authoring/destinations
y proporcionando el ID de instancia de la configuración de destino que desea actualizar. En el cuerpo de la llamada a , proporcione la configuración de destino actualizada.
Formato de API
PUT /authoring/destinations/{INSTANCE_ID}
Parámetro | Descripción |
---|---|
{INSTANCE_ID} |
El ID de la configuración de destino que desea actualizar. |
Solicitud
La siguiente solicitud actualiza una configuración de destino existente, configurada por los parámetros proporcionados en la carga útil. En la llamada de ejemplo siguiente, se actualiza la configuración creado anteriormente para aceptar ahora identificadores de correo electrónico con hash, GAID e IDFA como áreas de nombres de identidad.
curl -X PUT https://platform.adobe.io/data/core/activation/authoring/destinations/b0780cb5-2bb7-4409-bf2c-c625ca818588 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"instanceId":"b0780cb5-2bb7-4409-bf2c-c625ca818588",
"createdDate":"2020-10-28T06:14:09.784471Z",
"lastModifiedDate":"2021-04-28T06:14:09.784471Z",
"imsOrg":"AC3428435BF324E90A49402A@AdobeOrg",
"sandboxName":"prod",
"sandboxId":"r5g6660-c5da-11e9-93d4-6d5fc3a66a8e",
"name":"Moviestar",
"description":"Moviestar is a fictional destination, used for this example.",
"status":"TEST",
"customerAuthenticationConfigurations":[
{
"authType":"BEARER"
}
],
"customerDataFields":[
{
"name":"endpointsInstance",
"type":"string",
"title":"Select Endpoint",
"description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
"isRequired":true,
"enum":[
"US",
"EU",
"APAC",
"NZ"
]
},
{
"name":"customerID",
"type":"string",
"title":"Moviestar Customer ID",
"description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
"isRequired":true,
"pattern":"^[A-Za-z]+$"
}
],
"uiAttributes":{
"documentationLink":"https://www.adobe.com/go/destinations-moviestar-en",
"category":"mobile",
"connectionType":"Server-to-server",
"frequency":"Streaming"
},
"identityNamespaces":{
"external_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"Email":{
}
}
},
"another_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true
},
"gaid":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"GAID":{
}
}
},
"idfa":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"IDFA":{
}
}
},
"email_lc_sha256":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"transformation":"sha256(lower($))",
"acceptedGlobalNamespaces":{
"Email":{
"requiredTransformation":"sha256(lower($))"
},
"Email_LC_SHA256":{
}
}
}
},
"segmentMappingConfig":{
"mapExperiencePlatformSegmentName":false,
"mapExperiencePlatformSegmentId":false,
"mapUserInput":false,
"audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
},
"schemaConfig":{
"profileFields":[
{
"name":"a_custom_attribute",
"title":"a_custom_attribute",
"description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the phoneNumber value in Experience Platform could be phoneNo on your side.",
"type":"string",
"isRequired":false,
"readOnly":false,
"hidden":false
}
],
"profileRequired":true,
"segmentRequired":true,
"identityRequired":true
},
"aggregation":{
"aggregationType":"BEST_EFFORT",
"bestEffortAggregation":{
"maxUsersPerRequest":10,
"splitUserById":false
}
},
"destinationDelivery":[
{
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
}
],
"backfillHistoricalProfileData":true
}
Puede recuperar información detallada sobre una configuración de destino específica realizando una solicitud de GET al /authoring/destinations
y proporcionando el ID de instancia de la configuración de destino que desea recuperar.
Formato de API
GET /authoring/destinations/{INSTANCE_ID}
Parámetro | Descripción |
---|---|
{INSTANCE_ID} |
El ID de la configuración de destino que desea recuperar. |
Solicitud
curl -X GET https://platform.adobe.io/data/core/activation/authoring/destinations/b0780cb5-2bb7-4409-bf2c-c625ca818588 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Respuesta
Una respuesta correcta devuelve el estado HTTP 200 con información detallada sobre la configuración de destino especificada.
{
"instanceId":"b0780cb5-2bb7-4409-bf2c-c625ca818588",
"createdDate":"2020-10-28T06:14:09.784471Z",
"lastModifiedDate":"2021-06-04T06:14:09.784471Z",
"imsOrg":"AC3428435BF324E90A49402A@AdobeOrg",
"sandboxName":"prod",
"sandboxId":"r5g6660-c5da-11e9-93d4-6d5fc3a66a8e",
"name":"Moviestar",
"description":"Moviestar is a fictional destination, used for this example.",
"status":"TEST",
"customerAuthenticationConfigurations":[
{
"authType":"BEARER"
}
],
"customerDataFields":[
{
"name":"endpointsInstance",
"type":"string",
"title":"Select Endpoint",
"description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
"isRequired":true,
"enum":[
"US",
"EU",
"APAC",
"NZ"
]
},
{
"name":"customerID",
"type":"string",
"title":"Moviestar Customer ID",
"description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
"isRequired":true,
"pattern":"^[A-Za-z]+$"
}
],
"uiAttributes":{
"documentationLink":"https://www.adobe.com/go/destinations-moviestar-en",
"category":"mobile",
"connectionType":"Server-to-server",
"frequency":"Streaming"
},
"identityNamespaces":{
"external_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"Email":{
}
}
},
"another_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true
},
"gaid":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"GAID":{
}
}
},
"idfa":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"IDFA":{
}
}
},
"email_lc_sha256":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"transformation":"sha256(lower($))",
"acceptedGlobalNamespaces":{
"Email":{
"requiredTransformation":"sha256(lower($))"
},
"Email_LC_SHA256":{
}
}
}
},
"segmentMappingConfig":{
"mapExperiencePlatformSegmentName":false,
"mapExperiencePlatformSegmentId":false,
"mapUserInput":false,
"audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
},
"schemaConfig":{
"profileFields":[
{
"name":"a_custom_attribute",
"title":"a_custom_attribute",
"description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the phoneNumber value in Experience Platform could be phoneNo on your side.",
"type":"string",
"isRequired":false,
"readOnly":false,
"hidden":false
}
],
"profileRequired":true,
"segmentRequired":true,
"identityRequired":true
},
"aggregation":{
"aggregationType":"BEST_EFFORT",
"bestEffortAggregation":{
"maxUsersPerRequest":10,
"splitUserById":false
}
},
"destinationDelivery":[
{
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
}
],
"backfillHistoricalProfileData":true
}
Puede eliminar la configuración de destino especificada realizando una solicitud de DELETE al /authoring/destinations
y proporcionando el ID de la configuración de destino que desea eliminar en la ruta de solicitud.
Formato de API
DELETE /authoring/destinations/{INSTANCE_ID}
Parámetro | Descripción |
---|---|
{INSTANCE_ID} |
La variable id de la configuración de destino que desea eliminar. |
Solicitud
curl -X DELETE https://platform.adobe.io/data/core/activation/authoring/destinations/b0780cb5-2bb7-4409-bf2c-c625ca818588 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Respuesta
Una respuesta correcta devuelve el estado HTTP 200 junto con una respuesta HTTP vacía.
Los extremos de la API del Destination SDK siguen los principios generales del mensaje de error de la API del Experience Platform. Consulte Códigos de estado de API y errores en el encabezado de la solicitud en la guía de solución de problemas de Platform.
Después de leer este documento, ahora sabe cómo configurar su destino utilizando la variable /authoring/destinations
extremo de API. Lectura cómo usar Destination SDK para configurar el destino para comprender dónde encaja este paso en el proceso de configuración de su destino.