설명서Analytics구현 안내서

하드코딩된 이미지 요청으로 구현

Last update: Fri Jan 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

Adobe에서 제공하는 AppMeasurement 라이브러리는 페이지에 있는 변수를 컴파일한 후 Adobe에 이미지 요청으로 보냅니다. AppMeasurement 라이브러리를 모두 건너뛰고 이미지 요청을 수동으로 Adobe에 보낼 수 있습니다. 이 방법을 사용하려면 이미지 요청 및 쿼리 문자열을 수동으로 만들어야 합니다.

이 구현 방법은 외부 소스의 이미지를 표시하는 모든 플랫폼에서 사용할 수 있습니다. JavaScript은 전혀 사용하지 않습니다.

NOTE
하드코딩된 이미지 요청은 설정하기 쉽지만 대규모 프로젝트에서 디버그, 유지 관리 및 확장을 수행하기는 어렵습니다. 계속하기 전에 하드코딩된 이미지 요청이 가장 적합한 옵션인지 확인하십시오.

이미지 요청 구문

다음은 HTML을 사용하여 하드코딩된 이미지 요청의 예입니다.

<img src="https://example.data.adobedc.net/b/ss/examplersid/1/s234234238479?AQB=1&g=http%3A%2F%2Fexample.com&pageName=Example%20hardcoded%20hit&v1=Example%20value&AQE=1"/>
  • https://는 프로토콜을 지정합니다. 이미지 요청에 사용된 프로토콜을 나머지 사이트에서 사용하는 프로토콜과 일치시키십시오.
  • example.data.adobedc.net은 trackingServer 변수에 포함된 값입니다.
  • /b/ss/는 모든 이미지 요청에 포함됩니다. 이 항목은 Adobe 데이터 수집 서버에 저장된 이미지용 파일 구조의 일부입니다.
  • examplersid는 전송한 데이터를 받을 보고서 세트 ID입니다. 여러 보고서 세트의 경우 공백 없이 쉼표로 ID를 구분하십시오(예: examplersid1,examplersid2 등).
  • /1/은 히트 소스입니다. 내보내기 사용 안내서의 데이터 열 참조 아래에서 hit_source를 참조하십시오. 방문자 식별을 위해 쿠키와 기타 방법에 의해 사용되는 순서를 제어합니다.
  • /s234234238479 ("s" + 임의의 숫자)은 브라우저가 이미지 요청을 캐싱하는 것을 방지합니다.
  • 쿼리 문자열 구분 기호 (?) 뒤의 모든 내용이 보고서에 포함할 데이터입니다. 이미지 요청에 포함할 수 있는 매개 변수의 전체 목록이 필요하면 데이터 수집 쿼리 매개 변수를 참조하십시오.

Microsoft Outlook의 하드코딩된 이미지 요청

대부분의 이메일은 HTML을 기반으로 하므로 열린 이메일을 추적하고 해당 데이터를 Adobe Analytics에 보낼 수 있습니다. 조직에서 이 방법을 사용하도록 선택하는 경우 다음을 참고하십시오.

  • 모든 이메일 렌더링은 과금 가능한 서버 호출을 증가시킬 수 있습니다.
  • HTML을 지원하고 이미지를 허용하는 이메일 클라이언트만 추적됩니다. Microsoft Outlook과 같은 일부 이메일 클라이언트는 기본적으로 외부 이미지를 차단합니다. 이러한 이메일은 수신자가 외부 이미지를 다운로드하도록 선택하기 전까지 추적되지 않습니다.

이미지 요청이 포함된 Outlook 이메일을 작성하려면 다음을 수행하십시오.

  1. HTML 편집기를 엽니다. HTML 편집기를 사용할 수 없다면 일반 텍스트 편집기도 작동합니다.
  2. 새 HTML 파일에서, <body> 태그로 둘러싸인 하드코딩된 이미지 요청 <img> 태그를 삽입합니다.
  3. HTML 파일을 저장합니다.
  4. Microsoft Outlook을 열고 이메일을 작성합니다.
  5. 삽입 탭으로 이동하여 파일 첨부 ​를 클릭합니다. 이미지 요청 HTML 파일을 선택합니다.
  6. 삽입 옆에 있는 팝업 메뉴를 클릭하고 텍스트로 삽입 ​을 선택합니다. 팝업 메뉴 없이 삽입 버튼을 클릭하면 HTML 파일이 첨부 파일이 되어 작동하지 않습니다.

이미지 요청이 1x1 투명 픽셀이므로 이메일은 변경되지 않습니다. 테스트 목적으로 이미지 요청을 보려면 테두리, 추가 텍스트 또는 기타 콘텐츠를 포함하도록 HTML 파일을 수정하십시오.

FAQ

하드코딩된 이미지 요청을 사용하는 일반적인 질문에 대해 알아봅니다.

쿼리 문자열 매개 변수는 대/소문자를 구분합니까?

예. 쿼리 문자열 매개 변수가 정확히 일치하는지 또는 기록되지 않았는지 확인하십시오. 예를 들어 pagename은 유효한 쿼리 문자열 매개 변수가 아닌데 pageName은 유효한 쿼리 문자열 매개 변수입니다.

쿼리 문자열에 공백을 포함할 수 있습니까?

각 쿼리 문자열 매개 변수의 값은 URL로 인코딩됩니다. URL 인코딩은 URL에서 일반적으로 허용되지 않는 문자를 올바른 문자로 변환합니다. 예를 들면 공백 문자는 %20으로 변환됩니다. 영숫자가 아닌 모든 문자가 URL로 인코딩되어 있는지 확인하십시오. Adobe는 이미지 요청이 데이터 수집 서버에 도달할 때 값을 자동으로 URL 디코딩합니다.

URL 인코딩의 작동 방법에 대한 자세한 내용은 W3Schools의 HTML URL 인코딩 참조를 참조하십시오.

단일 값에 사용할 수 있는 최대 문자 수는 얼마입니까?

각 변수에는 서로 다른 최대 길이가 있습니다. 대부분의 트래픽 변수는 최대 100바이트를 보유하는 반면 대부분의 전환 변수는 최대 255바이트를 보유합니다. 이미지 요청이 데이터 수집 서버에 도달하면 Adobe는 이러한 값을 최대 길이로 자동으로 자릅니다.

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690