跳转到内容

Axon Pixel × Google Tag Manager 集成指南

在本指南中,我们假设您拥有一个带有数据层 (Data Layer) 的 Google 跟踪代码管理器 (GTM) 账户,并可通过该账户接收电商事件信息,如产品查看、加入购物车和结账等。

此外,我们还假设您熟悉 GTM 的核心概念,包括跟踪代码 (Tags)、触发器 (Triggers)、变量 (Variables) 和数据层。对于如何设置数据层,以向 GTM 提供数据,本指南不做阐释。

安装 Axon Pixel

  1. 登入您的 Google 跟踪代码管理器账户。点击您网站的容器,然后找到 Tags,点击 New 。对于 Tag Configuration,请选择 Custom HTML。然后输入一个名称,例如 “Axon — Init”。

  2. 将以下代码复制并粘贴进您的跟踪代码中。注意将 “«your-event-key»” 替换为您的 AppLovin 账户中的 key。

    <script>
    var AXON_EVENT_KEY="«your-event-key»";
    !function(e,r){var t=["https://s.axon.ai/pixel.js","https://res4.applovin.com/p/l/loader.iife.js"];if(!e.axon){var a=e.axon=function(){a.performOperation?a.performOperation.apply(a,arguments):a.operationQueue.push(arguments)};a.operationQueue=[],a.ts=Date.now(),a.eventKey=AXON_EVENT_KEY;for(var n=r.getElementsByTagName("script")[0],o=0;o<t.length;o++){var i=r.createElement("script");i.async=!0,i.src=t[o],n.parentNode.insertBefore(i,n)}}}(window,document);
    axon("init");
    </script>
  3. 点击 Triggering,并选择其中的 Initialization - All Pages,确保 Axon Pixel 能在所有页面上加载。然后点击 Save 保存。

使用 Axon Pixel 跟踪事件

请使用以下语法向 Axon 发送电商事件。每个事件都应在其对应的事件出现在数据层中时触发。

<script>
axon("track", «event-name», «event-data»);
</script>

参数

名称类型描述
event_namestring该事件的名称。请参阅 Axon Pixel 事件和对象,了解可用的事件。
event_dataobject该事件的数据。请查看 Axon Pixel 事件和对象,了解可发送的数据。(请注意:发送 page_view 事件时不需要发送 event_data。)

所有事件都需要 event_name 参数。除 page_view 外,每个事件都需要特定 event_data,请在下方具体事件对应版块查阅描述。

将数据发送至 Axon Pixel

在 GTM 中填充事件的方法有两种:

方法 1:单一 GTM 变量

针对每个需要 event_data 的事件,AppLovin 建议您创建一个 GTM 变量作为数据负载。示例如下:

<script>
axon("track", "add_to_cart", {{Axon - Add To Cart}} );
</script>

(其中 {{Axon - Add To Cart}} 是您创建的 GTM 变量)。

方法 2:组合使用 GTM 变量

您也可以创建由多个变量组成的对象。示例如下:

<script>
axon("track", "add_to_cart",
{
"currency": "USD",
"value": {{Axon - Add To Cart - Value}},
"items": {{Axon - Add To Cart - Items}}
}
)
</script>

增强用户识别 (推荐)

Axon Pixel 会设置第一方 Cookie _axwrt 来识别用户身份。该 Cookie 会自动附加在发送至您网站的每个请求中。为了增强用户识别,AppLovin 强烈建议您在网站后端进行下列操作:

只要您在 HTTP 请求中看到 Cookie _axwrt时,请设置 HTTP 响应,使其包含一个标头。该标头应设置新的第一方 HTTP Cookie axwrt (不带下划线),有效期为一年。

  • 此 Cookie 的值应与请求中传递的相应 Cookie 值相同。
  • Cookie 的域名应当是您的站点,并以半角句点为前缀。例如,如果您的网站是 mysite.com,那么域名属性应为 .mysite.com。请注意:不要在域名中包含 “www”。
  • Cookie 的路径应为 /
  • 请勿将 Cookie 设置为 HttpOnly

例如,如果您的网站收到 HTTP 请求,请求中的 Cookie _axwrt 值为 xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx,那么就应当在响应中添加下列标头:

Set-Cookie: axwrt=xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx;
Expires=«One Year from Today»; Domain=«.mysite.com»; Path=/; SameSite=Lax;