- TCF v2.1: TCF v2.1 문자열은 계속 허용하지만, 업계가 TCF v2.2로 전환하고 있으므로 CMP에서 주요 구현 일정에 관한 IAB 지침을 따르는 것이 좋습니다.
- Google 동의 관리 솔루션: Ad Manager, 애드센스, AdMob의 개인 정보 보호 및 메시지 탭에서 사용할 수 있는 Google 동의 관리 솔루션은 CMP 구현 기한인 2023년 11월 20일에 맞춰, 11월 초까지 GDPR 동의 메시지에 대해 IAB의 업데이트된 TCF v2.2를 지원할 계획입니다.
IAB 유럽에서 IAB Tech Lab 및 양 기관 회원사와 함께 개발한 투명성 및 동의 프레임워크 v2.0을 최종 확정했습니다. 이제 Google에서 TCF v2.0을 완벽하게 지원합니다.
게시자가 IAB 유럽의 투명성 및 동의 프레임워크 v2.0 출시와 관련된 오류 및 구성 오류를 관리할 수 있도록 하기 위해, Google에서는 오류 해결을 목적으로 게시자에게 발견된 오류 보고서 및 150일 유예 기간을 제공합니다.
이 도움말에서는 다음 내용을 포함해 TCF v2.2 구현 시의 오류 해결 방법에 대한 자세한 정보를 제공합니다.
업데이트된 가이드라인
업데이트 사항
- 13개월마다 동의를 다시 받아야 한다는 TCF 요구사항 관련 알림:
IAB TCF 정책에 따라, 최소 13개월(390일)에 한 번 동의 선택을 사용자에게 알려야 합니다. 동의 결정을 한 지 13개월이 지난 경우 Google은 해당 TC 문자열을 더 이상 유효하지 않은 것으로 간주하며 해당 사용자에게 광고를 게재하지 않습니다. CMP를 사용하여 13개월 한도에 도달하기 전에 사용자에게 동의 선택을 알려주세요.
- 3.2 오류 유형이 삭제되었습니다. 지난 13개월 사이에 업데이트된 투명성 및 동의(TC) 문자열은 계속 유효합니다.
일반적인 오류 수정
Ad Manager, 애드센스, AdMob에서 자주 발생하는 오류를 다음과 같은 조치로 해결할 수 있습니다.
수익이 창출되지 않는 TC 문자열로 사용자 동의를 다시 받으세요(오류 1.1, 3.1, 4.1, 5.1, 5.2, 6.1)
관련 오류
업데이트된 가이드라인
사용자의 동의를 다시 요청하는 것을 고려해 보세요.
이유
이전에 대역 외, 전역 범위 문자열, (테스트를 통한) 잘못된 CMP ID, (테스트를 통한) 잘못된 GVL ID를 사용했거나 구현 단계 중 적절한 동의를 얻은 공급업체로 Google을 추가하지 않은 게시자는 동의를 다시 요청하는 것이 좋습니다.
오류 1.1, 1.2, 1.3: 우선 대규모 트래픽에서 발생한 오류인지 확인해야 합니다. 대규모 트래픽에서 발생한 경우, CMP 측 문제가 아닌지 확인해야 합니다. 또한, Google이 필요한 목적에 대한 동의를 받았으며 동의 및 적법한 이익을 추구할 수 있는 공급업체(공급업체 ID 755)로 동의를 받았는지 확인해야 합니다.
IAB 사양
CMP는 IAB 사양에 따라 동의 문자열을 13개월 동안 캐시할 수 있습니다.
AddEventHandler로부터의 호출을 반환하도록 하세요(오류 2.1a, 2.1b, 2.0a, 2.0b, 2.0c)
관련 오류
오류 2.1a. 이 가이드라인은 오류 2.1b, 2.0a, 2.0b, 2.0c에도 적용될 수 있습니다.
업데이트된 가이드라인
시간 제한 요구사항은 더 이상 적용되지 않지만, CMP는 구현 상태를 자세히 검토하여 AddEventListener getTCData에 즉시 호출을 반환하는 것이 좋습니다.
CMP가 응답하지 않으면 요청에 대한 수익 창출이 이루어지지 않을 수 있습니다.
이유
Google은 CMP가 AddEventListener 함수에 즉시 응답해야 한다고 명시하는 IAB 사양을 준수합니다. CMP가 즉시 응답하지 않으면 요청에 대한 수익 창출이 이루어지지 않을 수 있습니다.
또한 CMP 응답은 광고 요청이 얼마나 빨리 생성될 수 있는지에 영향을 미치는 요인 중 하나입니다. 페이지 로드와 광고 요청 사이에 소요되는 시간을 줄이면 게시자의 노출 손실이 줄어듭니다.
IAB 사양
적용 가능한 IAB 사양: IAB AddEventListener 사양(GitHub)
loading이고 CMP의 TC 데이터가 불완전하더라도 현재 TC 데이터에 등록되는 즉시 AddEventListener 콜백이 호출되어야 합니다. 이렇게 해야 등록된 listenerId에 호출 스크립트가 액세스할 수 있습니다. 또한 RemoveEventListener를 사용하여 삭제되지 않은 한 TC 문자열이 변경될 때마다 콜백이 호출되어야 합니다.정책 센터
정책 센터에서는 앱 또는 사이트가 Google 동의 관리 요건을 준수하지 않는 경우 게시자에게 알립니다.
오류 보고서
게시자 소유의 사이트 또는 앱 하나 이상과 관련된 TC 문자열에서 문제가 감지되면 제품 사용자 인터페이스를 통해 게시자에게 알립니다. 오류가 발생한 게시자는 계정의 'EU 사용자 동의' 페이지에서 TCF 오류 보고서 다운로드를 클릭하여 최근 7일 동안 감지된 오류에 대한 자세한 보고서를 다운로드할 수 있습니다.
- Ad Manager: 관리
EU 사용자 동의를 클릭합니다.
- AdMob 및 애드센스: 차단 설정
보고서에는 감지된 각 오류에 대한 다음 정보가 포함됩니다.
- 도메인/MobileAppID: 잘못 구성된 사이트 또는 모바일 앱입니다.
- 광고 단위 경로: 오류와 관련된 광고 단위입니다.
- 오류 코드: 오류에 할당된 코드입니다.
- 오류 수: 지난주 동안 오류가 있는 것으로 확인된 쿼리의 수입니다.
- 마지막으로 감지된 날짜: 오류가 마지막으로 감지된 날짜입니다.
게시자는 보고서에 표시된 오류 코드를 사용하여 다음 문제 해결 표에서 추천된 문제 해결 방법을 찾아 실행하여 오류를 해결할 수 있습니다.
문제 해결
게시자가 잘못 구성된 IAB TCF v2.2 통합에 관한 문제를 수정할 수 있도록 Google에서는 가장 일반적인 TC 문자열 오류 유형과 해당하는 문제 해결 권장사항을 다음 표에 정리했습니다.
아래의 표를 참고하여 광고 요청 수준에서 발생하는 문제와 그에 따른 시스템 동작을 확인하세요.
제한된 동의 관련 시나리오
요청에 여러 개의 오류가 있어도 아래의 세 가지 시나리오가 항상 잘못된 구성 오류에 우선하여 적용됩니다.
| 시나리오 | 설명 | 추천 해결 방법 |
|---|---|---|
| 1.1 | Google이 동의 또는 적법한 이익에 따라 공급업체로 허용되지 않습니다. | 사용자가 공급업체로 Google을 의도적으로 거부했는지, CMP 구현 오류가 발생했는지 또는 게시자 제한이 있는지 확인합니다. |
| 1.2 | EEA 국가 및 영국을 위한 '목적 1'에 대해 동의가 이루어지지 않았습니다. |
사용자가 목적 1을 의도적으로 허용하지 않았는지 아니면 CMP 구현 오류 때문인지 확인합니다. 스위스 게시자는 사용자에게 동의를 요청하지 않는 경우
PublisherCC 및 PurposeOneTreatment 필드를 올바르게 설정해야 합니다. 2021년 12월부터 독일의 통신 및 텔레미디어 데이터 보호법에 따라 독일에서 발생한 광고 요청에 대한 |
| 1.3 | 목적 1에 동의하지만 기본 광고에 대한 법적 근거가 없습니다. |
사용자가 다른 목적에 대한 적법한 이익을 의도적으로 거부했는지 또는 CMP 구현 오류 때문인지 확인합니다. |
구성 오류
구성 오류가 존재하는 동안에는 광고 요청에 광고가 반환되지 않습니다.
| 오류 | 설명 | 추천 해결 방법 |
|---|---|---|
| 2.1a | CMP 상태 stub, loading 또는 error로 인해 태그 또는 SDK가 TC 문자열을 수신하지 않습니다. |
광고를 요청하기 위해 함수를 직접 호출하는 경우 광고를 요청하기 위해 함수를 직접 호출하지 않는 경우 CMP가 |
| 2.1b |
다음 두 조건이 모두 충족됩니다.
|
CMP에 IAB TCF 기술 사양에 따라 API를 올바르게 구현하도록 요청하세요. |
| 2.0a |
TC 문자열이 base64로 인코딩되지 않아서 파싱할 수 없습니다. 예: |
CMP(또는 게시자)는 gdpr_consent= 매개변수에 base64로 인코딩된 데이터만 전송해야 합니다. |
| 2.0b |
디코딩 오류로 인해 TC 문자열을 파싱할 수 없습니다. 예: 잘못된 비트 수 포함 |
CMP가 TC 문자열 구현 오류를 수정해야 합니다. |
| 2.0c |
데이터 오류로 인해 TC 문자열을 파싱할 수 없습니다. 예: 잘못된 타임스탬프, 너무 긴 공급업체 ID |
CMP가 TC 문자열 구현 오류를 수정해야 합니다. |
TC 문자열 문제
광고 요청과 관련된 TC 문자열에 문제가 있습니다. 광고 요청이 중단되고 광고가 반환되지 않습니다.
| 오류 | 설명 | 추천 해결 방법 |
|---|---|---|
| 3.1 | CMP ID가 잘못되었습니다. |
IAB에서 검증한 CMP가 사용되고 있으며 ID가 TC 문자열에 올바르게 설정되어 있는지 확인합니다. TC 문자열이 생성되었을 때 CMP가 유효했지만 나중에 IAB에서 삭제한 경우 유효한 CMP를 사용하여 동의를 다시 얻어야 합니다. |
| 3.2 | 더 이상 사용되지 않습니다. | 해결 방법이 없습니다. 이전 의미: TC 문자열 생성 날짜로부터 13개월 이상 지났습니다. |
재동의 필요
사용자의 동의를 얻어야 합니다. 사용자로부터 동의를 얻은 지 13개월이 지났거나 Google이 아직 등록되지 않은 버전의 GVL을 사용하는 경우 사용자의 동의를 다시 얻어야 합니다. 그렇지 않으면 광고 요청이 중단되고 광고가 반환되지 않습니다.
| 오류 | 설명 | 추천 해결 방법 |
|---|---|---|
| 3.3 | TC 문자열의 최종 업데이트 날짜로부터 13개월 이상 지났습니다. |
CMP가 이전의 TC 문자열을 삭제하고 동의를 다시 얻어야 합니다. CMP가 사용자 동의를 무효화하고 다시 동의를 받기 전에, 만료된 TC 문자열과 함께 광고 요청을 전송하는 경우 이러한 오류가 발생할 수 있습니다. 앱에서 Google 동의 관리 솔루션과 UMP SDK를 사용하는 경우 UMP SDK가 올바르게 구현되었는지, 앱이 시작될 때마다 |
| 4.1 | Google이 아직 등록되지 않은 버전의 GVL을 사용하여 TC 문자열이 생성되었습니다. | 현재 버전의 GVL을 사용하여 동의를 다시 얻습니다. |
전역 범위 및 대역 외 범위
전역 범위 및 대역 외 범위(Ad Manager, AdMob, 애드센스) 관련 문제 TC 문자열에 '대역 외' 또는 '전역 범위'가 표시되면 광고가 게재되지 않습니다.
| 오류 | 설명 | 추천 해결 방법 |
|---|---|---|
| 5.1 | TC 문자열이 대역 외 동의를 허용합니다. | TC 문자열에서 대역 외 범위 신호를 삭제하도록 CMP에 지시합니다. |
| 5.2 | 전역 범위가 지정된 TC 문자열입니다. | 구체적인 서비스 범위의 TC 문자열로 업데이트하도록 CMP에 지시합니다. |
제한적인 광고 게재
제한적인 광고가 게재됩니다.
| 오류 | 설명 | 추천 해결 방법 |
|---|---|---|
| 6.1 | TC 문자열 버전이 1 또는 1.1(v1.0 문자열)입니다. |
CMP가 TCF v2.2 문자열을 전송해야 합니다. |
Google에서 문제 처리
이러한 문제가 발생할 경우 필요하면 Google에서 자체적으로 문제를 완화하고 일반적인 TCF 처리 과정을 진행합니다.
| 오류 | 설명 | 추천 해결 방법 |
|---|---|---|
| 7.1 | gdprApplies가 정의되지 않았거나 잘못된 값 또는 식별할 수 없는 값으로 설정되어 있지만 유효한 TC 문자열이 있습니다. |
해당 사항 없음 |
| 7.2 | TC 문자열이 Google의 광고 게재 기술에 반영된 현재 버전보다 최신 버전의 GVL을 사용해 생성되었습니다. | 해당 사항 없음 |
| 7.3 | 일부 목적, 기능 또는 공급업체가 범위를 벗어났습니다(알 수 없음). | 해당 사항 없음 |
| 7.4 | TC 문자열에 최신 GVL보다 오래된 tcf_policy_version이 있습니다. |
CMP가 이전 TC 문자열을 삭제하고 최신 GVL을 사용하여 동의를 다시 얻어야 합니다. |
| 7.5 |
요청에 |
해당 사항 없음 |
| 7.6 | 게시자 국가 코드가 잘못되었지만 목적 1에 대한 동의가 있습니다. | CMP가 TC 문자열 구현 오류를 수정해야 합니다. |
| 7.7 | 언어 코드가 잘못되었습니다. | CMP가 TC 문자열 구현 오류를 수정해야 합니다. |
| 7.8 | TC 문자열 버전 필드가 1도, 2도 아닙니다. |
잘못된 TC 문자열이 감지되면 CMP가 새로운 동의를 요청하여 TC 문자열 구현 오류를 수정해야 합니다. 앱에서 Google 동의 관리 솔루션과 UMP SDK를 사용하는 경우 UMP SDK가 올바르게 구현되었는지, 앱이 시작될 때마다 |
| 7.9 | AC 문자열 버전이 1도, 2도 아닙니다. |
CMP가 AC 문자열 버전을 1 또는 2로 설정해야 합니다. |
AC 문자열 문제
이러한 문제가 발생하는 경우 Google에서는 추가 동의(AC) 문자열을 잘못된 것으로 간주하고 TC 문자열 외에 추가 공급업체를 고려하지 않습니다.
| 오류 | 설명 | 추천 해결 방법 |
|---|---|---|
| 8.1 | AC 문자열이 버전 구분자(~)를 사용하지 않습니다. |
동의한 공급업체 목록에서 버전 번호를 구분하기 위해 CMP가 '~' 구분자를 AC 문자열의 두 번째 문자로 사용해야 합니다. |
| 8.2 | AC 문자열에 예상되는 형식을 따르지 않는 공급업체 목록(' . '로 구분된 int64 목록)이 포함되어 있습니다. | CMP가 AC 문자열 구현 오류를 수정해야 합니다. |
