Tag Assistant를 사용하여 문제 해결하기

이 도움말은 Google 태그 또는 태그 관리자를 사용하며 태그 지정 설정 문제를 해결해야 하는 사용자를 위한 도움말입니다.

Tag Assistant는 태그 지정 설정 문제를 해결하는 데 도움이 되는 도구입니다. Tag Assistant를 사용하면 다음과 같은 작업을 할 수 있습니다.

• 웹사이트에 어떤 태그가 있는지 검토
• 실행된 이벤트 검토
• 데이터 영역으로 전달되는 데이터 검토
• 디버그 세션을 내보내 다른 사용자(예: Google 지원팀)와 공유
• 다른 사용자로부터 디버그 세션 가져오기
• 다른 사용자가 디버그할 수 있도록 디버깅 URL 공유

사이트에 Google 태그가 포함된 경우 Tag Assistant는 태그 적용 범위 요약에 태그가 지정된 페이지와 태그가 지정되지 않은 페이지를 추가하여 사이트의 전반적인 태그 지정 상태를 대략적으로 보여줍니다.

이 도움말의 내용은 다음과 같습니다.

• Tag Assistant Companion Chrome 확장 프로그램 설치
• 디버그 매개변수에 대한 정보
• 새 디버그 세션 시작하기
• Tag Assistant UI에 대한 정보
• 디버그 세션 내보내기
• 디버그 세션 가져오기
• 다른 사용자와 디버깅 액세스 권한 공유하기
• 디버그 모드 종료하기
• Tag Assistant를 사용하여 Google Ads 전환 액션 확인하기
• 연결 문제 해결

Tag Assistant Companion Chrome 확장 프로그램 설치

Tag Assistant Companion Chrome 확장 프로그램은 확장 프로그램이 없는 디버거에 대한 호환 기능으로 작동합니다. 최적의 디버깅 결과를 얻으려면 Tag Assistant Companion Chrome 확장 프로그램을 설치하세요. Chrome 확장 프로그램이 있으면 다음 기능이 사용 설정됩니다.

• iframe 내에서 Google 태그를 감지
• 현재 창에서 열린 팝업 창 또는 새 탭을 디버깅
• 디버그 창이 팝업이 아닌 새 브라우저 탭으로 열립니다. 이렇게 하면 사용자가 브라우저 URL 막대를 조작할 수 있을 뿐만 아니라 리퍼러 기반 작업을 쉽게 디버깅할 수 있어서 효율적입니다.
• 동일한 디버그 세션에서 다수의 창을 디버깅할 수 있습니다. 이벤트 트리에 각 창이 다른 기호로 표시되므로 쉽게 구분할 수 있습니다.
  

디버그 매개변수에 대한 정보

Tag Assistant는 앱 + 웹 측정 ID로 전송되는 조회에 대해 자동으로 '디버그' 매개변수(_dbg)를 설정합니다. 이를 통해 앱 + 웹의 DebugView 같이 다른 디버깅 도구에 표시되는 조회까지 확인할 수 있습니다. 앱 + 웹 조회는 전송 시 일괄 처리되지 않기 때문에 개별적으로 검사할 수 있습니다.

새 디버그 세션 시작하기

새 디버그 세션을 시작하는 방법은 다음과 같습니다.

1. Tag Assistant 열기
2. 도메인 추가를 클릭합니다.
3. 디버깅하려는 페이지의 URL을 입력합니다.
4. 시작을 클릭합니다. Tag Assistant가 디버그할 웹사이트를 새 탭에 로드합니다.
5. URL에 디버그 매개변수가 추가된 경우 일부 사이트가 작동하지 않을 수 있습니다. 이 경우 URL에 디버그 신호 포함하기 체크박스를 선택 해제하세요.

활성 또는 종료된 디버그 세션을 다시 시작하려면 Tag Assistant 홈페이지의 활성 도메인 또는 도메인 내역에서 도메인 이름을 클릭합니다.

사용 설정되면 입력한 페이지가 새 창으로 열리고 디버그 UI는 기존 Tag Assistant 브라우저 창에서 열립니다. Tag Assistant 창의 디버그 UI에는 태그가 어떻게 실행되고 어떤 데이터가 처리되고 있는지 등 gtag() 명령어 및 조회에 관한 세부정보가 표시됩니다. 디버그 정보는 일반 웹사이트 방문자에게 보이지 않습니다. 동일한 도메인 내에서 탐색하는 동안에는 페이지에 Google 태그가 있는 한 디버그 창이 계속 열려 있는 상태로 디버그 정보를 표시합니다.

웹사이트에서 마우스를 클릭하면서 이동하면 디버그 창에 태그가 어떻게 실행되었는지에 대한 정보가 업데이트됩니다. 이 정보를 토대로 태그가 성공적으로 실행되었는지, 실행 상태를 트리거한 또는 트리거하지 않은 요인은 무엇이었는지, 태그 실행 결과로 발생한 네트워크 요청이 무엇이었는지 확인할 수 있습니다.

Tag Assistant UI에 대한 정보

Tag Assistant를 처음 열면 요청한 페이지의 이벤트 개요 및 태그 정보가 포함된 기본 요약 보기가 표시됩니다. 여러 개의 Google 태그 또는 태그 관리자 컨테이너가 감지된 경우 하나를 선택하면 해당 특정 Google 태그 또는 컨테이너의 모든 조회가 표시됩니다. 

참고: 브라우저 이벤트는 모든 컨테이너에 적용될 수 있지만 조회는 선택한 컨테이너를 기준으로 필터링됩니다.

화면 왼쪽에는 이벤트 목록이 표시됩니다. Output(출력) 섹션에는 선택한 ID에 대해 조회가 감지될 때마다 카드가 표시됩니다.

이벤트는 이벤트가 발생한 페이지를 기준으로 그룹화됩니다. 페이지 수준 요약을 보려면 왼쪽 탐색 메뉴에서 페이지 제목을 클릭합니다. 사용자가 해당 사이트에서 Google 태그가 설치된 다른 페이지로 이동하면 새 페이지 그룹이 목록 상단에 추가됩니다.

이벤트는 실행된 순서대로 표시되며 순서에 따라 번호가 매겨집니다. 표시가 있는 이벤트는 Google 태그가 로드될 때 자동으로 전송되는 기본 제공 트리거입니다. 자세한 내용을 보려면 왼쪽 열에서 이벤트를 클릭하세요.

API Call(API 호출)에는 선택한 이벤트에 대한 데이터를 구성하는 데 사용된 자바스크립트가 표시됩니다. 이때 표시되는 자바스크립트는 gtag() 호출 또는 datalayer.push() 호출입니다.

Output(출력)에는 조회가 전송된 위치, 데이터 영역 업데이트, 오류가 표시됩니다.

조회 세부정보

Hits Sent(전송된 조회)에는 특정 조회가 전송된 위치와 조회 유형이 표시됩니다.

이 조회를 클릭하면 세부정보 창이 표시됩니다. 세부정보 패널에는 각 조회마다 함께 전송된 매개변수에 대한 정보가 표시됩니다.

데이터 영역

Data Layer(데이터 영역) 탭에는 dataLayer 객체에서 찾은 값이 표시됩니다. Summary(요약)에서는 현재 데이터 영역 상태와 각 이벤트마다 데이터 영역으로 푸시된 데이터를 확인할 수 있습니다.

디버그 세션 내보내기

Tag Assistant 세션 내보내기는 태그를 디버깅하는 데 도움이 필요한 경우 유용합니다. 내보낸 파일에는 다른 사용자가 Tag Assistant 브라우저 창으로 가져올 수 있는 디버그 기록이 저장됩니다.

주의: 테스트 중인 웹사이트에서 태그를 통해 개인 식별 정보(PII)를 전송하는 경우 민감한 정보도 내보냅니다.

디버그 세션을 내보내려면 다음 단계를 따르세요.

1. Tag Assistant 열기
2. 웹사이트를 탐색하여 Tag Assistant에서 디버그 정보를 채웁니다.
3. 디버그 세션을 내보낼 준비가 되면 더보기 메뉴 세션 내보내기를 클릭합니다.
4. 면책조항을 읽고 내보내기를 클릭합니다. 내보낸 파일이 컴퓨터에 저장됩니다. 파일 콘텐츠가 손상될 수 있으므로 파일 이름이나 파일 콘텐츠를 수정하지 마세요.
5. 태그 지정 디버그를 지원하는 사용자와 파일을 공유하면 이 사용자가 디버그 세션을 가져올 수 있습니다.

디버그 세션 가져오기

Tag Assistant 디버그 세션을 가져와서 사용자가 태그 설정을 테스트하기 위해 진행한 단계에 대해 알아볼 수 있습니다. 가져온 디버그 세션은 읽기 전용 모드로 열립니다. 즉, 디버깅을 계속할 수 없습니다. 가져온 세션에서는 새 조회 또는 태그를 실행할 수 없습니다. 다른 사용자를 대신하여 웹사이트를 테스트해야 하는 경우 해당 사용자에게 디버그 액세스 권한을 공유해 달라고 요청하세요.

디버그 세션을 가져오려면 다음 단계를 따르세요.

1. Tag Assistant 열기
2. 더보기 메뉴 에서 세션 가져오기 를 선택합니다.
3. 디버그 세션 파일을 업로드합니다. 가져온 세션은 읽기 전용 모드로 열립니다.

다른 사용자와 디버깅 액세스 권한 공유하기

태그 지정 설정을 디버깅하는 데 도움이 필요한 경우 다른 사람에게 Tag Assistant 액세스 권한을 부여하세요. 

디버깅 액세스 권한을 공유하려면 다음 단계를 따르세요.

1. Tag Assistant 열기
2. 새 디버그 세션을 시작합니다. 
3.  더보기 메뉴 에서 공유 를 선택합니다.
4. 디버그 설정을 검토하고 링크 복사를 클릭합니다.
5. 도움을 받을 사용자와 디버그 링크를 공유합니다.

디버그 모드 종료하기

디버그 모드를 종료하는 방법은 다음과 같습니다.

1. 디버그 모드로 사용 중인 웹브라우저 탭으로 전환합니다.
2. 플로팅 창이나 홈페이지에서 디버깅 중지를 클릭하거나 디버그 창의 왼쪽 상단에 있는 X를 클릭합니다.

Tag Assistant를 사용하여 Google Ads 전환 액션 확인하기

Google Ads와 Tag Assistant를 통합하면 전환 액션 인증을 할 수 있도록 가이드 모드가 포함됩니다.

Google Ads 전환 요약 페이지에는 확인되지 않은 전환 액션 문제를 해결할 수 있는 링크가 포함되어 있습니다. 이렇게 하면 위에서 설명한 대로 디버그 모드를 시작할 수 있는 Tag Assistant가 실행됩니다.

페이지 내 Tag Assistant 오버레이에는 전환 액션 확인에 대한 안내가 표시됩니다. 완료 시 Finish(마침)를 클릭하면 테스트된 전환 액션을 지정하는 요약 정보가 Tag Assistant 창에 표시됩니다. 이러한 결과는 짧은 지연 후 Google Ads 전환 요약 페이지에 반영됩니다. 자세히 알아보기

연결 문제 해결

디버그 창이 페이지에 연결되지 않으면 다음 해결 방법을 시도해 보세요.

• 입력한 URL의 페이지에 Google 태그가 없는 경우가 있습니다. 웹사이트 페이지 중에 정상 작동하는 Google 태그가 있을 만한 URL을 입력해 보세요.
• 페이지 URL에 추가된 디버그 매개변수가 페이지 동작을 방해할 수 있습니다. 이 문제를 해결하려면 디버그 모드에 입력한 도메인을 수정하고 URL에 디버그 신호 포함하기 체크박스를 선택 해제합니다.
• Tag Assistant가 페이지에 연결을 시도한 후 시간이 지나면 Google 태그 스크립트가 로드됩니다. 다시 시도를 클릭하여 다시 연결합니다.
• 테스트하려는 페이지가 AMP 페이지입니다. AMP는 현재 Tag Assistant에서 지원되지 않습니다.
• 페이지에서 iframe으로 Google 태그를 로드합니다. iframe에 로드된 태그 구성은 Tag Assistant Companion Chrome 확장 프로그램도 설치된 경우에만 디버깅할 수 있습니다.
• 브라우저 리디렉션이 많으면 디버그 창이 로드되지 않을 수 있습니다.
• 웹브라우저에 광고 차단 프로그램이 설치되어 있으면 Google 태그가 실행되지 않을 수 있습니다. 테스트할 페이지에서 광고 차단 프로그램의 사용을 중지해 주세요.
• Tag Assistant Companion을 설치한 경우 확장 프로그램에 테스트하려는 페이지의 사이트 데이터를 읽고 변경할 수 있는 권한이 있는지 확인하세요.
• 동의 관리 도구가 Google 태그를 차단할 수도 있습니다. 사용하는 모든 동의 관리 도구를 Google의 동의 API와 상호작용이 가능하도록 구성하세요.