> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/import-aggregate-performance-data-from-other-networks.md).

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

当你加入 impact.com 时，你可能在其他网络或平台上已有想要导入的汇总绩效数据。绩效数据可让你随时间监控并比较你的项目表现。impact.com 提供了一个灵活的解决方案，可从任何网络或平台导入汇总绩效数据。

## 前提条件

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

## 最佳实践

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

{% stepper %}
{% step %}

### 表数据映射

创建一个新的 .csv 文件，并添加与数据列相匹配的标题。请参见下面的示例 CSV，以了解 .csv 文件内容可能是什么样子。

<pre class="language-programlisting"><code class="lang-programlisting"><strong>子账户名称,折扣,收入,数量,广告ID,成本,引用URL,广告名称,广告活动ID,事件日期时间开始,操作系统,设备类型,事件类型,媒体值1,事件日期时间结束,产品类别,活动ID,媒体ID
</strong>"某合作伙伴",0.00,58.49,1,13564977,3.41,http://www.partner.com/email/onlineversion.jsp?dh_ABDA1546291792698~1,"有线方案",1554194,"2019-01-01 05:02:39 EST","Windows 10",桌面,item_sale,,"2019-01-01 23:59:59 EST",手机,15973,5343
"某合作伙伴",0.00,99.99,1,13564977,7.62,http://www.partner.com/email/onlineversion.jsp?dh_ABDA1546291792698~1,"有线方案",1554194,"2019-01-01 07:04:23 EST","Windows 10",桌面,item_sale,2661135,"2019-01-01 23:59:59 EST",手机,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>推广活动 ID</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>跳出</td><td>整数</td><td>有条件地</td><td>由第三方平台跟踪的、邮件发生退回的订阅者数量。</td></tr><tr><td>通话数</td><td>整数</td><td>有条件地</td><td>通话数量。</td></tr><tr><td>点击</td><td>整数</td><td>有条件地</td><td>已展示广告的点击次数。</td></tr><tr><td>转化</td><td>整数</td><td>有条件地</td><td>该广告产生的转化次数。</td></tr><tr><td>ConversionsRejected</td><td>整数</td><td>有条件地</td><td>验证后被拒绝的转化次数。</td></tr><tr><td>成本</td><td>小数</td><td>有条件地</td><td>成本值。</td></tr><tr><td>送达数</td><td>整数</td><td>有条件地</td><td>在广告活动期间，通过第三方平台投递给消费者的电子邮件或直邮数量。</td></tr><tr><td>折扣</td><td>小数</td><td>有条件地</td><td>折扣值。</td></tr><tr><td>展示次数</td><td>整数</td><td>有条件地</td><td>已展示广告的展示次数。</td></tr><tr><td>利润</td><td>小数</td><td>有条件地</td><td>默认或已批准操作的金额字段，计算公式为销售金额 - 商品成本。</td></tr><tr><td>OfferClicks</td><td>整数</td><td>有条件地</td><td>优惠点击次数。</td></tr><tr><td>打开数</td><td>整数</td><td>有条件地</td><td>消费者通过第三方平台在该活动中打开的电子邮件数量。</td></tr><tr><td>PageLikes</td><td>整数</td><td>有条件地</td><td>页面点赞数。</td></tr><tr><td>收入</td><td>小数</td><td>有条件地</td><td>收入值。</td></tr><tr><td>发送数</td><td>整数</td><td>有条件地</td><td>在广告活动期间，通过第三方平台发送给消费者的电子邮件或直邮数量。</td></tr><tr><td>SocialUniqueViewers</td><td>整数</td><td>有条件地</td><td>社交观看者数量。</td></tr><tr><td>广告位</td><td>整数</td><td>有条件地</td><td>第三方广告位。</td></tr><tr><td>取消订阅数</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>事件类型的唯一标识符（以前称为操作跟踪器）。</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>广告 ID</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>浏览器</td><td>字符串</td><td>否</td><td>设备浏览器，例如 Safari 或 Firefox。</td></tr><tr><td>城市</td><td>字符串</td><td>否</td><td>投放广告时用户所在的城市。</td></tr><tr><td>国家</td><td>字符串</td><td>否</td><td>投放广告时用户所在的国家。</td></tr><tr><td>客户邮箱</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>方式</td><td>字符串</td><td>否</td><td>用于插入记录的机制。常用的方法有 <em>插入</em>, <em>更新</em>, <em>将</em>，或 <em>删除</em>.</td></tr><tr><td>金额1</td><td>小数</td><td>否</td><td>杂项货币参数。</td></tr><tr><td>金额2</td><td>小数</td><td>否</td><td>杂项货币参数。</td></tr><tr><td>金额3</td><td>小数</td><td>否</td><td>杂项货币参数。</td></tr><tr><td>MSA</td><td>字符串</td><td>否</td><td>Metropolitan Statistical Area 的缩写：广告投放时用户所在的大都市区。</td></tr><tr><td>数值1</td><td>整数</td><td>否</td><td>杂项数值参数。</td></tr><tr><td>数值2</td><td>整数</td><td>否</td><td>杂项数值参数。</td></tr><tr><td>数值3</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>数量</td><td>整数</td><td>否</td><td>广告中提供的产品数量。</td></tr><tr><td>引荐域名</td><td>字符串</td><td>否</td><td>进行引荐的域名。</td></tr><tr><td>ReferringURL</td><td>字符串</td><td>否</td><td>引荐 URL。</td></tr><tr><td>地区</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>文本1</td><td>字符串</td><td>否</td><td>杂项文本参数。</td></tr><tr><td>文本2</td><td>字符串</td><td>否</td><td>杂项文本参数。</td></tr><tr><td>文本3</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>

**\***&#x81F3;少应包含一个标记为 *有条件地* 必填的列。

</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] → 合作伙伴 → 合作伙伴**.
2. 通过选择以下选项上传自定义合作伙伴映射 **批量编辑** 在右上角。了解更多关于 [自定义合作伙伴映射](/brand/zh/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/assign-custom-tracking-values-to-partners.md).

<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%2FRaOrVAstmTBOzraeDOfB%2FUntitled%20design%20(1).png?alt=media&amp;token=b486fded-0351-4e70-8df5-36bba301047a" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### 发送文件

1. 按照以下步骤： [创建数据上传连接](/brand/zh/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/create-a-data-upload-connection.md) 以创建 SFTP 连接。
   * 为历史绩效数据设置连接时，应选择的数据类型是 `aggregate_performance_data`.
   * 在……期间选择的汇总绩效时区 *其他设置* 步骤无关，应忽略。
2. 在上传你的 CSV 文件之前，请联系 [支持](https://app.impact.com/support/portal.ihtml) 并与 impact.com 实施工程师合作以验证该文件。
   {% endstep %}
   {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/import-aggregate-performance-data-from-other-networks.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
