コンテンツにスキップ

アナリティクス同意バナーを表示

EUおよびEEA地域では、2024年3月6日に、以下のDMA規制が義務付けられています。

アルファベット、アマゾン、アップル、バイトダンス、メタ、マイクロソフトなどのゲートキーパーからカスタム広告を提供するための個人情報を収集するときは、ユーザーから明示的な同意を得る必要があります。

したがって、EUおよびEEA地域でFirebaseまたはマーケティングアトリビューションツールを介してGoogleにデータを送信する場合は、その地域のユーザーから情報を提供することに同意する必要があります。

Hive SDKは、個人情報の収集に同意するかどうかを確認できる同意バナー表示機能を提供します。

基本操作フロー

ユーザーアプリに個人情報収集契約を適用すると、以下のSDK操作フローのステップ3から運用が開始されます。

  1. SDKの初期化とログイン中に表示される利用規約および条件の合意
  2. ADIZなどのCMP同意ポップアップの表示
  3. Analytics.showConsentModeIfRequire()を呼び出すことで、条件付きで個人情報収集同意UIを表示 - ユーザーがすでに同意を与えている場合、同意バナーUは表示されず、期限が切れた場合や追加の同意が必要な場合にのみ表示される
  4. Analytics.showConsentMode()を呼び出すことで、個人情報収集同意のUIが常に表示される
    - 以前に同意があった場合、UIは同意状況に応じて設定される - [ConsentMode]オブジェクトパラメータがnullに設定されると、Hive SDKは、サードパーティのマーケティング追跡ツールが追加されているかどうかに応じて同意リストを自動的に生成 - 設定ボタンはアプリ内で構成でき、ユーザーはいつでも再同意し、同意状況を確認できる

同意バナーUIの公開

Hive SDKは、AnalyticsのContentModeクラスオブジェクトを通じて、同意バナーUIの表示機能を提供します。

同意バナーUI設定は、ContentModeオブジェクトの機能パラメータ設定に応じて、「デフォルト同意バナーUI」と「カスタム同意バナーUI」に大きく分けられます。

デフォルトの同意バナーUI設定

[ConsentMode]オブジェクトパラメータをnullとして入力すると、Hive SDKで使用されるサードパーティのマーケティングトラッキングツールが追加されているかどうかに応じて、以下の「基本同意リスト」が自動的に作成されます。

アプリ内で個人情報の収集に同意すると、Hive SDKは、以下の各項目の値に対するコールバックを通じて、あなたが同意したことを確認できます。

  • [ConsentMode.ConsentForm.providerName]: * "main": 一般的に同意された項目 * "google", "adjust", "appsflyer", "singular" "airbridge: デフォルトの同意バナーに含まれるプロバイダー項目

カスタム同意バナーUI設定

Hive SDKが提供する基本的な同意バナーUIとは異なり、ユーザーのアプリの個性に合ったUIとテキストが含まれています。 以下に示すように、[ContentMode]オブジェクトによって提供される各パラメータにマッピングされる修正テキストを入力してください。

  • ConsentMode.title: これは同意バナーの上部に表示されるテキストです。
  • ConsentMode.companyName: 基本情報として公開されるとき、会社名はmainFormのdataUsageDescriptionに必要なタイトルと共に設定されます。
  • ConsentMode.privacyPolicy: 同意バナーの下部にある「プライバシーポリシー」ボタンをクリックしたときに実行されるURLです。
  • ConsentMode.mainForm: デフォルトの同意項目として指定されています。mainFormに同意しない場合、他の項目に同意することはできません。
  • ConsentMode.formList: 各会社が個人情報を共有するための同意項目です。
  • ConsentForm.providerName: 同意の対象に対応するプロバイダー名です。"main"に設定されている場合、設定はConsentMode.mainFormの設定と同じになります。
  • ConsentForm.dataUsageTitle: providerNameとのデバイス情報共有に関するタイトルテキストです。
  • ConsentForm.dataUsageDescription: dataUsageTitleの詳細です。
  • ConsentForm.personalizationTitle: パーソナライズされた広告情報を提供することに同意するタイトルフレーズです。
  • ConsentForm.personalizationDescription: personalizationTitleの詳細です。
  • ConsentStatus.providerName: 同意の対象に対応するプロバイダー名です。別途設定されていない場合、"main"、"google"、"adjust"、"appsflyer"、"singular"、"airbridge"のいずれかが設定されます。
  • ConsentStatus.consentForDataUsage: [providerName]とのデバイス情報を共有するかどうかです。ユーザーの同意に応じて、[Analytics.CONSENT_GRANTED]または[Analytics.CONSENT_DENIED]の値が設定されます。初めて何も設定されていない場合、"not-set"または空の文字列になります。
  • ConsentStatus.consentForPersonalization: [providerName]とのパーソナライズされた広告情報を共有するかどうかです。ユーザーの同意に応じて、[Analytics.CONSENT_GRANTED]または[Analytics.CONSENT_DENIED]の値が設定されます。初めて何も設定されていない場合、"not-set"または空の文字列になります。

サードパーティの同意管理プラットフォーム（CMP）と統合する

同意バナーポップアップを表示する際に作成されるTCF標準に準拠したファイルを使用することで、同意バナーUIがサードパーティの同意管理プラットフォーム（CMP）と重複して表示されないように設定できます。

Analytics.showConsentModeIfRequire()を呼び出すとき、checkCmp パラメータがtrueの場合、TCF標準に従って保存されたファイルがあると、そのファイルが読み込まれ、ファイル内の会社が設定に同意していると見なされます。そう見なされます。
checkCmpパラメータのデフォルト値はtrueです。

例えば、Adizを使用すると、Google AdMobコンソールにアクセスし、GDPRメッセージを作成し、その後Adizをリセットしてみることができます。

CMPで同意バナーが繰り返し表示されないようにするには、次の順序でパートナー設定を進めてください。同意が必要な会社を設定してから、パートナーとして設定します。設定の詳細については、HIVE ADIZ > GDPRメッセージの作成を参照してください。

  1. 左のメニューでプライバシーとメッセージをクリックします。- - 欧州規則メニューで、‘GDPR’ 設定をクリックします。その後、メッセージを入力し、パートナー企業を設定できるページに移動します。

    ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump\_파트너-설정\_1.png){width="700"px}

  2. 広告パートナーのレビュー > カスタム広告パートナーの下にある編集ボタンをクリックします。 その後、広告パートナーのリストを表示し、必要なものを選択するために編集できます。

    ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump\_파트너-설정\_2.png){width="700"px}

![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump\_파트너-설정\_3.png){width="700"px}

  3. 同意が必要な会社の名前を確認してください。（パートナーリストには検索機能がないため、Ctrl+Fで検索するのが便利です。）

  4. AppsFlyerの同意が必要 → Appsflyerを確認してください

  5. 同意の調整が必要 → Adjust GmbHを確認してください

  6. 単独の同意が必要 → Singular Labs Inc. を確認してください。 * ※ Googleが自動的に選択されています。 * ※ Airbridgeは現在パートナーとしてリストされていません。

    ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump_파트너-설정_4.png){width="700px"}

  7. 保存後、選択したパートナー企業がリストに表示されることがわかります。

    ![](https://developers.withhive.com/wp-content/uploads/2024/04/구글ump_파트너-설정_5.png){width="450px"}

Hive SDK アナリティクス同意バナーの表示設定

Hive SDK開発環境でのAnalytics同意バナーの表示設定方法について説明します。

Hive SDK Unity

  1. Unityプロジェクトの上部メニューからHive Dependenciesウィンドウを表示します。Hive > Hive Dependenciesを選択します。
  2. 以下に示すように、Analytics Consent-Modeオプションをチェックして保存します。

Hive SDK Androidネイティブ

アプリレベルのbuild.gradle で「Analytics Consent-Mode」ライブラリを宣言します。

implementation "com.com2us.android.hive:hive-analytics-consent-mode:${HIVE_SDK_VERSION}" // Enter SDK version if not using BoM

Hive SDK iOSネイティブ

あなたのPodfileで「Analytics Consent-Mode」フレームワークを宣言してください。

pod 'HiveAnalyticsConsentMode', '${HIVE_SDK_VERSION}' # Enter SDK version