Dùng khóa Advertiser API cho quy trình quản lý quảng cáo và khóa Conversions API để gửi sự kiện từ máy chủ. Trước khi xử lý sự cố với một trong hai loại khóa, hãy xác định tài khoản, thao tác và đích nhận dự kiến. Thông tin xác thực hợp lệ cho một công việc không chứng minh rằng công việc khác đã được cấp quyền hoặc kích hoạt.
Rà soát ngày 15/10/2026. Hướng dẫn độc lập này của GPTAd cung cấp khung chẩn đoán, không phải hướng dẫn cài đặt đã được kiểm thử trên tài khoản. Cần kiểm tra khả năng sử dụng và quyền truy cập ngay trong tài khoản thực tế. Không đưa token thật vào biểu mẫu này, ảnh chụp gửi hỗ trợ hoặc mã chạy trên trình duyệt.
Lập bảng mục đích sử dụng từng loại thông tin xác thực
Tài liệu Tổng quan Advertiser API của OpenAI trình bày cách quản lý chiến dịch, báo cáo và tạo khóa trong phần Settings của Ads Manager, đồng thời yêu cầu lưu khóa ở phía máy chủ. Ví dụ đọc thông tin tài khoản sử dụng endpoint tài khoản của API quảng cáo để xác minh tài khoản liên kết.
Tài liệu Conversions API mô tả cách gửi sự kiện giữa các máy chủ bằng khóa CAPI và Pixel ID. Tài liệu hướng dẫn cấp khóa qua thẻ Conversions, với quy trình riêng dành cho đối tác API đã được phê duyệt. Pixel ID xác định nguồn dữ liệu đích, không thay thế thông tin xác thực.
Tạo hai hồ sơ quản lý riêng, kể cả khi cùng một lập trình viên phụ trách cả hai:
- Tích hợp quản lý: mục đích kinh doanh, tài khoản quảng cáo, các thao tác được cấp quyền, người phụ trách triển khai, tham chiếu trong hệ thống quản lý bí mật và ngày xác minh gần nhất.
- Hệ thống phát sự kiện: sự kiện kinh doanh, tài khoản quảng cáo, Pixel ID, tham chiếu khóa CAPI trong hệ thống quản lý bí mật, người phụ trách hệ thống phát sự kiện và lần kiểm tra được phê duyệt gần nhất.
Bổ sung môi trường và khu vực nếu phù hợp với hạ tầng, cùng người có quyền phê duyệt thay đổi. Lưu tham chiếu đến bí mật thay vì nội dung của chúng. Dùng các giá trị giữ chỗ dễ hiểu như MANAGEMENT_SECRET_REFERENCE và EVENTS_SECRET_REFERENCE trong ví dụ nội bộ.
Việc tách biệt này cũng hữu ích khi lựa chọn nhà cung cấp. Một nhà cung cấp gửi sự kiện không mặc nhiên cần quyền chỉnh sửa chiến dịch. Hãy hỏi thao tác nào thực sự cần đến từng quyền được yêu cầu.
Kiểm tra thông tin nhỏ nhất có ích trước
Với tích hợp quản lý, hãy để lập trình viên được cấp quyền thực hiện bước xác minh tài khoản chỉ đọc theo tài liệu, rồi đối chiếu danh tính tài khoản trả về với hồ sơ đã được duyệt. Không tạo chiến dịch chỉ để thử xem khóa có hoạt động hay không.
Với việc gửi sự kiện, hãy kiểm tra đích nhận đã cấu hình, Pixel ID và tham chiếu bí mật trước khi gửi bất cứ thứ gì. Xác nhận không bị nhầm giữa môi trường thử nghiệm và môi trường vận hành. Dùng chức năng chỉ xác thực được mô tả trong tài liệu để kiểm tra payload thử nghiệm có cấu trúc đúng; xác thực thành công không chứng minh việc phân bổ chuyển đổi hay gửi dữ liệu trong môi trường vận hành đã thành công.
Để thiết kế hệ thống đo lường tổng thể, hãy tham khảo checklist phân công trách nhiệm cho Pixel và CAPI. Thông tin xác thực giải quyết quyền truy cập, còn định nghĩa sự kiện xác định hệ thống cần báo cáo điều gì. Hai yếu tố này không thể thay thế nhau.
Phân biệt lỗi thông tin xác thực với khả năng sử dụng tính năng
Tài liệu thiết lập dành cho đối tác API của OpenAI nêu các bước kiểm tra kích hoạt tài khoản cho việc cập nhật thương hiệu, quản lý pixel, tạo khóa CAPI và đặt giá thầu theo chuyển đổi. Tài liệu mô tả các phản hồi 403 hoặc 404 cụ thể cho những tình huống này, cùng lỗi thiếu nguồn dữ liệu khi nguồn được tham chiếu không có trong tài khoản hiện tại.
Đừng tạo bí mật mới mỗi khi gặp lỗi. Hãy chẩn đoán theo thứ tự sau:
- Đích nhận: yêu cầu có được gửi đến đúng API và thao tác theo tài liệu không?
- Danh tính: thao tác đọc tài khoản được cấp quyền có xác nhận đúng nhà quảng cáo dự kiến không?
- Cấu hình: dịch vụ đang chạy có nạp đúng tham chiếu bí mật mà không in giá trị của nó ra không?
- Phạm vi tài nguyên: chiến dịch hoặc nguồn dữ liệu được tham chiếu có thuộc tài khoản đó không?
- Kích hoạt: lỗi cụ thể có khớp với một hạn chế tính năng được mô tả trong tài liệu không?
- Yêu cầu kỹ thuật: phương thức, các trường bắt buộc và cấu trúc payload có đúng không?
Lưu bằng chứng cho từng kết luận. “Khóa bị hỏng” là giả thuyết; thông báo lỗi đã che dữ liệu nhạy cảm và danh tính tài khoản đã xác minh mới là những thông tin hữu ích. Tránh coi một mã trạng thái là bằng chứng chắc chắn cho cùng một nguyên nhân trong mọi trường hợp.
Chuẩn bị hồ sơ chuyển hỗ trợ đã loại bỏ dữ liệu nhạy cảm
Một yêu cầu hỗ trợ hữu ích giúp người khác tái hiện lỗi mà không cần nhận thông tin xác thực hay hồ sơ khách hàng của bạn. Hãy chuẩn bị:
- Thao tác và tác động đến hoạt động kinh doanh, bao gồm việc phân phối hiện tại có bị ảnh hưởng hay không.
- Thời điểm lỗi kèm múi giờ và lần chạy thành công gần nhất đã biết.
- Mã tài khoản và tài nguyên dự kiến, chỉ chia sẻ qua kênh hỗ trợ phù hợp.
- Phương thức HTTP, đường dẫn endpoint, trạng thái phản hồi và nội dung lỗi đã loại bỏ dữ liệu nhạy cảm.
- Mã định danh yêu cầu nếu phản hồi có cung cấp.
- Trạng thái quyền truy cập tính năng liên quan và những thay đổi triển khai gần đây.
- Payload giả lập tối giản thể hiện cấu trúc các trường, đã xóa hoàn toàn header xác thực.
Loại bỏ cookie, bearer token, thông tin định danh cá nhân và tham số URL không cần thiết khỏi ảnh chụp và nhật ký. Kiểm tra chính tệp đính kèm, không chỉ tên tệp. Nội dung sao chép từ phiên terminal có thể làm lộ thông tin xác thực dù thông báo lỗi chính không chứa dữ liệu nhạy cảm.
Xử lý tình huống giả định khi đổi đơn vị phụ trách
Giả sử một agency xây dựng cả dịch vụ báo cáo chiến dịch lẫn hệ thống gửi sự kiện ở backend. Một kỹ sư mới được cấp quyền truy cập tài khoản quảng cáo và cho rằng doanh nghiệp đã nắm quyền quản lý cả hai dịch vụ. Nhưng chúng có thể vẫn đang chạy trên hạ tầng của agency.
Kiểm kê từng môi trường chạy, quy trình triển khai, nơi nhận cảnh báo và người quản lý bí mật. Thống nhất quyền truy cập thay thế với quản trị viên tài khoản, xác minh dịch vụ thay thế rồi thu hồi quyền cũ theo quy trình được hỗ trợ. Ghi rõ ai đã xác nhận hoạt động liên tục. Không thu hồi quyền một cách mù quáng khi một hệ thống phát sự kiện chưa được ghi nhận vẫn đang phụ trách đo lường thực tế.
Nếu số lượng sự kiện thay đổi sau bàn giao, hãy kiểm tra định danh của từng lần phát sinh và cách định tuyến theo hướng dẫn kiểm thử chống trùng lặp. Nếu chính chiến dịch ngừng phân phối, hãy dùng quy trình xử lý sự cố phân phối riêng. Hồ sơ thông tin xác thực cần giúp thu hẹp phạm vi điều tra, thay vì biến mọi dấu hiệu vận hành thành vấn đề về khóa.
Tài liệu tham khảo
- Tổng quan Advertiser API của OpenAI; rà soát ngày 15/10/2026.
- Conversions API của OpenAI; rà soát ngày 15/10/2026.
- Thiết lập dành cho đối tác API của OpenAI; rà soát ngày 15/10/2026.
