Общие ошибки, приводящие к отказам SOAP (Часть IV)

Добро пожаловать в четвертую часть серии статей, в которых даются советы и подсказки, как решать возникающие с SOAP проблемы. AdWords API базируется на службе SOAP и обращается к ней. В тоже время, иногда очень трудно отлаживать отказы SOAP. В прошлой статье обсуждались ошибки, связанные со случаем «операция не существует». В этой статье будут рассмотрены ошибки SOAP, связанные с проверкой. Предыдущие статьи находятся здесь: статья 1, статья 2, статья 3.

Отказы проверки

В этом случае Вы получаете сообщение об ошибке «Один или несколько переданных элементов не прошли проверку» («One or more input elements failed validation») – код ошибки 122. В этом случае в ответе детализируются поля, содержащие последовательность элементов ApiError с элементами найденных ошибок. Могут быть приведены следующие поля:

• index: указывается индекс элемента в исходном массиве, который вызвал ошибку;
  
• code: указывается тип ошибки;
  
• field: имя поля исходного элемента, которое содержит ошибку;
  
• trigger: строка с описанием ошибки;
  
• isExemptable: булева переменная, которая показывает возможность освободиться от ошибки. По умолчанию – «false»;
  
• textIndex: место в тексте, вызвавшее ошибку;
  
• textLength: длина строки, которая привела к ошибке;
  
• detail: описание ошибки.

Общая ошибка, которая попадают в эту категорию, это ошибка нарушения Политики объявлений. Вы получите сообщение «Указанный текст нарушает политику Google» («The text specified for this Creative violates Google policy») – код ошибки 21, при попытке добавить объявление, не соответствующее Политике объявлений Google. Чтобы избежать этой ошибки, проверяйте объявления, используя checkAds(), на их соответствие Политике объявлений Google, и, только потом, добавляйте, используя addAd(). Если объявление нарушает политику, то checkAds() должна возвратить последовательность объектов ApiError, которые описывают нарушения политики. Вы можете, таким образом, проверить поля, которые вызвали нарушения политики. Кроме того, некоторые нарушения могут освобождаться, если флаг isExemptable установлен в «true». В этом случае Вы можете запросить освобождение от политики и добавить свое объявление.

В следующей статье будут рассмотрены ошибки, возникающие при синхронизации аккаунтов или при выполнении одновременных запросов к AdWords API.

Оригинал: Common issues that lead to SOAP faults (Part IV)

Автор: Anash Oommen

Общие ошибки, приводящие к отказам SOAP (Часть III)

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

Операция не существует

Также разработчики могут получать сообщение об ошибке «Тело запроса не содержит оператора или указанного оператора не существует» («The request body did not contain an operation or the specified operation does not exist») – код ошибки 116.

• Наиболее очевидной ошибкой является то, что вызываемый метод не существует. Это может произойти из-за опечатки в имени метода в запросе к SOAP, например GetAccountInfo вместо getAccountInfo. Это также может произойти, если Ваш запрос к SOAP обращается к несуществующей веб-службе.

• Вы можете также получить эту ошибку, если неправильно указали пространство имен для Вашего метода. Например, указанно ниже обращение к https://adwords.google.com/api/adwords/v12/AccountService вызовет ошибку:

<soap:Body>

    <getAccountInfo xmlns="https://adwords.google.com/api/adwords/v11"/>

  </soap:Body>

AdWords API будет игнорировать все идентификаторы, которые не входят в пространство имен, и сообщит об ошибке.

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

Оригинал: Common issues that lead to SOAP faults (Part III)

Автор: Команда AdWords API

Общие ошибки, приводящие к отказам SOAP (Часть II)

Добро пожаловать во вторую часть серии статей, в которых даются советы и подсказки, как решать возникающие с SOAP проблемы. AdWords API базируется на службе SOAP и обращается к ней. В тоже время, иногда очень трудно отлаживать отказы SOAP. В последней статье обсуждалось, что делать при возникновении ошибки SOAP «Неправильный идентификатор разработчика» («Invalid Developer Token»). Здесь будут обсуждаться действия при ошибочных заголовках запросов к SOAP.

Отсутствие заголовка

Новички в разработке с AdWords API могут получать сообщение об ошибке «Клиентский запрос не содержит [тип заголовка] заголовок» («The client request did not contain a [header type] header») – коды ошибок 1, 2, 8…

• Если Вы получили эту ошибку, то наиболее очевидной причиной является то, что Вы не упомянули требуемого для SOAP заголовка в своем XML вызове. Каждый запрос к SOAP требует следующих заголовков: «email», «password», «developerToken», «applicationToken», «useragent». Кроме того, Вам может потребоваться заголовок «clientEmail» или «clientCustomerId» в зависимости от используемого метода API.

• Другая возможная причина получения этой ошибки состоит в том, что Вы упомянули все необходимые заголовки, но использовали ошибочное пространство имен XML в своем XML. Например, если Вы отправляете заголовок запроса, описанный ниже, к https://adwords.google.com/api/adwords/v12/AccountService , то должны получить ошибку отсутствия заголовка email.

<soap:Header>

   <email xmlns="https://adwords.google.com/api/adwords/v11">ваш_e-mail</email>

   <!--more nodes-->

</soap:Header>

• Наилучший способ решения этой проблемы состоит в том, чтобы включать в SOAP XML проверку Ваших запросов XML к SOAP для ошибочных значений заголовков. Хорошо сформированный запрос к SOAP выглядит примерно так:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

   <soap:Header>

     <applicationToken xmlns="https://adwords.google.com/api/adwords/v12">INSERT_APPLICATION_TOKEN_HERE</applicationToken>

     <developerToken xmlns="https://adwords.google.com/api/adwords/v12">INSERT_DEVELOPER_TOKEN_HERE</developerToken>

     <email xmlns="https://adwords.google.com/api/adwords/v12">INSERT_YOUR_EMAIL_HERE</email>

     <password xmlns="https://adwords.google.com/api/adwords/v12">INSERT_YOUR_PASSWORD_HERE</password>

     <useragent xmlns="https://adwords.google.com/api/adwords/v12">INSERT_YOUR_USERAGENT_HERE</useragent>

   </soap:Header>

   <soap:Body>

     <getAccountInfo xmlns="https://adwords.google.com/api/adwords/v12"/>

   </soap:Body>

</soap:Envelope>

Если Вы используете образцы исходного кода AdWords API, то заголовки содержатся в самом исходном коде. Если Вы используете клиентские библиотеки AdWords API, то, чаще всего, заголовки находятся в соответствующих конфигурационных файлах. Клиентская библиотека .NET использует app.config, клиентские библиотеки Java и Ruby используют файл adwords.properties, APIlity использует authentication.ini для хранения значений заголовков. Библиотека Python использует auth.pkl. Вы можете просмотреть эти файлы и увидеть в них необходимые заголовки. Наконец, все клиентские библиотеки имеют соответствующий конструктор, который может принять необходимые заголовки при инициализации библиотеки, так что Вам требуется при ошибке проверять также код инициализирующий библиотеку.

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

Оригинал: Common issues that lead to SOAP faults (Part II)

Автор: Anash Oommen

Общие ошибки, приводящие к отказам SOAP (Часть I)

AdWords API базируется на службе SOAP и обращается к ней. В тоже время, иногда очень трудно отлаживать отказы SOAP. Было бы полезно описать наиболее распространенные ошибки, приводящие к отказам SOAP, с которыми сталкиваются разработчики на AdWords API. В дальнейшем будет опубликован ряд статей по этой теме. Надеюсь, что разработчикам это окажется полезным.

Неправильный идентификатор разработчика (Invalid Developer Token)

Наиболее распространенная ошибка, с которой сталкиваются разработчики в первые обращаясь к API «The developer token is invalid» («Неправильный идентификатор разработчика») – код ошибки 42. Есть несколько основных причин, благодаря которым Вы можете получить эту ошибку.

• Если Вы впервые делаете обращение к API, то убедитесь, что обращение происходит в аккаунте рабочей среды (adwords.google.com), а не в песочнице AdWords API (sandbox.google.com). Образец кода API по умолчанию настроен для отправки запроса в аккаунте песочницы, а не рабочей среды. Таким образом, если Вы программируете, используя примеры кода, то, вероятнее всего, это стало причиной ошибки.

• То же самое, если Вы используете клиентские библиотеки AdWords API, то по умолчанию они настроены для отправки запросов в песочнице AdWords API. Если Вы используете клиентские библиотеки Java, .NET или Ruby, убедитесь в том, что в секции аттестата пользователя конфигурационного файла (adwords.properties или app.config) не сипользуется ключ «alternateUrl». Для библиотеки Apility, убедитесь, что в файле settings.ini ключ Use_Sandbox установлен в «No». Для клиентской библиотеки Python, убедитесь, что Вы не инициализируете аргумент server="'https://sandbox.google.com'", при инициализации класса службы. Кроме того, каждая библиотека имеет соответствующий конструктор, который принимают аттестат в качестве параметра инициализации библиотеки. Убедитесь, что при инициализации Вы не передаете «alternateUrl». Наконец, некоторые библиотеки могут предоставлять вспомогательные функции (например, клиентская библиотека .NET предоставляет useSandbox()), которая позволяет Вам переключаться между рабочей средой и песочницей во время выполнения. Убедитесь, что эти функции не используются в Вашем коде.

• Менее распространенной, но более очевидной, причиной этой ошибки, является то, что признак разработчика в Вашем коде является недействительным. Шансы этого случая небольшие, поскольку большинство разработчиков копируют свой признак из аккаунта MCC. Однако, это может произойти, если Вы по ошибке поменяли заявку и признак разработчика, или если Вы сбросили признак разработчика в своем аккаунте, но забыли обновить код. Неоднократная проверка кода, должна помочь Вам обнаружить место ошибки в коде.

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

Оригинал: Common issues that lead to SOAP faults (Part I)

Автор: Anash Oommen

Проект: AdWords API Local Database Sync

В сентябре был анонсирован проект AdWords API Local Database Sync. Скрипты из этого проекта могут быть использованы для создания отчетов в AdWords API, сохранения результатов в локальной базе данных (используется SQLite) и выполнения запросов к этой базе данных.

Одна из рекомендаций, из перечисленных в статье «AdWords API: Top Ten Practices», состояла в хранении всего аккаунта AdWords в локальной базе данных и поддержании этой базы данных в актуальном состоянии при помощи AdWords API. Запросы к локальной базе данных имеют преимущество в скорости и цене перед запросами AdWords API, особенно для ответов на на вопросы типа «Как много активных кампаний создано во всех моих аккаунтах AdWords?» Поддержка истории в локальной базе данных может также помочь Вам ответить на такие вопросы, на которые AdWords API не сможет дать ответ, например: «Какие ключевые слова были изменены в аккаунте в течение последней недели?». С AdWords API Local Database Sync Вы сможете получить ответы на подобные вопросы.

Некоторые технические подробности: Скрипты написаны на Python и сипользуют библиотеки SOAPpy для доступа к службе AdWords API SOAP. Код на Python использует API dbapi2, и по умолчанию использует реализацию SQLite для сохранения данных в файле базы данных SQLite в локальной файловой системе. Есть возможность замены библиотек SQLite на библиотеку другой базы данных, которая поддерживает dbapi2.

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

Посетите этот проект на Google Code и попробуйте его!

Оригинал: Now Available: AdWords API Local Database Sync

Автор: Jeffrey Posnick

О способах торгов групп объявлений

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

Торги CPC

Правильная настройка

AdWords API может быть использован для управления критериями как ключевого слова, мест размещения, так и обоими сразу в рамках одной группы объявлений. Однако вначале Вы должны быть уверены, что Ваша группа объявлений правильно настроена, чтобы принимать оба этих типа критериев. Для того, чтобы Ваша группа объявлений принимала критерий ключевого слова, группа должна иметь атрибут keywordMaxCpc и/или keywordContentMaxCpc, которые позволяют устанавливать максимальную цену перехода. Для того, чтобы Ваша группа объявлений могла принимать критерий мест размещения, должен быть установлен атрибут siteMaxCpc. Отсутствие установленного значения атрибута siteMaxCpc является распространенной причиной ошибки SOAP 74 типа, при попытке добавления критерия мест размещения к существующей группе объявлений. При этом Вы получите вводящее в заблуждение сообщение: «Критерий этого типа является недействительным. Приемлемыми значениями являются «Места размещения» и «Ключевое слово». Места размещения и Ключевые слова не могут быть использованы в группах объявлений в одной и той же рекламной кампании» ("This criterion type is invalid. Acceptable values are 'Website' and 'Keyword'. Websites and keywords may not be used in ad groups in the same campaign."). Чтобы избежать этого, Вам надо просто настроить значение siteMaxCpc.

Когда и какая ставка срабатывает?

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

Предположим, что мы добавили в группу объявлений ключевые слова «кризис» и «банки» и место размещения «forex.ua». Рекламная кампания имеет стратегию торгов CPC и показывает объявления в поиске Google, на сайтах поисковых партнеров и на релевантных страницах в сети партнеров Google.

• Пользователь вводит запрос «кризис банков» в Google или на сайте его поискового партнера. В этом случае AdWords использует значение keywordMaxCpc для определения ставки.

• Пользователь просматривает статью о банковском кризисе на сайте forex.ua. В этом случае Вы имеете домен «forex.ua» в качестве одного из критериев места размещения, и ставка будет определена либо из атрибута siteMaxCpc группы объявлений, либо из атрибута siteMaxCpc критерия места размещения. Если значение maxCpc определено в критерии, то оно имеет приоритет. Даже если место размещения будет содержать слова, определенные как ключевые слова в группе объявлений, установка значений ставок будет нацелена на значения для мест размещения, так как они считаются более характерными в этом случае.

• Пользователь посещает какой-либо сайт со статьей о банковском кризисе, и сайт является рекламным партнером Google (т.е. на сайте установлен AdSense). Ключевое слово «кризис банков» вызовет показ объявления на этом сайте. В этом случае AdWords сначала проверяет значение maxCpc для ключевого слова, если оно не установлено, то используется keywordContentMaxCpc группы объявлений. Если keywordContentMaxCpc не установлен, то используется значение keywordMaxCpc. Для установки стоимости в этом случае siteMaxCpc никогда не используется.

(Кстати, если Вам любопытно, когда и какая ставка будет использоваться для группы объявлений, ориентированной, как на ключевые слова, так и на места размещения, при торгах, то Вы включить свой сайт в список мест размещения).

Торги CPM

Если Вы создали Вашу кампанию с торгами CPM (потому что Вы хотите использовать графические и видео-объявления в партнерской сети Google, и не будете использовать текстовые объявления в поиске Google), то соответствующую настройку группе объявлений можно задать только в siteMaxCpm. Это значительно упрощает настройку, по сравнению с вариантом, когда Вы используете торги CPC.

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

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

Оригинал: Understanding Ad Group Bidding Options

Авторы: Adam Rogal and Jeffrey Posnick

Получение информации о числе поисков ключевых слов в AdWords API v13

Ранее я уже рассказывал о таких нововведениях в AdWords API v13, как информация о показателе качества ключевого слова, новые типы отчетов и поддержку новых способов географического нацеливания. Существует, однако, одна новая функция, которая не получила должного внимания. Начиная с v13 появился метод getKeywordVariations() из Keyword Tool Service, который возвращает информацию о числе поисков в среднем и за последний месяц для ключевого слова с учетом ограничений. С тех пор, как в июле эта функция была внедрена в Инструмент подсказки ключевых слов, AdWords регулярно получал запросы от разработчиков, которые стремятся получать такого рода информацию о ключевых словах из AdWords API, поэтому в Google посчитали целесообразным разъяснить, каким образом Вы можете получать данные о поиске ключевых слов.

Допустим, Вы рассматриваете возможность добавления ключевого слова москва в одну из групп объявлений, и Вас интересует, сколько раз это ключевое слово обычно искали. Причем Вы заинтересованы в данных, относящихся к русскому языке в регионе «Россия», причем Вы хотите получить данные только по ключевому слову без учета синонимов. Для этого Вам необходимо послать следующий SOAP запрос:

  <Body> 

<getKeywordVariations>       

<seedKeywords>

<negative>false</negative> <text>москва</text>         <type>Broad</type>       </seedKeywords>       <useSynonyms>false</useSynonyms>       <language>ru</language>       <countries>RU</countries>

</getKeywordVariations>   

</Body>

Если сделать этот SOAP запрос к AdWords API v13, то Вы получите огромное количество результатов, которые содержат Ваше ключевое слово Москва, как, например, Москва центр или магазин москва. Каждый вариант будет иметь свои собственные данные о числе поисков, и все эти данные потенциально полезны. Однако изначально нас интересовало число поисков ключевого слова Москва. Так как Ваше оригинальное ключевое слово точно находится в данных, возвращаемых getKeywordVariations(), то Вам просто необходимо найти его точное совпадение. В нашем случае результирующий XML должен выглядеть следующим образом:

  <moreSpecific>

    <text>москва</text>  

   <language>ru</language>   

  <advertiserCompetitionScale>4</advertiserCompetitionScale>

    <avgSearchVolume>1830000</avgSearchVolume>   

  <lastMonthSearchVolume>1830000</lastMonthSearchVolume>

  </moreSpecific>

Итак, теперь мы знаем, что в течение последних 12 месяцев среднемесячный объем поиска по ключевому слову Москва был 1830000 запросов, и в прошлом месяце объем поиска составил 1830000 запросов. Москва оказывается очень популярный город!

Надеюсь, что данные, возвращаемые методом getKeywordVariations() в AdWords API v13, помогут Вам быстрее достигать своих целей и эффективнее оптимизировать свои кампании в AdWords.

Оригинал: v13's New Keyword Search Volume Info

Автор: Jeffrey Posnick

Удачные новогодние каникулы! Получайте больше единиц API

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

20 октября и до 15 января следующего года была запущена программа: все разработчики будут получать бонус в размере 20% единиц API без каких-либо дополнительных затрат.

• Все разработчики могут приобретать единицы API по курсу 1200/$0.25 вместо 1000/$0.25 до 15 января 2009.
  
• Рекламодатели, которые имеют право на бесплатные единицы API будут получать кредиты по ставке 300/$ на затраты AdWords, вместо 250/$ на затраты AdWords. Эти начисления праздничных бонусов будут основаны на затратах в предыдущие месяцы.
  

Посмотреть свою квоту API Вы можете в аккаунте MCC по ссылке «My Account» во вкладке «AdWords API Center».

Как обычно, Google рекомендует Вам использовать API как можно более эффективно. Например, рекомендуется использовать методы для работы со списками (такие как addCampaignList), когда это уместно, потому что они наиболее эффективны финансово для обработки больших массивов данных. Кроме того, ранее уже писалось об увеличении эффективности ПО для экономии Ваших единиц API. Более подробную информацию об экономии единиц API Вы можете получить из сообщения, посвященного только этой теме, официального блога AdWords API.

Оригинал: Happy Holidays! Enjoy more API units

Автор: Adam Wooley

Выпущена AdWords API V13

Google объявила о выпуске AdWords API версии 13 (V13)! В V13 появилось несколько изменений, некоторые из которых описаны ниже. Для получения полного списка изменений в V13, читайте этот документ.

Самое важное в V13

• Новые варианты гео-таргетирования: Нацеливание на несколько географических уровнях (страны, регионы, муниципальные районы, города) в рамках одной кампании, нацеливание на конкретные регионы в нескольких странах в одной кампании, а также настройка вычетательного нацеливания для указанных регионов (например, нацеливание на всю Россию за исключением Татарстана).
  
• Новые отчеты: Генерация новых отчетов Generate Search Query Performance и Geographic Performance, используя ReportService и DefinedReportJob.
  
• Мобильные графические объявления: Используйте новый тип объявлений MobileImageAd для создания графической рекламы для мобильных устройств.
  
• Предлагаемые бюджеты кампаний: Вы можете получить предлагаемый бюджет для Вашей кампании, используя getRecommendedBudgetList.
  
• Активные кампании и группы объявлений: Хотите получать данные только по активным кампаниям и группам объявлений? Теперь это возможно, используя getActiveAdWordsCampaigns и getActiveAdGroups.
  
• Поддержка Ставки первой страницы и Показателя качества: Было добавлено два новых поля для ключевого слова:
  
• firstPageCpc (Ставка первой страницы)
  
• qualityScore (Показатель качества ключевого слова)
  

V12 будет отключена в 2009

В соответствии со своей политикой версий, Google будет поддерживать V12 в течение четырех месяцев, начиная с 20 октября 2008, после чего она будет отключена. Поэтому, пожалуйста, убедитесь, что Вы провели обновление до V13 до 20 февраля 2009. Как и в случае с каждой новой версией AdWords API, Google настоятельно рекомендует ознакомиться с обновлениями в Руководстве разработчика, чтобы узнать больше об этой новой версии.

Оригинал: AdWords API Version 13 Now Available

Автор: Google Inc.

Сгоняем «жир» со своего ПО

Ограничение API-калорий Вашего ПО

Один из вопросов, которые получает Google от разработчиков ПО, как потратить меньшее число единиц API, и если ПО написано недостаточно аккуратно, то, возможно, Вы потратите неоправданное много единиц API. Однако Вы можете ограничить Ваше ПО в отношении таких аппетитов с помощью следующих простых рекомендаций:

Два пути до цели.

Вы запускаете множество кампаний по всему аккаунту? Тогда лучше использовать «Campaign Performance reports» вместо метода «getCampaignStats». Однако, если Вы поддерживаете несколько кампаний, то второй способ лучше первого.

Взгляд с высоты птичьего полета.

Иногда требуется получить большую часть данных из аккаунта, причем с некоторыми деталями. Если у Вас много кампаний, групп объявлений, самих объявлений и ключевых слов, то лучше всего использовать «Structure report». Это лучший подход в получении структурированного списка, чем более масштабируемые методы.

Один раз посмотреть, семь раз посчитать.

Если Вам часто необходим один и тот же отчет, то лучше использовать периодическое создание отчетов создаваемых с помощью «Центра отчетов» AdWords. Они будут создаваться автоматически каждый день, каждую неделю или каждый месяц как Вы сами укажете, и все Вам остается, это использовать методы «Report Service».

Проверка данных перед отправкой.

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

Могу ли я работать со списками данных?

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

Поиск различий.

Распространенная ошибка при изменении элементов (объявления, критерии и т.п.) состоит в том, что обновляются элементы, которые фактически не были изменены. Это увеличивает Ваши расходы без какой-либо пользы! Самый простой способ сохранить Ваши деньги состоит в том, чтобы иметь два списка элементов: один до внесения изменений, а другой после внесения изменений. Перед отправкой изменений, просто сравните два списка и удалите одинаковые элементы.

Клиенты не видят Вашей рекламы.

Ключевые слова Вашей рекламы – Ваше всё. Если Вы используете правильные ключевые слова, то клиенты найдут Ваши объявления. Если же Вы используете неправильные ключевые слова, то Ваш бизнес будет «медленным и печальным». Рассмотрим момент поиска неэффективных ключевых слов. Каждый раз, когда Вы получаете их список, обновляете или проверяете их через статистику API AdWords, то тратите единицы API. Один из лучших способов экономии единиц API в долгосрочной перспективе состоит в том, чтобы каждый раз проверять, что Вы используете все что, необходимо и пропускать все ненужное. Например, можно использовать сервис «Traffic Estimator», т.е. прежде чем добавлять какие-либо элементы, вначале получить представление о том, как много трафика могут генерировать эти ключевые слова.

Пойти поиграть в песочнице.

Вы еще находитесь в стадии разработки ПО или хотите опробовать новые функции? Для этого нет необходимости тратить единицы API. В конце концов, возможность поиграть должен иметь каждый! Для этого в API AdWords есть песочница для тестирования ПО, в ходе его разработки, и этот сервис бесплатен и открыт для всех, так что Вы можете использовать его множество раз, не беспокоясь о счетах.

Проверяйте ценник перед покупкой.

Наконец, Вы должны иметь в виду, что разные методы API AdWords имеют разную стоимость, чтобы это не стало для Вас сюрпризом уже после запуска Вашего ПО. Ознакомиться со списком ставок на методы Вы можете на странице «API Rate Sheet».

Приходилось ли Вам изобретать свои собственные трюки по оптимизации расходов на API Adwords? Если да, то Вы можете поделиться своим опытом с другими!

Оригинал: Your software on a diet!

Автор: Sérgio Gomes

AdWords API - Автоматизация рекламных кампаний

Доклад Рината Сафина на Google University в мае 2007 – «AdWords API - Автоматизация рекламных кампаний».

Рассмотрены следующие вопросы:

• Зачем и для каких случаев необходим AdWords API рекламодателю?
• Как получить доступ к AdWords API?
• Тестирование приложений на базе AdWords API.
• Пример автоматизации создания рекламной кампании на базе AdWords API.
• Пример оптимизации и увеличения ROI рекламной кампании на базе AdWords API.
• Где получить дополнительную информацию об AdWords API?

Отключение V11 API AdWords 26 августа

В соответствии с политикой отключения старых версий AdWords API, будет отключен доступ к версии V11 API во вторник, 26 августа 2008 года. Версия V12 API доступна уже более четырех месяцев вместе со списком ее новых возможностей. Google надеется, что рекламодатели уже воспользовались возможностью улучшить свой программный код.

Последние публично-доступные версии клиентских библиотек поддерживают версию V12 API, поэтому, если Вы используете одну из последних библиотек, то можете узнать в соответствующем файле README, как перейти с версии V11 к V12. Процесс миграции должен быть прост, но необходимо обратить внимание на следующее: тип идентификаторов группы объявлений должен быть не «int», как раньше, а «long».

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

Оригинал: Sunsetting V11 on August 26th, 2008

Автор: Jeffrey Posnick

Снижение ставок в API AdWords

15 апреля Google сообщил о сокращении некоторых ставок за использования API AdWords.

Google внес несколько усовершенствований в свою систему, которые сделали ее более эффективной, и, в конечном счете, привели к экономии средств для пользователей API AdWords.

Сейчас произошло снижение ставок в условных единицах API AdWords на следующие услуги:

Название услуги, условная единица (внутри API AdWords), новая цена

• addAds: 125 -> 50 для каждого элемента
• addCriteria: 25 -> 20 для каждого элемента
• updateCriteria: 10 -> 3 для каждого элемента
• getKeywordVariations: 25 -> 20
• getKeywordsFromSite: 25 -> 20
• estimateAdGroupList: 25 -> 20 для каждого элемента
• estimateCampaignList: 25 -> 20 для каждого элемента
• estimateKeywordList: 25 -> 20 для каждого элемента
• scheduleReportJob: 1000 -> 500

Котировка условных единиц API AdWords по прежнему составляет 0,25 USD (или в эквиваленте местной валюте) за 1000 условных единиц, но за счет уменьшения самих ставок пользователи должны получить существенную экономию.

И, как обычно, Google советует разработчикам использовать методы работы со списками, когда это возможно (например, addCampaignList). Такие методы наиболее эффективны (в том числе с точки зрения затрат) для обработки больших массивов данных.

Оригинал: April API rate sheet reductions, we're not joking :)

Автор оригинала: Debbie Leight

AdWords API вышел из beta-версии

Google окончательно удалила метку "beta" с AdWords API после нескольких лет тестирования и совершенствования новых версий, политики и методов использования API и системы обработки данных.

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

Оригинал: AdWords API Coming Out of Beta

Автор оригинала: Borana Toska