Ten dokument jest przeznaczony dla deweloperów, którzy chcą za pomocą interfejsu AdSense Management API uzyskiwać informacje o swoim koncie AdSense. Zakładamy w nim, że masz wiedzę z zakresu programowania i formatów danych z sieci.
Zanim rozpoczniesz
Załóż konto AdSense
Aby rozpocząć, zarejestruj się lub zaloguj na swoje konto AdSense.
Poznaj AdSense
Jeśli nie znasz jeszcze AdSense, przeczytaj wprowadzenie do AdSense i poeksperymentuj z interfejsem AdSense, zanim zaczniesz pisać kod.
Wybierz bibliotekę klienta
Na stronie Biblioteki klienta i przykłady znajdziesz informacje o dostępnych bibliotekach i przykładach. Kliknij kartę wybranego języka i użyj linków, aby pobrać źródło. Biblioteki klienta obsługują te funkcje:
- uwierzytelnienie
- odkrywanie usług
- tworzeniu żądań kierowanych do API
- analiza odpowiedzi
Przeczytaj instrukcje instalowania i konfigurowania wybranej biblioteki klienta, która zwykle znajduje się w pliku README w katalogu głównym repozytorium.
Jeśli Twoja implementacja ma specjalne potrzeby, np. używasz nieobsługiwanego języka, możesz wysyłać bezpośrednie żądania do interfejsu API zamiast korzystać z biblioteki klienta.
Rejestrowanie aplikacji
Aby korzystać z interfejsu API do zarządzania AdSense, musisz zarejestrować aplikację, którą tworzysz, tworząc projekt i generując identyfikator klienta.
Rejestrowanie aplikacjiZmodyfikuj pliki konfiguracji projektu biblioteki klienta, korzystając z nowo utworzonych danych logowania. Więcej informacji znajdziesz w dokumentacji biblioteki klienta.
Uwaga: konto Google użyte do rejestracji powinno być kontem dewelopera, czyli kontem, które użytkownicy aplikacji mają widzieć jako jej dewelopera. To konto nie musi być powiązane z loginem AdSense, ponieważ podczas korzystania z aplikacji użytkownicy będą przyznawać dostęp do swoich kont.
Szybki samouczek
Wykonaj poniższe czynności, by wysłać pierwszą prośbę. Te kroki mogą się nieznacznie różnić w zależności od biblioteki i języka, którego używasz:
- Użyj odpowiedniej próbki, aby pobrać listę klientów reklam z konta AdSense. To żądanie inicjuje jednorazowy proces, w ramach którego użytkownik AdSense uwierzytelnia i autoryzuje Twój projekt.
Klienci reklam reprezentują powiązanie między kontem AdSense a usługą AdSense, np. reklamami z treścią lub reklamami w wyszukiwarce. Konto AdSense może mieć jednego klienta reklamowego lub większą ich liczbę.
- W przypadku aplikacji internetowych użytkownicy są przekierowywani do witryny, w której mogą przyznać dostęp. Po autoryzacji zostaną przekierowani pod adres URL wywołania zwrotnego zdefiniowany w konsoli interfejsów API Google.
- Zainstalowane aplikacje działają podobnie. Biblioteka klienta spróbuje otworzyć okno przeglądarki i użyć kodu autoryzacji. W przypadku aplikacji na Androida, Chrome i iOS ta metoda zależy od platformy.
- Za pomocą eksploratora interfejsów API Google dla platformy
reports.generate
poproś o ten raport:date_range: YESTERDAY
dimensions: DATE
metrics: ESTIMATED_EARNINGS
Raporty zawierają informacje o tym, ile zarabiasz, a także o tym, co ma na nie wpływ. Mogą być wyświetlane na całym koncie lub w podzbiorze jednostek reklamowych za pomocą kanałów.
- Spróbuj poprosić o ten sam raport w swojej aplikacji.
- Raporty możesz filtrować według jednostek reklamowych. Pobierz listę jednostek reklamowych za pomocą parametru
adunits.list
. Pamiętaj, że potrzebny jest identyfikator klienta wyświetlania reklam (możesz go uzyskać w kroku 1). Po wybraniu jednostki reklamowej użyj jej identyfikatora w parametrze filter dlareports.generate
:Jednostki reklamowe to skonfigurowane przez użytkownika obiekty zastępcze reklam, które definiują niektóre właściwości wyświetlanych reklam (np. rozmiar i kształt).
date_range: YESTERDAY
dimensions: DATE
metrics: ESTIMATED_EARNINGS
filter: AD_UNIT_ID==ca-pub-123456789:987654321
- Spróbuj filtrować według kanału niestandardowego lub URL-a albo użyć kilku filtrów.
Kanały to narzędzia umożliwiające śledzenie skuteczności podzbioru jednostek reklamowych. Są 2 typy kanałów: URL i niestandardowy. Pierwsza z nich umożliwia śledzenie skuteczności na określonej stronie lub w określonej domenie, a druga – w przypadku określonych grup jednostek reklamowych wybranych przez użytkownika.
Możesz już rozpocząć implementację od zapoznania się z pozostałymi dostępnymi wywołaniami i zasobami w dokumentacji referencyjnej.