Объекты

Ресурсы — это единицы общедоступных данных, таких как изображения, видео, заголовки и описания, которые используются для создания различных типов рекламы в различных форматах, таких как медийная реклама, YouTube, магазин приложений и т. д.

Объекты

Наиболее основными объектами API являются следующие:

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

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

  • Связи с активами

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

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

Пример ресурсов кампании

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

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

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

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

Тип актива Ассетфилдтипе Тип объявления
видео YOUTUBE ВИДЕО
MASTHEAD_COMPANION_VIDEO
Реклама приложения
Реклама, ориентированная на взаимодействие с приложением
Местное объявление
Адаптивное медийное объявление
Медиа-пакет MEDIA_BUNDLE
CUSTOM_LAYOUT
Реклама приложения
Отображение объявления загрузки
Изображение MARKETING_IMAGE
SQUARE_MARKETING_IMAGE
ЛОГОТИП
LANDSCAPE_LOGO
PORTRAIT_MARKETING_IMAGE
Реклама приложения
Реклама, ориентированная на взаимодействие с приложением
Местное объявление
Адаптивное медийное объявление
Текст ЗАГОЛОВОК
LONG_HEADLINE
ОПИСАНИЕ
MANDATORY_AD_TEXT
CALL_TO_ACTION_SELECTION
НАИМЕНОВАНИЕ ФИРМЫ
Реклама приложения
Реклама, ориентированная на взаимодействие с приложением
Местное объявление
Адаптивное медийное объявление
Адаптивное поисковое объявление
Умное объявление кампании
Призыв к действию ПРИЗЫВ К ДЕЙСТВИЮ Местное объявление
Адаптивное медийное объявление

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

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

Тип актива Ассетфилдтипе Связь Изменяемый
Текст НАИМЕНОВАНИЕ ФИРМЫ КампанияАктив Нет
Изображение AD_IMAGE КампанияАктив
Актив группы объявлений
Нет
Изображение БИЗНЕС_ЛОГО КампанияАктив Нет
Форма для потенциальных клиентов LEAD_FORM КампанияАктив Да
Повышение ПОВЫШЕНИЕ КлиентАссет
КампанияАктив
Актив группы объявлений
Да
Вызывать ВЫЗЫВАТЬ КлиентАссет
КампанияАктив
Актив группы объявлений
Да
Структурированный фрагмент STRUCTURED_SNIPPET КлиентАссет
КампанияАктив
Актив группы объявлений
Да
Дополнительная ссылка САЙТ-ССЫЛКА КлиентАссет
КампанияАктив
Актив группы объявлений
Да
Мобильное приложение МОБИЛЬНОЕ ПРИЛОЖЕНИЕ КлиентАссет
КампанияАктив
Актив группы объявлений
Да
Уточнение отеля ОТЕЛЬ_CALLOUT КлиентАссет
КампанияАктив
Актив группы объявлений
Да
Вызов ВЫЗОВ КлиентАссет
КампанияАктив
Актив группы объявлений
Да
Цена ЦЕНА КлиентАссет
КампанияАктив
Актив группы объявлений
Да

Объекты местоположения

Ресурсы местоположения обрабатываются иначе, чем другие типы активов. Подробности см. в разделе «Ресурсы местоположения» .

Автоматически создаваемые активы

Автоматически созданные активы не могут быть изменены. AssetSource указывает, был ли актив создан пользователем или автоматически создан системой. Изменяемые типы, такие как дополнительная ссылка, нельзя связать с автоматически созданными объектами.

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

Определенные типы активов могут быть связаны с определенными типами наборов активов.

тип актива ТипАссетсеттипа Связь Изменяемый
PAGE_FEED PAGE_FEED Набор активов кампании Да
ДИНАМИЧЕСКОЕ_ОБРАЗОВАНИЕ ДИНАМИЧЕСКОЕ_ОБРАЗОВАНИЕ Набор активов кампании Да
ДИНАМИЧЕСКИЙ_ПОЛЬЗОВАТЕЛЬСКИЙ ДИНАМИЧЕСКИЙ_ПОЛЬЗОВАТЕЛЬСКИЙ Набор активов кампании Да
DYNAMIC_HOTELS_AND_RENTALS DYNAMIC_HOTELS_AND_RENTALS Набор активов кампании Да
DYNAMIC_REAL_ESTATE DYNAMIC_REAL_ESTATE Набор активов кампании Да
ДИНАМИЧЕСКИЙ_ЛОКАЛЬНЫЙ ДИНАМИЧЕСКИЙ_ЛОКАЛЬНЫЙ Набор активов кампании Да
ДИНАМИЧЕСКИЕ_ПОЛЕТЫ ДИНАМИЧЕСКИЕ_ПОЛЕТЫ Набор активов кампании Да
ДИНАМИЧЕСКИЕ_РАБОТЫ ДИНАМИЧЕСКИЕ_РАБОТЫ Набор активов кампании Да
ДИНАМИЧЕСКОЕ_ПУТЕШЕСТВИЕ ДИНАМИЧЕСКОЕ_ПУТЕШЕСТВИЕ Набор активов кампании Да
РАСПОЛОЖЕНИЕ LOCATION_SYNC CustomerAssetSet
Набор активов кампании
AdGroupAssetSet
Нет (генерируется системой)
GMB_DYNAMIC_LOCATION_GROUP Набор активов кампании
AdGroupAssetSet
CHAIN_DYNAMIC_LOCATION_GROUP Набор активов кампании
AdGroupAssetSet
STATIC_LOCATION_GROUP Набор активов кампании
AdGroupAssetSet