同意管理 | Xamarin用Tealium 1.x | Tealium開発者ドキュメント

使用方法

このモジュールはライブラリに自動的に含まれ、初期化時にネイティブコードで有効になるため、使用することが推奨されます。AndroidとiOSの両方のプラットフォームがサポートされています。

同意管理の詳細については、こちらを参照してください。

サンプルアプリ

当社のライブラリ、トラッキングメソッド、ベストプラクティスの実装に精通していただけるよう、Xamarin向け同意管理のサンプルアプリをダウンロードできるようになっています。

有効化

同意管理機能は、Tealium.Platform.*.dllsというDLLに埋め込まれた2つのネイティブSDKから提供されます。Tealium.Common.dllは、使用する次のカテゴリとステータスの列挙を提供します。

Tealium.ConsentManager.ConsentStatus
Tealium.ConsentManager.ConsentCategory

同意管理を有効にするには、以下の例のようにTealiumConfigのコンストラクタ内で任意のパラメータを渡すか、プロパティとして構成します。

TealiumConfig tealConfig = new TealiumConfig(
        TealiumConsts.INSTANCE_ID,
        TealiumConsts.ACCOUNT,
        TealiumConsts.PROFILE,
        TealiumConsts.ENVIRONMENT,
        true,
        commands,
        advConfig,
        false); // optional Consent Manager Enablement

// or subsequently enable it:
tealConfig.IsConsentManagerEnabled = true;

// initialise your Tealium Instance:
var tealium = instanceManager.CreateInstance(tealConfig);

同意ステータス

AndroidおよびiOSのネイティブSDKと同様に、同意管理が有効になっている場合、新しいユーザーは未知の状態だと見なされます。同意ステータスがオプトインまたはオプトアウトされ、各イベントが送信または消去されるまで、トラッキング要求がキューに登録されます。

以下の例のように、TealiumConfigオブジェクトのプロパティを使って初期ステータスをオーバーライドします。

// enable Consent Manager:
tealConfig.IsConsentManagerEnabled = true;

// Set Users to be Consented by default:
tealConfig.InitialUserConsentStatus = ConsentManager.ConsentStatus.Consented;
// Or set Users to be Not Consented by default:
tealConfig.InitialUserConsentStatus = ConsentManager.ConsentStatus.NotConsented;

// Opt users into All Categories
tealConfig.InitialUserConsentCategories = ConsentManager.AllCategories;
// or none:
tealConfig.InitialUserConsentCategories = ConsentManager.NoCategories;
// or partial opt-in, only to Analytics and Mobile categories.
tealConfig.InitialUserConsentCategories = new ConsentCategory[]{
    ConsentManager.ConsentCategory.Analytics,
        ConsentManager.ConsentCategory.Mobile
};

同意選択

TealiumインスタンスからConsentManagerプロパティを介して、Consent Managementと直接やりとりします。

ユーザーの同意選択を更新する必要がある場合は、以下の例のようにConsentManager.ConsentCategoryおよびConsentManager.ConsentStatusで利用可能な列挙型の値の1つを渡します。

// if the user is in an Unknown state, then the following code triggers any queued events are sent after this:
ITealium tealium = instanceManager.GetExistingInstance(TealiumConsts.INSTANCE_ID);
tealium.ConsentManager.UserConsentStatus = ConsentManager.ConsentStatus.Consented;

// The previous inherently opts the user into all categories as none have been provide.
// To grant consent and opt into a subset of categories, use the overload:
tealium.ConsentManager.UserConsentStatusWithCategories(ConsentManager.ConsentStatus.Consented, new ConsentCategory[]{
    ConsentManager.ConsentCategory.Analytics
});

リセット

現在選択されている同意構成をリセットするための追加のオプションが利用できます。このオプションを使用するとユーザーのステータスはUnknownに戻り、以降のイベントが再度キューに登録されるようになります。

完全に無効にするには、以下の例のようにTealiumConfigオブジェクトで無効化します。

ITealium tealium = instanceManager.GetExistingInstance(TealiumConsts.INSTANCE_ID);
tealium.ConsentManager.ResetUserConsentPreferences();