Демонстрационный пример

Основные сведения

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

Регистрация состоит из 4 шагов:

  1. Хост инициирует сеанс установления связи, вызывая метод associationsessions.start.
  2. Хост перенаправляет издателя на URL веб-сайта AdSense, полученный в ответе. Издатель заполняет форму регистрации на сайте.
  3. Издатель возвращается обратно на сайт хоста, при этом в параметре HTTP-запроса передается токен.
  4. Хост проверяет токен, используя метод associationsessions.verify. Если связь была успешно установлена, ответ будет содержать идентификатор аккаунта издателя. Хост должен сохранить его локально, чтобы использовать в последующих вызовах API для этого издателя.

Получив идентификатор аккаунта издателя, хост должен выполнить ещё 2 шага:

  1. Создать новые рекламные блоки в аккаунте издателя, вызвав accounts.adunits.insert.
  2. Создать рекламный код для этих блоков, используя accounts.adunits.getAdCode.

Установка демонстрационного примера

  1. Сначала установите последнюю версию клиентской библиотеки для Python. Пакеты можно найти на вкладке Downloads (Загрузки) на странице проекта, однако мы рекомендуем использовать для загрузки и установки специальный инструмент – pip.
  2. Загрузите и установите Django версии 1.5.x (более ранние и поздние могут вызвать проблемы совместимости). Для этого также рекомендуется использовать pip.
  3. Загрузите и установите демонстрационный пример:
  4. git clone https://code.google.com/p/adsense-apis-showcase
  5. Чтобы добавить информацию базы данных, измените файл samplehost/settings.py, задав поля ENGINE и NAME. Вот примерные настройки sqlite3:
  6. DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.sqlite3',
            'NAME': '/path/to/your_db.db',
            'USER': '',
            'PASSWORD': '',
            'HOST': '',
            'PORT': '',
        }
    }
    
  7. В этом же файле задайте для параметра TEMPLATE_DIRS абсолютный путь к каталогу с файлами шаблонов. Это подкаталог templates/ в вашем пакете установки примера.
  8. Когда проект Django будет полностью настроен, необходимо инициализировать базу данных. Из корня пакета установки примера запустите следующую команду:
  9. python manage.py syncdb
  10. Затем добавьте свои учетные данные разработчика в файл client_secrets.json. Вы найдете их на консоли API, после того как создадите идентификатор клиента для веб-приложения.
  11. И наконец, пройдите начальную аутентификацию в API. Будет создан файл adsensehost.dat (в нем будут храниться данные, возвращенные службой аутентификации Google). Для этого необходимо использовать аккаунт хоста. Из корня пакета установки примера запустите следующую команду:
    python api_utils.py

В этом видео показан процесс установки демонстрационного примера:

Запуск демонстрационного примера

  1. Запустите приложение на локальном сервере Django. Из корня пакета установки примера выполните следующую команду:
    python manage.py runserver
  2. Обязательно скопируйте URL службы. Обычно это http://localhost:8000 (или, при использовании адреса IPv4, http://127.0.0.1:8000), но он может выглядеть и немного иначе.
  3. Перейдите по этому URL в браузере и нажмите на единственный доступный блог. Вы увидите пример блога без объявлений. Представьте, что этот блог принадлежит вам и вы хотите получать доход от рекламы в нем.
  4. Откройте страницу администрирования. Вы увидите ссылку Monetize your blog with AdSense ("Монетизируйте свой блог с помощью AdSense"). Нажмите на нее.
  5. Вы перейдете на страницу регистрации в AdSense, где сможете создать новый аккаунт или войти в уже существующий.
  6. Выполнив все шаги, вы перейдете на URL обратного вызова (по умолчанию – http://localhost:8000/callback).
  7. Система проверит полученный токен, создаст рекламный блок и код для него, после чего перенаправит вас обратно в блог, где вы увидите объявление вверху страницы. На странице администрирования будет представлен идентификатор издателя для только что созданного (или связанного) вами аккаунта издателя.

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

Оставить отзыв о...

Текущей странице
AdSense Host API
AdSense Host API