Quảng Cáo Danh Mục Sản Phẩm (Product Feeds) & Đồng Bộ Tồn Kho Thời Gian Thực Qua Delta Feeds API Trên ChatGPT

Đối với các sàn Thương mại điện tử, chuỗi bán lẻ đa ngành hàng hoặc hệ thống khách sạn/du lịch sở hữu từ vài trăm đến hàng trăm ngàn mã sản phẩm (SKU), việc tạo tay từng mẫu quảng cáo đơn lẻ là bất khả thi. Để giải quyết bài toán này, OpenAI cung cấp giải pháp Product Feeds (Nguồn cấp danh mục sản phẩm) kết hợp với Delta Feeds API (Đồng bộ biến động giá & tồn kho tức thì).

Khi người dùng hỏi ChatGPT các câu hỏi mang tính mua sắm (ví dụ: "Gợi ý cho tôi giày chạy bộ địa hình chống nước dưới 100 USD"), hệ thống sẽ tự động lấy thông tin tên, hình ảnh, giá bán và tình trạng còn hàng từ Product Feed của bạn để kết xuất thành thẻ sản phẩm động ngay trong câu trả lời! Hãy cùng CDUDU tìm hiểu quy trình triển khai kỹ thuật chi tiết.

I. Quy trình 4 bước thiết lập Product Feed qua SFTP trên OpenAI Ads

Theo tài liệu Product Feeds (https://developers.openai.com/ads/product-feeds), quá trình nạp danh mục sản phẩm gốc được thực hiện an toàn thông qua giao thức truyền tệp SFTP:

Bước 1: Khởi tạo Feed trong tài khoản quảng cáo (POST /v1/feeds)

curl -X POST "https://api.ads.openai.com/v1/feeds" \
  -H "Authorization: Bearer ${OPENAI_ADS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CDUDU Ecommerce Master Catalog",
    "countries": ["US", "VN"]
  }'

Lưu lại mã feed_id (ví dụ fd_123) trả về từ hệ thống.

Bước 2: Cấp quyền kết nối SFTP (Password hoặc SSH Public Key)

OpenAI hỗ trợ cả hai phương thức xác thực SFTP là mật khẩu (password) hoặc khóa công khai SSH (ssh_key — khuyến nghị cho các cronjob tự động trên máy chủ Linux):

curl -X POST "https://api.ads.openai.com/v1/feeds/fd_123/sftp_access" \
  -H "Authorization: Bearer ${OPENAI_ADS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "authentication_method": "ssh_key",
    "ssh_public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... [email protected]"
  }'

Bước 3: Chuẩn bị tệp catalog.csv theo đúng Schema Thương mại của OpenAI

Tệp danh mục phải có định dạng UTF-8 CSV, mỗi dòng là một sản phẩm hoặc biến thể (variant), và giữ nguyên item_id ổn định giữa các lần tải lên. Đặc biệt, hãy chú ý 3 cột cờ điều khiển hiển thị cuối cùng:

• is_eligible_search: Cho phép xuất hiện trong tìm kiếm tự nhiên.
• is_eligible_checkout: Cho phép thanh toán trực tiếp.
• is_ads_eligible: Bắt buộc đặt là true cho những sản phẩm bạn muốn chạy quảng cáo ChatGPT Ads!

item_id,title,description,url,brand,image_url,price,availability,seller_name,seller_url,return_policy,target_countries,store_country,is_eligible_search,is_eligible_checkout,is_ads_eligible
SKU-001,Trail Running Shoe,Lightweight trail shoe for daily runs,https://example.com/products/sku-001,Acme,https://example.com/images/sku-001.jpg,89.00 USD,in_stock,Acme,https://example.com,https://example.com/returns,US,US,true,false,true

Bước 4: Tải tệp lên thư mục gốc SFTP & Giám sát qua /v1/feeds/uploads

Khi đẩy file catalog.csv lên SFTP (put /path/to/catalog.csv catalog.csv), bạn bắt buộc phải đặt file ngay tại thư mục gốc (SFTP root), tuyệt đối không tạo thư mục con lồng bên trong (nếu đặt trong thư mục con sẽ bị lỗi chẩn đoán invalid_sftp_directory_layout).

Sau khi upload, gọi GET https://api.ads.openai.com/v1/feeds/uploads để kiểm tra số dòng được chấp nhận (rows_accepted), số dòng đủ điều kiện quảng cáo (rows_ads_eligible) và các cảnh báo lỗi (diagnostics).

II. Đồng bộ Giá bán & Tồn kho Thời gian thực bằng Delta Feeds API

Nếu cửa hàng của bạn có 50.000 sản phẩm và cứ mỗi 5 phút lại có vài sản phẩm hết hàng (out_of_stock) hoặc thay đổi giá Flash Sale, việc upload lại toàn bộ file CSV qua SFTP là quá chậm. Đó là lúc bạn sử dụng Delta Feeds API (PATCH /v1/feeds/{feed_id}/products) để chỉ cập nhật đúng những biến thể vừa thay đổi:

curl -X PATCH "https://api.ads.openai.com/v1/feeds/product_feed_123/products" \
  -H "Authorization: Bearer ${OPENAI_ADS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {
        "id": "running-shoe-001",
        "variants": [
          {
            "id": "running-shoe-001-black-9",
            "availability": {
              "available": false
            }
          },
          {
            "id": "running-shoe-001-white-9",
            "title": "Running shoe - white, size 9 (Flash Sale)",
            "price": {
              "amount": 7999,
              "currency": "USD"
            },
            "availability": {
              "status": "in_stock"
            }
          }
        ]
      }
    ]
  }'

Các quy tắc quan trọng của Delta Feeds API:

1. Chỉ cập nhật sản phẩm đã tồn tại: Delta API dùng phương thức PATCH để sửa title, price (tính bằng minor units: 7999 = $79.99 USD) và availability (in_stock / out_of_stock) của các biến thể đã có trong catalog gốc, không dùng để thêm mới sản phẩm chưa từng nạp qua SFTP.
2. Tự động ngắt phân phối khi hết hàng: Khi một biến thể được cập nhật sang available: false (hoặc status: "out_of_stock"), hệ thống sẽ tự động ngừng phân phối quảng cáo cho sản phẩm đó ngay khi thay đổi được đồng bộ, giúp bạn không tốn một đồng click nào vào sản phẩm đã hết kho!
3. Kết hợp hoàn hảo với Chiến dịch oCPC Product Feed: Khi tạo Campaign có mode: "product_feed" và bidding_type: "conversions", bạn có thể lọc nhóm sản phẩm theo nhãn tùy chỉnh (product_set) ở cấp Ad Group.

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

III. Câu hỏi thường gặp (FAQ) về Product Feeds & Delta Feeds trên ChatGPT Ads

1. Nếu ngành hàng của tôi là Khách sạn và Lưu trú (Hotels) thì có dùng chung Product Feed này không?

OpenAI cung cấp một chuẩn nguồn cấp riêng cho ngành lưu trú là Hotel Property Feeds (https://developers.openai.com/ads/hotel-feeds — Limited Beta) được thiết kế chuyên biệt cho thông tin phòng, vị trí địa lý và giá theo đêm.

2. Tại sao tôi không được truyền trường shop_id hay target_country vào body của Delta Feeds API?

Bởi vì quyền sở hữu cửa hàng, danh tính sản phẩm và quốc gia mục tiêu đã được định nghĩa sẵn trên feed_id liên kết. Nếu bạn truyền thêm các trường lạ không nằm trong schema (products[].id, variants[].id, title, price, availability), API sẽ trả về lỗi HTTP 400 Bad Request.

3. Làm thế nào để đo lường xem sản phẩm nào trong Feed được người dùng nhấp vào nhiều nhất?

Bạn có thể truy xuất báo cáo phân tách theo từng sản phẩm (segments[]=product) qua Insights API để xem số lượt hiển thị, lượt click và cả tương tác trên từng thẻ Carousel (carousel_product_card_clicks).