- JSON-представление
- тип актива
- АктивПолитикаСводка
- AssetFieldTypePolicySummary
- YoutubeВидеоАктив
- MediaBundleAsset
- ImageAsset
- Размер изображения
- ТекстАссет
- ЛидФормАссет
- Лидформкаллтоактионтипе
- Лидформфилд
- ЛидФормаОдинВыборОтветы
- LeadFormCustomQuestionField
- Метод доставки лидформы
- ВебхукДоставка
- LeadFormPostSubmitCallToActionType
- Лидформдесирединтент
- BookOnGoogleAsset
- ПродвижениеАктив
- CalloutAsset
- Структурированный сниппетАссет
- Объект дополнительной ссылки
- PageFeedAsset
- ДинамическоеОбразованиеАктив
- Мобильное приложениеАссет
- ОтельВыноскаАктив
- CallAsset
- ЦенаАктив
- ЦенаПредложение
- Каллтоактионассет
- ДинамическийRealEstateAsset
- ДинамическийCustomAsset
- DynamicHotelsAndRentalsAsset
- DynamicFlightsAsset
- СпросГенКарусельКартаАктив
- ДинамическоеПутешествиеАссет
- ДинамическийЛокальныйАссет
- Динамический ДжобсАссет
- МестоположениеАктив
- БизнесПрофильМестоположение
- ОтельСобственностьАктив
Актив – это часть объявления, которую можно использовать в нескольких объявлениях. Это может быть изображение (ImageAsset), видео (YoutubeVideoAsset) и т. д. Ресурсы неизменяемы и не могут быть удалены. Чтобы остановить показ объекта, удалите его из организации, которая его использует.
JSON-представление |
---|
{ "resourceName": string, "type": enum ( |
Поля | |
---|---|
resourceName | Неизменный. Имя ресурса актива. Имена ресурсов активов имеют форму: |
type | Только вывод. Тип актива. |
finalUrls[] | Список возможных конечных URL-адресов после всех междоменных перенаправлений. |
finalMobileUrls[] | Список возможных конечных мобильных URL-адресов после всех междоменных перенаправлений. |
urlCustomParameters[] | Список сопоставлений, которые будут использоваться для замены тегов пользовательских параметров URL-адресов в trackUrlTemplate, FinalUrls и/или FinalMobileUrls. |
source | Только вывод. Источник актива. |
policySummary | Только вывод. Информация о политике для актива. |
fieldTypePolicySummaries[] | Только вывод. Информация о политике для актива для каждого FieldType. |
id | Только вывод. Идентификатор актива. |
name | Необязательное имя актива. |
trackingUrlTemplate | Шаблон URL-адреса для создания URL-адреса отслеживания. |
finalUrlSuffix | Шаблон URL-адреса для добавления параметров к URL-адресам целевых страниц, обслуживаемых с параллельным отслеживанием. |
Поле объединения asset_data . Конкретный тип актива. asset_data может быть только одним из следующих: | |
youtubeVideoAsset | Неизменный. Видеоресурс YouTube. |
mediaBundleAsset | Неизменный. Ресурс медиапакета. |
imageAsset | Только вывод. Имиджевый актив. |
textAsset | Неизменный. Текстовый ресурс. |
leadFormAsset | Актив формы для потенциальных клиентов. |
bookOnGoogleAsset | Книга об активах Google. |
promotionAsset | Рекламный актив. |
calloutAsset | Выноска. |
structuredSnippetAsset | Структурированный фрагмент. |
sitelinkAsset | Дополнительная ссылка. |
pageFeedAsset | Ресурс фида страницы. |
dynamicEducationAsset | Динамичный образовательный актив. |
mobileAppAsset | Актив мобильного приложения. |
hotelCalloutAsset | Объект уточнения отеля. |
callAsset | Актив вызова. |
priceAsset | Ценовой актив. |
callToActionAsset | Неизменный. Призыв к действию. |
dynamicRealEstateAsset | Динамичный объект недвижимости. |
dynamicCustomAsset | Динамический пользовательский актив. |
dynamicHotelsAndRentalsAsset | Динамичный актив в сфере отелей и сдачи в аренду. |
dynamicFlightsAsset | Актив динамичных полетов. |
demandGenCarouselCardAsset | Неизменный. Актив карты карусели формирования спроса. |
dynamicTravelAsset | Динамичный туристический актив. |
dynamicLocalAsset | Динамичный местный актив. |
dynamicJobsAsset | Актив динамичного трудоустройства. |
locationAsset | Только вывод. Объект местоположения. |
hotelPropertyAsset | Неизменный. Актив в виде гостиничной недвижимости. |
тип актива
Перечисление, описывающее возможные типы активов.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
YOUTUBE_VIDEO | Видеоресурс YouTube. |
MEDIA_BUNDLE | Ресурс медиагруппы. |
IMAGE | Имиджевый актив. |
TEXT | Текстовый актив. |
LEAD_FORM | Актив формы для потенциальных клиентов. |
BOOK_ON_GOOGLE | Забронируйте в активе Google. |
PROMOTION | Актив продвижения. |
CALLOUT | Выноска. |
STRUCTURED_SNIPPET | Актив структурированного фрагмента. |
SITELINK | Дополнительная ссылка. |
PAGE_FEED | Ресурс фида страниц. |
DYNAMIC_EDUCATION | Актив динамического образования. |
MOBILE_APP | Актив мобильного приложения. |
HOTEL_CALLOUT | Объект уточнения отеля. |
CALL | Вызов актива. |
PRICE | Ценовой актив. |
CALL_TO_ACTION | Призыв к действию. |
DYNAMIC_REAL_ESTATE | Динамический объект недвижимости. |
DYNAMIC_CUSTOM | Динамический пользовательский актив. |
DYNAMIC_HOTELS_AND_RENTALS | Динамичный актив в сфере отелей и аренды. |
DYNAMIC_FLIGHTS | Актив динамических полетов. |
DISCOVERY_CAROUSEL_CARD | Актив карты Discovery Carousel. |
DYNAMIC_TRAVEL | Динамичный туристический актив. |
DYNAMIC_LOCAL | Динамический локальный актив. |
DYNAMIC_JOBS | Актив динамичных рабочих мест. |
LOCATION | Объект местоположения. |
HOTEL_PROPERTY | Актив гостиничной недвижимости. |
АктивПолитикаСводка
Содержит информацию о политике для актива.
JSON-представление |
---|
{ "policyTopicEntries": [ { object ( |
Поля | |
---|---|
policyTopicEntries[] | Только вывод. Список результатов политики для этого актива. |
reviewStatus | Только вывод. На каком этапе проверки находится этот актив. |
approvalStatus | Только вывод. Общий статус утверждения этого актива, рассчитанный на основе статуса его отдельных записей в теме политики. |
AssetFieldTypePolicySummary
Содержит информацию о политике для актива в контексте AssetFieldType.
JSON-представление |
---|
{ "assetFieldType": enum ( |
Поля | |
---|---|
assetFieldType | Только вывод. FieldType этого актива. |
assetSource | Только вывод. Источник этого актива. |
policySummaryInfo | Только вывод. Краткое изложение политики. |
YoutubeВидеоАктив
Ресурс YouTube.
JSON-представление |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
Поля | |
---|---|
youtubeVideoTitle | Название видео на YouTube. |
youtubeVideoId | Идентификатор видео YouTube. Это строковое значение из 11 символов, используемое в URL-адресе видео YouTube. |
MediaBundleAsset
Ресурс MediaBundle.
JSON-представление |
---|
{ "data": string } |
Поля | |
---|---|
data | Данные об активах медиапакета (ZIP-файл). Формат загружаемого ZIP-файла зависит от поля объявления, в котором он будет использоваться. Дополнительные сведения о формате см. в документации к полю объявления, в котором вы планируете использовать MediaBundleAsset. Это поле доступно только для изменения. Строка в кодировке Base64. |
ImageAsset
Ресурс изображения.
JSON-представление |
---|
{ "mimeType": enum ( |
Поля | |
---|---|
mimeType | MIME-тип изображения. |
fullSize | Метаданные для этого изображения в исходном размере. |
data | Необработанные байты данных изображения. Это поле доступно только для изменения. Строка в кодировке Base64. |
fileSize | Размер файла изображения в байтах. |
Размер изображения
Метаданные для изображения определенного размера, исходного или измененного.
JSON-представление |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
Поля | |
---|---|
heightPixels | Высота изображения. |
widthPixels | Ширина изображения. |
url | URL-адрес, который возвращает изображение с этой высотой и шириной. |
ТекстАссет
Текстовый актив.
JSON-представление |
---|
{ "text": string } |
Поля | |
---|---|
text | Текстовое содержимое текстового актива. |
ЛидФормАссет
Актив формы для потенциальных клиентов.
JSON-представление |
---|
{ "businessName": string, "callToActionType": enum ( |
Поля | |
---|---|
businessName | Необходимый. Название рекламируемой компании. |
callToActionType | Необходимый. Предопределенный отображаемый текст, который побуждает пользователя развернуть форму. |
callToActionDescription | Необходимый. Текст, дающий четкое представление о том, чего ожидают пользователи, когда расширяют форму. |
headline | Необходимый. Заголовок расширенной формы, описывающий, что требуется или облегчает форма. |
description | Необходимый. Подробное описание расширенной формы, чтобы описать, что требуется или облегчает форма. |
privacyPolicyUrl | Необходимый. Ссылка на страницу с описанием политики обработки собранных данных рекламодателем/компанией. |
fields[] | Упорядоченный список полей ввода. Это поле можно обновить, изменив порядок вопросов, но не добавляя или удаляя вопросы. |
customQuestionFields[] | Упорядоченный список настраиваемых полей вопросов. В этом поле допускается не более 5 квалификационных вопросов на форму. |
deliveryMethods[] | Настроены методы для доставки собранных данных о потенциальных клиентах рекламодателю. Можно настроить только один метод с типом WebhookDelivery. |
postSubmitCallToActionType | Предопределенный отображаемый текст, который побуждает пользователя к действию после отправки формы. |
desiredIntent | Выбранное намерение формы для потенциальных клиентов, например, более объемное или более квалифицированное. |
postSubmitHeadline | Заголовок текста, отображаемый после отправки формы и описывающий, как рекламодатель будет связываться с пользователем. |
postSubmitDescription | Подробное описание, отображаемое после отправки формы, описывает, как рекламодатель будет связываться с пользователем. |
backgroundImageAsset | Имя ресурса актива фонового изображения. Размеры изображения должны быть ровно 1200x628. |
customDisclosure | Специальное раскрытие информации отображается вместе с заявлением об отказе от ответственности Google в форме для потенциальных клиентов. Доступно только авторизованным клиентам. |
Лидформкаллтоактионтипе
Перечисление, описывающее тип фраз призыва к действию в основной форме.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
LEARN_MORE | Узнать больше. |
GET_QUOTE | Получить цитату. |
APPLY_NOW | Применить сейчас. |
SIGN_UP | Зарегистрироваться. |
CONTACT_US | Связаться с нами. |
SUBSCRIBE | Подписаться. |
DOWNLOAD | Скачать. |
BOOK_NOW | Забронируйте сейчас. |
GET_OFFER | Получить предложение. |
REGISTER | Регистр. |
GET_INFO | Получить данные. |
REQUEST_DEMO | Запросите демо-версию. |
JOIN_NOW | Присоединяйся сейчас. |
GET_STARTED | Начать. |
Лидформфилд
Один экземпляр поля ввода в форме.
JSON-представление |
---|
{ "inputType": enum ( |
Поля | |
---|---|
inputType | Описывает тип ввода, который может быть предопределенным типом, например «полное имя», или предварительно проверенным вопросом, например «Какой тип транспортного средства у вас есть?». |
answers на поле Союза. Определяет конфигурацию ответа, которую принимает это поле формы. Если oneof не установлен, это ответ в виде произвольного текста. answers могут быть только одним из следующих: | |
singleChoiceAnswers | Конфигурация ответа на вопрос с одним выбором. Можно задать только для предварительно проверенных полей вопросов. Требуются минимум 2 ответа и разрешено максимум 12. |
hasLocationAnswer | Конфигурация ответа на вопрос о местоположении. Если это правда, данные о местоположении на уровне кампании/учетной записи (штат, город, название компании и т. д.) будут отображаться в форме для потенциальных клиентов. Начиная с версии 13.1, для параметра hasLocationAnswer можно задать только вопрос «Какой дилерский центр вы предпочитаете?» Вопрос для рекламодателей, у которых ресурсы местоположения настроены на уровне кампании/аккаунта. |
ЛидФормаОдинВыборОтветы
Определяет возможные ответы на вопрос с одним выбором, обычно представленный в виде раскрывающегося списка с одним выбором.
JSON-представление |
---|
{ "answers": [ string ] } |
Поля | |
---|---|
answers[] | Список вариантов для одного поля вопроса. Порядок записей определяет порядок пользовательского интерфейса. Требуются минимум 2 ответа и разрешено максимум 12. |
LeadFormCustomQuestionField
Один экземпляр поля ввода настраиваемого вопроса в форме.
JSON-представление |
---|
{ "customQuestionText": string, // Union field |
Поля | |
---|---|
customQuestionText | Точный текст поля настраиваемого вопроса (например, «Какой у вас автомобиль?»). |
answers на поле Союза. Определяет конфигурацию ответа, которую принимает это поле формы. Если oneof не установлен, это ответ в виде произвольного текста. answers могут быть только одним из следующих: | |
singleChoiceAnswers | Конфигурация ответа на вопрос с одним выбором. Разрешено минимум 2 ответа и максимум 12. |
hasLocationAnswer | Конфигурация ответа на вопрос о местоположении. Если это правда, данные о местоположении на уровне кампании/учетной записи (штат, город, название компании и т. д.) будут отображаться в форме для потенциальных клиентов. Начиная с версии 13.1, для параметра hasLocationAnswer можно задать только вопрос «Какой дилерский центр вы предпочитаете?» Вопрос для рекламодателей, у которых ресурсы местоположения настроены на уровне кампании/аккаунта. |
Метод доставки лидформы
Конфигурация доставки потенциальных клиентов рекламодателю.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
Поле объединения delivery_details . Различные подвиды доставки. delivery_details может быть только одним из следующих: | |
webhook | Метод доставки через вебхук. |
ВебхукДоставка
Google уведомляет рекламодателя о потенциальных клиентах, выполняя HTTP-вызовы к указанной им конечной точке. Запросы содержат JSON, соответствующий схеме, которую Google публикует как часть документации по рекламным объявлениям.
JSON-представление |
---|
{ "advertiserWebhookUrl": string, "googleSecret": string, "payloadSchemaVersion": string } |
Поля | |
---|---|
advertiserWebhookUrl | URL вебхука, указанный рекламодателем для отправки лида. |
googleSecret | Секрет защиты от спуфинга, установленный рекламодателем как часть полезной нагрузки веб-перехватчика. |
payloadSchemaVersion | Версия схемы, которую будет использовать этот экземпляр доставки. |
LeadFormPostSubmitCallToActionType
Перечисление, описывающее тип фраз призыва к действию после отправки для формы для потенциальных клиентов.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
VISIT_SITE | Посетите сайт. |
DOWNLOAD | Скачать. |
LEARN_MORE | Узнать больше. |
SHOP_NOW | Делайте покупки сейчас. |
Лидформдесирединтент
Перечисление, описывающее выбранный уровень намерения сгенерированных потенциальных клиентов.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
LOW_INTENT | Предоставляйте больше потенциальных клиентов с потенциально более низким качеством. |
HIGH_INTENT | Предоставляйте более квалифицированных потенциальных клиентов. |
BookOnGoogleAsset
Этот тип не имеет полей.
Книга в активе Google. Используется для перенаправления пользователя на бронирование через Google. При бронировании через Google URL-адрес перенаправления изменится на бронирование напрямую через Google.
ПродвижениеАктив
Актив продвижения.
JSON-представление |
---|
{ "promotionTarget": string, "discountModifier": enum ( |
Поля | |
---|---|
promotionTarget | Необходимый. Описание в свободной форме того, на что нацелена рекламная акция. |
discountModifier | Модификатор квалификации скидки. |
redemptionStartDate | Дата начала, когда акция может быть использована, в формате гггг-ММ-дд. |
redemptionEndDate | Последняя дата, когда акция может быть активирована, в формате гггг-ММ-дд. |
occasion | Событие, для которого была предназначена акция. Если событие установлено, окно погашения должно находиться в пределах диапазона дат, связанного с событием. |
languageCode | Язык продвижения. Представлен как языковой тег BCP 47. |
startDate | Дата начала, когда этот объект вступает в силу и может начать обслуживаться, в формате гггг-ММ-дд. |
endDate | Последняя дата, когда этот актив вступает в силу и продолжает работать, в формате гггг-ММ-дд. |
adScheduleTargets[] | Список непересекающихся расписаний с указанием всех интервалов времени, в течение которых может служить актив. В день может быть максимум 6 расписаний, всего 42. |
Поле объединения discount_type . Тип скидки: может быть процентной или суммовой. discount_type может быть только одним из следующих: | |
percentOff | Скидка в процентах по акции. 1 000 000 = 100%. Требуется либо это, либо MoneyAmountOff. |
moneyAmountOff | Сумма денег скидка на скидку в акции. Требуется либо это, либо процентВыкл. |
Объединённое поле promotion_trigger . Триггер продвижения. Может быть по промокоду или промокоду по подходящей сумме заказа. promotion_trigger может быть только одним из следующих: | |
promotionCode | Код, который пользователь должен использовать, чтобы иметь право на участие в акции. |
ordersOverAmount | Сумма общего заказа, необходимая для того, чтобы пользователь имел право на участие в акции. |
CalloutAsset
Ресурс выноски.
JSON-представление |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Поля | |
---|---|
calloutText | Необходимый. Текст выноски. Длина этой строки должна быть от 1 до 25 включительно. |
startDate | Дата начала, когда этот объект вступает в силу и может начать обслуживаться, в формате гггг-ММ-дд. |
endDate | Последняя дата, когда этот актив вступает в силу и продолжает работать, в формате гггг-ММ-дд. |
adScheduleTargets[] | Список непересекающихся расписаний с указанием всех интервалов времени, в течение которых может служить актив. В день может быть максимум 6 расписаний, всего 42. |
Структурированный сниппетАссет
Ресурс структурированного фрагмента.
JSON-представление |
---|
{ "header": string, "values": [ string ] } |
Поля | |
---|---|
header | Необходимый. Заголовок фрагмента. Эта строка должна быть одним из предопределенных значений в https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers. |
values[] | Необходимый. Значения во фрагменте. Размер этой коллекции должен быть от 3 до 10 включительно. Длина каждого значения должна составлять от 1 до 25 символов включительно. |
Объект дополнительной ссылки
Дополнительная ссылка.
JSON-представление |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Поля | |
---|---|
linkText | Необходимый. Текст URL-адреса для дополнительной ссылки. Длина этой строки должна быть от 1 до 25 включительно. |
description1 | Первая строка описания дополнительной ссылки. Если установлено, длина должна быть от 1 до 35 включительно, а также необходимо установить описание2. |
description2 | Вторая строка описания дополнительной ссылки. Если установлено, длина должна быть от 1 до 35 включительно, а также необходимо установить описание1. |
startDate | Дата начала, когда этот объект вступает в силу и может начать обслуживаться, в формате гггг-ММ-дд. |
endDate | Последняя дата, когда этот актив вступает в силу и продолжает работать, в формате гггг-ММ-дд. |
adScheduleTargets[] | Список непересекающихся расписаний с указанием всех интервалов времени, в течение которых может служить актив. В день может быть максимум 6 расписаний, всего 42. |
PageFeedAsset
Ресурс ленты страниц.
JSON-представление |
---|
{ "pageUrl": string, "labels": [ string ] } |
Поля | |
---|---|
pageUrl | Необходимый. Веб-страница, на которую хотят ориентироваться рекламодатели. |
labels[] | Метки, используемые для группировки URL-адресов страниц. |
ДинамическоеОбразованиеАктив
Актив динамического образования.
JSON-представление |
---|
{ "programId": string, "locationId": string, "programName": string, "subject": string, "programDescription": string, "schoolName": string, "address": string, "contextualKeywords": [ string ], "androidAppLink": string, "similarProgramIds": [ string ], "iosAppLink": string, "iosAppStoreId": string, "thumbnailImageUrl": string, "imageUrl": string } |
Поля | |
---|---|
programId | Необходимый. Идентификатор программы, который может представлять собой любую последовательность букв и цифр, должен быть уникальным и соответствовать значениям тега ремаркетинга. Необходимый. |
locationId | Идентификатор местоположения, который может представлять собой любую последовательность букв и цифр и должен быть уникальным. |
programName | Необходимый. Название программы, например, «Сестринское дело». Необходимый. |
subject | Предмет обучения, например, Здоровье. |
programDescription | Описание программы, например, «Сертификация медсестер». |
schoolName | Название школы, например Школа медсестер Маунтин-Вью. |
address | Адрес школы, который можно указать в одном из следующих форматов. (1) Город, штат, код, страна, например, Маунтин-Вью, Калифорния, США. (2) Полный адрес, например, 123 Boulevard St, Mountain View, CA 94043. (3) Широта-долгота в формате DDD, например, 41.40338, 2.17403. |
contextualKeywords[] | Контекстные ключевые слова, например, Сертификация медсестер, Здоровье, Маунтин-Вью. |
androidAppLink | Глубокая ссылка Android, например android-app://com.example.android/http/example.com/gizmos?1234. |
similarProgramIds[] | Похожие идентификаторы программ. |
iosAppLink | Ссылка на контент iOS, например exampleApp://content/page . |
iosAppStoreId | Идентификатор магазина приложений iOS. Это используется для проверки того, установлено ли у пользователя приложение на своем устройстве, перед диплинкингом. Если это поле установлено, то поле iosAppLink также должно присутствовать. |
thumbnailImageUrl | URL миниатюры изображения, например http://www.example.com/thumbnail.png . Миниатюрное изображение не будет загружено как ресурс изображения. |
imageUrl | URL-адрес изображения, например http://www.example.com/image.png . Изображение не будет загружено как ресурс изображения. |
Мобильное приложениеАссет
Актив, представляющий мобильное приложение.
JSON-представление |
---|
{
"appId": string,
"appStore": enum ( |
Поля | |
---|---|
appId | Необходимый. Строка, уникально идентифицирующая мобильное приложение. Он должен содержать только собственный идентификатор платформы, например «com.android.ebay» для Android или «12345689» для iOS. |
appStore | Необходимый. Магазин приложений, распространяющий это конкретное приложение. |
linkText | Необходимый. Видимый текст, отображаемый при отображении ссылки в объявлении. Длина этой строки должна быть от 1 до 25 включительно. |
startDate | Дата начала, когда этот объект вступает в силу и может начать обслуживаться, в формате гггг-ММ-дд. |
endDate | Последняя дата, когда этот объект вступает в силу и продолжает работать, в формате гггг-ММ-дд. |
ОтельВыноскаАктив
Актив, представляющий уточнение отеля.
JSON-представление |
---|
{ "text": string, "languageCode": string } |
Поля | |
---|---|
text | Необходимый. Текст объекта уточнения отеля. Длина этой строки должна быть от 1 до 25 включительно. |
languageCode | Необходимый. Язык уточнения отеля. Представлен как языковой тег BCP 47. |
CallAsset
Актив вызова.
JSON-представление |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
Поля | |
---|---|
countryCode | Необходимый. Двухбуквенный код страны номера телефона. Примеры: «США», «нас». |
phoneNumber | Необходимый. Необработанный номер телефона рекламодателя. Примеры: «1234567890», «(123)456-7890». |
callConversionReportingState | Указывает, должен ли этот CallAsset использовать собственную настройку преобразования вызовов, следовать настройке уровня учетной записи или отключить преобразование вызовов. |
callConversionAction | Действие-конверсия, которому будет присвоен звонок-конверсия. Если параметр не установлен, используется действие-конверсия по умолчанию. Это поле имеет эффект только в том случае, если для параметра callConversionReportingState установлено значение USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
adScheduleTargets[] | Список непересекающихся расписаний с указанием всех интервалов времени, в течение которых может служить актив. В день может быть максимум 6 расписаний, всего 42. |
ЦенаАктив
Актив, представляющий собой список ценовых предложений.
JSON-представление |
---|
{ "type": enum ( |
Поля | |
---|---|
type | Необходимый. Тип ценового актива. |
priceQualifier | Спецификатор цены ценового актива. |
languageCode | Необходимый. Язык ценового актива. Представлен как языковой тег BCP 47. |
priceOfferings[] | Ценовые предложения ценового актива. Размер этой коллекции должен быть от 3 до 8 включительно. |
ЦенаПредложение
Единое ценовое предложение в рамках PriceAsset.
JSON-представление |
---|
{ "header": string, "description": string, "price": { object ( |
Поля | |
---|---|
header | Необходимый. Заголовок ценового предложения. Длина этой строки должна быть от 1 до 25 включительно. |
description | Необходимый. Описание ценового предложения. Длина этой строки должна быть от 1 до 25 включительно. |
price | Необходимый. Ценовое значение ценового предложения. |
unit | Ценовая единица ценового предложения. |
finalUrl | Необходимый. Конечный URL-адрес после всех междоменных перенаправлений. |
finalMobileUrl | Конечный мобильный URL после всех междоменных перенаправлений. |
Каллтоактионассет
Призыв к действию.
JSON-представление |
---|
{
"callToAction": enum ( |
Поля | |
---|---|
callToAction | Призыв к действию. |
ДинамическийRealEstateAsset
Динамичный объект недвижимости.
JSON-представление |
---|
{ "listingId": string, "listingName": string, "cityName": string, "description": string, "address": string, "price": string, "imageUrl": string, "propertyType": string, "listingType": string, "contextualKeywords": [ string ], "formattedPrice": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarListingIds": [ string ] } |
Поля | |
---|---|
listingId | Необходимый. Идентификатор листинга, который может представлять собой любую последовательность букв и цифр, должен быть уникальным и соответствовать значениям тега ремаркетинга. Необходимый. |
listingName | Необходимый. Название объявления, например, Boulevard Bungalow. Необходимый. |
cityName | Название города, например, Маунтин-Вью, Калифорния. |
description | Описание, например, 3 кровати, 2 ванны, 1568 кв. футов. |
address | Адрес, который можно указать в одном из следующих форматов. (1) Город, штат, код, страна, например, Маунтин-Вью, Калифорния, США. (2) Полный адрес, например, 123 Boulevard St, Mountain View, CA 94043. (3) Широта-долгота в формате DDD, например, 41.40338, 2.17403. |
price | Цена, которая может представлять собой число, за которым следует буквенный код валюты, стандарт ISO 4217. Использовать '.' в качестве десятичного знака, например, 200 000,00 долларов США. |
imageUrl | URL-адрес изображения, например http://www.example.com/image.png . Изображение не будет загружено как ресурс изображения. |
propertyType | Тип недвижимости, например, Дом. |
listingType | Тип объявления, например, «Продается». |
contextualKeywords[] | Контекстные ключевые слова, например, Продается; Продажа домов. |
formattedPrice | Форматированная цена, которая может содержать любые символы. Если установлено, этот атрибут будет использоваться вместо «цены», например, «Начиная с 200 000,00 долларов США». |
androidAppLink | Глубокая ссылка Android, например android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink | Ссылка на контент iOS, например exampleApp://content/page . |
iosAppStoreId | Идентификатор магазина приложений iOS. Это используется для проверки того, установлено ли у пользователя приложение на своем устройстве, перед диплинкингом. Если это поле установлено, то поле iosAppLink также должно присутствовать. |
similarListingIds[] | Похожие идентификаторы объявлений. |
ДинамическийCustomAsset
Динамический пользовательский актив.
JSON-представление |
---|
{ "id": string, "id2": string, "itemTitle": string, "itemSubtitle": string, "itemDescription": string, "itemAddress": string, "itemCategory": string, "price": string, "salePrice": string, "formattedPrice": string, "formattedSalePrice": string, "imageUrl": string, "contextualKeywords": [ string ], "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarIds": [ string ] } |
Поля | |
---|---|
id | Необходимый. Идентификатор, который может представлять собой любую последовательность букв и цифр, должен быть уникальным и соответствовать значениям тега ремаркетинга, например седан. Необходимый. |
id2 | ID2, который может представлять собой любую последовательность букв и цифр, например красного цвета. Последовательность идентификаторов (ID + ID2) должна быть уникальной. |
itemTitle | Необходимый. Название товара, например, Среднеразмерный седан. Необходимый. |
itemSubtitle | Подзаголовок товара, например: «В вашем дилерском центре в Маунтин-Вью». |
itemDescription | Описание товара, например, «Самый продаваемый автомобиль среднего размера». |
itemAddress | Адрес элемента, который можно указать в одном из следующих форматов. (1) Город, штат, код, страна, например, Маунтин-Вью, Калифорния, США. (2) Полный адрес, например, 123 Boulevard St, Mountain View, CA 94043. (3) Широта-долгота в формате DDD, например, 41.40338, 2.17403. |
itemCategory | Категория товара, например, Седаны. |
price | Цена, которая может представлять собой число, за которым следует буквенный код валюты, стандарт ISO 4217. Использовать '.' в качестве десятичного знака, например, 20 000,00 долларов США. |
salePrice | Цена продажи, которая может представлять собой число, за которым следует буквенный код валюты, стандарт ISO 4217. Использовать '.' в качестве десятичного знака, например, 15 000,00 долларов США. Должно быть меньше поля «цена». |
formattedPrice | Форматированная цена, которая может содержать любые символы. Если установлено, этот атрибут будет использоваться вместо «цены», например, «Начиная с 20 000,00 долларов США». |
formattedSalePrice | Форматированная цена продажи, которая может содержать любые символы. Если этот атрибут установлен, этот атрибут будет использоваться вместо «Цена продажи», например «Распродажа за 15 000,00 долларов США». |
imageUrl | URL-адрес изображения, например http://www.example.com/image.png . Изображение не будет загружено как ресурс изображения. |
contextualKeywords[] | Контекстные ключевые слова, например, Седаны, 4-дверные седаны. |
androidAppLink | Глубокая ссылка Android, например android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink | Ссылка на контент iOS, например exampleApp://content/page . |
iosAppStoreId | Идентификатор магазина приложений iOS. Это используется для проверки того, установлено ли у пользователя приложение на своем устройстве, перед диплинкингом. Если это поле установлено, то поле iosAppLink также должно присутствовать. |
similarIds[] | Похожие идентификаторы. |
DynamicHotelsAndRentalsAsset
Динамичный актив в сфере отелей и сдачи в аренду.
JSON-представление |
---|
{ "propertyId": string, "propertyName": string, "imageUrl": string, "destinationName": string, "description": string, "price": string, "salePrice": string, "starRating": string, "category": string, "contextualKeywords": [ string ], "address": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "formattedPrice": string, "formattedSalePrice": string, "similarPropertyIds": [ string ] } |
Поля | |
---|---|
propertyId | Необходимый. Идентификатор ресурса, который может представлять собой любую последовательность букв и цифр, должен быть уникальным и соответствовать значениям тега ремаркетинга. Необходимый. |
propertyName | Необходимый. Название свойства, например Mountain View Hotel. Необходимый. |
imageUrl | URL-адрес изображения, например http://www.example.com/image.png . Изображение не будет загружено как ресурс изображения. |
destinationName | Название места назначения, например «Даунтаун Маунтин-Вью». |
description | Описание, например: Рядом с аэропортом SJC. |
price | Цена, которая может представлять собой число, за которым следует буквенный код валюты, стандарт ISO 4217. Использовать '.' в качестве десятичного знака, например, 100,00 долларов США. |
salePrice | Стандарт ИСО 4217. Использовать '.' в качестве десятичного знака, например, 80,00 долларов США. Должно быть меньше поля «цена». |
starRating | Звездный рейтинг. Должно быть числом от 1 до 5 включительно. |
category | Категория, например, «Гостиничный номер». |
contextualKeywords[] | Контекстные ключевые слова, например, Маунтин-Вью «Отели», отели Саут-Бэй. |
address | Адрес, который можно указать в одном из следующих форматов. (1) Город, штат, код, страна, например, Маунтин-Вью, Калифорния, США. (2) Полный адрес, например, 123 Boulevard St, Mountain View, CA 94043. (3) Широта-долгота в формате DDD, например, 41.40338, 2.17403. |
androidAppLink | Глубокая ссылка Android, например android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink | Ссылка на контент iOS, например exampleApp://content/page . |
iosAppStoreId | Идентификатор магазина приложений iOS. Это используется для проверки того, установлено ли у пользователя приложение на своем устройстве, перед диплинкингом. Если это поле установлено, то поле iosAppLink также должно присутствовать. |
formattedPrice | Форматированная цена, которая может содержать любые символы. Если установлено, этот атрибут будет использоваться вместо «цены», например, «Начиная со 100,00 долларов США». |
formattedSalePrice | Форматированная цена продажи, которая может содержать любые символы. Если этот атрибут установлен, этот атрибут будет использоваться вместо «цены со скидкой», например «Распродажа за 80,00 долларов США». |
similarPropertyIds[] | Похожие идентификаторы свойств. |
DynamicFlightsAsset
Актив динамичных полетов.
JSON-представление |
---|
{ "destinationId": string, "originId": string, "flightDescription": string, "imageUrl": string, "destinationName": string, "originName": string, "flightPrice": string, "flightSalePrice": string, "formattedPrice": string, "formattedSalePrice": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarDestinationIds": [ string ], "customMapping": string } |
Поля | |
---|---|
destinationId | Необходимый. Идентификатор назначения, который может представлять собой любую последовательность букв и цифр, должен быть уникальным и соответствовать значениям тега ремаркетинга. Необходимый. |
originId | Идентификатор происхождения, который может представлять собой любую последовательность букв и цифр. Последовательность идентификаторов (идентификатор назначения + идентификатор источника) должна быть уникальной. |
flightDescription | Необходимый. Описание рейса, например, «Забронируйте билет». Необходимый. |
imageUrl | URL-адрес изображения, например http://www.example.com/image.png . Изображение не будет загружено как ресурс изображения. |
destinationName | Название места назначения, например, Париж. |
originName | Название происхождения, например, Лондон. |
flightPrice | Стоимость полета может состоять из числа, за которым следует буквенный код валюты, стандарт ISO 4217. Использовать '.' в качестве десятичного знака, например, 100,00 долларов США. |
flightSalePrice | Цена продажи авиабилета, которая может представлять собой число, за которым следует буквенный код валюты, стандарт ISO 4217. Использовать '.' в качестве десятичного знака, например, 80,00 долларов США. Должно быть меньше поля FlightPrice. |
formattedPrice | Форматированная цена, которая может содержать любые символы. Если установлено, этот атрибут будет использоваться вместо «цены», например, «Начиная со 100,00 долларов США». |
formattedSalePrice | Форматированная цена продажи, которая может содержать любые символы. Если этот атрибут установлен, этот атрибут будет использоваться вместо «цены со скидкой», например «Распродажа за 80,00 долларов США». |
androidAppLink | Глубокая ссылка Android, например android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink | Ссылка на контент iOS, например exampleApp://content/page . |
iosAppStoreId | Идентификатор магазина приложений iOS. Это используется для проверки того, установлено ли у пользователя приложение на своем устройстве перед диплинкингом. Если это поле установлено, то поле iosAppLink также должно присутствовать. |
similarDestinationIds[] | Похожие идентификаторы назначения, например PAR,LON. |
customMapping | Пользовательское поле, которое может представлять собой несколько ключей для сопоставления значений, разделенных разделителями («,», «|» и «:») в форме « |
СпросГенКарусельКартаАктив
Актив карты карусели формирования спроса.
JSON-представление |
---|
{ "marketingImageAsset": string, "squareMarketingImageAsset": string, "portraitMarketingImageAsset": string, "headline": string, "callToActionText": string } |
Поля | |
---|---|
marketingImageAsset | Имя ресурса актива связанного маркетингового изображения с соотношением сторон 1,91:1. Требуется этот и/или квадратный маркетинговый имиджевый объект. |
squareMarketingImageAsset | Имя ресурса актива соответствующего квадратного маркетингового изображения. Требуется этот и/или маркетинговый имиджевый ресурс. |
portraitMarketingImageAsset | Имя ресурса ресурса связанного портретного маркетингового изображения с соотношением сторон 4:5. |
headline | Необходимый. Заголовок карточки карусели. |
callToActionText | Текст призыва к действию. |
ДинамическоеПутешествиеАссет
Динамичный туристический актив.
JSON-представление |
---|
{ "destinationId": string, "originId": string, "title": string, "destinationName": string, "destinationAddress": string, "originName": string, "price": string, "salePrice": string, "formattedPrice": string, "formattedSalePrice": string, "category": string, "contextualKeywords": [ string ], "similarDestinationIds": [ string ], "imageUrl": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string } |
Поля | |
---|---|
destinationId | Необходимый. Идентификатор назначения, который может представлять собой любую последовательность букв и цифр, должен быть уникальным и соответствовать значениям тега ремаркетинга. Необходимый. |
originId | Идентификатор происхождения, который может представлять собой любую последовательность букв и цифр. Последовательность идентификаторов (идентификатор назначения + идентификатор источника) должна быть уникальной. |
title | Необходимый. Заголовок, например, «Забронируйте билет на поезд». Необходимый. |
destinationName | Название места назначения, например, Париж. |
destinationAddress | Адрес назначения, который можно указать в одном из следующих форматов. (1) Город, штат, код, страна, например, Маунтин-Вью, Калифорния, США. (2) Полный адрес, например, 123 Boulevard St, Mountain View, CA 94043. (3) Широта-долгота в формате DDD, например, 41,40338, 2,17403. |
originName | Название происхождения, например, Лондон. |
price | Цена, которая может представлять собой число, за которым следует буквенный код валюты, стандарт ISO 4217. Использовать '.' в качестве десятичного знака, например, 100,00 долларов США. |
salePrice | Цена продажи, которая может представлять собой число, за которым следует буквенный код валюты, стандарт ISO 4217. Использовать '.' в качестве десятичного знака, например, 80,00 долларов США. Должно быть меньше поля «цена». |
formattedPrice | Форматированная цена, которая может содержать любые символы. Если установлено, этот атрибут будет использоваться вместо «цены», например, «Начиная со 100,00 долларов США». |
formattedSalePrice | Форматированная цена продажи, которая может содержать любые символы. Если этот атрибут установлен, этот атрибут будет использоваться вместо «цены со скидкой», например «Распродажа за 80,00 долларов США». |
category | Категория, например, Экспресс. |
contextualKeywords[] | Контекстные ключевые слова, например, поезда в Париже. |
similarDestinationIds[] | Похожие идентификаторы пунктов назначения, например Нью-Йорк. |
imageUrl | URL-адрес изображения, например http://www.example.com/image.png . Изображение не будет загружено как ресурс изображения. |
androidAppLink | Глубокая ссылка Android, например android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink | Ссылка на контент iOS, например exampleApp://content/page . |
iosAppStoreId | Идентификатор магазина приложений iOS. Это используется для проверки того, установлено ли у пользователя приложение на своем устройстве, перед диплинкингом. Если это поле установлено, то поле iosAppLink также должно присутствовать. |
ДинамическийЛокальныйАссет
Динамичный местный актив.
JSON-представление |
---|
{ "dealId": string, "dealName": string, "subtitle": string, "description": string, "price": string, "salePrice": string, "imageUrl": string, "address": string, "category": string, "contextualKeywords": [ string ], "formattedPrice": string, "formattedSalePrice": string, "androidAppLink": string, "similarDealIds": [ string ], "iosAppLink": string, "iosAppStoreId": string } |
Поля | |
---|---|
dealId | Необходимый. Идентификатор сделки может представлять собой любую последовательность букв и цифр. Он должен быть уникальным и соответствовать значениям тега ремаркетинга. Необходимый. |
dealName | Необходимый. Название сделки, например: скидка 50 % в магазине Mountain View Grocers. Необходимый. |
subtitle | Подзаголовок, например, «Продукты». |
description | Описание, например: Сэкономьте на еженедельном счете. |
price | Цена, которая может представлять собой число, за которым следует буквенный код валюты, стандарт ISO 4217. Использовать '.' в качестве десятичного знака, например, 100,00 долларов США. |
salePrice | Цена продажи, которая может представлять собой число, за которым следует буквенный код валюты, стандарт ISO 4217. Использовать '.' в качестве десятичного знака, например, 80,00 долларов США. Должно быть меньше поля «цена». |
imageUrl | URL-адрес изображения, например http://www.example.com/image.png . Изображение не будет загружено как ресурс изображения. |
address | Адрес, который можно указать в одном из следующих форматов. (1) Город, штат, код, страна, например, Маунтин-Вью, Калифорния, США. (2) Полный адрес, например, 123 Boulevard St, Mountain View, CA 94043. (3) Широта-долгота в формате DDD, например, 41,40338, 2,17403. |
category | Категория, например, Еда. |
contextualKeywords[] | Контекстные ключевые слова, например «Купоны на покупку продуктов». |
formattedPrice | Форматированная цена, которая может содержать любые символы. Если установлено, этот атрибут будет использоваться вместо «цены», например, «Начиная со 100,00 долларов США». |
formattedSalePrice | Форматированная цена продажи, которая может содержать любые символы. Если этот атрибут установлен, этот атрибут будет использоваться вместо «цены со скидкой», например «Распродажа за 80,00 долларов США». |
androidAppLink | Глубокая ссылка Android, например android-app://com.example.android/http/example.com/gizmos?1234. |
similarDealIds[] | Похожие идентификаторы сделок, например 1275. |
iosAppLink | Ссылка на контент iOS, например exampleApp://content/page . |
iosAppStoreId | Идентификатор магазина приложений iOS. Это используется для проверки того, установлено ли у пользователя приложение на своем устройстве перед диплинкингом. Если это поле установлено, то поле iosAppLink также должно присутствовать. |
Динамический ДжобсАссет
Актив динамичного трудоустройства.
JSON-представление |
---|
{ "jobId": string, "locationId": string, "jobTitle": string, "jobSubtitle": string, "description": string, "imageUrl": string, "jobCategory": string, "contextualKeywords": [ string ], "address": string, "salary": string, "androidAppLink": string, "similarJobIds": [ string ], "iosAppLink": string, "iosAppStoreId": string } |
Поля | |
---|---|
jobId | Необходимый. Идентификатор вакансии, который может представлять собой любую последовательность букв и цифр, должен быть уникальным и соответствовать значениям тега ремаркетинга. Необходимый. |
locationId | Идентификатор местоположения, который может представлять собой любую последовательность букв и цифр. Последовательность идентификаторов (идентификатор задания + идентификатор местоположения) должна быть уникальной. |
jobTitle | Необходимый. Должность, например, «Инженер-программист». Необходимый. |
jobSubtitle | Подзаголовок задания, например, Уровень II. |
description | Описание, например: Примените свои технические навыки. |
imageUrl | URL-адрес изображения, например http://www.example.com/image.png . Изображение не будет загружено как ресурс изображения. |
jobCategory | Категория вакансии, например, Технический. |
contextualKeywords[] | Контекстные ключевые слова, например, «Вакансия по разработке программного обеспечения». |
address | Адрес, который можно указать в одном из следующих форматов. (1) Город, штат, код, страна, например, Маунтин-Вью, Калифорния, США. (2) Полный адрес, например, 123 Boulevard St, Mountain View, CA 94043. (3) Широта-долгота в формате DDD, например, 41,40338, 2,17403. |
salary | Заработная плата, например, 100 000 долларов. |
androidAppLink | Глубокая ссылка Android, например android-app://com.example.android/http/example.com/gizmos?1234. |
similarJobIds[] | Похожие идентификаторы вакансий, например, 1275. |
iosAppLink | Ссылка на контент iOS, например exampleApp://content/page . |
iosAppStoreId | Идентификатор магазина приложений iOS. Это используется для проверки того, установлено ли у пользователя приложение на своем устройстве, перед диплинкингом. Если это поле установлено, то поле iosAppLink также должно присутствовать. |
МестоположениеАктив
Объект местоположения.
JSON-представление |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
Поля | |
---|---|
placeId | Идентификаторы мест однозначно идентифицируют место в базе данных Google Адресов и на Картах Google. Это поле уникально для данного идентификатора клиента и типа актива. См. https://developers.google.com/places/web-service/place-id , чтобы узнать больше об идентификаторе места. |
businessProfileLocations[] | Список офисов клиента. Он будет возвращен только в том случае, если объект местоположения синхронизируется с учетной записью бизнес-профиля. Под одной учетной записью можно иметь несколько записей в профиле компании, которые указывают на один и тот же идентификатор места. |
locationOwnershipType | Тип владения местоположением. Если тип – BUSINESS_OWNER, он будет использоваться как расширение местоположения. Если тип ПАРТНЕРСКИЙ, он будет использоваться в качестве партнерского местоположения. |
БизнесПрофильМестоположение
Данные о местоположении бизнес-профиля синхронизируются из связанной учетной записи бизнес-профиля.
JSON-представление |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
Поля | |
---|---|
labels[] | Метка местоположения, указанная рекламодателем в аккаунте профиля компании. Это синхронизируется с учетной записью бизнес-профиля. |
storeCode | Код магазина этого местоположения в профиле компании. Это синхронизируется с учетной записью бизнес-профиля. |
listingId | Листинговый идентификатор этого местоположения в профиле компании. Они синхронизируются со связанной учетной записью бизнес-профиля. |
ОтельСобственностьАктив
Актив в виде гостиничной недвижимости.
JSON-представление |
---|
{ "placeId": string, "hotelAddress": string, "hotelName": string } |
Поля | |
---|---|
placeId | Идентификаторы мест однозначно идентифицируют место в базе данных Google Адресов и на Картах Google. См. https://developers.google.com/places/web-service/place-id , чтобы узнать больше. |
hotelAddress | Адрес отеля. Только для чтения. |
hotelName | Название отеля. Только для чтения. |