feed services (russian)
DESCRIPTION
TRANSCRIPT
![Page 1: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/1.jpg)
AdWords API Workshops – All rights reserved
![Page 2: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/2.jpg)
AdWords API Workshops – All rights reserved
Feed ServicesУправление сервисами Feeds в AdWords API
Adam Ohren, Google Inc.Danial Klimkin, Google Inc.
![Page 3: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/3.jpg)
AdWords API Workshops – All rights reserved
● Основные положения● Создание новых фидов● Привязка расширений● Отчеты● Рекомендации● Использование примеров
План
![Page 4: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/4.jpg)
AdWords API Workshops – All rights reserved
Основные положения
![Page 5: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/5.jpg)
AdWords API Workshops – All rights reserved
● Таблица на уровне аккаунта● Набор изменяемых строк● Источник данных для расширений
○ Sitelinks (доп. ссылки)○ Call extensions (телефонные вызовы)○ App extensions (загрузка приложений)
Что такое фид (Feed)?Feed
Attr1 Attr2 Attr3
Item1 Val1 Val2 Val3
Item2 Val4 Val5 Val6
![Page 6: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/6.jpg)
AdWords API Workshops – All rights reserved
● Динамическое обновление расширений
○ Изменение расширений без пересоздания
○ Сохранение статистики
● Управление таргетингом платформ на
уровне фида
Преимущества использованияFeed
Attr1 Attr2 Attr3
Item1 Val1 Val2 Val3
Item2 Val4 Val5 Val6
![Page 7: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/7.jpg)
AdWords API Workshops – All rights reserved
Аналогия с базой данных (1/2)
Таблица
Столбец
Строка
Поле
Feed
FeedAttribute
FeedItem
FeedItemAttributeValue
![Page 8: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/8.jpg)
AdWords API Workshops – All rights reserved
Аналогия с базой данных (2/2)
Ad Extension
![Page 9: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/9.jpg)
AdWords API Workshops – All rights reserved
Используемые типыData Extension Type Ad Extensions
![Page 10: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/10.jpg)
AdWords API Workshops – All rights reserved
● Feed● FeedItem● FeedMapping● CampaignFeed● AdGroupFeed
Feed Services API
ServiceService
ServiceService
Service
![Page 11: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/11.jpg)
AdWords API Workshops – All rights reserved
Создание новых фидов
![Page 12: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/12.jpg)
AdWords API Workshops – All rights reserved
1. Создание2. Заполнение3. Привязка
Создание новых фидов
![Page 13: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/13.jpg)
AdWords API Workshops – All rights reserved
Создание новых фидов
Чтобы... …вызовите это... ...с этим!
Создать FeedService FeedFeedAttribute
Заполнить FeedItemService FeedItemFeedItemAttribute
Привязать FeedMappingService FeedMapping
![Page 14: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/14.jpg)
AdWords API Workshops – All rights reserved
● Добавляем новую поименованную
коллекцию данных
● Определяем названия и типы столбцов
Создание
![Page 15: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/15.jpg)
AdWords API Workshops – All rights reserved
1. Создаем Feeda. задаем имя
2. Добавляем аттрибуты (FeedAttributes)a. задаем именаb. задаем типы
3. Вызываем FeedService.mutate(ADD op)
Создание
![Page 16: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/16.jpg)
AdWords API Workshops – All rights reserved
● Добавляем строку в наш фид
● Указываем предпочтение по платформе
(опционально)
● Задаем временной интервал
(опционально)
Заполнение
![Page 17: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/17.jpg)
AdWords API Workshops – All rights reserved
1. Создаем FeedItema. задаем ID ранее созданного фида
2. Добавляем FeedItemAttributeValuesa. задаем ID “столбца” feedAttributeIdb. устанавливаем значение value
3. ВызываемFeedItemService.mutate(ADD op)
Заполнение
![Page 18: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/18.jpg)
AdWords API Workshops – All rights reserved
● Определяет, какие расширения могут
использовать фид
● Указывает, какие “столбцы” фида
используются в расширении
Привязка
![Page 19: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/19.jpg)
AdWords API Workshops – All rights reserved
1. Создаем FeedMappinga. указываем ID созданного Feedb. устанавливаем тип placeholderType
2. Добавляем AttributeFieldMappingsa. задаем feedAttributeIdb. задаем fieldId
3. ВызываемFeedMappingService.mutate(ADD op)
Привязка
![Page 20: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/20.jpg)
AdWords API Workshops – All rights reserved
Создание расширений объявлений
![Page 21: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/21.jpg)
AdWords API Workshops – All rights reserved
Использование данных фида в расширениях объявлений
Feed
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
![Page 22: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/22.jpg)
AdWords API Workshops – All rights reserved
Использование данных фида в расширениях объявлений
Feed
Campaign
AdGroup
CampaignFeed
AdGroupFeed
matchingFunction
matchingFunction
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
![Page 23: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/23.jpg)
AdWords API Workshops – All rights reserved
● Добавляем расширение в кампанию или группу объявлений
● Определяем как выбирается “строка” FeedItem с помощью функции соответствия (matchingFunction)
Добавление в кампании и группы
![Page 24: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/24.jpg)
AdWords API Workshops – All rights reserved
1. Создаем CampaignFeeda. задаем feedIdb. устанавливаем campaignIdc. определяем placeholderTypes
2. Добавляем функцию соответствияa. задаем оператор (operator)b. задаем операнды (operands)
3. Вызываем CampaignFeed.mutate(ADD op)
Добавление в кампании и группы
![Page 25: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/25.jpg)
AdWords API Workshops – All rights reserved
Функции соответствия (Matching Functions)
Feed
Campaign
AdGroup
CampaignFeed
AdGroupFeed
matchingFunction
matchingFunction
FeedItemId IN (id1, id2, …)
FeedItemId IN (idA, idB, …)
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
FeedItem
![Page 26: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/26.jpg)
AdWords API Workshops – All rights reserved
Функции соответствия (Matching Functions)Feed Campaign / AdGroup
FeedItemId IN (6435602, 6436202)
![Page 27: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/27.jpg)
AdWords API Workshops – All rights reserved
Отчеты
![Page 28: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/28.jpg)
AdWords API Workshops – All rights reserved
Ad Extensions Performance Report● DomainInfo● Location● LocationSync● Sitelinks● Mobile● InAppLink
Отчеты для Feeds
Placeholder Feed Item Report● Sitelinks● Mobile● InAppLink
![Page 29: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/29.jpg)
AdWords API Workshops – All rights reserved
● Статистика на уровке FeedItem
● PlaceholderType ⇔ Ad extension type● Sitelink● Call● App
Placeholder Feed Item Report
![Page 30: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/30.jpg)
AdWords API Workshops – All rights reserved
Рекомендации
![Page 31: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/31.jpg)
AdWords API Workshops – All rights reserved
● Автоматически создаваемые фиды:● Main sitelink feed● Main phone number feed● Main app feed
● Feed.origin = “ADWORDS”
● FeedAttributes (параметры) неизменяемы
Использование ADWORDS Feeds
![Page 32: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/32.jpg)
AdWords API Workshops – All rights reserved
● В интерфейсе доступны в выпадающем меню● Feed.origin = “USER”● FeedAttributes (параметры) могут быть добавлены
Пользовательские фиды
![Page 33: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/33.jpg)
AdWords API Workshops – All rights reserved
Удаление фидов
Строки фидов● удаление FeedItem
Расширения объявлений● убираем ID из функции
соответствияVS
![Page 34: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/34.jpg)
AdWords API Workshops – All rights reserved
● Только один CampaignFeed / AdGroupFeed для каждого PlaceholderType
● FeedAttributes нельзя изменить оператором Feed.SET ● FeedItemIds не проверяются в matchingFunctions● Максимально 20 фидов на один аккаунт
● включая автоматические фиды ADWORDS● Удалить фиды можно только с помощью API
Некоторые особенности
![Page 35: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/35.jpg)
AdWords API Workshops – All rights reserved
Использование примеров кода
AdWords API Workshops – All rights reserved
![Page 36: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/36.jpg)
AdWords API Workshops – All rights reserved
● Примеры доступны для всех библиотек:○ https://developers.google.com/adwords/api/docs/clientlibraries
● Не начинайте с нуля, посмотрите примеры!
● Начните с примера для SiteLinks
● Когда все работает, посмотрите другие расширения
Use The Code, Luke!
AdWords API Workshops – All rights reserved
![Page 37: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/37.jpg)
AdWords API Workshops – All rights reserved
Задают тип фида и полей, которые вы используете. Несколько примеров:PLACEHOLDER_SITELINKS = 1;PLACEHOLDER_CALL = 2; ...PLACEHOLDER_FIELD_CALL_ONLY = 4;
Полный список:https://developers.google.com/adwords/api/docs/appendix/placeholders
PLACEHOLDERs -- что это?
![Page 38: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/38.jpg)
AdWords API Workshops – All rights reserved
Определяются для каждого типа placeholder отдельно:
● Sitelink: Text, URL (up to 6 pairs)
● Call or : Phone Number, Country Code, isCallTracking,Mobile : isCallOnly, Conversion Duration Threshold
● App : Store, Id, Link Text, URL
Поля расширений
![Page 39: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/39.jpg)
AdWords API Workshops – All rights reserved
● Переименование методов
Все имена методов, переменных и параметров в примерах для наглядности включают текст SiteLink.
Просто доработайте напильником
![Page 40: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/40.jpg)
AdWords API Workshops – All rights reserved
● Измените аттрибуты на используемые:
FeedAttribute textAttribute = new FeedAttribute();
textAttribute.setType(FeedAttributeType.STRING);
textAttribute.setName("Link Text");
Становится:
FeedAttribute numberAttribute = new FeedAttribute();
numberAttribute.setType(FeedAttributeType.STRING);
numberAttribute.setName("Phone Number");
Просто доработайте напильником
![Page 41: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/41.jpg)
AdWords API Workshops – All rights reserved
● Укажите верно FeedAttributeType:
FeedAttribute iCOAttribute = new FeedAttribute();
iCOAttribute.setType(FeedAttributeType.BOOLEAN); iCOAttribute.setName("Is Call Only");
Просто доработайте напильником
![Page 42: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/42.jpg)
AdWords API Workshops – All rights reserved
● Указывайте AttributeId в правильном порядке:
Feed savedFeed = result.getValue()[0]; // a new FeedReturnValue
callData.callFeedId = savedFeed.getId(); // a data holder object
FeedAttribute[] savedAttributes = savedFeed.getAttributes();
callData.numberFeedAttributeId = savedAttributes[0].getId();
callData.ccFeedAttributeId = savedAttributes[1].getId();
callData.iCTFeedAttributeId = savedAttributes[2].getId();
... // other Attribute lines
Просто доработайте напильником
![Page 43: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/43.jpg)
AdWords API Workshops – All rights reserved
Полезные ресурсыGuide & Reference
https://developers.google.com/adwords/api/docs/guides/feed-serviceshttps://developers.google.com/adwords/api/docs/appendix/placeholdershttps://developers.google.com/adwords/api/docs/appendix/feed-errorshttps://developers.google.com/adwords/api/docs/clientlibraries
![Page 44: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/44.jpg)
AdWords API Workshops – All rights reserved
Вопросы?
![Page 45: Feed services (russian)](https://reader034.vdocuments.net/reader034/viewer/2022051110/54bf19e54a7959b9438b4585/html5/thumbnails/45.jpg)
AdWords API Workshops – All rights reserved