始める

Google User Messaging Platform（UMP）SDK は、プライバシーとメッセージを保護するためのツールで、 プライバシーに関する選択を管理できます詳細については、次をご覧ください: プライバシーと説明します。

メッセージ タイプを作成する

ユーザー メッセージは、いずれかの 利用可能なユーザー メッセージの種類 [プライバシーと[メッセージ] タブを アド マネージャー あります。UMP SDK は、 アプリケーション ID から Ad Manager 作成されたプライバシー メッセージ 必要があります。

詳しくは、 プライバシーとメッセージについて

アプリケーション ID を追加する

アプリケーション ID は、 アド マネージャーの管理画面: ID を これを次のコード スニペットに置き換えます。

アプリごとにユーザーの同意情報の更新をリクエストする必要があります Update()を使用して起動します。このリクエストは、 次のとおりです。

  • 同意が必要かどうか。たとえば、 以前に同意に関する決定が期限切れになったためです。
  • プライバシー オプションのエントリ ポイントが必要かどうか。一部のプライバシー メッセージ ユーザーがプライバシー オプションをいつでも変更できるようにすることを義務付けています。

アプリ起動時のステータスの確認方法の例を次に示します。

void Start()
{
    // Create a ConsentRequestParameters object.
    ConsentRequestParameters request = new ConsentRequestParameters();

    // Check the current consent information status.
    ConsentInformation.Update(request, OnConsentInfoUpdated);
}

void OnConsentInfoUpdated(FormError consentError)
{
    if (consentError != null)
    {
        // Handle the error.
        UnityEngine.Debug.LogError(consentError);
        return;
    }

    // If the error is null, the consent information state was updated.
    // You are now ready to check if a form is available.
}

必要に応じてプライバシー メッセージ フォームを読み込んで表示する

最新の同意ステータスを受け取ったら、 LoadAndShowConsentFormIfRequired() して、タスクに必要なフォームを読み込みます。 ユーザーの同意を取得します。読み込み後、フォームがすぐに表示されます。

void Start()
{
    // Create a ConsentRequestParameters object.
    ConsentRequestParameters request = new ConsentRequestParameters();

    // Check the current consent information status.
    ConsentInformation.Update(request, OnConsentInfoUpdated);
}

void OnConsentInfoUpdated(FormError consentError)
{
    if (consentError != null)
    {
        // Handle the error.
        UnityEngine.Debug.LogError(consentError);
        return;
    }

    // If the error is null, the consent information state was updated.
    // You are now ready to check if a form is available.
    ConsentForm.LoadAndShowConsentFormIfRequired((FormError formError) =>
    {
        if (formError != null)
        {
            // Consent gathering failed.
            UnityEngine.Debug.LogError(consentError);
            return;
        }

        // Consent has been gathered.
    });
}

ユーザーが選択または拒否した後になんらかのアクションを行う必要がある場合 そのロジックを Action<FormError> callbackに配置します。 選択します。

プライバシー設定

一部のプライバシー メッセージのフォームは、パブリッシャーがレンダリングするプライバシーから表示されます オプションのエントリ ポイントを用意し、ユーザーがいつでもプライバシー オプションを管理できるようにしました。 ユーザーに表示されるメッセージについて詳しくは、プライバシー オプションをご覧ください 参照できます。詳しくは、 利用可能なユーザー メッセージの種類。

プライバシー オプションのエントリ ポイントを実装する手順は次のとおりです。

  1. PrivacyOptionsRequirementStatusをご確認ください。
  2. プライバシー オプションのエントリ ポイントが 表示可能で操作可能な UI 要素をアプリに追加します。
  3. 以下を使用してプライバシー オプション フォームをトリガーします。 ShowPrivacyOptionsForm()。

次のコード例は、この手順を示しています。

[SerializeField, Tooltip("Button to show the privacy options form.")]
private Button _privacyButton;

private void Start()
{
  // Enable the privacy settings button.
  if (_privacyButton != null)
  {
      _privacyButton.onClick.AddListener(UpdatePrivacyButton);
      // Disable the privacy settings button by default.
      _privacyButton.interactable = false;
  }
}

/// <summary>
/// Shows the privacy options form to the user.
/// </summary>
public void ShowPrivacyOptionsForm()
{
    Debug.Log("Showing privacy options form.");

    ConsentForm.ShowPrivacyOptionsForm((FormError showError) =>
    {
        if (showError != null)
        {
            Debug.LogError("Error showing privacy options form with error: " + showError.Message);
        }
        // Enable the privacy settings button.
        if (_privacyButton != null)
        {
            _privacyButton.interactable =
                ConsentInformation.PrivacyOptionsRequirementStatus ==
                PrivacyOptionsRequirementStatus.Required;
        }
    });
}

広告をリクエスト

アプリで広告をリクエストする前に、同意を得ているかどうかを確認してください を使用してユーザーから取得できます。2 つのモデル 同意を取得する際に確認する項目:

  • 現在のセッションで同意が得られた後。
  • Update()を呼び出した直後。 前回のセッションで同意を取得した可能性があります。レイテンシ おすすめします。コールバックの完了を待たずに、 アプリのリリース後、できるだけ早く広告の読み込みを開始してください。
で確認できます。

同意取得プロセス中にエラーが発生した場合でも、 広告をリクエストできます。UMP SDK は、前のステップの あります。

void Start()
{
    // Create a ConsentRequestParameters object.
    ConsentRequestParameters request = new ConsentRequestParameters();

    // Check the current consent information status.
    ConsentInformation.Update(request, OnConsentInfoUpdated);
}

void OnConsentInfoUpdated(FormError consentError)
{
    if (consentError != null)
    {
        // Handle the error.
        UnityEngine.Debug.LogError(consentError);
        return;
    }

    // If the error is null, the consent information state was updated.
    // You are now ready to check if a form is available.
    ConsentForm.LoadAndShowConsentFormIfRequired((FormError formError) =>
    {
        if (formError != null)
        {
            // Consent gathering failed.
            UnityEngine.Debug.LogError(consentError);
            return;
        }

        // Consent has been gathered.
        if (ConsentInformation.CanRequestAds())
        {
            MobileAds.Initialize((InitializationStatus initstatus) =>
            {
              // TODO: Request an ad.
            });
        }
    });
    
}

テスト

開発中にアプリで統合をテストする場合は、 テストデバイスをプログラムで登録します。必ず テストデバイス ID を設定するコードを作成します。

  1. Update()を呼び出します。

  2. ログ出力で、次の例のようなメッセージを確認します。 に、デバイス ID と、テストデバイスとして追加する方法が表示されます。

    Android

    Use new ConsentDebugSettings.Builder().addTestDeviceHashedId("33BE2250B43518CCDA7DE426D04EE231")
to set this as a debug device.

    iOS

    <UMP SDK>To enable debug mode for this device,
set: UMPDebugSettings.testDeviceIdentifiers = @[2077ef9a63d2b398840261c8221a0c9b]

  3. テストデバイス ID をクリップボードにコピーします。

  4. コードを変更して DebugGeography.TestDeviceHashedIds して渡す テストデバイス ID のリスト。

    void Start()
{
    var debugSettings = new ConsentDebugSettings
    {
        TestDeviceHashedIds =
        new List<string>
        {
            "TEST-DEVICE-HASHED-ID"
        }
    };

    // Create a ConsentRequestParameters object.
    ConsentRequestParameters request = new ConsentRequestParameters
    {
        ConsentDebugSettings = debugSettings,
    };

    // Check the current consent information status.
    ConsentInformation.Update(request, OnConsentInfoUpdated);
}

地域を強制的に適用する

UMP SDK を使用すると、デバイスが別のデバイスで動作しているかのようにアプリの動作をテストできます。 EEA または英国に居住している（ the DebugGeography field on ConsentDebugSettingsを使用）注: デバッグ設定はテストデバイスでのみ機能します。

void Start()
{
    var debugSettings = new ConsentDebugSettings
    {
        // Geography appears as in EEA for debug devices.
        DebugGeography = DebugGeography.EEA,
        TestDeviceHashedIds = new List<string>
        {
            "TEST-DEVICE-HASHED-ID"
        }
    };

    // Create a ConsentRequestParameters object.
    ConsentRequestParameters request = new ConsentRequestParameters
    {
        ConsentDebugSettings = debugSettings,
    };

    // Check the current consent information status.
    ConsentInformation.Update(request, OnConsentInfoUpdated);
}

UMP SDK でアプリをテストする場合は、 SDK の状態を評価して、ユーザーが初めてインストールする際の動作をシミュレートできるようにします。 SDK には、これを行うための Reset() メソッドが用意されています。

ConsentInformation.Reset();

GitHub の例