コンテンツにスキップ

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

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

Adjustによる手動イベントトラッキング

  1. カスタムイベントを手動で追跡するには、Adjustダッシュボードでイベントを登録し、アプリトークンとイベントトークンを取得します。アプリトークンはダッシュボードのメインページで取得でき、イベントトークンはダッシュボード > すべての設定 > イベントで取得できます。トークンの取得方法については、Adjustダッシュボードガイドを参照してください。
  2. hive_config.xmlに各イベントのアプリトークンとイベントトークンを追加します。詳細については、以下の例コードを参照してください。
  3. アプリのスプーフィングを防ぐために、AdjustダッシュボードはSDK署名を提供しています。この機能を使用するには、Adjust契約の詳細を確認する必要があります。この機能を使用するには、必要なキーを取得し、hive_config.xmlに追加します(secretIdinfo1info2info3info4)。

    <providers>
    <!-- (スキップされました) -->
    <!-- Adjustノードのidフィールドを設定しないでください。 -->
    <!-- Adjustノードのnameフィールドは「Adjust」に固定されています。 -->
    <!-- eventノードの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. Analytics API sendEvent() を呼び出してイベントを送信します。イベントを送信する際には、hive_config.xml の event name を使用してください。name は sendEvent() のリクエストパラメータとして使用され、設定した value は各アトリビューションのダッシュボードに更新されます。

    * `Analytics.sendEvent("TutorialComplete");`
    * `Analytics.sendEvent("MissionClear");`
    

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

  1. 必要なトークンを取得します。トークンの取得方法については、Airbridge ダッシュボードガイドを参照してください。
    • ダッシュボード > 設定 > トークン管理からアプリ SDK トークンとアプリ名を取得します。
  2. 以下の指示に従って、hive_config.xmlにトークン、アプリ名、およびイベント設定を追加します。以下の例コードを参照してください。
  3. Airbridgeはアプリの偽装を防ぐためにSDK署名を提供しています。関連機能を使用するには、Airbridgeとの契約を確認する必要があります。関連機能を使用するには、キーを取得し、hive_config.xmlのsecretIdsecretに追加します。SDK署名のセキュリティ情報についての詳細は、Airbridgeガイドを参照してください。
  4. Analytics API sendEvent()を呼び出してイベントを送信します。イベントを送信する際は、hive_config.xmlに追加した`event name`を使用します。`name`はAPIを呼び出す際のパラメータとして使用され、`value`は各アトリビューションのダッシュボードで確認できます。
    • Analytics.sendEvent("TutorialComplete");
    • Analytics.sendEvent("MissionClear");

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

  1. 各アトリビューションダッシュボードから必要なキーを取得します。各アトリビューションダッシュボードのガイドを参照して、キーの取得方法を学んでください。
    • Singular: ダッシュボードからSDKキーとSDKシークレットキーを取得します。
    • Appsflyer: AppsFlyer設定 > アプリ設定に移動してDevキーを取得します。
    • Firebase Analytics: キーは必要ありません。
  2. 以下のガイドに従ってhive_config.xmlを設定します。詳細については、以下の例コードを参照してください。AppsFlyerアトリビューションをHive SDK iOS(ネイティブ、Unity、Unreal)で使用する場合は、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="Tutorial Complete"/>
                            <event name="MissionClear" value="Mission Clear"/>
                    </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ファイルで定義されている<event>要素のnameプロパティの値を入力します。

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

APIリファレンス: [hive.Analytics.sendEvent](http://developers.withhive.com/HTML/v4_api_reference_en/Unity3D/group___analytics.html#ga17724d232e1a72e0fd639e3f01e45bd1)

```cs
using hive;    
        String eventName = "TutorialComplete";    
Analytics.sendEvent(eventName);
```
#include "HiveAnalytics.h"

FString EventName = TEXT("TutorialComplete");
FHiveAnalytics::SendEvent(EventName);
APIリファレンス: [Analytics::sendEvent](http://developers.withhive.com/HTML/v4_api_reference_en/CPP/group___analytics.html#ga1bac3fa81ee5df24ddc8e592b7114c2c)

```cpp
#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
        using namespace std;    
        using namespace hive;    
        string eventName = "TutorialComplete";    
Analytics::sendEvent(eventName);
```
APIリファレンス: [Analytics.sendEvent](https://developers.withhive.com/HTML/dokka/-hive%20-s-d-k%20v4/com.hive/index.html)

```kt
import com.hive.Analytics    
        val eventName = "TutorialComplete"    
Analytics.sendEvent(eventName)
```
APIリファレンス: [AnalyticsInterface .sendEvent](https://developers.withhive.com/documentation/hiveservice/analyticsinterface/sendevent(_:))

```java
import HIVEService    
        let eventName = "TutorialComplete"    
AnalyticsInterface.sendEvent(eventName)
```
APIリファレンス: [HIVEAnalytics:sendEvent](http://developers.withhive.com/HTML/v4_api_reference_en/iOS/interface_h_i_v_e_analytics.html#a952cc16b760f8f18709f0cacc715b918)

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