Tiện ích Meta Business

Bảng điều khiển dành cho nhà phát triển Tiện ích Meta Business

Bảng điều khiển dành cho nhà phát triển Tiện ích Meta Business là một sản phẩm có trong Bảng điều khiển ứng dụng. Phần này giải thích cách thiết lập và xác thực quá trình tích hợp Tiện ích Meta Business thông qua bảng điều khiển đó.

Truy cập vào Bảng điều khiển dành cho nhà phát triển Tiện ích Meta Business

  1. Chuyển đến Bảng điều khiển ứng dụng rồi nhấp vào tên ứng dụng mà bạn muốn đặt cấu hình để tải Bảng điều khiển ứng dụng. Hoặc nếu bạn chưa có ứng dụng, hãy tạo một ứng dụng trên Meta rồi chọn Doanh nghiệp làm loại ứng dụng.
  2. Sau khi vào Bảng điều khiển ứng dụng, hãy nhấp vào Thêm sản phẩm.
  3. Trong danh sách sản phẩm, tìm Tiện ích Meta Business (bạn có thể cần nhấp vào Xem thêm sản phẩm).
  4. Trên thẻ sản phẩm, nhấp vào Thiết lập.
    5. Hiện tại, chúng tôi đã thêm Bảng điều khiển dành cho nhà phát triển MBE vào cột bên trái của Bảng điều khiển ứng dụng. Khi điều hướng các tab, bạn sẽ thấy danh sách kiểm tra gồm các mục hành động và những bước thiết lập cần hoàn thành: hoàn thành các yêu cầu, thiết lập danh mục, chọn tính năng, v.v.
  5. Bắt đầu các bước Chuẩn bị rồi nhấp vào tab Thiết lập (có thể truy cập từ menu bên trái) để điền các thông tin còn lại.
  6. Gửi tiện ích tích hợp của bạn đi xét duyệt: Sử dụng tab Xét duyệt tiện ích tích hợp trong Bảng điều khiển dành cho nhà phát triển MBE. Sau khi tiện ích tích hợp của bạn được phê duyệt, bạn có thể truy cập vào tab Trạng thái ra mắt. Tại đây, bạn có thể ra mắt ứng dụng của mình với người dùng công khai. Hãy tìm hiểu thêm về quy trình Xét duyệt tiện ích tích hợp.

Bạn không tìm thấy Tiện ích Meta Business trên Danh sách sản phẩm?

  • Nếu bạn không tìm thấy Tiện ích Meta Business trên danh sách sản phẩm do ứng dụng của bạn yêu cầu quyền riêng tư manage_business_extension, hãy liên hệ với đối tác của Meta để thêm ứng dụng đó vào danh sách cho phép và thông báo cho bạn khi quyền này được cấp.
  • Ứng dụng của bạn phải thuộc loại ứng dụng dành cho Doanh nghiệp để có quyền truy cập vào Bảng điều khiển dành cho nhà phát triển Tiện ích Meta Business.

Tab Tổng quan

Danh sách kiểm tra trên tab Tổng quan có tất cả các mục mà bạn cần hoàn thành, xây dựng và xác thực trong quá trình tích hợp MBE thì bạn mới có thể gửi tiện ích cho đội ngũ của chúng tôi xét duyệt.

Tab này đóng vai trò là một hướng dẫn dễ thực hiện để đảm bảo bạn không bỏ sót bước bắt buộc nào. Các mục trong danh sách kiểm tra sẽ tự động được đánh dấu là "Chưa hoàn tất", "Không bắt buộc", "Có lỗi" hoặc "Hoàn tất" khi bạn thực hiện các bước trong tab Thiết lập.

Tab Thiết lập

Tab Thiết lập là nơi bạn sẽ đặt cấu hình và xác thực hầu hết quá trình tích hợp. Trước khi bắt đầu, hãy xem xét các trường hợp sử dụng, công cụ xác thực và tính năng mà ứng dụng đó sẽ cung cấp cho doanh nghiệp bạn. Làm như vậy sẽ đảm bảo rằng bạn đang thiết lập đúng cấu hình và xây dựng các công cụ phù hợp.

  • Ứng dụng của tôi dùng cho các trường hợp sử dụng (ngành dọc) nào? Ví dụ: Cuộc hẹn, Thương mại, Đặt chỗ tại nhà hàng, v.v. Hãy xem danh sách đầy đủ các trường hợp sử dụng được MBE hỗ trợ tại đây.
  • Tôi muốn kích hoạt những tính năng nào của ứng dụng cho doanh nghiệp của mình? Ví dụ: Nút kêu gọi hành động trên Instagram, Chat trên Messenger, v.v.

Mỗi phần khác nhau trong tab này đều cung cấp phương thức xác thực giúp bạn nắm được tiện ích tích hợp hiện tại có lỗi nào cần khắc phục hay không trước khi cho phép doanh nghiệp của bạn sử dụng. Ví dụ: khi xây dựng phương thức Đăng nhập cho doanh nghiệp hoặc URL xác thực, nếu có giá trị cấu hình nào không hợp lệ (đơn vị tiền tệ không được hỗ trợ, phần bổ sung sai định dạng, cấu hình tính năng chưa đầy đủ, v.v.), lỗi sẽ hiển thị khi bạn nhấp vào nút Lưu và thẻ sẽ được đánh dấu là "Có lỗi".

Ví dụ

Webhooks

Hãy dùng thẻ Webhooks để thiết lập và sửa đổi cấu hình webhooks. Hệ thống sẽ kiểm tra và xác thực URL gọi lại cũng như Mã xác minh đã nhập tại đây. Sau khi được xác thực, webhook fbe_install sẽ tự động được đăng ký. Tuy nhiên, bạn có thể bật/tắt trạng thái đăng ký bằng nút chuyển ở cuối thẻ này.


Miền ký tự đại diện

Hãy sử dụng miền ký tự đại diện của bảng điều khiển dành cho nhà phát triển để chạy phương thức xác thực chung trên pixel. Ngoài ra, chúng tôi dùng các phương thức xác thực này để xác định những doanh nghiệp tiềm năng sẽ được hưởng lợi từ MBE. Bạn phải thêm mọi định dạng có thể có của URL doanh nghiệp vào nền tảng của mình.


Ví dụ

  • https://www.example.com
  • https://www.example.com/*
  • Nếu doanh nghiệp có thể có các miền phụ tùy chỉnh:
    • https://www.*.example.com
  • Nếu bạn yêu cầu doanh nghiệp phải có các đường dẫn bắt buộc:
    • https://www.example.com/some_mandatory_path/*
    • https://www.example.com/*/some_mandatory_path/*

Bảng câu hỏi về pixel

Vui lòng sử dụng Bảng câu hỏi về pixel để cân nhắc trong quá trình triển khai pixel. Bảng câu hỏi này có trong thẻ Đặt cấu hình pixel trên tab Thiết lập. Hãy nhấp vào nút đặt cấu hình để bắt đầu bảng câu hỏi. Trong quy trình Xét duyệt tiện ích tích hợp, chúng tôi sẽ sử dụng các câu trả lời bạn đưa ra trong bảng câu hỏi để nắm được cách bạn triển khai kích hoạt pixel.

Tab Xét duyệt tiện ích tích hợp

Bạn có thể bắt đầu quy trình xét duyệt tiện ích tích hợp trong tab này. Bạn có thể gửi tiện ích tích hợp đi xét duyệt ngay khi hoàn thành tất cả các mục bắt buộc trong danh sách kiểm tra trên tab Tổng quan.

Tab Trạng thái ra mắt

Sau khi tiện ích tích hợp của bạn được phê duyệt, bạn có thể truy cập vào tab này. Tại đây, bạn có thể ra mắt ứng dụng của mình với người dùng công khai bằng cách nhấp vào nút Ra mắt ứng dụng.

Tab Trình gỡ lỗi

Tab này có 2 công cụ mà bạn có thể sử dụng sau khi ra mắt, khi bạn bắt đầu tích hợp doanh nghiệp và cần biết chi tiết về kết nối FBE của doanh nghiệp đó, cũng như khắc phục các vấn đề ảnh hưởng đến quy trình tích hợp của họ.

Bạn nên dùng các công cụ trình gỡ lỗi trong bước đầu tiên khi cố gắng hỗ trợ doanh nghiệp tích hợp (ví dụ: nếu doanh nghiệp báo cáo với đội ngũ hỗ trợ khách hàng rằng họ không thể kết nối hoặc các tính năng dự kiến không hoạt động như dự định). Các công cụ này có thể giúp bạn biết liệu có xảy ra vấn đề từ phía bạn hay không và cho phép bạn tự khắc phục vấn đề.

Lỗi cấu hình sai trong ứng dụng

Phần này liệt kê các loại lỗi cài đặt khác nhau cản trở quá trình tích hợp của doanh nghiệp bạn do vấn đề cấu hình sai trong quá trình tích hợp MBE. Số lượng doanh nghiệp bị ảnh hưởng bởi mỗi loại lỗi sẽ hiển thị dưới dạng "Tổng số".

Hãy sử dụng menu thả xuống ở bên phải để xem danh sách lỗi trong khung thời gian đã chỉ định (tháng trước, tuần trước, ngày qua).

Ví dụ


Cách khắc phục các lỗi được hiển thị

Nguyên nhân của mọi lỗi hiển thị trong bảng điều khiển này đều là do cấu hình sai trên đối tượng phần bổ sung mà bạn phải chuyển cho Facebook khi các doanh nghiệp tích hợp thông qua phương thức Đăng nhập cho doanh nghiệp và URL xác thực.

Để khắc phục lỗi, bạn cần xác định phần nào của đối tượng phần bổ sung bị thiếu/định dạng sai hoặc sử dụng giá trị không hợp lệ. Mỗi loại lỗi được liệt kê đều nêu rõ nguyên nhân. Vì vậy, bạn có thể xác thực các giá trị mà tiện ích tích hợp đang gửi dựa trên Tài liệu tham khảo về FBE dành cho phần bổ sung.

Một số ví dụ thường gặp bao gồm:

  • Trường currency trong setup bị định dạng sai - Nghĩa là giá trị của đơn vị tiền tệ dành cho một số doanh nghiệp mà bạn đang gửi trên đối tượng phần bổ sung không được hỗ trợ bởi Facebook.

  • Trường ig_cta trong business_config có chứa giá trị không hợp lệ - Nghĩa là các trường hoặc giá trị được dùng để bật nút Kêu gọi hành động trên Instagram không phải là giá trị dự kiến dành cho đối tượng ig_cta.

Trình gỡ lỗi Tiện ích Meta Business

Công cụ này cho phép bạn lấy trạng thái và thông tin chi tiết về một doanh nghiệp cụ thể. Bạn có thể xác nhận xem doanh nghiệp có đang kết nối với MBE hay không bằng cách cung cấp external_business_id của doanh nghiệp đó. Nếu doanh nghiệp được kết nối, bạn sẽ nhận được thông tin chi tiết về tài sản đã kết nối (ví dụ: Trang, Instagram, Danh mục, pixel, v.v.), cũng như danh sách các tính năng MBE mà kết nối đó hỗ trợ.

Bước tiếp theo