Feed services (russian)

1,012 views
871 views

Published on

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
1,012
On SlideShare
0
From Embeds
0
Number of Embeds
4
Actions
Shares
0
Downloads
1
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Feed services (russian)

  1. 1. AdWords API Workshops – All rights reserved
  2. 2. Feed Services Управление сервисами Feeds в AdWords API Adam Ohren, Google Inc. Danial Klimkin, Google Inc. AdWords API Workshops – All rights reserved
  3. 3. План ● ● ● ● ● ● Основные положения Создание новых фидов Привязка расширений Отчеты Рекомендации Использование примеров AdWords API Workshops – All rights reserved
  4. 4. Основные положения AdWords API Workshops – All rights reserved
  5. 5. Что такое фид (Feed)? Feed ● Таблица на уровне аккаунта ● Набор изменяемых строк ● Источник данных для расширений ○ Sitelinks (доп. ссылки) ○ Call extensions (телефонные вызовы) ○ App extensions (загрузка приложений) AdWords API Workshops – All rights reserved Attr1 Attr2 Attr3 Item1 Val1 Val2 Val3 Item2 Val4 Val5 Val6
  6. 6. Преимущества использования Feed ● Динамическое обновление расширений ○ Изменение расширений без пересоздания ○ Сохранение статистики ● Управление таргетингом платформ на уровне фида AdWords API Workshops – All rights reserved Attr1 Attr2 Attr3 Item1 Val1 Val2 Val3 Item2 Val4 Val5 Val6
  7. 7. Аналогия с базой данных (1/2) Таблица Feed Столбец FeedAttribute Строка FeedItem Поле FeedItemAttributeValue AdWords API Workshops – All rights reserved
  8. 8. Аналогия с базой данных (2/2) Ad Extension AdWords API Workshops – All rights reserved
  9. 9. Используемые типы Data AdWords API Workshops – All rights reserved Extension Type Ad Extensions
  10. 10. Feed Services API ● ● ● ● ● FeedService FeedItem Service FeedMapping Service CampaignFeed Service AdGroupFeed Service AdWords API Workshops – All rights reserved
  11. 11. Создание новых фидов AdWords API Workshops – All rights reserved
  12. 12. Создание новых фидов 1. Создание 2. Заполнение 3. Привязка AdWords API Workshops – All rights reserved
  13. 13. Создание новых фидов Чтобы... …вызовите это... ...с этим! Создать FeedService Feed FeedAttribute Заполнить FeedItemService FeedItem FeedItemAttribute Привязать FeedMappingService FeedMapping AdWords API Workshops – All rights reserved
  14. 14. Создание ● Добавляем новую поименованную коллекцию данных ● Определяем названия и типы столбцов AdWords API Workshops – All rights reserved
  15. 15. Создание 1. Создаем Feed a. задаем имя 2. Добавляем аттрибуты (FeedAttributes) a. задаем имена b. задаем типы 3. Вызываем FeedService.mutate(ADD op) AdWords API Workshops – All rights reserved
  16. 16. Заполнение ● Добавляем строку в наш фид ● Указываем предпочтение по платформе (опционально) ● Задаем временной интервал (опционально) AdWords API Workshops – All rights reserved
  17. 17. Заполнение 1. Создаем FeedItem a. задаем ID ранее созданного фида 2. Добавляем FeedItemAttributeValues a. задаем ID “столбца” feedAttributeId b. устанавливаем значение value 3. Вызываем FeedItemService.mutate(ADD op) AdWords API Workshops – All rights reserved
  18. 18. Привязка ● Определяет, какие расширения могут использовать фид ● Указывает, какие “столбцы” фида используются в расширении AdWords API Workshops – All rights reserved
  19. 19. Привязка 1. Создаем FeedMapping a. указываем ID созданного Feed b. устанавливаем тип placeholderType 2. Добавляем AttributeFieldMappings a. задаем feedAttributeId b. задаем fieldId 3. Вызываем FeedMappingService.mutate(ADD op) AdWords API Workshops – All rights reserved
  20. 20. Создание расширений объявлений AdWords API Workshops – All rights reserved
  21. 21. Использование данных фида в расширениях объявлений Feed FeedItem FeedItem FeedItem FeedItem FeedItem FeedItem FeedItem FeedItem FeedItem AdWords API Workshops – All rights reserved
  22. 22. Использование данных фида в расширениях объявлений Feed FeedItem matchingFunction FeedItem CampaignFeed Campaign AdGroupFeed AdGroup FeedItem FeedItem FeedItem FeedItem FeedItem FeedItem FeedItem AdWords API Workshops – All rights reserved matchingFunction
  23. 23. Добавление в кампании и группы ● Добавляем расширение в кампанию или группу объявлений ● Определяем как выбирается “строка” FeedItem с помощью функции соответствия (matchingFunction) AdWords API Workshops – All rights reserved
  24. 24. Добавление в кампании и группы 1. Создаем CampaignFeed a. задаем feedId b. устанавливаем campaignId c. определяем placeholderTypes 2. Добавляем функцию соответствия a. задаем оператор (operator) b. задаем операнды (operands) 3. Вызываем CampaignFeed.mutate (ADD op) AdWords API Workshops – All rights reserved
  25. 25. Функции соответствия (Matching Functions) Feed FeedItem FeedItem FeedItem matchingFunction CampaignFeed Campaign AdGroupFeed AdGroup FeedItemId IN (id1, id2, …) FeedItem FeedItem FeedItem FeedItem FeedItem FeedItem AdWords API Workshops – All rights reserved matchingFunction FeedItemId IN (idA, idB, …)
  26. 26. Функции соответствия (Matching Functions) Feed Campaign / AdGroup FeedItemId IN (6435602, 6436202) AdWords API Workshops – All rights reserved
  27. 27. Отчеты AdWords API Workshops – All rights reserved
  28. 28. Отчеты для Feeds Ad Extensions Performance Report ● DomainInfo ● Location ● LocationSync ● Sitelinks ● Mobile ● InAppLink AdWords API Workshops – All rights reserved Placeholder Feed Item Report ● Sitelinks ● Mobile ● InAppLink
  29. 29. Placeholder Feed Item Report ● Статистика на уровке FeedItem ● PlaceholderType ⇔ Ad extension type ● Sitelink ● Call ● App AdWords API Workshops – All rights reserved
  30. 30. Рекомендации AdWords API Workshops – All rights reserved
  31. 31. Использование ADWORDS Feeds ● Автоматически создаваемые фиды: ● Main sitelink feed ● Main phone number feed ● Main app feed ● Feed.origin = “ADWORDS” ● FeedAttributes (параметры) неизменяемы AdWords API Workshops – All rights reserved
  32. 32. Пользовательские фиды ● В интерфейсе доступны в выпадающем меню ● Feed.origin = “USER” ● FeedAttributes (параметры) могут быть добавлены AdWords API Workshops – All rights reserved
  33. 33. Удаление фидов Строки фидов ● удаление FeedItem AdWords API Workshops – All rights reserved VS Расширения объявлений ● убираем ID из функции соответствия
  34. 34. Некоторые особенности ● Только один CampaignFeed / AdGroupFeed для каждого PlaceholderType ● FeedAttributes нельзя изменить оператором Feed.SET ● FeedItemIds не проверяются в matchingFunctions ● Максимально 20 фидов на один аккаунт ● включая автоматические фиды ADWORDS ● Удалить фиды можно только с помощью API AdWords API Workshops – All rights reserved
  35. 35. Использование примеров кода AdWords API Workshops – All rights reserved
  36. 36. Use The Code, Luke! ● Примеры доступны для всех библиотек: ○ https://developers.google.com/adwords/api/docs/clientlibraries ● Не начинайте с нуля, посмотрите примеры! ● Начните с примера для SiteLinks ● Когда все работает, посмотрите другие расширения AdWords API Workshops – All rights reserved
  37. 37. PLACEHOLDERs -- что это? Задают тип фида и полей, которые вы используете. Несколько примеров: PLACEHOLDER_SITELINKS = 1; PLACEHOLDER_CALL = 2; ... PLACEHOLDER_FIELD_CALL_ONLY = 4; Полный список: https://developers.google.com/adwords/api/docs/appendix/placeholders AdWords API Workshops – All rights reserved
  38. 38. Поля расширений Определяются для каждого типа 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 AdWords API Workshops – All rights reserved
  39. 39. Просто доработайте напильником ● Переименование методов Все имена методов, переменных и параметров в примерах для наглядности включают текст SiteLink. AdWords API Workshops – All rights reserved
  40. 40. Просто доработайте напильником ● Измените аттрибуты на используемые: FeedAttribute textAttribute = new FeedAttribute(); textAttribute.setType(FeedAttributeType.STRING); textAttribute.setName("Link Text"); Становится: FeedAttribute numberAttribute = new FeedAttribute(); numberAttribute.setType(FeedAttributeType.STRING); numberAttribute.setName("Phone Number"); AdWords API Workshops – All rights reserved
  41. 41. Просто доработайте напильником ● Укажите верно FeedAttributeType: FeedAttribute iCOAttribute = new FeedAttribute(); iCOAttribute.setType(FeedAttributeType.BOOLEAN); iCOAttribute.setName("Is Call Only"); AdWords API Workshops – All rights reserved
  42. 42. Просто доработайте напильником ● Указывайте 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 AdWords API Workshops – All rights reserved
  43. 43. Полезные ресурсы Guide & Reference https://developers.google.com/adwords/api/docs/guides/feed-services https://developers.google.com/adwords/api/docs/appendix/placeholders https://developers.google.com/adwords/api/docs/appendix/feed-errors https://developers.google.com/adwords/api/docs/clientlibraries AdWords API Workshops – All rights reserved
  44. 44. Вопросы? AdWords API Workshops – All rights reserved
  45. 45. AdWords API Workshops – All rights reserved

×