此配置允许您指示基于文件的目标的基本信息,如目标名称、类别、描述等。 此配置中的设置还可确定Experience Platform用户如何对您的目标进行身份验证、该目标如何显示在Experience Platform用户界面中,以及可导出到您目标的身份。 您还可以使用此配置来显示与导出文件的文件类型、文件格式或压缩设置相关的选项。
此配置还会将目标工作所需的其他配置(目标服务器和受众元数据)连接到此配置。 了解如何在 下文.
您可以使用 /authoring/destinations
API端点。 读取 目标API端点操作 有关可对端点执行的操作的完整列表。
以下是通过创建的专用自定义Amazon S3目标的示例 /destinations
配置端点。
{
"name":"S3 Destination with CSV Options",
"description":"S3 Destination with CSV Options",
"status":"TEST",
"maxProfileAttributes":"2000",
"maxIdentityAttributes":"10",
"customerAuthenticationConfigurations":[
{
"authType":"S3"
}
],
"customerEncryptionConfigurations":[
],
"customerDataFields":[
{
"name":"bucketName",
"title":"Amazon S3 bucket name",
"description":"Enter your Amazon S3 bucket name",
"type":"string",
"isRequired":true,
"pattern": "(?=^.{3,63}$)(?!^(\\d+\\.)+\\d+$)(^(([a-z0-9]|[a-z0-9][a-z0-9\\-]*[a-z0-9])\\.)*([a-z0-9]|[a-z0-9][a-z0-9\\-]*[a-z0-9])$)",
"readOnly":false,
"hidden":false
},
{
"name":"path",
"title":"Amazon S3 bucket path",
"description":"Enter your S3 bucket path",
"type":"string",
"isRequired":true,
"pattern": "^[0-9a-zA-Z\\/\\!\\-_\\.\\*\\''\\(\\)]*((\\%SEGMENT_(NAME|ID)\\%)?\\/?)+$",
"readOnly":false,
"hidden":false
},
{
"name":"sep",
"title":"Enter a separator for each field and value",
"description":"Enter a separator character 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":"Escape all quoted values",
"description":"Select whether to escape all 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":"http://www.adobe.com/go/YOURDESTINATION-en",
"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}}"
}
],
"identityNamespaces":{
"adobe_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true
},
"mobile_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true
}
},
"segmentMappingConfig":{
"mapExperiencePlatformSegmentName":false,
"mapExperiencePlatformSegmentId":false,
"mapUserInput":false,
"audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
},
"schemaConfig":{
"profileFields":[
{
"name":"phoneNo",
"title":"phoneNo",
"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
},
"batchConfig":{
"allowMandatoryFieldSelection":true,
"allowDedupeKeyFieldSelection":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"
],
"defaultFrequency":"DAILY",
"defaultStartTime":"00:00",
"filenameConfig":{
"allowedFilenameAppendOptions":[
"SEGMENT_NAME",
"DESTINATION_INSTANCE_ID",
"DESTINATION_INSTANCE_NAME",
"ORGANIZATION_NAME",
"SANDBOX_NAME",
"DATETIME",
"CUSTOM_TEXT"
],
"defaultFilenameAppendOptions":[
"DATETIME"
],
"defaultFilename":"%DESTINATION%_%SEGMENT_ID%"
},
"backfillHistoricalProfileData":true
}
参数 | 类型 | 描述 |
---|---|---|
name |
字符串 | 指示Experience Platform目录中目标的标题。 |
description |
字符串 | 在Experience Platform目标目录中,提供目标卡的描述。 目标不超过4-5句。 |
status |
字符串 | 指示目标卡的生命周期状态。 接受的值包括 TEST 、PUBLISHED 和 DELETED 。使用 TEST 首次配置目标时。 |
maxProfileAttributes |
字符串 | 指示客户可导出到目标的配置文件属性的最大数量。 默认值为 2000 。 |
maxIdentityAttributes |
字符串 | 指示客户可导出到目标的身份命名空间的最大数量。 默认值为 10 。 |
目标配置中的此部分将生成 配置新目标 Experience Platform用户界面中的页面,用户可将Experience Platform连接到他们与您的目标拥有的帐户。
"customerAuthenticationConfigurations": [
{
"authType": "S3"
}
],
取决于 身份验证选项 您在 authType
字段中,将为用户生成Experience Platform页面,如下所示:
配置Amazon S3身份验证类型时,需要用户输入S3凭据。
配置Azure Blob身份验证类型时,需要用户输入连接字符串。
使用密码身份验证类型配置SFTP时,用户需要输入SFTP用户名和密码,以及SFTP域和端口(默认端口为22)。
使用SSH密钥身份验证类型配置SFTP时,需要用户输入SFTP用户名和SSH密钥,以及SFTP域和端口(默认端口为22)。
在Experience PlatformUI中连接到目标时,使用此部分要求用户填写特定于您目标的自定义字段。
在以下示例中, customerDataFields
要求用户输入其目标的名称,并提供 Amazon S3 存储段名称和文件夹路径,以及压缩类型、文件格式和若干其他文件格式选项。
您可以在模板中访问和使用来自客户数据字段的客户输入。 使用宏 {{customerData.exampleName}}
. 例如,如果您要求用户输入名为的Amazon S3存储段字段 bucket
,则可以在模板中使用宏来访问它 {{customerData.bucket}}
. 查看如何在 目标服务器配置.
"customerDataFields":[
{
"name":"bucket",
"title":"Amazon S3 bucket name",
"description":"Enter your Amazon S3 bucket name",
"type":"string",
"isRequired":true,
"readOnly":false,
"hidden":false
},
{
"name":"path",
"title":"Amazon S3 bucket path",
"description":"Enter your S3 bucket path",
"type":"string",
"isRequired":true,
"pattern":"^[A-Za-z]+$",
"readOnly":false,
"hidden":false
},
{
"name":"sep",
"title":"Enter a separator for each field and value",
"description":"Enter a separator character 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":"Escape all quoted values",
"description":"Select whether to escape all 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"
}
上例中列出的所有文件格式配置,均在 文件格式配置 中。
参数 | 类型 | 描述 |
---|---|---|
name |
字符串 | 为要引入的自定义字段提供名称。 |
title |
字符串 | 指示字段的名称,客户在Experience Platform用户界面中可看到该字段。 |
description |
字符串 | 为自定义字段提供描述。 |
type |
字符串 | 指示您引入的自定义字段类型。 接受的值为 string , object , integer . |
isRequired |
布尔型 | 指示目标设置工作流中是否需要此字段。 |
pattern |
字符串 | 如果需要,可为自定义字段实施模式。 使用正则表达式来强制实施模式。 例如,如果您的客户ID不包含数字或下划线,请输入 ^[A-Za-z]+$ 中。 |
enum |
字符串 | 将自定义字段呈现为下拉菜单,并列出可供用户使用的选项。 |
default |
字符串 | 定义 enum 列表。 |
此部分引用上述配置中的UI元素,Adobe应在Adobe Experience Platform用户界面中将其用于您的目标。
"uiAttributes":{
"documentationLink":"http://www.adobe.com/go/YOURDESTINATION-en",
"category":"cloudStorage",
"iconUrl":"https://dc5tqsrhldvnl.cloudfront.net/2/90048/da276e30c730ce6cd666c8ca78360df21.png",
"connectionType":"S3",
"flowRunsSupported":true,
"monitoringSupported":true,
"frequency":"Batch"
}
参数 | 类型 | 描述 |
---|---|---|
documentationLink |
字符串 | 指 目标目录 你的目的地。 使用 http://www.adobe.com/go/destinations-YOURDESTINATION-en ,其中 YOURDESTINATION 是您的目标名称。 对于名为Moviestar的目标,您将使用 http://www.adobe.com/go/destinations-moviestar-en . 请注意,此链接仅在Adobe设置目标处于实时状态且文档已发布后才可用。 |
category |
字符串 | 是指分配给您在Adobe Experience Platform中的目标的类别。 有关更多信息,请阅读 目标类别. 使用以下任一值: 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 . |
iconUrl |
字符串 | 您在其中托管要在目标目录卡中显示的图标的URL。 对于私有自定义集成,不需要执行此操作。 对于按产品化配置,您需要在 提交目标供审核. |
connectionType |
字符串 | 连接类型,具体取决于目标。 支持的值:
|
flowRunsSupported |
布尔型 | 指示目标连接是否包含在 流运行UI. 将此参数设置为 true :
|
monitoringSupported |
布尔型 | 指示目标连接是否包含在 监控UI. 将此参数设置为 true , 在监控中查看 选项。 |
frequency |
字符串 | 是指目标支持的数据导出类型。 设置为 Batch (对于基于文件的目标)。 |
目标投放部分确切地指示导出数据的去向,以及在数据登陆位置中使用的身份验证规则。 您需要指定一个或多个 destinationServerId
用于提交数据和验证规则的位置。 在大多数情况下,您应使用的身份验证规则是 CUSTOMER_AUTHENTICATION
.
的 deliveryMatchers
部分是可选的,如果您指定了多个 destinationServerId
s.如果是这样, deliveryMatchers
部分指示导出的数据应如何在各个目标服务器之间进行拆分。
"destinationDelivery":[
{
"deliveryMatchers":[
{
"type":"SOURCE",
"value":[
"batch"
]
}
],
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"{{destinationServerId}}"
}
]
参数 | 类型 | 描述 |
---|---|---|
authenticationRule |
字符串 | 指示方式 Platform 客户连接到您的目标。 接受的值为 CUSTOMER_AUTHENTICATION , PLATFORM_AUTHENTICATION , NONE .
|
destinationServerId |
字符串 | 的 instanceId 的 目标服务器配置 你 已创建 的值。 |
目标配置的此部分与区段元数据(如区段名称或ID)在Experience Platform与目标之间共享的方式相关。
通过 audienceTemplateId
,此部分还会将此配置与 受众元数据配置.
"segmentMappingConfig":{
"mapExperiencePlatformSegmentName":false,
"mapExperiencePlatformSegmentId":false,
"mapUserInput":false,
"audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
},
参数 | 类型 | 描述 |
---|---|---|
mapExperiencePlatformSegmentName |
布尔型 | 控制目标激活工作流中的区段映射ID是否为Experience Platform区段名称。 |
mapExperiencePlatformSegmentId |
布尔型 | 控制目标激活工作流中的区段映射ID是否为Experience Platform区段ID。 |
mapUserInput |
布尔型 | 控制用户是否在目标激活工作流中输入区段映射ID。 |
audienceTemplateId |
布尔型 | 的 instanceId 的 受众元数据模板 用于此目标。 要设置受众元数据模板,请阅读 受众元数据API参考. |
Adobe Experience Platform Destination SDK支持合作伙伴定义的模式。 合作伙伴定义的架构允许用户将配置文件属性和标识映射到目标合作伙伴定义的自定义架构,与 流目标 工作流。
在中使用参数 schemaConfig
以启用目标激活工作流的映射步骤。 通过使用下面描述的参数,您可以确定Experience Platform用户是否可以将配置文件属性和/或身份映射到基于文件的目标。
您可以创建静态、硬编码架构字段,也可以指定Experience Platform应连接到的动态架构,以便动态检索和填充映射工作流目标架构中的字段。 目标架构如下面的屏幕截图所示。
"schemaConfig":{
"profileFields":[
{
"name":"phoneNo",
"title":"phoneNo",
"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
}
参数 | 类型 | 描述 |
---|---|---|
profileFields |
数组 | 添加预定义 profileFields ,则Experience Platform用户可以选择将平台属性映射到目标中的预定义属性。 |
profileRequired |
布尔型 | 使用 true 如上面的示例配置所示,用户应该能够在目标侧将配置文件属性从Experience Platform映射到自定义属性。 |
segmentRequired |
布尔型 | 始终使用 segmentRequired:true . |
identityRequired |
布尔型 | 使用 true 用户应能够将身份命名空间从Experience Platform映射到所需的架构。 |
在中使用参数 dynamicSchemaConfig
用于动态检索您自己的架构,Platform配置文件属性和/或身份可以映射到该架构。
"schemaConfig":{
"dynamicSchemaConfig":{
"dynamicEnum": {
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"2aa8a809-c4ae-4f66-bb02-12df2e0a2279",
"value": "Schema Name",
"responseFormat": "SCHEMA"
}
},
"profileRequired":true,
"segmentRequired":true,
"identityRequired":true
}
参数 | 类型 | 描述 |
---|---|---|
profileRequired |
布尔型 | 使用 true 如上面的示例配置所示,用户应该能够在目标侧将配置文件属性从Experience Platform映射到自定义属性。 |
segmentRequired |
布尔型 | 始终使用 segmentRequired:true . |
identityRequired |
布尔型 | 使用 true 用户应能够将身份命名空间从Experience Platform映射到所需的架构。 |
destinationServerId |
字符串 | 的 instanceId 的 目标服务器配置 创建的动态架构的ID。 此目标服务器包含HTTP端点,Experience Platform将调用该端点来检索用于填充目标字段的动态架构。 |
authenticationRule |
字符串 | 指示方式 Platform 客户连接到您的目标。 接受的值为 CUSTOMER_AUTHENTICATION , PLATFORM_AUTHENTICATION , NONE .
|
value |
字符串 | 要在Experience Platform用户界面中的映射步骤中显示的架构名称。 |
responseFormat |
字符串 | 始终设置为 SCHEMA 定义自定义架构时。 |
在架构配置中,您可以选择添加必需(或预定义)映射。 用户在设置与目标的连接时可以查看但无法修改的映射。 例如,您可以强制将电子邮件地址字段始终发送到导出文件中的目标。 请参阅下面两个具有所需映射的架构配置示例,以及这些示例在的映射步骤中的显示情况 将数据激活到批处理目标工作流.
"requiredMappingsOnly": true, // when this is selected true , users cannot map other attributes and identities in the activation flow, apart from the required mappings that you define.
"requiredMappings": [
{
"destination": "identityMap.ExamplePartner_ID", //if only the destination field is specified, then the user is able to select a source field to map to the destination.
"mandatoryRequired": true,
"primaryKeyRequired": true
}
]
"requiredMappingsOnly": true, // when this is selected true , users cannot map other attributes and identities in the activation flow, apart from the required mappings that you define.
"requiredMappings": [
{
"sourceType": "text/x.schema-path",
"source": "personalEmail.address",
"destination": "personalEmail.address" //when both source and destination fields are specified as required mappings, then the user can not select or edit any of the two fields and can only view the selection.
}
]
当前支持的所需映射组合包括:
当前仅配置必需源字段 not 受支持。
如果要在目标的激活工作流中添加所需的映射,请使用下表中描述的参数。
参数 | 类型 | 描述 |
---|---|---|
requiredMappingsOnly |
布尔型 | 指示用户是否能够在激活流程中映射其他属性和身份, apart 您定义的所需映射。 |
requiredMappings.mandatoryRequired |
布尔型 | 如果此字段必须是必填字段,则应始终存在于目标文件导出中,则设置为true。 有关更多信息 必需属性. |
requiredMappings.primaryKeyRequired |
布尔型 | 如果在导出到目标的文件中必须将此字段用作重复数据删除键,则设置为true。 有关更多信息 重复数据删除键. |
requiredMappings.sourceType |
字符串 | 在根据需要配置源字段时使用。 使用 "text/x.schema-path" ,表示源字段是预定义的XDM属性 |
requiredMappings.source |
字符串 | 指示必需的源字段。 |
requiredMappings.destination |
字符串 | 指示必填目标字段的内容。 |
此部分中的参数可确定目标接受的身份。 此配置还会在 映射步骤 Experience Platform用户界面的中,用户可将身份和属性从其XDM架构映射到目标中的架构。
"identityNamespaces": {
"crm_id": {
"acceptsAttributes": true,
"acceptsCustomNamespaces": true
},
"mobile_id": {
"acceptsAttributes": true,
"acceptsCustomNamespaces": true
}
},
您必须指明 Platform 标识客户能够导出到您的目标。 例如 Experience Cloud ID,经过哈希处理的电子邮件,设备ID(IDFA, GAID)。 这些值包括 Platform 客户可以映射到来自您目标的身份命名空间的身份命名空间。 您还可以指示客户是否可以将自定义命名空间映射到您的目标支持的身份(acceptsCustomNamespaces: true
)以及客户是否可以将标准XDM属性映射到您的目标支持的标识(acceptsAttributes: true
)。
身份命名空间不需要 Platform 和你的目的地。
例如,客户可以映射 Platform IDFA 命名空间 IDFA 命名空间,或者它们可以映射相同的 Platform IDFA 命名空间 Customer ID 命名空间。
有关身份的更多信息,请参阅 身份命名空间概述.
本节将介绍将在Adobe Experience Platform用户界面中为您的目标显示的文件命名和导出计划设置。 您在此处设置的值会在 计划区段导出 基于文件的目标激活工作流的步骤。
"batchConfig":{
"allowMandatoryFieldSelection":true,
"allowDedupeKeyFieldSelection":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"
],
"defaultFrequency":"DAILY",
"defaultStartTime":"00:00",
"filenameConfig":{
"allowedFilenameAppendOptions":[
"SEGMENT_NAME",
"DESTINATION_INSTANCE_ID",
"DESTINATION_INSTANCE_NAME",
"ORGANIZATION_NAME",
"SANDBOX_NAME",
"DATETIME",
"CUSTOM_TEXT"
],
"defaultFilenameAppendOptions":[
"DATETIME"
],
"defaultFilename":"%DESTINATION%_%SEGMENT_ID%"
},
}
参数 | 类型 | 描述 |
---|---|---|
allowMandatoryFieldSelection |
布尔型 | 设置为 true 以允许客户指定哪些配置文件属性是必需的。 默认值为 false 。请参阅 必需属性 以了解更多信息。 |
allowDedupeKeyFieldSelection |
布尔型 | 设置为 true 允许客户指定重复数据删除键。 默认值为 false 。请参阅 重复数据删除键 以了解更多信息。 |
defaultExportMode |
枚举 | 定义默认的文件导出模式。 支持的值:
DAILY_FULL_EXPORT 。请参阅 批量激活文档 有关文件导出计划的详细信息。 |
allowedExportModes |
列表 | 定义客户可用的文件导出模式。 支持的值:
|
allowedScheduleFrequency |
列表 | 定义客户可用的文件导出频率。 支持的值:
|
defaultFrequency |
枚举 | 定义默认文件导出频率。支持的值:
DAILY 。 |
defaultStartTime |
字符串 | 定义文件导出的默认开始时间。 使用24小时文件格式。 默认值为“00:00”。 |
filenameConfig.allowedFilenameAppendOptions |
字符串 | 必需. 可供用户选择的可用文件名宏列表。 这可确定要将哪些项目附加到导出的文件名(区段ID、组织名称、导出日期和时间等)中。 设置 defaultFilename ,请确保避免复制宏。 支持的值:
如果 defaultFilename 为空, allowedFilenameAppendOptions 列表必须至少包含一个宏。 |
filenameConfig.defaultFilenameAppendOptions |
字符串 | 必需. 用户可取消选中的预选默认文件名宏。 此列表中的宏是 allowedFilenameAppendOptions . |
filenameConfig.defaultFilename |
字符串 | 可选. 为导出的文件定义默认的文件名宏。 用户无法覆盖这些内容。 定义的任何宏 allowedFilenameAppendOptions 将在 defaultFilename 宏。 如果 defaultFilename 为空,则必须在 allowedFilenameAppendOptions . |
使用文件名配置宏来定义导出的文件名应包含的内容。 下表中的宏描述了在 文件名配置 屏幕。
作为最佳实践,您应始终包含 SEGMENT_ID
宏。 区段ID是唯一的,因此将它们包含在文件名中是确保文件名也唯一的最佳方法。
宏 | UI标签 | 描述 | 示例 |
---|---|---|---|
DESTINATION |
目标 | UI中的目标名称。 | Amazon S3 |
SEGMENT_ID |
区段ID | 平台生成的唯一区段ID | ce5c5482-2813-4a80-99bc-57113f6acde2 |
SEGMENT_NAME |
区段名称 | 用户定义的区段名称 | VIP订阅者 |
DESTINATION_INSTANCE_ID |
目标ID | 目标实例的唯一、平台生成的ID | 7b891e5f-025a-4f0d-9e73-1919e71da3b0 |
DESTINATION_INSTANCE_NAME |
目标名称 | 目标实例的用户定义的名称。 | 我2022年的广告去向 |
ORGANIZATION_NAME |
组织名称 | Adobe Experience Platform中的客户组织名称。 | 我的组织名称 |
SANDBOX_NAME |
沙盒名称 | 客户使用的沙盒的名称。 | prod |
DATETIME / TIMESTAMP |
日期和时间 | DATETIME 和 TIMESTAMP 这两种格式都定义了文件的生成时间,但格式不同。
DATETIME 和 TIMESTAMP 互斥,且不能同时使用。 |
|
CUSTOM_TEXT |
自定义文本 | 要包含在文件名中的用户定义的自定义文本。 不能在中使用 defaultFilename . |
My_Custom_Text |
TIMESTAMP |
日期和时间 | 生成文件时的10位时间戳(Unix格式)。 | 1652131584 |
上图中显示的示例使用以下文件名宏配置:
"filenameConfig":{
"allowedFilenameAppendOptions":[
"CUSTOM_TEXT",
"SEGMENT_ID",
"DATETIME"
],
"defaultFilenameAppendOptions":[
"SEGMENT_ID",
"DATETIME"
],
"defaultFilename": "%DESTINATION%"
}
您可以使用 backfillHistoricalProfileData
参数来确定是否应将历史配置文件资格导出到您的目标。
"backfillHistoricalProfileData":true
参数 | 类型 | 描述 |
---|---|---|
backfillHistoricalProfileData |
布尔型 | 控制在将区段激活到目标时是否导出历史配置文件数据。
|
您的某些目标设置必须通过 目标服务器 或 受众元数据配置 端点。 此处描述的目标配置通过引用以下两个其他配置来连接所有这些设置:
destinationServerId
引用为目标设置的目标服务器和文件模板配置。audienceMetadataId
引用为您的目标设置的受众元数据配置。