Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.
Cập nhật bằng tiếng Anh: 27 tháng 4

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

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

Hãy đảm bảo bạn đã xem lại và hoàn thành các điều kiện tiên quyết dành cho Cổng API Chuyển đổi trước khi làm theo hướng dẫn thiết lập 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.



  • 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.

Chọn tùy chọn

  • Chọn các chế độ 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.


  • 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 trong 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.

  • Tất cả các trường sẽ được điền sẵn. Vui lòng không thay đổi trường ProvisioningData.
  • 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 30 đến 40 phút. Sau đó, 3 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ị: 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).
  • (Đề xuất) Tạo một miền tùy chỉnh để hỗ trợ định tuyến dữ liệu. Hãy xem bước 4 bên dưới.
  • 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) (tham khảo bước 2). Bạn cũng có thể tìm thấy CapigSetupURL trong Trình quản lý sự kiện trên Meta.

  • 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 trang web 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ừ 5 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ờ, 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.

(Đề xuất) Bước 4: Thêm miền tùy chỉnh

Thiết lập một miền tùy chỉnh trong Giao diện người dùng quản trị của Cổng API Chuyển đổi. Bạn nên dùng miền tùy chỉnh vì miền này có thể góp phần tối ưu hóa chức năng định tuyến dữ liệu và giảm bớt chi phí.

Lưu ý: Bạn sẽ phải truy cập vào nhà cung cấp DNS thì mới thêm được miền tùy chỉnh

  • Đăng nhập vào Giao diện người dùng quản trị của Cổng API Chuyển đổi.
  • Điều hướng đến mục Quản lý miền ở thanh bên trái trong phần Cài đặt.
  • Chọn giữa nhà cung cấp DNS là AWS Certificate Manager (ACM) hoặc Cloudflare.

1. AWS Certificate Manager

Vui lòng làm theo hướng dẫn Thiết lập ACM để hoàn tất việc thiết lập.

2. Cloudflare

Vui lòng làm theo hướng dẫn Thiết lập Cloudflare để hoàn tất việc thiết lập.

Khắc phục sự cố thiết lập

Hãy làm theo các bước sau để khắc phục sự cố khi bạn thiết lập Cổng API Chuyển đổi. Để khắc phục sự cố chung, hãy xem bài viết Cổng API Chuyển đổi - Khắc phục lỗi và cảnh báo.

Tính năng tự động điền vào trình duyệt cản trở việc thiết lập

Nếu bạn không thể cài đặt Cổng API Chuyển đổi do dữ liệu cấp phép bị hết hạn ngay cả khi đã khởi chạy cài đặt từ Trình quản lý sự kiện, rất có thể tính năng tự động điền vào trình duyệt đang tự động điền thông tin từng sử dụng trước đó.

Chẩn đoán

  1. Khởi chạy cài đặt từ Trình quản lý sự kiện và lưu dữ liệu cấp phép để kiểm tra sau.
  2. Nhấp vào Sao chép URL và lưu URL đã sao chép vào trình chỉnh sửa văn bản bất kỳ, chẳng hạn như Notepad.
  3. Nhấp vào Bắt đầu triển khai để khởi chạy trang tạo AWS.
  4. Trên trang tạo AWS, hãy tìm ProvisioningData và xác minh rằng mục nhập khớp với URL mà bạn đã sao chép trước đó. Nếu không khớp thì tức là tính năng tự động điền đang bật và bạn phải tắt tính năng này.

Độ phân giải

Đối với trình duyệt FireFox, hãy làm theo các bước sau:

  1. Nhấp vào biểu tượng menu Firefox (biểu tượng 3 dấu gạch ngang ở trên cùng bên phải màn hình).
  2. Nhấp vào Cài đặt.
  3. Chọn cài đặt Quyền riêng tư và bảo mật.
  4. Cuộn đến phần Lịch sử, đối với mục Firefox sẽ, hãy chọn Sử dụng cài đặt tùy chỉnh cho lịch sử.
  5. Bỏ chọn Ghi nhớ lịch sử tìm kiếm và biểu mẫu.
  6. Thay đổi của bạn sẽ tự động được lưu.

Đối với trình duyệt Chrome, hãy làm theo các bước sau:

  1. Nhấp vào biểu tượng menu Chrome (biểu tượng 3 dấu chấm ở trên cùng bên phải màn hình).
  2. Nhấp vào Cài đặt.
  3. Chọn cài đặt Tự động điền.
  4. Mở rộng khu vực thích hợp.
  5. Tắt cài đặt tự động điền.
  6. Thay đổi của bạn sẽ tự động được lưu.

Cấu hình bổ sung

Với Trình quản lý sự kiện trên Meta, bạn có thể thêm kết nối mới, đặt cấu hình miền bổ sung và thêm Pixel mới vào kết nối Cổng API Chuyển đổi hiện có. Để xác định những chế độ cài đặt này, vui lòng làm theo các bước bên dưới:

Nhấp vào Tích hợp đối tác xuất hiện ở bên trái trang:



Chọn Cổng API Chuyển đổi để mở Cổng API Chuyển đổi.



Trên màn hình này, bạn có thể xem:

  • Sự kiện trên trang web
    1. Sự kiện là các hành động trên trang web được thiết lập trên trang web Cổng API Chuyển đổi và được gửi riêng đến Meta bằng Meta Pixel.
  • Miền trang web
    1. Các trang web mà Cổng API Chuyển đổi của bạn được đặt cấu hình để kết nối thông qua Pixel.


Nhấp vào Cài đặt rồi chọn hành động mà bạn muốn thực hiện.

Thêm kết nối Cổng API Chuyển đổi khác

Với lựa chọn này, bạn có thể thiết lập phiên bản Cổng API Chuyển đổi mới bằng một Meta Pixel khác. Sau đây là bước đầu tiên trong hộp thoại, tương tự như bước trên trang cài đặt Meta Pixel. Tiếp theo, bạn sẽ được yêu cầu chọn một Meta Pixel để cài đặt kết nối Cổng API Chuyển đổi mới.

Thêm một Meta Pixel khác vào kết nối Cổng API Chuyển đổi hiện có

Với tùy chọn này, bạn có thể tích hợp một Meta Pixel khác trong quá trình cài đặt Cổng API Chuyển đổi hiện có.

Để 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 "Cổng API Chuyển đổi hiện có", hãy nhấp vào nút Kết nối: