コンテンツにスキップ

マーケティングアトリビューションの使用

イベントとは、ゲームのインストール、ゲームの更新、アイテムの購入など、ユーザーがゲームをプレイしながら実行するすべての活動です。マーケティングアトリビューションは、これらのイベントログを収集し、サーバーに送信してユーザーの活動を追跡する機能です。マーケティングアトリビューションの追跡データは、さまざまな方法で分析および活用できます。例えば、ゲーム内で発生するレベルアップやアイテム強化などのイベントを追跡して、ユーザーの行動を予測し、ユーザーがゲームをより楽しめるように導くことができます。

Hive SDKを使用すると、ユーザーアプリへのユーザーエントリパスとユーザー活動を追跡できるサードパーティアプリマーケティングアトリビューションを使用できます。SDKでサポートされているサードパーティアプリマーケティングアトリビューションには、Adjust、Singular、AppsFlyer、Firebase Analytics、Airbridgeの5つのオプションがあります。

機能とサポート範囲

マーケティングアトリビューションで提供される機能は以下のとおりです:

  • 自動イベント追跡:アプリのインストール、アプリのオープン、アプリの更新、アプリ内購入などの基本的なイベントを自動的に追跡し、アトリビューションサーバーにデータを送信します。
  • 手動イベント追跡:ゲームで収集したいイベントを直接定義し、追跡し、アトリビューションサーバーにデータを送信します。
  • PG決済購入完了情報収集:PG決済を使用する場合でも購入完了イベントを収集できます。
  • 属性送信手動イベント追跡時に、属性を通じてイベントの追加情報を収集できます。
  • 広告露出情報送信:ゲームで広告が表示されるとき、広告プラットフォームの種類、広告露出位置、露出タイミング、露出あたりの広告収益などを測定して送信します。
  • SDK Signature:スプーフィング(広告サーバーに虚偽イベントを送信する広告詐欺)を防止するソリューションです。有効な署名情報を確認して真偽イベントを区別し、広告詐欺を防止します。
  • アプリアンインストール追跡:1日に1回サイレントプッシュを送信して、アプリがアンインストールされたかどうかを確認します。
  • 遅延ディープリンク:アプリをインストールしていないユーザーをアプリストアに誘導してインストールを促し、インストールされたアプリを実行すると指定されたコンテンツ位置にユーザーをリダイレクトします。
  • マーケット別流入量測定設定:マーケット(Google Play Store、One Store、Huawei Store、Galaxy Storeなど)のアプリインストールパフォーマンスを分析するための識別子を設定します。
Note

広告情報送信、SDK Signature、アプリアンインストール追跡、遅延ディープリンク、およびマーケット別流入量測定設定は、モバイルゲームアプリでのみサポートされる機能です。

サポートされるマーケティングアトリビューションのサードパーティアプリの種類と機能は、ゲームアプリがモバイル環境かまたはPC環境かによって異なります。

モバイル

モバイル環境では、5つのマーケティングアトリビューションアプリすべてをサポートしており、各アプリで提供される機能は以下のとおりです:

機能 Adjust Airbridge Appsflyer Firebase Analytics Singular
自動イベント追跡 O O O O O
手動イベント追跡 O O O O O
PG決済購入完了情報収集 O O O O O
属性送信 O O O O O
広告情報送信 O O O O O
SDK Signature O O - - -
アプリアンインストール追跡 O O O - -
遅延ディープリンク - O - - -
マーケット別流入量測定設定 - O - - -

PC

PC環境では、AirbridgeとAppsflyer(Steam)の2つのオプションのみサポートしています。

機能 Airbridge Appsflyer
自動イベント追跡 O O
手動イベント追跡 O O
PG決済購入完了情報収集 O O
属性送信 O O

コミュニティとウェブショップ

コミュニティとウェブショップでは、マーケティングアトリビューションとしてAirbridgeの自動イベント追跡機能のみが利用可能です。また、モバイルおよびPC環境の両方でイベントを収集できます。

Note

コミュニティとウェブショップでは、Airbridgeだけでなく**Google Tag Manager(GTM)**でもイベント収集が可能です。GTMコードを発行してHiveコンソールに登録することでイベントを収集できます。詳細については、コンソールガイドを参照してください。

コミュニティ自動収集イベント

Airbridgeがコミュニティサイトから自動収集できるイベントは以下のとおりです:

イベント イベント詳細 トリガーポイント 構成要素(参考) Airbridgeイベントリストマッチング
ログイン ログイン ログイン完了後に正常にページに入るとき - ログイン(スタンダード)
ログイン サインアップ コミュニティIDを作成するとき - サインアップ(スタンダード)
ログイン ログアウト ログアウトボタンを選択するとき - ログアウト(スタンダード)
投稿(コンテンツ) メイン画面表示 メイン画面に表示された投稿を選択するとき • 投稿情報(タイトル、画像/動画、ニックネーム、登録日、表示回数、コメント) • ボードタイプ • リストでの露出位置 ホーム画面表示(スタンダード)
投稿(コンテンツ) カテゴリ/メニュー選択 カテゴリ/メニューボタンを選択するとき • カテゴリ/メニュー名 商品リスト表示(スタンダード)
投稿(コンテンツ) 書き込みボタン選択 サイドナビゲーション/カテゴリ内の書き込みボタンを選択するとき • カテゴリ • 形式 (カスタムイベント)
投稿(コンテンツ) 投稿登録 投稿作成完了後に登録を選択するとき • 長さ(作成量) • 添付ファイル数 • 作成所要時間 • 作成日 (カスタムイベント)
投稿(コンテンツ) 投稿削除 登録された投稿の削除ボタンを選択するとき • 投稿情報(タイトル、画像/動画、ニックネーム、登録日、表示回数、コメント) (カスタムイベント)
投稿(コンテンツ) 投稿一時登録 投稿作成中に一時登録を選択するとき - (カスタムイベント)
投稿(コンテンツ) ソート/フィルター適用 投稿リストでデフォルトソート/フィルター以外の方法を選択するとき • 選択したソート方法 • 選択したフィルター (カスタムイベント)
投稿(コンテンツ) コミュニティ活動 • コメント/返信作成完了後に登録ボタンを選択するとき • コメント/返信削除ボタンを選択するとき • 報告、いいね、悪いを選択するとき • 投稿情報 (カスタムイベント)
投稿(コンテンツ) 投稿共有 投稿共有ボタン選択後、共有ポップアップで共有方法を選択するとき • 投稿情報 • 選択した共有方法 共有(スタンダード)
投稿(コンテンツ) 検索結果表示 検索結果リストから投稿を選択するとき • 投稿情報 • ページ番号 検索結果表示(スタンダード)
投稿(コンテンツ) ハッシュタグ使用 • 投稿作成時にハッシュタグ入力後登録を選択するとき • ハッシュタグ(#)入力後検索を開始するとき • 投稿情報 • 入力したハッシュタグ数 • 該当ハッシュタグ関連投稿数 (カスタムイベント)
ユーザー プロフィール設定 • プロフィール修正が完了したとき • 他のユーザーのプロフィールを表示するとき • プロフィール画像 • ニックネーム (カスタムイベント)
ユーザー 退会 コミュニティ退会案内ポップアップで退会ボタンを選択するとき - (カスタムイベント)
その他 ウェブショップ進入 ヘッダー/サイドナビゲーション内のウェブショップボタンを選択するとき - (カスタムイベント)
その他 購入履歴確認 ヘッダー/サイドナビゲーション内の購入履歴ボタンを選択するとき - (カスタムイベント)
その他 PCでプレイ進入(Web) サイドナビゲーション内のPCでプレイボタンを選択するとき - (カスタムイベント)
その他 クーポン交換所進入 サイドナビゲーション内のクーポン交換所ボタンを選択するとき - (カスタムイベント)
その他 ブランドサイト進入 サイドナビゲーション内のブランドサイトボタンを選択するとき - (カスタムイベント)
その他 マーケット移動 フッター/サイドナビゲーション内のマーケット移動ボタンを選択するとき - (カスタムイベント)

ウェブショップ自動収集イベント

Airbridgeがウェブショップサイトから自動収集できるイベントは以下のとおりです:

イベント トリガーポイント 構成要素
ログイン ログイン後にページに入るとき -
サインアップ コミュニティID作成時間を基準として -
ホーム画面表示 ホーム画面ページに入るとき -
商品リスト表示 商品リストが表示されるとき • カテゴリ名 • ページ番号
カテゴリ選択 カテゴリボタンを選択するとき カテゴリ名
商品詳細表示 商品情報をクリックして商品詳細情報ページに入るとき • 商品マーケット • 商品名 • 通貨 • 商品価格
購入ボタンクリック 商品詳細情報内の購入ボタンをクリックするとき • 商品マーケット • 商品名 • 通貨 • 商品価格
支払い開始 サーバー情報選択ポップアップで購入ボタンをクリックするとき • 商品マーケット • 商品名 • 通貨 • 商品価格 • 商品数量
購入完了 ウェブPG支払い完了後、ビリングから支払い完了情報を受け取るとき • 通貨 • 注文番号 • 商品マーケット • 商品名 • 商品価格 • 購入数量

サードパーティアトリビューションの有効化

Hive APIを使用してサードパーティアトリビューションを有効または無効にできます。サードパーティアトリビューションを有効または無効にするには、Analytics APIのsetEnableTracker()関数を呼び出してください。関数の最初のパラメーターとして、有効または無効にしたいアトリビューションを以下の文字列で定義してください:

  • Adjust: ADJUST
  • Singular: SINGULAR
  • AppsFlyer: APPSFLYER
  • Firebase: FIREBASE
  • Airbridge: AIRBRIDGE
Note

hive_config.xmlで使用したいサードパーティアトリビューションを定義している場合、サードパーティアトリビューションはデフォルトで有効になります。そのため、Hive 初期化後に直接サードパーティアトリビューションを有効にする必要はありません。

以下は特定のアトリビューションを無効にするサンプルコードです:

API Reference: hive.Analytics.setEnableTracker

using hive;    
    String trackerName = "ADJUST";    

Analytics.setEnableTracker(trackerName, false);
#include "HiveAnalytics.h"

FString TrackingTypeName = TEXT("ADJUST");
FHiveAnalytics::SetEnableTracker(TrackingTypeName, false);

API Reference: Analytics::setEnableTracker

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    string trackerName = "ADJUST";    

Analytics::setEnableTracker(trackerName, false);

API Reference: Analytics.setEnableTracker

import com.hive.Analytics    
    val trackerName = "ADJUST"    

Analytics.setEnableTrackerWithName(trackerName, false)

API Reference: AnalyticsInterface.setEnableTracker

import HIVEService    
    let trackerName = "ADJUST"    
AnalyticsInterface.setEnableTracker(name: trackerName, enable: false)

API Reference: setEnableTracker(name:enable:)

import HIVEService
let trackName = "ADJUST”
AnalyticsInterface.setEnableTracker(name: trackerName, enable: false)

API Reference: HIVEAnalytics:setEnableTracker

#import <HIVEService/HIVEService-Swift.h>    
    NSString *trackerName = @"ADJUST";    

[HIVEAnalytics setEnableTrackerWithName: trackerName enable: NO];

Windowsでのマーケティングアトリビューションの適用

Windows環境でマーケティングアトリビューションを適用する手順は以下のとおりです:

  1. リリース > プラグイン > マーケティングアトリビューション > Windowsに移動します。
  2. 使用したいマーケティングアトリビューションプラグインをダウンロードします。
  3. ダウンロードしたファイルを展開します。
  4. 展開したファイルの中から_DLL_ファイルを_{game app executable path}/plugins/trackers_に追加します。