[GTM-Vi] - Hướng dẫn

Bước 1: Tạo Tag mới “Set Network Cookie“

• Truy cập https://tagmanager.google.com và tạo chiến dịch mới theo tên miền của đối tác của MasOffer.

• Để có thể lưu lại được cookie, đối tác cần tạo 1 Tag có kiểu Custom HTML trên GTM.

• Đoạn code HTML này có chứa script JS giúp chúng ta có thể thiết lập được tên của cookie (cookie name), và thời hạn tồn tại của cookie (cookie expiration).

• Để tạo tag, chọn New Tag -> Thay thế Untitled Tag bằng Set Network Cookie -> click Tag Configuration -> chọn Custom HTML trong Choose tag type.

Tại trang quản lý. chọn New

Thay thể Untilted Tag với Set Network Cookie

Chọn Custom HTML trong Choose tag type

Step 2: Trong HTML nhập vào đoạn mã tracking sau

<script>
"use strict";

let MasOffer = (function () {
    //set cookies when traffic_id exist on url
    function getFromUrl(name, url) {
        if (!url) url = location.href;
        name = name.replace(/[\[]/, "\\[").replace(/[\]]/, "\\]");
        let regexS = "[\\?&]" + name + "=([^&#]*)";
        let regex = new RegExp(regexS);
        let results = regex.exec(url);
        return results == null ? null : results[1];
    }

    function setCookie(key, value, e) {
        let d = new Date();
        d.setTime(d.getTime() + e * 24 * 60 * 60 * 1000);
        let ee = "expires=" + d.toUTCString();
        document.cookie = key + "=" + value + "; " + ee + "; path=/";
    }

    function moTrack() {
        let trafficIdUrl = getFromUrl("traffic_id");
        let refUrl = getFromUrl("ref");
        let utmSourceUrl = getFromUrl("utm_source");

        if (utmSourceUrl !== null) {
            setCookie("mo_network", utmSourceUrl, 30);
        }

        if (refUrl !== "mo") {
            return false;
        }

        if (trafficIdUrl) {
            setCookie("mo_click_id", trafficIdUrl, 30);
            return true;
        }

        return false;
    }

    let getCurrentScript = function () {
        if (document.currentScript) {
            return document.currentScript.src;
        }
    };

    function getCookie(cname) {
        let name = cname + "=";
        let ca = document.cookie.split(";");

        for (let i = 0; i < ca.length; i++) {
            let c = ca[i];

            while (c.charAt(0) == " ") c = c.substring(1);

            if (c.indexOf(name) == 0) return c.substring(name.length, c.length);
        }

        return undefined;
    }

    return {
        init: function () {
            moTrack();
        },
    };
})();

MasOffer.init();
</script>

Các giá trị cần lưu ý

• Cookie Name: tên cookie cần có có ý nghĩa, ví dụ ở đây là “mo_traffic_id”.

• Cookie Value: giá trị cookie sẽ phụ thuộc vào tham số trên URL, ví dụ URL có dạng https://domain.com/?utm_source=masoffer&traffic_id=5dee042bb677b900405e272e, đối tác sử dụng tham số “utm_source” để xác định nguồn traffic và “traffic_id” để xác định nguồn publisher của MasOffer.

• Cookie Expiration Time: thời gian tồn tại của cookie, thường sẽ được thiết lập là 30 ngày.

Step 3: Thêm Trigger vào Tag

Sau khi chèn mã HTML ấn vào Triggering để thêm sự kiện.

Mục đích thêm trigger là đăng ký với trình duyệt mỗi khi vào trang thì đoạn mã chúng ta vừa thêm bên trên sẽ được chạy.

Chọn All Page để đoạn code có thể chạy được trên tất cả các trang

Ấn Save/Lưu để hoàn thành việc thêm tag.

Cuối cùng đối tác cần Submit và Publish tất cả những thay đổi.

Kiểm tra việc cài đặt thành công

1. Lấy ví dụ domain trang đối tác là partner.masoffer-example.com

2. Truy cập link: partner.masoffer-example.com?utm_source=masoffer&traffic_id=&ref=mo

3. Nhấn F12 hoặc Ctrl+shift+I, vào thẻ Application

Lưu ý: Thay thế tên miền partner.masoffer-example.com bằng tên miền của đối tác

Chọn mục Cookies ở sidebar bên tay trái và chọn vào domain của đối tác, sau đó search từ khóa mo_ nếu ghi nhận được hai cookie có name là mo_network và mo_click_id thì đối tác đã setup việc lưu và đọc cookies thành công.

Tài liệu liên quan

🌟[ECOMMERCE] - Intergration | Tích hợp📝[SCRIPT] - Order Recording | Ghi nhận đơn hàng

Tìm hiểu thêm những trường mà hệ thống MasOffer ghi nhận. Điều kiện ghi nhận.

Other related knowledge:

👉[GTM] - Khái niệm👉[COOKIE]👉[KIẾN THỨC] - CPS, CPL, CPO, CPA, CPI là gì?