このガイドは、商品の閲覧、カートへの追加、チェックアウトなどのeコマースイベントを受信するData Layerを備えたGoogle Tag Manager (GTM)アカウントをお持ちであることを前提としています。
また、このガイドは、タグ、トリガー、変数、Data LayerといったGTMのコア概念に精通していることも前提としています。 このガイドでは、GTMにデータを提供するためのData Layerの構成方法については説明しません。
Shopifyサイトをお持ちの場合は、代わりにAppLovin Shopifyアプリと連携してください。
開始する前に、GTMの設定がサイトのすべてのページで機能することを確認してください。
ただし、サイトがヘッドレスモードでShopifyを実行している場合は、チェックアウトページでのイベントをキャプチャするために、必ずShopifyアプリをインストールしてください。 Shopifyのヘッドレス設定の場合:
Google Tag Managerアカウントにログインします。 ウェブサイトのコンテナをクリックし、タグの下にある新規をクリックします。 タグの設定で、カスタムHTMLを選択します。 「AppLovin—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>
トリガーの下をクリックし、Initialization - All Pages(初期化 - すべてのページ)を選択します。 これにより、AppLovin pixelがすべてのページで読み込まれるようになります。 保存をクリックします。
AppLovin pixelは、サイトの各ページで読み込まれ、初期化される必要があります。 イベントを送信する各ページで、GTMのInitialization - All Pages Triggerが配信されることを確認してください。
購入フロー:
最低限、page_view、view_item、add_to_cart、begin_checkout、purchaseイベントを提供してください。
また、サイトでこれらのイベントを使用している場合は、sign_upまたはloginも含めてください。
リード獲得フロー:
最低限、page_viewおよびgenerate_leadイベントを提供してください。
eコマースイベントの発生をAppLovinに送信するには、次の構文を使用します。 各イベントは、Data Layerで対応するイベントが発生したときにトリガーされる必要があります。
<script>
axon("track", «event-name», «event-data»);
</script>
| 名前 | タイプ | 説明 |
|---|---|---|
event_name | string | このイベントの名前。利用可能なイベントについては、AppLovin pixelのイベントとオブジェクトを参照してください。 |
event_data | object | このイベントのデータ。送信するデータについては、AppLovin pixelのイベントとオブジェクトを参照してください。(注意: page_viewでevent_dataを送信する必要はありません。) |
すべてのイベントでevent_name引数が必要です。
page_viewを除く各イベントには、以下のイベントセクションで説明する特定のevent_dataも必要です。
GTMでイベントを設定するには、次の2つの方法があります。
event_dataを必要とする各イベントについて、AppLovinはペイロードとなるGTM変数を作成することを推奨します。
例えば、
<script>
axon("track", "add_to_cart", {{Axon - Add To Cart}} );
</script>
(ここで{{Axon - Add To Cart}}は作成したGTM変数です)。
複数の変数で構成されるオブジェクトを作成することもできます。 例えば:
<script>
axon("track", "add_to_cart",
{
"currency": "USD",
"value": {{Axon - Add To Cart - Value}},
"items": {{Axon - Add To Cart - Items}}
}
)
</script>
AppLovin pixelはGoogle Analytics 4 (GA4) APIと互換性があります。
Data LayerがGA4形式でデータを保存するように設定されている場合は、それらのData Layer変数をタグ自体に直接渡すことができます。
例えば、{{GA - Ecommerce}}がGA4のように設定されたData Layerのeコマースフィールドを参照している場合、以下のように直接pixelに渡すことができます。
<script>
axon("track", "add_to_cart", {{GA - Ecommerce}} );
</script>
これにより、中間変数を作成する手間を省くことができます。
Data LayerがGA4のように設定されていない場合は、AppLovin pixel用の新しい変数を作成する必要がある場合があります。
AppLovin pixelは、ユーザーを識別するためにファーストパーティクッキー_axwrtを設定します。
ウェブサイトへのその後の各リクエストには、このクッキーが含まれます。
ユーザー識別を強化するために、AppLovinはサイトのバックエンドで以下を行うことを強く推奨します。
HTTPリクエストでクッキー_axwrtを検出したときはいつでも、有効期限が1年の新しいファーストパーティHTTPクッキーaxwrt(アンダースコアを削除したもの)を設定するヘッダーをHTTPレスポンスに含めるように設定します。
mysite.comの場合、ドメイン属性は.mysite.comにする必要があります。
注意:「www」は含めないでください。/にする必要があります。HttpOnlyに設定しないでください。例えば、クッキー_axwrtの値がxxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxxであるHTTPリクエストをサイトが受信した場合、レスポンスに次のヘッダーを追加します。
Set-Cookie: axwrt=xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx;
Expires=«One Year from Today»; Domain=«.mysite.com»; Path=/; SameSite=Lax;