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

ในกรณีที่ผู้ค้าปลีกไม่สามารถสนับสนุนสิ่งนี้ CitrusAd เสนอความสามารถในการแคชที่ช่วยให้ผู้ค้าปลีกสามารถแสดงโฆษณาให้กับลูกค้าหลายรายซ้ำหลายครั้ง

🚧

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

ข้อกําหนดการผสานการทํางาน

sessionId ไม่จำเป็นในคำขอโฆษณาอีกต่อไป เนื่องจากสามารถแสดงโฆษณาได้หลายเซสชัน

ผู้ค้าปลีกรายใดที่ต้องการแคชโฆษณาต้อง:

• ส่งพารามิเตอร์ใหม่ในคำขอโฆษณาไปยัง CitrusAd ของ “cached”: true ในส่วนตัวเลือก

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "options": {
                         "filterMode": "AndOr",
                         "cached": true
                             },
    "maxNumberOfAds": 3    
}

• ผสานรวมกับ sessionId วิธีการระบุแหล่งที่มาเมื่อรายงานคำสั่งซื้อ
• กําลังส่ง sessionId เข้ารหัสในรายงานการแสดงผลและการคลิก
• ส่งการประทับเวลาของเหตุการณ์ในรายงานการแสดงผลและการคลิก เขตเวลาระหว่างเหตุการณ์ควรสอดคล้องกัน แต่เขตเวลาใดที่ใช้ขึ้นอยู่กับผู้ค้าปลีก จัดรูปแบบในรูปแบบ ISO-8601

https://integration.<ENV>.citrusad.com/v1/resource/second-c/<AD_ID>?sessionId=<SESSION_ID>&event_ts=20220127152500

เมื่อดำเนินการอยู่ การประมวลผลที่เกี่ยวข้องในฝั่ง CitrusAd จะเกิดขึ้น CitrusAd ไม่ได้กำหนดให้ต้องมีการกำหนดค่าเพิ่มเติม

การแคชทํางานอย่างไร

สำหรับโฆษณาที่แคชไว้ จะมีคุณสมบัติที่กำหนดค่าได้ชื่อว่า "หน้าต่าง" หน้าต่างนี้ใช้กับโฆษณาทุกประเภท นอกจากนี้ยังมีคุณสมบัติ "หมดอายุ" ผ่านไปแล้วในการตอบสนองโดย CitrusAd
เราใช้คุณสมบัติเหล่านี้เพื่อกําหนดวิธีที่เราปฏิบัติต่อการแสดงผลและการคลิก ในบางกรณี CitrusAd จะสร้าง AdId ใหม่และประมวลผลการแสดงผล/การคลิกตามลำดับ
นี่คือวิธีที่ CitrusAd ช่วยให้มั่นใจว่าการระบุแหล่งที่มาจะทำงานได้อย่างสมบูรณ์ในเซสชันลูกค้าหลายรายการ

สถานการณ์สมมติที่ 1

สำหรับโฆษณาใดๆ สำหรับ sessionId เดียวกันภายใน "หน้าต่าง" จะถือว่าเป็น adId เดียวกัน

สถานการณ์สมมติที่ 2

สำหรับโฆษณาใดๆ ที่มี sessionId ต่างกัน เราจะสร้าง AdId ใหม่และประมวลผลเป็นการแสดงผล/การคลิกใหม่

สถานการณ์สมมติที่ 3

การแสดงผล/การคลิกใดๆ นอกเวลาหมดอายุของโฆษณาจะถูกบันทึกไว้แต่จะไม่ถูกเรียกเก็บเงินหรือรายงาน

สถานการณ์สมมติที่ 4

การคลิกใดๆ ที่เกิดขึ้นในหน้าต่างที่ไม่มีรายงานการแสดงผล CitrusAd จะอนุมานถึงการคลิก ซึ่งเป็นพฤติกรรมของทั้งระบบในปัจจุบัน

ซึ่งบรรเทาได้ด้วยการเพิ่มหน้าต่าง และการที่ผู้ค้าปลีกลดแคชลง

คาดว่าแต่ละสถานการณ์เกิดขึ้นอย่างอิสระในการผลิต หากโฆษณาแสดงต่อลูกค้าหลายราย

🚧

ความเสี่ยงที่มากเกินไป

คุณลักษณะนี้ช่วยให้ผู้ค้าปลีกสามารถแสดงโฆษณาให้กับลูกค้าหลายรายหลายครั้งโดยไม่ต้องขอโฆษณาจาก CitrusAd

คุณลักษณะนี้ไม่ได้ดำเนินการเปลี่ยนแปลงใดๆ กับวิธีการเปลี่ยนแปลงแคมเปญ/กระเป๋าเงิน ยิ่งโฆษณาถูกแคชนานเท่าใด โอกาสในการแสดงโฆษณาสำหรับแคมเปญหรือกระเป๋าเงินก็จะยิ่งสูงขึ้นเท่านั้น

CitrusAd จะยังคงดำเนินการและค่าใช้จ่ายสำหรับการแสดงผล/การคลิกสำหรับแคมเปญ/กระเป๋าเงินที่มาจากเงินที่มีอยู่สำหรับการโฆษณาปรากฏเมื่อกระเป๋าเงินมีเงิน

มีสามวิธีในการบรรเทาการใช้จ่ายเกินในสถานการณ์เหล่านี้

• ลดการแคชให้เหลือน้อยที่สุดเท่าที่จะเป็นไปได้ (ควรทำ)
  ยิ่งโฆษณาสามารถแสดงโฆษณาได้นานขึ้นเท่าใด ความเสี่ยงในการแสดงโฆษณาที่มาจากแคมเปญ/กระเป๋าเงินที่หมดลงตั้งแต่นั้นมาก็จะยิ่งมากขึ้นเท่านั้น

• CitrusAd ลด “หมดอายุ” ของโฆษณาทั้งหมด
  CitrusAd สามารถลดระยะเวลาที่โฆษณาถือว่า "ใช้ได้" หลังจากแสดงผล การแสดงผล/การคลิกใดๆ หลังจากหมดอายุนี้จะถือเป็นโมฆะ

• CitrusAd ขยาย “หน้าต่าง” ของโฆษณาทั้งหมด
  หน้าต่างที่ใหญ่ขึ้นจะลดปริมาณการแสดงผล/การคลิกใหม่ อย่างไรก็ตาม การกระทำนี้จะลดจำนวนการแสดงผล/การคลิกที่รายงาน