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

🚧

โฆษณาผลิตภัณฑ์เท่านั้น

ขณะนี้ความสามารถนี้รองรับเฉพาะโฆษณาผลิตภัณฑ์ของ CitrusAd เท่านั้น

วิธีใช้การแบ่งหน้าในเว็บไซต์ของคุณ

เมื่อสร้างโฆษณาผลิตภัณฑ์ ในการตอบกลับ คุณจะได้รับ memoryToken.

{
    "ads": [
        {
            "id": "display_3rGiryPskhQusmsf43nghbQwnqo3NzMzNjU3",
            "gtin": "7733657",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400917769Z",
            "position": 1
        }
    ],
    "banners": [],
    "products": [],
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}

เมื่อลูกค้านำทางไปยังหน้าถัดไป คุณควรส่งโทเค็นนี้ในคำขอโฆษณาครั้งต่อไปของคุณ

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

การใช้โทเค็นนี้ CitrusAd จะยกเว้นโฆษณาที่แสดงก่อนหน้านี้ให้กับลูกค้า หาก sessionId เหมือนกับคำขอของโทเค็น

🚧

การผสานรวมมาตรฐาน

ขณะนี้ความสามารถนี้รองรับเฉพาะโฆษณาผลิตภัณฑ์ของ CitrusAd เท่านั้น

ลักษณะการทำงาน

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

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

โทเค็นหน่วยความจำมีข้อมูลเข้ารหัสที่ช่วยให้ CitrusAd สามารถกำหนดโฆษณาที่ได้รับการแสดงก่อนหน้านี้ (ทั้งในคำขอเดียวหรือในช่วงระยะเวลาของคำขอที่เชื่อมโยงกันหลายรายการ)

ในกรณีที่มีการส่งโทเค็นที่ไม่เกี่ยวข้องไปยัง CitrusAd (เช่น บริบทอื่น) โฆษณาจะได้รับการปรับใหม่เสมือนว่าไม่มีการระบุโทเค็นในคำขอโฆษณา

⚠

️ คุณขอโฆษณามากกว่าที่แสดงบนเว็บไซต์ของคุณหรือไม่

หากคุณเป็นผู้ค้าปลีกที่ขอโฆษณาจาก CitrusAd มากกว่าที่แสดงต่อลูกค้าของคุณ คุณอาจไม่ได้รับโฆษณาจำนวนมากในหน้าถัดไป หากคุณขอโฆษณา 15 รายการและให้บริการเพียง 4 รายการแก่ลูกค้าของคุณ เมื่อได้รับ memoryTokenCitrusAd จะไม่รวมโฆษณาทั้งหมด 15-20 รายการที่เคยแสดงให้คุณในการตอบกลับโฆษณาที่ตามมา

ตัวอย่างโฟลว์คําขอ

คำถามที่พบบ่อย

ฉันสามารถใช้โทเค็นนี้ในการค้นหาลูกค้าหลายรายการเพื่อยกเว้นผลิตภัณฑ์ในเส้นทางการซื้อของลูกค้าที่ใหญ่ขึ้นได้หรือไม่

ไม่ หาก CitrusAd ได้รับคำขอโฆษณาที่ไม่ตรงกับคำขอโฆษณาของโทเค็น คำขอนั้นจะถูกละเว้นและโฆษณาจะถูกสร้างขึ้นราวกับว่าไม่มีโทเค็นให้

จะเกิดอะไรขึ้นหากฉันส่ง memoryToken ที่มีรูปแบบไม่ถูกต้อง

CitrusAd จะละเว้นโทเค็นและประมวลผลคำขอราวกับว่าเป็นคำขอที่ปกติ

ฉันสามารถแบ่งหน้าได้กี่หน้า

โดยค่าเริ่มต้น ค่านี้คือ 5 ซึ่งเป็นค่าสมดุลระหว่างประสิทธิภาพและความอิ่มตัวที่ดีที่สุดที่ CitrusAd เคยพบในไคลเอ็นต์หลายเครื่อง

ใน CitrusAd รุ่น 39.0 สามารถกำหนดค่าผ่านผู้จัดการบัญชีด้านเทคนิคของคุณ

จะเกิดอะไรขึ้นเมื่อโฆษณาที่จะแสดงของคุณหมด เช่น หน้า 5-10 ในการกำหนดค่าเริ่มต้น

memoryToken ได้รับการกำหนดค่าที่ฝั่ง CitrusAd เพื่อจัดเก็บโฆษณาจากจำนวนหน้าในการกำหนดค่า ตัวอย่างเช่น หากการกำหนดค่าเป็นค่าเริ่มต้นของหน้า 5 หน้า CitrusAd จะเริ่มแสดงโฆษณาซ้ำตั้งแต่หน้าที่ 7

คำขอแบ่งหน้า 6 (หน้า 6): memoryToken มีข้อมูลเกี่ยวกับโฆษณาของหน้า 5 หน้าที่แล้ว ดังนั้นจะไม่มีการแสดงโฆษณาจากหน้า 5 หน้าที่แล้ว

คำขอเลขหน้า 7 (หน้า 7): โฆษณาจากหน้า 1 มีสิทธิ์แสดง

จะเกิดอะไรขึ้นหากโฆษณาของฉันหมดก่อนหน้า 5 ในการกำหนดค่าเริ่มต้น

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