Interfejs AdSense Management API ma wywołania służące do generowania nowych i zapisanych raportów. Mogą one zawierać proste dane statystyczne, np. zarobki dzienne, lub bardzo złożone tabele współczynników klikalności według kanału niestandardowego z poszczególnymi krajami. Ten przewodnik zawiera listę przypadków brzegowych, które należy prawidłowo obsługiwać, aby zapewnić solidną integrację z interfejsami API.
Struktura raportu
Wyniki raportu są zwracane jako obiekt ReportResult. Pełne informacje znajdziesz w dokumentacji odpowiedzi na raport.
Korzystanie z wymiarów chronologicznych: DATE, WEEK i MONTH
Raporty mogą być puste lub zawierać luki
Jeśli w okresie określonym w żądaniu nie było żadnej aktywności, nie są generowane żadne żądania reklamy i usługa raportowania nie wyświetla wierszy w tych okresach. Jest to ważne, gdy np. rysujesz wykres.
Więcej informacji znajdziesz w przewodniku po wypełnianiu dat.
Żądanie wymiarów MONTH i WEEK w tym samym raporcie
Ten raport może mieć negatywne lub nieoczekiwane konsekwencje. Jeśli tydzień należy do 2 różnych miesięcy, widoczne będą 2 wiersze dla tego samego tygodnia – po jednym na każdy miesiąc.
Przykład
| Wymiary | Wskaźniki | Data rozpoczęcia | Data zakończenia |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
Zwroty:
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | 2014-04-27 | 43 |
* pierwszy dzień tygodnia
Rozwiązanie
Usuń z raportu kolumnę MONTH.
WEEK | CLICKS |
|---|---|
| 2014-04-27 | 93 |
Łączenie wartości wymiarów
Przy wysyłaniu żądania wymiarów takich jak powiązane np. z platformami (komputery, zaawansowane urządzenia mobilne itp.) pokazywane są tylko platformy, na których aktywność jest aktywna. Jeśli w danym dniu, tygodniu lub miesiącu nie odnotowano żadnych wizyt z zaawansowanych telefonów komórkowych, nie pojawią się informacje z tej kategorii.
Przykład
| Wymiary | Wskaźniki | Data rozpoczęcia | Data zakończenia |
|---|---|---|---|
PLATFORM_TYPE_NAMEMONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
Zwroty:
| MIESIĄC | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Komputer | 100 |
| 2014-03 | Zaawansowane komórki | 5 |
| 2014-04 | Komputer | 75 |
Rozwiązanie
Podczas przetwarzania wyników raportu załóżmy, że wartość wynosi 0 dla każdej wartości wymiarów, która nie pojawia się w wynikach:
| MIESIĄC | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Komputer | 100 |
| 2014-03 | Zaawansowane komórki | 5 |
| 2014-04 | Komputer | 75 |
| 2014-04 | Zaawansowane urządzenia mobilne | 0 |
Łączenie wielu sąsiednich raportów
Czasami raport jest za duży, aby można go było wygenerować w całości. Aby to zrobić, trzeba utworzyć go zbiorczo. Jeśli Twoja aplikacja tak robi, weź pod uwagę te sytuacje:
- Jeśli używasz wymiarów
WEEKlubMONTHi dzielisz raport w połowie tygodnia lub miesiąca, każdy raport będzie zawierał zduplikowane wpisy z różnymi danymi. - Upewnij się, że wszystkie raporty mają te same dane i wymiary, ponieważ dane mogą nie być łączone w ramach różnych wymiarów.
Konta specjalne
Niektórzy użytkownicy mogą mieć konta AdSense z atrybutami, których nie znasz lub których nie znasz. Pamiętaj, aby wziąć pod uwagę te kwestie:
- wydawców z tysiącami domen lub witryn.
- wydawców, którzy mają tysiące jednostek reklamowych lub kanałów niestandardowych.
- Wydawcy, którzy chcą generować raporty na temat wielu klientów reklamowych (AdSense dla wyszukiwania, AdSense dla wideo itp.),
Wiele kont
Użytkownicy mogą mieć dostęp do więcej niż jednego konta AdSense. Z tego względu przy każdym wywołaniu interfejsu API należy określić identyfikator konta. Wywołanie accounts.list pobiera listę kont, a użytkownik powinien wyświetlić okno wyboru konta. Możesz go pominąć, jeśli liczba pobranych kont wynosi 1.
Zmiany strefy czasowej
Wydawcy AdSense mogą zmienić strefę czasową w dowolnym momencie, co może prowadzić do skoków i spadków w raportach. Więcej informacji znajdziesz w przewodniku o raportowaniu w strefie czasowej lokalnej.