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

Hive SDKは、次の4つのイベントを自動的に追跡し、それぞれのアトリビューションに送信できます: インストール、オープン、アップデート、購入（アプリ内購入） ゲームスタジオは、これらの4つのイベントを追跡するためのコードを実装する必要はありません。

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

1. 各アトリビューションから必要なトークンを取得します。Adjustダッシュボードガイドを参照して、トークンの取得方法を学んでください。

   • 購入および更新イベントを自動的に追跡するには、これらのイベントをAdjustダッシュボードに登録し、アプリトークンとイベントトークンを取得します。アプリトークンはダッシュボードのメインページで取得でき、イベントトークンはダッシュボード > すべての設定 > イベントで取得できます。
   • インストールおよびオープンイベントの自動追跡には、トークンは必要ありません。

2. hive_config.xmlにトークンを追加します。

   • アプリトークン、購入イベントトークン、および更新イベントトークンをhive_config.xmlに追加します。以下の例のコードを参照してください。
   • インストールとオープンイベントの自動追跡のために、hive_config.xmlの設定は必要ありません。
3. Adjustダッシュボードは、アプリのスプーフィングを防ぐためのSDK Signature V3を提供します。SDK Signatureを使用するには、Adjustとの契約条件を確認する必要があります。

SDK署名統合¶

古いバージョンのSDK Signatureを使用している場合は、署名ライブラリを統合する前にSDK Signature Migrationを確認してください。

SDK署名を初めて使用する場合は、以下の指示に従ってください。

アンドロイド¶

Android環境でSDK署名を使用するには、これらの手順に従ってください。

1. モジュールレベルの build.gradle ファイルに Adjust の帰属を追加して、SDK シグネチャを使用します..

   dependencies {
       implementation "com.com2us.android.hive:hive-analytics-provider-adjust"
   }
   

2. Adjust ダッシュボードに移動し、Adjust の許可リストにデジタル証明書のフィンガープリントを追加する ページの指示に従ってフィンガープリントを設定します。

各アプリで使用される証明書方法に応じたフィンガープリント抽出方法を、Adjust Suiteの証明書設定ページを参照することで確認できます。

iOS¶

iOS環境でSDK Signatureを使用するには、PodfileにProviderAdjustサブスペックを追加してください。

(omitted)
pod HiveAnalyticsProviderAdjust, $HIVE_SDK_VERSION
(omitted)

ユニティ¶

UnityエンジンでSDK署名を使用したい場合は、Unityエンジンのメニューで簡単に設定できます。

以下の**インスペクタ**メニューでHive - Hive 依存関係 (ExternalDependency)を選択し、調整にチェックを入れると、追加の設定なしでSDK署名を使用できます。

SDK署名統合ステータスの確認¶

SDK署名ライブラリが正常に統合されていることを確認するには、まずHive SDK設定のzoneがsandboxに設定されていることを確認してください。次に、以下の手順に従ってください。

1. テストデバイスからアプリを完全にアンインストールして、インストール情報が送信されることを確認します。
2. Adjustダッシュボードのテストコンソールに移動し、テストデバイスの情報を入力して、デバイスを削除をクリックしてすべてのデバイスを削除します。
3. テストデバイスにアプリをインストールし、実行してインストール情報がAdjustに送信されることを確認します。
4. テストデバイスの広告IDまたはIDFAをテストコンソールに入力して、インストールイベント情報を取得します。
   • SignatureVerificationResultフィールドにはValid Signatureという値が表示されるべきです。
   • SignatureVersionフィールドの値が3であることを確認します。

SDK署名の移行¶

最新のSDK署名を使用するには、以前のSDK署名バージョンの設定を削除する必要があります。

Android, iOS¶

secretId、info1、info2、info3、およびinfo4に設定されたすべてのキーと値をのAdjust関連設定から削除してください。

<providers>
    <!-- (code omitted) -->

    <!-- Do not set the Adjust node id field. -->
    <!-- The Adjust node name field is fixed as "Adjust". -->
    <!-- The event node name field is set arbitrarily by the game company. -->

    <!-- Remove secretId="1" info1="5432112345" info2="334123" info3="555333" info4="111333" below -->
    <!-- <Adjust name="Adjust" id="unused" key="APP_TOKEN" secretId="1" info1="5432112345" info2="334123" info3="555333" info4="111333"> -->
    <Adjust name="Adjust" key="APP_TOKEN">
        <events>
            <event name="Purchase" value="PURCHASE_EVENT_TOKEN" />
            <event name="Update" value="UPDATE_EVENT_TOKEN" />
        </events>
    </Adjust>

    <!-- (code omitted) -->
</providers>

ユニティ¶

Hive SDK Unityは、以前のSDK Signatureバージョン設定を削除する必要はありません。

Airbridgeを使用してイベントを自動的に追跡する¶

1. 必要なトークンを取得します。トークンの発行方法についての詳細は、Airbridgeダッシュボードガイドを参照してください。
• ダッシュボード > 設定 > トークン管理からアプリSDKトークンとアプリ名を取得します。
2. AndroidとiOSの場合、トークン、アプリ名、および更新イベント設定をhive_config.xmlに追加します。以下の hive_config.xmlの例コードを参照してください。
3. Windowsの場合、hive_config.xml設定の代わりにHiveコンソール設定が必要です。以下のWindows設定を参照してください。
4. Windows、Android、iOSを一緒に適用する場合は、Airbridgeに事前設定について問い合わせてください。
5. Airbridgeはアプリのスプーフィングを防ぐためにSDK署名を提供します。この機能を使用するには、まずAirbridgeとの契約条件を確認する必要があります。キーを取得し、hive_config.xmlのsecretId、secret値として追加します。SDK署名のセキュリティ情報についての詳細は、Airbridgeガイドを参照してください。これはAndroidとiOSのみでサポートされており、Windowsではサポートされていません。

SDK署名統合¶

SDK署名を初めて使用する場合は、以下の指示に従ってください。

hive_config.xml の例コード¶

<providers>
    <Airbridge name="Airbridge" key="APP_SDK_TOKEN" appName="APP_NAME" secretId="SECRET_ID" secret="SECRET">
        <events>
            <event name="Update" value="Update" />

                        <event name="Install" value="Install"/>
            <event name="Open" value="Open"/>
            <event name="PrePurchase" value="airbridge.initiateCheckout"/>
            <event name="PurchaseCancel" value="airbridge.ecommerce.order.canceled"/>
            <event name="Purchase" value="airbridge.ecommerce.order.completed"/>
        </events>
    </Airbridge>
</providers>

アンドロイド、iOS¶

Airbridgeに関連するsecretId、secretキーの値をhive_config.xmlに設定します。

ウィンドウズ¶

1. マーケティングアトリビューションを進める - HiveコンソールのAirbridge設定。

   • hive_config.xmlに関連するsecretId、secretキーの値を設定する必要はありません。

2. 以下の指示に従って、hive_config.xmlに設定します。 *hive_config.xml*の例コードを参照してください。
   Airbridgeで定義された値に設定すると、Airbridge標準イベントとして送信できます。
   Airbridgeイベントタイプ

   • インストール: セットアップが必要です。
   • オープン: セットアップが必要です。
   • 更新: セットアップが必要です。
   • プレ購入: セットアップが必要です。値として airbridge.initiateCheckout を持つ標準イベントを送信できます。
   • 購入キャンセル: セットアップが必要です。値として airbridge.ecommerce.order.canceled を持つ標準イベントを送信できます。
   • 購入: セットアップが必要です。値として airbridge.ecommerce.order.completed を持つ標準イベントを送信できます。

ユニティ¶

メニューからHive - 設定を編集を選択し、AndroidまたはiOSタブをアクティブにします。次に、AirbridgeでsecretId, secretに渡された値を設定します。

自動イベントが発生したときに送信される情報¶

特定のイベントが実行されると、そのイベントは自動的にAirbridgeアプリのアトリビューションに送信されます。この時送信される情報は以下の通りです。

Singular、Appsflyer、Firebase Analyticsによる自動イベント追跡¶

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

2. 以下のガイドに従ってhive_config.xmlを構成します。詳細については、以下の例コードを参照してください。

   • オープン: Firebase Analyticsの構成のみが必要です。
   • 更新: すべてのアトリビューション（Singular、Appsflyer、Firebase Analytics）の構成が必要です。
   • 購入: SingularとFirebase Analyticsの構成が必要です。
   • Hive SDK iOS（ネイティブ、Unity、Unreal）でAppsFlyerアトリビューションを使用する場合は、Apple AppIDのためにitunseConnectAppIdを設定する必要があります。

   <providers>
           <!-- Singularの設定 -->
           <!-- Singularノードのnameフィールドは「Singular」に固定されています。 -->
           <!-- eventノードのnameとvalueフィールドは各ゲームスタジオによって定義されます。 -->
           <Singular name="Singular" id="SDK_KEY" key="SDK_SECRET_KEY">
                   <events>
                           <event name="Purchase" value="purchase"/>
                           <event name="Update" value="update"/>
                   </events>
           </Singular>
   
           <!-- AppsFlyerの設定 -->
           <!-- AppsFlyerノードのnameフィールドは「AppsFlyer」に固定されています。 -->
           <!-- AppsFlyerノードのidフィールドは設定しないでください。 -->
           <!-- イベントノードのnameとvalueフィールドは各ゲームスタジオによって定義されます。 -->
           <AppsFlyer name="AppsFlyer" id="unused" key="DEV_KEY" itunseConnectAppId="909923112">
                   <events>
                           <event name="Update" value="Update"/>
                   </events>
           </AppsFlyer>
   
           <!-- Firebase Analyticsの設定 -->
           <!-- イベントノードの名前と値フィールドは各ゲームスタジオによって定義されます。 -->
           <firebase>
                   <events>
                           <event name="Purchase" value="purchase"/>
                           <event name="Open" value="open"/>
                           <event name="Update" value="update"/>
                   </events>
           </firebase>
   </providers>
   

購入イベントに送信される情報¶

ゲームの課金をHive IAPで実装すると、Hive SDKは自動的に購入イベントをサードパーティのモバイルアプリのアトリビューションに送信します。各イベントで送信される情報は以下の通りです。