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

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

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

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

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

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

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

SDK署名統合¶

古いバージョンのSDK Signatureを使用している場合は、署名ライブラリを統合する前にSDK Signatureの移行を確認してください。SDK Signatureを初めて使用する場合は、以下の手順に従ってください。

アンドロイド¶

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

1. SDK/Externalフォルダーに含まれているadjust-android-signature-xxxxxx.aarライブラリをコピーし、プロジェクトのlibsフォルダーに追加します。
2. Adjustダッシュボードに移動し、Adjustの許可リストにデジタル証明書のフィンガープリントを追加するページの指示に従ってフィンガープリントを設定します。アプリで使用されている証明書の方法に従うために、Adjust Suiteの証明書設定ページを参照してフィンガープリントを確認できます。

iOS¶

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

(omitted)
pod 'HiveAnalyticsProviderAdjust', $HIVE_SDK_VERSION
pod 'HiveAnalyticsProviderAdjust/SignatureV3', $HIVE_SDK_VERSION
(omitted)

ユニティ¶

メニューからHive - Hive 依存関係(ExternalDependency)を選択し、署名を調整 V3を有効にします。

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

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

詳細については、[Adjust Documentation](https://dev.adjust.com/ko/sdk/android/integrations/signature-library?version=v4#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist)を参照してください。

1. テストデバイスからアプリを完全にアンインストールして、インストール情報が送信されることを確認します。
2. Adjust Dashboard Testing Consoleに移動し、テストデバイスの情報を入力して、デバイスを削除をクリックしてすべてのデバイスを削除します。
3. テストデバイスにアプリをインストールし、実行してインストール情報がAdjustに送信されることを確認します。

4. テストデバイスの広告IDまたはIDFAをテストコンソールに入力して、インストールイベント情報を取得します。

5. SignatureVerificationResult フィールドは Valid Signature の値を表示する必要があります。

6. SignatureVersion フィールドの値が 3 であることを確認してください。

SDK署名の移行¶

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

アンドロイド、iOS¶

hive_config.xmlのAdjust関連設定で、secretId、info1、info2、info3、およびinfo4に設定されたすべてのキーと値を削除します。

<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">
                <events>
                        <event name="Purchase" value="PURCHASE_EVENT_TOKEN" />
                        <event name="Update" value="UPDATE_EVENT_TOKEN" />
                </events>
        </Adjust>

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

ユニティ¶

メニューからHive - 設定を編集を選択し、AndroidまたはiOSタブをアクティブにします。その後、Adjust > アプリシークレット値に設定されているすべての値をsecretid, info1 ~ info4について削除します。

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

1. 必要なトークンを取得します。トークンの発行方法についての詳細は、Airbridgeダッシュボードガイドを参照してください。
• ダッシュボード > 設定 > トークン管理からアプリSDKトークンとアプリ名を取得します。
2. トークン、アプリ名、および更新イベント設定をhive_config.xmlに追加します。以下の例のコードを参照してください。
3. Airbridgeはアプリの偽装を防ぐためにSDK署名を提供しています。関連機能を使用するには、Airbridgeとの契約を確認する必要があります。関連機能を使用するには、キーを取得し、それをhive_config.xmlのsecretIdとsecretに追加します。SDK署名のセキュリティ情報についての詳細は、Airbridgeガイドを参照してください。

SDK署名統合¶

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

アンドロイド、iOS¶

hive_config.xmlのAirbridge関連設定でsecretIdとsecretキーの値を設定します。

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

ユニティ¶

メニューから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のために構成する必要があります。

3. 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ノードの名前フィールドは「AppsFlyer」に固定されています。 -->
           <!-- AppsFlyerノードのidフィールドは設定しないでください。 -->
           <!-- イベントノードの名前と値フィールドは各ゲームスタジオによって定義されます。 -->
           <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は自動的に購入イベントをサードパーティのモバイルアプリのアトリビューションに送信します。各イベントで送信される情報は以下の通りです。