Cổng API Chuyển đổi: Hướng dẫn thiết lập AWS App Runner

Hãy làm theo các bước dưới đây để thiết lập Cổng API Chuyển đổi.

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

Trước khi có thể triển khai Cổng API Chuyển đổi, hãy chắc chắn rằng bạn có:

  • ID Meta Pixel
  • Quyền quản trị vào Trình quản lý sự kiện (quyền truy cập một phần sẽ không thực hiện được)
  • Tất cả miền trang web
  • Quyền truy cập vào Nhà cung cấp DNS (cần có để đặt cấu hình miền phụ)
  • Quyền quản trị vào nhà cung cấp dịch vụ đám mây (ví dụ: AWS)

Khuyến nghị: Bật tính năng So khớp nâng cao trên Meta Pixel để góp phần tối đa hóa hiệu quả của tiện ích tích hợp Cổng API Chuyển đổi. Với tính năng So khớp nâng cao, bạn có thể gửi thông tin liên hệ của khách hàng ở dạng băm cùng với các sự kiện Pixel của bạn. Qua đó, bạn có thể ghi nhận thêm lượt chuyển đổi và tiếp cận nhiều người hơn. Xem thêm chi tiết tại đây.

Phiên bản hiện tại của Cổng API Chuyển đổi chỉ hỗ trợ Amazon Web Services (AWS) với vai trò là nhà cung cấp dịch vụ đám mây bên thứ ba:

  • Nếu chưa có tài khoản AWS, bạn có thể tạo tài khoản bằng cách làm theo hướng dẫn này.

Bước 1: Bắt đầu và bắt đầu triển khai

Để bắt đầu quy trình thiết lập, hãy chuyển đến tab Cài đặt trong Trình quản lý sự kiện trên Meta. Trong phần Thiết lập bằng Cổng API Chuyển đổi, hãy nhấp vào Bắt đầu.


  • Chọn tùy chọn lưu trữ là Tự lưu trữ.


  • Xem xét các điều kiện tiên quyết đối với Cổng API Chuyển đổi rồi chọn Tiếp.


  • Ở bước Chọn tùy chọn, hãy chọn cài đặt bạn muốn bật rồi nhấp vào Tiếp tục.

    • Tính năng cải thiện sự kiện có thể góp phần nâng cao hoạt động phân bổ lượt chuyển đổi và tăng tối đa các lợi ích về hiệu quả của những sự kiện mà bạn hiện chia sẻ với Meta.
    • Tính năng giám sát tình trạng Cổng API Chuyển đổi hỗ trợ Meta khắc phục các sự cố tiềm ẩn một cách hiệu quả hơn.


  • Khi được yêu cầu chọn nhà cung cấp dịch vụ đám mây, hãy chọn tùy chọn thiết lập đám mây là AWS App Runner.


  • Triển khai trên AWS bằng App Runner.
    • Tiếp theo, trong phần Chọn khu vực lưu trữ của bạn, hãy chọn khu vực bạn mong muốn. Bạn chỉ có thể thiết lập Cổng API Chuyển đổi ở một khu vực.
    • Nhấp vào Tiếp để mở Amazon Web Services (AWS) hoặc nhấp vào Sao chép URL để gửi cho quản trị viên tài khoản AWS của tổ chức bạn.


Bước 2: Đặt cấu hình AWS và cài đặt

Đăng nhập vào AWS nếu bạn chưa đăng nhập.

  • Một quy trình tạo nhanh cho ngăn xếp Cổng API Chuyển đổi sẽ mở ra.


  • Mọi trường sẽ được điền sẵn. Vui lòng không thay đổi trường ProvisioningDataBootstrapInformation.
  • Nhấp vào Create stack (Tạo ngăn xếp) để bắt đầu cài đặt.
  • Quy trình tạo này mất khoảng 15 đến 20 phút. Sau đó, 1 kết quả sẽ được ghi vào tab Outputs (Đầu ra) của phiên bản AWS mới. Khi quy trình này kết thúc, trạng thái sẽ hiển thị là CREATE_COMPLETE trong tab Stack info (Thông tin ngăn xếp).
  • Sau khi hoàn tất quy trình, hãy chuyển đến tab Outputs (Đầu ra).
  • Ghi lại CapigSetupURL vì bạn sẽ cần dùng URL này để cấp phép giao diện người dùng của Cổng API Chuyển đổi.


Bước 3: Xác minh hoạt động thu thập dữ liệu

Để truy cập vào giao diện người dùng quản trị của Cổng API Chuyển đổi, hãy sử dụng CapigSetupURL trong tab Outputs (Đầu ra).

  • Bạn sẽ được yêu cầu tạo tài khoản quản trị viên khi đăng nhập lần đầu vào giao diện người dùng quản trị.
  • Chọn Đăng nhập sau khi tạo tài khoản quản trị viên.
  • Bạn sẽ nhìn thấy giao diện người dùng quản trị của Cổng API Chuyển đổi.
  • Khi xem trang web này lần đầu, bạn sẽ không thấy dữ liệu máy chủ và trình duyệt. Thông tin này sẽ mất từ 10 phút đến 2 giờ mới xuất hiện.
  • Để kiểm tra xem dữ liệu có đang được thu thập hay không, bạn có thể truy cập vào trang web của mình rồi làm mới trang. Nếu các sự kiện không xuất hiện sau 2 giờ, hãy liên hệ với Meta để khắc phục sự cố.
  • Nếu các sự kiện không xuất hiện sau 2 giờ, vui lòng liên hệ với Meta.
  • Lúc này, bạn sẽ nhìn thấy Cổng API Chuyển đổi trong phần cài đặt pixel.
  • Khuyến nghị: Tạo một miền tùy chỉnh để tối ưu hóa quy trình định tuyến dữ liệu. Hãy xem hướng dẫn trên trang tham khảo này.