Feed services (russian)

AdWords API Workshops – All rights reserved


Feed ServicesУправление сервисами Feeds в AdWords API

Adam Ohren, Google Inc.Danial Klimkin, Google Inc.


● Основные положения● Создание новых фидов● Привязка расширений● Отчеты● Рекомендации● Использование примеров

План


Основные положения


● Таблица на уровне аккаунта● Набор изменяемых строк● Источник данных для расширений

○ Sitelinks (доп. ссылки)○ Call extensions (телефонные вызовы)○ App extensions (загрузка приложений)

Что такое фид (Feed)?Feed

Attr1 Attr2 Attr3

Item1 Val1 Val2 Val3



● Динамическое обновление расширений

○ Изменение расширений без пересоздания

○ Сохранение статистики

● Управление таргетингом платформ на

уровне фида

Преимущества использованияFeed

Attr1 Attr2 Attr3




Аналогия с базой данных (1/2)

Таблица

Столбец

Строка

Поле

Feed

FeedAttribute

FeedItem

FeedItemAttributeValue


Аналогия с базой данных (2/2)

Ad Extension


Используемые типыData Extension Type Ad Extensions


● Feed● FeedItem● FeedMapping● CampaignFeed● AdGroupFeed

Feed Services API

ServiceService

ServiceService

Service


Создание новых фидов


1. Создание2. Заполнение3. Привязка




Чтобы... …вызовите это... ...с этим!

Создать FeedService FeedFeedAttribute

Заполнить FeedItemService FeedItemFeedItemAttribute

Привязать FeedMappingService FeedMapping


● Добавляем новую поименованную

коллекцию данных

● Определяем названия и типы столбцов

Создание


1. Создаем Feeda. задаем имя

2. Добавляем аттрибуты (FeedAttributes)a. задаем именаb. задаем типы

3. Вызываем FeedService.mutate(ADD op)

Создание


● Добавляем строку в наш фид

● Указываем предпочтение по платформе

(опционально)

● Задаем временной интервал

(опционально)

Заполнение


1. Создаем FeedItema. задаем ID ранее созданного фида

2. Добавляем FeedItemAttributeValuesa. задаем ID “столбца” feedAttributeIdb. устанавливаем значение value

3. ВызываемFeedItemService.mutate(ADD op)

Заполнение


● Определяет, какие расширения могут

использовать фид

● Указывает, какие “столбцы” фида

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

Привязка


1. Создаем FeedMappinga. указываем ID созданного Feedb. устанавливаем тип placeholderType

2. Добавляем AttributeFieldMappingsa. задаем feedAttributeIdb. задаем fieldId

3. ВызываемFeedMappingService.mutate(ADD op)

Привязка


Создание расширений объявлений


Использование данных фида в расширениях объявлений

Feed

FeedItem

FeedItem

FeedItem

FeedItem

FeedItem

FeedItem

FeedItem

FeedItem

FeedItem


Использование данных фида в расширениях объявлений

Feed

Campaign

AdGroup

CampaignFeed

AdGroupFeed

matchingFunction

matchingFunction

FeedItem

FeedItem

FeedItem

FeedItem

FeedItem

FeedItem

FeedItem

FeedItem

FeedItem


● Добавляем расширение в кампанию или группу объявлений

● Определяем как выбирается “строка” FeedItem с помощью функции соответствия (matchingFunction)

Добавление в кампании и группы


1. Создаем CampaignFeeda. задаем feedIdb. устанавливаем campaignIdc. определяем placeholderTypes

2. Добавляем функцию соответствияa. задаем оператор (operator)b. задаем операнды (operands)

3. Вызываем CampaignFeed.mutate(ADD op)

Добавление в кампании и группы


Функции соответствия (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


Функции соответствия (Matching Functions)Feed Campaign / AdGroup

FeedItemId IN (6435602, 6436202)


Отчеты


Ad Extensions Performance Report● DomainInfo● Location● LocationSync● Sitelinks● Mobile● InAppLink

Отчеты для Feeds

Placeholder Feed Item Report● Sitelinks● Mobile● InAppLink


● Статистика на уровке FeedItem

● PlaceholderType ⇔ Ad extension type● Sitelink● Call● App

Placeholder Feed Item Report


Рекомендации


● Автоматически создаваемые фиды:● Main sitelink feed● Main phone number feed● Main app feed

● Feed.origin = “ADWORDS”

● FeedAttributes (параметры) неизменяемы

Использование ADWORDS Feeds


● В интерфейсе доступны в выпадающем меню● Feed.origin = “USER”● FeedAttributes (параметры) могут быть добавлены

Пользовательские фиды


Удаление фидов

Строки фидов● удаление FeedItem

Расширения объявлений● убираем ID из функции

соответствияVS


● Только один CampaignFeed / AdGroupFeed для каждого PlaceholderType

● FeedAttributes нельзя изменить оператором Feed.SET ● FeedItemIds не проверяются в matchingFunctions● Максимально 20 фидов на один аккаунт

● включая автоматические фиды ADWORDS● Удалить фиды можно только с помощью API

Некоторые особенности


Использование примеров кода



● Примеры доступны для всех библиотек:○ https://developers.google.com/adwords/api/docs/clientlibraries

● Не начинайте с нуля, посмотрите примеры!

● Начните с примера для SiteLinks

● Когда все работает, посмотрите другие расширения

Use The Code, Luke!


https://developers.google.com/adwords/api/docs/clientlibraries

https://developers.google.com/adwords/api/docs/clientlibraries


Задают тип фида и полей, которые вы используете. Несколько примеров:PLACEHOLDER_SITELINKS = 1;PLACEHOLDER_CALL = 2; ...PLACEHOLDER_FIELD_CALL_ONLY = 4;

Полный список:https://developers.google.com/adwords/api/docs/appendix/placeholders

PLACEHOLDERs -- что это?

https://developers.google.com/adwords/api/docs/appendix/placeholders

https://developers.google.com/adwords/api/docs/appendix/placeholders


Определяются для каждого типа 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

Поля расширений


● Переименование методов

Все имена методов, переменных и параметров в примерах для наглядности включают текст SiteLink.

Просто доработайте напильником


● Измените аттрибуты на используемые:

FeedAttribute textAttribute = new FeedAttribute();

textAttribute.setType(FeedAttributeType.STRING);

textAttribute.setName("Link Text");

Становится:

FeedAttribute numberAttribute = new FeedAttribute();

numberAttribute.setType(FeedAttributeType.STRING);

numberAttribute.setName("Phone Number");



● Укажите верно FeedAttributeType:

FeedAttribute iCOAttribute = new FeedAttribute();

iCOAttribute.setType(FeedAttributeType.BOOLEAN); iCOAttribute.setName("Is Call Only");



● Указывайте 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



Полезные ресурсы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


Вопросы?


Technology

Feed services (russian)