Rozpocznij

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 aplikacji

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

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

    1. 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.
    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 zależy od platformy.
  2. 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.

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