전환 추적

경고: 전환 데이터의 일부로 사용자 개인 식별 정보가 정보 (PII)는 Google로 전송되지 않습니다.

구현

요약

전환 추적 구현은 다음과 같은 세 가지 요소로 구성됩니다.

  • 방문 페이지 / 앱에서 rwg_tokenmerchant_id 수집 진입점에 있습니다
  • 적절한 기여 분석을 위해 rwg_tokenmerchant_id 유지 창
  • 전환 시 유지된 merchant_idmerchant_id 비교 (예약 완료됨)입니다.
  • 전환 시점에 전환 이벤트 전송 (예약 완료)

이 전환 추적을 구현하려면 Google 애널리틱스 또는 기타 서드 파티 자바스크립트

전환 추적 구현 작업을 시작하기 전에 전환을 기기 수준에서 추적할지 아니면 사용자 수준에서 추적할지 결정합니다.

  • 기기 수준에는 브라우저 쿠키, 로컬 저장소, 앱 로컬 사용이 포함됩니다. 스토리지 또는 30일 동안 토큰을 유지할 수 있는 다른 방법 기여 산정 기간 토큰이 사용자의 사용자가 사용 중인 기기를 변경하는 경우 기기의 로컬 데이터 삭제 시크릿 브라우징 또는 시크릿 모드를 사용 중인 경우 전환 이벤트에 대한 기여도가 제대로 부여되지 않을 수 있습니다. 기기 수준을 사용하는 경우 지원되는 모든 계정에서 다시 구현해야 합니다 표시 경로 (모바일 포함)
  • 사용자 수준에는 서버 측 분석 시스템 또는 기타 서버 측 시스템입니다. 왜냐하면 사용자가 기기를 변경하면 토큰이 서버 측에 저장됨 로컬 저장소 또는 쿠키를 지우거나, 비공개 웹 서버를 사용 중인지 시크릿 모드를 사용해도 전환 이벤트는 여전히 한 번만 기여도가 부여됩니다. 사용자가 다시 로그인할 때 사용자 수준 전환 추적을 사용할 때는 시스템 아키텍처에서 이를 한 번 구현하거나 서버 측을 표시하고 지원되는 모든 표시 경로에서 재사용할 수 있습니다.

rwg_token 수집 중

피드를 통해 제공한 action_link가 Google에서 표시될 때마다 해당 URL이 고유한 쿼리 매개변수(rwg_token)를 포함하도록 수정됩니다. 이 rwg_token 값은 사용자가 클릭했지만 사용자 데이터가 없는 링크 이 토큰을 저장해야 하며 전환 이벤트의 일부로 다시 전달합니다.

각 방문 페이지 / 앱 진입점에서 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;
  }
}

merchant_id 수집 중

방문 페이지의 프런트엔드에 전환 추적 로직을 구현하는 경우 페이지에 있는 URL을 찾아 캡처하는 맞춤 스크립트를 구현해야 합니다. merchant_id 일반적으로 merchant_id는 방문 페이지 또는 URL에 포함할 수 있습니다. 그렇지 않은 경우 어딘가에 노출시킬 방법을 찾으세요. 어딘가에 노출시켜서 백엔드 변경사항을 적용할 수 있습니다

백엔드에서 전환 추적 로직을 구현하는 경우 생성할 내부 시스템을 쿼리하는 데이터와 함께 merchant_id 확인할 수 있습니다

merchant_id은(는) 다음에서 Google과 공유한 것과 같아야 합니다. 있습니다.

rwg_tokenmerchant_id 유지

rwg_token URL 매개변수를 유지해야 합니다. 총 30일간 제공된 모든 액션 링크에 추가됩니다. rwg_token의 값은 수정하지 않고 저장하고 반환해야 합니다.

rwg_token와 함께 연결된 merchant_id를 저장해야 합니다. 작업 링크를 클릭하세요.

이전 방문에서 유지되는 기존 토큰이 있는 경우 rwg_tokenmerchant_id는 대체되어야 하며, 스토리지를 재설정해야 합니다.

위의 쌍을 유지하면 기기에 값을 저장하거나 있습니다.

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

다음은 기기 수준 전환 추적의 예로, 이러한 값을 웹 브라우저와 연결된 네트워크입니다. 이 예에서는 위의 예와 같이 토큰 값을 변수로 변환합니다. 이 예를 사용하려면 rootdomain.com을(를) 도메인에 업데이트해야 합니다.

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

사용자 수준 전환 추적을 사용할 때는 rwg_token + merchant_id가 다음과 같아야 합니다. 서버에 저장되고 사용자와 연결됩니다.

전환 데이터 보내기

사용자가 Google 지역 정보에서 구매한 거래를 완료할 때 액션 링크가 포함된 경우 전환 엔드포인트에 HTTP POST 요청을 전송해야 합니다. 엔드포인트는 두 가지가 있습니다. 하나는 프로덕션 환경용이고 다른 하나는 실행할 수 있습니다.

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

post 본문은 다음과 같은 형식의 JSON 인코딩된 객체여야 합니다.

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

예 (파트너 20123456에 대한 테스트 토큰이 있는 변경되지 않은 판매자):

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

판매자_변경 값은 판매자가 변경되었는지 확인하는 데 사용됩니다. 초기 리디렉션 판매자로부터 액세스할 수 있습니다 두 가지 값을 전달할 수 있습니다.

판매자 변경 값 요구사항
1 이 값은 사용자가 구매 완료 다른 판매자와 거래하고
2 이 값은 고객이 원래 법인을 통해 거래를 완료한 경우 (판매자)

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

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

샌드박스에서 테스트하려면 다음 URL 매개변수를 수동으로 추가해야 합니다. 샌드박스 링크:

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

기기 수준 전환 추적의 전체 예 (사용자의 기기)가 포함된 페이지(예:

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

사용자 수준 전환 추적을 사용할 때는 사용자가 어떤 표면에 있는지와 상관없이 사이트에서 사용자와 서버 측 저장 메커니즘을 사용하고 동일한 프로덕션 또는 샌드박스 엔드포인트에서 사용할 수 있습니다

전환 기여 요건

Google의 필수 전환 기여 기준은 30일 기여입니다. 모든 상점에서 장소 링크와의 상호작용을 위한 창입니다.

이 기여 산정 기간은 Google에서 전환 이벤트가 다음 시나리오 중 하나에 해당될 경우:

  • 사용자가 작업 옵션 링크를 따라 동일한 판매자에게 주문 생성할 수 있습니다. (판매자 변경 값 = 2)
  • 사용자가 작업 옵션 링크를 따른 후 다른 채널에서 돌아옵니다. 30일 이내에 동일한 판매자를 위해 주문할 수 있습니다. (판매자 Change Value(값 변경 = 2)
  • 사용자가 작업 옵션 링크를 클릭한 후 다른 위치에서 주문합니다. 동일한 세션 내 또는 30일 내 다른 세션 내에서 발생한 광고 창 ( 판매자 변경 값 = 1)

또한 Google은 전환 이벤트가 작업 링크에서 방문할 수 있습니다. 다음을 포함합니다.

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

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

토큰이 브라우저와 같이 기기 수준에서만 저장된 경우 교차 기기 기여 분석을 제공하지 않는 것이 좋습니다. 이 이 경우 사용자가 작업 링크를 추가하고 각 기기는 별도로 규칙을 만들 수 있습니다