Mintegral Pixel: 커스텀 온라인 스토어 직접 연동 가이드

Direct Code Integration to a Custom Online Store

사용 사례: 맞춤형 온라인 스토어가 GTM을 사용하지 않거나, SDK를 직접 삽입하는 방식을 선호하는 경우입니다.

Integration Steps

Step 1: Pixel SDK 로드

다음 스크립트를 복사하여 붙여넣고 웹사이트 전체에 적용합니다.

<script>
(function (w, d) {
  var u = "https://cdn-static.mintegral.com/sdk/pixel.js";
  if (w.mintegralPixel) return;
  var s = (w.mintegralPixel = function () {
    s.performOperation
      ? s.performOperation.apply(s, arguments)
      : s.operationQueue.push(arguments);
  });
  s.operationQueue = [];
  var f = d.getElementsByTagName("script")[0],
    e = d.createElement("script");
  e.async = !0;
  e.src = u;
  f.parentNode.insertBefore(e, f);
})(window, document);

mintegralPixel("init", {
  setupType: 1 // 1 - self-built website
});
</script>

Step 2: MTG 공식 이벤트 리포팅

<script>
mintegralPixel("track", {
  "type": <event_name>, 
  "data": <event_data>
});
</script>

Parameters

Enhanced User Identification (Recommended)

Mintegral Pixel은 사용자를 식별하기 위해 퍼스트파티 쿠키 <span data-type="text">_mtgtrk</span>를 설정합니다. 이 쿠키는 웹사이트에 대한 모든 요청에 자동으로 전송됩니다. 사용자 식별을 강화하기 위해, Mintegral은 사이트 백엔드에서 다음 작업을 수행할 것을 강력히 권장합니다.

HTTP 요청에서 쿠키 <span data-type="text">_mtgtrk</span>가 확인될 때마다, 응답에 새 퍼스트파티 HTTP 쿠키 <span data-type="text">mtgtrk</span>(앞의 밑줄 제거)를 설정하는 헤더를 포함하도록 HTTP 응답을 설정하세요. 만료일은 1년 후로 설정합니다.

• 새 쿠키의 값은 들어온 요청의 해당 <span data-type="text">_mtgtrk</span> 쿠키 값과 정확히 동일해야 합니다.
• 쿠키의 도메인은 사이트 도메인이어야 하며, 앞에 마침표를 붙여야 합니다.
  • 예시: 사이트가 <span data-type="text">yoursite.com</span>인 경우 domain 속성은 <span data-type="text">.yoursite.com</span>이어야 합니다.
  • ⚠️ Note: 여기에는 <span data-type="text">"www"</span>를 포함하지 않아야 합니다.
• 쿠키의 path는 <span data-type="text">/</span>여야 합니다.
• 쿠키를 <span data-type="text">HttpOnly</span>로 설정하지 마세요.

Example:

사이트가 다음 값의 <span data-type="text">_mtgtrk</span> 쿠키가 포함된 HTTP 요청을 수신하는 경우:

exxxxxxx-8xxx-4xxx-bxxx-1xxxxxxxxxxx

HTTP 응답에는 다음이 포함되어야 합니다.

Set-Cookie: mtgtrk=exxxxxxx-8xxx-4xxx-bxxx-1xxxxxxxxxxx;
Expires=«One Year from Today»; Domain=«.yoursite.com»; Path=/; SameSite=Lax;