# 从其他网络导入汇总绩效数据

当您在 impact.com 上完成入驻后，您可能会在其他网络或平台上有想要导入的汇总绩效数据。绩效数据可帮助您随时间监控并比较您的项目表现。impact.com 提供了一种灵活的解决方案，可从任何网络或平台导入汇总绩效数据。

#### 前提条件

* 仅支持汇总数据。不支持点击级或行为级数据。
* 在上传数据之前，您需要映射第三方数据并提供自定义映射。下面将介绍这些步骤。

#### 最佳实践

* 您必须以正确的格式添加数据。
* 在对映射的历史数据进行技术审核后，应先上传少量初始样本，通常为几十条到一百条记录。随后需要确认绩效报告准确无误，之后再进行实际的批量上传。
* 如果您需要回滚更改，应将原始文件按原样、未修改地上传到 *delete* 文件夹。
* 请确保最终数据文件的大小不超过 1 GB。

{% stepper %}
{% step %}

### 映射表数据

创建一个新的 .csv 文件，并添加与数据列相匹配的表头。请参阅下面的示例 CSV，以了解 .csv 文件内容的可能样式。

<pre class="language-programlisting"><code class="lang-programlisting"><strong>SubAccountName,Discount,Revenue,Quantity,AdId,Cost,ReferringURL,AdName,AdCampaignId,EventDateTimeStart,OperatingSystem,DeviceType,EventType,MediaValue1,EventDateTimeEnd,ProductCategory,CampaignId,MediaId
</strong>"Some Partner",0.00,58.49,1,13564977,3.41,http://www.partner.com/email/onlineversion.jsp?dh_ABDA1546291792698~1,"Wired Plans",1554194,"2019-01-01 05:02:39 EST","Windows 10",Desktop,item_sale,,"2019-01-01 23:59:59 EST",Phones,15973,5343
"Some Partner",0.00,99.99,1,13564977,7.62,http://www.partner.com/email/onlineversion.jsp?dh_ABDA1546291792698~1,"Wired Plans",1554194,"2019-01-01 07:04:23 EST","Windows 10",Desktop,item_sale,2661135,"2019-01-01 23:59:59 EST",Phones,15973
</code></pre>

将您平台或网络中的列映射到 CSV 中相应的列。有关支持的列标题的更多信息，请参阅 *列参考* 如下。

<details>

<summary>列参考</summary>

<table><thead><tr><th width="228.7734375">目标列名</th><th width="83.328125">类型</th><th width="139.15625">必填</th><th>说明</th></tr></thead><tbody><tr><td>CampaignId</td><td>整数</td><td>是</td><td>impact.com 的项目 ID。</td></tr><tr><td>EventDateTimeEnd</td><td>日期</td><td>是</td><td>与事件结束时间对应的日期时间，格式如下：yyyyMMddd hh:mm:ss z（例如：2023-10-18 23:59:59 EST）。</td></tr><tr><td>EventDateTimeStart</td><td>日期</td><td>是</td><td>与事件开始时间对应的日期时间，格式如下：yyyyMMddd hh:mm:ss z（例如：2023-10-18 09:23:67 EST）。</td></tr><tr><td>MediaId</td><td>整数</td><td>有条件：如果未提供 MediaValue1</td><td>与 impact.com 关联的合作伙伴唯一 ID。 </td></tr><tr><td>MediaValue1</td><td>字符串</td><td>有条件：如果未提供 MediaId</td><td>来自第三方合作伙伴的唯一标识符。此字段接受任何字母数字值。如果使用 MediaValue1，则该值必须进行映射。更多信息请参见 <a href="#conditional-upload-custom-partner-mappings"><em>自定义合作伙伴映射</em></a> 如下。</td></tr><tr><td>AvgViewsPerUniqueViewer</td><td>整数</td><td>条件性</td><td>每位唯一观看者的平均观看次数。</td></tr><tr><td>Bounces</td><td>整数</td><td>条件性</td><td>第三方平台跟踪到的发生邮件退回的订阅者数量。</td></tr><tr><td>Calls</td><td>整数</td><td>条件性</td><td>通话次数。</td></tr><tr><td>Clicks</td><td>整数</td><td>条件性</td><td>展示广告的点击次数。</td></tr><tr><td>Conversions</td><td>整数</td><td>条件性</td><td>该广告产生的转化次数。</td></tr><tr><td>ConversionsRejected</td><td>整数</td><td>条件性</td><td>验证后被拒绝的转化次数。</td></tr><tr><td>Cost</td><td>小数</td><td>条件性</td><td>成本值。</td></tr><tr><td>Delivers</td><td>整数</td><td>条件性</td><td>在广告活动期间，通过第三方平台送达给消费者的电子邮件或直邮数量。</td></tr><tr><td>Discount</td><td>小数</td><td>条件性</td><td>折扣值。</td></tr><tr><td>Impressions</td><td>整数</td><td>条件性</td><td>展示广告的曝光次数。</td></tr><tr><td>Margin</td><td>小数</td><td>条件性</td><td>默认或已批准行为的金额字段，计算方式为销售额 - 商品成本。</td></tr><tr><td>OfferClicks</td><td>整数</td><td>条件性</td><td>优惠点击次数。</td></tr><tr><td>Opens</td><td>整数</td><td>条件性</td><td>在该活动中，通过第三方平台被消费者打开的电子邮件数量。</td></tr><tr><td>PageLikes</td><td>整数</td><td>条件性</td><td>页面点赞数。</td></tr><tr><td>Revenue</td><td>小数</td><td>条件性</td><td>收入值。</td></tr><tr><td>Sends</td><td>整数</td><td>条件性</td><td>在广告活动期间，通过第三方平台发送给消费者的电子邮件或直邮数量。</td></tr><tr><td>SocialUniqueViewers</td><td>整数</td><td>条件性</td><td>社交观看者数量。</td></tr><tr><td>Spots</td><td>整数</td><td>条件性</td><td>第三方广告位。</td></tr><tr><td>Unsubscribes</td><td>整数</td><td>条件性</td><td>第三方平台跟踪到的取消订阅促销邮件或直邮的订阅者数量。</td></tr><tr><td>ViewThroughConversions</td><td>整数</td><td>条件性</td><td>查看后转化次数。</td></tr><tr><td>WebsiteClicks</td><td>整数</td><td>条件性</td><td>网站点击次数。</td></tr><tr><td>ActionTrackerId</td><td>整数</td><td>否</td><td>事件类型的唯一标识符（以前称为 action tracker）。</td></tr><tr><td>AdCampaignGroupId</td><td>整数</td><td>否</td><td>与第三方广告活动组关联的唯一 ID。</td></tr><tr><td>AdCampaignGroupName</td><td>字符串</td><td>否</td><td>第三方广告活动组的名称。广告活动组通过将多个活动捆绑在一起，简化活动管理。</td></tr><tr><td>AdCampaignId</td><td>整数</td><td>否</td><td>分配给第三方营销平台中该活动的唯一 ID。</td></tr><tr><td>AdCampaignName</td><td>字符串</td><td>否</td><td>第三方营销平台中每个活动对应的名称。</td></tr><tr><td>AdDistributionType</td><td>字符串</td><td>否</td><td>第三方广告投放渠道，例如 Google 搜索。</td></tr><tr><td>AdGroupId</td><td>整数</td><td>否</td><td>与第三方广告组关联的唯一 ID。</td></tr><tr><td>AdGroupName</td><td>字符串</td><td>否</td><td>触发点击的广告对应的第三方广告组名称。</td></tr><tr><td>AdId</td><td>字符串</td><td>否</td><td>第三方广告的 ID。</td></tr><tr><td>AdName</td><td>字符串</td><td>否</td><td>第三方平台中该广告的名称。</td></tr><tr><td>AdNetwork</td><td>字符串</td><td>否</td><td>投放该广告的第三方广告网络名称。</td></tr><tr><td>AdPlacement</td><td>字符串</td><td>否</td><td>触发点击的广告对应的第三方广告位。</td></tr><tr><td>AdPosition</td><td>字符串</td><td>否</td><td>您的广告在页面上相对于其他广告显示的顺序。</td></tr><tr><td>AdSize</td><td>字符串</td><td>否</td><td>广告尺寸。</td></tr><tr><td>AdType</td><td>字符串</td><td>否</td><td>第三方广告类型。</td></tr><tr><td>AuctionCost</td><td>小数</td><td>否</td><td>竞价成本。</td></tr><tr><td>AveragePosition</td><td>整数</td><td>否</td><td>描述您的广告通常相对于其他广告排名的统计值。此排名决定广告在页面上的显示顺序。</td></tr><tr><td>Browser</td><td>字符串</td><td>否</td><td>设备浏览器，例如 Safari 或 Firefox。</td></tr><tr><td>City</td><td>字符串</td><td>否</td><td>展示广告时用户所在的城市。</td></tr><tr><td>Country</td><td>字符串</td><td>否</td><td>展示广告时用户所在的国家/地区。</td></tr><tr><td>CustomerEmail</td><td>字符串</td><td>否</td><td>客户的电子邮件。</td></tr><tr><td>CustomerId</td><td>字符串</td><td>否</td><td>客户的第三方 ID。</td></tr><tr><td>CustomerSegment</td><td>字符串</td><td>否</td><td>分配给该客户的第三方细分。</td></tr><tr><td>DataCost</td><td>小数</td><td>否</td><td>数据成本。</td></tr><tr><td>DeviceName</td><td>字符串</td><td>否</td><td>设备名称。</td></tr><tr><td>DeviceType</td><td>字符串</td><td>否</td><td>广告投放到的设备类型。</td></tr><tr><td>EventName</td><td>字符串</td><td>否</td><td>第三方事件名称。</td></tr><tr><td>EventType</td><td>字符串</td><td>否</td><td>发生的事件类型。</td></tr><tr><td>ImpactAdId</td><td>整数</td><td>否</td><td>impact.com 广告的 ID。</td></tr><tr><td>Keyword</td><td>字符串</td><td>否</td><td>与搜索匹配的竞价关键词。</td></tr><tr><td>KeywordId</td><td>整数</td><td>否</td><td>与该竞价关键词关联的第三方竞价关键词 ID。</td></tr><tr><td>KeywordRelevance</td><td>字符串</td><td>否</td><td>您的广告活动元素与搜索关键词的匹配程度。</td></tr><tr><td>LandingPageRelevance</td><td>字符串</td><td>否</td><td>您的落地页元素与搜索关键词的匹配程度。</td></tr><tr><td>LandingPageURL</td><td>字符串</td><td>否</td><td>落地页的 URL。</td></tr><tr><td>LandingPageUserExperience</td><td>字符串</td><td>否</td><td>AdWords 使用的一项衡量指标，用于估计您网站落地页对点击您广告的用户有多相关、多有用。评分更高的落地页通常组织更清晰，并且包含与用户搜索词相关的文本。</td></tr><tr><td>MatchType</td><td>字符串</td><td>否</td><td>搜索引擎实现的匹配类型。</td></tr><tr><td>MaxCPC</td><td>整数</td><td>否</td><td>您在付费搜索平台中愿意为特定广告活动或广告支付的最高出价。</td></tr><tr><td>Method</td><td>字符串</td><td>否</td><td>用于插入记录的机制。常用方法包括 <em>Insert</em>, <em>Update</em>, <em>Replace</em>，或 <em>Delete</em>.</td></tr><tr><td>Money1</td><td>小数</td><td>否</td><td>一个杂项金额参数。</td></tr><tr><td>Money2</td><td>小数</td><td>否</td><td>一个杂项金额参数。</td></tr><tr><td>Money3</td><td>小数</td><td>否</td><td>一个杂项金额参数。</td></tr><tr><td>MSA</td><td>字符串</td><td>否</td><td>Metropolitan Statistical Area 的缩写：用户所在的大都市区，即广告投放所在区域。</td></tr><tr><td>Numeric1</td><td>整数</td><td>否</td><td>一个杂项数值参数。</td></tr><tr><td>Numeric2</td><td>整数</td><td>否</td><td>一个杂项数值参数。</td></tr><tr><td>Numeric3</td><td>整数</td><td>否</td><td>一个杂项数值参数。</td></tr><tr><td>OperatingSystem</td><td>字符串</td><td>否</td><td>设备的操作系统：iOS、Android、Windows、Mac。</td></tr><tr><td>Param1</td><td>字符串</td><td>否</td><td>一个杂项跟踪参数。</td></tr><tr><td>Param2</td><td>字符串</td><td>否</td><td>一个杂项跟踪参数。</td></tr><tr><td>Param3</td><td>字符串</td><td>否</td><td>一个杂项跟踪参数。</td></tr><tr><td>Param4</td><td>字符串</td><td>否</td><td>一个杂项跟踪参数。</td></tr><tr><td>PricingModel</td><td>字符串</td><td>否</td><td>所采用的定价模式。</td></tr><tr><td>ProductCategory</td><td>字符串</td><td>否</td><td>产品类别。</td></tr><tr><td>ProductCategoryId</td><td>整数</td><td>否</td><td>第三方产品类别 ID。</td></tr><tr><td>ProductId</td><td>字符串</td><td>否</td><td>点击广告中展示的产品 ID 或 SKU。</td></tr><tr><td>ProductSubCategory</td><td>字符串</td><td>否</td><td>产品子类别。</td></tr><tr><td>QualityScore</td><td>整数</td><td>否</td><td>广告质量的估计值。</td></tr><tr><td>Quantity</td><td>整数</td><td>否</td><td>广告中提供的产品数量。</td></tr><tr><td>ReferringDomain</td><td>字符串</td><td>否</td><td>发起引用的域名。</td></tr><tr><td>ReferringURL</td><td>字符串</td><td>否</td><td>引用 URL。</td></tr><tr><td>Region</td><td>字符串</td><td>否</td><td>展示广告时用户所在的地区。</td></tr><tr><td>SearchText</td><td>字符串</td><td>否</td><td>用户在搜索引擎中输入的搜索词。</td></tr><tr><td>SharedId</td><td>字符串</td><td>否</td><td>与广告主共享的跟踪值。</td></tr><tr><td>SubAccountId</td><td>整数</td><td>否</td><td>impact.com 平台上的子联盟或合作伙伴 ID。</td></tr><tr><td>SubAccountName</td><td>字符串</td><td>否</td><td>子联盟或合作伙伴名称。</td></tr><tr><td>SubId1</td><td>字符串</td><td>否</td><td>数据仓库报告中包含的跟踪值。</td></tr><tr><td>SubId2</td><td>字符串</td><td>否</td><td>数据仓库报告中包含的跟踪值。</td></tr><tr><td>SubId3</td><td>字符串</td><td>否</td><td>数据仓库报告中包含的跟踪值。</td></tr><tr><td>TargetMarketSize</td><td>字符串</td><td>否</td><td>目标市场规模。</td></tr><tr><td>Text1</td><td>字符串</td><td>否</td><td>一个杂项文本参数。</td></tr><tr><td>Text2</td><td>字符串</td><td>否</td><td>一个杂项文本参数。</td></tr><tr><td>Text3</td><td>字符串</td><td>否</td><td>一个杂项文本参数。</td></tr><tr><td>TrafficSource</td><td>字符串</td><td>否</td><td>付费搜索媒体合作伙伴流量来源。</td></tr><tr><td>TrafficType</td><td>字符串</td><td>否</td><td>流量类别或类型，用于 CPC/CPL/CPA。</td></tr><tr><td>UniqueClicks</td><td>整数</td><td>否</td><td>唯一点击次数。</td></tr><tr><td>UniquePeopleConverting</td><td>整数</td><td>否</td><td>转化的唯一人数。</td></tr><tr><td>UniqueViewers</td><td>整数</td><td>否</td><td>唯一观看者数量。</td></tr><tr><td>UserAgent</td><td>字符串</td><td>否</td><td>跟踪用户浏览器的 user agent 字符串。</td></tr></tbody></table>

![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) 至少应包含标记为 *条件性* 必填的列之一到您的文件中。

</details>
{% endstep %}

{% step %}

### （可选）上传自定义合作伙伴映射

{% hint style="warning" %}
**警告：** 在尝试上传数据之前，您应启用任何自定义合作伙伴映射。上传数据后再更新映射将不会产生任何效果。
{% endhint %}

如果您无法在数据中向 impact.com 提供合作伙伴 ID，则需要自定义合作伙伴映射。

1. 从左侧导航菜单中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Partners → Partners**.
2. 通过选择以下内容上传自定义合作伙伴映射 **Bulk Edit** 位于右上角。阅读更多关于 [自定义合作伙伴映射](https://help.impact.com/brand/zh/nin-xiang-liao-jie-shen-me/platform-features/tracking/set-up-tracking/assign-custom-tracking-values-to-partners).

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-90b0659aed7fa5e272b491f310474c39de8890d4%2Fcfeabebd2a7e0fcc725dc4e56426e4c11a3fff1daa51d96ed7a6a089ae0187ff.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### 发送文件

1. 按照以下步骤 [创建数据上传连接](https://help.impact.com/brand/zh/nin-xiang-liao-jie-shen-me/account-administration/account-settings/send-data-to-impactcom/create-a-data-upload-connection) 来创建 SFTP 连接。
   * 为历史绩效数据设置连接时，应选择的数据类型是 `aggregate_performance_data`.
   * 在 *Additional Setup* 步骤中选择的汇总绩效时区无关紧要，应忽略。
2. 在上传 CSV 文件之前，请联系 [支持](https://app.impact.com/support/portal.ihtml) 并与 impact.com 实施工程师合作验证文件。
   {% endstep %}
   {% endstepper %}