[문제 해결]하나 이상의 사이트 또는 앱에서 IAB TC 문자열에서 문제가 발견되었습니다.

떠돌이개발자Nov 29, 2023

애드센스 사이트에 로그인을 해보니 IAB TC문자열에서 문제가 발견되었는 알림창이 보입니다.

하나 이상의 사이트 또는 앱에서 IAB TC 문자열에서 문제가 발견되었습니다. 이러한 오류는 유럽 사용자에게 광고를 게재할 경우 영향을 미칠 수 있습니다. 세부 보고서는 EU 사용자 동의 페이지에서 확인할 수 있습니다.

EU 사용자를 대상으로 개인 맞춤아닌 광고로 설정해두었는데

이런 일이 발생합니다. 이유가 무엇일까요?

TCF오류 보고서 다운로드를 클릭하여 보니

csv파일이 다운로되고 해당 엑셀 파일을 열어보았습니다.

보고서에는 감지된 각 오류에 대한 다음 정보가 포함됩니다.

도메인/MobileAppID: 잘못 구성된 사이트 또는 모바일 앱입니다.
광고 단위 경로: 오류와 관련된 광고 단위입니다.
오류 코드: 오류에 할당된 코드입니다.
오류 수: 지난주 동안 오류가 있는 것으로 확인된 쿼리의 수입니다.
마지막으로 감지된 날짜: 오류가 마지막으로 감지된 날짜입니다.

오류 보고서는 왜 노출되었는가?

하나 이상의 사이트 또는 앱과 관련된 TC 문자열에서 문제가 감지되면 제품 사용자 인터페이스를 통해 게시자에게 알립니다. 게시자는 계정의 ‘EU 사용자 동의’ 페이지에서 TCF 오류 보고서 다운로드를 클릭하여 최근 7일 동안 감지된 오류에 대한 자세한 보고서를 다운로드할 수 있습니다.

이 보고서는 최근 7일 동안 오류가 감지된 경우에만 사용할 수 있습니다.

IAB TC 문자열 오류 해결방법

게시자는 보고서에 표시된 오류 코드를 사용하여 다음 문제 해결 표에서 추천된 문제 해결 방법을 찾아 실행하여 오류를 해결할 수 있습니다.

아래의 표를 참고하여 광고 요청 수준에서 발생하는 문제와 그에 따른 시스템 반응을 확인하세요.

제한된 동의 관련 상황

상황 1.1과 1.3에서는 항상 광고 요청이 제외되어 광고가 반환되지 않습니다. 상황 1.2에서는 이와 반대입니다. 요청 1건에 여러 오류가 있어도 아래의 세 가지 상황이 항상 잘못된 구성 오류에 우선하여 적용됩니다.

상황

오류 코드	설명	추천 해결 방법
1.1	Google이 동의 또는 적법한 이익에 따라 공급업체로 허용되지 않습니다. 광고 요청이 제외되고 광고가 반환되지 않습니다.	사용자가 공급업체로 Google을 의도적으로 거부했는지, CMP 구현 오류가 발생했는지 또는 게시자 제한이 있는지 확인합니다.
1.2	EEA 국가 및 영국을 위한 ‘목적 1’에 대한 동의가 부재합니다.	사용자가 목적 1을 고의적으로 허용하지 않았는지 또는 CMP 구현 오류 때문인지 확인합니다. 독일 게시자는 사용자에게 동의를 요청하지 않는 경우 PublisherCC 및 PurposeOneTreatment 필드를 올바르게 설정해야 합니다.
1.3	목적 1에 대한 동의가 존재하지만 ‘기본 광고’에 대한 법적 근거가 없습니다. 광고 요청이 제외되고 광고가 반환되지 않습니다.	사용자가 다른 목적으로 적법한 이익을 고의적으로 거부했는지 또는 CMP 구현 오류 때문인지 확인합니다.

구성 오류

구성 오류가 존재하는 동안에는 광고 요청에 광고가 반환되지 않습니다.

오류 코드	설명	추천 해결 방법
2.1a	stub, loading, error인 CMP 상태로 인해 태그 또는 SDK에 TC 문자열이 수신되지 않습니다.	광고를 요청하기 위해 함수를 직접 호출하는 경우 응답이 getTCData TCData.eventStatus = ‘tloadload’ 또는 ‘cmpuishowed’ + ‘useractioncomplete’이어야 합니다. 이는 CMP가 사용자에게 동의와 관련된 선택사항을 제공할 준비가 되었음을 나타냅니다. 광고를 요청하기 위해 함수를 직접 호출하지 않는 경우 CMP를 통해 getTCData 지원을 구현하고 TCData.eventStatus = ‘tcloaded’ 또는 ‘cmpuishowed’ + ‘ useractioncomplete’을 반환하도록 하여 API를 통해 사용자 동의를 사용할 준비가 되었음을 나타내세요.

2.1b	다음 두 조건이 모두 충족됩니다. CMP가 &gdpr=1로 설정됩니다. &gdpr_consent=이 요청에 있지만 TC 문자열이 비어 있습니다.	CMP에 IAB TCF 기술 사양에 따라 API가 올바르게 구현되었는지 확인을 요청하세요.
2.2a	TC 문자열이 base64로 인코딩되지 않아서 파싱할 수 없습니다. 예: “2”	CMP(또는 게시자)는 gdpr_consent= 매개변수에 base64로 인코딩된 데이터만 전송해야 합니다.
2.2b	디코딩 오류로 인해 TC 문자열을 파싱할 수 없습니다. 예: 잘못된 비트 수 포함	CMP가 TC 문자열 구현 오류를 수정해야 합니다.
2.2c	데이터 오류로 인해 TC 문자열을 파싱할 수 없습니다. 예: 잘못된 타임스탬프, 공급업체 ID가 너무 김	CMP가 TC 문자열 구현 오류를 수정해야 합니다.

TC 문자열 문제

광고 요청과 관련된 TC 문자열에 문제가 있습니다. 광고 요청이 제외되고 광고가 반환되지 않습니다.

오류 코드	설명	추천 해결 방법
3.1	CMP ID가 잘못되었습니다.	IAB에서 검증한 CMP가 사용되고 있으며 ID가 TC 문자열에 올바르게 설정되어 있는지 확인합니다. TC 문자열이 생성되었을 때 CMP가 유효했지만 나중에 IAB에서 삭제한 경우 유효한 CMP를 사용하여 동의를 다시 얻어야 합니다.

3.2	더 이상 사용되지 않습니다.	이전 의미: TC 문자열 생성 날짜로부터 13개월 이상 지났습니다. CMP가 이전의 TC 문자열을 삭제하고 동의를 다시 얻어야 합니다.
3.3	TC 문자열의 최종 업데이트 날짜로부터 13개월 이상 지났습니다.	CMP가 이전의 TC 문자열을 삭제하고 동의를 다시 얻어야 합니다.

재동의 필요

사용자의 동의를 얻어야 합니다. 사용자로부터 동의를 얻은 지 13개월 이상 지났거나 Google에서 GVL에 가입하기 전에 동의를 얻은 경우 사용자의 동의를 다시 얻어야 합니다. 그렇지 않으면 광고 요청이 제외되고 광고가 반환되지 않습니다.

오류 코드	설명	추천 해결 방법
4.1	Google이 아직 등록되지 않은 GVL 버전을 사용하여 TC 문자열이 생성되었습니다.	Google을 포함하는 업데이트된 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.0 문자열을 전송해야 합니다.

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	요청에 &gdpr=1이 있지만 요청 URL에 &gdpr_consent 매개변수가 전혀 없습니다.	해당 사항 없음
7.6	게시자 국가 코드가 잘못되었지만 목적 1에 대한 동의가 있습니다.	CMP가 TC 문자열 구현 오류를 수정해야 합니다.
7.7	언어 코드가 잘못되었습니다.	제한적인 광고만 게재됩니다. CMP가 TC 문자열 구현 오류를 수정해야 합니다.
7.8	TC 문자열 버전 필드가 1도 아니고 2도 아닙니다.	제한적인 광고만 게재됩니다. CMP가 TC 문자열 구현 오류를 수정해야 합니다.
7.9	AC 문자열 버전이 1이 아닙니다.	CMP가 AC 문자열 버전을 1로 설정해야 합니다.

AC 문자열 문제

이러한 문제가 발생하는 경우 Google에서는 추가 동의(AC) 문자열을 잘못된 것으로 간주하고 TC 문자열 외에 추가 공급업체를 고려하지 않습니다.

오류 코드	설명	추천 해결 방법
8.1	AC 문자열이 버전 구분자(~)를 사용하지 않습니다.	동의한 공급업체 목록에서 버전 번호를 구분하려면 CMP가 ‘~’ 구분자를 AC 문자열의 두 번째 문자로 사용해야 합니다.
8.2	AC 문자열에는 예상되는 형식을 따르지 않는 공급업체 목록(‘ . ‘로 구분된 int64 목록)이 포함됩니다.	CMP가 AC 문자열 구현 오류를 수정해야 합니다.