> For the complete documentation index, see [llms.txt](https://businessdaangn.gitbook.io/business.daangn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://businessdaangn.gitbook.io/business.daangn/ads-pro/tools/tracking/event-mapping.md). # 이벤트 매핑 도구 사용 가이드 ### 1. 이벤트 매핑 도구란? 이벤트 매핑 도구는 코드 작성 없이 광고주 사이트 위에서 버튼 클릭과 URL 방문을 전환 이벤트로 매핑하는 노코드 도구예요. 전환 추적 코드 상세 화면에서 \[이벤트 매핑 도구] 배너를 누르면 광고주 웹사이트가 새 탭으로 열리고, 그 화면 위에서 직접 버튼을 선택하거나 URL 키워드를 입력해 전환 이벤트를 추가할 수 있어요. **진입 경로** \[전문가모드] → \[광고 도구] → \[전환 추적 관리] → \[전환 추적 코드 상세] → \[이벤트 매핑 도구] 배너 클릭 **지원 방식** | 방식 | 설명 | | ------ | -------------------------------------------------- | | 버튼 클릭 | 사이트 위에서 원하는 버튼을 클릭해 매핑해요. | | URL 전환 | `product`, `/order` 같은 키워드가 포함된 페이지 방문을 전환으로 매핑해요. | **지원 이벤트 (7종)** 장바구니 담기, 상세 페이지 조회, 회원가입, 로그인, 설치, 잠재고객 수집, 서비스 신청 {% hint style="info" %} 구매 이벤트는 이벤트 매핑 도구에서 지원하지 않아요. 구매 이벤트는 [이벤트 스크립트 설치 가이드](/business.daangn/ads-pro/tools/tracking/event.md)를 참고해 직접 코드를 추가해 주세요. {% endhint %} ### 2. 사용 전 확인 사항 이벤트 매핑 도구를 사용하려면 아래 조건을 모두 충족해야 해요. * 공통 스크립트가 웹사이트의 `` 영역에 설치되어 있어야 해요. * 설치된 공통 스크립트가 최신 버전이어야 해요. * MAT만 연동된 전환 추적 코드에서는 사용할 수 없어요. 이 경우 \[이벤트 매핑 도구] 배너 자체가 노출되지 않아요. 공통 스크립트 설치 방법은 [웹사이트 연동 가이드](/business.daangn/ads-pro/tools/tracking/website.md)를 참고해 주세요. ### 3. 이벤트 매핑하기 {% stepper %} {% step %} #### 전환 추적 관리 접속 \[전문가모드] → \[광고 도구] → \[전환 추적 관리]에서 이벤트를 추가할 전환 추적 코드를 선택해 주세요. {% endstep %} {% step %} #### 이벤트 매핑 도구 실행 전환 추적 코드 상세 화면에서 \[이벤트 매핑 도구] 배너를 눌러 주세요. 광고주 웹사이트가 새 탭으로 열리며, 화면 위에서 버튼이나 URL을 직접 선택할 수 있어요. {% endstep %} {% step %} #### 이벤트 추가 방식 선택 이벤트를 추가하려는 방식에 따라 두 가지 중 하나를 선택해 주세요. * **버튼 클릭** — 사이트 화면에서 매핑할 버튼을 직접 선택해요. * **URL 전환** — 전환으로 정의할 페이지의 URL에 포함된 키워드를 입력해요. (예: `product`, `/order`) {% endstep %} {% step %} #### 이벤트 유형 선택 및 매핑 저장 선택한 동작에 해당하는 이벤트 유형(장바구니 담기, 상세 페이지 조회, 회원가입, 로그인, 설치, 잠재고객 수집, 서비스 신청 중 하나)을 지정한 뒤 매핑을 저장해 주세요. {% endstep %} {% step %} #### 수집 상태 확인 저장 후 \[전환 추적 관리]에서 해당 이벤트가 **수집중** 상태로 바뀌는지 확인해 주세요. {% hint style="info" %} 이벤트가 정상적으로 수집되는지 빠르게 확인하려면 당근 픽셀 헬퍼를 활용하세요. {% endhint %} {% endstep %} {% endstepper %} ### 4. 자주 묻는 질문 **Q. 이벤트 매핑 도구가 연결에 실패해요. 어떻게 확인해야 하나요?** 이벤트 매핑 도구는 최신 버전의 공통 스크립트가 설치된 웹사이트에서만 동작해요. 연결 실패 시 아래 세 가지를 순서대로 확인해 주세요. **1. 공통 스크립트 설치 여부 확인** 페이지 `` 영역에 당근 공통 스크립트가 설치되어 있는지 확인해 주세요. **2. 공통 스크립트 최신 버전 확인** 공통 스크립트 URL에 `0.N` 같은 버전 표기가 있다면 구버전이에요. * 예: `https://karrot-pixel.business.daangn.com/0.4/karrot-pixel.umd.js` ← 구버전 * 이 경우 전환 추적 코드 화면에서 신규 버전을 다시 발급받아 설치해 주세요. **3. Cross-Origin-Opener-Policy 헤더 확인** 광고주 사이트에 `Cross-Origin-Opener-Policy: same-origin-allow-popups` 헤더가 적용되어 있는경우 매핑 도구 연결에 실패할 수 있어요. 적용 여부를 확인해 주세요. 확인 방법은 아래와 같아요. * 광고주 사이트에서 개발자 도구(F12) → Network 탭을 열어 주세요. * 페이지를 새로고침한 뒤 첫 문서(HTML) 요청을 선택해 주세요. * Response Headers에서 `Cross-Origin-Opener-Policy` 값을 확인해 주세요. {% hint style="info" %} MAT만 연동된 전환 추적 코드에서는 이벤트 매핑 도구를 사용할 수 없어요. 이 경우에는 \[이벤트 매핑 도구] 배너 자체가 노출되지 않아요. MAT 연동 환경에서는 [MAT 연동 가이드](/business.daangn/ads-pro/tools/tracking/mat.md)를 참고해 주세요. {% endhint %} **Q. 버튼 문구가 바뀌면 이벤트 매핑을 다시 설정해야 하나요?** 버튼의 문구만 변경된 경우에는 다시 설정하지 않으셔도 괜찮아요. 이벤트는 그대로 정상 수집돼요. 다만, 아래와 같은 변경이 있는 경우에는 기존 매핑 규칙을 삭제하고 다시 설정해 주세요. * 버튼의 위치가 변경된 경우 * 버튼의 HTML 구조가 변경된 경우 * 페이지 레이아웃이 변경된 경우 위와 같은 변경이 있을 경우 기존 규칙으로는 이벤트가 수집되지 않을 수 있어요. 변경 이후에는 \[전환 추적 관리] → 전환 추적 코드 → \[이벤트 매핑 변경 이력]에서 기존 규칙을 확인한 뒤, 새로 설정해 주세요. *** #### 관련 가이드 * [웹사이트 연동 가이드](/business.daangn/ads-pro/tools/tracking/website.md) * [이벤트 스크립트 설치 가이드](/business.daangn/ads-pro/tools/tracking/event.md) * [당근 픽셀 헬퍼 사용가이드](/business.daangn/ads-pro/tools/tracking/pixel.md)