Этот документ предназначен для разработчиков, которые хотят использовать API управления AdSense для получения информации о своей учетной записи AdSense. В этом документе предполагается, что вы знакомы с концепциями веб-программирования и форматами веб-данных.
Прежде чем ты начнешь
Получите аккаунт AdSense
Зарегистрируйтесь или войдите в свою учетную запись AdSense , чтобы начать.
Познакомьтесь с AdSense
Если вы не знакомы с концепциями AdSense, прочтите вводную информацию об AdSense и поэкспериментируйте с пользовательским интерфейсом AdSense, прежде чем приступать к написанию кода.
Выберите свою клиентскую библиотеку
На странице «Клиентские библиотеки и образцы» вы найдете информацию о доступных библиотеках и образцах. Откройте вкладку выбранного языка и перейдите по ссылкам, чтобы загрузить исходный код. Клиентские библиотеки выполняют за вас следующее:
- аутентификация
- открытие услуг
- построение запросов к API
- анализ ответа
Прочтите инструкции по установке и настройке выбранной вами клиентской библиотеки, которые обычно находятся в файле README в корневом каталоге репозитория.
Если у вашей реализации есть особые потребности, например использование неподдерживаемого языка, вы можете делать прямые запросы к API вместо использования клиентской библиотеки.
Зарегистрируйте свое приложение
Чтобы использовать API управления AdSense, вам необходимо зарегистрировать разрабатываемое вами приложение, создав проект и сгенерировав идентификатор клиента.
Зарегистрируйте свое приложениеОтредактируйте файлы конфигурации проекта клиентской библиотеки, используя только что созданные новые учетные данные. Дополнительную информацию можно найти в документации клиентской библиотеки.
Примечание. Учетная запись Google, используемая для регистрации, должна быть вашей учетной записью разработчика , то есть учетной записью, которую вы хотите, чтобы пользователи вашего приложения видели как разработчика приложения. Эту учетную запись не нужно привязывать к логину AdSense , поскольку пользователи будут предоставлять доступ к своим собственным учетным записям во время использования приложения.
Краткое руководство по началу работы
Выполните следующие действия, чтобы сделать первые запросы. Обратите внимание, что эти шаги могут незначительно отличаться в зависимости от используемой библиотеки или языка:
- Используйте соответствующий образец, чтобы получить список рекламных клиентов из учетной записи AdSense. Этот запрос инициирует однократный процесс, в ходе которого пользователь AdSense проверяет подлинность и авторизует ваш проект.
Рекламные клиенты представляют собой связь между учетной записью AdSense и продуктом AdSense, например контентной рекламой или поисковой рекламой. Учетная запись AdSense может иметь один или несколько рекламных клиентов.
- Для веб-приложений пользователи будут перенаправлены на сайт, где они смогут предоставить доступ. После авторизации они будут перенаправлены на URL-адрес обратного вызова, определенный в консоли Google API.
- Установленные приложения работают аналогично. Клиентская библиотека попытается открыть окно браузера и использовать код авторизации. Для приложений Android, Chrome и iOS этот метод зависит от платформы.
- Используйте проводник Google API для
reports.generate
, чтобы запросить следующий отчет:-
date_range: YESTERDAY
-
dimensions: DATE
-
metrics: ESTIMATED_EARNINGS
Отчеты дают вам представление о том, сколько вы зарабатываете, а также о том, что влияет на эти доходы. Их можно запускать на всей учетной записи или на отдельных рекламных блоках с помощью каналов.
-
- Попробуйте запросить тот же отчет из вашего приложения.
- Вы можете фильтровать отчеты по рекламным блокам. Получите список рекламных блоков с помощью
adunits.list
. Обратите внимание, что необходим идентификатор рекламного клиента (получите его на шаге 1). После того, как вы выберете рекламный блок, используйте его идентификатор в параметре фильтра дляreports.generate
:Рекламные блоки — это настраиваемые пользователем заполнители для объявлений, которые определяют некоторые свойства показываемых объявлений (например, размер и форму).
-
date_range: YESTERDAY
-
dimensions: DATE
-
metrics: ESTIMATED_EARNINGS
-
filter: AD_UNIT_ID==ca-pub-123456789:987654321
-
- Попробуйте фильтровать по пользовательским или URL-каналам или смешать несколько фильтров.
Каналы – это инструменты, позволяющие отслеживать эффективность определенного набора рекламных блоков. Существует два типа каналов: URL-адреса и пользовательские. Первый позволяет отслеживать эффективность конкретной страницы или домена, а второй помогает отслеживать эффективность конкретных выбранных пользователем групп рекламных блоков.
Вы готовы начать реализацию с изучения остальных доступных вызовов и ресурсов в справочной документации .