Объекты

Объекты – это фрагменты данных, которые можно использовать для создания объявлений разных типов и форматов, например медийных, видеообъявлений на YouTube, объявлений в магазинах приложений и т. д. К объектам относятся изображения, видео, заголовки и описания.

Объекты

Ниже перечислены основные объекты API.

  • Asset – единица рекламных данных, которыми можно делиться.
    • AssetType – тип контента, который содержит объект, например текст или изображение.
    • AssetFieldType: как используется объект. Например, текстовый объект может быть использован как заголовок или объект описания.
  • AssetSet – набор объектов, объединенных общей темой или кампанией.
    • AssetSetType – класс набора объектов.

Существуют объекты, представляющие связи между объектами, наборами объектов, группами объявлений, кампаниями и клиентами:

  • Связи с объектами

    • CustomerAsset: связь между клиентом и объектом.
    • CampaignAsset – связь между кампанией и объектом.
    • AdGroupAsset – связь между группой объявлений и объектом.
    • AssetSetAsset: связь между набором объектов и объектом.
  • Связи с наборами объектов

    • CustomerAssetSet: связь между клиентом и набором объектов.
    • CampaignAssetSet – связь между кампанией и набором объектов.
    • AdGroupAssetSet – связь между группой объявлений и набором объектов.

Пример объектов кампании

На иллюстрации ниже показано, как можно связать некоторые объекты. В примере выше кампании находятся на верхнем уровне, но такая же иерархия применяется к клиентам и группам объявлений.

Диаграмма набора объектов кампании
Схема наборов объектов кампании

Прежде чем создавать CampaignAssetSet, необходимо создать Campaign и AssetSet, содержащую один или несколько объектов. Вы можете создать инвентарь для всех доступных форматов объявлений в кампании или разрешить Google Рекламе комбинировать доступные объекты в зависимости от канала, на котором показывается объявление (YouTube, Gmail, Поиск и т. д.).

Важно! Campaign может быть связан с одним или несколькими объектами CampaignAssetSet, но каждый объект CampaignAssetSet может быть связан только с одним Campaign.

Типы объектов, связанных с объявлениями

Некоторые типы объектов можно связывать непосредственно с объявлениями.

Тип объекта AssetFieldType Тип объявления
Видео YOUTUBE_VIDEO Реклама приложения
Объявление, ориентированное на взаимодействие с приложением
Местное объявление
Адаптивное медийное объявление
Набор рекламных материалов MEDIA_BUNDLE
CUSTOM_LAYOUT
Реклама приложения
Объявление с загрузкой
Изображение MARKETING_IMAGE
SQUARE_MARKETING_IMAGE
LOGO
LANDSCAPE_LOGO
PORTRAIT_MARKETING_IMAGE
CLASSIC_DISPLAY_IMAGE
Реклама приложения
Объявление, ориентированное на взаимодействие с приложением
Местное объявление
Адаптивное медийное объявление
Объявление с несколькими объектами для создания спроса
Текст HEADLINE
LONG_HEADLINE
DESCRIPTION
MANDATORY_AD_TEXT
CALL_TO_ACTION_SELECTION
BUSINESS_NAME
Объявление для приложений
Объявление для взаимодействия с приложением
Местное объявление
Адаптивное медийное объявление
Адаптивное поисковое объявление
Объявление умной кампании
Призыв к действию CALL_TO_ACTION Местное объявление
Адаптивное медийное объявление

Типы объектов, связанных с клиентами, кампаниями и группами объявлений

Некоторые типы объектов можно связать с клиентами, кампаниями или группами объявлений с помощью объектов связи.

Тип объекта AssetFieldType Связь Изменяемый
Сообщение для компании BUSINESS_MESSAGE AdGroupAsset
CampaignAsset
CustomerAsset
Да
Текст BUSINESS_NAME CampaignAsset
CustomerAsset
Нет
Изображение AD_IMAGE AdGroupAsset
CampaignAsset
Нет
Изображение BUSINESS_LOGO CampaignAsset
CustomerAsset
Нет
Форма для потенциальных клиентов LEAD_FORM CampaignAsset Да
Промоакция ПРОМОАКЦИЯ AdGroupAsset
CampaignAsset
CustomerAsset
Да
Уточнение CALLOUT AdGroupAsset
CampaignAsset
CustomerAsset
Да
Структурированное описание STRUCTURED_SNIPPET AdGroupAsset
CampaignAsset
CustomerAsset
Да
Дополнительная ссылка ДОПОЛНИТЕЛЬНАЯ ССЫЛКА AdGroupAsset
CampaignAsset
CustomerAsset
Да
Мобильное приложение MOBILE_APP AdGroupAsset
CampaignAsset
CustomerAsset
Да
Уточнение для гостиницы HOTEL_CALLOUT AdGroupAsset
CampaignAsset
CustomerAsset
Да
Позвонить ПОЗВОНИТЬ AdGroupAsset
CampaignAsset
CustomerAsset
Да
Цена ЦЕНА AdGroupAsset
CampaignAsset
CustomerAsset
Да

Объекты адресов

Объекты адресов обрабатываются иначе, чем другие типы объектов. Подробнее о местоположении объектов…

Оптимизация текста

Объекты, созданные с помощью функции оптимизации текста (ранее – автоматически созданные объекты), нельзя изменить. Значок AssetSource показывает, был ли объект создан пользователем или автоматически сгенерирован системой. Изменяемые типы, например дополнительные ссылки, нельзя связывать с объектами, созданными с помощью оптимизации текста.

Типы объектов, связанных с наборами объектов

Некоторые типы объектов можно связывать только с определенными типами наборов объектов.

AssetType AssetSetType Связь Изменяемый
PAGE_FEED PAGE_FEED CampaignAssetSet Да
DYNAMIC_EDUCATION DYNAMIC_EDUCATION CampaignAssetSet Да
DYNAMIC_CUSTOM DYNAMIC_CUSTOM CampaignAssetSet Да
DYNAMIC_HOTELS_AND_RENTALS DYNAMIC_HOTELS_AND_RENTALS CampaignAssetSet Да
DYNAMIC_REAL_ESTATE DYNAMIC_REAL_ESTATE CampaignAssetSet Да
DYNAMIC_LOCAL DYNAMIC_LOCAL CampaignAssetSet Да
DYNAMIC_FLIGHTS DYNAMIC_FLIGHTS CampaignAssetSet Да
DYNAMIC_JOBS DYNAMIC_JOBS CampaignAssetSet Да
DYNAMIC_TRAVEL DYNAMIC_TRAVEL CampaignAssetSet Да
МЕСТОПОЛОЖЕНИЕ LOCATION_SYNC CustomerAssetSet
CampaignAssetSet
AdGroupAssetSet
Нет (создано системой)
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP CampaignAssetSet
AdGroupAssetSet
CHAIN_DYNAMIC_LOCATION_GROUP CampaignAssetSet
AdGroupAssetSet
STATIC_LOCATION_GROUP CampaignAssetSet
AdGroupAssetSet