Danh Sách 13 Sự Kiện Chuyển Đổi Chuẩn (Supported Events) & Cấu Trúc Dữ Liệu (Data Shapes) Trên ChatGPT Ads

Khi tích hợp ChatGPT Ads Measurement Pixel hoặc OpenAI Conversions API (CAPI), một trong những yêu cầu kỹ thuật nghiêm ngặt nhất của OpenAI là Sự tương thích giữa Tên sự kiện (type) và Hình thái dữ liệu đi kèm (data.type — Event Data Shape).

Nếu bạn gửi sự kiện order_created nhưng lại truyền data.type: "customer_action", hoặc gửi giá trị tiền tệ dạng số thập phân 42.00 thay vì số nguyên đơn vị nhỏ nhất (4200), hệ thống OpenAI sẽ lập tức từ chối lưu sự kiện. Trong bài viết này, CDUDU sẽ tổng hợp bảng tra cứu 13 Sự kiện chuyển đổi chuẩn (Supported Events) và 4 Cấu trúc Data Shapes theo đúng đặc tả của OpenAI Developers.

I. Bảng tra cứu 13 Sự kiện chuyển đổi chuẩn (Supported Events) trên ChatGPT Ads

Theo tài liệu Supported Events (https://developers.openai.com/ads/supported-events), OpenAI định nghĩa 12 sự kiện tiêu chuẩn và 1 sự kiện tùy chỉnh (custom). Bạn nên luôn ưu tiên sử dụng sự kiện tiêu chuẩn vì chỉ các sự kiện tiêu chuẩn mới được phép chọn làm mục tiêu tối ưu hóa cho chiến dịch oCPC (Conversion-Optimized Campaigns):

II. Giải mã 4 Cấu trúc Dữ liệu (Event Data Shapes)

Mỗi sự kiện đều chứa đối tượng data, và trường data.type quyết định các thuộc tính được phép xuất hiện bên trong:

1. Kiểu contents (Dành cho Thương mại điện tử & Xem nội dung)

Áp dụng cho page_viewed, contents_viewed, items_added, checkout_started, order_created:

• type: Bắt buộc là "contents".
• amount (Integer, tùy chọn): Tổng giá trị tiền tệ của toàn bộ sự kiện.
• currency (String, bắt buộc nếu có amount): Mã tiền tệ 3 ký tự chuẩn ISO 4217 (VD: USD, VND, EUR).
• contents (Array, tùy chọn): Danh sách các mặt hàng. Mỗi phần tử hỗ trợ: id, name, content_type (product, plan, page), quantity (số nguyên), amount (đơn giá 1 sản phẩm), currency, và 2 trường chỉ dành riêng cho CAPI là group_id (mã sản phẩm cha) cùng variant_dict (VD: {"size": "L", "color": "blue"}).

2. Kiểu customer_action (Dành cho Thu thập Lead, Đặt lịch & App)

Áp dụng cho lead_created, appointment_scheduled, registration_completed, app_installed, app_opened:

• type: Bắt buộc là "customer_action".
• amount & currency (Tùy chọn): Giá trị ước tính của một Lead hoặc lịch hẹn.
• Lưu ý quan trọng: Kiểu customer_action không cho phép truyền mảng contents hay plan_id.

3. Kiểu plan_enrollment (Dành cho Phần mềm SaaS & Thuê bao định kỳ)

Áp dụng cho subscription_created và trial_started:

• type: Bắt buộc là "plan_enrollment".
• plan_id (String, tùy chọn): Mã gói cước nội bộ của bạn (VD: creup_ai_pro_unlimited_350k).
• amount, currency, contents (Tùy chọn).

4. Kiểu custom (Dành cho Sự kiện tự định nghĩa)

Khi type của sự kiện là "custom", bạn bắt buộc phải truyền custom_event_name (từ 1–64 ký tự gồm chữ thường, số, gạch dưới _ hoặc gạch ngang -, không được trùng tên với 12 sự kiện chuẩn). Trong data (có type: "custom"), ngoài amount, currency, plan_id, contents, bạn được phép truyền thêm các thuộc tính tùy ý (custom fields).

III. Quy tắc tính Tiền tệ theo Đơn vị nhỏ nhất (ISO 4217 Minor Units)

Một điểm kỹ thuật cực kỳ quan trọng trong cả Measurement Pixel và Conversions API: Trường amount luôn nhận kiểu Số nguyên (integer) biểu thị đơn vị tiền tệ nhỏ nhất (Minor Unit) theo chuẩn ISO 4217, tuyệt đối không nhận số thực dấu phẩy động (float):

• Với các đồng tiền có 2 chữ số thập phân (như USD, EUR, TRY): Nhân giá trị thực với 100. Ví dụ: Đơn hàng $42.00 USD phải gửi "amount": 4200, "currency": "USD".
• Khi gửi mảng contents có nhiều sản phẩm (quantity > 1):
  • contents[].amount là đơn giá của 1 đơn vị sản phẩm (per-unit price).
  • data.amount ở cấp sự kiện là tổng giá trị của cả đơn hàng.

{
  "type": "contents",
  "amount": 159800,
  "currency": "USD",
  "contents": [
    {
      "id": "SKU-PRO-01",
      "name": "Goi Phan Mem Doanh Nghiep",
      "content_type": "product",
      "quantity": 2,
      "amount": 79900,
      "currency": "USD"
    }
  ]
}

(Trong ví dụ trên: Mỗi sản phẩm có giá $799.00 tức 79900 cents; mua số lượng 2 nên tổng giá trị sự kiện amount là 2 × 79900 = 159800).

Trọn Bộ 20 Bài Viết Chuyên Sâu & Hướng Dẫn Thực Chiến Chạy ChatGPT Ads (2026)

Để nắm vững toàn bộ kiến trúc kỹ thuật, quy trình cầm tay chỉ việc và kinh nghiệm thực chiến tối ưu chuyển đổi trên hệ sinh thái quảng cáo OpenAI Ads (ads.openai.com), mời bạn khám phá trọn bộ 20 bài hướng dẫn chuyên sâu từ đội ngũ kỹ sư CDUDU:

Phần 1: Nền tảng Kiến trúc, Đo lường Server-to-Server CAPI & OpenAI Ads API (Bài 01 – 12)

1. Tổng quan hệ sinh thái (Pillar): ChatGPT Ads Là Gì? Toàn Tập Quảng Cáo Trên ChatGPT & Hệ Sinh Thái OpenAI Ads (2026)
2. Kiến trúc Server-to-Server CAPI: OpenAI Ads Conversions API (CAPI) Là Gì? Hướng Dẫn Tích Hợp Đo Lường Server-to-Server
3. Browser SDK & Deduplication: Hướng Dẫn Cài Đặt ChatGPT Ads Measurement Pixel (oaiq.min.js) & Chống Trùng Lặp Sự Kiện
4. Định danh phân bổ & SHA-256: Giải Mã Tham Số oppref Và Cookie __obref Trong ChatGPT Ads Attribution
5. Từ điển 13 Sự kiện & Data Shapes: Danh Sách 13 Sự Kiện Chuyển Đổi Chuẩn (Supported Events) & Data Shapes Trên ChatGPT Ads
6. Chiến lược Đấu thầu & oCPC: Chiến Lược Đấu Thầu (Bidding), Ngân Sách & Tối Ưu Chuyển Đổi oCPC Trên ChatGPT Ads
7. Nhắm mục tiêu Ngữ cảnh AI: Nghệ Thuật Nhắm Mục Tiêu Trên ChatGPT Ads: Context Hints, Địa Lý & Nền Tảng (iOS, Android, Web)
8. First-Party Data & Remarketing: Xây Dựng Tệp Đối Tượng Tùy Chỉnh (Custom Audiences) & Chiến Lược Remarketing Trên ChatGPT Ads
9. Thương mại điện tử & SFTP Catalog: Quảng Cáo Danh Mục Sản Phẩm (Product Feeds) & Đồng Bộ Tồn Kho Qua Delta Feeds API
10. Báo cáo Đa chiều & ROAS: Phân Tích Hiệu Quả ChatGPT Ads Với Insights API: Đo Lường ROAS, CPA & Cửa Sổ Phân Bổ
11. Tự động hóa REST API & Bulk API: Tự Động Hóa Chiến Dịch Quảng Cáo ChatGPT Hàng Loạt Bằng OpenAI Advertiser API & Bulk API
12. So sánh Đa kênh & Xử lý lỗi: So Sánh ChatGPT Ads Với Google Ads & Facebook Ads: Cách Chẩn Đoán Lỗi Serving Issues

Phần 2: Hướng dẫn Thực chiến Cầm tay chỉ việc & Kinh nghiệm Tối ưu Chuyển đổi (Bài 13 – 20)

13. Hướng dẫn A-Z cho người mới: Hướng Dẫn Chạy Quảng Cáo ChatGPT Ads Từ A-Z Cho Người Mới Bắt Đầu (Cầm Tay Chỉ Việc 2026)
14. Viết mẫu quảng cáo CTR cao: Bí Quyết Viết Mẫu Quảng Cáo chat_card & product_ad_template Đạt CTR Cao Kỷ Lục Trên ChatGPT Ads
15. Quản trị Ngân sách & UTM Tracking: Chia Sẻ Kinh Nghiệm Tối Ưu Chi Phí, Hạn Mức Chi Tiêu (Spend Limits) & Thứ Tự Ưu Tiên UTM Tracking
16. HTML Image Tag & Đa Pixel: Hướng Dẫn Đo Lường Chuyển Đổi ChatGPT Ads Bằng HTML Image Tag (Không Cần JS) & Quản Lý Multiple Pixels
17. Quảng cáo Khách sạn & Du lịch: Hướng Dẫn Chạy Quảng Cáo Khách Sạn, Resort & Lưu Trú Trên ChatGPT Ads Với Hotel Property Feeds
18. Chiến lược cho B2B SaaS & Phần mềm: Chiến Lược Chạy ChatGPT Ads Bùng Nổ Khách Hàng B2B SaaS, Phần Mềm & Dịch Vụ Doanh Nghiệp
19. Kết hợp Affiliate, TMĐT & Video AI: Bí Quyết Kết Hợp ChatGPT Ads Với Affiliate Marketing, TMĐT & Hệ Thống Reup Video Tự Động CReup AI PRO
20. 15 Sai lầm đốt tiền & Checklist Audit: 15 Sai Lầm "Đốt Tiền" Khi Tự Chạy Quảng Cáo ChatGPT Ads Và Checklist Audit Chiến Dịch Toàn Diện

IV. Câu hỏi thường gặp (FAQ) về 13 Sự kiện Chuyển đổi ChatGPT Ads

1. Sự khác nhau giữa page_viewed và contents_viewed là gì?

Bạn dùng page_viewed khi trình duyệt tải xong một trang web bất kỳ. Trong khi đó, contents_viewed được dùng khi người dùng xem cụ thể một sản phẩm, bài viết hoặc hạng mục nội dung (kể cả khi họ bấm mở Modal xem nhanh sản phẩm trên trang SPA mà không tải lại trang).

2. Sự kiện nào dùng để tính chỉ số ROAS (Lợi nhuận trên chi tiêu quảng cáo) trong báo cáo OpenAI Insights?

Chỉ số doanh thu phân bổ (order_created_attributed_sales) và order_created_roas trong Insights API được OpenAI tính toán dựa trên trường amount của sự kiện order_created.

3. Tôi có thể dùng sự kiện custom để chạy chiến dịch tối ưu chuyển đổi oCPC không?

Không. Theo quy định của OpenAI, chiến dịch oCPC (bidding_type: "conversions") chỉ chấp nhận 1 sự kiện chuyển đổi tiêu chuẩn (Standard Event) đang hoạt động làm mục tiêu tối ưu hóa.