이 페이지는 Cloud Translation API를 통해 번역되었습니다.

전환추적

개요

전환 추적은 Google의 Action Center 통합 중 하나를 통해 Google에서 시작한 전환을 추적합니다. 통합이 양호한 상태로 실행되어야 합니다. 특정 페이지의 순위에 영향을 줄 수 있기 때문입니다. Google에서 action_link를 생성할 때마다 고유한 쿼리 매개변수 rwg_token가 포함되도록 특정 URL이 수정됩니다. 토큰을 저장하고 사용자가 예약을 완료하면 적절한 값을 반환할 수 있습니다.

통합을 완료하려면 다음 단계를 따르세요.

rwg_token를 파싱하고 저장합니다.
판매자 정보를 파싱하고 저장합니다.
rwg_token 및 merchant_changed 값을 반환합니다.
전환 추적을 테스트하고 확인합니다.

`rwg_token` 파싱 및 저장

통합을 완료하려면 최초 Google 추천 후 최대 30일 동안 rwg_token를 수집하고 저장해야 합니다. rwg_token 값은 링크에 관한 메타데이터와 해당 action_link를 생성한 판매자 정보를 포함하는 인코딩된 문자열입니다.

토큰 파싱

사용자가 예약 페이지로 연결되면 제공된 URL에 새 rwg_token가 추가됩니다. 예약 페이지에서 토큰 값을 파싱해야 합니다.

다음 예는 브라우저를 통한 기기 수준 추적을 위해 rwg_token가 파싱되는 방식을 보여줍니다.

var query = location.search.substring(1);
var params = query.split('&');
var rwgToken = undefined;
for (var i = 0; i < params.length; ++i) {
  var pair = params[i].split('=');
  if (pair[0] == 'rwg_token') {
    rwgToken = decodeURIComponent(pair[1]);
    break;
  }
}

URL에 추가된 토큰은 암호화됩니다. 다음 rwg_token 예시를 참고하세요. 이 샘플 토큰을 사용하여 =와 같은 특수문자와 함께 토큰을 올바르게 파싱할 수 있는지 확인하세요.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

토큰 저장

rwg_token를 저장할 때는 다음 두 가지 수준에서 전환 추적을 구현할 수 있습니다.

기기 수준
사용자 수준

토큰은 어느 수준에서든 저장할 수 있지만 초기 추천 후 30일 동안 토큰을 저장해야 합니다.

다음 예는 기기 수준 변환 추적을 보여줍니다. 퍼스트 파티 쿠키를 사용하여 브라우저에 토큰 값을 저장할 수 있습니다. 이 예에서는 토큰 값을 변수로 파싱했다고 가정합니다. rootdomain.com을 도메인으로 업데이트해야 합니다.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Google에서 피드를 통해 제공된 action_link를 생성할 때마다 고유한 쿼리 매개변수 rwg_token를 포함하도록 URL이 수정됩니다. 이 토큰을 저장하고 전환 이벤트의 일부로 다시 전달해야 합니다.

기기 수준 저장

기기 수준에는 브라우저 쿠키, 로컬 저장소, 앱 로컬 저장소 또는 30일 기여 분석 기간 동안 토큰을 유지할 수 있는 기타 모든 방법이 포함됩니다. 토큰은 사용자 기기에 로컬로 저장됩니다. 따라서 사용자가 다음과 같은 경우 전환 이벤트에 기여도가 부여되지 않습니다.

사용하는 기기를 변경합니다.
로컬 저장소 또는 쿠키를 삭제합니다.
비공개 또는 시크릿 브라우저를 사용합니다.

기기 수준 전환 추적을 사용하려면 모바일을 포함하여 지원되는 모든 기기에서 전환 이벤트를 다시 구현해야 합니다.

사용자 수준 저장

사용자 수준은 서버 측 분석 시스템 또는 기타 서버 측 시스템을 통해 애플리케이션 데이터베이스에 토큰을 유지합니다. 토큰은 서버 측에 저장됩니다. 따라서 사용자가 다시 로그인한 후에도 전환 이벤트가 계속 올바르게 기여도를 부여합니다.

시스템 아키텍처를 기반으로 사용자 수준 전환 추적을 사용하면 서버 측에서 전환 이벤트를 한 번 구현하고 지원되는 모든 기기에서 재사용할 수 있습니다.

토큰 새로고침

Google에서 사용자를 동일한 판매자에게 추천하면 이미 저장된 기존 토큰이 최신 추천의 새 토큰으로 대체됩니다. 토큰 교체 후 토큰 저장소의 30일 기여 분석 기간이 재설정되고 이 판매자의 모든 새 전환은 최신 토큰에 기여도가 부여됩니다.

자세한 내용은 전환 기여 분석 요구사항을 참고하세요.

판매자 정보 파싱 및 저장

사용자가 예약 페이지로 이동하면 판매자 세부정보를 찾아 캡처할 수 있는 로직을 구현해야 합니다. 일반적으로 파트너는 액션 링크에 판매자 메타데이터 또는 merchant_id를 추가하고 이를 사용하여 판매자 정보를 식별하고 저장합니다.

merchant_id 또는 선택한 식별자를 rwg_token와 함께 저장하는 것이 좋습니다. 사용자가 예약을 확인하면 완료된 전환 요청을 보내기 전에 판매자에게 문의할 수 있습니다. 토큰 저장소와 마찬가지로 최초 추천 후 30일 동안 토큰과 함께 판매자 세부정보를 저장해야 합니다.

다음 예에서는 이전에 저장된 rwg_token를 수정합니다. 제공된 URL의 메타데이터에서 판매자 정보를 파싱하고 merchant_id로 저장했거나 기존 merchant_id와 일치시켰다고 가정합니다.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

`rwg_token` 및 `merchant_changed` 값 반환

사용자가 action_link 추천으로 시작된 예약을 완료하면 전환 엔드포인트에 HTTP POST 요청을 전송해야 합니다. 두 가지 엔드포인트가 있습니다.

프로덕션 환경: https://www.google.com/maps/conversion/collect
샌드박스 환경: https://www.google.com/maps/conversion/debug/collect

전환 이벤트를 전송할 때 저장된 rwg_token 및 merchant_changed 값 1 또는 2를 포함해야 합니다. merchant_changed에 관한 자세한 내용은 판매자 변경 값 반환을 참고하세요.

POST 본문은 다음 형식의 JSON 인코딩 객체여야 합니다.

{
  "conversion_partner_id": "<partnerId>",
  "rwg_token": "<rwg_token_val>",
  "merchant_changed": "1|2"
}

{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": "2"
}

다음 예에는 JavaScript로 작성된 사용자 기기의 쿠키를 사용한 기기 수준 전환 추적이 포함되어 있습니다.

const partnerId = XXXXXXXXXX;

const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal,
      merchant_changed: merchantChanged
    })
  });
}

판매자 변경 값 반환

merchant_changed 값은 판매자가 초기 리디렉션 판매자에서 변경되었는지 확인하는 데 사용됩니다. 방문 페이지가 다른 판매자가 포함된 플랫폼 내에 있는 경우 판매자가 변경되는 경우가 많습니다. 이 경우 사용자가 Google에서 내 플랫폼으로 안내되었으나 다른 판매자로 이동하여 예약을 완료하기로 한 경우 별도의 판매자에서 전환이 발생했음을 알아야 합니다. 불리언을 사용하여 판매자 변경사항을 식별할 수는 있지만 판매자 세부정보는 식별할 수 없습니다.

merchant_changed에 할당할 값을 결정할 때는 판매자 정보 파싱 및 저장에 저장된 원본 판매자를 가져와야 합니다. 판매자가 변경되었는지 확인하고 요구사항에 따라 값을 할당합니다.

요구사항: 사용자가 원래 판매자의 웹사이트를 나와 다른 판매자의 플랫폼을 통해 구매를 완료하는 경우
- 판매자 변경 값: 1
요구사항: 사용자가 원래 판매자를 통해 거래를 완료하는 경우
- 판매자 변경 값: 2

전환 추적 테스트 및 확인

다음 테스트 사례는 테스트 토큰 섹션에 제공된 테스트 토큰을 사용하며, 전환 이벤트를 일으킬 수 있는 다양한 시나리오를 모두 안내하는 데 도움이 됩니다. 이렇게 하면 토큰이 적절하게 저장되고 merchant_changed 값이 올바르게 설정되며 적절한 경우 전환 이벤트가 전송됩니다.

피드에 제공된 작업 링크 또는 예약 페이지 URL을 사용하고 URL 끝에 테스트 토큰을 추가하여 각 테스트 사례를 실행합니다. 비공개 또는 시크릿 브라우저 창을 사용해야 합니다. 이렇게 하면 현재 사용자와 연결된 기존 토큰이 모두 삭제되고 작업할 수 있는 깨끗한 상태가 됩니다.

테스트 사례	테스트 설명	사용자 흐름	예상 결과
1	사용자가 Google에서 시작하지 않은 예약을 완료합니다.	사용자가 Google에서 추천받지 않았거나 기존 추천 없이 예약 페이지로 바로 이동합니다. 이로 인해 전환 이벤트가 발생하지 않습니다.	사용자가 이전에 예약 페이지를 방문하지 않았거나 Google에서 추천하지 않았기 때문에 전환 이벤트 없음
2	사용자가 Google에서 시작된 예약을 완료합니다.	사용자가 Google을 통해 판매자를 찾고 예약 페이지로 안내되어 예약을 완료합니다.	사용자가 Google에서 예약 페이지로 안내되었으므로 토큰 A 및 판매자 변경 값 2와 함께 전환 이벤트가 전송됩니다.
3	Google에서 유입된 사용자가 예약 절차를 시작하지만 예약이 완료되기 전에 세션을 중단합니다. 참고: 테스트 4 및 5에서는 이 세션을 열어 둡니다.	사용자가 예약 페이지로 안내되었지만 세션이 종료되고 예약을 완료하지 않습니다.	사용자가 예약을 완료하지 않았으므로 전환 없음이지만 토큰 B는 30일 동안 저장해야 합니다.
4	사용자가 Google에서 시작하지 않고 예약 페이지로 돌아가 예약을 완료합니다. 참고: 예약 흐름 URL에는 rwg_token이 포함되어서는 안 됩니다.	사용자가 테스트 4 후에 예약 페이지로 돌아갑니다. 토큰 B는 30일 동안 저장되어야 하며 이 30일 동안 발생한 모든 전환은 전환 이벤트를 반환해야 합니다.	사용자가 이전에 Google에서 추천한 후 예약 페이지로 돌아가므로 토큰 B 및 판매자 변경 값이 2인 전환 이벤트가 전송됩니다.
5	사용자가 테스트 4 후에 Google에서 발생한 새 예약을 완료합니다.	사용자가 이전 Google 추천 후 Google 추천을 사용하여 예약 페이지로 돌아오면 30일 저장 기간이 재설정되고 새 토큰 토큰 C가 이전 토큰 토큰 B를 대체합니다. 그러면 향후 모든 전환 기여도가 토큰 C에 부여됩니다.	사용자가 예약을 완료하고 새 토큰이 이전에 저장된 토큰을 대체했기 때문에 토큰 C 및 판매자 변경 값이 2인 전환 이벤트가 전송됩니다.

사용자가 다른 판매자와 결제할 수 있는 플랫폼이 있는 경우 다음을 테스트합니다.

테스트 사례	테스트 설명	사용자 흐름	예상 결과
6	사용자가 Google을 통해 내 예약 페이지로 안내되었으나 다른 판매자와 예약을 완료합니다.	사용자가 Google에서 예약 페이지로 추천되고 토큰 A가 사용되었지만 예약을 완료하기 전에 다른 페이지로 이동하여 원래 추천과 다른 판매자와 예약을 완료합니다.	사용자가 추천과 다른 판매자에서 예약을 완료했기 때문에 토큰 A 및 판매자 변경 값이 1인 Google 추천으로 발생한 예약을 완료했으므로 전환 이벤트가 전송됩니다.

테스트하는 동안 HTTP POST 요청을 변환 엔드포인트로 전송합니다. 엔드포인트는 두 가지가 있습니다.

프로덕션 환경: https://www.google.com/maps/conversion/collect
샌드박스 환경: https://www.google.com/maps/conversion/debug/collect

테스트 토큰

전환 추적을 테스트하려면 피드에 제공하는 액션 링크 또는 예약 페이지 URL 끝에 다음 테스트 토큰 중 하나를 추가합니다.

토큰 A:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

토큰 B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

토큰 C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

성공적인 전환 이벤트를 전송하면 전환 추적 대시보드 아래의 작업 센터에서 집계된 이벤트를 확인할 수 있습니다.

conversion-tracking-dashboard

전환 기여 분석 요구사항

Google의 전환 기여 분석에 필요한 표준은 모든 매장에서 장소 액션 링크와의 상호작용에 대해 30일의 기여 분석 기간을 적용하는 것입니다.

이 기여 분석 기간은 Google이 다음 시나리오 중 하나에서 전환 이벤트가 전송될 것으로 예상할 수 있음을 의미합니다.

사용자가 장소 작업 링크를 따라 이동한 후 동일한 세션에서 동일한 판매자의 상품을 주문합니다. 판매자 변경 값 = 2입니다.
사용자가 장소 작업 링크를 따라간 후 30일 기여 분석 기간 내에 다른 채널에서 다시 방문하여 동일한 판매자의 제품을 주문합니다. 판매자 변경 값 = 2입니다.
사용자가 장소 작업 링크를 클릭한 후 30일 기여 분석 기간 내에 동일한 세션 또는 다른 세션에서 다른 매장에서 주문합니다. 판매자 변경 값 = 1.

또한 Google은 사용자가 장소 정보 작업 링크를 통해 액세스할 수 있는 모든 기기에서 전환 이벤트를 전송할 것으로 예상합니다. 이러한 기기는 다음과 같습니다.

데스크톱 또는 모바일 웹 애플리케이션
앱 딥 링크 또는 도메인에 등록된 앱 인텐트를 통한 모바일 앱

토큰이 사용자 수준에 저장된 경우 교차 기기 기여 분석을 제공해야 합니다. 자세한 내용은 사용자 수준 저장을 참고하세요. 이 경우 데스크톱에서 액션 링크를 클릭한 후 동일한 사용자 계정으로 모바일에서 거래를 완료하는 사용자가 전환 이벤트를 트리거해야 합니다.

토큰이 브라우저 쿠키와 같이 기기 수준에서만 저장되는 경우 교차 기기 기여 분석을 제공할 필요가 없습니다. 이 경우 사용자가 해당 기기에서 액션 링크를 클릭하면 각 기기에 별도의 토큰이 유지될 수 있으며 각 기기는 기여 분석 규칙을 별도로 따를 수 있습니다.

피드

통합 검토