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

전환추적

요약

전환 추적은 Google의 Action Center 통합 중 하나를 통해 Google에서 시작한 전환을 추적하기 위한 것입니다. 이는 통합을 정상적으로 실행하는 데 매우 중요하며 특정 페이지의 순위에 영향을 줄 수 있습니다. Google에서 action_link를 표시할 때마다 고유한 쿼리 매개변수 rwg_token가 포함되도록 URL이 수정됩니다. 이 토큰을 저장하고 사용자가 예약을 완료할 때 적절한 값을 반환하는 것은 개발자 본인의 책임입니다.

통합을 완료하려면 다음을 완료해야 합니다.

rwg_token를 수집하고 저장합니다.
판매자를 수집하고 저장합니다.
rwg_token 및 merchant_change 값을 반환합니다.
전환 추적 테스트 및 확인

`rwg_token`를 수집하고 저장합니다.

이 통합을 완료하려면 최초 Google 추천 후 최대 30일 동안 rwg_token를 수집하고 저장해야 합니다. rwg_token 값은 링크 및 해당 액션 링크를 생성한 판매자에 관한 일부 메타데이터가 포함된 인코딩된 문자열입니다. 토큰에 사용자 데이터가 저장되거나 암호화되지 않습니다.

토큰 수집

사용자가 예약 페이지로 이동하면 제공된 URL에 새 쿼리 매개변수 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=/";
}

rwg_token를 저장할 위치를 결정할 때 다음을 고려하세요.

기기 수준 저장용량

기기 수준에는 브라우저 쿠키, 로컬 저장소, 앱 로컬 저장소 또는 30일 기여 분석 기간 동안 토큰을 유지할 수 있는 기타 모든 방법이 포함됩니다. 토큰은 사용자의 기기에 로컬로 저장되므로 사용자가 사용 중인 기기를 변경하거나 로컬 스토리지 또는 쿠키를 지우거나 시크릿 브라우징 또는 시크릿 모드를 사용 중인 경우 전환 이벤트에 기여도가 제대로 부여되지 않을 수 있습니다. 기기 수준 전환 추적을 사용하는 경우 지원되는 모든 노출 영역(모바일 포함)에서 이를 다시 구현해야 합니다.

사용자 수준 스토리지

사용자 수준에는 서버 측 분석 시스템 또는 기타 서버 측 시스템을 통해 애플리케이션 데이터베이스에 유지하는 작업이 포함됩니다. 토큰은 서버 측에 저장되므로 사용자가 사용 중인 기기를 변경하거나 로컬 저장소 또는 쿠키를 삭제하거나 시크릿 브라우징 또는 시크릿 모드를 사용하는 경우 사용자가 다시 로그인하면 전환 이벤트가 계속 기여 분석됩니다. 사용자 수준 전환 추적을 사용하는 경우 시스템 아키텍처에 따라 서버 측에서 한 번 구현하고 지원되는 모든 표시 경로에서 재사용할 수 있습니다.

Google에서 피드를 통해 제공한 action_link를 표시할 때마다 고유한 쿼리 매개변수 rwg_token가 포함되도록 URL이 수정됩니다. rwg_token 값은 사용자가 클릭한 링크에 관한 일부 메타데이터를 포함하는 인코딩된 문자열이지만 사용자 데이터는 포함하지 않습니다. 이 토큰을 저장하고 전환 이벤트의 일부로 다시 전달해야 합니다.

토큰 새로고침

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_change` 값을 반환합니다.

사용자가 Action Link 추천에서 시작된 예약을 완료하면 전환 엔드포인트에 HTTP POST 요청을 전송해야 합니다. 프로덕션 환경용 엔드포인트와 샌드박스 환경용 엔드포인트, 두 가지가 있습니다.

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

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

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"
}

다음 예는 사용자 기기에서 쿠키를 사용하여 기기 수준 전환 추적을 실행하는 방법을 보여줍니다. 자바스크립트로 작성되었습니다.

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_change에 할당할 값을 결정할 때는 판매자 수집 및 저장에 저장된 원래 판매자를 가져와 판매자가 변경되었는지 확인한 다음 값을 할당할 때 다음 표를 참고해야 합니다.

예약 페이지가 플랫폼 내에 있지 않거나 사용자가 다른 판매자로 이동할 수 없는 경우 이러한 요청의 값을 2로 하드코딩할 수 있습니다. 이는 예약 페이지를 판매자의 웹사이트에 통합하거나 예약 처리를 위한 맞춤 방문 페이지가 있는 파트너에게 일반적입니다.

판매자 변경 값	요구사항
1	이 값은 사용자가 원래 판매자의 웹사이트를 나와 다른 판매자의 플랫폼을 통해 구매를 완료한 경우에 사용해야 합니다.
2	이 값은 고객이 원래 항목(판매자)을 통해 거래를 완료한 경우에 사용해야 합니다.

전환 추적 테스트 및 확인

전환 추적 구현이 올바른지 확인하려면 다음 테스트를 실행해야 합니다. 판매자와 연결된 작업 링크를 사용하고 비공개 창 또는 시크릿 창에서 요청을 실행하여 해당 사용자와 연결된 이전 토큰이 삭제되도록 하세요.

작업 링크만 사용하여 예약 완료
- 추천 또는 이전에 저장된 토큰이 없는 직접 예약의 경우 Google에 요청이 전송되지 않습니다.
rwg_token가 추가된 링크를 사용하여 예약을 완료합니다.
- 요청이 성공적으로 전송되고 rwg_token 및 merchant_change 값이 2인지 확인합니다.
- rwg_token를 30일 동안 저장해야 합니다.
새 rwg_token를 사용하여 동일한 판매자와 새 예약을 완료합니다.
- 요청이 성공적으로 전송되고 새 rwg_token 및 merchant_change 값 2로 전송되었는지 확인합니다.
- 토큰의 기여 분석 저장 기간이 30일 동안 새로고침되는지 확인
테스트 중인 판매자의 예약 페이지로 직접 이동하여 rwg_token를 추가하지 않고 새 예약을 진행합니다.
- 요청이 이전에 저장된 rwg_token와 함께 전송되고 merchant_change 값이 2인지 확인합니다.

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

rwg_token가 추가된 링크를 사용하여 판매자의 예약 페이지로 이동한 다음 다른 판매자로 이동하여 예약합니다.
- 요청이 rwg_token 및 merchant_change 값이 1인 상태로 전송되는지 확인합니다.

테스트할 때는 HTTP POST 요청을 전환 엔드포인트로 전송합니다. 프로덕션 환경용 엔드포인트와 샌드박스 환경용 엔드포인트가 각각 하나씩 있습니다.

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

다음 토큰을 액션 링크 또는 URL에 추가해야 합니다.

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

추가 토큰이 필요한 테스트에는 다음 토큰을 사용하세요.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

전환 이벤트를 전송하면 전환 추적 대시보드 아래의 작업 센터에서 집계된 전환 이벤트를 확인할 수 있습니다. 전환이 대시보드에 표시되기까지 최대 1시간이 걸릴 수 있습니다.

conversion-tracking-dashboard

전환 기여 분석 요구사항

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

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

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

또한 Google은 사용자가 장소 액션 링크에서 방문할 수 있는 모든 표시 경로에서 전환 이벤트가 전송되기를 기대합니다. 다음을 포함합니다.

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

토큰이 사용자 수준에 저장되는 경우 (토큰 유지 참고) 교차 기기 기여 분석을 제공해야 합니다. 즉, 데스크톱에서 작업 링크를 클릭한 후 동일한 사용자 계정을 사용하여 휴대기기에서 거래를 완료하는 사용자는 전환 이벤트를 트리거해야 합니다.

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

피드

통합 검토