Axon Pixel Google タグ マネージャーとの連携
このガイドでは、Google タグ マネージャー(GTM)アカウントを保有し、「商品の閲覧」、「カートに追加」、「チェックアウト」などのEコマースイベントを受信するデータレイヤーを設定済みであることを前提としています。
このガイドでは、タグ、トリガー、変数、データレイヤーなどといったGTMの基本的な概念について理解していることも前提としています。なお、本ガイドでは、GTMにデータを渡すためのデータレイヤーの設定方法については説明していません。
Axon Pixelをインストール
-
Google タグ マネージャアカウントにログインします。 Webサイトのコンテナをクリックし、TagsでNew をクリックします。 Tag Configurationで、Custom HTMLを選択します。「Axon — Init」などの名前を入力します。
-
次のコードをコピーし、タグに貼り付けます。 «your-event-key» を、AppLovinアカウントで取得したキーに置き換えます。
<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> -
Triggeringをクリックして、Initialization - All Pagesを選択します。 これにより、すべてのページでAxon Pixelがロードされるようになります。 Saveをクリックします。
Axon Pixelでイベントをトラッキング
EコマースイベントをAxonに送信するには、次の構文を使用してください。各イベントは、対応するイベントがデータレイヤーで発生したタイミングでトリガーする必要があります。
<script> axon("track", «event-name», «event-data»);</script>
パラメーター
名前 | タイプ | 説明 |
---|---|---|
event_name | 文字列 | このイベントの名前。利用可能なイベントについては、Axon Pixelイベントとオブジェクトを参照してください。 |
event_data | オブジェクト | このイベントのデータ。送信するデータについては、Axon Pixelイベントとオブジェクトを参照してください。注: page_view でevent_data を送信する必要はありません。 |
すべてのイベントにはevent_name
引数が必要です。
page_view
を除くイベントには、特定のevent_data
も必須となります。以下にある各イベント固有のセクションをご覧ください。
Axon Pixelにデータを送信
GTMでイベントを表示するには、次の2つの方法があります。
方法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は、Webサイトへのすべてのリクエストに自動的に送信されます。ユーザー識別の精度を高めるために、AppLovinでは以下の処理をサイトのバックエンドで実装することを強く推奨しています。
HTTPリクエスト内にクッキー_axwrt
が含まれている場合は、HTTPレスポンスにヘッダーを追加し、axwrt
(アンダースコアを除く)のファーストパーティクッキーを新たに設定してください。このクッキーには、1 年間の有効期限を指定します。
- この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;