Tìm sản phẩm và ưu đãi được quảng cáo trên Meta.

Kiểm soát chi phí: trước mỗi lệnh gọi Spytrend có phí, hãy chạy `estimate_cost` miễn phí với cùng công cụ và tham số, ước tính chi phí và giữ trong ngân sách mà người dùng đã nêu; nếu người dùng chưa nêu ngân sách, hãy báo ước tính cho họ trước lệnh gọi có phí đầu tiên. Nếu cần sự đồng ý về giá, hãy hiển thị các điều khoản được trả về và dừng lại cho đến khi khách hàng đồng ý rõ ràng; không bao giờ tự đồng ý thay khách hàng. Nếu một lệnh gọi bắt buộc không nằm trong ngân sách đã nêu, không thực hiện lệnh gọi có phí đó và trả về `Budget limit prevents required research`; bỏ qua một lệnh gọi không bắt buộc nếu không nằm trong ngân sách và nêu rõ việc giảm phạm vi bao phủ. Khi mở quảng cáo bằng `get_ad`, bỏ qua các quảng cáo đa ngôn ngữ (`is_multilang`) và không bao giờ gọi `get_media` sau `get_ad`. Chỉ thử lại một lần khi `retryable=true`, sau `retry_after_seconds`. Đọc `params.ignored` sau mỗi lượt tìm kiếm; một bộ lọc bắt buộc bị bỏ qua không bao giờ được tính là đã áp dụng. Nếu một lượt tìm kiếm báo `pagination.total_status=restricted` (khung lưu trữ của gói miễn phí; `meta.plan_window_cutoff` nêu rõ ranh giới), hãy báo cho người dùng rằng kết quả chỉ bao gồm các quảng cáo bắt đầu vào hoặc trước ngày đó, và không bao giờ báo cáo số 0 từ đó là "không có quảng cáo như vậy". Thông báo chi phí không thuộc báo cáo cuối cùng cho khách hàng.
Sử dụng Spytrend MCP đã kết nối để chuẩn bị một bảng điều khiển (dashboard) hướng đến khách hàng, hoàn chỉnh, về các sản phẩm cụ thể và nhóm ưu đãi hiện đang được quảng cáo trên Meta trong danh mục, quốc gia và khoảng thời gian xem lại lưu trữ đã kiểm soát được cung cấp.

Thực hiện mọi giai đoạn nghiên cứu trong prompt này trong một lượt duy nhất. Ngoài các thông báo chi phí bắt buộc trước mỗi lệnh gọi, không phát ra phản hồi bước trung gian và không dừng lại sau khi xác thực. Chỉ dừng sớm khi đầu vào không hợp lệ, bằng chứng bắt buộc không có sẵn, hoặc danh tính bắt buộc chưa được xác định. Chỉ trả về báo cáo cuối cùng cho khách hàng.

Đơn vị kết quả là một nhóm sản phẩm hoặc ưu đãi đã xác minh, không phải một quảng cáo riêng lẻ, danh sách nhà quảng cáo, bộ sưu tập cảm hứng sáng tạo, bảng xếp hạng hiệu suất hay một cuộc điều tra thị trường đầy đủ. Hướng tới 3–5 nhóm sản phẩm đã xác minh.

Cấu hình đã chọn:
- Danh mục: Ecommerce and Retail | ai_category=ecommerce_and_retail
- Danh mục con: Electronics and Gadgets | ai_subcategory=electronics_and_gadgets
- Quốc gia (ISO-2): US
- Khoảng thời gian xem lại: 30 ngày UTC đã hoàn tất
- Nguồn/trạng thái: Meta / đang hoạt động hiện tại
- Sản phẩm/thực thể được phép: sản phẩm cụ thể từ các thương hiệu và người bán trực tiếp khớp với danh mục đã chọn (và danh mục con nếu có chọn)
- Sản phẩm/thực thể bị loại trừ: dịch vụ, nhà xuất bản, đại lý, ưu đãi mơ hồ, sản phẩm nằm ngoài danh mục/danh mục con đã chọn và các thực thể chưa xác định rõ
- Giới hạn: hai hướng khám phá với năm dòng mỗi hướng; tối đa sáu chi tiết quảng cáo ban đầu; một hướng mở rộng nhóm sản phẩm có điều kiện với ba dòng và một chi tiết quảng cáo bổ sung; không lấy chi tiết nhà quảng cáo; 3–5 nhóm sản phẩm trong câu trả lời

Giá trị danh mục có dạng `Name | ai_category=<slug>` và giá trị danh mục con có dạng `Name | ai_subcategory=<slug>` (slug `none` = không có danh mục con). Chỉ sử dụng các slug này trong lệnh gọi công cụ; trong mọi dòng hướng đến khách hàng, chỉ dùng tên thường trước `|` và tên đầy đủ của quốc gia. Không chấp nhận bất kỳ truy vấn, từ đồng nghĩa, thương hiệu, ngưỡng, danh mục, quốc gia hay khoảng thời gian xem lại thay thế nào do khách hàng viết.

Sử dụng ngày UTC hiện tại do môi trường trả về. Loại trừ ngày UTC hiện tại còn đang mở. Tính khung thời gian: 30 ngày UTC đã hoàn tất gần nhất, kết thúc vào hôm qua, và hiển thị cả hai ngày này trong Research coverage.

Coi quốc gia đã chọn là bằng chứng quốc gia phân phối quảng cáo được trả về. Nó không chứng minh trụ sở nhà quảng cáo, đăng ký kinh doanh, hàng tồn kho tại địa phương, vận chuyển, khách hàng, doanh số hay vị thế thống lĩnh ở quốc gia đó.

Chỉ sử dụng Spytrend ở chế độ chỉ đọc.

Coi search_ads và mọi công cụ tìm kiếm/khám phá là lệnh gọi nặng. Chỉ chạy đúng một lệnh gọi nặng tại một thời điểm, chờ phản hồi của nó, và không bao giờ gộp lô, chạy song song hay dùng Promise.all cho các lệnh gọi nặng.

Kiểm tra schema trực tiếp của search_ads. Chạy đúng hai lệnh gọi search_ads tuần tự với source=`meta`, categories=[slug ai_category từ Ecommerce and Retail | ai_category=ecommerce_and_retail], countries=[`US`], date_from và date_to = ngày đầu và ngày cuối của khung thời gian đã tính, status_today=`active`, dedupe=false và limit=5. Thêm ai_subcategory=[slug ai_subcategory từ Electronics and Gadgets | ai_subcategory=electronics_and_gadgets] bất cứ khi nào slug đó không phải là `none`; chỉ bỏ qua khi nó chính xác là `none`.

Không bao giờ bỏ một danh mục con đã cấu hình để khắc phục lỗi bị endpoint từ chối. Nếu endpoint từ chối cặp danh mục/danh mục con đã cấu hình, không thực hiện lệnh gọi khám phá rộng hơn và trả về một kết quả Partial ngắn gọn nêu rõ `Unsupported controlled category mapping`. Điều này cho thấy một lỗi allowlist ở backend. Không thay thế bằng một danh mục, danh mục con hay truy vấn khác.

Hướng A dùng sort_by=`date`, sort_order=`desc`. Hướng B dùng sort_by=`most_reused_creative` được Meta hỗ trợ, sort_order=`desc`. Không thay bằng `days_active`. Không thêm truy vấn, thương hiệu, domain, loại media, danh mục con chưa cấu hình hay từ đồng nghĩa tự tạo.

Áp dụng các bộ lọc ngày theo đúng ngữ nghĩa schema/response đã kết nối. Không khẳng định mọi quảng cáo trả về đều ra mắt trong khung thời gian trừ khi bằng chứng ngày bắt đầu tự nó chứng minh điều đó. Câu chữ hướng đến khách hàng nên nói rằng các quảng cáo được quan sát trong hoặc trùng với khung thời gian lưu trữ đã chọn.

Loại trùng các dòng theo ID quảng cáo chính xác. Giữ nguyên thứ tự của Hướng A, theo sau là các dòng chưa xuất hiện của Hướng B. Chỉ loại bỏ tại chỗ các xung đột phạm vi kiểm soát rõ ràng. Không bao giờ chọn một dòng chỉ vì thương hiệu quen thuộc.

Kiểm tra tối đa sáu quảng cáo ứng viên riêng biệt theo thứ tự tuần tự bằng get_ad(source=`meta`, id=<exact returned ID>), xen kẽ các hướng khám phá khi khác nhau, bỏ qua các dòng đa ngôn ngữ (`is_multilang`) và chỉ khi mỗi ước tính nằm trong ngân sách đã nêu. Ngừng mở khi đã xác minh được năm nhóm sản phẩm. Ưu tiên bằng chứng sản phẩm rõ ràng và sự đa dạng giữa các hướng. Không mở các dòng yếu chỉ để lấp đầy kết quả. Nếu một chi tiết tiếp theo không nằm trong ngân sách, hãy bỏ qua, công bố việc giảm phạm vi bao phủ và giữ lại bằng chứng đã xác minh trước đó.

Không gọi get_advertiser ở chế độ chuẩn. Chỉ hiển thị tên nhà quảng cáo khi get_ad trả về rõ ràng; không bao giờ suy ra tên từ tiêu đề, trang, domain hay URL. Nếu không, ghi `Advertiser not returned`.

Một nhóm sản phẩm/ưu đãi là cùng một sản phẩm, dòng sản phẩm, gói combo hoặc ưu đãi dịch vụ có thể nhận diện được. Chỉ gộp các dòng khi tên/mẫu sản phẩm, route đích/SKU, câu chữ ưu đãi rõ ràng hoặc một định danh ổn định tương đương chứng minh cùng danh tính. Sự tương đồng về danh mục, hình ảnh, một nhà quảng cáo hay một domain riêng lẻ là chưa đủ.

Giữ riêng các mẫu, gói combo, kích cỡ, mục đích sử dụng, giá hoặc ưu đãi dịch vụ khác biệt đáng kể nếu chúng làm thay đổi quyết định mua hàng. Chỉ nhóm các biến thể nhỏ khi dòng sản phẩm chung là rõ ràng. Không bao giờ suy luận việc thuộc cùng một nhóm sản phẩm từ một hình ảnh bạn không thể kiểm tra.

Sau khi xác minh ban đầu, nếu chưa nhóm sản phẩm nào có hai quảng cáo đã kiểm tra và xác minh, có ít nhất một nhóm sản phẩm đã xác minh có domain đích chính xác được trả về, và việc mở rộng cộng với một chi tiết khả dĩ vẫn nằm trong ngân sách còn lại, hãy chạy tối đa một lệnh gọi `search_ads` mở rộng nhóm sản phẩm có điều kiện cho nhóm sản phẩm đủ điều kiện được xếp hạng cao nhất. Giữ nguyên source, category, subcategory đã cấu hình, country, khung ngày, trạng thái active và `dedupe=false`; chỉ thêm `landing_domain=<exact returned registrable domain>`, `landing_domain_exact=true`, `sort_by=date`, `sort_order=desc` và `limit=3`. Không chạy lại bất kỳ hướng khám phá ban đầu nào và không mở rộng một danh tính domain yếu hoặc xung đột.

Mở tối đa một dòng mở rộng chưa được kiểm tra trước đó bằng `get_ad` khi ước tính của nó vẫn nằm trong ngân sách. Chỉ gộp khi chi tiết chứng minh cùng sản phẩm/mẫu, route/SKU hoặc ưu đãi rõ ràng tương đương. Một domain, trang hay mẫu quảng cáo chung là chưa đủ. Mức trần tổng chi tiết quảng cáo là bảy: sáu chi tiết ban đầu cộng một chi tiết mở rộng có điều kiện. Nếu việc mở rộng trả về một sản phẩm khác, loại trừ nó mà không thay thế hay mở rộng thêm.

Chỉ phân loại một nhóm sản phẩm là Verified (đã xác minh) khi bằng chứng của lượt chạy hiện tại xác lập được một sản phẩm/ưu đãi cụ thể đủ điều kiện, US nằm trong các quốc gia phân phối được trả về, trạng thái hoạt động được trả về, có trùng khung lưu trữ theo ngữ nghĩa của hướng tìm kiếm, nhà quảng cáo/trang có thể nhận diện hoặc tên bị thiếu được công bố rõ ràng, điểm đến khi được trả về, và ít nhất một quảng cáo bằng chứng đại diện.

Loại trừ nhận diện thương hiệu mơ hồ, ngôn ngữ chỉ mang tính danh mục, nội dung biên tập, việc làm, đầu tư, chợ trực tuyến/nhà bán lẻ chung không có sản phẩm cụ thể đủ điều kiện, các sản phẩm/thực thể bị loại trừ, các kết quả khớp taxonomy không liên quan và danh tính sản phẩm chưa được xác định.

Chỉ đếm `active ads in inspected sample` từ các dòng quảng cáo riêng biệt, đã xác minh, được trả về và thuộc nhóm sản phẩm đó. Chỉ đếm số nhà quảng cáo/trang từ các danh tính riêng biệt, đã xác minh trong mẫu đã kiểm tra. Gán nhãn cả hai là số liệu mẫu. Chỉ hiển thị số lượng quảng cáo đính kèm/tái sử dụng lớn hơn khi nó được trả về rõ ràng cho đúng nhóm sản phẩm đã xác minh, và giữ phạm vi tính của nó riêng biệt.

Chuẩn hóa tài nguyên thực tế được phân phối chỉ thành `Image`, `Video`, `Image and video` hoặc `Not returned`. Nhiều tài nguyên không chứng minh đó là Carousel, slideshow hay một vị trí hiển thị cụ thể. Không liệt kê vị trí hiển thị trên nền tảng trừ khi khách hàng yêu cầu rõ ràng.

Trước khi dùng bất kỳ trường creative chính xác hay tái sử dụng nào trong xếp hạng, hãy so sánh mọi số liệu được trả về cho creative đó. Nếu các số liệu xung đột hoặc phạm vi tính của chúng không thể đối chiếu được, loại tất cả các số liệu tái sử dụng xung đột đó ra khỏi xếp hạng. Trong câu trả lời cho khách hàng, hãy nói `Additional creative-reuse counts were returned with unreconciled scopes` mà không kèm số liệu, hoặc bỏ qua chúng. Không bao giờ giải quyết xung đột bằng cách chọn giá trị lớn hơn, mới hơn hay ở cấp hướng tìm kiếm.

Việc ra mắt lại cần ít nhất hai quảng cáo riêng biệt đã xác minh cho cùng một nhóm sản phẩm với các ngày bắt đầu rõ ràng khác nhau. Việc mở rộng gần đây cần các số liệu chuỗi thời gian rõ ràng có thể so sánh được. Không suy luận điều này từ các dòng chưa xác minh, tổng số lưu trữ hay một quảng cáo đại diện gần đây.

Xếp hạng tối đa năm nhóm sản phẩm theo: số quảng cáo đang hoạt động riêng biệt trong mẫu đã kiểm tra; số nhà quảng cáo/trang riêng biệt được trả về, với độ tin cậy danh tính được giữ riêng; số lần tái sử dụng chính xác của nhóm sản phẩm được trả về rõ ràng; thời gian hoạt động/ngày bắt đầu được trả về; sau đó là mức độ phù hợp trực tiếp với danh mục. Chỉ dùng bằng chứng có thể so sánh được, giữ nguyên trạng thái đồng hạng và không bao giờ tự tạo ra điểm số.

Khi tất cả các tín hiệu hoạt động có thể so sánh đều đồng hạng, giữ nguyên thứ tự khám phá và xác minh. Giữ trạng thái đồng hạng rõ ràng, nhưng dùng các vị trí hiển thị và số thứ tự phần liên tiếp, duy nhất để khách hàng có thể điều hướng kết quả. Thay câu xếp hạng chuẩn bằng: `Ordered by discovery and verification sequence because the comparable inspected activity signals were tied.` Không ngụ ý rằng các dòng xuất hiện trước có hiệu suất tốt hơn.

Không gọi search_creatives, get_creative, get_trends, search_shops, get_shop, search_webmasters, analytics hay các công cụ web ngoài. Chỉ thử lại đúng một lần khi retryable=true kèm retry_after_seconds, sau một ước tính mới giống như trước. Một hướng khám phá cốt lõi thất bại hoặc một lệnh gọi xác minh ban đầu đã chọn bị thất bại sẽ khiến lượt chạy là Partial; tiếp tục phần công việc tuần tự bắt buộc còn lại. Một chi tiết đã hoàn tất mà ứng viên không đạt điều kiện là bằng chứng loại trừ hợp lệ và không khiến lượt chạy là Partial. Việc trả về ít hơn ba nhóm sản phẩm không tự nó là Partial; hãy nêu rõ vì sao xác minh được ít hơn. Một lượt mở rộng không bắt buộc đã hoàn tất mà trả về số 0, một bản trùng hoặc một sản phẩm khác là bằng chứng hợp lệ và vẫn giữ lượt chạy đang là Complete là Complete. Một lượt mở rộng có điều kiện bị thất bại không làm mất hiệu lực các nhóm sản phẩm đã xác minh hay khiến một lượt chạy đang là Complete trở thành Partial; công bố điều đó như một khoảng trống bằng chứng tổng hợp không bắt buộc.

Chỉ hiển thị một liên kết first-party ổn định được trả về rõ ràng dưới dạng `Evidence`. Nếu không, chỉ hiển thị một ID bằng chứng nguồn ổn định khi nó được trả về rõ ràng như vậy. Không bao giờ nêu tên dịch vụ trong câu trả lời cho khách hàng, không tự tạo URL hay để lộ UUID nội bộ, JSON thô, URL media đã ký, thông tin đăng nhập, hạn mức, chi tiết schema hay các dòng bị loại. Giữ các slug taxonomy, mã ISO, tên route, tên công cụ, tên tham số thô và tên trường thô ngoài câu trả lời cho khách hàng. Dịch bằng chứng được trả về sang ngôn ngữ khách hàng thông thường: ví dụ, nói `returned active duration` thay vì `days_active`, và `domain-associated entity` thay vì `webmaster`. Nếu không có cả liên kết và ID bằng chứng nguồn ổn định nào được trả về, hãy ghi `Evidence reference not returned`.

Gán lợi ích sản phẩm, giá, giảm giá, đánh giá và số lượng khách hàng cho tuyên bố của nhà quảng cáo. Không bao giờ gọi một sản phẩm là có lợi nhuận, bán chạy nhất, chuyển đổi cao, thắng thế, đang tăng trưởng (scaling), phổ biến hay dẫn đầu thị trường. Không bao giờ suy luận về chi tiêu, phạm vi tiếp cận, tương tác, chuyển đổi, doanh số, doanh thu, ROAS hay lợi nhuận.

Sử dụng một bảng điều khiển (dashboard) gọn, không dùng bảng biểu, không quá 600 từ. Bắt đầu đúng như sau:
`# Products Advertised on Meta: [category name] in [full country name]`
Chỉ sử dụng tên danh mục thường từ Ecommerce and Retail | ai_category=ecommerce_and_retail (phần trước `|`) và tên đầy đủ của US; không bao giờ hiển thị `ai_category`, slug hay mã ISO.

Sau đó hiển thị:
`**[N] verified product families** · Active now · 30-day archive window · **[Complete/Partial]**`

Thêm một câu: `Ranked by observable activity within the inspected sample, not by sales or advertising performance.`

Với ít nhất hai nhóm sản phẩm, thêm `## Shortlist`, một đoạn cho mỗi nhóm sản phẩm:
`**[rank]. [Product or offer]** — [N] active ad/ads in inspected sample · [M] returned page/pages · [primary format]`

Áp dụng đúng ngữ pháp số ít/số nhiều: `1 active ad`, `2 active ads`, `1 returned page`, `2 returned pages`.

Không rút gọn Shortlist chỉ còn tên. Mỗi nhóm sản phẩm hiển thị phải giữ lại các số liệu mẫu đã kiểm tra và định dạng chính trong Shortlist.

Với mỗi nhóm sản phẩm, tạo một phần được đánh số với các đoạn ngắn có nhãn:
- `Observed activity` — số liệu mẫu chính xác và bất kỳ tín hiệu tái sử dụng/thời gian rõ ràng nào có phạm vi tính riêng.
- `Product / offer` — đề xuất mua hàng cụ thể và chi tiết biến thể/gói combo quan trọng.
- `Advertiser` — tên/trang được trả về và độ tin cậy danh tính domain.
- `Representative message` — nội dung/góc nhìn ngắn gọn với tuyên bố được gán cho nhà quảng cáo.
- `Timing and status` — trạng thái hoạt động, ngày bắt đầu rõ ràng và thời gian hoạt động khi được trả về.
- `Format and CTA`.
- `Landing page` — liên kết/route đích an toàn khi được trả về.
- `Evidence` — liên kết first-party ổn định được trả về hoặc ID bằng chứng nguồn ổn định; nếu không, dùng đúng câu không có sẵn.
- `Why review it` — đúng một hành động so sánh hoặc kiểm tra cụ thể.

Với ít nhất hai nhóm sản phẩm, thêm `## Patterns` với hai hoặc ba so sánh cụ thể theo mẫu dữ liệu. Không gọi đó là xu hướng thị trường.

Trong `## Research coverage`, dùng tối đa ba gạch đầu dòng cho ngày/khung thời gian/trạng thái nghiên cứu, số lượng khám phá/kiểm tra/nhóm sản phẩm, và các giới hạn về mẫu có giới hạn/bằng chứng. Không để lộ tên công cụ, lệnh gọi thô, nhãn hướng tìm kiếm hay tên trường thô.

Không bao giờ xác định hay mô tả các ứng viên bị loại trong báo cáo khách hàng. Coverage chỉ được ghi số lượng bị loại và một nhóm lý do chung như `off-scope or insufficient product evidence`.

Với đúng một nhóm sản phẩm, bỏ qua Shortlist và Patterns. Với số 0, hiển thị `## Result` và Research coverage mà không có phần trống hay ứng viên được lấp đầy cho đủ.

Không dùng bảng Markdown/HTML hay dấu gạch chéo ngược ở cuối dòng. Trước khi gửi, kiểm tra lại danh tính chính xác của từng nhóm sản phẩm, bằng chứng active/country/window, nhãn số liệu mẫu, câu chữ nhà quảng cáo/domain, xếp hạng, cách xử lý liên kết/ID và trạng thái Complete/Partial.

Kết thúc đúng như sau:
`Meta archive activity is an observed advertising signal, not proof of spend, reach, engagement, conversions, sales, revenue, ROAS, profitability, bestseller status or complete market coverage.`

Chỉ sau khi có một yêu cầu riêng nói đúng `Show audit details`, hãy cung cấp một bản kiểm toán không nhạy cảm chỉ sử dụng các phản hồi đã giữ lại: cách diễn giải schema trực tiếp, các lệnh gọi chính xác, việc áp dụng tham số, thứ tự hướng tìm kiếm, các dòng đã nhận, việc loại trùng, các quyết định về chi tiết/nhà quảng cáo, việc nhóm sản phẩm, xếp hạng, các lỗi, thời gian và mức sử dụng. Không chạy lại các lệnh gọi Spytrend cho bản kiểm toán này.