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

หลักปฏิบัติที่ดีที่สุด - API คอนเวอร์ชั่น

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

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

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

การนำไปใช้งาน

ระหว่างตั้งค่าแคมเปญ ให้ลดความซับซ้อนของโครงสร้างบัญชีและใช้หลักปฏิบัติที่ดีที่สุดสำหรับแคมเปญที่กำหนดไว้ดังนี้:

ตั้งค่าเหตุการณ์ซ้ำซ้อน

เราขอแนะนำให้คุณใช้ API คอนเวอร์ชั่นด้วย นอกเหนือจากพิกเซลของ Meta และแชร์เหตุการณ์เดียวกันนั้นโดยใช้ทั้งสองเครื่องมือ โดยเราเรียกขั้นตอนนี้ว่าการตั้งค่าเหตุการณ์ซ้ำซ้อน ตัวอย่างเช่น หากคุณแชร์เหตุการณ์ Purchase, Initiate Checkout และ Contact โดยใช้พิกเซลของ Meta คุณควรแชร์เหตุการณ์เดียวกันนั้นจากเซิร์ฟเวอร์ของคุณโดยใช้ API คอนเวอร์ชั่นด้วย

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

ตรวจสอบให้แน่ใจว่าเหตุการณ์ที่ซ้ำกันสามารถลบออกได้

เมื่อส่งเหตุการณ์ซ้ำซ้อนโดยใช้พิกเซลของ Meta และ API คอนเวอร์ชั่น ให้ตรวจสอบว่าทั้ง 2 เหตุการณ์ใช้ event_name เดียวกัน และมี event_id หรือชุด external_id กับ fbp รวมอยู่ด้วย เราขอแนะนำให้รวมพารามิเตอร์ทั้งหมดเหล่านี้ไว้ด้วย เพื่อช่วยให้ Meta ลบเหตุการณ์ที่ซ้ำกันออกได้อย่างเหมาะสม และลดการรายงานเหตุการณ์ที่เหมือนกันซ้ำ 2 ครั้ง เรียนรู้เพิ่มเติมเกี่ยวกับการลบเหตุการณ์ซ้ำซ้อนเมื่อจำเป็น และวิธีตั้งค่า

ส่งพารามิเตอร์ที่จำเป็นและพารามิเตอร์แนะนำ

จำเป็นต้องมีพารามิเตอร์เหตุการณ์บนเซิร์ฟเวอร์และข้อมูลลูกค้า ดังนี้

พารามิเตอร์ประเภทเมื่อจำเป็น

action_source

เหตุการณ์บนเซิร์ฟเวอร์

ทุกเหตุการณ์

event_source_url

เหตุการณ์บนเซิร์ฟเวอร์

ทุกเหตุการณ์บนเว็บไซต์

client_user_agent

ข้อมูลลูกค้า

ทุกเหตุการณ์บนเว็บไซต์

การใช้ API คอนเวอร์ชั่นแสดงว่าคุณยอมรับว่าพารามิเตอร์ action_source นั้นถูกต้องตามขอบเขตความเข้าใจของคุณ นอกจากนี้ เรายังขอแนะนำให้ใส่พารามิเตอร์เหตุการณ์ external_id และ event_id ไว้สำหรับทุกเหตุการณ์ด้วย

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

  • ที่อยู่อีเมล (em)
  • ที่อยู่ IP (client_ip_address)
  • ชื่อ (fn และ ln)
  • หมายเลขโทรศัพท์ (ph)

ข้อกำหนดพื้นฐานสำหรับการจับคู่

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

เหตุการณ์หนึ่งจะถือว่าใช้ไม่ได้ หากพารามิเตอร์ข้อมูลลูกค้ามีเพียงหนึ่งในชุดพารามิเตอร์ต่อไปนี้ (หรือชุดย่อยของพารามิเตอร์ดังกล่าว)

  • ct + country + st + zp + ge + client_user_agent
  • db + client_user_agent
  • fn + ge
  • ln + ge

ตัวอย่างเช่น หากเหตุการณ์มีเพียงพารามิเตอร์ข้อมูลลูกค้า gectst และ country (ซึ่งอาจตรงกับชายคนหนึ่งในเมนโลพาร์ก รัฐแคลิฟอร์เนีย สหรัฐอเมริกา) เหตุการณ์นั้นอาจถูกปฏิเสธได้ เนื่องจากพารามิเตอร์ข้อมูลลูกค้าเหล่านี้เป็นชุดย่อยของชุดพารามิเตอร์ข้างต้นชุดใดชุดหนึ่ง

ตรวจสอบให้แน่ใจว่าได้รีเฟรชพารามิเตอร์ fbp และ fbc แล้ว

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

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

แชร์เหตุการณ์ให้ใกล้เคียงเวลาจริงมากขึ้น

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

ใช้เหตุการณ์ทดสอบ

เราขอแนะนำให้ใช้เครื่องมือเหตุการณ์ทดสอบเพื่อตรวจสอบความถูกต้องของการเชื่อมต่อ API คอนเวอร์ชั่นของคุณ โดยทั่วไปแล้ว ผู้พัฒนาควรใช้พารามิเตอร์ข้อมูลลูกค้าของตนเอง (เช่น ชื่อ อีเมล หมายเลขโทรศัพท์) สำหรับเหตุการณ์ทดสอบ เนื่องจากเหตุการณ์เหล่านี้อาจถูกละทิ้งได้หากไม่ตรงกับบัญชี Facebook หรือ Meta

คุณสามารถใช้เครื่องมือเหตุการณ์ทดสอบเพื่อดำเนินการต่อไปนี้ได้

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

เรียนรู้วิธีทดสอบเหตุการณ์บนเซิร์ฟเวอร์ของคุณโดยใช้เครื่องมือเหตุการณ์ทดสอบ

ใช้ตัวช่วยเพย์โหลด

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

ใช้ SDK ธุรกิจของเรา

ตัวอย่างโค้ดในเอกสารประกอบของเราประกอบด้วยตัวอย่าง SDK ธุรกิจในภาษา Python, Java, Ruby, PHP และโหนด ซึ่งช่วยลดกระบวนการพัฒนาบางอย่างได้ เช่น การแฮชพารามิเตอร์ผู้ใช้ที่จะดำเนินโดยอัตโนมัติใน SDK ธุรกิจ

หากคุณไม่ได้วางแผนที่จะใช้ SDK ธุรกิจ เราขอแนะนำให้คุณใช้การแฮช

ใช้ API คอนเวอร์ชั่นสำหรับเหตุการณ์แบบออฟไลน์

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

เมื่อส่งเหตุการณ์แบบออฟไลน์ ต้องรวมพารามิเตอร์เหตุการณ์ action_source ด้วย พร้อมทั้งเลือกค่าที่เหมาะสม (ไม่ควรเป็น website) อีกทั้งต้องมีแหล่งที่มาของการดำเนินการเพื่อกำหนดวัตถุประสงค์แคมเปญสำหรับเหตุการณ์ที่ต้องการ

การใช้ API คอนเวอร์ชั่นแสดงว่าคุณยอมรับว่าพารามิเตอร์ action_source นั้นถูกต้องตามขอบเขตความเข้าใจของคุณ

หลักปฏิบัติที่ดีที่สุดเพิ่มเติมสำหรับพาร์ทเนอร์

เอเจนซี่: ส่ง partner_agent สตริง

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

แพลตฟอร์มเว็บไซต์: การเริ่มต้นใช้งานผู้ลงโฆษณา

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

หลังการนำไปใช้งาน

ตรวจสอบคุณภาพการจับคู่เหตุการณ์

หากคุณแชร์เหตุการณ์บนเซิร์ฟเวอร์โดยใช้ API คอนเวอร์ชั่น คุณจะเห็นคุณภาพการจับคู่เหตุการณ์ (Event Match Quality หรือ EMQ) สำหรับแต่ละเหตุการณ์ในตัวจัดการเหตุการณ์ คะแนน EMQ ของเหตุการณ์ (เต็ม 10) จะบ่งชี้ว่าข้อมูลลูกค้าของเหตุการณ์บนเซิร์ฟเวอร์อาจมีประสิทธิภาพเพียงใดในการจับคู่กับบัญชี Facebook หรือ Meta เรียนรู้เพิ่มเติมเกี่ยวกับหลักปฏิบัติที่ดีที่สุดของ EMQ ที่นี่

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

ดำเนินการทดสอบ

เมื่อใช้ API คอนเวอร์ชั่น เราขอแนะนำให้คุณทดสอบและปรับกลยุทธ์การโฆษณาบน Meta ของคุณให้เหมาะสม ตัวเลือกการทดสอบบางส่วนมีดังนี้

เรียนรู้เพิ่มเติม