Bài viết này cũng có sẵn trong:
Khi tích hợp các plugin của bên thứ ba để tiếp thị qua email hoặc gửi khảo sát đánh giá, sẽ có khả năng các nền tảng của bên thứ ba này yêu cầu về các biến sau khi khách hàng hoàn tất quá trình thanh toán tại cửa hàng ShopBase. Bài viết này sẽ đi qua các trường phổ biến nhất trên cửa hàng ShopBase và cách sử dụng chúng khi tích hợp các plugin của bên thứ ba.

Vui lòng tham khảo bài viết này về cách thêm Power Up Scripts để tích hợp các plugin của bên thứ ba và tối ưu hóa cửa hàng của bạn.

Nội dung bài viết

A. Tổng quan về tích hợp plugin script của bên thứ ba và các biến trong trang xác nhận đơn hàng
B. Danh sách các trường phổ biến
C. Hướng dẫn cách thiết lập script và sử dụng các trường phổ biến
D. Sử dụng ShopBase StoreFront SDK để xem các trường

A. Tổng quan về tích hợp plugin script của bên thứ ba và các biến trong trang xác nhận đơn hàng

Trong quá trình hoạt động kinh doanh trên ShopBase, bạn có thể có nhu cầu muốn tích hợp các scripts với nền tảng của bên thứ ba để gửi email tiếp thị hoặc khảo sát cho khách hàng để lấy phản hồi. Nếu nền tảng hoặc ứng dụng của bên thứ ba mà bạn muốn kết nối không được liệt kê trong số các plugin Tiếp thị đa kênh được ShopBase hỗ trợ, bạn vẫn có thể tự tích hợp các scripts của bên thứ ba bằng cách làm theo hướng dẫn trong bài viết này.

Một số nền tảng yêu cầu các biến của những đơn hàng được khách hàng thanh toán thành công để tích hợp chính xác các scripts. Bài viết này sẽ cung cấp cho bạn danh sách các biến thông dụng của ShopBase và hướng dẫn cách sử dụng chúng.

Dưới đây là hướng dẫn về cách tích hợp script của bên thứ ba vào ShopBase để bạn tham khảo:

Tích hợp TrustPilot vào cửa hàng
Tích hợp biểu mẫu mời tham gia khảo sát Google Customer Reviews

B. Danh sách các trường phổ biến

Sau khi đơn hàng được thanh toán thành công, cửa hàng ShopBase sẽ lưu lại dữ liệu đơn hàng và thông tin khách hàng sau khi thanh toán.

Bạn có thể tra cứu các trường trong danh sách dưới đây:

Đơn hàng

NameFieldExample
Order IDorder.id1234567
Order nameorder.name#pb12345678_1234
Customer email addressorder.emailjohn.doe@gmail.com
Does customer accept marketingorder.buyer_accepts_marketingtrue
Order created dateorder.created_at2022-01-01T01:59:59+00:00
Order fulfillment statusorder.fulfillment_statusdelivered
Order discount codeorder.discount_codeSummer sale
Does order use discountorder.is_discount_has_usedtrue
Order payment method made by customerorder.payment_methodpaypal-express
Order total valueorder.totals24


Địa chỉ thanh toán

NameFieldExample
Customer’s first nameorder.billing_address.first_nameJohn
Customer's last nameorder.billing_address.last_nameDoe
Customer's full nameorder.billing_address.nameJohn Doe
Customer's phone numberorder.billing_address.phone914-989-6265
Customer’s addressorder.billing_address.address13245 Midway Road · West Harrison · Indiana
Customer’s city nameorder.billing_address.cityWest Harrison
Customer’s country nameorder.billing_address.countryUnited States
Customer’s country codeorder.billing_address.country_codeUS
Customer’s province/stateorder.billing_address.provinceIndiana
Customer’s province/state codeorder.billing_address.province_codeIN
Customer’s zip codeorder.billing_address.zip47060


Line item

NameFieldExample
Product nameorder.items.product_titleKitten Coffee Mug
Product quantityorder.items.qty2
Product imageorder.items.image"https://..."
Product price without currencyorder.items.line_item_price20
Product idorder.items.product_id123456
Product SKUorder.items.product_skuPB-AP-Kitten-Coffee-Mug-white-123456


C. Hướng dẫn cách thiết lập script và sử dụng các trường phổ biến

Để đảm bảo rằng các trường của ShopBase Storefront được lấy khi người mua vừa hoàn thành sự kiện thanh toán, đoạn script tích hợp từ plugin của bên thứ 3 cần được chèn sau dòng //Your 3rd party code paste in here trong đoạn code dưới đây:

<script>
window.sbsdk.ready(function() {
    window.sbsdk.page.onContextUpdate(function(context) {
        if (context.type === 'post_checkout') {
            const order = window.sbsdk.checkout.getOrder();
               //Your 3rd party code paste in here

        }
    });
});
</script>

Ví dụ: Để áp dụng các trường lấy từ Storefront SDK cho các biến của plugin biểu mẫu mời đánh giá khảo sát Google Customer Review, vui lòng làm theo các bước dưới đây:

Xác định script của bên thứ ba để tích hợp. Dưới đây là script từ biểu mẫu mời đánh giá khảo sát với các biến từ Google Customer Review.

<script src="https://apis.google.com/js/platform.js?onload=renderOptIn" async defer></script>

<script>
 window.renderOptIn = function() {
   window.gapi.load('surveyoptin', function() {
     window.gapi.surveyoptin.render(
       {
         // REQUIRED FIELDS
         "merchant_id": 117246064,
         "order_id": "ORDER_ID",
         "email": "CUSTOMER_EMAIL",
         "delivery_country": "COUNTRY_CODE",
         "estimated_delivery_date": "YYYY-MM-DD",
 
         // OPTIONAL FIELDS
         "products": [{"gtin":"GTIN1"}, {"gtin":"GTIN2"}]
       });
   });
 }
</script>

Thiết lập đoạn script của bên thứ ba mà bạn cần thay thế các biến vào đoạn script của ShopBase Storefront SDK.

<script src="https://apis.google.com/js/platform.js?onload=renderOptIn" async defer>
</script>

<script>
window.sbsdk.ready(function() {
    window.sbsdk.page.onContextUpdate(function(context) {
        if (context.type === 'post_checkout') {
            const order = window.sbsdk.checkout.getOrder();
               window.renderOptIn = function() {
                window.gapi.load('surveyoptin', function() {
                    window.gapi.surveyoptin.render({
                        // REQUIRED FIELDS
                        "merchant_id": "MERCHANT_ID",
                        "order_id": "ORDER_ID",
                        "email": "CUSTOMER_EMAIL",
                        "delivery_country": "COUNTRY_CODE",
                        "estimated_delivery_date": "YYYY-MM-DD",

                        // OPTIONAL FIELDS
                        "products": [{"gtin":"GTIN1"}, {"gtin":"GTIN2"}]
                    });
                });
            }
        }
    });
});
</script>

Xác định các biến cần thay thế, tham khảo phần B để biết danh sách các trường phổ biến.

<script src="https://apis.google.com/js/platform.js?onload=renderOptIn" async defer>
</script>

<script>
window.sbsdk.ready(function() {
    window.sbsdk.page.onContextUpdate(function(context) {
        if (context.type === 'post_checkout') {
            const order = window.sbsdk.checkout.getOrder();
            
            window.renderOptIn = function() {
                window.gapi.load('surveyoptin', function() {
                    window.gapi.surveyoptin.render({
                        // REQUIRED
                        "merchant_id": "MERCHANT_ID",
                        "order_id": order.id,
                        "email": order.email,
                        "delivery_country": order.shipping_address.country_code,
                        "estimated_delivery_date": order.created_at + 14,
                    });
                });
            }
        }
    });
});
</script>

Tại đây, các biến bạn cần áp dụng là:
merchant_id: ID người bán trên Google của bạn.
order_id: order.id
email: order.email
delivery_country: order.shipping_address.country_code
estimated_delivery_date: order.created_at + (số ngày khách hàng nhận hàng dự tính theo chính sách giao hàng của bạn)
products: Vui lòng bỏ qua phần này vì ShopBase chưa hỗ trợ người dùng lấy dữ liệu liên quan đến GTIN.

Tại trang quản trị ShopBase, đi tới Online store > Preferences.


Dán đoạn script trên vào mục Additional scripts, Body.


Nhấp vào Save để hoàn tất quá trình tích hợp.

Tham khảo thêm: Tích hợp biểu mẫu mời tham gia khảo sát Google Customer Reviews

D. Sử dụng ShopBase StoreFront SDK để xem các trường

Nếu bạn muốn xem các trường đơn hàng của ShopBase, vui lòng làm theo hướng dẫn bên dưới:

Truy cập vào Storefront SDK của ShopBase và đi tới mục Get content > Get order. Sao chép đoạn code trong mục Get order.


Đi tới trang Order confirmation hoặc Thank you của một đơn hàng đã hoàn tất thanh toán. Vui lòng tham khảo bài viết này về cách bạn có thể xem trang trạng thái đơn hàng.



Kiểm tra phần tử web bằng cách nhấn F12 trên bàn phím của bạn hoặc nhấp chuột phải vào trang, sau đó chọn Inspect.


Trong tab Console, dán đoạn code với chức năng Get order trên trang ShopBase Storefront SDK và nhấn Enter.


Bây giờ bạn có thể xem các trường của cửa hàng ShopBase.



Bài viết liên quan

Tổng quan về mục Preferences
Thêm Power Up Scripts để tối ưu hóa cửa hàng của bạn
Tích hợp TrustPilot vào cửa hàng
Tích hợp biểu mẫu mời tham gia khảo sát Google Customer Reviews
Bài viết có hữu ích không?
Hủy bỏ
Cảm ơn!