Базовые концепты

На этой странице представлен обзор архитектуры API Google Ad Manager, а также описаны общие концепции и термины Менеджера рекламы.

Архитектура API

Вот упрощенная диаграмма основных классов API Менеджера рекламы и их связи друг с другом:

Заказ

Объект Order содержит общую информацию о заказе, такую ​​как валюта или продавец, и содержит один или несколько экземпляров LineItem . В коде каждый LineItem содержит идентификатор содержащего его Order , а не Order , содержащий список объектов LineItem .

Линейный элемент

Объект LineItem описывает набор требований к показу рекламы, включая то, как и когда она должна показываться, размеры креативов, которые она должна показывать, и порядок их показа (по порядку, по весу или в соответствии с их производительность), приоритет этих объявлений и многие свойства, описывающие структуру затрат. LineItem имеет один объект InventoryTargeting , который описывает, на какие объекты AdUnit и Placement он может ориентироваться, а также необязательные дополнительные объекты подкласса Targeting , которые представляют географические, пользовательские или другие критерии.

LineItemCreativeAssociation

LineItemCreativeAssociation (часто называемая LICA) связывает один LineItem с одним Creative . Позиции можно связать с несколькими объявлениями, и в зависимости от типа вашей учетной записи вы можете связать объявление с несколькими позициями. Когда вы создаете LineItemCreativeAssociation , Менеджер рекламы сначала проверяет, совместимы ли креатив и позиция; если, например, размеры различаются, вы получите сообщение об ошибке при попытке создать или обновить ассоциацию. Этот объект также позволяет переопределить некоторые значения в связанном LineItem , например даты начала и окончания или размер (если у вас есть объявление, которое не совсем соответствует размеру, указанному в позиции, но вы готовы разрешить Менеджеру рекламы оперативно корректируйте размер объявления в соответствии с рекламным блоком). LICA не отображаются в пользовательском интерфейсе Менеджера рекламы; это соглашение API.

творческий

Creative представляет собой фактическое объявление. Если объявление размещено в Менеджере рекламы, этот объект содержит фактические байты изображения, флэш-файлы или пользовательские теги HTML, хранящиеся на серверах Менеджера рекламы; Если креатив размещен на стороннем сайте, он представляет собой URL-адрес или фрагмент HTML, который отправляет запрос со стороннего сервера.

Подклассы InventoryTargeting и Targeting

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

Размещение

Объект Placement – это коллекция из одного или нескольких объектов AdUnit .

Рекламный блок

AdUnit представляет собой местоположение объявления на одной или нескольких страницах. AdUnit может быть целью либо объекта InventoryTargeting LineItem , либо объекта Placement . Объект AdUnit включает размер, идентификатор и уникальное имя. Идентификатор используется для идентификации других объектов AdUnit в API; это имя используется в качестве уникального идентификатора в тегах HTML для идентификации конкретного объекта AdUnit и отправляется обратно в Менеджер рекламы как часть запроса страницы.