Google EU 사용자 동의에 따름 정책에 따라 EEA (유럽 경제 지역)의 사용자에게 쿠키 또는 기타 로컬 저장소의 사용에 대한 동의를 얻습니다. 개인 정보 (예: 광고 ID)를 사용하여 광고를 게재하거나, 법적으로 필요한 경우. 이 정책에는 EU 온라인 개인 정보 보호 지침 및 개인 정보 보호법 (GDPR)
게시자가 이 정책의 의무 조항을 준수할 수 있도록 Google은 사용자 메시지 플랫폼 (UMP) SDK. UMP SDK가 최신 IAB 표준을 준수해야 합니다. 이제 이러한 모든 구성을 개인 정보 보호 및 AdMob 개인 정보 보호 및 메시지를 보낼 수 있습니다.
기본 요건
- 시작 가이드를 모두 읽어보세요.
- Android API 수준 21 이상 (Android용)
- GDPR 관련 요구사항을 수행하는 경우 IAB 요구사항이 EU에 미치는 영향 동의 메시지
메시지 유형 만들기
다음 중 하나로 사용자 메시지를 작성합니다. 사용 가능한 사용자 메시지 유형 Privacy & 메시지 탭에서 AdMob 있습니다. UMP SDK는 애플리케이션 ID에서 AdMob 생성된 사용자 메시지 확인할 수 있습니다 애플리케이션에 메시지가 구성되어 있지 않으면 SDK는 오류가 반환됩니다.
자세한 내용은 개인 정보 보호 및 메시지 정보
SDK 설치
단계에 따라 Google 모바일 광고 (GMA) C++를 설치합니다. SDK를 사용하는 것이 좋습니다. UMP C++ SDK는 GMA C++ SDK에 포함되어 있습니다.
앱의 AdMob 앱을 구성해야 합니다. ID 를 선택합니다.
코드에서 다음을 호출하여 UMP SDK를 초기화합니다.
ConsentInfo::GetInstance()
- Android에서는 개발자가 제공하는
JNIEnv
및Activity
를 전달해야 합니다. NDK를 생성합니다. 이 작업은GetInstance()
를 처음 호출할 때만 실행하면 됩니다. - 또는 이미 Firebase C++
SDK를 사용하는 경우
GetInstance()
를 처음 호출할 때firebase::App
에서 발생합니다.
#include "firebase/gma/ump.h" namespace ump = ::firebase::gma::ump; // Initialize using a firebase::App void InitializeUserMessagingPlatform(const firebase::App& app) { ump::ConsentInfo* consent_info = ump::ConsentInfo::GetInstance(app); } // Initialize without a firebase::App #ifdef ANDROID void InitializeUserMessagingPlatform(JNIEnv* jni_env, jobject activity) { ump::ConsentInfo* consent_info = ump::ConsentInfo::GetInstance(jni_env, activity); } #else // non-Android void InitializeUserMessagingPlatform() { ump::ConsentInfo* consent_info = ump::ConsentInfo::GetInstance(); } #endif
- Android에서는 개발자가 제공하는
후속 ConsentInfo::GetInstance()
호출은 모두 동일한 인스턴스를 반환합니다.
UMP SDK 사용을 완료한 경우
ConsentInfo
인스턴스:
void ShutdownUserMessagingPlatform() {
ump::ConsentInfo* consent_info = ump::ConsentInfo::GetInstance();
delete consent_info;
}
Future
를 사용하여 비동기 작업 모니터링
가
firebase::Future
는 비동기 메서드의 완료 상태를 확인하는 방법을 제공합니다.
있습니다.
비동기식으로 작동하는 모든 UMP C++ 함수 및 메서드 호출은
Future
및 '최종 결과'를 제공합니다. Future
를 가져오는 함수
가져올 수 있습니다.
Future
에서 결과를 가져오는 방법에는 두 가지가 있습니다.
OnCompletion()
를 호출합니다. 작업을 호출할 때 호출되는 자체 콜백 함수를 나타냅니다.Future
의status()
를 주기적으로 확인합니다. 이 상태kFutureStatusPending
에서kFutureStatusCompleted
로 변경되면 작업이 완료되었습니다.
비동기 작업이 완료된 후에는
작업의 오류를 가져오기 위한 Future
의 error()
생성합니다. 오류 코드가 0
(kConsentRequestSuccess
)인 경우
또는 kConsentFormSuccess
)
작업이 성공적으로 완료되었습니다. 오류 코드를 확인하고
error_message()
를 사용하여 무엇이 문제인지 확인하세요.
완료 콜백
다음은 OnCompletion
를 사용하여 완료 콜백을 설정하는 방법의 예입니다.
이 메서드는 비동기 작업이 완료되면 호출됩니다.
void MyApplicationStart() {
// [... other app initialization code ...]
ump::ConsentInfo *consent_info = ump::ConsentInfo::GetInstance();
// See the section below for more information about RequestConsentInfoUpdate.
firebase::Future<void> result = consent_info->RequestConsentInfoUpdate(...);
result.OnCompletion([](const firebase::Future<void>& req_result) {
if (req_result.error() == ump::kConsentRequestSuccess) {
// Operation succeeded. You can now call LoadAndShowConsentFormIfRequired().
} else {
// Operation failed. Check req_result.error_message() for more information.
}
});
}
루프 폴링 업데이트
이 예에서는 앱 시작 시 비동기 작업이 시작된 후 게임의 업데이트 루프 함수 (실행되는 1회).
ump::ConsentInfo *g_consent_info = nullptr;
bool g_waiting_for_request = false;
void MyApplicationStart() {
// [... other app initialization code ...]
g_consent_info = ump::ConsentInfo::GetInstance();
// See the section below for more information about RequestConsentInfoUpdate.
g_consent_info->RequestConsentInfoUpdate(...);
g_waiting_for_request = true;
}
// Elsewhere, in the game's update loop, which runs once per frame:
void MyGameUpdateLoop() {
// [... other game logic here ...]
if (g_waiting_for_request) {
// Check whether RequestConsentInfoUpdate() has finished.
// Calling "LastResult" returns the Future for the most recent operation.
firebase::Future<void> result =
g_consent_info->RequestConsentInfoUpdateLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
g_waiting_for_request = false;
if (result.error() == ump::kConsentRequestSuccess) {
// Operation succeeded. You can call LoadAndShowConsentFormIfRequired().
} else {
// Operation failed. Check result.error_message() for more information.
}
}
}
}
firebase::Future
에 관한 자세한 내용은 Firebase C++ SDK를 참조하세요.
문서
및 GMA C++ SDK 문서를 참고하세요.
애플리케이션 ID 추가
다음에서 애플리케이션 ID를 찾을 수 있습니다. AdMob UI ID를 다음 코드 스니펫으로 대체합니다.
동의 정보 요청
모든 앱에서 사용자 동의 정보 업데이트를 요청해야 합니다.
RequestConsentInfoUpdate()
를 사용하여 실행합니다. 이는
사용자가 아직 동의하지 않은 경우 동의를 제공해야 하는지 여부
사용자의 동의가 만료된 경우
#include "firebase/gma/ump.h"
namespace ump = ::firebase::gma::ump;
void MyApplicationStart() {
ump::ConsentInfo* consent_info = ump::ConsentInfo::GetInstance();
// Create a ConsentRequestParameters struct.
ump::ConsentRequestParameters params;
// Set tag for under age of consent. False means users are NOT under age
// of consent.
params.tag_for_under_age_of_consent = false;
consent_info->RequestConsentInfoUpdate(params).OnCompletion(
[](const Future<void>& result) {
if (result.error() != ump::kConsentRequestSuccess) {
LogMessage("Error requesting consent update: %s", result.error_message());
} else {
// Consent status is now available.
}
});
}
다음을 사용하여 완료 여부를 확인하는 예는 위를 참조하세요. 업데이트 루프 폴링을 사용해야 합니다.
필요한 경우 동의 양식 로드 및 표시
최신 동의 상태를 받은 후
LoadAndShowConsentFormIfRequired()
ConsentInfo
클래스를 사용하여 동의 양식을 로드합니다. 만약
동의 상태가 필요한 경우 SDK가 양식을 로드하고 즉시 제시
제공된 값에서 FormParent
. Future
완료 양식이 닫힌 후에 호출됩니다. 동의가 필요하지 않은 경우 Future
완료 즉시 호출됩니다.
void MyApplicationStart(ump::FormParent parent) {
ump::ConsentInfo* consent_info = ump::ConsentInfo::GetInstance();
// Create a ConsentRequestParameters struct..
ump::ConsentRequestParameters params;
// Set tag for under age of consent. False means users are NOT under age of consent.
params.tag_for_under_age_of_consent = false;
consent_info->RequestConsentInfoUpdate(params).OnCompletion(
[*](const Future<void>& req_result) {
if (req_result.error() != ump::kConsentRequestSuccess) {
// req_result.error() is a kConsentRequestError enum.
LogMessage("Error requesting consent update: %s", req_result.error_message());
} else {
consent_info->LoadAndShowConsentFormIfRequired(parent).OnCompletion(
[*](const Future<void>& form_result) {
if (form_result.error() != ump::kConsentFormSuccess) {
// form_result.error() is a kConsentFormError enum.
LogMessage("Error showing consent form: %s", form_result.error_message());
} else {
// Either the form was shown and completed by the user, or consent was not required.
}
});
}
});
}
사용자가 결정을 내렸거나 닫은 후 작업을 실행해야 하는 경우
양식에서 Future
를 처리하는 코드에 로직을 배치합니다.
LoadAndShowConsentFormIfRequired()
에서 반환함
광고 요청
앱에서 광고를 요청하기 전에 동의를 얻었는지 확인하세요.
ConsentInfo::GetInstance()‑>CanRequestAds()
를 사용하여 사용자로부터 반환합니다. 두 가지
동의를 수집할 때 확인해야 할 곳은 다음과 같습니다.
- 현재 세션에서 동의가 수집된 후
-
RequestConsentInfoUpdate()
를 호출한 직후 이전 세션에서 동의를 받았을 수 있습니다. 지연 시간 콜백이 완료될 때까지 기다리지 않는 것이 좋습니다. 그래야 최대한 빨리 광고 로드를 시작하세요
동의 수집 과정에서 오류가 발생하더라도 광고를 요청할 수 없습니다. UMP SDK는 이전 세션입니다.
다음 전체 예에서는 업데이트 루프 폴링을 사용하지만
OnCompletion
콜백을 사용하여 비동기 작업을 모니터링합니다. 사용
코드 구조에 더 적합한 기법을 사용할 수 있습니다.
#include "firebase/future.h"
#include "firebase/gma/gma.h"
#include "firebase/gma/ump.h"
namespace gma = ::firebase::gma;
namespace ump = ::firebase::gma::ump;
using firebase::Future;
ump::ConsentInfo* g_consent_info = nullptr;
// State variable for tracking the UMP consent flow.
enum { kStart, kRequest, kLoadAndShow, kInitGma, kFinished, kErrorState } g_state = kStart;
bool g_ads_allowed = false;
void MyApplicationStart() {
g_consent_info = ump::ConsentInfo::GetInstance(...);
// Create a ConsentRequestParameters struct..
ump::ConsentRequestParameters params;
// Set tag for under age of consent. False means users are NOT under age of consent.
params.tag_for_under_age_of_consent = false;
g_consent_info->RequestConsentInfoUpdate(params);
// CanRequestAds() can return a cached value from a previous run immediately.
g_ads_allowed = g_consent_info->CanRequestAds();
g_state = kRequest;
}
// This function runs once per frame.
void MyGameUpdateLoop() {
// [... other game logic here ...]
if (g_state == kRequest) {
Future<void> req_result = g_consent_info->RequestConsentInfoUpdateLastResult();
if (req_result.status() == firebase::kFutureStatusComplete) {
g_ads_allowed = g_consent_info->CanRequestAds();
if (req_result.error() == ump::kConsentRequestSuccess) {
// You must provide the FormParent (Android Activity or iOS UIViewController).
ump::FormParent parent = GetMyFormParent();
g_consent_info->LoadAndShowConsentFormIfRequired(parent);
g_state = kLoadAndShow;
} else {
LogMessage("Error requesting consent status: %s", req_result.error_message());
g_state = kErrorState;
}
}
}
if (g_state == kLoadAndShow) {
Future<void> form_result = g_consent_info->LoadAndShowConsentFormIfRequiredLastResult();
if (form_result.status() == firebase::kFutureStatusComplete) {
g_ads_allowed = g_consent_info->CanRequestAds();
if (form_result.error() == ump::kConsentRequestSuccess) {
if (g_ads_allowed) {
// Initialize GMA. This is another asynchronous operation.
firebase::gma::Initialize();
g_state = kInitGma;
} else {
g_state = kFinished;
}
// Optional: shut down the UMP SDK to save memory.
delete g_consent_info;
g_consent_info = nullptr;
} else {
LogMessage("Error displaying consent form: %s", form_result.error_message());
g_state = kErrorState;
}
}
}
if (g_state == kInitGma && g_ads_allowed) {
Future<gma::AdapterInitializationStatus> gma_future = gma::InitializeLastResult();
if (gma_future.status() == firebase::kFutureStatusComplete) {
if (gma_future.error() == gma::kAdErrorCodeNone) {
g_state = kFinished;
// TODO: Request an ad.
} else {
LogMessage("Error initializing GMA: %s", gma_future.error_message());
g_state = kErrorState;
}
}
}
}
공개 설정 옵션
일부 동의 양식은 사용자가 언제든지 동의를 수정해야 합니다. 준수 필요한 경우 다음 단계로 이동하여 개인 정보 보호 옵션 버튼을 구현합니다.
이 경우 방법은 다음과 같습니다.
- 앱 설정 페이지의 버튼과 같은 UI 요소를 구현합니다. 개인 정보 보호 옵션 양식을 트리거할 수 있습니다.
- 완료되면
LoadAndShowConsentFormIfRequired()
다음을 확인합니다.getPrivacyOptionsRequirementStatus()
표시될지 아니면 개인 정보 보호 옵션 양식을 표시할 수 있는 UI 요소입니다. - 사용자가 UI 요소와 상호작용하면
showPrivacyOptionsForm()
양식을 표시하여 사용자가 언제든지 개인 정보 보호 옵션을 업데이트할 수 있습니다
테스트
개발하는 동안 앱에서 통합을 테스트하려면 다음 단계에 따라 테스트 기기를 프로그래매틱 방식으로 등록하세요. 반드시 를 사용하는 것이 좋습니다.
-
RequestConsentInfoUpdate()
를 호출합니다. 로그 출력에서 다음 예와 비슷한 메시지를 확인합니다. 에 기기 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]
테스트 기기 ID를 클립보드에 복사합니다.
코드를 수정하여
ConsentRequestParameters.debug_settings.debug_device_ids
받는사람 테스트 기기 ID 목록입니다.void MyApplicationStart() { ump::ConsentInfo consent_info = ump::ConsentInfo::GetInstance(...); ump::ConsentRequestParameters params; params.tag_for_under_age_of_consent = false; params.debug_settings.debug_device_ids = {"TEST-DEVICE-HASHED-ID"}; consent_info->RequestConsentInfoUpdate(params); }
지역 강제 설정
UMP SDK는 마치 기기가 제대로 작동하지 않는 것처럼 앱 동작을 테스트하는 방법을 제공합니다.
ConsentRequestParameters.debug_settings.debug_geography
를 사용하여 EEA 또는 영국에 거주 참고:
디버그 설정은 테스트 기기에서만 작동합니다.
void MyApplicationStart() {
ump::ConsentInfo consent_info = ump::ConsentInfo::GetInstance(...);
ump::ConsentRequestParameters params;
params.tag_for_under_age_of_consent = false;
params.debug_settings.debug_device_ids = {"TEST-DEVICE-HASHED-ID"};
// Geography appears as EEA for debug devices.
params.debug_settings.debug_geography = ump::kConsentDebugGeographyEEA
consent_info->RequestConsentInfoUpdate(params);
}
동의 상태 재설정
UMP SDK로 앱을 테스트할 때
사용자의 첫 설치 환경을 시뮬레이션할 수 있습니다.
SDK에서는 이를 위한 Reset()
메서드를 제공합니다.
ConsentInfo::GetInstance()->Reset();