输入和输出 Attribution AI
以下文件概述了在中使用的不同输入和输出 Attribution AI.
Attribution AI 输入数据
Attribution AI通过分析以下数据集计算算法分数来工作：
- Adobe Analytics数据集使用 Analytics源连接器
- Adobe Experience Platform架构中的Experience Event (EE)数据集
- 使用者体验事件(CEE)数据集
您现在可以基于 身份映射 （字段）表示每个数据集共享相同的身份类型（命名空间），例如ECID。 选择身份和命名空间后，将显示ID列完整性量度，指示要拼合的数据量。 要了解有关添加多个数据集的更多信息，请访问 Attribution AI用户指南.
默认情况下，并不总是映射渠道信息。 在某些情况下，如果mediaChannel（字段）为空，则在将字段映射到mediaChannel之前，您将无法“继续”，因为它是必需列。 如果在数据集中检测到频道，则默认情况下该频道将映射到mediaChannel。 其他列，例如 媒体类型 和 媒体操作 仍然是可选的。
映射渠道字段后，请继续执行“定义事件”步骤，您可以在其中选择转化事件、接触点事件，然后从单个数据集中选择特定字段。
Adobe Analytics Source Connector最多可能需要四周时间来回填数据。 如果您最近设置了连接器，则应验证数据集是否具有Attribution AI所需的最小数据长度。 请查看 历史数据 部分，以验证您是否有足够的数据来计算准确的算法分数。
有关设置的更多详细信息 Consumer Experience Event (CEE)模式，请参阅 Intelligent Services数据准备 指南。 有关映射Adobe Analytics数据的更多信息，请访问 Analytics字段映射 文档。
并非中的所有列 Consumer Experience Event (CEE)模式是Attribution AI的必需模式。
您可以使用架构或选定数据集中下面推荐的任何字段配置接触点。
| 建议的列 | 需要 |
|---|---|
| 主要标识字段 | 接触点/转化 |
| 时间戳 | 接触点/转化 |
| 渠道._类型 | 接触点 |
| Channel.mediaAction | 接触点 |
| Channel.mediaType | 接触点 |
| Marketing.trackingCode | 接触点 |
| Marketing.campaignname | 接触点 |
| Marketing.campaigngroup | 接触点 |
| Commerce | 转化 |
通常，在“商务”下的订单、购买和结账等转化列上运行归因。 “渠道”和“营销”列用于定义Attribution AI的接触点(例如， channel._type = 'https://ns.adobe.com/xdm/channel-types/email')。 为获得最佳结果和见解，强烈建议您包含尽可能多的转化和接触点列。 此外，您不仅可以使用上述列。 您可以将任何其他推荐的列或自定义列作为转化或接触点定义。
只要与配置接触点相关的渠道或营销活动信息存在于其中一个混合或传递字段中，体验事件(EE)数据集就不需要显式地包含渠道和营销mixin。
如果您在CEE架构中使用Adobe Analytics数据，Analytics的接触点信息通常存储在 channel.typeAtSource (例如， channel.typeAtSource = 'email')。
历史数据
Attribution AI运行所需的最小数据量如下：
- 您需要提供至少3个月（90天）的数据才能运行良好的模型。
- 您至少需要1000次转化。
Attribution AI需要历史数据作为模型训练的输入。 所需的数据持续时间主要取决于两个关键因素：训练窗口和回顾窗口。 训练窗口较短的输入对近期趋势更敏感，而训练窗口较长的输入有助于产生更稳定、更准确的模型。 使用最能代表您的业务目标的历史数据为目标建模，这一点很重要。
此 训练窗口配置 根据发生时间筛选设置为用于模型训练的转化事件。 目前，最低培训时段为1季（90天）。 此 回顾窗口 提供了一个时间范围，用于指示应包含与转化事件相关的转化事件接触点之前的天数。 这两个概念共同确定应用程序所需的输入数据量（以天为单位）。
默认情况下，Attribution AI将培训时段定义为最近2个季度（6个月），回顾时段定义为56天。 换言之，该模型将考虑过去2个季度发生的所有已定义的转化事件，并查找在相关转化事件之前56天内发生的所有接触点。
公式:
所需的最小数据长度=训练时段+回顾时段
具有默认配置的应用程序所需的最小数据长度为：2季度（180天）+ 56天= 236天。
示例：
- 您希望归因最近90天（3个月）内发生的转化事件，并跟踪在转化事件之前4周内发生的所有接触点。 输入数据持续时间应跨越过去90天+ 28天（4周）。 培训时段为90天，回顾时段为28天，共计118天。
Attribution AI输出数据
Attribution AI输出以下内容：
示例输出架构：
原始粒度分数
Attribution AI会尽可能以最精细的级别输出归因分数，以便您可以按任意分数列对分数进行细分。 要在UI中查看这些分数，请阅读以下部分： 查看原始得分路径. 要使用API下载得分，请访问 在Attribution AI中下载分数 文档。
仅当满足以下任一条件时，您才能在得分输出数据集的输入数据集中看到任何所需的报表列：
- 报告列作为接触点或转化定义配置的一部分包含在配置页面中。
- 报表列包含在附加分数数据集列中。
下表概述了原始分数示例输出中的架构字段：
| 列名称（数据类型） | 可为空 | 描述 |
|---|---|---|
| timestamp (DateTime) | False | 发生转化事件或观察的时间。 示例： 2020-06-09T00:01:51.000赫 |
| identityMap (Map) | True | 与CEE XDM格式类似的用户的identityMap。 |
| eventType（字符串） | True | 此时间序列记录的主要事件类型。 示例： "Order"、"Purchase"、"Visit" |
| eventMergeId（字符串） | True | 要关联或合并多个ID Experience Events 基本相同的事件或应该合并的事件相关联。 此插件旨在由数据生成器在引入之前填充。 示例： 575525617716-0-edc2ed37-1aab-4750-a820-1c2b3844b8c4 |
| _id（字符串） | False | 时间序列事件的唯一标识符。 示例： 4461-edc2ed37-1aab-4750-a820-1c2b3844b8c4 |
| _tenantId（对象） | False | 与您的租户ID对应的顶层对象容器。 示例： _atsdsnrmmsv2 |
| your_schema_name（对象） | False | 对包含转化事件的行进行得分，计算与其及其元数据关联的所有接触点事件。 示例： Attribution AI分数 — 型号名称__2020 |
| 分段（字符串） | True | 转化区段，例如构建模型所针对的地理分段。 如果缺少区段，则区段与conversionName相同。 示例： ORDER_US |
| conversionName（字符串） | True | 在安装期间配置的转换的名称。 示例： 订购、潜在客户、访问 |
| 转换（对象） | False | 转换元数据列。 |
| 数据源（字符串） | True | 数据源的全局唯一标识。 示例： Adobe Analytics |
| eventSource（字符串） | True | 实际事件发生时的源。 示例： Adobe.com |
| eventType（字符串） | True | 此时间序列记录的主要事件类型。 示例： 订购 |
| geo（字符串） | True | 进行转换的地理位置 placeContext.geo.countryCode. 示例： US |
| priceTotal（双精度） | True | 通过转换获得的收入 示例： 99.9 |
| product (String) | True | 产品本身的XDM标识符。 示例： RX 1080 ti |
| productType（字符串） | True | 在此产品视图中向用户显示的产品显示名称。 示例： Gpu |
| 数量（整数） | True | 在转换期间购买的数量。 示例： 1 1080立方 |
| receivedTimestamp (DateTime) | True | 已收到转换的时间戳。 示例： 2020-06-09T00:01:51.000赫 |
| skuId（字符串） | True | 库存单位(SKU)，供应商定义的产品的唯一标识符。 示例： MJ-03-XS-Black |
| timestamp (DateTime) | True | 转换的时间戳。 示例： 2020-06-09T00:01:51.000赫 |
| passThrough（对象） | True | 配置模型时用户指定的其他得分数据集列。 |
| commerce_order_purchaseCity（字符串） | True | 其他得分数据集列。 示例： 城市：圣何塞 |
| customerProfile（对象） | False | 用于构建模型的用户的身份详细信息。 |
| 标识（对象） | False | 包含用于构建模型的用户的详细信息，例如 id 和 namespace. |
| id（字符串） | True | 用户的身份ID，如Cookie ID、Adobe Analytics ID (AAID)或Experience CloudID （ECID，也称为MCID或访客ID）等。 示例： 17348762725408656344688320891369597404 |
| 命名空间（字符串） | True | 用于构建路径并因此构建模型的身份命名空间。 示例： aaid |
| touchpointsDetail（对象数组） | True | 导致转化的接触点详细信息列表，排序方式： |
| touchpointName（字符串） | True | 在安装期间配置的接触点的名称。 示例： PAID_SEARCH_CLICK |
| 分数（对象） | True | 作为得分的接触点对此转化的贡献。 有关此对象中生成的分数的更多信息，请参阅 总归因分数 部分。 |
| touchPoint（对象） | True | 接触点元数据。 有关此对象中生成的分数的更多信息，请参阅 汇总分数 部分。 |
查看原始得分路径(UI)
您可以在UI中查看原始分数的路径。 首先选择 架构 然后，在Platform UI中搜索并选择您的归因人工智能得分架构 浏览 选项卡。
接下来，选择 结构 UI窗口、 字段属性 选项卡打开。 范围 字段属性 是映射到原始分数的路径字段。
汇总的归因分数
如果日期范围少于30天，则可以从Platform UI以CSV格式下载汇总分数。
Attribution AI支持两类归因分数：算法分数和基于规则的分数。
Attribution AI生成两种不同类型的算法分数，增量分数和影响分数。 影响分数是每个营销接触点负责的转化率部分。 增量分数是营销接触点直接造成的边际影响的数量。 增量分数和影响分数之间的主要区别在于，增量分数将基线效应考虑在内。 它并不认为转化完全由先前的营销接触点引起。
以下快速查看Adobe Experience Platform UI中的Attribution AI架构输出示例：
有关每个归因分数的更多详细信息，请参阅下表：
| 归因分数 | 描述 |
|---|---|
| 影响（算法） | 影响分数是每个营销接触点负责的转化率部分。 |
| 增量（算法） | 增量分数是营销接触点直接造成的边际影响的数量。 |
| 首次接触 | 基于规则的归因得分，将所有信用分配给转化路径上的初始接触点。 |
| 最后接触 | 基于规则的归因得分，将所有信用分配给最接近转化的接触点。 |
| 线性 | 基于规则的归因得分，将相等的点数分配给转化路径上的每个接触点。 |
| U 型 | 基于规则的归因得分，将40%的信用分配给第一个接触点，将40%的信用分配给最后一个接触点，其他接触点平分剩余的20%。 |
| 时间衰减 | 基于规则的归因得分，其中距离转化较近的接触点比距离转化较远的接触点获得更多的点数。 |
原始得分参考（归因得分）
下表将归因分数映射到原始分数。 如果您希望下载原始分数，请访问 在Attribution AI中下载分数 文档。
| 归因分数 | 原始得分引用列 |
|---|---|
| 影响（算法） | _tenantID.your_schema_name.element.touchpoint.algorithmicInffected |
| 增量（算法） | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.algorithmicInffected |
| 首次接触 | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.firstTouch |
| 最后接触 | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.lastTouch |
| 线性 | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.linear |
| U 型 | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.uShape |
| 时间衰减 | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.decayUnits |
汇总分数
如果日期范围少于30天，则可以从Platform UI以CSV格式下载汇总分数。 有关每个聚合列的更多详细信息，请参阅下表。
| 列名称 | 约束 | 可为空 | 描述 |
|---|---|---|---|
| customerevents_date (DateTime) | 用户定义的固定格式 | False | 客户事件日期，格式为YYYY-MM-DD。 示例：2016-05-02 |
| mediatouchpoints_date (DateTime) | 用户定义的固定格式 | True | YYYY-MM-DD格式的媒体接触点日期 示例：2017-04-21 |
| 区段（字符串） | 已计算 | False | 转化区段，例如构建模型所针对的地理分段。 如果缺少区段，则区段与conversion_scope相同。 示例： ORDER_AMER |
| conversion_scope（字符串） | 用户定义 | False | 用户配置的转换的名称。 示例：订单 |
| touchpoint_scope（字符串） | 用户定义 | True | 用户配置的接触点名称 示例：PAID_SEARCH_CLICK |
| product (String) | 用户定义 | True | 产品的XDM标识符。 示例：抄送 |
| product_type（字符串） | 用户定义 | True | 在此产品视图中向用户显示的产品显示名称。 示例：gpu，笔记本电脑 |
| geo（字符串） | 用户定义 | True | 进行转换的地理位置(placeContext.geo.countryCode) 示例：美国 |
| event_type（字符串） | 用户定义 | True | 此时间序列记录的主要事件类型 示例：付费转化 |
| media_type（字符串） | 枚举 | False | 描述媒体类型是付费媒体、自有媒体还是免费媒体。 示例：付费，拥有 |
| channel（字符串） | 枚举 | False | 此 channel._type 属性用于为具有类似属性的渠道提供粗略分类 Consumer Experience Event XDM。 示例：搜索 |
| 操作（字符串） | 枚举 | False | 此 mediaAction 属性用于提供一种体验事件媒体操作。 示例：单击 |
| campaign_group（字符串） | 用户定义 | True | 将多个营销活动组合在一起的营销活动组的名称，如“50%_DISCOUNT”。 示例：商业 |
| campaign_name（字符串） | 用户定义 | True | 用于标识营销活动的活动名称，如“50%_DISCOUNT_USA”或“50%_DISCOUNT_ASIA”。 示例：感恩节优惠 |
原始得分参考（汇总）
下表将汇总分数映射到原始分数。 如果您希望下载原始分数，请访问 在Attribution AI中下载分数 文档。 要从UI中查看原始得分路径，请访问 查看原始得分路径 在此文档中。
| 列名称 | 原始得分引用列 |
|---|---|
| customerevents_date | timestamp |
| mediatouchpoints_date | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.timestamp |
| segment（区段） | _tenantID.your_schema_name.segmentation |
| conversion_scope | _tenantID.your_schema_name.conversion.conversionName |
| touchpoint_scope | _tenantID.your_schema_name.touchpointsDetail.element.touchpointName |
| product | _tenantID.your_schema_name.conversion.product |
| product_type | _tenantID.your_schema_name.conversion.product_type |
| 地域 | _tenantID.your_schema_name.conversion.geo |
| event_type | 事件类型 |
| media_type | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.mediaType |
| channel | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.mediaChannel |
| 操作 | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.mediaAction |
| campaign_group | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.campaignGroup |
| campaign_name | _tenantID.your_schema_name.touchpointsDetail.element.touchpoint.campaignName |
- Attribution AI仅使用更新的数据进行进一步的训练和评分。 同样，当您请求删除数据时，客户人工智能会禁止使用已删除的数据。
- Attribution AI可利用Platform数据集。 为了支持品牌可能收到的消费者权利请求，品牌应使用平台Privacy Service提交消费者访问和删除请求，以通过数据湖、身份服务和实时客户配置文件删除他们的数据。
- 我们用于模型输入/输出的所有数据集都将遵循Platform准则。 Platform Data Encryption适用于静态和传输中的数据。 请参阅文档以了解有关 数据加密
后续步骤
准备好数据并准备好所有凭据和架构后，请按照以下步骤开始 Attribution AI用户指南. 本指南将指导您完成创建Attribution AI实例。
Business.Adobe.com 资源
