Начало работы

Этот документ предназначен для разработчиков, которые хотят использовать API управления AdSense для получения информации о своей учетной записи AdSense. В этом документе предполагается, что вы знакомы с концепциями веб-программирования и форматами веб-данных.

Прежде чем ты начнешь

Получите аккаунт AdSense

Зарегистрируйтесь или войдите в свою учетную запись AdSense , чтобы начать.

Познакомьтесь с AdSense

Если вы не знакомы с концепциями AdSense, прочтите вводную информацию об AdSense и поэкспериментируйте с пользовательским интерфейсом AdSense , прежде чем приступать к написанию кода.

Выберите свою клиентскую библиотеку

На странице «Клиентские библиотеки и образцы» вы найдете информацию о доступных библиотеках и образцах. Откройте вкладку выбранного языка и перейдите по ссылкам, чтобы загрузить исходный код. Клиентские библиотеки выполняют за вас следующее:

  • аутентификация
  • открытие услуг
  • построение запросов к API
  • анализ ответа

Прочтите инструкции по установке и настройке выбранной вами клиентской библиотеки, которые обычно находятся в файле README в корневом каталоге репозитория.

Если у вашей реализации есть особые потребности, например использование неподдерживаемого языка, вы можете делать прямые запросы к API вместо использования клиентской библиотеки.

Зарегистрируйте свое приложение

Чтобы использовать API управления AdSense, вам необходимо зарегистрировать разрабатываемое вами приложение, создав проект и сгенерировав идентификатор клиента.

Зарегистрируйте свое приложение

Отредактируйте файлы конфигурации проекта клиентской библиотеки, используя только что созданные новые учетные данные. Дополнительную информацию можно найти в документации клиентской библиотеки.

Примечание. Учетная запись Google, используемая для регистрации, должна быть вашей учетной записью разработчика , то есть учетной записью, которую вы хотите, чтобы пользователи вашего приложения видели как разработчика приложения. Эту учетную запись не нужно привязывать к логину AdSense , поскольку пользователи будут предоставлять доступ к своим собственным учетным записям во время использования приложения.

Краткое руководство по началу работы

Выполните следующие действия, чтобы сделать первые запросы. Обратите внимание, что эти шаги могут незначительно отличаться в зависимости от используемой библиотеки или языка:

  1. Используйте соответствующий образец, чтобы получить список рекламных клиентов из учетной записи AdSense. Этот запрос инициирует однократный процесс, в ходе которого пользователь AdSense проверяет подлинность и авторизует ваш проект.

    Рекламные клиенты представляют собой связь между учетной записью AdSense и продуктом AdSense, например контентной рекламой или поисковой рекламой. Учетная запись AdSense может иметь один или несколько рекламных клиентов.

    1. Для веб-приложений пользователи будут перенаправлены на сайт, где они смогут предоставить доступ. После авторизации они будут перенаправлены на URL-адрес обратного вызова, определенный в консоли API.
    2. Установленные приложения работают аналогично. Клиентская библиотека попытается открыть окно браузера и использовать код авторизации. Для приложений Android, Chrome и iOS этот метод зависит от платформы.
  2. Используйте проводник API для reports.generate , чтобы запросить следующий отчет:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    Отчеты дают вам представление о том, сколько вы зарабатываете, а также о том, что влияет на эти доходы. Их можно запускать на всей учетной записи или на отдельных рекламных блоках с помощью каналов.

  3. Попробуйте запросить тот же отчет из вашего приложения.
  4. Вы можете фильтровать отчеты по рекламным блокам. Получите список рекламных блоков с помощью adunits.list . Обратите внимание, что необходим идентификатор рекламного клиента (получите его на шаге 1). После того, как вы выберете рекламный блок, используйте его идентификатор в параметре фильтра для reports.generate :

    Рекламные блоки — это настраиваемые пользователем заполнители для объявлений, которые определяют некоторые свойства показываемых объявлений (например, размер и форму).

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. Попробуйте фильтровать по пользовательским или URL-каналам или смешать несколько фильтров.

    Каналы – это инструменты, позволяющие отслеживать эффективность определенного набора рекламных блоков. Существует два типа каналов: URL-адреса и пользовательские. Первый позволяет отслеживать эффективность конкретной страницы или домена, а второй помогает отслеживать эффективность конкретных выбранных пользователем групп рекламных блоков.

Вы готовы начать реализацию с изучения остальных доступных вызовов и ресурсов в справочной документации .