API คอนเวอร์ชัน

1. ทำไมต้องฝั่งเซิร์ฟเวอร์

พิกเซลเบราว์เซอร์ต้องผ่านสามอย่างก่อนรายงานคอนเวอร์ชัน: ตัวบล็อกโฆษณา การป้องกันติดตาม และการปิดแท็บก่อนพิกเซลทำงาน คำขอฝั่งเซิร์ฟเวอร์ผ่านทั้งหมดได้เพราะไม่ได้เกิดในเบราว์เซอร์เลย

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

2. สิ่งที่ส่งและไม่ส่งเด็ดขาด

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

เครือข่าย	ตัวระบุที่ใช้	แหล่งที่มา
Meta	_fbp, _fbc	คุกกี้บุคคลที่หนึ่งจากพิกเซล Meta
LinkedIn	li_fat_id	คุกกี้บุคคลที่หนึ่งจาก LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp เป็นคุกกี้ ส่วน ttclid มาจาก URL คลิกโฆษณา
Google Ads	gclid, wbraid, gbraid	จาก URL คลิกโฆษณา หรือคุกกี้ _gcl_aw ภายหลัง
Microsoft Advertising	msclkid	จาก URL คลิกโฆษณา หรือคุกกี้ _uetmsclkid ที่แท็ก UET เขียน

เฉพาะเมื่อยินยอม

ทุกคำขออยู่หลังเงื่อนไขยินยอมเดียวกับการบันทึก เซสชันไม่ยินยอมไม่สร้างรายงานคอนเวอร์ชัน ไม่ว่าสวิตช์โปรเจกต์ตั้งอย่างไร

3. Google Ads มีสามตัวระบุ ไม่ใช่หนึ่ง

เรื่องนี้มักทำให้แปลกใจ จึงควรระบุชัด Google ใช้ gclid สำหรับคลิกโฆษณาเดียว เมื่อการป้องกันติดตามของ Apple ทำให้ระบุคลิกเดี่ยวไม่ได้ Google ส่ง wbraid หรือ gbraid แทน ซึ่งหมายถึงกลุ่มคลิก

ทั้งสามใช้ร่วมกันไม่ได้ Google ปฏิเสธคอนเวอร์ชันที่มีสองค่า เราส่งค่าเดียวเสมอ และ gclid มาก่อนหากมีหลายค่า เพราะแม่นยำที่สุด

อยู่ใน URL เพียงครั้งเดียว

ตัวระบุปรากฏในที่อยู่เฉพาะหน้า แรก หลังคลิกโฆษณา จากนั้นแท็ก Google เก็บในคุกกี้ _gcl_aw เราอ่านคุกกี้เป็นทางสำรอง มิฉะนั้นคอนเวอร์ชันบนหน้าที่สามจะไม่พบตัวระบุเลย

4. ตั้งค่า

Meta, LinkedIn และ TikTok

ระบบละสองช่อง: ID พิกเซลหรือกฎคอนเวอร์ชัน และโทเค็นเข้าถึงที่สร้างในเครือข่ายนั้น ทั้งคู่เก็บเข้ารหัส AES-256-GCM และไม่แสดงอีกหลังบันทึก

Google Ads ต้องใช้หกช่อง

Google เป็นข้อยกเว้นและควรรู้ก่อนเริ่ม Google ไม่มีโทเค็นเข้าถึงอย่างง่ายเหมือนอีกสามเครือข่าย ต้องใช้ OAuth พร้อมโทเค็นรีเฟรช และ Ads API ยังต้องมี โทเค็นนักพัฒนา

ช่อง	หาได้ที่ใด
ID ลูกค้า	มุมขวาบนใน Google Ads ใช้ตัวเลขไม่มีขีดคั่น
ID การกระทำคอนเวอร์ชัน	Goals and conversions แล้วเลือกการกระทำที่จะบันทึก
โทเค็นนักพัฒนา	บัญชีผู้จัดการ Google Ads ใน API Center
ID และความลับไคลเอนต์ OAuth	Google Cloud Console, Credentials, OAuth client ประเภท "desktop app"
โทเค็นรีเฟรช	สร้างเองหนึ่งครั้งสำหรับขอบเขต adwords

LinkedIn มีสองเส้นทาง ควรใช้ทางสั้น

ใน Campaign Manager: Data, Signals Manager, Direct API, Generate access token นี่คือทางสำหรับผู้ลงโฆษณาส่งข้อมูลตนเอง ไม่ต้องมีแอปนักพัฒนาหรือการตรวจ โทเค็นไม่หมดอายุและไม่แสดงซ้ำ จึงคัดลอกทันที

อีกทางคือแอปนักพัฒนาจาก LinkedIn Developer Portal สำหรับแพลตฟอร์มที่ส่งแทนผู้ลงโฆษณาหลายราย ต้องยืนยันหน้าองค์กรและอนุมัติกรณีใช้งาน ไม่จำเป็นสำหรับที่นี่

Microsoft Advertising ง่ายที่สุด

หลัง Google Ads อาจคาดว่าต้อง OAuth โทเค็นนักพัฒนา และการอนุมัติ แต่กลับใช้เพียงสองช่อง: ID แท็ก UET เดิมในเบราว์เซอร์และโทเค็นที่คัดลอกจาก Microsoft Advertising ในแท็ก UET ส่วน "Use Conversions API", "Copy Token" ไม่ต้องยื่นขอ

ใช้ ID แท็ก เดียวกัน กับแท็กเบราว์เซอร์ เพื่อให้ Microsoft รู้ว่าเหตุการณ์ฝั่งเซิร์ฟเวอร์และเบราว์เซอร์คือคอนเวอร์ชันเดียว ไม่ใช่สอง

5. รายงานคอนเวอร์ชันเมื่อใด

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

สิ่งที่เห็นในบัญชีโฆษณา

คอนเวอร์ชันมีชื่อเป้าหมาย มูลค่าและสกุลเงินหากตั้งไว้ และเวลาที่เกิด ปกติถึงภายในหนึ่งนาที

หากไม่มีข้อมูลเข้ามา

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