Api update rundown (russian)

AdWords API Workshops – All rights reserved


Новые возможностиAdWords API

Danial Klimkin, Google Inc.


● Новая функциональность

○ Импорт офлайн конверсий

○ Новые отчеты

○ Контроль видимости бюджетов

Основные изменения в v201309 (1/3)


● Другие важные изменения:

○ Имена кампании и группы -- обязательные поля

○ Ограничение по переключению настроек сети кампании

○ Статистика доступна только в отчетах



● Возможости, выведенные из Beta

○ Display criteria bid modifiers

○ Динамические поисковые объявления

○ AdGroup-level feeds (site links)

○ Flexible bidding strategies

○ Location bid modifiers



Новая функциональность


● Позволяет вручную зарегистрировать конверсии● конверсии, отслеживаемые вручную● данные от других систем слежения за конверсиями

● До 90 дней между кликом и конверсией● и значение можно менять

● Данные по конверсиям можно использовать для:● Flexible bidding● Отчеты по конверсиям (search funnels)

Импорт офлайн конверсий (1/3)


1. Включите автоматическое добавление тэгов

2. Сохраняйте данные о переходах в БД

3. При конверсии, ставьте отметку в БД

4. Регулярно загружайте конверсии в AdWords



● Для загрузки конверсии:

a. Создайте тип конверсии■ через UI или ConversionTrackerService

b. Загружайте конверсии■ OfflineConversionFeedService



Создание типа конверсии (код)

UploadConversion uc = new UploadConversion();

uc.setCategory(ConversionTrackerCategory.SIGNUP);

uc.setName("Freemium signup");

uc.setViewthroughLookbackWindow(30);

uc.setCtcLookbackWindow(90);

ConversionTrackerService.mutate(ADD, uc);

// NOTE: wait 6 hours after creating before uploading.


OfflineConversionFeed feed = new OfflineConversionFeed();

feed.setConversionName("Freemium signup");

feed.setConversionTime(conversionTime);

feed.setGoogleClickId(gClid);

feed.setConversionValue(3.50); // optional, > 0

OfflineConversionFeedService.mutate(ADD, feed);

// conversion can take up to 3 hours to be processed fully

Загрузка данных конверсии (код)


Другие важные изменения


● Обязательные поля

● Должны быть уникальны

● (всё)

Имена кампаний и групп объявлений


● Display кампании значительно изменились

● Больше нельзя переключать targetSearchNetwork

● Ошибка: TargetError.TARGET_ERROR

● Другие настройки не затронуты

● Нельзя отключать все сети одновременно

Переключение настроек сети кампаний


● Многие cервисы (7) содержали объекты типа Stats

● AdGroupService, CampaignService, MutateJobService...

● Больше нет

● Используйте отчеты для получания статистики

● API отчетов очень прост

● Все(*) уже используют отчеты

Статистика доступна только в отчетах


● С версии v201309 возможно создать “индивидуальные” бюджеты

● Для обозначение типа есть булевое поле в объекте Budget: isExplicitlyShared

● Для создания индивидуального бюджета: isExplicitlyShared = false

● По-умолчанию, разделяемый бюджет: isExplicitlyShared = true

Контроль видимости бюджетов


● Индивидуальные бюджеты не видно в UI● Могут быть использованы только в одной кампании ● Удаляются вместе с кампанией, не нужно

дополнительной операции BudgetService.mutate(REMOVE op)

● Для кампаний с experiments или budget optimizer● Индивидуальный >->-> Разделяемый

Зачем нужны индивидуальные бюджеты?


Возможости, выведенные из Beta


● BiddableAdGroupCriterion.bidModifier

● Для корректировки ставок для сегментов Display Network

● Remarketing Lists for Search Ads

● Не работает для критериев поисковой сети

1. Display Criteria Bid Modifiers


● Автоматические объявления на основе вашего сайта● Не нужно создавать заголовок, ключевые слова или URL● Нужно задать описание и отображаемый URL

● Участвуют в общем аукционе объявлений● Можно добавлять в обычные кампании

● Например, использовать как fallback ads● Можно использовать минус-слова, получать

статистику, использовать расширения

2. Динамические поисковые объявления (1/6)


● Создайте кампанию и группу объявлений

● Если необходимо, добавьте таргетинг

● Для DSA, необходимы:

● DomainInfoExtension

● один или несколько Webpage Criteria

● DynamicSearchAds



● Создание DynamicSearchAd:● укажите description1, description2, displayUrl

● Можно указать и URL (с параметрами)● {unescapedlpurl} — в самом начале, заменяет URL

● {unescapedlpurl}?lang=en● {escapedlpurl} — URL-кодированная версия (для трекеров)

● http://www.3rdpartytracker.com/?lp={escapedlpurl}● {lpurlpath} — только путь и параметры URL

● http://www.mygoodbusiness.com/tracking/{lpurlpath}

● По-умолчанию, используется {unescapedlpurl}


http://www.mygoodbusiness.com/tracking/%7Blpurlpath

http://www.mygoodbusiness.com/tracking/%7Blpurlpath


DynamicSearchAd dsa = new DynamicSearchAd();dsa.url = "{unescapedlpurl}?source=dsa";dsa.displayUrl = "amazingcarrepairs.com";dsa.description1 = "We'll take good care of your car";dsa.description2 = "Wash and wax service included.";

AdGroupAd aga = new AdGroupAd(_adgroupid);aga.ad = dsa;

AdGroupService.mutate(ADD, aga);



WebpageCondition cond = new WebpageCondition();cond.operand = URL; // filter on URLs, equal to "CONTAINS"cond.argument = "/grandcherokee";

WebpageParameter param = new WebpageParameter();param.criterionName = "Jeep Grand Cherokee";param.conditions = [ cond ];

Webpage wp = new Webpage(); // the criterionwp.parameter = param;// can now put in AdGroupCriterion object and ADD!



● Ограничение:● Необходимо создать DomainInfoExtension (для

кампании)● Данное расширение не поддерживается в API

● нужно использовать UI

● Можно создавать объявления для существующих DomainInfoExtensions

● Можно обновлять настройки, получать статистику



● Доступен сервис AdGroupFeedService

● Создание дополнительных ссылок на

уровне групп объявлений

3. AdGroup Level Feeds


● Стратегии ставок задаются для каждой кампании● Параметры стратегии -- часть объекта кампании

● В некоторых случаях стратегии можно использовать

повторно

● Возможно с использованием Flexible Bidding strategies● Flexible == Shared

4. Flexible Bidding Strategies (1/6)






● BiddingStrategyService -- пул конфигураций

● Позволяет создать объект SharedBiddingStrategy

● Содержит обычный biddingScheme● TargetSpendBiddingScheme...

● При создании кампании, используется ID стратегии

● как обычно для разделяемых объектов



// 1. create the shared bidding strategy.TargetSpendBiddingScheme tsbs = new TargetSpendBiddingScheme();tsbs.spendTarget = 250000000; // $250 a monthtsbs.bidCeiling = 2500000; // max 2.50$ bid

SharedBiddingStrategy sbs = new SharedBiddingStrategy();sbs.name = "Monthly targeted spend";sbs.type = TARGET_SPEND;sbs.biddingScheme = tsbs;

BiddingStrategyService.mutate(ADD, sbs); // extract result



// 2. add it to the campaign.

Campaign c = new Campaign();

// set up stuff on c

BiddingStrategyConfiguration bsc = new

BiddingStrategyConfiguration();

bsc.biddingStrategyId = sbs.id;

c.biddingStrategyConfiguration = bsc;

CampaignService.mutate(ADD, c);



● Корректировка ставок по

георгафическому

положению

● Позволяет задать разные

ставки для разных мест в

рамках одной кампании

5. Location Bid Modifiers


Location Bid Modifiers (cont’d)

// 1. normal location criterion.LocationCriterion lc = new Location();lc.id = 1002451; // Toronto, Ontario, Canadalc.bidModifier = 1.0;

CampaignCriterion cc = new CampaignCriterion();cc.campaignId = _campaignId;cc.criterion = lc;CampaignCriterionService.mutate(ADD, cc);


Location Bid Modifiers (cont’d)

// 2. let's bid more for successful suburbLocationCriterion lc = new Location();lc.id = 1002350; // Mississauga, Ont, Canlc.bidModifier = 1.5; // bid 50% more for here

CampaignCriterion cc = new CampaignCriterion();cc.campaignId = _campaignId;cc.criterion = lc;CampaignCriterionService.mutate(ADD, cc);


Редко используемые функции


● Минус-слова (negative keywords)

● Дополнительные ссылки (Site Links / Feeds)

Использование данных функций часто улучшает результативность кампаний

Редко используемые функции


Минус-слова / Negative Keywords

// Create keyword. We're creating ads for “Westminster dentist”.

Keyword keyword = new Keyword();

keyword.setText("reviews");

keyword.setMatchType(KeywordMatchType.BROAD);

// Create negative campaign criterion.

NegativeCampaignCriterion ncc = new NegativeCampaignCriterion();

ncc.setCampaignId(_campaignId);

ncc.setCriterion(keyword);

CampaignCriterionService.mutate(ADD, ncc);


● Реализуются сервисами Feeds

● Обсуждаем на отдельной сессии позже

Дополнительные ссылка / Site Links


Полезные ссылки

Google Ads v201309 Blog Post - http://goo.gl/TvNQDxv201309 Migration Guide - http://goo.gl/e4O7YZ


Вопросы?


Technology

Api update rundown (russian)