전환 API
브라우저 대신 당사 서버에서 Meta, LinkedIn, TikTok 및 Google Ads에 목표를 보고합니다. 광고 네트워크가 직접 설정한 클릭 식별자로만 매칭합니다.
1. 서버 측 방식을 사용하는 이유
브라우저 픽셀이 전환을 보고하려면 광고 차단기, 추적 방지 설정, 픽셀 실행 전 탭 닫기라는 세 장애물을 넘어야 합니다. 서버 측 호출은 브라우저에서 일어나지 않아 세 문제를 모두 피합니다.
MousePlayer는 목표 달성 시점을 이미 알고 있습니다. 목표의 용도가 바로 그것입니다. 전환 API는 그 사실을 당사 서버에서 광고 네트워크에 전달할 뿐입니다.
브라우저 픽셀을 대체하지 않습니다. 픽셀을 유지하세요. 각 네트워크가 양쪽을 대조해 중복을 제거하며 당사는 필요한 식별자를 보냅니다.
2. 보내는 내용과 절대 보내지 않는 내용
이 호출에서 방문자를 식별하는 것은 네트워크 자체가 설정한 쿠키 또는 클릭 식별자뿐입니다. 그 밖의 개인정보는 당사 서버를 떠나지 않습니다.
| 네트워크 | 사용 식별자 | 출처 |
|---|---|---|
| Meta | _fbp, _fbc | Meta 픽셀이 설정한 퍼스트파티 쿠키 |
li_fat_id | LinkedIn Insight Tag가 설정한 퍼스트파티 쿠키 | |
| TikTok | _ttp, ttclid | _ttp 는 쿠키이며, ttclid 는 광고 클릭 URL에서 가져옴 |
| Google Ads | gclid, wbraid, gbraid | 광고 클릭 URL 또는 이후의 _gcl_aw 쿠키에서 가져옴 |
| Microsoft Advertising | msclkid | 광고 클릭 URL 또는 UET 태그가 기록한 _uetmsclkid 쿠키에서 가져옴 |
절대 보내지 않는 내용: 이메일 주소, 전화번호, 이름 또는 IP 주소는 해시 처리한 값도 보내지 않습니다. 클릭 식별자가 없으면 아무것도 보내지 않습니다. 귀속할 수 없는 전환보다 정확한 집계가 더 유용합니다.
동의한 경우에만
모든 호출은 녹화와 같은 동의 확인을 거칩니다. 동의 없는 세션은 프로젝트 설정의 스위치와 관계없이 전환을 보고하지 않습니다.
3. Google Ads 식별자는 하나가 아닌 세 개
의외일 수 있어 분명히 설명합니다. Google은 단일 광고 클릭에 gclid 를 사용합니다. Apple 추적 방지로 단일 클릭을 귀속할 수 없으면 대신 wbraid 또는 gbraid 를 보내며, 이들은 클릭 그룹을 나타냅니다.
셋은 상호 배타적이며 Google은 두 개가 포함된 전환을 거부합니다. 정확히 하나만 보내고, 여러 값이 있으면 gclid 를 우선합니다. 가장 정밀한 식별자이기 때문입니다.
URL에는 한 번만 표시됨
식별자는 광고 클릭 후 첫 페이지 주소에만 표시됩니다. 이후 Google 태그가 _gcl_aw 쿠키에 저장합니다. 쿠키는 대체 수단으로 읽습니다. 그렇지 않으면 세 번째 페이지에서 발생한 전환은 식별자를 찾을 수 없습니다.
4. 설정
Meta, LinkedIn 및 TikTok
각각 두 필드가 필요합니다. 픽셀 또는 전환 규칙 ID와 네트워크 화면에서 직접 생성한 액세스 토큰입니다. 둘 다 AES-256-GCM으로 암호화하여 저장하고 저장 후 다시 표시하지 않습니다.
Google Ads에는 여섯 필드 필요
Google은 예외이며 시작 전 이유를 알아둘 필요가 있습니다. 다른 세 네트워크와 달리 단순 액세스 토큰을 발급하지 않습니다. 갱신 토큰을 사용하는 OAuth로 접근하며 Ads API에는 추가로 개발자 토큰이 필요합니다.
| 필드 | 확인 위치 |
|---|---|
| 고객 ID | Google Ads 오른쪽 위. 대시 없이 숫자만 입력합니다. |
| 전환 액션 ID | 목표 및 전환에서 기록할 액션을 선택합니다. |
| 개발자 토큰 | Google Ads 관리자 계정의 API 센터. |
| OAuth 클라이언트 ID 및 보안 비밀 | Google Cloud Console, 사용자 인증 정보, “데스크톱 앱” 유형 OAuth 클라이언트. |
| 갱신 토큰 | 다음 범위로 직접 한 번 생성합니다: adwords. |
LinkedIn에는 두 경로가 있으며 짧은 경로를 사용하세요
Campaign Manager에서: 데이터, Signals Manager, Direct API, 액세스 토큰 생성. 자체 데이터를 보내는 광고주용 경로로 개발자 앱이나 검토가 필요하지 않습니다. 토큰은 만료되지 않으며 다시 표시하지 않으므로 즉시 복사하세요.
LinkedIn Developer Portal에서 개발자 앱을 신청하는 다른 경로는 여러 광고주를 대신해 전송하는 플랫폼용입니다. 회사 페이지 확인과 사용 사례 승인이 필요하며 여기에서는 불필요합니다.
Microsoft Advertising은 간단함
Google Ads처럼 OAuth, 개발자 토큰 및 승인이 필요할 것으로 예상할 수 있지만 반대입니다. 두 필드만 필요합니다. 브라우저에서 쓰는 UET 태그 ID와 Microsoft Advertising의 UET 태그에서 “Conversions API 사용”, “토큰 복사”로 가져온 토큰입니다. 신청할 것은 없습니다.
브라우저 태그와 같은 태그 ID를 쓰세요. 그래야 Microsoft가 서버 이벤트와 브라우저 이벤트를 두 전환이 아닌 하나로 인식합니다.
개발자 토큰은 Google 승인이 필요함 (“기본 액세스”)에 며칠이 걸립니다. 1분 안에 끝낼 수 없는 유일한 단계이므로 먼저 시작하세요. 당사는 Google 비밀번호가 아닌 갱신 토큰만 보며 언제든 철회할 수 있습니다.
5. 전환 보고 시점
목표 및 세션마다 정확히 한 번입니다. 호출 전에 MousePlayer가 중복을 제거하고 페이로드에도 ID를 넣어 네트워크가 다시 중복을 제거합니다. 상품 다섯 개를 장바구니에 넣어도 전환은 다섯 번이 아닌 한 번입니다.
광고 계정에 표시되는 내용
목표 이름, 설정한 경우 가치와 통화 및 발생 시각이 포함됩니다. 정상 운영 시 1분 이내에 도착합니다.
도착하지 않을 때
- 클릭 식별자 없음. 해당 네트워크 광고로 오지 않았거나 픽셀이 쿠키를 설정하기 전에 도착했습니다. 아무것도 보내지 않는 것이 정상입니다.
- 동의 없음. 동의 확인이 우선입니다.
- 네트워크가 호출은 수락했지만 전환은 거부함. Google, TikTok 등은 HTTP 200을 반환하면서 응답 본문에 오류를 넣습니다. 상태뿐 아니라 본문을 읽으며 이유는 전송 로그에 표시합니다.
여기에 언급된 모든 상표는 각 소유자에게 귀속됩니다. MousePlayer는 이 제공업체들과 사업 관계가 없습니다.