Lỗi feed danh mục Facebook: Ý nghĩa và cách khắc phục
Giải thích lỗi feed danh mục Facebook: fatal và cảnh báo, cách sửa lỗi giá, tồn kho, hình ảnh, ID trùng lặp cùng script kiểm tra trước khi tải lên.
Long Nguyen
Lập trình viên Fullstack · Kỹ sư AI · Nhà nghiên cứu
Fatal và cảnh báo: lỗi feed danh mục Facebook nào khiến sản phẩm bị chặn?
API của Meta phân loại mọi lỗi tải lên thành hai mức độ. Lỗi fatal có nghĩa là sản phẩm bị ảnh hưởng sẽ không được tạo. Lỗi warning nghĩa là sản phẩm vẫn được tạo và lỗi chỉ mang tính thông báo.
Chi tiết nhiều người dễ bỏ qua là lỗi fatal được xử lý theo từng dòng. Theo tài liệu tham chiếu lỗi tải product feed của Meta, những sản phẩm trong cùng một tệp không có lỗi vẫn được tạo, ngay cả khi các dòng khác gặp lỗi fatal.
Điều này dẫn đến một cách chẩn đoán thực tế. Nếu chỉ thiếu một vài sản phẩm, hãy tìm các lỗi fatal ở cấp dòng. Nếu toàn bộ sản phẩm đều biến mất, gần như chắc chắn bạn đang gặp vấn đề mang tính hệ thống, chẳng hạn tên cột sai hoặc cột được ánh xạ nhầm sang thuộc tính khác, khiến mọi dòng cùng lúc trở thành lỗi fatal.
Cảnh báo không có nghĩa là sản phẩm đã chính xác. Nó chỉ cho biết sản phẩm vẫn tồn tại. Tôi vẫn xem cảnh báo về giá là lỗi cần xử lý ngay, vì một sản phẩm đang hiển thị với giá bị đọc sai trong quảng cáo có thể gây thiệt hại lớn hơn một sản phẩm bị thiếu.
Tìm lỗi feed danh mục Facebook ở đâu?
Trong Commerce Manager, hãy bắt đầu từ tab Issues của catalog để xem vấn đề ở từng sản phẩm, rồi kiểm tra lịch sử tải lên của nguồn dữ liệu để xem kết quả của từng lần chạy feed. Với catalog nhỏ, như vậy là đủ. Với catalog lớn hơn, API cung cấp chính xác dòng và cột bị lỗi.
| Thông tin cần tìm | Lệnh gọi | Kết quả trả về |
|---|---|---|
| Các phiên tải lên gần đây | GET /{feed-id}/uploads |
ID phiên tải lên |
| Lỗi của một lần tải lên | GET /{upload-id}/errors |
summary, description, severity, row_number, column_number, id cùng tổng số lỗi |
| Chỉ lấy các lỗi chặn sản phẩm | error_priority=HIGH trong cùng lệnh gọi |
Chỉ trả về lỗi fatal. MEDIUM và LOW sẽ trả về các cảnh báo |
| Danh sách có thể tải xuống | POST /{upload-id}/error_report |
Tệp CSV sau khi trạng thái chuyển thành WRITE_FINISHED. Báo cáo cũ hơn 30 ngày sẽ hiển thị ERROR_REPORT_OUTDATED |
| Đề xuất cách sửa | GET /{error-id}/suggested_rules |
Đề xuất rule tự động cho lỗi đó |
curl -G "https://graph.facebook.com/v26.0/UPLOAD_ID/errors" \
-d "error_priority=HIGH" \
-d "access_token=YOUR_TOKEN"
Hãy sử dụng phiên bản Graph API đang hiện hành tại thời điểm bạn chạy lệnh. Ví dụ trong tài liệu tại thời điểm viết bài dùng v26.0. Giá trị của row_number và column_number giúp bạn đi thẳng đến ô bị lỗi thay vì phải tự dò sản phẩm bằng mắt.
Những lỗi feed phổ biến nhất và cách khắc phục
Phần lớn lỗi feed bắt nguồn từ một nhóm nhỏ các trường bắt buộc. Các định dạng dưới đây dựa trên tài liệu tham chiếu trường catalog của Meta.
| Hiện tượng | Nguyên nhân thường gặp | Cách khắc phục |
|---|---|---|
| Price Without Currency (cảnh báo) | Giá được xuất dưới dạng 9.99 hoặc 45$ |
Dùng số, một khoảng trắng rồi đến mã ISO gồm 3 chữ cái: 9.99 USD. Dùng dấu chấm làm dấu thập phân, không dùng dấu phẩy |
| Giá trị availability không hợp lệ | Nền tảng xuất InStock, in_stock hoặc từ đã được dịch |
Dùng chính xác in stock hoặc out of stock. Sản phẩm hết hàng vẫn hợp lệ và sẽ hiển thị là đã bán hết trong cửa hàng |
| Giá trị condition không hợp lệ | Bỏ trống hoặc dùng từ địa phương hóa như Neu |
Dùng new, refurbished hoặc used |
| ID trùng lặp | Dùng ID sản phẩm cha cho mọi biến thể hoặc liệt kê cùng một SKU hai lần | Mỗi content ID chỉ được xuất hiện một lần trong catalog, tối đa 100 ký tự. Dùng SKU của biến thể thay vì ID sản phẩm cha |
| Hình ảnh bị từ chối hoặc không cập nhật | Sai định dạng, quá nhỏ, quá lớn hoặc tệp đã được thay thế tại cùng URL | Dùng JPEG hoặc PNG, tối thiểu 500 x 500 pixel và dưới 8 MB. Hình ảnh thay đổi phải dùng URL mới |
| Link không hợp lệ | Thiếu protocol, chuyển hướng đến domain của Facebook hoặc dùng URL staging | Bắt đầu bằng http:// hoặc https:// và trỏ đến trang sản phẩm thật trên domain của bạn |
| Lỗi mô tả | Có thẻ HTML, toàn bộ chữ viết hoa hoặc chứa liên kết trong nội dung | Chỉ dùng văn bản thuần, tối đa 9.999 ký tự, không có liên kết và không viết toàn bộ bằng chữ hoa |
| Lỗi tiêu đề | Tiêu đề dài hơn 200 ký tự hoặc giống hệt mô tả | Giữ tiêu đề cụ thể và khác với phần mô tả. Meta khuyến nghị tối đa 65 ký tự |
| Thiếu size (fatal đối với Shop) | Sản phẩm thời trang hoặc giày dép được xuất mà không có size | Size là trường bắt buộc tùy trường hợp: cần có khi bán hàng trên Shop ở các danh mục như quần áo và giày dép. Viết có khoảng trắng, chẳng hạn US 12 |
| Group Mismatch for Property (fatal) | Meta liệt kê đây là lỗi fatal; trang tài liệu nêu tên lỗi nhưng không giải thích | Theo cách tôi hiểu, lỗi này liên quan đến các biến thể được nhóm với dữ liệu thuộc tính không nhất quán. Hãy kiểm tra cách item_group_id nhóm các biến thể |
Hai lỗi trong số này thường bị bỏ qua. Lỗi về giá và availability gần như luôn là vấn đề định dạng trong tệp xuất, không phải dữ liệu trong cửa hàng. Chỉ cần sửa mẫu xuất một lần là cả nhóm lỗi sẽ biến mất. Ngược lại, ID trùng lặp bắt nguồn từ cách cửa hàng mô hình hóa các biến thể, vì vậy chỉnh sửa tệp chỉ che giấu vấn đề cho đến lần đồng bộ tiếp theo.
Cách sửa hàng loạt lỗi feed bằng data feed rules
Khi không thể thay đổi nguồn dữ liệu, Commerce Manager có thể viết lại các giá trị trong quá trình tiếp nhận dữ liệu. Tài liệu xử lý sự cố feed của Meta mô tả ba loại rule.
- Mapping rules sửa tên thuộc tính, chẳng hạn một cột bị viết sai khiến Meta đọc thành trường khác.
- Value mapping rules chuyển đổi các giá trị không được nhận diện:
InStockthànhin stock,45$thành45.00 USD,Neuthànhnew. - Letter case rules chuẩn hóa kiểu chữ, chẳng hạn chuyển tiêu đề viết toàn bộ bằng chữ hoa thành kiểu viết hoa phù hợp.
Với API, quy trình là đọc các lỗi của một lần tải lên, sau đó gọi endpoint suggested-rules cho error ID để nhận rule được đề xuất.
Nguyên tắc của tôi là: hãy sửa tại nguồn nếu bạn kiểm soát trình tạo feed, và dùng feed rules khi feed đến từ plugin hoặc nền tảng mà bạn không thể chỉnh sửa. Rule có hiệu quả, nhưng đây là logic ẩn. Sáu tháng sau, không ai còn nhớ một rule đang viết lại availability, và khi nguồn dữ liệu thay đổi định dạng, rule có thể âm thầm không còn khớp. Nếu bạn vận hành nhiều feed trên nhiều kênh, đây chính là kiểu sai lệch mà dịch vụ quản lý product feed được thiết kế để loại bỏ: một mẫu feed sạch, sau đó xuất riêng cho từng kênh.
Sản phẩm vẫn thiếu hoặc không khớp sau khi tải lên không còn lỗi
Một lần tải lên không có lỗi fatal vẫn có thể để lại catalog không hoạt động đúng trong quảng cáo. Nguyên nhân thường gặp là ID không khớp, chứ không phải lỗi định dạng.
Hướng dẫn của Meta về các sản phẩm catalog bị thiếu tập trung vào ba điểm kiểm tra:
- Content ID trong các sự kiện Pixel hoặc ứng dụng phải khớp với ID trong feed.
- Pixel phải được liên kết với catalog.
- Sản phẩm đó thực sự phải tồn tại trong feed.
Lỗi kinh điển xảy ra khi cửa hàng gửi ID sản phẩm cha trong các sự kiện Pixel, còn feed lại dùng SKU của biến thể. Khi đó, mọi sự kiện đều trỏ đến một ID không tồn tại trong catalog. Hãy thống nhất một quy tắc ID, áp dụng cho cả feed và các sự kiện, rồi kiểm tra trên một vài trang sản phẩm thực tế trước khi tin dùng bất kỳ quảng cáo động nào.
Kiểm tra feed trước khi Meta kiểm tra
Phát hiện lỗi trước khi tải lên giúp bạn tránh một lần chạy thất bại và thời gian chờ đến lần lấy dữ liệu theo lịch tiếp theo. Script này kiểm tra feed CSV theo các quy tắc trong tài liệu tham chiếu trường ở trên. Script không cần dependency.
import csv
import re
import sys
from collections import Counter
PRICE = re.compile(r'^\d+(\.\d+)?\s[A-Z]{3}$')
AVAILABILITY = {'in stock', 'out of stock'}
CONDITION = {'new', 'refurbished', 'used'}
def check(path):
with open(path, newline='', encoding='utf-8') as f:
rows = list(csv.DictReader(f))
id_counts = Counter(r.get('id', '').strip() for r in rows)
problems = []
for line, r in enumerate(rows, start=2): # line 1 is the header
pid = r.get('id', '').strip()
if not pid or len(pid) > 100:
problems.append((line, 'id', 'missing or over 100 characters'))
elif id_counts[pid] > 1:
problems.append((line, 'id', 'duplicate id ' + pid))
if not PRICE.match(r.get('price', '').strip()):
problems.append((line, 'price', 'expected 9.99 USD format'))
if r.get('availability', '').strip() not in AVAILABILITY:
problems.append((line, 'availability', 'use in stock / out of stock'))
if r.get('condition', '').strip() not in CONDITION:
problems.append((line, 'condition', 'use new / refurbished / used'))
if not r.get('link', '').startswith(('http://', 'https://')):
problems.append((line, 'link', 'must start with http(s)://'))
if not r.get('image_link', '').startswith(('http://', 'https://')):
problems.append((line, 'image_link', 'must be a full URL'))
title = r.get('title', '').strip()
if not title or len(title) > 200:
problems.append((line, 'title', 'empty or over 200 characters'))
if title and title == r.get('description', '').strip():
problems.append((line, 'title', 'identical to description'))
for line, column, message in problems:
print('row ' + str(line) + ' | ' + column + ' | ' + message)
print(str(len(problems)) + ' problem(s) in ' + str(len(rows)) + ' rows')
return len(problems)
if __name__ == '__main__':
sys.exit(1 if check(sys.argv[1]) else 0)
Nếu phiên bản feed spec của bạn chấp nhận thêm giá trị, hãy mở rộng tập AVAILABILITY. Phần kiểm tra hình ảnh được cố ý giữ ở mức cơ bản: chỉ xác nhận URL tồn tại, không kiểm tra tệp có phải JPEG hoặc PNG và có kích thước tối thiểu 500 x 500 pixel hay không. Nếu muốn xác minh điều đó, bạn có thể thêm một HEAD request.
Khi cùng một lỗi feed liên tục quay lại
Các lỗi lặp lại sau khi bạn đã sửa tệp thường cho thấy vấn đề nằm ở hệ thống phía trên: mẫu xuất liên tục tạo lại giá trị sai sau mỗi lần đồng bộ, mô hình biến thể tạo ID trùng lặp hoặc nhiều kênh cùng lấy dữ liệu từ một bảng tính không được duy trì. Sửa từng dòng trong mỗi lần tải lên sẽ không giải quyết được nguyên nhân.
Nếu muốn có người truy tìm và khắc phục vấn đề ngay tại nguồn, hãy gửi yêu cầu báo giá miễn phí cho Netalith kèm URL feed hoặc mẫu các lỗi bạn đang gặp.
CÂU HỎI THƯỜNG GẶP
Câu hỏi thường gặp
Tại sao catalog Facebook báo lỗi nhưng sản phẩm của tôi vẫn hiển thị?
Meta chia lỗi thành fatal và warning. Lỗi fatal khiến sản phẩm bị ảnh hưởng không được tạo. Cảnh báo, chẳng hạn giá không có mã tiền tệ, vẫn tạo sản phẩm và chỉ mang tính thông báo. Lỗi fatal cũng áp dụng theo từng dòng, vì vậy những sản phẩm không có lỗi trong cùng tệp vẫn được tạo.
“Price Without Currency” nghĩa là gì và sửa thế nào?
Giá chưa có mã tiền tệ. Meta yêu cầu một con số, một khoảng trắng và mã tiền tệ ISO gồm ba chữ cái, chẳng hạn 9.99 USD, với dấu chấm làm dấu thập phân. Hãy sửa mẫu xuất để mọi giá đều được ghi theo định dạng này.
Làm thế nào để sửa ID trùng lặp trong product feed Facebook?
Mỗi content ID chỉ được xuất hiện một lần trong catalog và có tối đa 100 ký tự. Hãy dùng một giá trị duy nhất cho từng sản phẩm có thể bán, tốt nhất là SKU của biến thể, thay vì lặp ID sản phẩm cha cho mọi biến thể.
Có thể sửa lỗi feed mà không chỉnh sửa tệp nguồn không?
Có, trong một số trường hợp. Data feed rules trong Commerce Manager có thể ánh xạ tên thuộc tính, chuyển các giá trị không được nhận diện như InStock thành in stock và thay đổi kiểu chữ. Đây là giải pháp tạm thời cho feed mà bạn không thể chỉnh sửa, nên sửa tại nguồn vẫn là lựa chọn bền vững hơn.
Có thể tải báo cáo lỗi của lần tải feed lên trong bao lâu?
Bạn yêu cầu báo cáo qua endpoint error_report của lần tải lên và tải tệp CSV xuống khi trạng thái là WRITE_FINISHED. Báo cáo cũ hơn 30 ngày sẽ được đánh dấu ERROR_REPORT_OUTDATED, vì vậy hãy yêu cầu báo cáo mới từ một lần tải lên gần đây.
Sản phẩm hết hàng có phải là lỗi feed không?
Không. out of stock là một giá trị availability hợp lệ. Những sản phẩm này vẫn nằm trong catalog và hiển thị là đã bán hết trong các cửa hàng.