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

当您在 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.impact.com/brand/zh/nin-xiang-liao-jie-shen-me/account-administration/account-settings/send-data-to-impactcom/import-aggregate-performance-data-from-other-networks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.