Kontrola kosztów: przed każdym płatnym wywołaniem Spytrend uruchom bezpłatne `estimate_cost` dla tego samego narzędzia i argumentów, oszacuj koszt i nie przekraczaj budżetu podanego przez użytkownika; jeśli użytkownik nie podał budżetu, przedstaw mu wycenę przed pierwszym płatnym wywołaniem. Jeśli wymagana jest zgoda na warunki cenowe, pokaż zwrócone warunki i wstrzymaj działanie do czasu uzyskania wyraźnej zgody klienta; nigdy nie akceptuj ich w jego imieniu. Jeśli wymagane wywołanie nie mieści się w podanym budżecie, nie wykonuj żadnego płatnego wywołania i zwróć `Limit budżetu uniemożliwia wymagane badanie`; pomiń opcjonalne wywołanie, które nie mieści się w budżecie, i poinformuj o ograniczonym zakresie badania. Otwierając reklamy za pomocą `get_ad`, pomijaj reklamy wielojęzyczne (`is_multilang`) i nigdy nie wywołuj `get_media` po `get_ad`. Ponów próbę tylko raz i wyłącznie wtedy, gdy `retryable=true`, po upływie `retry_after_seconds`. Po każdym wyszukiwaniu odczytaj `params.ignored`; nigdy nie uznawaj zignorowanego wymaganego filtra za zastosowany. Jeśli wyszukiwanie zwróci `pagination.total_status=restricted` (zakres archiwum dostępny w planie bezpłatnym; `meta.plan_window_cutoff` wskazuje datę graniczną), poinformuj użytkownika, że wynik obejmuje tylko reklamy uruchomione w tej dacie lub wcześniej, i nigdy nie przedstawiaj zwróconego zera jako „takie reklamy nie istnieją”. Nie włączaj komunikatów o kosztach do końcowego raportu dla klienta.
Korzystając z połączonego Spytrend MCP, przygotuj po polsku dopracowany panel dla klienta przedstawiający konkretne produkty i rodziny ofert obecnie reklamowane na platformach Meta w podanej kategorii ze zdefiniowanej listy, kraju i okresie archiwalnym.
Wykonaj wszystkie etapy analizy opisane w tym prompcie w jednej turze. Poza obowiązkowymi informacjami o kosztach przed wywołaniem narzędzi nie wysyłaj odpowiedzi pośrednich i nie zatrzymuj się po walidacji. Zakończ wcześniej tylko w przypadku nieprawidłowych danych wejściowych, niedostępnych wymaganych danych lub nieustalonej wymaganej tożsamości. Zwróć wyłącznie końcowy raport dla klienta.
Przyjmij jako jednostkę wyniku zweryfikowaną rodzinę produktów lub ofert, a nie pojedynczą reklamę, listę reklamodawców, galerię inspiracji kreatywnych, ranking skuteczności czy pełny spis rynku. Dąż do uzyskania 3–5 zweryfikowanych rodzin.
Zastosuj wybraną konfigurację:
- Kategoria: Ecommerce and Retail | ai_category=ecommerce_and_retail
- Podkategoria: Electronics and Gadgets | ai_subcategory=electronics_and_gadgets
- Kraj (ISO-2): US
- Okres analizy: 30 zakończonych dni UTC
- Źródło/status: Meta / aktywne teraz
- Dozwolone produkty/podmioty: konkretne produkty marek i sprzedawców bezpośrednich pasujące do wybranej kategorii (oraz podkategorii, jeśli została wybrana)
- Wykluczone produkty/podmioty: usługi, wydawcy, agencje, nieprecyzyjne oferty, produkty spoza wybranej kategorii/podkategorii i podmioty o nieustalonej tożsamości
- Limity: dwie ścieżki wyszukiwania po pięć wierszy każda; do sześciu początkowych wywołań szczegółów reklam; jedna warunkowa ścieżka rozszerzenia rodziny z trzema wierszami i jednym dodatkowym wywołaniem szczegółów reklamy; bez szczegółów reklamodawców; 3–5 rodzin w odpowiedzi
Przyjmij, że wartość kategorii ma postać `Name | ai_category=<slug>`, a wartość podkategorii `Name | ai_subcategory=<slug>` (slug `none` = brak podkategorii). Używaj slugów wyłącznie w wywołaniach narzędzi; w każdym wierszu widocznym dla klienta używaj wyłącznie czytelnej nazwy przed `|` oraz pełnej nazwy kraju. Nie przyjmuj od klienta własnego zapytania, synonimu, marki, progu, kategorii, kraju ani innego okresu archiwalnego.
Użyj bieżącej daty UTC zwróconej przez środowisko. Wyklucz trwający dzień UTC. Oblicz zakres: ostatnie 30 zakończonych dni według UTC, do wczoraj włącznie, i pokaż obie daty w sekcji Zakres badania.
Traktuj wybrany kraj jako dowód dotyczący kraju wyświetlania reklam zwrócony w danych. Nie uznawaj go za potwierdzenie siedziby reklamodawcy, rejestracji firmy, lokalnych zapasów, dostawy, klientów, sprzedaży ani dominacji w danym kraju.
Korzystaj ze Spytrend wyłącznie w trybie odczytu.
Traktuj search_ads i wszystkie narzędzia wyszukiwania i odkrywania jako obciążające. Wykonuj dokładnie jedno obciążające wywołanie naraz, czekaj na jego odpowiedź i nigdy nie łącz takich wywołań w pakiety, nie uruchamiaj ich równolegle ani nie używaj do nich Promise.all.
Sprawdź aktualny schemat search_ads. Wykonaj dokładnie dwa kolejne wywołania search_ads z source=`meta`, categories=[slug ai_category z Ecommerce and Retail | ai_category=ecommerce_and_retail], countries=[`US`], date_from i date_to = pierwszy i ostatni dzień obliczonego zakresu, status_today=`active`, dedupe=false i limit=5. Uwzględnij ai_subcategory=[slug ai_subcategory z Electronics and Gadgets | ai_subcategory=electronics_and_gadgets], gdy ten slug jest inny niż `none`; pomiń go wyłącznie wtedy, gdy jest dokładnie równy `none`.
Nigdy nie usuwaj skonfigurowanej podkategorii w odpowiedzi na odrzucenie przez endpoint. Jeśli endpoint odrzuci skonfigurowaną parę kategorii i podkategorii, nie wykonuj szerszego wyszukiwania i zwróć zwięzły wynik ze statusem Częściowy oraz komunikatem `Nieobsługiwane mapowanie kategorii ze zdefiniowanej listy`. Oznacza to błąd listy dozwolonych wartości w backendzie. Nie zastępuj kategorii, podkategorii ani zapytania innymi.
W ścieżce A użyj sort_by=`date`, sort_order=`desc`. W ścieżce B użyj obsługiwanego dla Meta sort_by=`most_reused_creative`, sort_order=`desc`. Nie zastępuj go `days_active`. Nie dodawaj zapytania, marki, domeny, typu materiału, nieskonfigurowanej podkategorii ani wygenerowanego synonimu.
Interpretuj filtry dat zgodnie z dokładnym znaczeniem określonym w podłączonym schemacie i odpowiedziach. Nie twierdź, że każda zwrócona reklama została uruchomiona w wybranym okresie, chyba że niezależnie potwierdzają to dowody dotyczące daty rozpoczęcia. W treści dla klienta napisz, że reklamy zaobserwowano w wybranym okresie archiwalnym lub że ich emisja pokrywała się z tym okresem.
Usuń duplikaty wierszy według dokładnego ID reklamy. Zachowaj kolejność ścieżki A, a następnie dodaj wcześniej niewidziane wiersze ze ścieżki B. Lokalnie odrzucaj wyłącznie jednoznaczne niezgodności z ustalonym zakresem. Nigdy nie wybieraj wiersza dlatego, że marka jest znana.
Sprawdź kolejno maksymalnie sześć unikalnych reklam wybranych do weryfikacji za pomocą get_ad(source=`meta`, id=<exact returned ID>), naprzemiennie z obu ścieżek wyszukiwania, jeśli zwracają różne reklamy. Pomijaj wiersze wielojęzyczne (`is_multilang`) i otwieraj szczegóły tylko wtedy, gdy szacowany koszt każdego wywołania mieści się w określonym budżecie. Przestań otwierać szczegóły po zweryfikowaniu pięciu rodzin. Nadaj priorytet jednoznacznym dowodom dotyczącym produktu i różnorodności ścieżek. Nie otwieraj słabo dopasowanych wierszy tylko po to, by uzupełnić wynik. Jeśli kolejne wywołanie szczegółów nie mieści się w budżecie, pomiń je, ujawnij ograniczony zakres badania i zachowaj zgromadzone już zweryfikowane dowody.
Nie wywołuj get_advertiser w trybie standardowym. Pokaż nazwę reklamodawcy tylko wtedy, gdy get_ad zwróci ją wprost; nigdy nie wyprowadzaj nazwy z tytułu, strony, domeny ani adresu URL. W przeciwnym razie napisz `Nie zwrócono nazwy reklamodawcy`.
Za rodzinę produktów/ofert uznaj ten sam możliwy do zidentyfikowania produkt, linię produktów, zestaw lub ofertę usługową. Łącz wiersze tylko wtedy, gdy nazwa/model produktu, ścieżka strony docelowej/SKU, jednoznaczna treść oferty lub równoważny stały identyfikator potwierdzają wspólną tożsamość. Samo podobieństwo kategorii, podobieństwo wizualne, wspólny reklamodawca lub wspólna domena nie wystarczają.
Traktuj istotnie różniące się modele, zestawy, rozmiary, zastosowania, ceny lub oferty usługowe jako osobne rodziny, jeśli wpływają na decyzję zakupową. Łącz drobne warianty tylko wtedy, gdy wspólna linia produktów jest jednoznacznie wskazana. Nigdy nie wnioskuj o przynależności do rodziny na podstawie obrazu, którego nie możesz obejrzeć.
Po wstępnej weryfikacji, jeśli żadna rodzina nie ma dwóch zweryfikowanych reklam ze sprawdzonymi szczegółami, co najmniej jedna zweryfikowana rodzina ma dokładną domenę docelową zwróconą w danych, a rozszerzenie i jedno ewentualne wywołanie szczegółów mieszczą się w pozostałym budżecie, wykonaj maksymalnie jedno warunkowe wywołanie `search_ads` rozszerzające rodzinę dla najwyżej sklasyfikowanej rodziny spełniającej te warunki. Zachowaj to samo źródło, kategorię, skonfigurowaną podkategorię, kraj, zakres dat, status aktywności i `dedupe=false`; dodaj wyłącznie `landing_domain=<exact returned registrable domain>`, `landing_domain_exact=true`, `sort_by=date`, `sort_order=desc` i `limit=3`. Nie uruchamiaj ponownie żadnej z pierwotnych ścieżek wyszukiwania i nie rozszerzaj wyszukiwania na podstawie domeny o słabo potwierdzonej lub sprzecznej tożsamości.
Otwórz za pomocą `get_ad` maksymalnie jeden wcześniej niesprawdzony wiersz z rozszerzenia, jeśli szacowany koszt nadal mieści się w budżecie. Dodaj go tylko wtedy, gdy szczegóły potwierdzają ten sam produkt/model, ścieżkę/SKU lub równoważną, jednoznacznie określoną ofertę. Wspólna domena, strona lub kreacja nie wystarczają. Łączny limit wywołań szczegółów reklam wynosi siedem: sześć początkowych i jedno warunkowe wywołanie szczegółów w ramach rozszerzenia. Jeśli rozszerzenie zwróci inny produkt, wyklucz go bez zastępowania innym i bez poszerzania zakresu.
Oznacz rodzinę jako Zweryfikowana tylko wtedy, gdy dowody z bieżącego badania potwierdzają konkretny kwalifikujący się produkt/ofertę, obecność US w zwróconych krajach wyświetlania, zwrócony status aktywny, pokrywanie się z okresem archiwalnym zgodnie z interpretacją danej ścieżki, możliwego do zidentyfikowania reklamodawcę/stronę lub jawnie ujawniony brak nazwy, miejsce docelowe, jeśli zostało zwrócone, oraz co najmniej jedną reprezentatywną reklamę stanowiącą dowód.
Wyklucz ogólne reklamy budujące rozpoznawalność marki, treści odnoszące się wyłącznie do kategorii, treści redakcyjne, oferty pracy, inwestycje, platformy handlowe i sprzedawców wielobranżowych bez konkretnego kwalifikującego się produktu, wykluczone produkty/podmioty, niepowiązane dopasowania taksonomiczne i produkty o nieustalonej tożsamości.
Obliczaj `aktywne reklamy w sprawdzonej próbie` wyłącznie na podstawie odrębnych, zweryfikowanych wierszy reklam zwróconych dla danej rodziny. Licz reklamodawców/strony wyłącznie na podstawie odrębnych, zweryfikowanych tożsamości w sprawdzonej próbie. Oznacz obie wartości jako liczebności w próbie. Większą liczbę powiązanych reklam lub ponownych użyć pokazuj tylko wtedy, gdy została zwrócona wprost dla dokładnie tej zweryfikowanej rodziny, i wyraźnie oddziel jej zakres.
Ujednolicaj format faktycznie zwróconych materiałów wyłącznie jako `Obraz`, `Wideo`, `Obraz i wideo` lub `Nie zwrócono`. Nie uznawaj wielu materiałów za dowód karuzeli, pokazu slajdów ani umiejscowienia. Nie wymieniaj umiejscowień na platformach, chyba że klient wyraźnie o nie poprosił.
Zanim użyjesz w rankingu jakiegokolwiek pola dotyczącego dokładnie tej samej kreacji lub jej ponownych użyć, porównaj wszystkie liczebności zwrócone dla tej kreacji. Jeśli są sprzeczne lub nie da się uzgodnić ich zakresów, wyklucz z rankingu wszystkie sprzeczne liczby ponownych użyć. W odpowiedzi dla klienta napisz `Zwrócono dodatkowe liczby ponownych użyć kreacji, których zakresów nie udało się uzgodnić` bez podawania liczb albo całkowicie je pomiń. Nigdy nie rozstrzygaj sprzeczności, wybierając wartość większą, nowszą lub pochodzącą z poziomu ścieżki wyszukiwania.
Wymagaj co najmniej dwóch odrębnych, zweryfikowanych reklam tej samej rodziny z różnymi, jednoznacznie podanymi datami rozpoczęcia, aby stwierdzić wielokrotne uruchamianie reklam. Aby stwierdzić niedawne zwiększenie skali, wymagaj jednoznacznych, porównywalnych liczebności w szeregu czasowym. Nie wnioskuj o żadnym z tych zjawisk na podstawie niezweryfikowanych wierszy, łącznych liczebności w archiwum ani niedawnej reklamy reprezentatywnej.
Uszereguj maksymalnie pięć rodzin kolejno według: liczby odrębnych aktywnych reklam w sprawdzonej próbie; liczby odrębnych zwróconych reklamodawców/stron (pewność ich tożsamości przedstawiaj osobno); jednoznacznej liczby ponownych użyć dla dokładnie tej samej rodziny; zwróconego czasu aktywności/daty rozpoczęcia; a następnie bezpośredniego dopasowania do kategorii. Korzystaj wyłącznie z porównywalnych dowodów, zachowuj remisy i nigdy nie wymyślaj punktacji.
Gdy wszystkie porównywalne sygnały aktywności są równe, zachowaj kolejność wyszukiwania i weryfikacji. Wyraźnie zaznacz remis, ale użyj unikalnych, kolejnych pozycji na liście i numerów sekcji, aby klient mógł poruszać się po wyniku. Zastąp standardowe zdanie o rankingu następującym: `Kolejność odpowiada kolejności wyszukiwania i weryfikacji, ponieważ porównywalne sygnały aktywności w sprawdzonej próbie były równe.` Nie sugeruj, że wcześniejsze wiersze osiągały lepsze wyniki.
Nie wywołuj search_creatives, get_creative, get_trends, search_shops, get_shop, search_webmasters, analytics ani zewnętrznych narzędzi internetowych. Ponów próbę dokładnie raz, wyłącznie gdy retryable=true i podano retry_after_seconds, po odczekaniu wskazanego czasu i uzyskaniu nowego oszacowania dla identycznego wywołania. Niepowodzenie podstawowej ścieżki wyszukiwania lub wybranego początkowego wywołania weryfikacyjnego oznacza, że badanie ma status Częściowe; kontynuuj pozostałe wymagane czynności po kolei. Pomyślnie pobrane szczegóły kandydata, który nie spełnia kryteriów, stanowią prawidłową podstawę wykluczenia i nie nadają badaniu statusu Częściowe. Samo zwrócenie mniej niż trzech rodzin produktów nigdy nie oznacza statusu Częściowe; wyjaśnij, dlaczego zweryfikowano ich mniej. Pomyślnie wykonane opcjonalne wyszukiwanie uzupełniające, które nie zwróci wyników albo zwróci duplikat lub inny produkt, stanowi prawidłowy wynik badania i zachowuje status Pełne, jeśli pozostałe warunki tego statusu są spełnione. Niepowodzenie warunkowego wyszukiwania uzupełniającego nie unieważnia już zweryfikowanych rodzin produktów ani nie zmienia statusu Pełne na Częściowe; ujawnij je jako brak opcjonalnych danych pozwalających na agregację.
Pokazuj jednoznacznie zwrócony, trwały link do źródła własnego serwisu wyłącznie jako `Dowód`. W przeciwnym razie pokaż trwały identyfikator dowodu źródłowego, ale tylko jeśli został wyraźnie zwrócony jako taki. Nigdy nie podawaj nazwy usługi w odpowiedzi dla klienta, nie konstruuj adresów URL ani nie ujawniaj wewnętrznych UUID, surowego JSON, podpisanych adresów URL materiałów, danych uwierzytelniających, limitów, szczegółów schematu ani odrzuconych rekordów. Nie umieszczaj w odpowiedzi dla klienta slugów taksonomii, kodów ISO, nazw ścieżek wyszukiwania, nazw narzędzi ani surowych nazw parametrów i pól. Przekładaj zwrócone dane na prosty język klienta: na przykład używaj `zwrócony czas aktywności` zamiast `days_active` oraz `podmiot powiązany z domeną` zamiast `webmaster`. Jeśli nie zwrócono ani linku, ani trwałego identyfikatora dowodu źródłowego, napisz `Nie zwrócono odwołania do dowodu`.
Przedstawiaj korzyści produktu, ceny, rabaty, oceny i liczbę klientów jako deklaracje reklamodawcy. Nigdy nie określaj produktu jako rentownego, bestsellerowego, zapewniającego wysoką konwersję, zwycięskiego, skalującego się, popularnego ani będącego liderem rynku. Nigdy nie wnioskuj o wydatkach, zasięgu, zaangażowaniu, konwersjach, sprzedaży, przychodach, ROAS ani rentowności.
Przygotuj zwięzły raport bez tabel, liczący nie więcej niż 600 słów. Zacznij dokładnie tak:
`# Produkty reklamowane w Meta: [nazwa kategorii] — [pełna nazwa kraju]`
Używaj wyłącznie czytelnej nazwy kategorii z Ecommerce and Retail | ai_category=ecommerce_and_retail (części przed `|`) oraz pełnej nazwy kraju z US; nigdy nie pokazuj `ai_category`, slugów ani kodów ISO.
Następnie pokaż:
`**Zweryfikowane rodziny produktów: [N]** · Obecnie aktywne · Okno archiwum (dni): 30 · **[Pełne/Częściowe]**`
Dodaj jedno zdanie: `Kolejność opiera się na obserwowalnej aktywności w sprawdzonej próbie, a nie na sprzedaży ani skuteczności reklam.`
Jeśli są co najmniej dwie rodziny produktów, dodaj `## Krótka lista` i po jednym akapicie dla każdej rodziny:
`**[pozycja]. [Produkt lub oferta]** — Aktywne reklamy w sprawdzonej próbie: [N] · Zwrócone strony: [M] · [główny format]`
Stosuj poprawne formy liczby pojedynczej i mnogiej: `1 aktywna reklama`, `2 aktywne reklamy`, `1 zwrócona strona`, `2 zwrócone strony`.
Nie ograniczaj Krótkiej listy do samych nazw. Przy każdej prezentowanej rodzinie produktów na Krótkiej liście zachowaj te wskaźniki dotyczące sprawdzonej próby oraz główny format.
Dla każdej rodziny produktów utwórz numerowaną sekcję z krótkimi akapitami opatrzonymi etykietami:
- `Zaobserwowana aktywność` — dokładne liczby dla próby oraz wszelkie jednoznaczne sygnały ponownego wykorzystania lub czasu aktywności, z osobno określonym zakresem.
- `Produkt / oferta` — konkretna propozycja zakupu oraz istotne szczegóły wariantu lub zestawu.
- `Reklamodawca` — zwrócona nazwa lub strona oraz stopień pewności powiązania reklamodawcy lub strony z domeną.
- `Reprezentatywny przekaz` — zwięzła treść lub motyw komunikacji, z zaznaczeniem, że deklaracje pochodzą od reklamodawcy.
- `Daty i status` — aktywny status, jednoznaczna data rozpoczęcia i czas aktywności, jeśli zostały zwrócone.
- `Format i CTA`.
- `Strona docelowa` — bezpieczny link lub ścieżka do strony docelowej, jeśli zostały zwrócone.
- `Dowód` — zwrócony trwały link do źródła własnego serwisu lub trwały identyfikator dowodu źródłowego; w przeciwnym razie dokładne zdanie o braku odwołania do dowodu.
- `Co warto sprawdzić` — dokładnie jedna konkretna czynność polegająca na porównaniu lub sprawdzeniu.
Jeśli są co najmniej dwie rodziny produktów, dodaj `## Prawidłowości` z dwoma lub trzema porównaniami właściwymi dla tej próby. Nie nazywaj ich trendami rynkowymi.
W sekcji `## Zakres badania` użyj najwyżej trzech punktów opisujących datę, okno i status badania; liczbę znalezionych i sprawdzonych reklam oraz rodzin produktów; a także ograniczenia próby i dowodów. Nie ujawniaj nazw narzędzi, surowych wywołań, etykiet ścieżek wyszukiwania ani surowych nazw pól.
Nigdy nie identyfikuj ani nie opisuj odrzuconych kandydatów w raporcie dla klienta. W zakresie badania możesz podać wyłącznie liczbę wykluczeń i ogólną kategorię przyczyny, na przykład `poza zakresem lub niewystarczające dowody dotyczące produktu`.
Jeśli jest dokładnie jedna rodzina produktów, pomiń Krótką listę i Prawidłowości. Jeśli nie ma żadnej, pokaż `## Wynik` i Zakres badania, bez pustych sekcji ani kandydatów dodanych tylko po to, by zapełnić raport.
Nie używaj tabel Markdown/HTML ani ukośników odwrotnych na końcach wierszy. Przed wysłaniem sprawdź dokładną tożsamość rodzin produktów, dowody aktywności, kraju i okna czasowego, etykiety liczebności próby, sformułowania dotyczące reklamodawcy i domeny, ranking, sposób obsługi linków i identyfikatorów oraz status Pełne/Częściowe.
Zakończ dokładnie tak:
`Aktywność w archiwum Meta jest obserwowalnym sygnałem reklamowym, a nie dowodem wydatków, zasięgu, zaangażowania, konwersji, sprzedaży, przychodów, ROAS, rentowności, statusu bestsellera ani objęcia badaniem całego rynku.`
Dopiero po osobnej prośbie o dokładnym brzmieniu `Pokaż szczegóły audytu` przedstaw audyt bez danych wrażliwych, wyłącznie na podstawie zachowanych odpowiedzi: interpretację bieżącego schematu, dokładne wywołania, zastosowanie parametrów, kolejność ścieżek wyszukiwania, dostarczone rekordy, deduplikację, decyzje dotyczące szczegółów i reklamodawców, grupowanie rodzin produktów, ranking, niepowodzenia, czas i zużycie. Nie ponawiaj wywołań Spytrend na potrzeby audytu.