Ten dokument jest przeznaczony dla programistów, którzy chcą uzyskiwać informacje o swoim koncie AdSense za pomocą interfejsu API do zarządzania AdSense. Zakładamy w nim, że znasz koncepcje związane z programowaniem internetowym oraz formaty danych internetowych.
Zanim zaczniesz
Utwórz konto AdSense
Aby rozpocząć, zarejestruj lub zaloguj się na konto AdSense.
Poznaj AdSense
Jeśli nie znasz jeszcze AdSense, zapoznaj się z informacjami wprowadzającymi o tej usłudze i poeksperymentuj z interfejsem AdSense, zanim zaczniesz tworzyć kod.
Wybieranie biblioteki klientów
Na stronie Biblioteki klienta i przykłady znajdziesz informacje o dostępnych bibliotekach i przykładach. Kliknij kartę wybranego języka i skorzystaj z linków, aby pobrać źródło. Biblioteki klienta obsługują następujące zadania:
- uwierzytelnienie
- odkrywanie usług
- tworzenie żądań do interfejsu API
- analiza odpowiedzi
Przeczytaj instrukcje instalowania i konfigurowania wybranej biblioteki klienta. Zwykle można je znaleźć w pliku README w katalogu głównym repozytorium.
Jeśli Twoja implementacja ma szczególne potrzeby, np. używanie 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ć nadaną aplikację, tworząc projekt i generując identyfikator klienta.
Rejestrowanie aplikacjiEdytuj pliki konfiguracji projektu biblioteki klienta przy użyciu 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 deweloper. Konto nie musi być powiązane z loginem AdSense, ponieważ użytkownicy przyznają dostęp do własnych kont podczas korzystania z aplikacji.
Szybki samouczek
Aby wysłać pierwszą prośbę, wykonaj te czynności. Pamiętaj, że czynności te mogą się nieznacznie różnić w zależności od używanej biblioteki i języka:
- Użyj odpowiedniego przykładu, aby pobrać listę klientów reklamowych z konta AdSense. Żądanie inicjuje jednorazowy proces, w którym użytkownik AdSense uwierzytelnia i autoryzuje Twój projekt.
Klienci reklam reprezentują powiązanie między kontem AdSense a usługą AdSense, np. reklamami treści lub reklamami w wyszukiwarce. Konto AdSense może mieć jednego lub wielu klientów reklamowych.
- W przypadku aplikacji internetowych użytkownicy zostaną przekierowani do witryny, w której będą mogli przyznać dostęp. Po autoryzacji zostaną przekierowani na adres URL wywołania zwrotnego zdefiniowany w konsoli interfejsów API.
- 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 jest zależna od platformy.
- Użyj eksploratora interfejsów API dla platformy
reports.generate
, aby zażądać tego raportu:date_range: YESTERDAY
dimensions: DATE
metrics: ESTIMATED_EARNINGS
Raporty zapewniają wgląd w Twoje zarobki oraz wpływ na te zarobki. Za pomocą kanałów reklamy można wyświetlać na całym koncie lub w podzbiorze jednostek reklamowych.
- Spróbuj poprosić o ten sam raport ze swojej aplikacji.
- Raporty możesz filtrować według jednostek reklamowych. Pobierz listę jednostek reklamowych za pomocą właściwości
adunits.list
. Pamiętaj, że potrzebny jest identyfikator klienta reklamy (uzyskaj go z kroku 1). Po wybraniu jednostki reklamowej użyj jej identyfikatora w parametrze filter dla funkcjireports.generate
:Jednostki reklamowe to skonfigurowane przez użytkownika obiekty zastępcze na reklamy. Określają one 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 przefiltrować dane według kanałów niestandardowych lub kanałów URL albo połącz kilka filtrów.
Kanały to narzędzia umożliwiające śledzenie skuteczności podzbioru jednostek reklamowych. Są 2 rodzaje kanałów: URL i niestandardowy. Pierwszy sposób umożliwia śledzenie skuteczności na określonej stronie lub w określonej domenie, a drugi – w określonych grupach jednostek reklamowych wybranych przez użytkownika.
Możesz rozpocząć implementację od pozostałych dostępnych wywołań i zasobów w dokumentacji referencyjnej.