자바스크립트 이벤트를 추적하기 전에 먼저 글로벌 스니펫을 포함해야 합니다.
이는 탐색의 Settings > Tracking Codes
에서 찾을 수 있습니다.
페이지의 어느 곳에나 배치할 수 있으며 페이지당 한 번만 포함되어야 합니다.
전환 이벤트 추적
먼저, 오퍼 소스 및 오퍼 섹션에서 제공된 글로벌 스니펫에는 이미 전환 이벤트 코드가 포함되어 있다는 점에 유의하세요.
페이지가 조회 추적이 아닌 전환만 신경 쓰는 감사 페이지인 경우, 이 스니펫을 사용하여 추적할 수 있습니다.
이 코드에는 전환 수익과 거래 ID에 대한 자리 표시자가 포함되어 있습니다.
이 두 가지 모두 선택 사항입니다 -- 수익 값을 전달하지 않으면 오퍼의 기본값을 사용합니다. 제휴 네트워크를 사용하는 경우, 일반적으로 오퍼 소스가 동적 지불금/거래 ID를 코드에 삽입합니다(하지만 가급적이면 포스트백 URL을 사용하는 것이 좋습니다).
참고: 검색한 스니펫에서 오퍼 소스에 따라 대문자로 된 값들은 실제 값으로 대체되어야 하며, 알 수 없는 경우 완전히 생략해야 합니다(예: CONVERSION_VALUE 등).
자바스크립트 이벤트 코드
기본 전환 이벤트는 다음과 같이 실행할 수 있습니다:
flux.track("conversion", { rev:'REVENUE' })
이는 쿠키와 현재 페이지 URL을 사용하여 사용자(즉, 방문자 ID)를 확인합니다. 해당 방문자에 대해 가장 최근에 생성된 오퍼 히트가 전환됩니다.
이 이벤트는 우리의 범용 JS 스니펫이 이미 포함되어 있어야만 성공할 수 있습니다.
이 코드를 사용하여 버튼 클릭, 양식 제출 등에서 수동으로 이벤트를 트리거할 수 있습니다. 페이지 로드 시 전환을 실행하려면 이 코드를 그대로 포함하되 범용 스니펫 이후에 포함하세요.
클릭, 제출 등 이후에 전환 이벤트를 트리거하려면 기본 이벤트 리스너 사용에 대해 설명하는 이 문서를 참조하세요.
추가 매개변수
사용 가능한 경우 추가 데이터를 전환 이벤트에 삽입할 수 있습니다. 모든 속성은 문자열로 전달되어야 합니다.
전환 이벤트에서 사용 가능한 매개변수는 다음과 같습니다:
rev
-- 수익, 선택 사항, 달러와 센트로 표시(예: 12.99). 생략하면 전환 중인 오퍼의 기본값이 사용됩니다. 이는 반드시 문자열로 전달되어야 하므로 따옴표 안에 있어야 합니다.tx
-- 거래 ID, 선택 사항p
-- 페이지 ID, 선택 사항, 전환이 귀속되어야 하는 오퍼(페이지)의 ID입니다. 종종 현재 페이지가 아닌 이전 페이지인 경우가 많습니다. 생략하면 사용자 세션의 가장 최근 오퍼 페이지 조회가 전환됩니다vid
-- 방문자 ID. 이는 종종 URL이나 쿠키에 존재하지만 직접 삽입할 수도 있습니다hit
-- 전환할 오퍼 조회의 히트 ID. 이는 일반적으로 현재 페이지가 아닌 이전 페이지일 것입니다. 이를 알고 있다면 더 신뢰할 수 있는 서버 간 포스트백 호출을 위해 필요한 모든 정보를 가지고 있을 가능성이 높습니다. hit을 보내는 경우 vid를 보내지 않아야 하며 그 반대도 마찬가지입니다. 이들은 경쟁하는 사용자 식별자이기 때문입니다(hit이 더 구체적이며 사용될 것입니다).
예를 들어 거래 ID와 알려진 페이지 ID(전환과 연관된 오퍼의):
flux.track("conversion", { rev:'REVENUE', tx:'OPTIONAL_TRANSACTION_ID' p:'PAGE_ID' })
시스템이 히트나 방문자 ID를 직접 삽입할 수 있다면 추적을 더 신뢰할 수 있게 만들 수 있습니다:
flux.track("conversion", { rev:'REVENUE', tx:'OPTIONAL_TRANSACTION_ID', vid:'VID', p:'PAGE_ID' })
hit 속성도 보낼 수 있지만, 일반적으로 hit ID를 알고 있다면 대신 포스트백 URL을 호출할 수 있습니다.
hit ID와 VID를 알고 있다면 둘 중 하나를 선택하여 보낼 수 있습니다.
JS 요청에서 전환 시간을 재정의하는 경우는 드물지만 아래와 같이 가능합니다:
flux.track("conversion", { rev:'REVENUE', conversion_time: "unix_timestamp" })
가능한 경우 유닉스 타임스탬프를 사용하는 것이 좋지만 다른 일부도 구문 분석 가능합니다.
API 요청 및 응답
보내는 API 요청은 조회 이벤트와 유사할 것입니다. 예를 들면:
성공하면 응답에는 전환 ID, 타임스탬프가 포함되고 전환된 히트 ID와 일부 이벤트 컨텍스트가 표시됩니다: