Как мы и объявили в октябре 2011, 1 марта были отключены все старые версии AdWords API. v201109 - текущая и единственная версия интерфейса на данный момент. Проверьте работоспособность ваших приложений! Список необходимых изменений опубликован в нашем блоге.

Мы обновили наши библиотеки для AdWords API для всех поддерживаемых языков.

Основные изменения:

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

Более подробную информацию об API можно получить на нашем сайте. Вопросы всегда можно задать на форуме.

Кратко рассказываем, что нового появилось в программном интерфейсе (API) AdWords за последнее время.

Клиентская библиотека JavaScript

Команда AdWords API разработала и представила новую клиентскую библиотеку для языка JavaScript. Данная библиотека позволяет обращаться к функциям AdWords из браузера или расширения (extension) Google Chrome. Пример использования библиотеки и ссылка на демо-приложение опубликованы в блоге AdWords API.

Подробная документация по селекторам и отчетам

Большинство разработчиков при создании приложений, использующих AdWords API, сталкиваются с необходимостью выбора полей для селекторов и отчетов. Для вашего удобства мы собрали всю необходимую информацию по таким полям в приложениях к документации: типы отчетов и поля селекторов.

Также, на сайте обновился раздел практических советов.

Изменения в географическом таргетинге

• Были обновлены данные по регионам и добавлена возможность таргетинга на уровне городов для 17 стран, включая Украину (полный список стран).
• В новых кампаниях больше нельзя использовать таргетинг типа PolygonTarget, рекомендуется использовать вместо него таргетинг по региону / городу или ProximityTarget.
• Исключена редко используемая опция задания адреса в ProximityTarget. Для включения данных об адресе и номере телефона, используйте LocationExtension.
  

Частичные отказы (PartialFailure) в BulkMutateJobService

С первого августа пакетные (Bulk) операции сервиса BulkMutateJobService типов AdGroupCriterionOperation и AdGroupAdOperation обрабатываются с включенными частичными отказами. Это означает что ошибка, произошедшая при выполнении одной операции, не остановит выполнения всего задания. Соответственно, ответ сервера в случае возникновения ошибки изменился и теперь включает данные об ошибочных операциях. Более подробно в блоге AdWords API.

Обновление документации

Мы обновили перевод документации, в том числе на русский язык. В настоящее время команда работает над переводами для самой последней версии.

Дополнительная информация

Более подробную информацию об API можно получить на нашем сайте. Вопросы всегда можно задать на форуме.

Автор: Даниил Климкин, команда AdWords API

Мы уже давали краткое описание AdWords API и его возможностей. Пришло время перейти от теории к практике. В этой статье я кратко расскажу, как установить одну из клиентских библиотек и сделать первый вызов к интерфейсу.

Здесь и далее я рассчитываю, что у вас уже есть аккаунт в AdWords, а также создан MCC аккаунт и предоставлен ключ разработчика (токен). Аккаунты должны быть связаны.

В качестве примера рассмотрю библиотеку Ruby для платформы GNU / Linux. Данную библиотеку можно скачать с нашего сайта или установить стандартными средствами платформы. Библиотеки для других языков можно найти здесь.

Установим библиотеку стандартными средствами (ruby 1.8):

$ gem install google-adwords-api

Есть несколько способов задать данные для авторизации (см. README), но самый простой из них - конфигурационный файл по умолчанию. Он идет в пакете библиотек, а также доступен в репозитории. Внесем необходимые изменения и сохраним его как adwords_api.yml в домашнем каталоге:

---
:authentication:
  :method: ClientLogin
  :developer_token: ваш_ключ_разработчика
  :user_agent: идентификатор_приложения
  :email: логин_для_авторизации
  :password: пароль_для_авторизации
  :client_email: логин_клиентского_аккаунта
:service:
  :environment: Sandbox

Необходимо указать логин и пароль MCC-аккаунта и ваш ключ разработчика. Логин (или цифровой идентификатор) клиентского аккаунта указывается только если необходимо работать с данными конкретного клиента. Поле ‘environment’ указывает на то, что мы будем обращаться к тестовой среде (sandbox). Обращаю внимание, что для работы с sandbox ключ разработчика получать не нужно, см. документацию.

Всё готово, можно выполнять запрос. Для этого необходимо:

1. Подключить библиотеку adwords_api:

require 'adwords_api'

2. Создать объект AdwordsApi:

adwords = AdwordsApi::Api.new

3. Получить экземпляр необходимого сервиса:

campaign_srv = adwords.service(:CampaignService, :v201101)

4. Выполнить запрос:

response = campaign_srv.get({
    :fields => ['Id', 'Name', 'Status'],
    :ordering => [{:field => 'Name',
                   :sort_order => 'ASCENDING'}]
})

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

Более подробную информацию об API можно получить на нашем сайте. Вопросы всегда можно задать форуме.

Автор: Даниил Климкин, команда AdWords API

При реализации большинства проектов, использующих Google AdWords, рано или поздно возникает вопрос масштабируемости. С увеличением числа товаров, разделов сайта, объявлений или клиентов управление компаниями через пользовательский интерфейс становится утомительным и начинает занимать слишком много времени. В то же время, большая часть информации, используемой для создании кампании и объявлений, уже доступна пользователям в электронном виде.

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

В таком случае на помощь может прийти программный интерфейс AdWords (AdWords API). Он позволяет автоматизировать работу с системой AdWords и легко выполнять большой объем операций. API также практически единственный возможный путь оперативного обновления объявлений, такого, например, как указание текущей цены товара прямо в объявлении.

AdWords API - это набор сервисов, позволяющий создавать приложения для управления кампаниями AdWords и всеми связанными с этим объектами. API основан на протоколе SOAP 1.1 и доступен из любой среды, данный протокол поддерживающей. Для ускорения разработки мы предоставляем также клиентские библиотеки, позволяющие работать с API на более высоком уровне, для всех популярных платформ.

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

С использованием AdWords API вы можете автоматически создать кампании (на основе списка ваших товаров), объявления (используя описания продуктов из вашей базы данных), ссылки на соответствующие разделы вашего сайта, контекстный и географический таргетинг и другие параметры. Что важно, разработав один раз приложение для создания кампании, вы можете использовать его каждый раз при получении новых поступлений, обновляя ваши рекламные кампании практически мгновенно!

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

Как уже было сказано, AdWords API - это набор сервисов. Каждый из сервисов имеет свое назначение и как правило работает только с одной группой объектов.

Приведу краткую таблицу, характеризующую весь набор сервисов.