전환 추적

목표: 약속 비즈니스 링크 통합에 대한 전환 추적을 구현합니다.

경고: 전환 데이터의 일부로 사용자 개인 식별 정보 (PII)가 Google로 전송되지 않도록 하세요.

구현

요약

전환 추적 구현에는 세 가지 요소가 있습니다.

1. 방문 페이지 / 앱 진입점에서 rwg_token를 수집합니다.
2. 적절한 기여 산정 기간의 rwg_token 유지
3. 결제 시 전환 이벤트 전송

이 전환 추적 구현은 Google 애널리틱스 또는 기타 타사 자바스크립트를 사용하지 않아도 됩니다.

핵심사항: 전환 추적은 기기 수준과 사용자 수준의 두 가지 수준으로 구현할 수 있습니다. 통합 과정에서 두 가지 모두 지원되며 제품 아키텍처에 따라 선택할 수 있습니다.

전환 추적 구현 작업을 시작하기 전에 기기 수준 또는 사용자 수준에서 전환을 추적할지 여부를 결정해야 합니다.

• 기기 수준에는 브라우저 쿠키, 로컬 저장소, 앱 로컬 저장소 또는 30일 기여 산정 기간 동안 토큰을 유지할 수 있는 기타 방법을 사용하는 것이 포함됩니다. 토큰은 사용자의 기기에 로컬로 저장되므로 사용자가 사용 중인 기기를 변경하거나 로컬 저장소/쿠키를 지우거나 시크릿 브라우징 또는 시크릿 모드를 사용하는 경우 전환 이벤트에 제대로 반영되지 않을 수 있습니다. 기기 수준 전환 추적을 사용하는 경우 지원되는 모든 표시 경로 (모바일 포함)에서 이를 다시 구현해야 합니다.
• 사용자 수준에는 서버 측 분석 시스템 또는 다른 서버 측 시스템을 통해 애플리케이션 데이터베이스에 데이터를 유지하는 것이 포함됩니다. 토큰은 서버 측에 저장되므로 사용자가 사용 중인 기기를 변경하거나 로컬 저장소/쿠키를 삭제하거나 시크릿 브라우징 또는 시크릿 모드를 사용하는 경우 사용자가 다시 로그인하면 전환 이벤트에 계속 기여합니다. 사용자 수준 전환 추적을 사용하는 경우 시스템의 아키텍처에 따라 서버 측에서 이를 한 번만 구현하면 지원되는 모든 플랫폼에서 재사용할 수 있습니다.

rwg_token 수집 중

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

각 방문 페이지 / 앱 진입점에서 rwg_token 쿼리 매개변수에 설정된 값을 파싱하여 저장해야 합니다. 이 매개변수를 저장하기 위한 요구사항은 rwg_token 유지 단계에 설명되어 있습니다.

다음은 브라우저를 통한 기기 수준 추적에서 이 토큰을 파싱하는 방법의 예입니다. 또는 요청에 응답할 때 서버 측에서 이 토큰을 수집할 수도 있습니다.

<script>
  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;
    }
  }
</script>

rwg_token 유지

참고: 필수 기여 산정 기간을 올바르게 구현하려면 rwg_token를 유지하는 것이 중요합니다. 저작자 표시 요구사항에 관한 자세한 내용은 아래 전환 기여 분석 요구사항 섹션을 참고하세요.

rwg_token URL 매개변수를 총 30일 동안 유지해야 합니다. 이 매개변수는 제공된 모든 작업 링크에 추가됩니다. rwg_token의 값은 어떠한 수정 없이 저장하고 반환해야 합니다. 이전 방문에서 유지된 기존 토큰이 있는 경우 이전 토큰을 대체하고 30일 저장 기간을 재설정해야 합니다.

토큰을 유지할 때 기기 수준 또는 사용자 수준에서 토큰을 저장할 수 있습니다.

• 기기 수준에는 브라우저 쿠키, 로컬 저장소, 앱 로컬 저장소 또는 30일 기여 산정 기간 동안 토큰을 유지할 수 있는 기타 방법을 사용하는 것이 포함됩니다.
• 사용자 수준에는 서버 측 분석 시스템 또는 다른 서버 측 시스템을 통해 애플리케이션 데이터베이스에 데이터를 유지하는 것이 포함됩니다.

다음은 퍼스트 파티 쿠키를 통해 이 토큰을 웹브라우저에 저장하는 기기 수준 전환 추적의 예입니다. 이 예에서는 위의 예와 같이 토큰 값을 변수로 파싱했다고 가정합니다. 이 예를 사용하려면 'rootdomain'을 내 도메인으로 업데이트해야 합니다.

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

사용자 수준 전환 추적을 사용할 때는 rwg_token가 서버에 저장되고 사용자와 연결되어야 합니다.

전환 데이터 전송

사용자가 Google 장소 작업 링크에 기인하는 거래를 완료하면 변환 엔드포인트에 HTTP POST 요청을 전송해야 합니다. 엔드포인트는 두 개가 있습니다. 하나는 프로덕션 환경용이고 다른 하나는 샌드박스 환경용입니다.

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

게시물 본문은 다음 형식의 json으로 인코딩된 객체여야 합니다.

{
  'conversion_partner_id': partnerId,
  'rwg_token': <rwg_token_val>
}

샌드박스 환경과 프로덕션 환경 모두에서 전환 이벤트를 전송할 때 유효한 rwg_token를 제공해야 합니다. 샌드박스 환경에서는 테스트 목적으로 다음 테스트 토큰을 사용할 수 있습니다.

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

참고: 프로덕션에서는 이 통합에 기인하지 않는 전환 이벤트를 전송하면 안 됩니다. 이벤트를 전송하기 전에 유효한 rwg_token 값이 만료되지 않았는지 확인하세요.

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
    })
  });
}

사용자 수준 전환 추적을 사용하는 경우 서버 측 저장소 메커니즘에서 (사용자가 노출되는 표면에 관계없이) 사용자와 연결된 토큰을 검색하고 동일한 프로덕션 또는 샌드박스 엔드포인트를 사용하여 토큰을 전송해야 합니다.

참고: 전환 이벤트는 웹 또는 앱 클라이언트 또는 서버에서 전송할 수 있습니다. 전환 이벤트가 전환당 정확히 한 번만 전송되고 유효한 rwg_token 값을 포함하는 한 요구사항과 토큰이 저장된 위치에 따라 결정을 내릴 수 있습니다.

전환 기여 분석 요구사항

전환 기여 분석에 Google의 필수 표준은 모든 매장에서 장소 링크와의 상호작용에 대한 기여 산정 기간 30일입니다.

참고: 이 기여 분석 프레임워크는 애널리틱스 시스템이 전환에 기여도를 부여하는 방식과 다를 수 있습니다. 이 시스템은 시스템에서 수행 중인 전환 추적과는 별개로 작동하도록 설계되었으며 내부 분석에 영향을 미치지 않습니다.

이 기여 산정 기간은 다음과 같은 시나리오에서 전환 이벤트가 전송될 것으로 예상함을 의미합니다.

• 사용자가 작업 옵션 링크를 따라 동일한 세션에서 주문합니다.
• 사용자가 장소 작업 링크를 따른 후 30일 이내에 다른 채널에서 돌아와 주문합니다.
• 사용자가 작업 옵션 링크를 따라 다른 매장(동일한 세션 내 또는 30일 기간 내의 다른 세션 내)에서 주문합니다.

또한 사용자가 장소 작업 링크에서 방문할 수 있는 모든 위치에서 전환 이벤트가 전송될 것으로 예상됩니다. 다음을 포함합니다.

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

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

토큰이 브라우저 쿠키와 같이 기기 수준에서만 저장되는 경우 교차 기기 기여 분석을 제공하지 않아야 합니다. 이 경우 사용자가 해당 기기에서 작업 링크를 따라간 경우 각 기기에는 별도의 토큰이 유지되며 각 기기는 저작자 표시 규칙을 개별적으로 따릅니다.