events
ディメンションと指標は、レポートにとって重要な要素です。events
変数は、サイト上の多くの指標のデータ収集を行います。イベントは、通常、レポートで指標を増分します。
イベントを実装する前に、レポートスイートの設定の「成功イベント」で、成功イベントを作成し、設定していることを確認してください。リンクトラッキングのヒットでカスタムイベントを使用する予定がある場合は、linkTrackVars
と linkTrackEvents
が正しく設定され ていることを確認してください。
Web SDK を使用したイベント
XDM オブジェクトを使用する場合、カスタムイベントでは次の XDM フィールドを使用します。
- カスタムイベント 1 ~ 100 は、
xdm._experience.analytics.event1to100.event1
~xdm._experience.analytics.event1to100.event100
にマッピングされます。 - カスタムイベント 101 ~ 200 は、
xdm._experience.analytics.event101to200.event100
~xdm._experience.analytics.event101to200.event200
にマッピングされます。 - このパターンは、
xdm._experience.analytics.event901to1000.event901
~xdm._experience.analytics.event901to1000.event1000
まで、100 イベントごとに繰り返されます。eventx.value
は、増分量を指定するために使用されます。eventx.id
は、シリアル化に使用されます。 - 注文件数は、
xdm.commerce.purchases.value
にマッピングされます。 - 単位は、すべての
productListItems[].quantity
フィールドの合計にマッピングされます。 - 売上高は、すべての
productListItems[].priceTotal
フィールドの合計にマッピングされます。 - 製品表示は、
xdm.commerce.productViews.value
にマッピングされます。 - 買い物かごは、
xdm.commerce.productListOpens.value
にマッピングされます。 - 買い物かごへの追加は、
xdm.commerce.productListAdds.value
にマッピングされます。 - 買い物かごからの削除は、
xdm.commerce.productListRemovals.value
にマッピングされます。 - 買い物かご表示は、
xdm.commerce.productListViews.value
にマッピングされます。 - チェックアウトは、
xdm.commerce.checkouts.value
にマッピングされます。
productListItems
に設定され(例えば、productListItems._experience.analytics.event1.value
)、そのイベントがまだこのフィールドにない場合、そのイベントは、このフィールドに自動的に追加されます。data オブジェクト を使用する場合、すべてのイベントで data.__adobe.analytics.events
を使用します。次のAppMeasurement文字列構文に従います。 このフィールドを設定すると、XDM オブジェクトで設定されたイベントが上書きされ、Adobe Analyticsに送信されません。
Adobe Analytics 拡張機能を使用したイベント
イベントは、Analytics 拡張機能の設定時(グローバル変数)またはルールで設定できます。
- Adobe ID 資格情報を使用して、Adobe Experience Platform Data Collection にログインします。
- 目的のタグプロパティをクリックします。
- 「ルール」タブに移動し、目的のルールをクリックします(またはルールを作成します)。
- 「アクション」で、既存の「Adobe Analytics - 変数を設定」アクションをクリックするか、「+」アイコンをクリックします。
- 「 拡張機能 」ドロップダウンリストをAdobe Analyticsに設定し、「 アクションタイプ 」を 変数を設定 に設定します。
- イベントセクションを見つけます。
次の機能が利用できます。
- 含めるイベントを選択できるドロップダウンリスト
- シリアル化用のオプションのテキストフィールドです。イベントのシリアル化を参照してください。
- イベント値のオプションのテキストフィールドです。通貨イベントには通貨を、通貨イベント以外のイベントには整数を含めて、通貨イベントを複数回増やすことができます。例えば、ドロップダウンリストの下の「
event1
」を選択し、このフィールドに「10
」を含めると、レポートでは 10 ずつevent1
増します。 - 別のイベントを追加するボタン。単一のルールに、無理のない範囲で好きなだけイベントを追加できます。
AppMeasurement および Analytics 拡張機能のカスタムコードエディターの s.events
s.events
変数は、ヒットに含めるイベントのコンマ区切りリストを含む文字列です。この変数を使用すると、最大 64k バイトを格納でき、実質的にはヒットの必要な数だけイベントを発生させることができます。 有効な設定値は以下のとおりです。
event1
~event1000
:カスタムイベントを設定します。組織のソリューションデザインドキュメントに各イベントの使用方法を記録します。使用可能なイベントの数は、組織の Analytics 契約によって異なります。レガシー契約以外の組織のほとんどは、1,000 件のカスタムイベントを利用できます。使用できるカスタムイベントの数が不明な場合は、Adobeアカウントチームにお問い合わせください。purchase
:「注文件数」指標を 1 増分し、products
変数に設定された値を使用して「単位」と「売上高」を計算します。詳しくは、購入イベントを参照してください。prodView
:「製品表示回数」指標を増分します。scOpen
:「買い物かご」指標を増分します。scAdd
:「買い物かごへの追加件数」指標を増分します。scRemove
:「買い物かごからの削除件数」指標を増分します。scView
:「買い物かご表示回数」指標を増分します。scCheckout
:「チェックアウト数」指標を増分します。
// Set the events variable to a single value
s.events = "event1";
// Set the events variable to multiple values
s.events = "event1,event13,purchase";
カウンターイベントを複数回増分します
必要に応じて、カスタムイベントを複数回カウントできます。文字列内の目的のイベントに整数を割り当てます。レポートスイート設定で作成されたイベントは、デフォルトでカウンターイベントです。
// Count event1 ten times
s.events = "event1=10";
// Count event1 twice and event2 once
s.events = "event1=2,event2";
通貨イベントの使用
カスタムイベントを変更して、整数の代わりに通貨を使用できます。通貨イベントは、レポートスイートの通貨と currencyCode
変数が一致しない場合、レポートスイートの通貨に自動的に変換されます。配送費、割引、返金の計算に役立ちます。イベントをその製品のみに属性設定する場合は、products
変数に通貨イベントを設定できます。
通貨イベントを実装する前に、レポートスイートの設定の「成功イベント」で目的のイベントを「通貨」に設定してください。
// Send $9.99 USD in event1 using the events variable. Make sure the event type for event1 is Currency in Report suite settings
s.currencyCode = "USD";
s.events = "event1=9.99";
// Send $9.99 USD in event1 using the products variable. Make sure the event type for event1 is Currency in Report suite settings
s.currencyCode = "USD";
s.events = "event1";
s.products = "Example category;Example product;1;0;event1=9.99";
events
変数と products
変数の両方に通貨値を設定した場合、events
での通貨値が使用されます。events
変数と products
変数の両方で通貨値を設定しないでください。数値イベントの使用
整数の代わりに小数値を受け入れるカスタムイベントを変更できます。数値イベントは通貨イベントと同様に動作しますが、通貨コンバージョンを使用しない点が異なります。イベントをその製品のみに属性設定する場合は、products
変数に数値イベントを設定できます。
数値イベントを実装する前に、レポートスイート設定の「成功イベント」で、目的のイベントを「数値」に設定してください。
// Send 4.5 in event1 using the events variable. Make sure the event type for event1 is Numeric in Report suite settings
s.events = "event1=4.5";
// Send 4.5 in event1 using the products variable. Make sure the event type for event1 is Numeric in Report suite settings
s.events = "event1";
s.products = "Example category;Example product;1;0;event1=4.5";
events
変数と products
変数の両方に数値を設定した場合は、events
の数値が使用されます。events
変数と products
変数の両方に数値を設定しないでください。