เหตุการณ์ในแอพสำหรับเกมบน Facebook

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

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

ข้อกำหนดเบื้องต้น

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

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

เกมบน Facebook ของคุณควรมี Facebook SDK สำหรับ JavaScript อยู่แล้ว หากไม่มี โปรดอ่านคู่มือการเริ่มต้นใช้งานอย่างง่ายสำหรับ JavaScript ของเรา

คุณสามารถดูเหตุการณ์ที่ลงบันทึกไว้ได้โดยใช้ตัวจัดการเหตุการณ์บน Facebook

การลงบันทึกเหตุการณ์อัตโนมัติ

เราจะลงบันทึกเหตุการณ์ต่อไปนี้สำหรับเกมบน Facebook โดยอัตโนมัติ

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

หากคุณเปิดใช้งานการชำระเงินผ่าน Facebook แล้ว เหตุการณ์เพิ่มเติมต่อไปนี้จะได้รับการลงบันทึก

• การเริ่มขั้นตอนการชำระเงิน: ผู้ใช้เริ่มกระบวนการชำระเงินเพื่อทำการซื้อ
• ซื้อแล้ว: ผู้ใช้ดำเนินการชำระเงินในแอพของคุณสำเร็จ
• ยกเลิกการซื้อแล้ว: ผู้ใช้ยกเลิกการชำระเงินของตน (รวมทั้งการชำระเงินที่ยกเลิกด้วยตนเองและเมื่อวิธีการชำระเงินล้มเหลว)

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

คุณสามารถดูเหตุการณ์ที่ลงบันทึกไว้ได้โดยใช้ตัวจัดการเหตุการณ์บน Facebook

ลงบันทึกเหตุการณ์ด้วยพารามิเตอร์

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

ด้านล่างนี้คือตัวอย่างของวิธีการที่สามารถใช้ลงบันทึกเหตุการณ์พร้อมกับพารามิเตอร์ที่อธิบายเหตุการณ์ของคุณ

var params = {};
params[FB.AppEvents.ParameterNames.LEVEL] = '12'; //player level
FB.AppEvents.logEvent(
  FB.AppEvents.EventNames.ACHIEVED_LEVEL,
  null,  // numeric value for this event - in this case, none
  params
);

เราขอแนะนำให้ใช้เหตุการณ์ที่กำหนดไว้ให้แล้วอย่างใดอย่างหนึ่ง อย่างไรก็ตาม เรายังสนับสนุนให้ลงบันทึกเหตุการณ์ที่กำหนดเองด้วย

ลงบันทึกการซื้อ

Facebook SDK จะมีฟังก์ชั่นเฉพาะสำหรับการลงบันทึกการซื้อ ซึ่งต้องเป็นไปตามข้อมูลจำเพาะของสกุลเงิน

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

var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = 'QW-12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

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

var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = '12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

เหตุการณ์ในแอพที่กำหนดเอง

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

FB.AppEvents.logEvent('battledAnOrc');

ชื่อเหตุการณ์ที่กำหนดเองมีความยาวได้สูงสุด 40 อักขระ และควรมีเฉพาะตัวอักษรและตัวเลข เครื่องหมายขีดล่าง หรือเครื่องหมายขีดเท่านั้น

การตรวจจับข้อยกเว้น

หากคุณเรียกใช้ฟังก์ชั่น SDK JavaScript ที่ระบุไว้ซึ่งมีพารามิเตอร์ที่ไม่ถูกต้อง ฟังก์ชั่นจะแสดงข้อยกเว้น ให้ตรวจสอบให้แน่ใจว่าโค้ดของคุณส่งต่อพารามิเตอร์ที่ถูกต้องแล้ว และตรวจจับข้อยกเว้นใดๆ หากเกิดขึ้น

แก้ไขจุดบกพร่อง

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

js.src = "https://connect.facebook.net/en_US/sdk/debug.js";

ข้อมูลอ้างอิง

• Javascript SDK
• ข้อมูลอ้างอิงเกี่ยวกับ AppEvents.LogEvents