Объекты – это элементы данных, которыми можно делиться, например изображения, видео, заголовки и описания. Они используются для создания объявлений разных типов и форматов, например медийных, для 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 |