自動イベントトラッキング
Hive SDKは、以下の4つのイベントを自動的に追跡し、それぞれのアトリビューションに送信できます: インストール、オープン、アップデート、購入(アプリ内購入) ゲームスタジオは、これらの4つのイベントを追跡するためのコードを実装する必要はありません。
Adjustによる自動イベントトラッキング¶
-
各アトリビューションから必要なトークンを取得します。Adjustダッシュボードガイドを参照して、トークンの取得方法を学んでください。
- 購入および更新イベントを自動的に追跡するには、これらのイベントをAdjustダッシュボードに登録し、アプリトークンとイベントトークンを取得します。アプリトークンはダッシュボードのメインページで取得でき、イベントトークンはダッシュボード > すべての設定 > イベントで取得できます。
- インストールおよびオープンイベントの自動追跡には、トークンは必要ありません。
-
hive_config.xmlにトークンを追加します。
- hive_config.xmlにアプリトークン、Purchaseのイベントトークン、およびUpdateのイベントトークンを追加します。詳細については、以下の例コードを参照してください。
- InstallおよびOpenイベントの自動追跡のために、hive_config.xmlの設定は必要ありません。
- Adjustダッシュボードは、アプリの偽装を防ぐためのSDK Signature V3を提供します。SDK Signatureを使用するには、Adjustとの契約条件を確認する必要があります。
Note
ゲーム運営のために、すべての4つのイベントを自動的に追跡することをお勧めします。
SDK署名統合¶
古いバージョンのSDK Signatureを使用している場合は、署名ライブラリを統合する前にSDK Signatureの移行を確認してください。SDK Signatureを初めて使用する場合は、以下の手順に従ってください。
アンドロイド¶
Android環境でSDK署名を使用するには、これらの指示に従ってください。
- SDK/Externalフォルダーに含まれているadjust-android-signature-xxxxxx.aarライブラリをコピーし、プロジェクトのlibsフォルダーに追加します。
- 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
に設定されていることを確認してください。その後、以下の手順に従ってください。
Note
詳細については、[Adjust Documentation](https://dev.adjust.com/ko/sdk/android/integrations/signature-library?version=v4#add-your-digital-certificate-fingerprints-to-adjust-s-allowlist)を参照してください。
- テストデバイスからアプリを完全にアンインストールして、インストール情報が送信されることを確認します。
- Adjust Dashboard Testing Consoleに移動し、テストデバイスの情報を入力して、デバイスを削除をクリックしてすべてのデバイスを削除します。
- テストデバイスにアプリをインストールし、実行してインストール情報がAdjustに送信されることを確認します。
-
テストデバイスの広告IDまたはIDFAをテストコンソールに入力して、インストールイベント情報を取得します。
-
SignatureVerificationResult
フィールドはValid Signature
の値を表示する必要があります。 -
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を使用してイベントを自動的に追跡する¶
- 必要なトークンを取得します。トークンの発行方法についての詳細は、Airbridgeダッシュボードガイドを参照してください。
- ダッシュボード > 設定 > トークン管理からアプリSDKトークンとアプリ名を取得します。
- トークン、アプリ名、および更新イベント設定をhive_config.xmlに追加します。以下の例のコードを参照してください。
- 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アプリのアトリビューションに送信されます。この時送信される情報は以下の通りです。
イベント名 | パラメータ | 備考 | |
---|---|---|---|
ログイン | サインイン |
| |
ログアウト | outサインアウト | ||
支払い開始 | チェックアウト開始 |
|
|
購入完了 | 注文完了 |
|
|
購入キャンセル | 注文キャンセル |
|
|
サブスクリプション | サブスクライブ |
|
|
広告インプレッション | 広告インプレッション |
|
|
広告クリック | 広告クリック |
|
|
評価 | 評価 |
|
|
共有 | 共有 |
Singular、Appsflyer、Firebase Analyticsによる自動イベントトラッキング¶
- 各アトリビューションダッシュボードから必要なキーを取得します。キーの取得方法については、各アトリビューションダッシュボードのガイドを参照してください。
- Singular: ダッシュボードからSDKキーとSDKシークレットキーを取得します。
- Appsflyer: AppsFlyer設定 > アプリ設定に移動してDevキーを取得します。
- Firebase Analytics: キーは必要ありません。
- 以下のガイドに従って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ノードの名前フィールドは「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>
Note
ゲーム運営のために、すべての4つのイベントを自動的に追跡することをお勧めします。
購入イベントで送信される情報¶
ゲームの課金をHive IAPで実装すると、Hive SDKは自動的に購入イベントをサードパーティのモバイルアプリのアトリビューションに送信します。各イベントで送信される情報は以下の通りです。
イベント名 | パラメータ | 備考 | |
---|---|---|---|
調整 | 購入 |
|
|
Airbridge | 注文完了 |
|
|
Singular | __iap__ |
|
|
AppsFlyer | 購入 |
|
|
Firebase Analytics | 購入 |
|
|