# 合作伙伴发布者标签实施

本文说明如何使用发布者标签（Publisher tag），它是一段可添加到您网站的 JavaScript 代码片段。发布者标签会将您网站上相关的直接链接转换为跟踪链接，并在用户每次加载页面时跟踪展示次数。该 [基本集成](#section-idm234420645737758) 提供下面的前两个功能，而 `identifyUser` 集成提供第三个功能：

* **转换链接** — 当与您的网页一起加载时，发布者标签会检测您用于将流量发送到所合作品牌着陆页的任何直接链接，并自动将其转换为 impact.com 跟踪链接。当用户点击这些链接时，您将因由该流量产生的任何行为获得归因。
* **展示追踪** — 发布者标签还会在每次加载页面时为您转换后的链接计数展示次数，这些数据可以在 impact.com 中作为报告查看。要使此功能生效，您所合作的品牌需要在其 impact.com 帐户中启用此功能。
* **identifyUser 集成** — 发布者标签可以追踪额外的信息，例如流量信息，以实现更准确的转化路径报告。

#### 发布者标签放置位置

根据您希望如何使用发布者标签，它可以放置在：

* 广告代码 `<head>` 您网页的 标签 — <mark style="color:$success;">**\[推荐]**</mark> 将代码放置在每个您希望其运行的网页的 `<head>` 的底部。
* 广告代码 `<body>` 您网页的 标签 — 将代码放在 `<body>` 的底部。
* 广告代码 **网站的头部模板** 中 — <mark style="color:$success;">**\[推荐]**</mark> 如果您希望其在您所有网页上自动运行，请将代码放在您的 **网站的头部模板** 的底部。

#### 复制发布者标签

1. 从顶部导航栏，选择 **内容 →** [广告工具](https://app.impact.com/secure/mediapartner/fr/ads/mp-ad-tools-flow.ihtml).
2. 广告代码 *发布者标签* 在右侧代码片段下的 部分中，选择 **复制标签** 将代码复制到剪贴板。

   <div data-with-frame="true"><figure><img src="https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-856c8e6c600b43419719ad1f6edae1322fcfeddd%2F6b43028dda27cea5fa3622cf1094dca7146e150b702f6528450f72cf92582a67.png?alt=media" alt=""><figcaption></figcaption></figure></div>

#### 使用基本集成安装发布者标签

安装发布者标签的过程取决于您的网站是本地托管、由 CMS 托管，还是使用标签管理器而有所不同。

{% tabs %}
{% tab title="本地托管" %}
如果您直接管理网站代码，而不是将其托管在 CMS 或网站平台上，请使用此方法。

1. 打开您要安装发布者标签的网页的源代码。
2. 在网页代码中，找到顶部的 `<head>` 起始标签。
3. 将整个发布者标签代码粘贴到 部分的末尾，确保所有内容都位于 `</head>` 结束标签之前。
4. 对您希望发布者标签运行的每个网页重复此操作。
   {% endtab %}

{% tab title="由 CMS 托管" %}
如果您使用内容管理系统（CMS）或第三方网站平台（如 Wordpress、Squarespace、Wix 等），请查阅它们的帮助文档了解如何将 JavaScript 标签添加到您的网站。快速的网络搜索应能找到关于如何为您特定 CMS 安装 JavaScript 标签的一些结果。示例见下：

* [Wordpress：Header and Footer Scripts 插件](https://wordpress.org/plugins/header-and-footer-scripts/) &#x20;
* [Squarespace：使用代码注入（Code Injection）](https://support.squarespace.com/hc/en-us/articles/205815908) &#x20;
* [Wix：关于跟踪工具和分析](https://support.wix.com/en/article/about-tracking-tools-analytics)
  {% endtab %}

{% tab title="标签管理器" %}
如果您为网站使用标签管理系统（TMS），则需要向网站添加自定义 HTML 标签。请参阅标签管理器的帮助文档了解如何操作。例如：

* [Google Tag Manager — 自定义标签](https://support.google.com/tagmanager/answer/6107167?hl=en\&ref_topic=3002579)
  {% endtab %}
  {% endtabs %}

#### 测试您的基本集成

在您将发布者标签代码片段安装到网站后，应测试该集成以确保其正常工作。使用浏览器的开发者控制台检查链接转换和展示追踪功能是否正常运行。

<details>

<summary>检查您网站的链接 </summary>

1. 将鼠标悬停在链接上，右键点击并选择以打开浏览器的开发者控制台，随后选择 **检查（Inspect）** （或 **检查元素（Inspect Element）**).
   * 检查 位于 `<a href=””>` 引号内的链接是否看起来像 impact.com 的跟踪链接（例如， `https://advertiser.sjv.io/` ).
2. 或者，您也可以将鼠标悬停在网页上的链接上。大多数浏览器会在左下角的状态栏中显示链接路径。该链接应看起来像 impact.com 的跟踪链接（例如， `https://advertiser.sjv.io/` 或类似）。

</details>

<details>

<summary>检查展示追踪 </summary>

{% hint style="info" %}
**注意：** 如果您使用 Safari，请确保从顶部菜单启用 *状态* 状态栏。选择 **查看 → 显示状态栏（View → Show Status Bar）** （或在键盘上按住 ![](https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-b0dd5c5d459bb640d554d4838bb3b47cb68a09d8%2F1988705e47c39af922ad3c11b684e1563c37312eafa93bba6c3d46d8fb32152c.svg?alt=media) **［Command］ +** **/［斜线］**).
{% endhint %}

1. 将鼠标悬停在链接上，右键点击并选择以打开浏览器的开发者控制台，随后选择 **检查（Inspect）** （或 **检查元素（Inspect Element）**).
2. 在浏览器的开发者控制台中，选择 **网络** 选项卡。刷新页面以捕获最新数据。
   * 在 下的列表中，检查是否有 *类型*xhr `beacon` 或 `已发送且其状态为` 或者，您也可以在您的 `200`.
3. 选项卡中搜索。该行项目的格式为 **合作伙伴 ID** 在 *网络* {trackingdomain}/i/partnerId/adId/campaignId `并带有一个` 类型（Type）为 `beacon` 或 `已发送且其状态为` 且状态（Status）为 `200`.

</details>

#### 使用 identifyUser 安装发布者标签

{% hint style="warning" %}
**注意！** 高级集成需要具备技能的 Web 开发人员，他们需要理解此集成如何更改脚本以及该函数的含义。我们 **强烈建议** 在尝试此集成之前咨询开发人员。
{% endhint %}

使用 以下方式集成 `identifyUser` 是推荐的方法，因为通过 提交经过身份验证的用户数据可以改善归因。 `identifyUser` 函数也会捕获非个人身份识别信息（非 PII）。

该 `identifyUser` 第 1 步：修改脚本

{% stepper %}
{% step %}

#### **在发布者标签主体中其他函数调用之前添加以下代码行：**&#x20;

1. 将以下代码行添加到发布者标签主体中，放在其他函数调用之前：

   ```programlisting
   impactPublisher('identifyUser', {properties}, {options});
   ```
2. 添加新代码后，完整标签将类似于：

   ```programlisting
   <script type="text/javascript">
       (function(a,b,c,d,e,f,g){e['ire_o'] = c;e[c] = e[c] || function(){(e[c].a = e[c].a||[]).push(arguments)};f = d.createElement(b);g = d.getElementsByTagName(b)[0];f.async = 1;f.src = a;g.parentNode.insertBefore(f,g);})('//d.impactradius-event.com/<UNIQUE_ID>.js','script','impactPublisher',document,window);
       impactPublisher('identifyUser', {properties}, {options});
       impactPublisher('transformLinks', {properties}, {options [augmentLinksOnly, addImpressions]});
       impactPublisher('trackImpression', {properties}, {options});
       impactPublisher('trackLinks');
   </script>
   ```

{% endstep %}

{% step %}

#### **第 2 步：安装脚本**&#x20;

修改脚本后，您可以按照 [基本集成说明](#section-idm234420645737758) 来安装该脚本。
{% endstep %}

{% step %}

#### **第 3 步：测试您的 identifyUser 集成**&#x20;

在您将发布者标签代码片段安装到网站后，应测试它以确保其正常工作。测试高级集成需要了解如何动态传递 `partnercustid` 或 `customeremail` 变量。

配置完成后，在浏览器开发者控制台的 *网络* 选项卡中检查是否有 `partnercustid={passedid}` 和 `customeremail={passedemail}`.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**注意：** 有关发布者标签的更多信息，请阅读 [发布者标签常见问题（Publisher Tag FAQ）](https://app.gitbook.com/s/wMLlMoFBtKJa8ptd3zaw/what-would-you-like-to-learn-about/platform-features/tracking/tracking-explained/publisher-tag-faq)。如果您不确定如何完成本文中提到的任何步骤， [联系支持](https://app.impact.com/support/portal.ihtml?createTicket=true).
{% endhint %}
