Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

전환추적

개요

전환 추적은 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이 파싱되는 방법을 보여줍니다.

const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;

토큰 저장

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

기기 수준
사용자 수준

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

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

if (rwgToken !== undefined) {
  document.cookie =
  "_rwgToken=" + rwgToken + "; max-age=2592000; domain=rootdomain.com; path=/";
}

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

기기 수준에서 저장

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

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

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

사용자 수준에서 저장

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

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

토큰 새로고침

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

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

판매자 정보 파싱 및 저장

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

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

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

// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
  document.cookie =
  "_rwgToken=" + rwgToken + "; _merchantId=" + 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과 1 또는 2의 merchant_changed 값을 포함해야 합니다. merchant_changed에 관한 자세한 내용은 판매자 변경 값 반환을 참고하세요.

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

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

{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AFd1xnHrJWKcjtriCyB5j3QL0bzbmLdcg1N1f5cJuSNVhteYjuOJz18Au6GIAT0tjHkw6fkUJKcarafV45b3c_gl7uT_o8HMcg==",
  "merchant_changed": "2"
}

다음 예에서는 JavaScript로 작성된 사용자 기기의 쿠키를 사용한 기기 수준 전환 추적을 보여줍니다.

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

// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;

// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: decodeURIComponent(storedRwgToken),
      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 가 사용되지만 예약을 완료하기 전에 다른 페이지로 이동하여 원래 추천과 다른 판매자와 예약을 완료합니다.	사용자가 Google에서 추천받은 토큰 A 로 시작된 예약을 완료하고 추천과 다른 판매자에서 예약을 완료했으므로 판매자 변경 값이 1 인 전환 이벤트가 전송됩니다.

테스트하는 동안 전환 엔드포인트에 HTTP POST 요청을 보냅니다. 엔드포인트는 두 개입니다.

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

테스트 토큰

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

토큰 A:

rwg_token=AFd1xnHrJWKcjtriCyB5j3QL0bzbmLdcg1N1f5cJuSNVhteYjuOJz18Au6GIAT0tjHkw6fkUJKcarafV45b3c_gl7uT_o8HMcg%3D%3D

토큰 B:

rwg_token=AE37R_gte8WCEaytMalsIr9agWQRLuN8199RsVhU2WoRKRvcZ0eBTD8cFvnfUZh-GY0IvY-zjS3W9KWAmy3WDiWXbVvQRZyzMQ%3D%3D

토큰 C:

rwg_token=AE37R_jmAP-UgWNApkxwdlX5M2z1UBGuUzHZ63YWmRWeTjRJKxfSD1mzJ4joLnB11MHrBULuisjP-9I64LnBJDXyCc_CIJSCPg%3D%3D

전환 이벤트가 성공적으로 전송되면 액션 센터의 전환 추적 대시보드에서 집계된 전환 이벤트를 확인할 수 있습니다.

conversion-tracking-dashboard

전환 기여 분석 요구사항

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

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

사용자가 작업 옵션 링크를 따라 동일한 세션에서 동일한 판매자의 주문을 합니다. 판매자 변경 값 = 2
사용자가 작업 옵션 링크를 따라 30일 기여 산정 기간 내에 다른 채널에서 돌아와 동일한 판매자의 주문을 합니다. 판매자 변경 값 = 2
사용자가 장소 정보 작업 링크를 따라 동일한 세션 내 또는 30일 기여 분석 기간 내의 다른 세션에서 다른 매장의 주문을 합니다. 판매자 변경 값 = 1

또한 Google은 사용자가 작업 옵션 링크를 통해 액세스할 수 있는 모든 기기에서 전환 이벤트를 전송할 것으로 예상합니다. 이러한 기기에는 다음이 포함됩니다.

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

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

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