Skonfigurować połączenie robocze z Amazon Ads API i eksport raportów reklamowych, w tym plików zbiorczych.

Cel: potrzebujemy, aby dane dotyczące reklamy Amazon Ads (kampanie, wydatki, wyświetlenia, kliknięcia, sprzedaż itp.) stabilnie były pobierane przez API do naszego zewnętrznego narzędzia (Google Sheets / Baza danych / raport - ustalimy osobno).

1. Kontekst i obecna sytuacja

• Istnieje działające konto Amazon Seller / Ads oraz utworzona aplikacja w Developer Console.
• Obecnie połączenie z Amazon Ads API nie działa:
  * przy zapytaniu o profile (profiles) zwraca pustą tablicę [] — profil konta reklamowego nie jest pobierany;
  * przy połączeniu przez istniejącą aplikację wystąpił błąd requested scopes not found;
  * istnieje podejrzenie, że konto reklamowe jest niepoprawnie powiązane z aplikacją / nie przyznano odpowiednich uprawnień.
• Token odświeżający uzyskuje się przez link w postaci:
  https://www.amazon.com/ap/oa?client_id=...&scope=advertising::campaign_management&response_type=code&redirect_uri=http://localhost
  ale dalej łańcuch autoryzacji do działającego Profile ID nie został doprowadzony.
• Wszystkie dostępne dane (Client ID, Client Secret, Refresh Token, Developer ID, link do Developer Console, dostęp do systemu wsparcia) przekażemy osobno.
  
  

2. Co należy zrobić

1. Sprawdzić i poprawnie skonfigurować aplikację w Amazon Developer Console
   * Upewnić się, że wskazane są poprawne zakresy dla Amazon Ads (advertising::campaign_management i inne, jeśli są potrzebne).
   * Sprawdzić, czy konto reklamowe jest rzeczywiście powiązane z aplikacją (przez Amazon Advertising Console / Developer Console).
   * W razie potrzeby ponownie utworzyć aplikację „od zera” zgodnie z najlepszymi praktykami.
2. Ustalić poprawny przepływ OAuth
   * Skonfigurować uzyskiwanie kodu autoryzacji → access_token / refresh_token.
   * Sprawdzić, czy token odświeżający działa i nie wygasa co pół godziny z powodu błędów w konfiguracji.
   * Udokumentować, jaki dokładnie link i parametry powinniśmy używać do aktualizacji tokenów.
3. Uzyskać działający Profile ID
   * Doprowadzić do tego, aby zapytanie do /v2/profiles (lub aktualnego endpointu) zwracało listę profili, a nie [].
   * Ustalić i usunąć przyczynę, dlaczego obecnie profil nie jest pobierany (uprawnienia, region, niewłaściwe konto itp.).
   * Zarejestrować potrzebny Profile ID i opisać, jak go ponownie uzyskać.
4. Sprawdzić dostęp do Amazon Apps & Services
   * W razie potrzeby — sformułować, jakie uprawnienia i role należy przyznać na koncie, aby sekcja Apps & Services → Develop Apps była dostępna i wszystko działało poprawnie.
   * Krótko opisać, jakie dokładnie zaznaczenia/zezwolenia są potrzebne od właściciela konta.
5. Skonfigurować podstawowy eksport raportów Amazon Ads
   * Zrealizować przykład zapytania do Amazon Ads API (na przykład, Sponsored Products / Sponsored Brands) z wykorzystaniem uzyskanego Profile ID.
   * Uzyskać i zapisać pierwszy testowy raport (przynajmniej w formacie JSON lub CSV) dotyczący kampanii za wybrany okres.
   * Opisać, jakie endpointy i parametry można wykorzystać dalej (abyśmy mogli rozwijać raportowanie samodzielnie lub z Twoją pomocą).
   
   

3. Co jest ważne na wyjściu

Na wyjściu potrzebujemy:

1. Działający dostęp API do Amazon Ads, który:
   * poprawnie się autoryzuje;
   * widzi profil(e) konta reklamowego;
   * pozwala na pobieranie danych dotyczących reklamy.
2. Mini-dokumentacja (krótko, punkt po punkcie):
   * gdzie w Seller Central / Advertising Console co jest skonfigurowane;
   * jakie Client ID / Developer ID / zakresy są używane;
   * jak aktualizować tokeny (kroki i przykład zapytania);
   * przykład zapytania do Ads API (z curl lub Postman);
   * jakie uprawnienia są potrzebne od właściciela konta.
3. Zrozumienie ograniczeń:
   * jeśli istnieją jakieś limity / ograniczenia dotyczące regionu, typu konta lub polityki Amazon — opisać to.
   
   

Jeśli do rozpoczęcia potrzebne są jeszcze jakieś dane (konkretny stos, gdzie wyprowadzać raporty, dostęp do hostingu itp.) — proszę osobno wymienić, co dokładnie jest wymagane.