Основные понятия

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

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

Ниже представлена упрощенная диаграмма основных классов в Ad Manager API и их взаимосвязей.

Основные объекты в архитектуре Менеджера рекламы.

Заказ

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

LineItem

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

LineItemCreativeAssociation

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

Креатив

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

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

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

Место размещения

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

AdUnit

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