adstage
Deep Link

Postback ไปยังสื่อโฆษณา

แอปรีวอร์ด สื่อบูสต์ และพาร์ทเนอร์สื่ออื่น ๆ ที่ใช้ระบบติดตามของตัวเองมักขอให้ "แจ้งไปยังปลายทางของเราเมื่อเกิดคอนเวอร์ชัน" adstage รองรับสิ่งนี้ในรูปแบบ การตั้งค่าต่อลิงก์ เพียงใส่ URL callback ที่สื่อให้มา adstage จะเรียกปลายทางนั้นเมื่อผู้ใช้ที่เข้ามาผ่านลิงก์ดังกล่าวติดตั้ง ซื้อ หรือทำอีเวนต์ที่กำหนดไว้

ไม่ต้องพัฒนาระบบเพิ่มสำหรับแต่ละสื่อ เพียงรับสเปกมากรอกในแดชบอร์ด การเชื่อมต่อก็พร้อมใช้งาน

1. ตั้งค่าได้ที่ไหน

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

2. รายการตั้งค่า

รายการคำอธิบาย
URL Postback การติดตั้งจำเป็น ปลายทางที่จะเรียกเมื่อเกิดคอนเวอร์ชันการติดตั้ง
URL Postback อีเวนต์ไม่บังคับ ปลายทางสำหรับอีเวนต์อื่นที่ไม่ใช่การติดตั้ง เช่น การซื้อ หากเว้นว่าง จะใช้ URL การติดตั้งกับทุกอีเวนต์
ชื่อพารามิเตอร์ Click IDชื่อของตัวระบุคลิกที่สื่อแนบมากับ URL คลิก ค่าเริ่มต้นคือ click_id
อีเวนต์ที่ส่ง Postbackอีเวนต์ใดบ้างที่จะส่ง postback ค่าเริ่มต้นคือ install

หากสื่อแจ้งว่า "เราส่ง click ID ผ่านพารามิเตอร์ชื่อ cb" ให้กรอก cb ในช่อง ชื่อพารามิเตอร์ Click ID

3. เทมเพลต URL และมาโคร

วาง URL ที่สื่อให้มาตามเดิม และใช้มาโครในตำแหน่งที่ต้องแทนค่า

https://postback.network.com/install?cb={click_id}&adid={adid}

มาโครที่ใช้ได้มีดังนี้

มาโครค่า
{click_id}ตัวระบุคลิกที่สื่อส่งมาตอนคลิก
{adid}ตัวระบุโฆษณา (IDFA บน iOS, GAID บน Android)
{ifa} {idfa} {gaid}ค่าเดียวกับ {adid} ใช้ชื่อตามที่ปรากฏในสเปกของสื่อได้เลย
{device_id}ตัวระบุอุปกรณ์ที่ adstage กำหนด
{platform}ios หรือ android
{event}ชื่ออีเวนต์ (เช่น install, purchase)
{timestamp}เวลาที่เกิดอีเวนต์
{ip}IP ของผู้ใช้
{campaign}ชื่อแคมเปญ

มาโครที่ไม่อยู่ในรายการ

หากสื่อต้องการค่าเฉพาะของตนเอง เช่น {sub_id} หรือ {pub_id} ให้ใช้ได้ตามนั้น มาโครที่ไม่อยู่ในรายการจะ สะท้อนค่าพารามิเตอร์ชื่อเดียวกันจาก URL คลิก กลับไป

กล่าวคือ หากสื่อแนบ ?sub_id=abc123 มากับ URL คลิก ตำแหน่ง {sub_id} ใน postback จะถูกเติมด้วย abc123

โปรดทราบ

หากไม่มีพารามิเตอร์นั้นตอนคลิก ระบบจะส่งค่าว่างไป ควรตรวจสอบว่าพารามิเตอร์ในสเปกของสื่อถูกแนบมากับ URL คลิกจริง

4. หลักการทำงาน

  1. ผู้ใช้คลิกโฆษณาของสื่อและเข้าสู่ลิงก์ติดตามของ adstage ในขั้นตอนนี้ click ID และพารามิเตอร์ของสื่อจะถูกบันทึกไว้

  2. เมื่อผู้ใช้รายนั้นติดตั้งหรือทำอีเวนต์ที่ตั้งค่าไว้ adstage จะระบุที่มากลับไปยังคลิกของสื่อ

  3. มาโครในเทมเพลต URL จะถูกแทนที่ด้วยค่าจริง แล้วเรียกปลายทางของสื่อ

การป้องกันการส่งซ้ำ

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

ชื่ออีเวนต์ที่มีความหมายเดียวกัน เช่น install และ first_open จะถูกรวมเป็นหนึ่ง จึงยิง postback เพียงครั้งเดียวแม้ได้รับทั้งสองอย่าง

การลองใหม่เมื่อล้มเหลว

หากเซิร์ฟเวอร์ของสื่อไม่ตอบสนองชั่วคราว adstage จะลองส่งใหม่อัตโนมัติเพื่อไม่ให้คอนเวอร์ชันสูญหายอย่างเงียบ ๆ

รายการค่า
จำนวนครั้งที่ลองใหม่สูงสุด 8 ครั้ง (ส่งครั้งแรก 1 + ลองใหม่ 8)
ระยะห่างขั้นต่ำ3 นาที
รอบตรวจสอบตรวจรายการที่ล้มเหลวทุก 5 นาที
เกณฑ์ยกเลิกรายการที่ล้มเหลวและเก่ากว่า 24 ชั่วโมง

5. สิ่งที่ควรสอบถามสื่อก่อนเชื่อมต่อ

คุณต้องการข้อมูลจากพาร์ทเนอร์สื่อรายใหม่เพียงสี่อย่าง

  1. URL Postback — สำหรับการติดตั้ง และแยกสำหรับอีเวนต์หากมี
  2. ชื่อพารามิเตอร์ Click ID — ชื่อตัวระบุที่แนบมากับ URL คลิก
  3. รายการมาโครที่ต้องการ — ต้องการรับค่าใดบ้าง
  4. อีเวนต์เป้าหมาย — เฉพาะการติดตั้ง หรือรวมอีเวนต์อื่น เช่น การซื้อ

6. ข้อควรระวัง

  • การตั้งค่า postback เป็นแบบต่อลิงก์ หากสื่อหนึ่งใช้หลายลิงก์ ต้องตั้งค่าทุกลิงก์
  • postback จะยิงเมื่อการระบุที่มาสำเร็จเท่านั้น ทราฟฟิกที่ไม่ผ่านลิงก์ของสื่อจะไม่เข้าเงื่อนไข
  • ค่าต่าง ๆ จะถูกเข้ารหัส URL อัตโนมัติ ไม่ต้องเข้ารหัสค่าล่วงหน้าในตำแหน่งมาโคร
  • สื่อบางรายแจ้งผลสำเร็จหรือล้มเหลวในเนื้อหาการตอบกลับ แต่ adstage ตัดสินจาก HTTP status code เท่านั้น โดยถือว่า 2xx และ 3xx คือสำเร็จ หากสื่อตอบ 200 พร้อมข้อผิดพลาดในเนื้อหา adstage จะไม่ทราบว่าล้มเหลว จึงควรขอให้ตอบ 4xx หรือ 5xx เมื่อเกิดข้อผิดพลาด

สารบัญ