Game trên Facebook

    Sự kiện trong ứng dụng dành cho Game trên Facebook

    API Sự kiện trong ứng dụng này của Facebook SDK (JS) đã ngừng hoạt động và không còn được hỗ trợ kể từ ngày 01/07/2022. Chúng tôi chưa có kế hoạch thêm tính năng mới vào sản phẩm này. Thay vì sử dụng FB.AppEvents.LogEvent, bạn nên gửi các sự kiện này qua Meta Pixel.

    Sự kiện trong ứng dụng cho phép bạn đo lường hiệu quả quảng cáo và tạo đối tượng để nhắm mục tiêu quảng cáo cho Game trên Facebook.

    Để thực hiện điều này, hãy gửi sự kiện từ ứng dụng của bạn qua Facebook SDK dành cho Javascript. Sự kiện này có thể là một trong các sự kiện xác định trước, chẳng hạn như "đã thêm vào giỏ hàng" trong ứng dụng thương mại hoặc "cấp độ đạt được" trong game hoặc các sự kiện tùy chỉnh khác.

    Điều kiện tiên quyết

    Trước khi thêm mã để đo lường sự kiện, bạn cần đăng ký ứng dụng của mình với Facebook. Nếu chưa đăng ký ứng dụng của mình với Facebook, bạn có thể đăng ký tại đây: Bắt đầu nhanh Game trên Facebook.

    Triển khai

    Game trên Facebook của bạn phải có sẵn Facebook SDK dành cho Javascript. Nếu không, hãy đọc hướng dẫn bắt đầu nhanh JavaScript của chúng tôi.

    Bạn có thể xem các sự kiện được ghi của mình qua Trình quản lý sự kiện trên Facebook.

    Tự động ghi sự kiện

    Chúng tôi tự động ghi các sự kiện sau đây cho Game trên Facebook:

    • Cài đặt ứng dụng: Người dùng chấp nhận điều khoản dịch vụ dành cho ứng dụng của bạn lần đầu tiên.
    • Khởi chạy ứng dụng: Bất cứ khi nào người dùng mở trang web chứa ứng dụng của bạn.

    Nếu bạn đã bật tính năng thanh toán qua Facebook - hệ thống sẽ ghi thêm các sự kiện sau đây:

    • Bắt đầu thanh toán: Người dùng bắt đầu quá trình thanh toán để mua hàng.
    • Mua hàng: Người dùng đã hoàn tất thành công khoản thanh toán trong ứng dụng của bạn.
    • Hủy mua hàng: Người dùng đã hủy thanh toán (bao gồm hủy thanh toán theo cách thủ công và khi phương thức thanh toán bị lỗi).

    Lưu ý: Sự kiện Hủy mua hàng có thể không được ghi nếu người dùng đóng cửa sổ trình duyệt của họ vào giữa quá trình mua. Đây là lý do sự kiện Hủy mua hàng có thể không bằng với hiệu số giữa sự kiện Bắt đầu thanh toán và sự kiện Mua hàng.

    Bạn có thể xem các sự kiện được ghi của mình qua Trình quản lý sự kiện trên Facebook.

    Ghi sự kiện cùng với thông số

    Bạn có thể quyết định ghi các thông tin ngoài sự kiện được ghi tự động để đo lường tốt hơn hiệu quả của ứng dụng trên Facebook.com. Ví dụ: bạn có thể muốn ghi sự kiện mỗi khi ai đó hoàn tất một cấp độ trong game của bạn.

    Dưới đây là ví dụ về cách bạn có thể ghi một sự kiện cùng với thông số mô tả sự kiện đó:

    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
);

    Bạn nên sử dụng một trong các sự kiện xác định trước. Tuy nhiên, chúng tôi cũng hỗ trợ ghi sự kiện tùy chỉnh.

    Số lượng tên sự kiện khác nhau tối đa là 1.000. Lưu ý: Không có loại sự kiện mới nào được ghi sau khi đạt đến giới hạn này và nếu vượt quá giới hạn này, bạn có thể gặp lỗi 100 Invalid parameter khi ghi. Hãy đọc thêm về giới hạn sự kiện trong phần Câu hỏi thường gặp.

    Ghi lượt mua

    Facebook SDK có một hàm riêng để ghi lượt mua. Hàm này cần có quy cách về đơn vị tiền tệ.

    Các khoản thanh toán đã thực hiện qua Game trên Facebook được tự động ghi dưới dạng sự kiện mua hàng. Bạn chỉ cần sử dụng mã sau để bán các mặt hàng thực.

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

    Để sử dụng các thông số xác định trước, hãy tạo đối tượng thông số rồi chuyển đối tượng đó vào hàm như minh họa bên dưới.

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

    Sự kiện tùy chỉnh trong ứng dụng

    Bạn cũng có thể chọn tạo sự kiện tùy chỉnh của riêng mình bằng cách chỉ định tên sự kiện dưới dạng chuỗi:

    FB.AppEvents.logEvent('battledAnOrc');

    Độ dài tối đa của tên sự kiện tùy chỉnh là 40 ký tự. Tên sự kiện tùy chỉnh chỉ được chứa ký tự chữ và số, dấu gạch dưới hoặc dấu gạch ngang.

    Nhận ngoại lệ

    Nếu bạn gọi hàm JavaScript SDK được cung cấp với thông số không đúng, hàm này sẽ trả về một ngoại lệ. Hãy đảm bảo mã của bạn chuyển đúng thông số và nhận bất kỳ ngoại lệ nào nếu xuất hiện.

    Gỡ lỗi

    Để cải thiện hiệu quả, JavaScript SDK được nén khi tải. Bạn cũng có thể tải phiên bản gỡ lỗi của JavaScript SDK bao gồm nhiều lần ghi và kiểm tra đối số nghiêm ngặt hơn cũng như không được nén. Để thực hiện điều này, hãy thay đổi giá trị js.src trong mã tải của bạn thành:

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

    Tài liệu tham khảo