IAB 유럽에서 IAB Tech Lab 및 양 기관 회원사와 함께 개발한 투명성 및 동의 프레임워크 v2.0을 최종 확정했습니다. 이제 Google에서 TCF v2.0을 완벽하게 지원합니다.
게시자가 IAB 유럽의 투명성 및 동의 프레임워크 v2.0 출시와 관련된 오류 및 구성 오류를 관리할 수 있도록 하기 위해, Google에서는 오류 해결을 목적으로 게시자에게 발견된 오류 보고서 및 150일 유예 기간을 제공합니다.
이 도움말에서는 TCF v2.0 구현 오류 해결 방법에 대한 추가 정보를 다루며, 다음 내용을 포함합니다.
업데이트된 가이드라인
업데이트 사항
- 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
에서 전송되는 호출을 500밀리초 이내에 반환하게 하세요(오류 2.1a, 2.1b, 2.2a, 2.2b, 2.2c)
관련 오류
오류 2.1a. 이 가이드라인은 오류 2.1b, 2.2a 2.2b, 2.2c에도 적용될 수 있습니다.
업데이트된 가이드라인
시간 제한 요구사항은 더 이상 적용되지 않지만, CMP가 구현 상태를 자세히 검토하여 AddEventListener getTCData
에 즉시 호출을 반환하도록 하는 것이 좋습니다.
CMP가 응답하지 않으면 요청의 수익 창출 기회가 상실될 수 있습니다.
이유
Google은 CMP가 AddEventListener
함수에 즉시 응답해야 한다고 명시하는 IAB 사양을 준수합니다. CMP가 즉시 응답하지 않으면 요청의 수익 창출 기회가 상실될 수 있습니다.
또한 CMP 응답은 광고 요청이 얼마나 빨리 생성될 수 있는지에 영향을 미치는 요인 중 하나입니다. 페이지 로드와 광고 요청 사이에 소요되는 시간을 줄이면 게시자의 노출 손실이 줄어듭니다.
IAB 사양
적용 가능한 IAB 사양: IAB AddEventListener 사양(GitHub에 명시)
로드 중
이고 CMP가 보유한 TC 데이터가 불완전하더라도 AddEventListener
콜백은 현재 TC 데이터가 등록되는 즉시 호출되어야 합니다. 이렇게 해야 등록된 listenerId
에 호출 스크립트가 액세스할 수 있습니다. 또한, RemoveEventListener
를 사용하여 삭제되지 않은 한 TC 문자열이 변경될 때마다 콜백이 호출되어야 합니다.오류 보고서
하나 이상의 사이트 또는 앱과 관련된 TC 문자열에서 문제가 감지되면 제품 사용자 인터페이스를 통해 게시자에게 알립니다. 게시자는 계정의 'EU 사용자 동의' 페이지에서 TCF 오류 보고서 다운로드를 클릭하여 최근 7일 동안 감지된 오류에 대한 자세한 보고서를 다운로드할 수 있습니다.
- Ad Manager: 관리
EU 사용자 동의를 클릭합니다.
- AdMob 및 애드센스: 차단 관리
EU 사용자 동의를 클릭합니다.
보고서에는 감지된 각 오류에 대한 다음 정보가 포함됩니다.
- 도메인/MobileAppID: 잘못 구성된 사이트 또는 모바일 앱입니다.
- 광고 단위 경로: 오류와 관련된 광고 단위입니다.
- 오류 코드: 오류에 할당된 코드입니다.
- 오류 수: 지난주 동안 오류가 있는 것으로 확인된 쿼리의 수입니다.
- 마지막으로 감지된 날짜: 오류가 마지막으로 감지된 날짜입니다.
게시자는 보고서에 표시된 오류 코드를 사용하여 다음 문제 해결 표에서 추천된 문제 해결 방법을 찾아 실행하여 오류를 해결할 수 있습니다.
문제 해결
게시자가 잘못 구성된 IAB TCF v2.0 적용 문제를 수정할 수 있도록 Google에서는 가장 일반적인 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 문자열이 수신되지 않습니다. |
광고를 요청하기 위해 함수를 직접 호출하는 경우 응답이 광고를 요청하기 위해 함수를 직접 호출하지 않는 경우 CMP를 통해 |
2.1b |
다음 두 조건이 모두 충족됩니다.
|
CMP에 IAB TCF 기술 사양에 따라 API가 올바르게 구현되었는지 확인을 요청하세요. |
2.2a |
TC 문자열이 base64로 인코딩되지 않아서 파싱할 수 없습니다. 예: |
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 |
요청에 |
해당 사항 없음 |
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 문자열 구현 오류를 수정해야 합니다. |