Multi-Channel Selling

Thiết lập product feed cho ChatGPT: Trường, định dạng và SFTP

Thiết lập product feed cho ChatGPT trong 7 bước: 9 trường bắt buộc, định dạng được chấp nhận, SFTP, biến thể và lỗi khiến dữ liệu bị từ chối.

Ảnh đại diện Long Nguyen

Long Nguyen

Lập trình viên Fullstack · Kỹ sư AI · Nhà nghiên cứu

• • 5 phút đọc •

Product feed cho ChatGPT là gì và ai có thể gửi?

Product feed cho ChatGPT là một tệp danh mục có cấu trúc, được gửi đến OpenAI để ChatGPT có thể đọc thông tin sản phẩm, giá và tình trạng tồn kho. Đây là hình thức đẩy dữ liệu: bạn gửi tệp theo lịch thay vì chờ hệ thống thu thập, và chất lượng của tệp là nền tảng cho mọi bước tiếp theo.

Quyền truy cập là bước xét duyệt đầu tiên. Tính đến , hướng dẫn Get Started của OpenAI cho biết quy trình tích hợp product feed chỉ dành cho các đối tác được phê duyệt; bạn có thể đăng ký qua biểu mẫu dành cho merchant tại chatgpt.com/merchants. Hãy đăng ký trước, sau đó tranh thủ thời gian chờ để làm sạch dữ liệu, vì phần lớn công việc thiết lập là chuẩn hóa danh mục — điều mà mọi product feed đều cần.

Có hai phương thức gửi dữ liệu: tải tệp lên và sử dụng API. OpenAI thường khuyến nghị gửi toàn bộ feed mỗi ngày bằng cách tải tệp lên, đồng thời đẩy các cập nhật trong ngày qua API. Những feed nhỏ có thể dùng hoàn toàn API, còn dữ liệu khuyến mãi chỉ có thể gửi qua API. Hướng dẫn này tập trung vào phương thức tải tệp lên, dựa trên tổng quan về tải tệp lên của OpenAI.

Thiết lập product feed cho ChatGPT trong 7 bước

  1. Đăng ký quyền truy cập qua biểu mẫu dành cho merchant của OpenAI và xác nhận thông tin gửi dữ liệu (địa chỉ SFTP và các tùy chọn Ads Manager hoặc API nếu sử dụng) trong quá trình onboarding.
  2. Chọn phương thức: tải tệp lên, API hoặc kết hợp cả hai. OpenAI khuyến nghị dùng ảnh chụp toàn bộ danh mục mỗi ngày cùng với các cập nhật trong ngày qua API.
  3. Ánh xạ danh mục vào 9 trường bắt buộc (ở phần tiếp theo). Mỗi dòng tương ứng với một sản phẩm hoặc biến thể có thể mua.
  4. Xuất dữ liệu ở định dạng được hỗ trợ: Parquet được ưu tiên; jsonl.gz, csv.gz và tsv.gz cũng được chấp nhận. Toàn bộ dữ liệu phải được mã hóa bằng UTF-8.
  5. Gửi mẫu khoảng 100 sản phẩm với đầy đủ các trường bắt buộc, sau đó đọc kết quả tải lên trước khi mở rộng quy mô.
  6. Kiểm tra toàn bộ ảnh chụp danh mục đầu tiên, không chỉ mẫu thử. Chỉ kiểm tra mẫu có thể bỏ sót những vấn đề xuất hiện khi xử lý danh mục lớn, chẳng hạn ID trùng lặp và các biến thể bất thường.
  7. Tự động hóa ảnh chụp danh mục hằng ngày, ghi đè lên cùng một tên tệp ở mỗi lần gửi.

9 trường bắt buộc trong product feed cho ChatGPT

Đặc tả sản phẩm của OpenAI liệt kê 9 trường bắt buộc để tạo một feed khám phá sản phẩm hữu ích. Hãy sử dụng tên thương hiệu và tên người bán thật, không dùng giá trị giữ chỗ. Các chi tiết dưới đây tuân theo đặc tả sản phẩm của OpenAI.

Trường Dữ liệu cần gửi Lỗi cần tránh
item_id ID ổn định, duy nhất cho từng sản phẩm hoặc biến thể Không bao giờ dùng lại ID cho một sản phẩm khác. OpenAI đối chiếu sản phẩm bằng ID này, không phải bằng tên tệp.
title Tên sản phẩm, bao gồm biến thể đã chọn Nên giới hạn ở 150 ký tự hoặc ít hơn.
description Mô tả thực tế bằng văn bản thuần túy cho sản phẩm này Nên giới hạn ở 5.000 ký tự hoặc ít hơn. Không chèn nội dung quảng cáo sáo rỗng.
url Trang sản phẩm, ưu tiên chọn sẵn biến thể nếu có thể Phải có thể truy cập công khai và ổn định.
brand Thương hiệu như được hiển thị trên trang sản phẩm Không chấp nhận giá trị giữ chỗ.
seller_name Tên người bán mà người dùng sẽ nhìn thấy Bắt buộc ở mọi dòng trong định dạng của OpenAI.
image_url URL JPEG hoặc PNG trực tiếp, hiển thị đúng biến thể này Phải có thể truy cập công khai, không phải trang thư viện ảnh.
availability in_stock, out_of_stock, pre_order, backorder hoặc unknown Giá trị bị thiếu, để trống hoặc không được nhận diện sẽ khiến dòng bị từ chối.
price Giá niêm yết theo dạng 79.99 USD Đơn vị lớn, một khoảng trắng, mã ISO 4217 viết hoa; không dùng dấu phân cách hàng nghìn.

Một bản ghi JSONL hợp lệ trên một dòng có dạng như sau:

{"item_id":"GRIND-HAND-BLK","title":"Hand coffee grinder, matte black","description":"Manual burr grinder with a stainless steel burr and a 30 g glass jar.","url":"https://example.com/products/hand-grinder-black","brand":"Brewline","seller_name":"Brewline Coffee Gear","image_url":"https://example.com/images/hand-grinder-black.jpg","price":"64.00 USD","availability":"in_stock"}

Một lưu ý quan trọng: đặc tả cho biết hướng dẫn về định dạng không đảm bảo mọi giá trị không hợp lệ đều bị từ chối khi tải lên. Tệp tải lên không báo lỗi vẫn có thể chứa dữ liệu sai, vì vậy hãy kiểm tra trước khi gửi, không phải sau đó. Một công cụ kiểm tra đơn giản được cung cấp ở phần bên dưới.

Định dạng tệp, gửi qua SFTP và quy tắc về tệp

Chủ đề Hướng dẫn của OpenAI
Loại feed Ảnh chụp toàn bộ danh mục, được xem là nguồn dữ liệu chính xác
Tần suất Ít nhất mỗi ngày
Phương thức gửi Đẩy đến OpenAI qua SFTP
Định dạng Ưu tiên Parquet (lý tưởng nhất là nén bằng zstd); cũng hỗ trợ jsonl.gz, csv.gz và tsv.gz
Mã hóa UTF-8
Tên tệp Giữ một tên ổn định và ghi đè lên tệp đó ở mỗi lần chạy
Phân mảnh Tối đa 500.000 sản phẩm mỗi shard, tệp nhỏ hơn khoảng 500 MB; giữ nguyên cùng một bộ shard ở mỗi lần cập nhật

Có hai cơ chế cần đặc biệt lưu ý trong thực tế. Thứ nhất, thư mục gốc SFTP đại diện cho toàn bộ danh mục của bạn và không có tệp đánh dấu hoàn tất: OpenAI sẽ xử lý mọi tệp trong thư mục gốc sau khi các tệp ngừng thay đổi trong một khoảng thời gian ngắn. Hãy tải tất cả shard liên tiếp, vì khoảng dừng dài có thể khiến hệ thống xử lý một danh mục chưa hoàn chỉnh (sau đó OpenAI sẽ xử lý lại khi các tệp còn lại được gửi đến). Thứ hai, nếu nhiều feed thương hiệu dùng chung một vị trí, hãy thêm tiền tố thương hiệu vào tên tệp.

Một số hướng dẫn của bên thứ ba mô tả phương thức gửi là HTTPS push. Tổng quan chính thức của OpenAI nêu rõ phương thức là SFTP, vì vậy hãy tuân theo hướng dẫn này và xác nhận chính xác endpoint với OpenAI trong quá trình onboarding.

Phần nặng nhất thường không phải là xuất dữ liệu. Đó là duy trì một danh mục sạch để cấp dữ liệu cho nhiều kênh cùng lúc — đây cũng là lý do việc bàn giao quản lý product feed thường tiết kiệm hơn so với tự duy trì các tập lệnh riêng cho từng kênh.

Biến thể, group ID và kiểm tra GTIN

Gửi một dòng cho mỗi biến thể có thể lựa chọn. Mỗi dòng có item_id riêng, cùng một group_id (phải khác mọi item ID), listing_has_variations=true và một variant_dict chứa các tùy chọn đã chọn. Mỗi dòng có giá, tình trạng còn hàng, URL và hình ảnh riêng.

{"item_id":"TEE-NAVY-M","group_id":"TEE","listing_has_variations":true,"variant_dict":{"color":"Navy","size":"M"},"offer_id":"brewline-TEE-NAVY-M","title":"Cotton tee, navy, size M","description":"Midweight cotton tee.","url":"https://example.com/products/tee-navy-m","brand":"Brewline","seller_name":"Brewline Coffee Gear","image_url":"https://example.com/images/tee-navy.jpg","price":"24.00 USD","availability":"in_stock"}
{"item_id":"TEE-NAVY-L","group_id":"TEE","listing_has_variations":true,"variant_dict":{"color":"Navy","size":"L"},"offer_id":"brewline-TEE-NAVY-L","title":"Cotton tee, navy, size L","description":"Midweight cotton tee.","url":"https://example.com/products/tee-navy-l","brand":"Brewline","seller_name":"Brewline Coffee Gear","image_url":"https://example.com/images/tee-navy.jpg","price":"24.00 USD","availability":"out_of_stock"}

Một số quy tắc thường khiến các đội ngũ mắc lỗi: dùng tên tùy chọn giống hệt nhau trong cùng một nhóm, giữ color hoặc size cấp cao nhất nhất quán với variant_dict vì hệ thống không tự xử lý xung đột giữa chúng, và không bao giờ đưa giá vào offer_id. Custom_variant1_category cùng các cặp tùy chọn kiểu cũ vẫn hoạt động, nhưng không được dùng chung với variant_dict.

Đối với mã định danh, gtin phải có chính xác 8, 12, 13 hoặc 14 chữ số và chữ số kiểm tra hợp lệ; hãy lưu dưới dạng chuỗi để giữ nguyên các số 0 ở đầu. Gửi mpn cùng với brand, và không tự tạo MPN để bù cho GTIN bị thiếu. Công cụ kiểm tra trước khi tải lên dưới đây kiểm tra các trường bắt buộc, giá trị availability, định dạng tiền tệ, chữ số kiểm tra GTIN và ID trùng lặp, sau đó ghi ảnh chụp JSONL được nén bằng gzip:

import gzip
import json
import re

REQUIRED = ("item_id", "title", "description", "url", "brand",
            "seller_name", "image_url", "availability", "price")
AVAILABILITY = {"in_stock", "out_of_stock", "pre_order", "backorder", "unknown"}
PRICE = re.compile(r"^\d+(\.\d+)? [A-Z]{3}$")


def gtin_ok(value):
    if not value.isdigit() or len(value) not in (8, 12, 13, 14):
        return False
    body, check = value[:-1], int(value[-1])
    total = sum(int(d) * (3 if i % 2 == 0 else 1)
                for i, d in enumerate(reversed(body)))
    return (10 - total % 10) % 10 == check


def problems(row):
    out = [f"missing {f}" for f in REQUIRED if not str(row.get(f, "")).strip()]
    if row.get("availability") not in AVAILABILITY:
        out.append("availability would reject the row")
    if not PRICE.match(str(row.get("price", ""))):
        out.append("price must look like 79.99 USD")
    if row.get("gtin") and not gtin_ok(str(row["gtin"])):
        out.append("gtin fails the check digit")
    return out


def write_snapshot(rows, path="products.jsonl.gz"):
    seen, failed = set(), 0
    with gzip.open(path, "wt", encoding="utf-8") as f:
        for row in rows:
            issues = problems(row)
            if row.get("item_id") in seen:
                issues.append("duplicate item_id")
            seen.add(row.get("item_id"))
            if issues:
                failed += 1
                print(row.get("item_id"), issues)
                continue
            f.write(json.dumps(row, ensure_ascii=False) + "\n")
    return failed

Cờ đủ điều kiện tìm kiếm và thanh toán

Trường Mặc định Chức năng
is_eligible_search true nếu không khai báo false loại sản phẩm khỏi khả năng xuất hiện trong tìm kiếm và đồng thời vô hiệu hóa thanh toán. Đủ điều kiện không đảm bảo sản phẩm sẽ được hiển thị.
is_eligible_checkout vô hiệu hóa nếu không khai báo Chỉ bật khi tìm kiếm cũng được đặt là true và thanh toán đã được bật cho integration của bạn. Cần có URL seller_privacy_policy và seller_tos.

Đặt cờ thanh toán không hoàn tất quy trình onboarding thanh toán, vì thanh toán cần một integration được bật riêng. Các bí danh cũ như enable_search và enable_checkout vẫn được chấp nhận, nhưng mỗi giá trị chỉ nên gửi một tên: phiên bản enable_ được ưu tiên hơn phiên bản is_eligible_. Nếu tập lệnh xuất dữ liệu cũ vẫn ghi cả hai, kết quả có thể gây nhầm lẫn.

Ngoài ra, hãy kiểm tra chính sách sản phẩm bị cấm trước khi tải lên. OpenAI loại trừ các danh mục như nội dung người lớn, rượu, nicotine, cờ bạc, vũ khí và thuốc chỉ được kê đơn; đồng thời có thể gỡ sản phẩm hoặc cấm người bán vi phạm chính sách. Hãy lọc các sản phẩm này khỏi feed hoặc đặt khả năng xuất hiện trong tìm kiếm thành false.

Các trường tùy chọn đáng gửi và mặc định chỉ dành cho Hoa Kỳ

Trường Quy tắc Lỗi cần tránh
sale_price Lớn hơn 0, nhỏ hơn nghiêm ngặt so với price, cùng đơn vị tiền tệ Giá khuyến mãi bằng, cao hơn hoặc khác đơn vị tiền tệ sẽ bị bỏ qua.
shipping_price Không âm, cùng đơn vị tiền tệ với giá Bỏ trống có nghĩa là chưa rõ, không phải miễn phí vận chuyển.
accepts_returns, return_deadline_in_days, return_policy Boolean, số ngày nguyên, URL công khai URL chính sách không tự đặt accepts_returns.
review_count, star_rating Chỉ dùng đánh giá sản phẩm, điểm từ 0 đến 5 Không trộn với đánh giá cửa hàng hoặc người bán.
additional_image_urls Mảng trong JSONL, phân tách bằng dấu phẩy trong CSV Mã hóa dấu phẩy bên trong URL theo dạng %2C.

Mặc định theo thị trường là vấn đề cần chú ý. Định dạng tải lên tiêu chuẩn của OpenAI hiện nhắm đến Hoa Kỳ, và các cột cấp dòng như target_countries không thay đổi điều đó. Các thị trường khác cần OpenAI xác nhận integration trước; đơn vị tiền tệ, URL sản phẩm hoặc hệ thống kích cỡ không dùng để chọn thị trường đích. Nếu phần lớn hoạt động bán hàng của bạn diễn ra ngoài Hoa Kỳ, hãy hỏi về khả năng hỗ trợ thị trường trong quá trình onboarding trước khi đầu tư xây dựng feed bản địa hóa.

Tần suất cập nhật feed và cách gỡ sản phẩm

Xuất ảnh chụp toàn bộ danh mục ít nhất mỗi ngày. Sản phẩm không có trong một ảnh chụp đã xử lý sẽ không bị xóa ngay: OpenAI giữ bản ghi đã xử lý gần nhất trong tối đa 14 ngày để tránh việc một shard bị gửi chậm. Điều này dẫn đến hai điểm cần lưu ý. Để gỡ sản phẩm khỏi tìm kiếm ngay ở lần xử lý tiếp theo, hãy đặt is_eligible_search=false. Để xóa bằng cách không gửi sản phẩm, hãy loại sản phẩm đó khỏi mọi shard trong các ảnh chụp toàn bộ danh mục tiếp theo và chờ bản ghi được giữ lại hết hạn trong vòng 14 ngày.

Các trường ngày tháng không lên lịch cho bất kỳ hoạt động nào. Khoảng thời gian khuyến mãi, ngày hết hạn và ngày cập nhật tình trạng không tự động thay đổi giá hoặc tồn kho. Vì vậy, hãy cập nhật giá khi chương trình khuyến mãi bắt đầu và kết thúc, đồng thời cập nhật availability khi sản phẩm hết hàng. Do sản phẩm được đối chiếu bằng item_id, hãy tạo ID từ SKU ổn định hoặc khóa cơ sở dữ liệu, không tạo từ số thứ tự dòng hay slug tiêu đề có thể thay đổi khi ai đó chỉnh sửa tên sản phẩm.

Có thể dùng lại feed Google Merchant Center cho ChatGPT không?

Chỉ khi OpenAI xác nhận định dạng tương thích với Google cho feed đã đăng ký của bạn. Đây là một profile riêng với các quy tắc khác nhau, và định dạng OpenAI được kiểm tra trước; mỗi lần tải lên chỉ áp dụng một định dạng cho toàn bộ tệp.

Khía cạnh Định dạng OpenAI Profile tương thích với Google
Tệp Parquet, jsonl.gz, csv.gz, tsv.gz .txt, .tsv hoặc .csv, có thể nén bằng gzip; không hỗ trợ JSON và XML
Giá trị đặt trước pre_order preorder
Availability unknown Được chấp nhận Không được chấp nhận
Thông tin người bán seller_name trên mọi dòng Tên merchant đã đăng ký; seller_name trong tệp tải lên không thể ghi đè thông tin này
Từ chối tìm kiếm theo từng sản phẩm Được tôn trọng qua is_eligible_search Không được tôn trọng; chỉ tải lên các sản phẩm muốn được khám phá
Mã định danh GTIN và MPN là tùy chọn Cần GTIN hoặc MPN hợp lệ, trừ khi identifier_exists là false

Bài học thực tế là bản xuất từ Google chỉ nên được xem là điểm khởi đầu, không phải tệp có thể dùng ngay. Cách viết preorder, việc thiếu tùy chọn từ chối tìm kiếm và tên người bán đã đăng ký là những khác biệt thường chỉ lộ ra ở giai đoạn cuối.

Lỗi product feed ChatGPT thường gặp và checklist trước khi tải lên

  • Giá sai định dạng. Viết 79.99 USD, không viết 7999 hoặc 79,99.
  • Giá trị availability không hợp lệ. Giá trị không được nhận diện sẽ khiến dòng bị từ chối. Hãy dùng rõ ràng unknown thay vì để trống.
  • Chuỗi giữ chỗ. Không ghi null, n/a hoặc unknown vào các trường tùy chọn. Hãy bỏ qua trường đó.
  • GTIN không hợp lệ. Kiểm tra chữ số và giữ các số 0 ở đầu bằng cách xử lý giá trị dưới dạng chuỗi.
  • Tạo tên tệp mới ở mỗi lần chạy. Thay vào đó, hãy ghi đè lên một tên tệp hoặc bộ shard ổn định.
  • Hai cách biểu diễn phí vận chuyển. Không gửi đồng thời shipping_price và một tuple shipping cho cùng một khoản phí; lưu ý rằng tuple cần được thiết lập riêng theo feed.
  • URL riêng tư hoặc bị chặn. URL sản phẩm và hình ảnh phải có thể truy cập công khai.

Xây dựng và duy trì feed luôn được cập nhật

Được chấp nhận feed một lần là phần dễ dàng. Việc giữ ID ổn định, cập nhật giá và tồn kho, cũng như nhóm biến thể chính xác ở mọi lần cập nhật mới là yếu tố bảo vệ danh sách sản phẩm của bạn theo thời gian. Netalith xây dựng và duy trì product feed cho Google Merchant Center, Meta, Pinterest, Microsoft và OpenAI (ChatGPT). Nếu bạn muốn được đánh giá thêm về danh mục hoặc cần xây dựng feed, hãy yêu cầu báo giá miễn phí và mô tả nền tảng cùng quy mô danh mục của bạn.

CÂU HỎI THƯỜNG GẶP

Câu hỏi thường gặp

Mọi merchant có thể gửi product feed đến ChatGPT không?

Chưa. Tính đến ngày 29 tháng 9 năm 2026, OpenAI cho biết quy trình tích hợp product feed chỉ dành cho các đối tác được phê duyệt; bạn cần đăng ký qua biểu mẫu dành cho merchant tại chatgpt.com/merchants. Trong thời gian chờ, hãy chuẩn bị và kiểm tra dữ liệu của mình.

Nên dùng định dạng tệp nào cho product feed của ChatGPT?

OpenAI ưu tiên Parquet, lý tưởng nhất là được nén bằng zstd. Ngoài ra, hệ thống hỗ trợ jsonl.gz, csv.gz và tsv.gz. Tất cả tệp phải dùng UTF-8; JSONL thường là lựa chọn dễ triển khai nhất cho danh mục nhỏ và vừa.

Bao lâu nên cập nhật product feed ChatGPT một lần?

Hãy gửi ảnh chụp toàn bộ danh mục ít nhất mỗi ngày và ghi đè lên cùng một tên tệp ở mỗi lần gửi. Hướng dẫn Get Started của OpenAI cũng khuyến nghị đẩy các cập nhật trong ngày qua API nếu giá hoặc tồn kho thay đổi nhanh.

Tải feed lên có đảm bảo sản phẩm xuất hiện trong ChatGPT không?

Không. Đủ điều kiện không đảm bảo sản phẩm sẽ được hiển thị. Feed giúp sản phẩm đủ điều kiện xuất hiện; việc ChatGPT có hiển thị hay không còn phụ thuộc vào truy vấn, chất lượng và mức độ phù hợp của dữ liệu.

Làm thế nào để gỡ một sản phẩm khỏi product feed ChatGPT?

Đặt is_eligible_search thành false để sản phẩm không còn đủ điều kiện ở lần xử lý ảnh chụp tiếp theo, hoặc loại sản phẩm khỏi mọi shard trong các ảnh chụp toàn bộ danh mục sau đó. OpenAI giữ bản ghi đã xử lý gần nhất trong tối đa 14 ngày, vì vậy gỡ bằng cách không gửi sản phẩm sẽ không có hiệu lực ngay lập tức.

Có cần GTIN để thiết lập product feed ChatGPT không?

Trong định dạng OpenAI, GTIN và MPN là tùy chọn. Nếu gửi GTIN, mã này phải hợp lệ, có 8, 12, 13 hoặc 14 chữ số và chữ số kiểm tra chính xác. Không tự tạo MPN để bù cho GTIN bị thiếu. Profile tương thích với Google yêu cầu GTIN hoặc MPN hợp lệ, trừ khi identifier_exists là false.

Có thể dùng feed Google Merchant Center cho ChatGPT không?

Chỉ khi OpenAI xác nhận định dạng tương thích với Google cho feed đã đăng ký của bạn. Các quy tắc có sự khác biệt so với định dạng OpenAI: preorder được viết khác, availability unknown bị từ chối và tên người bán được lấy từ tên merchant đã đăng ký.

Cập nhật cùng Netalith

Nhận kiến thức công nghệ, cập nhật sản phẩm và ưu đãi đặc biệt qua email.