คุกกี้ของบุคคลที่หนึ่งเป็นข้อมูลชิ้นเล็กๆ ซึ่งถูกจัดเก็บโดยเว็บไซต์ (หรือโดเมน) ที่ผู้ใช้กำลังเยี่ยมชมอยู่ในขณะนี้ คุกกี้เหล่านี้ถูกสร้างและจัดเก็บโดยตรงโดยเว็บไซต์นั้นเองและสามารถเข้าถึงได้โดยเว็บไซต์นั้นเท่านั้น

เมื่อผู้ใช้เยี่ยมชมเว็บไซต์ คุกกี้ของบุคคลที่หนึ่งจะถูกตั้งค่าในเบราว์เซอร์ ซึ่งอาจมีข้อมูลต่างๆ เช่น รหัสประจำตัวเฉพาะของผู้ใช้หรือข้อมูลเกี่ยวกับการโต้ตอบของผู้ใช้บนเว็บไซต์ คุกกี้จะคงอยู่ตลอดหลายเซสชันและการเข้าชม ช่วยให้เว็บไซต์สามารถจดจำผู้ใช้ที่กลับมาและระบุลักษณะของการกระทำของผู้ใช้ได้เมื่อเวลาผ่านไป ID เหล่านี้อยู่ในระบบประมาณ 13 เดือน

Epsilon ใช้ประโยชน์จากคุกกี้เพื่อช่วยให้การรายงานและการระบุช่องทางต่างๆ เจาะลึกยิ่งขึ้น

ข้อกําหนดเบื้องต้น

เพื่อนำคุกกี้ของบุคคลที่หนึ่ง (FPC) ที่อ้างอิงลักษณะการกระทำจากเว็บไซต์ของคุณมาใช้ได้สำเร็จ โปรดตรวจสอบให้แน่ใจว่าคุณมีข้อมูลต่อไปนี้ก่อนที่คุณจะบูรณาการกิจกรรมในเว็บไซต์ของคุณกับคุกกี้ของบุคคลที่หนึ่งของ Epsilon:

เตรียมข้อมูลที่จำเป็น

ตรวจสอบให้แน่ใจว่าคุณมีข้อมูลลูกค้า ข้อมูลการแปลง และแท็กไซต์ Epsilon พร้อมแล้ว

ข้อมูลการแปลง: ข้อมูลการแปลงช่วยในการระบุลักษณะได้อย่างแม่นยำ เพิ่มประสิทธิภาพการกำหนดเป้าหมาย เพิ่มประสิทธิภาพการทำงาน รับรองความสอดคล้องของข้อมูล และให้ข้อมูลเชิงลึกเกี่ยวกับลูกค้าอย่างครอบคลุม
- ข้อมูลคอนเวอร์ชันของแคมเปญ: ประกอบด้วยข้อมูลคอนเวอร์ชันสำหรับช่องทางการซื้อทั้งหมด เช่น ในร้านค้า ออนไลน์ และแคตตาล็อก
- การแปลงทั้งหมด: รวมการแปลงทั้งหมดจากทั้งลูกค้าที่รู้จักและไม่รู้จัก
- ยอดขายรวมเท่านั้น: ให้เฉพาะยอดขายรวมเท่านั้น ไม่รวมการอัปเดตหรือการยกเลิกคำสั่งซื้อ
- ID คําสั่งซื้อที่สอดคล้องกัน: ตรวจสอบว่า ID คําสั่งซื้อที่ส่งในไฟล์คอนเวอร์ชันตรงกับ ID คําสั่งซื้อที่ส่งในแท็กเว็บไซต์
แท็กไซต์ Epsilon: การติดแท็กไซต์คือการฝังรหัสติดตามลงในหน้าเว็บของคุณเพื่อตั้งค่าและอ่านคุกกี้ของบุคคลที่หนึ่ง กระบวนการนี้จำเป็นอย่างยิ่งสำหรับการบันทึกการโต้ตอบของผู้ใช้และระบุลักษณะของการกระทำได้อย่างแม่นยำเมื่อเวลาผ่านไป
📘
เพื่อให้แน่ใจว่าการบูรณาการจะราบรื่น คุณจะต้องร่วมมือกับทีมวิศวกรบูรณาการของลูกค้า (CIE) และผู้จัดการโปรแกรมบูรณาการ (IPM) พวกเขาจะแนะนำคุณผ่านขั้นตอนที่จำเป็น รวมถึง
• กลยุทธ์การติดแท็ก: พัฒนากลยุทธ์เพื่อบันทึกการโต้ตอบที่เกี่ยวข้องทั้งหมดของผู้ใช้
• การนำไปใช้งาน: ฝังโค้ดติดตามลงในหน้าเว็บของคุณอย่างถูกต้อง
• การทดสอบ: ทดสอบอย่างละเอียดเพื่อให้แน่ใจว่าคุกกี้ได้รับการตั้งค่าและอ่านอย่างถูกต้อง

ระบุแอตทริบิวต์ที่ตรงกัน

ไคลเอนต์จะต้องระบุแอตทริบิวต์ที่ตรงกันในจุดข้อมูลต่อไปนี้

คำอธิบายฟิลด์	RMN Offsite - ชื่อฟีลด์ (ที่ตั้ง)	RMN Onsite - ชื่อฟีลด์ (ที่ตั้ง)
รหัสประจำตัวลูกค้า	`mk_cust_id` (ใน `mk_file_id`)	`Customer_Id` (ใน BigQuery)
รหัสการสั่งซื้อ	`order_id` (ใน `mk_file_id`)	`Retailer_Order_Id` (ใน BigQuery)
รหัสผลิตภัณฑ์	`mk_sku_id` หรือ `web_sku_id` (ใน `mk_file_id`)	`product_code` (ใน Product_catalog)
รหัสคุกกี้ของบุคคลที่หนึ่ง	`dtm_id` (ใน `raw_text_form_submission_log`)	`dtm_cookie_id` (รุ่น 2H)

ใช้คุกกี้ของบุคคลที่หนึ่ง

ส่วนนี้อธิบายขั้นตอนตามลำดับที่จำเป็นในการรวมคุกกี้บุคคลที่หนึ่งของ Epsilon (FPC) เข้ากับกิจกรรมบนเว็บไซต์ของคุณได้สำเร็จ โดยรับรองการติดตามและการระบุลักษณะได้อย่างแม่นยำ

ขั้นตอนที่ 1: ระบุและจับคุกกี้ของฝ่ายแรก

กำหนดเวลาที่จะตั้งค่า FPC ในเบราว์เซอร์ของไคลเอนต์
ค้นหาและระบุ dtm_token ค่าภายในข้อมูลคุกกี้

📘
เมื่อผู้ใช้ใหม่เข้าชมเว็บไซต์ของคุณเป็นครั้งแรก FPC จะไม่ถูกตั้งค่า เมื่อผู้ใช้ท่องภายในเว็บไซต์ของคุณเป็นครั้งแรก ค่าคุกกี้ของบุคคลที่หนึ่งจะปรากฏขึ้น คุณสามารถเริ่มใช้ dtm_token เมื่อพร้อมใช้งาน

ขั้นตอนที่ 2: ผ่าน `dtm_token` ในการเรียก API การร้องขอโฆษณาบนไซต์

รวมถึง dtm_token คุณค่าใน dtmCookieId ฟิลด์เมื่อทำการเรียก Onsite Ad Request API ซึ่งช่วยให้สามารถติดตามและระบุลักษณะการโต้ตอบของผู้ใช้ได้อย่างแม่นยำ
นอกจากนี้ ให้ผ่าน CustomerId คุณค่าใน CustomerId ฟิลด์เพื่อเชื่อมโยงคุกกี้กับลูกค้ารายใดรายหนึ่งโดยเฉพาะ เพื่อเพิ่มความแม่นยำในการติดตาม ค่า CustomerId พร้อมใช้งานเมื่อลูกค้าเข้าสู่ระบบไซต์ผู้ค้าปลีก

ตัวอย่างคำขอ
```
{
  "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.
}
```
ตัวอย่างการตอบสนอง
```
{
  "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.
}
```

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเรียก API คำขอโฆษณา โปรดดู สร้างโฆษณาผลิตภัณฑ์

📘
หากระบบของคุณใช้แคชเพื่อปรับปรุงประสิทธิภาพโดยการจัดเก็บข้อมูลหรือเนื้อหาไว้ชั่วคราว สิ่งสำคัญคือต้องรวม dtm_token ค่าในการเรียกเหตุการณ์การแสดงผลและการคลิกทั้งหมด วิธีนี้จะช่วยให้แน่ใจว่าการโต้ตอบของผู้ใช้จะถูกติดตามอย่างถูกต้อง แม้ว่าจะได้รับข้อมูลจากแคชก็ตาม

ขั้นตอนที่ 2a: จัดการการใช้งานแคช

หากคุณได้รวมฟังก์ชันแคชไว้แล้ว โปรดตรวจสอบให้แน่ใจว่าคุณกำลังส่ง dtm_token ค่าในการแสดงผลของคุณและคลิกเรียกเหตุการณ์

ตัวอย่างกิจกรรมสร้างความประทับใจ

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

ตัวอย่างเหตุการณ์คลิก

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

ขั้นตอนที่ 3: ผ่าน `dtm_token` ในการสั่งการเรียก API ในสถานที่

รวมถึง dtm_token คุณค่าใน dtmCookieId ฟิลด์เมื่อทำการโทร API คำสั่งซื้อในสถานที่ ซึ่งช่วยในการระบุลักษณะคำสั่งซื้อและการกระทำเกี่ยวกับคอนเวอร์ชันจากผู้ใช้ที่เฉพาะเจาะจงได้อย่างถูกต้อง
นอกจากนี้ ให้ผ่าน CustomerId คุณค่าใน CustomerId ฟิลด์เพื่อเชื่อมโยงข้อมูลการสั่งซื้อกับโปรไฟล์ลูกค้า ช่วยให้การรายงานและวิเคราะห์มีรายละเอียดมากขึ้น ค่า CustomerId จะพร้อมใช้งานเมื่อลูกค้าเข้าสู่ระบบเว็บไซต์ผู้ค้าปลีก

ตัวอย่างการตอบสนอง

{
    "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"
                }
              ]
            }
    ]
}

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเรียก API คำขอโฆษณา โปรดดู การซิงค์ข้อมูลคำสั่งซื้อผ่าน AP