コンテンツにスキップ

手動イベントトラッキング

インストール、オープン、アップデート、購入（アプリ内購入）を除いて、Hive SDKによって自動的に追跡されるイベント以外に、手動で追跡したい必要なイベントを追跡できます。これを行うには、各アトリビューションのダッシュボードにイベントを登録する必要があります。たとえば、ゲームチュートリアルの完了（TutorialComplete）やミッション目標の完了（MissionClear）などの特定のイベントを追跡できます。自動イベント追跡の設定が完了した後に、手動イベント追跡を実装する必要があります。

Adjustを使用した手動イベントトラッキング

  1. カスタムイベントを手動で追跡するには、Adjustダッシュボードでイベントを登録し、アプリトークンとイベントトークンを取得します。アプリトークンはダッシュボードのメインページで取得でき、イベントトークンはダッシュボード > すべての設定 > イベントで取得できます。トークンの取得方法については、Adjustダッシュボードガイドを参照してください。
  2. hive_config.xmlに各イベントのアプリトークンとイベントトークンを追加します。詳細については、以下の例コードを参照してください。

  3. アプリの偽装を防ぐために、AdjustダッシュボードはSDK署名を提供しています。この機能を使用するには、Adjust契約の詳細を確認する必要があります。この機能を使用するには、必要なキーを取得し、hive_config.xmlに追加します（secretId、info1、info2、info3、info4）。

    <providers>
<!-- (スキップされました) -->
<!-- Adjustノードのidフィールドを設定しないでください。 -->
<!-- Adjustノードのnameフィールドは「Adjust」に固定されています。 -->
<!-- イベントノードのnameフィールドはゲームスタジオによって定義されます。ただし、一度設定されると、sendEvent()リクエストのすべての他のマーケティング帰属のnameフィールドと同じである必要があります。-->
<Adjust name="Adjust" id="unused" key="APP_TOKEN" secretId="1" info1="5432112345" info2="334123" info3="555333" info4="111333">
        <events>
                <event name="TutorialComplete" value="TutorialComplete_EVENT_TOKEN"/>
                <event name="MissionClear" value="MissionClear_EVENT_TOKEN"/>
        </events>
<!-- (スキップされました) -->
</Adjust>
</providers>

  4. コールアナリティクスAPI sendEvent() を呼び出してイベントを送信します。イベントを送信する際には、hive_config.xmlでevent nameを使用します。nameはsendEvent()のリクエストパラメータとして使用され、設定したvalueは各アトリビューションのダッシュボードに更新されます。

    • Analytics.sendEvent("TutorialComplete");
    • Analytics.sendEvent("MissionClear");

Airbridgeで手動でイベントを追跡する

  1. 必要なトークンを取得します。トークンの取得方法については、Airbridge ダッシュボードガイドを参照してください。
    • ダッシュボード > 設定 > トークン管理からアプリ SDK トークンとアプリ名を取得します。
  2. トークン、アプリ名、およびイベント設定を hive_config.xml に追加します。以下の hive_config.xml の例コードを参照してください。Windows では、トークンとアプリ名の設定は必要ありませんが、Hive コンソールの設定は必要です。
  3. Airbridge はアプリの偽装を防ぐためにSDK シグネチャを提供しています。関連機能を使用するには、まず Airbridge と契約条件を確認する必要があります。キーを取得し、hive_config.xml に secretId、secret の値として追加します。 SDK シグネチャのセキュリティ情報についての詳細は、Airbridge ガイドを参照してください。これは Android と iOS のみでサポートされており、Windows ではサポートされていません。
  4. Windows、Android、iOS を一緒に適用する場合は、Airbridgeにプリセットについて問い合わせてください。
  5. Analytics API sendEvent()を呼び出してイベントを送信します。イベントを送信する際は、hive_config.xml に追加された event< タグの name と value を使用します。name は API を呼び出すときのパラメータとして使用され、value は各アトリビューションのダッシュボードで確認できます。
    • Analytics.sendEvent("TutorialComplete");
    • Analytics.sendEvent("MissionClear");

hive_config.xml の例コード

<providers>
    <Airbridge name="Airbridge" key="APP_SDK_TOKEN" appName="APP_NAME" secretId="SECRET_ID" secret="SECRET">
                <events>
                        <event name="TutorialComplete" value="Tutorial Complete" />
                        <event name="MissionClear" value="Mission Clear" />
                </events>
        </Airbridge>
</providers>

Singular、Appsflyer、Firebase Analyticsによる手動イベントトラッキング

  1. 各アトリビューションダッシュボードから必要なキーを取得します。キーの取得方法については、各アトリビューションダッシュボードのガイドを参照してください。
    • Singular: ダッシュボードからSDKキーとSDKシークレットキーを取得します。
    • Appsflyer: AppsFlyerの設定 > アプリ設定に移動してDevキーを取得します。
    • Firebase Analytics: キーは必要ありません。

  2. 以下のガイドに従ってhive_config.xmlを構成します。詳細については、以下の例コードを参照してください。Hive SDK iOS（ネイティブ、Unity、Unreal）でAppsFlyerアトリビューションを使用する場合は、Apple AppIDのためにitunseConnectAppIdを設定する必要があります。

    <providers>
        <!-- Singular用に設定 -->
        <!-- Singularノードのnameフィールドは「Singular」に固定されています。 -->
        <!-- eventノードのnameフィールドはゲームスタジオによって定義されます。しかし、一度設定されると、sendEvent()リクエストの他のすべてのマーケティング帰属のnameフィールドと同じである必要があります。-->
        <!-- eventノードのvalueフィールドはゲームスタジオによって定義されます。 -->
        <Singular name="Singular" id="SDK_KEY" key="SDK_SECRET_KEY">
                <events>
                        <event name="TutorialComplete" value="チュートリアル完了"/>
                        <event name="MissionClear" value="ミッションクリア"/>
                </events>
        </Singular>

        <!-- AppsFlyerの設定 -->
        <!-- AppsFlyerノードのnameフィールドは「AppsFlyer」に固定されています。 -->
        <!-- AppsFlyerノードのidフィールドは設定しないでください。 -->
        <!-- イベントノードのnameフィールドはゲームスタジオによって定義されます。しかし、一度設定されると、sendEvent()リクエストのすべての他のマーケティングアトリビューションのnameフィールドと同じである必要があります。-->
        <!-- イベントノードのvalueフィールドはゲームスタジオによって定義されます。 -->
        <AppsFlyer name="AppsFlyer" id="unused" key="DEV_KEY" itunseConnectAppId="909923112">
                <events>
                        <event name="TutorialComplete" value="チュートリアル完了"/>
                        <event name="MissionClear" value="ミッションクリア"/>
                </events>
        </AppsFlyer>

        <!-- Firebase Analyticsの設定 -->
        <!-- イベントノードのnameフィールドはゲームスタジオによって定義されます。しかし、一度設定されると、sendEvent()リクエストの他のすべてのマーケティング帰属のnameフィールドと同じであるべきです。-->
        <!-- イベントノードのvalueフィールドはゲームスタジオによって定義されます。 -->
        <firebase>
                <events>
                    <event name="TutorialComplete" value="TutorialComplete"/>
                    <event name="MissionClear" value="MissionClear"/>
                </events>
        </firebase>
</providers>

  3. アナリティクスAPI sendEvent() を呼び出してイベントを送信します。イベントを送信する際には、hive_config.xmlでevent nameを使用してください。nameはsendEvent()のリクエストパラメータとして使用され、設定したvalueは各アトリビューションのダッシュボードに更新されます。

    • Analytics.sendEvent("TutorialComplete");
    • Analytics.sendEvent("MissionClear");

sendEvent()を使用してイベントを送信

特定の条件、例えばチュートリアルの完了など、ユーザーの活動が満たされる場合にのみ、アトリビューションにトラッキングイベントを送信することをお勧めします。トラッキングイベントを送信するには、AnalyticsクラスのsendEvent()メソッドを呼び出します。sendEvent()の最初のパラメータとして、hive_config.xmlファイルで定義された要素のnameプロパティの値を入力します。

以下は、ユーザーがチュートリアルを完了したことを通知するために、マーケティングアトリビューションにTutorialCompleteイベントを送信するサンプルコードです。

APIリファレンス: hive.Analytics.sendEvent

using hive;    
    String eventName = "TutorialComplete";    
Analytics.sendEvent(eventName);

#include "HiveAnalytics.h"

FString EventName = TEXT("TutorialComplete");
FHiveAnalytics::SendEvent(EventName);

APIリファレンス: Analytics::sendEvent

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    string eventName = "TutorialComplete";    
Analytics::sendEvent(eventName);

APIリファレンス: Analytics.sendEvent

import com.hive.Analytics    
    val eventName = "TutorialComplete"    
Analytics.sendEvent(eventName)

APIリファレンス: AnalyticsInterface .sendEvent

import HIVEService    
    let eventName = "TutorialComplete"    
AnalyticsInterface.sendEvent(eventName)

APIリファレンス: HIVEAnalytics:sendEvent

#import <HIVEService/HIVEService-Swift.h>    
    NSString eventName = @"TutorialComplete";    
[HIVEAnalytics sendEvent: eventName];