오프라인 전환 가져오기(OCI)는 GCLID를 사용하여 가져오기에서 발생한 오프라인 전환을 추적합니다. GCLID를 사용할 수 없는 시나리오에서 OCI 사용자는 해싱된 사용자 제공 데이터, wbraid/gbraid 또는 session_attributes와 같은 다른 식별자를 사용할 수 있습니다.
이 페이지의 내용
session_attributes에 대한 정보
session_attributes는 사용자와 웹사이트의 상호작용에 대한 추가 컨텍스트와 신호를 제공하는 필드로, 이를 통해 전환 측정, 보고(동일/교차 기기 분석 포함), 입찰 정확성을 개선할 수 있습니다. 아래의 프런트엔드 스크립트를 사용하여 session_attributes의 base64 인코딩 문자열을 만들어 데이터베이스/CRM에 전달하고 API 가져오기에서 Google에 전송할 수 있습니다. 프런트엔드 스크립트를 사용할 수 없는 경우 session_attributes_key_value_pairs 필드를 사용하여 각 키-값 쌍을 개별적으로 전송하세요.
하위 필드를 모두 전송하는 것이 좋지만 원하는 만큼 전송할 수 있습니다. 모든 하위 필드는 선택사항입니다. session_attributes 필드의 권장 스토리지 크기는 5KB입니다. 대부분의 사용량은 이 크기를 초과하지 않습니다. session_attributes가 이보다 큰 경우 CRM 제공업체와 협력하여 필드 크기를 수정하거나(적극 권장됨) JavaScript 도우미 함수에서 landing_page_url 및 landing_page_referrer 매개변수를 삭제하세요.
다음은 session_attributes 필드 내의 하위 필드입니다.
gad_source: 광고에서 발생한 트래픽의 소스를 나타내기 위해 URL에 게재되는 집계 매개변수입니다. gad_* URL 매개변수에 대해 자세히 알아보세요.gad_campaignid: 광고 클릭을 유도한 특정 광고 캠페인의 ID입니다. gad_* URL 매개변수에 대해 자세히 알아보세요.landing_page_url: 웹사이트 방문 페이지의 전체 URL입니다. 사용자가 처음으로 도착한 특정 페이지를 나타냅니다.session_start_time_usec: 웹사이트에서 사용자의 세션이 시작된 시점의 타임스탬프입니다. 이를 통해 사용자 방문 기간을 추적할 수 있습니다. UNIX 타임스탬프 에포크 마이크로초 단위의 일관된 시간 형식을 사용하는 것이 중요합니다.landing_page_referrer: 사용자를 웹사이트로 연결한 웹페이지의 URL입니다. 이를 통해 사이트로 유입되는 트래픽 소스를 파악할 수 있습니다. 리퍼러에 관한 자세한 내용은 이 도움말을 참고하세요. 이 도움말은 애널리틱스에 중점을 두고 있지만 리퍼러의 개념은 웹 전반에서 보편적입니다.landing_page_user_agent: 사용자의 브라우저와 운영체제를 식별하는 문자열입니다. 이 정보는 사용자의 기술 환경을 이해하는 데 유용할 수 있습니다.
session_attributes를 캡처하는 방법
방문 페이지에서 아래의 JavaScript 도우미 함수와 HTML 양식을 사용하여 session_attributes를 캡처하고 유지할 수 있습니다.
이 코드 예는 데이터를 localStorage에 유지합니다. 웹사이트에 구현하기 전에 웹사이트별 동의 및 데이터 보관 요구사항이 필요에 따라 준수되는지 추가 확인하세요.
HTML 양식
session_attributes에 숨겨진 필드를 추가하려면 각 양식 제출 페이지를 수정해야 합니다. 그러면session_attributes가 백엔드 시스템에 전달됩니다. 다음은 이를 보여주는 샘플 코드입니다.<form action="" name="myForm">
Name: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Submit Form" name="btnSubmit">
</form>session_attributes_encoded를 캡처하여 양식 필드에 설정하는 샘플 스크립트입니다. 이 코드 예는 데이터를 localStorage에 유지합니다.<script>
function getSessionAttributes() {
const searchParams = new URLSearchParams(window.location.search);
if (Array.from(searchParams.keys()).some(key => key.startsWith('gad_')) ||
searchParams.has('gclid') || searchParams.has('gbraid')) {
const params = {};
searchParams.forEach((value, key) => {
if (key.startsWith('gad_')) params[key] = value;
});
params['session_start_time_usec'] =
(new Date().getTime() * 1000).toString();
params['landing_page_url'] = window.location.href;
params['landing_page_referrer'] = document.referrer;
params['landing_page_user_agent'] = navigator.userAgent;
const sessionAttributesEncoded = btoa(JSON.stringify(params))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '');
localStorage.setItem('google_session_attributes', sessionAttributesEncoded);
return sessionAttributesEncoded;
}
return localStorage.getItem('google_session_attributes') || '';
}
function addSessionAttributes() {
const sessionAttributesEncoded = getSessionAttributes();
var sessionAttributesFormField =
document.getElementById('session_attributes_field');
if (sessionAttributesFormField && sessionAttributesEncoded != '') {
sessionAttributesFormField.value = sessionAttributesEncoded;
}
}
window.addEventListener('load', addSessionAttributes);
</script>
Google Ads로 데이터를 전송하는 방법
1. Google Ads API의 session_attributes_encoded 필드
JavaScript를 사용하는 기존 오프라인 전환 가져오기(OCI) 사용자의 경우 기존 업로드 스키마 내에 ClickConversion.session_attributes_encoded라는 새 필드에 제공된 JavaScript에서 캡처한 인코딩된 session_attributes를 설정하여 이 데이터를 전송합니다. 현재 OCI 프로세스를 계속 사용하되 가져올 때 이 새 필드를 설정합니다. 다른 식별자가 없는 경우 Google Ads에서는 session_attributes를 사용합니다.
모든 신규 사용자는 Data Manager API를 사용해야 합니다. Google Ads API를 통해 IP 주소 또는 세션 속성을 전송하도록 계정이 허용 목록에 추가되지 않은 경우 해당 전환에 대한 오류 메시지가 표시됩니다.
고급
JavaScript를 사용할 수 없는 경우 개별 키-값 쌍을 캡처하여 오프라인 전환 가져오기와 함께 전송할 수 있습니다.
JavaScript를 사용하지 않는 기존 오프라인 전환 가져오기(OCI) 사용자의 경우 기존 업로드 스키마 내에 ClickConversion.session_attributes_key_value_pairs라는 키-값 쌍 필드를 설정할 수도 있습니다. API를 호출할 때 이 필드와 함께 키-값 쌍을 전송하는 것이 좋습니다. ClickConversion에 개별 키-값 쌍을 추가하는 방법이 설명된 개발자 문서를 참고하세요.
2. 데이터 관리 도구를 사용하는 session_attributes 필드
데이터 관리 도구를 사용하여 session_attributes 필드를 전송할 수도 있습니다.
- 데이터 관리 도구 UI: 제공된 JavaScript를 사용하여
session_attributes필드를 만들고 데이터 관리 도구 UI를 통해 업로드합니다. - Data Manager API: Data Manager API와 통합하여 프로그래매틱 방식으로 데이터를 업로드할 수 있습니다. 구체적인 안내와 스키마 세부정보는 데이터 관리 도구 문서를 참고하세요.
올바른 데이터를 전송하면 Google Ads에서 이 정보를 사용하여 올바른 캠페인에 전환 기여도를 부여하고 더 포괄적인 전환 보고 기능을 제공할 수 있습니다.