얘들아 안녕, 다들 개발 잘 하고 있어?
저번 달에 GDPR 구현하다가 막혀서 여기다 글을 올렸었는데, 다행히 이젠 해결한 것 같아.
그 당시 해결하면 팁 남겨달라던 친구의 댓글이 기억나서 다시 돌아왔어.
사실 GDPR은 나온지가 진짜 오래 되었어.
심지어 구글 애드몹 기준으로도 ‘24년 1월 16일까지 대응 필수!’라며 경고를 엄청 띄워왔었기에 대부분 대응을 완료 했을 거라고 생각해.
그래도 이제 개발하는 친구들은 모를 수도 있을테니 도움이 되었으면 하는 마음에 남겨봐.
그럼 시작해보자.
GDPR이 뭐임?
정확한 명칭은 유럽 개인정보 보호법이라는데, 간단히 이야기하면
“유럽 유저들의 개인 정보를 가져다 쓰려면 직접 허락을 받아라’”
라고 할 수 있어. 애플의 ATT와 비슷한데, 조건이 안 맞으면 광고를 아예 못 튼다는 부분에서 조금 더 빡센 느낌이야.
더 상세한 내용이 궁금한 친구들은 구글에 GDPR로 검색하면 자료가 쏟아지니까 확인해보자.
사실 인디 게임 개발자인 우리가 알아야 될 것은 하나인 것 같아.
“유럽(+ 영국)에서 광고로 돈 벌려면 GDPR 동의 팝업을 추가해야 함.”
GDPR 대응 안하면 어떻게 되는데?
중요한 건 GDPR의 대상이 그 이름처럼 유럽(+영국) 한정이라는거야.
즉, 아직 글로벌 서비스를 계획하고 있지 않다면 신경 쓸 필요가 없어.
하지만 서비스의 대상에 유럽(+영국)가 포함된다면, GDPR 동의를 받지 않은 유저들에겐 광고를 아예 띄울 수 없어.
다만 이미 서비스 중인 게임 기준, 따로 GDPR을 구현하지 않더라도 어떻게든 애드몹이 온몸 비틀기로 GDPR 동의를 띄우는 것 같아.
다만 제대로 된 팝업은 아닌 것으로 보이고, 그래서인지 동의율이 낮아.
거기다 애드몹이 이런 식의 땜빵을 꾸준히 해준다는 보장도 없으니, 아직 대응을 안했거나 신규 개발 중이라면 GDPR 처리를 해 두는걸 권장해.
그렇다면 어떻게 대응하는가?
앞에서 말했듯이 애드몹에서 최근에 필수로 변경해서 그렇지, GDPR 자체는 몇 년도 전에 있었어.
때문에 GDPR을 처리할 수 있는 방법은 다양해.
애드몹처럼 광고 플랫폼이 제공하는 기능을 사용해도 되고, 아예 GDPR을 별도로 처리해주는 서비스도 있다고 들었어.
근데 난 애드몹으로 처리했으니, 애드몹 기준으로 설명할게.
애드몹에서 GDPR을 처리하려면, 크게 2가지가 필요해.
바로 팝업과 구현이야.
팝업 추가하기
먼저 애드몹의 ‘개인 정보 보호 및 메시지’ 메뉴로 들어가서, 유럽 규정의 ‘관리’로 들어가.
그럼 이렇게 메시지 만들기를 선택할 수 있고
이후에 나오는 페이지에서 GDPR 페이지 설정을 마무리하면 돼.
여기서 신경 써야 할 것은 3가지인 것 같아.
1, 2 - 둘 다 유저에게 미동의 버튼을 얼마나 적극적으로 보여주느냐를 결정하는 기능이야.
개발자 입장에선 동의율이 높은 게 좋으니 둘 다 사용안함으로 두는 게 유리할 거야.
3 - 해당 팝업을 몇 가지 언어로 지원하는지를 결정하는 부분이야.
기본은 영어로 되어있고, 다양한 언어를 지원하길래 나는 31개 추가언어를 모두 활성화했어.
여기까지 세팅하고 ‘게시’ 버튼 누르면 팝업에 대한 세팅은 끝이야.
팝업 구현하기
저것만 추가하고 끝나면 참 좋은데... 안타깝게도 코드 딴에서 직접 저 팝업을 호출해줘야 하더라.
애드몹에서 직접 설명하고 있고, 코드가 복잡하지 않으니 직접 확인해보면 될 거야.
https://developers.google.com/admob/unity/privacy?hl=ko
하면서 내가 겪었던 문제를 몇 가지 공유하면 다음과 같아.
- 싱글 스레드 에러가 발생하면 아래 코드를 추가해 줘야 함.
MobileAds.RaiseAdEventsOnUnityMainThread = true;
- 테스트를 위해 핸드폰의 Hashed ID가 필요한데, 테스트 빌드를 로그캣에 물려서 돌려보면 로그에 찍힘.
이렇게 코드까지 추가해주면 기본적인 작업은 끝이야.
추가 처리 (선택)
앞선 2개만 처리하면 돌리는 것은 문제가 없어. 그러니 대부분의 경우엔 이 정도에서 구현을 마쳐도 괜찮을거야.
하지만 내 경우는 상세한 정보를 필요했는데, 이런 것들이야.
- 이 유저가 GDPR의 대상인지 아닌지
- 지금 애드몹이 광고를 안주는게 유저가 GDPR 동의를 안 해서 그런 건지, 그냥 광고 슬롯이 빈 건지
- 개인화 광고 여부
특히 ‘주모 키우기’에선 광고 슬롯이 비어 있는 게 유저 잘못은 아니라고 생각해서 리워드 보상을 주고 있었단 말야.
하지만 GDPR에 비동의한 유저도 광고 슬롯은 똑같이 비어있는 것으로 확인되었고, 때문에 GDPR의 동의 상태 확인이 무척 중요해졌지.
저번에 문의 글을 남긴 이유도 이 부분의 방법을 찾지 못해서 그런거였어.
하지만 열심히 뒤지다보니 다 방법이 있긴 하더라.
여기서부터는 링크로 대체할게.
애드몹에서 GDPR 동의 수준 확인하는 법
https://stackoverflow.com/questions/69307205/mandatory-consent-for-admob-user-messaging-platform
유니티에서 자바 클래스 호출해서 확인하는 법
https://groups.google.com/g/google-admob-ads-sdk/c/uIQkJX6_XtM/m/KIFmbfXVAQAJ
애드몹의 파트너 플랫폼 별 ID 확인 (앱로빈 - 1301, 유니티애즈 - 3234)
https://support.google.com/admob/answer/9681920?hl=en // 이 페이지의 Where will the Google ATPs be published? 메뉴에서 받음
여기 글들을 잘 읽어보면 대응이 가능하긴 한데... 솔직히 나도 엄청 헤맸다보니 사람에 따라선 부족할 수 있다 싶어.
그러니 내가 구현한 코드도 함께 남겨둘게. 이해가 어려운 친구들은 참고해 봐.
{
MobileAds.RaiseAdEventsOnUnityMainThread = true; // 애드몹 관련 처리는 메인 스레드에서만 처리하도록 처리
#if !UNITY_EDITOR // 에디터에선 GDPR 동의 홀드
Debug.Log("GDPR 동의 프로세스 스타트");
#if DEBUGBUILD // 테스트 빌드에서만 테스트모드 활성화
Debug.Log("테스트 버전 - 초기화 후 체크 개시!");
ConsentInformation.Reset(); // 테스트를 위해 기존 GDPR 정보 초기화
var debugSettings = new ConsentDebugSettings
{
DebugGeography = DebugGeography.EEA, // 일시적으로 유럽인척
#if UNITY_IOS
TestDeviceHashedIds = new List<string> {"여기에 아이폰 해시 ID"}
#else
TestDeviceHashedIds = new List<string> {"여기에 안드로이드 해시 ID"}
#endif
};
ConsentRequestParameters request = new ConsentRequestParameters {ConsentDebugSettings = debugSettings};
ConsentInformation.Update(request, OnConsentInfoUpdated);
#else // 릴리즈 & 디스트리뷰트에선 GDPR 테스트 모드 끄기
Debug.Log("릴리즈 버전 - 체크 개시!");
ConsentRequestParameters request = new ConsentRequestParameters();
ConsentInformation.Update(request, OnConsentInfoUpdated);
#endif
#else
// 구글 애즈 초기화
Debug.Log("애드몹 초기화 시도!");
MobileAds.Initialize(initStatus =>
{
StartAdSet();
});
#endif
}
void OnConsentInfoUpdated(FormError consentError)
{
Debug.Log("GDPR 동의 상태 콜백 확인");
if (consentError != null)
{
Debug.Log("동의 상태 확인 실패: " + consentError);
return;
}
Debug.Log("GDPR 동의 상태 확인 완료!");
ConsentForm.LoadAndShowConsentFormIfRequired((FormError formError) =>
{
Debug.Log("양식 로드 시도");
if (formError != null)
{
Debug.Log("동의 획득 실패: " + consentError);
return;
}
if (CurrentGdpr.IsGDPR()) // GDPR을 검사하는 국가에서만 체크
{
isNoAd = !CurrentGdpr.CanAdShow();
if (CurrentGdpr.IsPartnerConsent("1301")) // 앱로빈 확인
{
AppLovin.SetHasUserConsent(true);
Debug.Log("앱로빈 GDPR 켜짐");
}
if (CurrentGdpr.IsPartnerConsent("3234")) // 유니티애즈 확인
{
UnityAds.SetConsentMetaData("gdpr.consent", true);
Debug.Log("유니티애즈 GDPR 켜짐");
}
}
else
isNoAd = false;
Debug.Log("GDPR 적용 여부: " + CurrentGdpr.IsGDPR());
Debug.Log("동의 성공. 현재 광고 재생 가능? " + !isNoAd);
Debug.Log("개인화된 광고 가능? " + CurrentGdpr.CanShowPersonalizedAds());
if (ConsentInformation.CanRequestAds())
{
// 구글 애즈 초기화
Debug.Log("애드몹 초기화 시도!");
MobileAds.Initialize(initStatus =>
{
StartAdSet();
});
}
else
Debug.Log("광고 요청 불가 상태...");
});
여기까지가 GDPR 세팅 및 팝업 호출 & 애드몹 초기화고
public static class CurrentGdpr
{
private static bool _isGdprOn;
private static string _purposeConsent, _vendorConsent, _vendorLi, _purposeLi, _partnerConsent;
static CurrentGdpr()
{
SetData();
}
public static void SetData()
{
int gdprNum;
#if UNITY_EDITOR // 에디터에서는 자바 호출이 에러나서 에외처리
gdprNum = 1;
_purposeConsent = "0000000000";
_vendorConsent = "0000000000";
_vendorLi = "";
_purposeLi = "";
_partnerConsent = "";
#elif UNITY_ANDROID
AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
AndroidJavaObject currentActivity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity");
AndroidJavaClass preferenceManagerClass = new AndroidJavaClass("android.preference.PreferenceManager");
AndroidJavaObject sharedPreferences =
preferenceManagerClass.CallStatic<AndroidJavaObject>("getDefaultSharedPreferences", currentActivity);
gdprNum = sharedPreferences.Call<int>("getInt", "IABTCF_gdprApplies", 0);
_purposeConsent = sharedPreferences.Call<string>("getString", "IABTCF_PurposeConsents", "");
_vendorConsent = sharedPreferences.Call<string>("getString", "IABTCF_VendorConsents", "");
_vendorLi = sharedPreferences.Call<string>("getString", "IABTCF_VendorLegitimateInterests", "");
_purposeLi = sharedPreferences.Call<string>("getString", "IABTCF_PurposeLegitimateInterests", "");
_partnerConsent = sharedPreferences.Call<string>("getString", "IABTCF_AddtlConsent", "");
#elif UNITY_IOS
gdprNum = PlayerPrefs.GetInt("IABTCF_gdprApplies", 0);
_purposeConsent = PlayerPrefs.GetString("IABTCF_PurposeConsents", "");
_vendorConsent = PlayerPrefs.GetString("IABTCF_VendorConsents", "");
_vendorLi = PlayerPrefs.GetString("IABTCF_VendorLegitimateInterests", "");
_purposeLi = PlayerPrefs.GetString("IABTCF_PurposeLegitimateInterests", "");
_partnerConsent = PlayerPrefs.GetString("IABTCF_AddtlConsent", "");
#endif
// 0 이면 아예 GDPR 대상이 아님. 1이어야 GDPR
if (gdprNum == 1)
_isGdprOn = true;
else
_isGdprOn = false;
Debug.Log("GDPR을 띄우는가? " + _isGdprOn);
Debug.Log("광고에 필요한 권한 동의: " + _purposeConsent);
Debug.Log("광고에 필요한 적법관심(?) 동의: " + _vendorConsent);
Debug.Log("구글에 동의처리가 되어있는가?: " + _vendorLi);
Debug.Log("구글에 적법관심(?) 처리 여부: " + _purposeConsent);
Debug.Log("파트너 네트워크 여부: " + _partnerConsent);
}
// GDPR을 띄워야 할 유저인지(= 유럽 + 영국) 리턴
public static bool IsGDPR()
{
return _isGdprOn;
}
// 광고가 보여지는지 여부 리턴
public static bool CanAdShow()
{
int googleId = 755;
bool hasGoogleVendorConsent = HasAttribute(_vendorConsent, googleId);
bool hasGoogleVendorLi = HasAttribute(_vendorLi, googleId);
// 광고 가능 - 비개인화 광고
// return HasConsentFor(new List<int> { 1 }, _purposeConsent, hasGoogleVendorConsent)
// && HasConsentOrLegitimateInterestFor(new List<int> { 2, 7, 9, 10 },
// _purposeConsent, _purposeLi, hasGoogleVendorConsent, hasGoogleVendorLi);
// 광고 가능 - 제한적인 광고 - 1에 대한 권한이 없어도 됨 ㅇㅇ
return HasConsentOrLegitimateInterestFor(new List<int> { 2, 7, 9, 10 },
_purposeConsent, _purposeLi, hasGoogleVendorConsent, hasGoogleVendorLi);
}
// 개인화 광고가 보여지는지 여부 리턴
public static bool CanShowPersonalizedAds()
{
int googleId = 755;
bool hasGoogleVendorConsent = HasAttribute(_vendorConsent, googleId);
bool hasGoogleVendorLi = HasAttribute(_vendorLi, googleId);
return HasConsentFor(new List<int> { 1, 3, 4 }, _purposeConsent, hasGoogleVendorConsent)
&& HasConsentOrLegitimateInterestFor(new List<int> { 2, 7, 9, 10 },
_purposeConsent, _purposeLi, hasGoogleVendorConsent, hasGoogleVendorLi);
}
public static bool IsPartnerConsent(string partnerID) // 파트너 권한 있는지 확인
{
return _partnerConsent.Contains(partnerID);
}
// 이진 문자열의 "index" 위치에 "1"이 있는지 확인합니다(1 기반).
private static bool HasAttribute(string input, int index)
{
return input.Length >= index && input[index - 1] == '1';
}
// 목적 목록에 대한 동의가 주어졌는지 확인합니다.
private static bool HasConsentFor(List<int> purposes, string purposeConsent, bool hasVendorConsent)
{
return purposes.All(p => HasAttribute(purposeConsent, p)) && hasVendorConsent;
}
// 목적 목록에 대한 공급자의 동의 또는 정당한 이익이 있는지 확인합니다.
private static bool HasConsentOrLegitimateInterestFor(List<int> purposes, string purposeConsent, string purposeLI, bool hasVendorConsent, bool hasVendorLI)
{
return purposes.All(p =>
(HasAttribute(purposeLI, p) && hasVendorLI) ||
(HasAttribute(purposeConsent, p) && hasVendorConsent));
}
}
이건 GDPR에 대한 세부 속성을 확인하는 코드야.
위의 링크에 있는 코드들을 C#으로 변경하고, 최신 상황에 맞춰 수정한거야.
자, 대충 여기까지야.
나 또한 구현에 시간이 걸리다보니 애드몹이 말한 제한시간을 넘겨서 GDPR을 추가하게 되었어.
그러다보니 본의 아니게 애드몹 기본 제공 GDPR을 몇 일간 사용하게 되었었는데, 차이는 다음과 같아.
위쪽이 애드몹에서 제공하는 기본 구현일 때, 아래쪽이 지금 상황이야. 1주일 남짓인데 그 사이에 레이아웃이 바뀌었네. 흠?;
데이터가 적어 객관성은 떨어지지만, 일단 구현을 처리한 쪽이 동의율이 높긴 한 것 같아.
위에서 따로 이야기는 안했지만, GDPR 동의를 끈 유저들이 광고 시청을 시도할 때는 '옵션에서 GDPR을 켜!' 라고 안내도 하고 있어.
어때, 조금 도움이 되었을까?
처음 게임을 출시할 때 GDPR 같은 것은 신경 안써도 되었었는데, 어째 점점 챙겨야 될 게 많아지는 느낌이네.
1주일 넘게 서비스하면서 문제를 발견하진 못했지만, 맨 땅에 헤딩하면서 찾은 정보다 보니 틀린 내용도 있을 수 있어.
혹시 잘 아는 친구들은 수정사항을 댓글로 남겨주면 맞춰서 반영할게.
자 그럼 다들 개발 열심히 해!
2024.02.02 14:47:52
댓글 영역
획득법
① NFT 발행
작성한 게시물을 NFT로 발행하면 일주일 동안 사용할 수 있습니다. (최초 1회)
② NFT 구매
다른 이용자의 NFT를 구매하면 한 달 동안 사용할 수 있습니다. (구매 시마다 갱신)
사용법
디시콘에서지갑연결시 바로 사용 가능합니다.