Cookie của bên thứ nhất là những phần dữ liệu nhỏ được lưu trữ bởi trang web (hoặc tên miền) mà người dùng hiện đang truy cập. Những cookie này được tạo và lưu trữ trực tiếp bởi chính trang web và chỉ có trang web đó mới có thể truy cập.

Khi người dùng truy cập trang web, cookie của bên thứ nhất được đặt trong trình duyệt của họ, có thể chứa nhiều thông tin khác nhau như mã nhận dạng duy nhất của người dùng hoặc dữ liệu về các tương tác của người dùng trên trang web. Cookie này tồn tại trong nhiều phiên và lượt truy cập, cho phép trang web nhận ra người dùng quay trở lại và phân bổ hành động của họ theo thời gian. Những ID này có sẵn trong hệ thống trong khoảng 13 tháng.

Epsilon tận dụng cookie này để tạo điều kiện cho việc báo cáo và phân bổ đa kênh sâu hơn.

Điều kiện tiên quyết

Để triển khai thành công cookie bên thứ nhất (FPC) dựa trên các thuộc tính của trang web, bạn phải có những dữ liệu sau trước khi tích hợp các hoạt động tại chỗ của mình với Cookie của bên thứ nhất của Epsilon:

Chuẩn bị dữ liệu cần thiết

Đảm bảo bạn đã chuẩn bị sẵn dữ liệu khách hàng, dữ liệu chuyển đổi và Thẻ trang web Epsilon.

• Dữ liệu chuyển đổi: Dữ liệu chuyển đổi giúp phân bổ chính xác, tăng cường nhắm mục tiêu, tối ưu hóa hiệu suất, đảm bảo tính nhất quán của dữ liệu và cung cấp thông tin chi tiết toàn diện về khách hàng.
  • Dữ liệu chuyển đổi chiến dịch: Bao gồm dữ liệu chuyển đổi cho tất cả các kênh mua hàng như tại cửa hàng, trực tuyến và qua danh mục.
  • Tất cả chuyển đổi: Bao gồm tất cả các chuyển đổi từ cả khách hàng đã biết và chưa biết.
  • Chỉ tổng doanh số bán hàng: Chỉ cung cấp tổng doanh số bán hàng, không bao gồm cập nhật hoặc hủy đơn hàng.
  • ID đơn hàng nhất quán: Đảm bảo rằng ID đơn hàng được chuyển trong tệp chuyển đổi khớp với ID đơn hàng được chuyển trong thẻ trang web.
• Thẻ trang web Epsilon: Gắn thẻ trang web liên quan đến nhúng mã theo dõi vào các trang web của bạn để cài đặt và đọc cookie của bên thứ nhất. Quá trình này rất cần thiết để nắm bắt các tương tác của người dùng và phân bổ hành động chính xác theo thời gian.

  📘

  Để đảm bảo tích hợp liền mạch, bạn sẽ cần phải cộng tác với nhóm Kỹ sư Tích hợp Khách hàng (CIE) và Quản lý Chương trình Tích hợp (IPM). Họ sẽ hướng dẫn bạn thực hiện các bước cần thiết, bao gồm:

  • Chiến lược gắn thẻ: Phát triển chiến lược để nắm bắt tất cả các tương tác người dùng có liên quan.
  • Triển khai: Nhúng mã theo dõi chính xác vào trang web của bạn.
  • Kiểm tra: Kiểm tra kỹ lưỡng để đảm bảo cookie được thiết lập và đọc chính xác.

Cung cấp các thuộc tính phù hợp

Khách hàng phải cung cấp các thuộc tính phù hợp trên các điểm dữ liệu sau.

Triển khai Cookie của bên thứ nhất

Phần này phác thảo các bước tuần tự cần thiết để tích hợp thành công Cookie của bên thứ nhất (FPC) của Epsilon với các hoạt động tại chỗ của bạn, đảm bảo theo dõi và phân bổ chính xác.

Bước 1: Xác định và thu thập Cookie của bên thứ nhất

1. Xác định thời điểm FPC được thiết lập trong trình duyệt của máy khách.

2. Xác định vị trí và nhận dạng dtm_token giá trị trong dữ liệu cookie.

   

📘

Khi người dùng mới lần đầu truy cập trang web của bạn, FPC sẽ không được thiết lập. Khi người dùng lần đầu truy cập vào trang web của bạn, giá trị Cookie của bên thứ nhất sẽ xuất hiện. Bạn có thể bắt đầu sử dụng dtm_token khi nó có sẵn.

Bước 2: Chuyển dtm_token trong các lệnh gọi API Yêu cầu quảng cáo tại chỗ

1. Bao gồm dtm_token giá trị trong dtmCookieId trường khi thực hiện các cuộc gọi API Yêu cầu quảng cáo tại chỗ. Điều này cho phép theo dõi chính xác và phân bổ các tương tác của người dùng.

2. Ngoài ra, chuyển CustomerId giá trị trong CustomerId trường để liên kết cookie với một khách hàng cụ thể, nâng cao độ chính xác theo dõi. Giá trị CustomerId trở nên khả dụng khi khách hàng đăng nhập vào trang web của nhà bán lẻ.

   Yêu cầu mẫu

   HTTP

   {
     "sessionid": "{SESSION_ID}", // Set to value advised by your CIE.
     "customerid": "{CUSTOMER_ID}", // Set to CustomerId value when available.
     "dtmCookieId": "{DTM_TOKEN_VALUE}" // Set to dtm_token value.
   }
   
   

   Ví dụ về phản hồi

   HTTP

   {
     "sessionid": "SESSION_1", // Set to value advised by your CIE.
     "customerid": "CUSTOMER_1", // Set to CustomerId value when available.
     "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE" // Set to dtm_token value.
   }
   
   

Để biết thêm thông tin về Cuộc gọi API Yêu cầu quảng cáo, hãy xem Tạo quảng cáo sản phẩm.

📘

Nếu hệ thống của bạn sử dụng bộ nhớ đệm để cải thiện hiệu suất bằng cách lưu trữ tạm thời dữ liệu hoặc nội dung, điều cần thiết là phải bao gồm giá trị dtm_token trong tất cả các cuộc gọi sự kiện số lần hiển thị và nhấp chuột. Điều này đảm bảo rằng các tương tác của người dùng được theo dõi chính xác, ngay cả khi dữ liệu được phục vụ từ bộ nhớ đệm.

Bước 2a: Xử lý việc triển khai bộ nhớ đệm

Nếu bạn đã tích hợp chức năng bộ nhớ đệm, hãy đảm bảo rằng bạn đang gửi giá trị dtm_token trong các cuộc gọi sự kiện số lần hiển thị và nhấp chuột.

Ví dụ về Sự kiện Số lần hiển thị

GET {integration}.citrusad.com/v1/resource/first-i/display_xc0O_S0kqwqS93k972ikrrUDagUKCAoGOTI0NTcxEgIIARoMCI7ew6AGENTCytEDIgIIAQ==?sessionId=SESSION_1&customerId=CUSTOMER_1&dtmCookieId=AAAF8xLBTA968AB6TOthAAAAAAE&event_ts=20230314200515

Ví dụ về Sự kiện Nhấp chuột

GET {integration}.citrusad.com/v1/resource/second-c/display_xc0O_S0kqwqS93k972ikrrUDagUKCAoGOTI0NTcxEgIIARoMCI7ew6AGENTCytEDIgIIAQ==?sessionId=SESSION_1&customerId=CUSTOMER_1&dtmCookieId=AAAF8xLBTA968AB6TOthAAAAAAE&event_ts=20230314200515

Bước 3: Chuyển dtm_token trong cuộc gọi API đơn hàng tại chỗ

1. Bao gồm dtm_token giá trị trong dtmCookieId trường khi thực hiện cuộc gọi API Đơn hàng tại chỗ. Điều này giúp phân bổ chính xác các đơn hàng và hành động chuyển đổi cho người dùng cụ thể.
2. Ngoài ra, chuyển CustomerId giá trị trong CustomerId trường để liên kết dữ liệu đơn hàng với hồ sơ khách hàng, tạo điều kiện cho việc báo cáo và phân tích chi tiết hơn. Giá trị CustomerId trở nên khả dụng khi khách hàng đăng nhập vào trang web của nhà bán lẻ.

Ví dụ về phản hồi

{
    "orders": [
       {
        "customerId": "npc-s243-ir",
        "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
        "sessionId": "5cat7-9964-4f",
        "dtmCookieId": " AAAF8xLBTA968AB6TOthAAAAAAE"
        "orderDate": "2021-12-02T15:00:00Z",
        "id": "3h30e938-c158-4d78-a0af-b48bbwfrcss4",
        "orderItems": [
            {
                  "gtin": "9891998566P",  
                  "quantity": 3, 
                  "regularUnitPrice": 1.00,
                  "totalOrderItemPriceAfterDiscounts": 3.00,
                  "catalogId": "6adb93d0-7he4-4d4e-9b47-e5d3714c976a",
                  "citrusDiscountAmount": 0.0,
                  "substitutedFor": null,
                  "sellerId": "seller_id_601_64"
                }
              ]
            }
    ]
}

Để biết thêm thông tin về Cuộc gọi API Yêu cầu quảng cáo, hãy xem Đồng bộ hóa dữ liệu đơn hàng qua AP.