6. 외부 사이트 설치·수집 설정
이미 운영 중인 외부 사이트에 MetaFlyer SDK를 설치해 방문·클릭·전환을 수집할 때 사용하는 기능입니다. MetaFlyer 빌더로 본문을 편집하는 작업과 구분해 주세요. 외부 사이트의 코드 편집 권한이 필요합니다.
1단계. 설치 정보 준비하기
웹사이트 → 사이트 → 대상 사이트 → 외부 설치를 엽니다.
새 설치에서 설치 정보를 확인합니다. 화면에 표시된 Public key와 SDK version은 해당 설치의 값입니다.
허용 Origin에 실제 설치할 사이트의 출처를 입력합니다. 예를 들어
https://www.example.com처럼 프로토콜과 호스트를 확인합니다. www 유무나 다른 서브도메인을 혼동하지 마세요.상태와 수집 항목을 확인한 뒤 설치 카드의 저장을 누릅니다.
2단계. 수집 범위 정하기
항목 | 설정·확인할 내용 |
|---|---|
동의 모드 | 사이트의 동의 운영 방식과 맞춰 선택합니다. 초기 화면은 ‘익명 기본’으로 표시됩니다. |
페이지 방문 | 방문 통계 수집에 사용합니다. |
클릭·CTA 노출 | CTA CTR을 보려면 둘 다 켜고, 분석할 버튼·링크에 data-mf-cta 식별자를 넣습니다. |
폼 이벤트 | 입력값 자체를 수집하지 않습니다. 폼 완료는 외부 사이트에서 실제 성공 처리 시 이벤트를 보내야 합니다. |
전환·사용자 정의 이벤트 | 사이트에서 원하는 행동을 실제 이벤트로 전송하도록 연동을 확인합니다. |
팝업·배너 표시 | 외부 사이트에서 해당 운영 콘텐츠를 사용하려는 경우 설정을 확인합니다. |
자동화 이벤트 전달 | 켜고 저장하면 새 이벤트가 연결된 자동화로 전달됩니다. 분석만 사용할 때는 꺼 두세요. |
3단계. 설치 코드 적용하기
snippet 복사로 해당 설치의 코드를 복사합니다. 다른 사이트의 키·코드를 재사용하지 않습니다.
외부 사이트의 공통 코드 영역에 설치합니다. 플랫폼마다 삽입 위치가 다르므로 해당 사이트의 코드 관리 방식에 맞춰 적용합니다.
기본 snippet은 URL의 공개키로 자동 초기화하고 저장된 동의 상태를 복원합니다. init 포함 복사는 동의 상태를 명시하여 기존 저장 값을 덮어쓴다는 차이가 있습니다.
외부 사이트의 변경 내용을 저장·배포하고 브라우저에서 새로고침합니다.
4단계. 설치 검증하기
설치가 저장된 뒤 테스트 코드 복사를 사용합니다.
화면 안내에 따라 실제 설치한 외부 사이트의 개발자 콘솔에서 테스트 코드를 실행합니다. 설치 대상 사이트가 맞는지 먼저 확인합니다.
MetaFlyer로 돌아와 수신 확인을 누릅니다.
수신 상태를 확인한 뒤, 실제 이벤트는 사이트 분석의 집계 기준에 맞춰 확인합니다.
수신과 통계는 다릅니다.
테스트 이벤트는 방문 통계와 자동화를 실행하지 않습니다. 최근 수신은 서버가 접수한 시각이며 통계 집계 완료를 의미하지 않습니다.
5단계. 고급 설정
고급 설정 → 열기에서 이벤트 속성 허용 목록, 기능 플래그 JSON, Form mapping JSON, Popup/Banner descriptor JSON을 관리합니다. 허용 목록은 한 줄에 하나씩 최대 20개이며 허용한 속성의 문자·숫자·참/거짓 값만 저장합니다. 개인정보를 넣지 마세요. JSON 형식을 이해하는 담당자가 필요한 값만 작성합니다.
고급 설정 창을 닫는 것만으로 저장되지 않습니다. 설치 카드의 저장을 눌러야 반영되며 수집 설정 변경 후 외부 사이트를 새로고침합니다.
문제 해결과 팁
수신이 없으면 설치 코드 적용·배포, 공개키 일치, 허용 Origin, 설치 상태, 동의·수집 설정을 순서대로 확인합니다.
CTA는 클릭만 켜고 CTR을 기대하지 마세요. 노출과 식별자도 필요합니다.
실제 고객 자동화를 테스트 이벤트로 검증했다고 판단하지 않습니다. 분석·수신 확인과 자동화 실행을 구분합니다.