앱 간 동의 동기화 (베타)

플랫폼 선택: Android iOS

사용자에게 중복된 GDPR 메시지가 표시되지 않도록 여러 앱에서 동의를 동기화하세요. 사용자가 동의 동기화가 사용 설정된 앱에서 동의 여부를 결정하면 이 선택사항은 개발자가 제공한 동의 동기화 식별자를 사용하여 저장됩니다. 이 동의 결정은 동일한 동의 동기화 식별자를 공유하는 다른 모든 앱에 자동으로 적용됩니다. Google만 이 식별자를 사용하여 사용자의 동의 결정을 저장하고 검색합니다.

이 가이드에서는 모바일 앱의 사용자 메시지 플랫폼(UMP) SDK에서 GDPR 동의를 동기화하는 방법을 설명합니다.

기본 요건

시작하기 전에 다음을 수행합니다.

  • 시작하기 가이드를 완료합니다.
  • Ad Manager UI의 개인 정보 보호 및 메시지 탭에서 요건을 충족하는 앱에 동의 동기화를 사용 설정합니다.

사용자를 식별할 수 있는 앱에서 UMP SDK에 동의 동기화 ID를 제공합니다. 앱에 사용자 식별자가 없는 경우 앱 세트 ID API와 같은 다른 식별자를 사용하여 여러 앱에서 사용자를 식별합니다.

ConsentRequestParameters 객체에서 동의 동기화 ID를 설정합니다.

자바

import com.google.android.gms.appset.AppSet;
import com.google.android.gms.appset.AppSetIdClient;

// Example fetching App Set ID to identify the user across apps.
AppSetIdClient client = AppSet.getClient(this);
client.getAppSetIdInfo().addOnSuccessListener(
  info -> {
    String appSetId = info.getId();
    ConsentRequestParameters params = new ConsentRequestParameters.Builder()
        .setConsentSyncId(appSetId)
        .build();
  }
);

Kotlin

import com.google.android.gms.appset.AppSet
import com.google.android.gms.appset.AppSetIdInfo

// Example fetching App Set ID to identify the user across apps.
val client = AppSet.getClient(this)
client.appSetIdInfo.addOnSuccessListener { info: AppSetIdInfo ->
  val appSetId = info.id
  val params = ConsentRequestParameters.Builder()
    .setConsentSyncId(appSetId)
    .build()
}

제공하는 식별자는 동의가 동기화되는 모든 앱에서 사용자를 고유하게 식별해야 합니다. 개인 식별 정보 (PII)가 Google에 전송되지 않도록 식별자를 해싱하거나 암호화합니다.

제공된 ID는 다음 요구사항을 충족해야 합니다.

  • UUID 문자열로 구성되거나 정규 표현식 ^[0-9a-zA-Z+.=\/_\-$,{}]{22,150}$와 일치합니다.
  • 22자 이상이어야 합니다.
  • 최대 150자(영문 기준)

다음은 올바른 동의 동기화 ID의 예입니다.

  • 12JD92JD8078S8J29SDOAKC0EF230337
  • 12jd92jd8078s8j29sdoakc0ef230337
  • 12Jd92jD8078s8j29sDoakc0ef230337
  • 123e4567-e89b-12d3-a456-426614174000

요구사항을 충족하지 않으면 동의 동기화 ID가 설정되지 않고 UMP SDK가 콘솔에 경고를 로깅합니다.