Rozpocznij

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 aplikacji

Edytuj 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:

  1. 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.

    1. 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.
    2. 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.
  2. 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.

  3. Spróbuj poprosić o ten sam raport ze swojej aplikacji.
  4. 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 funkcji reports.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
  5. 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.