Tìm quảng cáo Meta theo từ khóa, thương hiệu hoặc slogan.

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 người dùng đã nêu; nếu người dùng chưa nêu ngân sách, hãy cho họ biết mức ước tính trước lệnh gọi có phí đầu tiên. Nếu cần có 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 lệnh gọi tùy chọn không nằm trong ngân sách và nêu rõ phạm vi bị thu hẹp. 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` (cửa sổ lưu trữ của gói miễn phí; `meta.plan_window_cutoff` nêu rõ ranh giới), hãy cho người dùng biết 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 gửi khách hàng.

Tìm quảng cáo Meta đang hoạt động được ra mắt trong **30 ngày UTC đã hoàn tất** gần nhất tại **Hoa Kỳ / US**, có nội dung quảng cáo trả về có thể chứa đúng cụm từ **Product** **acne patches**.

Sử dụng Spytrend ở chế độ chỉ đọc. Đây là bước 1/4. Chưa tạo báo cáo khách hàng.

Chỉ chấp nhận Loại tìm kiếm là Literal phrase, Product, Brand, Slogan hoặc Offer; một quốc gia ISO-2 được hỗ trợ; và khoảng thời gian 7, 14, 30 hoặc 90 ngày UTC đã hoàn tất. Quốc gia được cho dưới dạng `Name / code`: chỉ dùng mã ISO-2 sau `/` trong các lệnh gọi, và chỉ dùng tên quốc gia trước `/` trong câu trả lời. Chỉ cắt khoảng trắng ở hai đầu cụm từ. Yêu cầu 2-80 ký tự. Giữ nguyên cách viết, dấu câu, chữ hoa/thường và ngôn ngữ. Không dịch, không sửa, không thêm từ đồng nghĩa hay tạo biến thể.

Đặt `date_to` là ngày UTC đã hoàn tất gần nhất và tính `date_from` bao gồm đủ số ngày đã chọn. Chạy đúng một lệnh gọi `search_ads(source="meta", query=<literal phrase>, country=<ISO-2>, search_in="text", date_from=<date>, date_to=<date>, status_today="active", sort_by="most_reused_creative", sort_order="desc", dedupe=true, limit=10)`. Chỉ thử lại một lần cho phản hồi có thể thử lại do bận/hết thời gian, và chỉ sau khoảng thời gian chờ được trả về. Không thử lại với đầu vào không hợp lệ hoặc kết quả hoàn tất bằng 0. Không phân trang hoặc mở rộng phạm vi.

Yêu cầu query, country, phạm vi văn bản, ngày ra mắt, trạng thái active, sắp xếp theo reuse và loại trùng lặp phải được áp dụng mà không bị thay thế ngữ nghĩa hay bỏ qua bộ lọc. Nếu không, giữ trạng thái `Unavailable` cho Bước 4. Một dòng trả về không hoạt động không làm mất hiệu lực của một tuyến trạng thái active đã áp dụng thành công ở phần còn lại: chỉ đánh dấu dòng đó là `ineligible - inactive` và tiếp tục với các dòng còn lại.

Coi truy vấn là khám phá ứng viên. Chỉ đánh dấu một dòng active đủ điều kiện là `visible exact` khi cụm từ đầy đủ xuất hiện liên tục và không phân biệt chữ hoa/thường trong title hoặc body trả về. Đánh dấu `needs opening` khi nội dung body bị bỏ qua rõ ràng. Đánh dấu dòng trả về không hoạt động là `ineligible - inactive`. Khớp một phần token hoặc từ riêng lẻ không được coi là khớp chính xác. Loại trùng lặp theo ad ID và giữ nguyên thứ tự máy chủ trả về.

Giữ lại cho bước sau: đầu vào đã xác thực và các ngày đã tính; trạng thái tuyến; tổng số dòng; danh sách ID ứng viên theo thứ tự; `is_multilang` cho mỗi dòng; title/body hiển thị hoặc dấu hiệu bị bỏ qua rõ ràng; trạng thái khớp chính xác hiển thị; ID và tên nhà quảng cáo khi được trả về; trạng thái active; ngày ra mắt và ngày thấy lần cuối; format; CTA; URL/domain trang đích; creative ID; reuse theo lựa chọn; reuse trọn đời; URL bằng chứng ổn định khi được trả về. Không loại bỏ một ứng viên chỉ vì thiếu một trường tùy chọn.

Chỉ trả lời bằng một điểm kiểm tra Bước 1 ngắn gọn: trạng thái tuyến, khoảng ngày, số dòng và danh sách ID ứng viên theo thứ tự kèm `visible exact`, `needs opening`, `not exact` hoặc `ineligible - inactive`. Không để lộ token hay quota. Kết thúc bằng `Ready for Step 2.`

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 người dùng đã nêu; nếu người dùng chưa nêu ngân sách, hãy cho họ biết mức ước tính trước lệnh gọi có phí đầu tiên. Nếu cần có 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 lệnh gọi tùy chọn không nằm trong ngân sách và nêu rõ phạm vi bị thu hẹp. 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` (cửa sổ lưu trữ của gói miễn phí; `meta.plan_window_cutoff` nêu rõ ranh giới), hãy cho người dùng biết 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 gửi khách hàng.

Tiếp tục tìm kiếm **Product** đã giữ lại cho **acne patches** tại **Hoa Kỳ / US**. Đây là bước 2/4. Không chạy lại khám phá và chưa tạo báo cáo khách hàng.

Nếu Bước 1 giữ trạng thái cuối `Unavailable` hoặc hoàn tất bằng 0, không thực hiện lệnh gọi nào, giữ nguyên trạng thái đó và trả lời bằng một điểm kiểm tra ngắn gọn kết thúc bằng `Ready for Step 3.`

Nếu không, mở các ứng viên active đủ điều kiện đã giữ lại theo thứ tự máy chủ bằng `get_ad(id=<ad ID>)` cho đến khi 5 quảng cáo được xác minh hoặc 6 ứng viên đã được mở, tùy điều kiện nào đến trước. Bỏ qua các dòng được đánh dấu `ineligible - inactive` hoặc `is_multilang=true` mà không tính vào giới hạn 6 lượt mở. Không bao giờ thay thế bằng một quảng cáo ngoài trang đó. Chỉ thử lại mỗi lệnh gọi chi tiết bắt buộc một lần cho phản hồi có thể thử lại do bận/hết thời gian, và chỉ sau khoảng thời gian chờ được trả về.

Chỉ giữ lại một quảng cáo đã mở khi nó thực sự đang active và cụm từ đầy đủ xuất hiện liên tục, không phân biệt chữ hoa/thường trong title/body đã mở. Với Literal phrase, xuất hiện chính xác là đủ. Với Product, cụm từ phải xác định được sản phẩm hoặc nhóm sản phẩm. Với Brand, phải xác định được một thương hiệu hoặc sản phẩm mang thương hiệu. Với Slogan, phải đóng vai trò slogan hoặc tagline chứ không phải văn bản thông thường. Với Offer, phải nêu rõ ưu đãi. Loại bỏ một khớp nguyên văn nhưng sai vai trò.

Với mỗi ứng viên đã mở, giữ lại: ad ID; lý do đạt/loại; ID và tên nhà quảng cáo rõ ràng khi được trả về; một đoạn trích bối cảnh 80-160 ký tự quanh vị trí khớp; ưu đãi rõ ràng; trạng thái active thực tế; ngày ra mắt và ngày thấy lần cuối; format; CTA; URL/domain trang đích chính xác; creative ID; reuse theo lựa chọn; reuse trọn đời; URL bằng chứng ổn định. Giữ các trường không có sẵn ở trạng thái không có sẵn. Chỉ giữ riêng reuse theo lựa chọn và reuse trọn đời khi cả hai nhất quán nội bộ. Nếu reuse theo lựa chọn vượt quá reuse trọn đời hoặc phạm vi không rõ ràng, giữ `Reuse comparison unavailable` cùng với sự không nhất quán về phạm vi.

Chỉ trả lời bằng một điểm kiểm tra Bước 2 ngắn gọn: số lượng đã mở, các ID đã xác minh, các ID bị loại kèm lý do ngắn gọn, và liệu đã đạt điểm dừng 5 kết quả hay 6 lượt mở. Không để lộ token hay quota. Kết thúc bằng `Ready for Step 3.`

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 người dùng đã nêu; nếu người dùng chưa nêu ngân sách, hãy cho họ biết mức ước tính trước lệnh gọi có phí đầu tiên. Nếu cần có 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 lệnh gọi tùy chọn không nằm trong ngân sách và nêu rõ phạm vi bị thu hẹp. 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` (cửa sổ lưu trữ của gói miễn phí; `meta.plan_window_cutoff` nêu rõ ranh giới), hãy cho người dùng biết 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 gửi khách hàng.

Tiếp tục tìm kiếm **Product** đã giữ lại cho **acne patches** tại **Hoa Kỳ / US**. Đây là bước 3/4. Không chạy lại khám phá hay mở lại quảng cáo. Chưa tạo báo cáo khách hàng.

Với mỗi advertiser ID riêng biệt trong số các quảng cáo đã xác minh và giữ lại, dùng tên nhà quảng cáo hoặc tên trang được trả về cùng quảng cáo đã mở, kể cả tên trang hoặc webmaster được trả về, và chỉ gọi `get_advertiser(id=<exact advertiser_id>)` khi quảng cáo đã mở không trả về tên nào như vậy. Chỉ thử lại một lần lệnh gọi xác định danh tính bắt buộc cho phản hồi có thể thử lại do bận/hết thời gian, và chỉ sau khoảng thời gian chờ được trả về. Một lượt tra cứu danh tính thất bại không loại bỏ quảng cáo đã xác minh; giữ `Name unavailable`.

Nhóm các creative ID trùng lặp. Khi creative ID không có sẵn, chỉ nhóm các dòng có cùng danh tính nhà quảng cáo rõ ràng, nội dung body đã mở được chuẩn hóa giống hệt nhau và cùng đường dẫn trang đích. Không hợp nhất các nội dung chỉ tương tự, các đường dẫn khác nhau hoặc các nhà quảng cáo khác nhau. Giữ lại số lượng quảng cáo quan sát được và toàn bộ ID bằng chứng cho mỗi nhóm chính xác (chỉ dùng nội bộ). Không suy luận ra một nhóm ưu đãi.

Giữ lại cho Bước 4 mỗi kết quả/nhóm đã xác minh cùng tên nhà quảng cáo, đoạn trích bối cảnh, số quảng cáo quan sát được, ưu đãi, trạng thái active, ngày ra mắt và ngày thấy lần cuối, format, CTA, đường dẫn trang đích chính xác, so sánh reuse hoặc việc nó không có sẵn một cách rõ ràng, creative ID khi có, và các URL bằng chứng ổn định. Cũng giữ lại trạng thái tuyến và các ngày của Bước 1, tổng số dòng đã khám phá, số lượng đã mở, và bất kỳ khoảng trống xác minh bắt buộc nào.

Chỉ trả lời bằng một điểm kiểm tra Bước 3 ngắn gọn: tên nhà quảng cáo đã xác định, số nhóm cuối cùng, số quảng cáo quan sát được theo mỗi nhóm và bất kỳ bằng chứng bắt buộc chưa được giải quyết nào. Không để lộ advertiser ID thô, token hay quota. Kết thúc bằng `Ready for Step 4.`

Chỉ sử dụng bằng chứng đã giữ lại từ Bước 1-3, viết báo cáo cuối cùng cho khách hàng về cụm từ **Product** **acne patches** tại **Hoa Kỳ / US**. Không thực hiện lệnh gọi mới nào.

Không dùng bảng và giữ dưới 300 từ. Bắt đầu bằng `# Active Meta Ads Containing "acne patches": <country name>`, sau đó `**[N] verified ads · [M] advertisers · [Complete/Partial/Unavailable]**`. `N` là số quảng cáo đã xác minh quan sát được trước khi nhóm chính xác, không phải số nhóm hiển thị.

Thêm `## Verified ads`. Với mỗi kết quả/nhóm chính xác, hiển thị nhà quảng cáo, bối cảnh ngắn gọn chứng minh cả cụm từ chính xác và vai trò Loại tìm kiếm được yêu cầu, số quảng cáo quan sát được khi được nhóm, ưu đãi, trạng thái active thực tế và ngày ra mắt, format, CTA, đường dẫn trang đích, reuse theo lựa chọn/trọn đời hoặc `Reuse comparison unavailable`, và URL bằng chứng ổn định trên spytrend.com khi được trả về (không bao giờ dùng ad ID thô).

Thêm tối đa ba gạch đầu dòng `## Research coverage` nêu khoảng thời gian ra mắt, mẫu ứng viên mười dòng có giới hạn, số ứng viên đã được mở, việc xác minh cụm từ chính xác và bất kỳ khoảng trống đáng kể nào.

Một lượt khám phá hoàn tất với xác minh bắt buộc thành công là `Complete`, kể cả khi creative ID tùy chọn, ngày thấy lần cuối, nội dung ưu đãi, tên nhà quảng cáo hoặc các trường reuse không có sẵn. Một lượt khám phá hoàn tất mà không có dòng nào được xác minh vẫn là `Complete` với số 0; hãy nói rằng không có quảng cáo nào được xác minh trong mẫu có giới hạn, không nói rằng không có quảng cáo nào tồn tại. Một lượt khám phá thất bại cuối cùng là `Unavailable`. Chỉ dùng `Partial` khi bằng chứng cụm từ, trạng thái active hoặc trang đích bắt buộc bị mất đối với một quảng cáo đã mở mà lẽ ra có thể giữ lại, và nêu rõ khoảng trống đó.

Không để lộ tên dịch vụ/công cụ, lệnh gọi, tham số, quota, token, thời gian, số lần thử lại, advertiser ID hay ad ID thô, hoặc các dòng bị loại. Literal phrase chỉ báo cáo sự xuất hiện của văn bản mà không gán vai trò ngữ nghĩa. Không suy luận về mối liên kết, sự cho phép, vi phạm, hàng giả, chi tiêu, lượt click, chuyển đổi, doanh thu, hiệu suất, lợi nhuận hay phạm vi thị trường đầy đủ.

Kết thúc đúng như sau:

`Ad text, destination and creative-reuse data are observed research signals. They do not prove affiliation, authorization, spend, conversions, revenue or advertising performance.`