Package google.ads.searchads360.v0.resources

Индекс

Доступная стратегия ставок

Представляет представление BiddingStrategies, принадлежащее клиенту и доступное ему.

В отличие от BiddingStrategy, этот ресурс включает стратегии, принадлежащие менеджерам клиента и доступные этому клиенту, в дополнение к стратегиям, принадлежащим этому клиенту. Этот ресурс не предоставляет показателей и предоставляет только ограниченное подмножество атрибутов BiddingStrategy.

Поля
resource_ name

string

Название ресурса доступной стратегии назначения ставок. Имена ресурсов AccessibleBiddingStrategy имеют вид:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

Идентификатор стратегии назначения ставок.

name

string

Название стратегии назначения ставок.

type

BiddingStrategyType

Тип стратегии назначения ставок.

owner_ customer_ id

int64

Идентификатор клиента, которому принадлежит стратегия назначения ставок.

owner_ descriptive_ name

string

descriptive_name клиента, которому принадлежит стратегия назначения ставок.

scheme поля Союза. Схема торгов.

Можно установить только один. scheme может быть только одной из следующих:

maximize_ conversion_ value

MaximizeConversionValue

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

maximize_ conversions

MaximizeConversions

Стратегия автоматического назначения ставок, которая поможет получить максимальное количество конверсий в ваших кампаниях, расходуя при этом бюджет.

target_ cpa

TargetCpa

Стратегия назначения ставок, позволяющая получить как можно больше конверсий по заданной вами целевой цене за конверсию.

target_ impression_ share

TargetImpressionShare

Стратегия назначения ставок, которая автоматически оптимизируется в соответствии с выбранным процентом показов.

target_ roas

TargetRoas

Стратегия назначения ставок, которая поможет вам максимизировать доход, обеспечивая при этом среднюю целевую рентабельность инвестиций в рекламу (ROAS).

target_ spend

TargetSpend

Стратегия назначения ставок, которая устанавливает ставки так, чтобы получить как можно больше кликов в рамках вашего бюджета.

Максимизироватьконверсионвалуе

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

Поля
target_ roas

double

Опция целевой рентабельности инвестиций в рекламу (ROAS). Если этот параметр установлен, стратегия назначения ставок будет максимизировать доход при усреднении целевой рентабельности инвестиций в рекламу. Если целевая рентабельность инвестиций в рекламу высока, стратегия назначения ставок может оказаться не в состоянии израсходовать весь бюджет. Если целевая рентабельность инвестиций в рекламу не задана, стратегия назначения ставок будет направлена ​​на достижение максимально возможной рентабельности инвестиций в рекламу в рамках бюджета.

Максимизация конверсий

Стратегия автоматического назначения ставок, которая поможет получить максимальное количество конверсий в ваших кампаниях, расходуя при этом бюджет.

Поля
target_ cpa

int64

Опция целевой цены за приобретение (CPA). Это средняя сумма, которую вы готовы потратить на одно приобретение.

target_ cpa_ micros

int64

Опция целевой цены за приобретение (CPA). Это средняя сумма, которую вы готовы потратить на одно приобретение.

Целевая цена за конверсию

Стратегия автоматического назначения ставок, позволяющая получить как можно больше конверсий по заданной вами целевой цене за конверсию.

Поля
target_ cpa_ micros

int64

Целевая средняя цена за конверсию. Эта цель должна быть больше или равна минимальной единице оплаты в зависимости от валюты аккаунта.

Целевая доля показов

Стратегия автоматического назначения ставок, которая устанавливает ставки таким образом, чтобы определенный процент поисковых объявлений показывался вверху первой страницы (или в другом целевом месте).

Поля
location

TargetImpressionShareLocation

Целевое местоположение на странице результатов поиска.

location_ fraction_ micros

int64

Выбранная доля рекламы, которая будет показываться в целевом месте, в микрометрах. Например, 1% равен 10 000.

cpc_ bid_ ceiling_ micros

int64

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

Целевая рентабельность инвестиций в рекламу

Стратегия автоматического назначения ставок, которая поможет вам максимизировать доход, обеспечивая при этом среднюю целевую рентабельность инвестиций в рекламу (ROAS).

Поля
target_ roas

double

Выбранный доход (на основе данных о конверсиях) на единицу расходов.

Целевые расходы

Автоматизированная стратегия назначения ставок, которая устанавливает ставки так, чтобы получить как можно больше кликов в рамках вашего бюджета.

Поля
target_spend_micros
(deprecated)

int64

Целевой показатель расходов, при достижении которого можно получить максимальное количество кликов. Участник торгов TargetSpend попытается потратить меньшую из этих величин или суммы расходов при естественном регулировании. Если не указано, бюджет используется в качестве целевого показателя расходов. Это поле устарело и больше не должно использоваться. Подробности см. на странице https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html .

cpc_ bid_ ceiling_ micros

int64

Максимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией.

Реклама.

Поля
resource_ name

string

Имя ресурса объявления. Имена рекламных ресурсов имеют вид:

customers/{customer_id}/ads/{ad_id}

final_ urls[]

string

Список возможных конечных URL-адресов после всех междоменных перенаправлений объявления.

type

AdType

Тип объявления.

id

int64

Идентификатор объявления.

display_ url

string

URL-адрес, который отображается в описании объявления для некоторых форматов объявлений.

name

string

Название объявления. Это используется только для идентификации объявления. Он не обязательно должен быть уникальным и не влияет на отображаемое объявление. Поле имени в настоящее время поддерживается только для DisplayUploadAd, ImageAd, ShoppingComparisonListingAd и VideoAd.

Поле объединения ad_data . Подробности, относящиеся к типу объявления. Должно быть установлено ровно одно значение. ad_data может быть только одним из следующих:
text_ ad

SearchAds360TextAdInfo

Подробности, относящиеся к текстовому объявлению.

expanded_ text_ ad

SearchAds360ExpandedTextAdInfo

Подробная информация о развернутом текстовом объявлении.

responsive_ search_ ad

SearchAds360ResponsiveSearchAdInfo

Подробная информация об адаптивном поисковом объявлении.

product_ ad

SearchAds360ProductAdInfo

Подробности, относящиеся к рекламе продукта.

expanded_ dynamic_ search_ ad

SearchAds360ExpandedDynamicSearchAdInfo

Подробная информация о расширенном динамическом поисковом объявлении.

Группа объявлений

Группа объявлений.

Поля
resource_ name

string

Имя ресурса группы объявлений. Названия ресурсов группы объявлений имеют вид:

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

Статус группы объявлений.

type

AdGroupType

Тип группы объявлений.

ad_ rotation_ mode

AdGroupAdRotationMode

Режим ротации объявлений в группе объявлений.

creation_ time

string

Временная метка создания этой группы объявлений. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс».

targeting_ setting

TargetingSetting

Настройка таргетинга на связанные функции.

labels[]

string

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

effective_ labels[]

string

Названия ресурсов эффективных ярлыков, прикрепленных к этой группе объявлений. Эффективный ярлык – это ярлык, унаследованный или напрямую назначенный этой группе объявлений.

engine_ id

string

Идентификатор группы объявлений во внешнем аккаунте системы. Это поле предназначено только для аккаунтов, не принадлежащих Google Реклама, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта Google Реклама вместо этого используйте «ad_group.id».

start_ date

string

Дата, когда в этой группе объявлений начнется показ объявлений. По умолчанию группа объявлений начинается сейчас или в дату начала группы объявлений, в зависимости от того, что наступит позже. Если это поле задано, то группа объявлений начинается в начале указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и шлюза Facebook.

Формат: ГГГГ-ММ-ДД. Пример: 14.03.2019.

end_ date

string

Дата прекращения показа объявлений в группе объявлений. По умолчанию группа объявлений заканчивается в дату окончания группы объявлений. Если это поле задано, группа объявлений заканчивается в конце указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и шлюза Facebook.

Формат: ГГГГ-ММ-ДД. Пример: 14.03.2019.

language_ code

string

Язык объявлений и ключевых слов в группе объявлений. Это поле доступно только для учетных записей Microsoft Advertising. Более подробная информация: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage.

last_ modified_ time

string

Дата и время последнего изменения этой группы объявлений. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс».

id

int64

Идентификатор группы объявлений.

name

string

Название группы объявлений.

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

Он должен содержать менее 255 символов полной ширины UTF-8.

Он не должен содержать нулевых символов (кодовая точка 0x0), перевода строки NL (кодовая точка 0xA) или возврата каретки (кодовая точка 0xD).

cpc_ bid_ micros

int64

Максимальная ставка CPC (цена за клик).

engine_ status

AdGroupEngineStatus

Статус системы для группы объявлений.

Группа объявленийОбъявление

Объявление группы объявлений.

Поля
resource_ name

string

Имя ресурса объявления. Названия рекламных ресурсов группы объявлений имеют следующий вид:

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

status

AdGroupAdStatus

Статус объявления.

ad

Ad

Реклама.

creation_ time

string

Временная метка создания объявления ad_group_ad. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс».

labels[]

string

Имена ресурсов ярлыков, прикрепленных к этому объявлению группы объявлений.

effective_ labels[]

string

Названия ресурсов эффективных ярлыков, прикрепленных к этому объявлению. Эффективный ярлык – это ярлык, унаследованный или напрямую назначенный этому объявлению.

engine_ id

string

Идентификатор объявления во внешнем аккаунте системы. Это поле предназначено только для учетной записи Search Ads 360, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта, не относящегося к Search Ads 360, вместо этого используйте «ad_group_ad.ad.id».

engine_ status

AdGroupAdEngineStatus

Дополнительный статус объявления во внешнем аккаунте движка. Возможные статусы (в зависимости от типа внешней учетной записи) включают активный, соответствующий требованиям, ожидающий проверки и т. д.

last_ modified_ time

string

Дата и время последнего изменения этого объявления группы объявлений. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс».

Группа объявленийAdEffectiveLabel

Связь между объявлением группы объявлений и эффективным ярлыком. Эффективный ярлык – это ярлык, унаследованный или напрямую назначенный данному объявлению в группе объявлений.

Поля
resource_ name

string

Имя ресурса эффективного ярлыка объявления группы объявлений. Названия ресурсов эффективных ярлыков объявлений группы объявлений имеют следующий вид: customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}

ad_ group_ ad

string

Объявление группы объявлений, к которому прикреплен действующий ярлык.

label

string

Действующий ярлык, присвоенный объявлению группы объявлений.

owner_ customer_ id

int64

Идентификатор клиента, которому принадлежит действующая этикетка.

Группа объявленийAdLabel

Связь между объявлением группы объявлений и ярлыком.

Поля
resource_ name

string

Имя ресурса ярлыка объявления группы объявлений. Имена ресурсов меток объявлений группы объявлений имеют форму: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

ad_ group_ ad

string

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

label

string

Ярлык, присвоенный объявлению группы объявлений.

owner_ customer_ id

int64

Идентификатор клиента, которому принадлежит этикетка.

Актив группы объявлений

Связь между группой объявлений и объектом.

Поля
resource_ name

string

Имя ресурса объекта группы объявлений. Имена ресурсов AdGroupAsset имеют вид:

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

ad_ group

string

Необходимый. Группа объявлений, с которой связан объект.

asset

string

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

status

AssetLinkStatus

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

AdGroupAssetSet

AdGroupAssetSet – это связь между группой объявлений и набором объектов. Создание AdGroupAssetSet связывает набор объектов с группой объявлений.

Поля
resource_ name

string

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

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

ad_ group

string

Группа объявлений, с которой связан этот набор объектов.

asset_ set

string

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

status

AssetSetLinkStatus

Статус набора объектов группы объявлений. Только для чтения.

Группа объявленийАудиторияView

Просмотр аудитории группы объявлений. Включает данные об эффективности по интересам и спискам ремаркетинга для рекламы в контекстно-медийной сети и сети YouTube, а также списки ремаркетинга для поисковых объявлений (RLSA), агрегированные на уровне аудитории.

Поля
resource_ name

string

Имя ресурса представления аудитории группы объявлений. Названия ресурсов просмотра аудитории группы объявлений имеют следующий вид:

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

Модификатор ставки группы объявлений

Представляет модификатор ставки на уровне группы объявлений.

Поля
resource_ name

string

Имя ресурса модификатора ставок на уровне группы объявлений. Названия ресурсов модификаторов ставок группы объявлений имеют следующий вид:

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

bid_ modifier

double

Модификатор ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 – 10,0. Диапазон составляет 1,0–6,0 для PreferredContent. Используйте 0, чтобы отказаться от типа устройства.

criterion поля объединения. Критерий модификатора ставок для группы объявлений.

Требуется при операциях создания, начиная с V5. criterion может быть только одним из следующих:

device

DeviceInfo

Критерий устройства.

Критерий группы объявлений

Критерий группы объявлений. Отчет ad_group_criterion возвращает только те критерии, которые были явно добавлены в группу объявлений.

Поля
resource_ name

string

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

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

creation_ time

string

Временная метка создания критерия группы объявлений. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс».

status

AdGroupCriterionStatus

Статус критерия.

Это статус объекта критерия группы объявлений, установленный клиентом. Примечание. Отчеты пользовательского интерфейса могут включать дополнительную информацию, влияющую на возможность применения критерия. В некоторых случаях критерий, УДАЛЕННЫЙ в API, все равно может отображаться в пользовательском интерфейсе как включенный. Например, кампании по умолчанию показываются пользователям всех возрастных диапазонов, если они не исключены. В пользовательском интерфейсе каждая возрастная группа будет отображаться как «включенная», поскольку они имеют право видеть рекламу; но в AdGroupCriterion.status будет указано «удалено», поскольку положительный критерий не был добавлен.

quality_ info

QualityInfo

Информация о качестве критерия.

type

CriterionType

Тип критерия.

labels[]

string

Имена ресурсов ярлыков, прикрепленных к этому критерию группы объявлений.

effective_ labels[]

string

Названия ресурсов эффективных ярлыков, прикрепленных к этому критерию группы объявлений. Эффективный ярлык – это ярлык, унаследованный или напрямую присвоенный этому критерию группы объявлений.

position_ estimates

PositionEstimates

Оценки критериальных ставок на различных позициях.

final_ urls[]

string

Список возможных конечных URL-адресов после всех междоменных перенаправлений объявления.

engine_ id

string

Идентификатор критерия группы объявлений во внешнем аккаунте системы. Это поле предназначено только для аккаунтов, не принадлежащих Google Реклама, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта Google Реклама вместо этого используйте «ad_group_criterion.criterion_id».

last_ modified_ time

string

Дата и время последнего изменения этого критерия группы объявлений. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс».

criterion_ id

int64

Идентификатор критерия.

ad_ group

string

Группа объявлений, к которой относится критерий.

negative

bool

Нацеливать ( false ) или исключать ( true ) критерий.

Это поле неизменяемо. Чтобы переключить критерий с положительного на отрицательный, удалите его, а затем добавьте заново.

bid_ modifier

double

Модификатор ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 – 10,0. Большинство типов таргетируемых критериев поддерживают модификаторы.

cpc_ bid_ micros

int64

Ставка CPC (цена за клик).

effective_ cpc_ bid_ micros

int64

Эффективная ставка CPC (цена за клик).

engine_ status

AdGroupCriterionEngineStatus

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

final_ url_ suffix

string

Шаблон URL-адреса для добавления параметров к конечному URL-адресу.

tracking_ url_ template

string

Шаблон URL-адреса для создания URL-адреса отслеживания.

criterion поля объединения. Критерий группы объявлений.

Должен быть установлен именно один. criterion может быть только одним из следующих:

keyword

KeywordInfo

Ключевое слово.

listing_ group

ListingGroupInfo

Группа листингов.

age_ range

AgeRangeInfo

Возрастной диапазон.

gender

GenderInfo

Пол.

user_ list

UserListInfo

Список пользователей.

webpage

WebpageInfo

Веб-страница

location

LocationInfo

Расположение.

ПозицияОценки

Оценки критериальных ставок на различных позициях.

Поля
top_ of_ page_ cpc_ micros

int64

Оценка ставки CPC, необходимой для показа объявления вверху первой страницы результатов поиска.

Информация о качестве

Контейнер для информации о качестве критериев группы объявлений.

Поля
quality_ score

int32

Показатель качества.

Это поле может быть не заполнено, если у Google недостаточно информации для определения значения.

AdGroupCriterionEffectiveLabel

Связь между критерием группы объявлений и эффективным ярлыком. Эффективный ярлык – это ярлык, унаследованный или напрямую присвоенный этому критерию группы объявлений.

Поля
resource_ name

string

Имя ресурса эффективной метки критерия группы объявлений. Названия ресурсов эффективных ярлыков критерия группы объявлений имеют форму: customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_ group_ criterion

string

Критерий группы объявлений, к которому прикреплен действующий ярлык.

label

string

Действующий ярлык, присвоенный критерию группы объявлений.

owner_ customer_ id

int64

Идентификатор клиента, которому принадлежит действующая этикетка.

AdGroupCriterionLabel

Связь между критерием группы объявлений и ярлыком.

Поля
resource_ name

string

Имя ресурса метки критерия группы объявлений. Имена ресурсов меток критерия группы объявлений имеют форму: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_ group_ criterion

string

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

label

string

Ярлык, присвоенный критерию группы объявлений.

owner_ customer_ id

int64

Идентификатор клиента, которому принадлежит этикетка.

Группа объявленийEffectiveLabel

Связь между группой объявлений и эффективным ярлыком. Эффективный ярлык – это ярлык, унаследованный или напрямую назначенный этой группе объявлений.

Поля
resource_ name

string

Имя ресурса эффективного ярлыка группы объявлений. Имена эффективных ярлыков группы объявлений имеют следующий формат: customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

ad_ group

string

Группа объявлений, к которой прикреплен действующий ярлык.

label

string

Действующий ярлык, присвоенный группе объявлений.

owner_ customer_ id

int64

Идентификатор клиента, которому принадлежит действующая этикетка.

Ярлык группы объявлений

Связь между группой объявлений и ярлыком.

Поля
resource_ name

string

Имя ресурса ярлыка группы объявлений. Имена ресурсов ярлыков групп объявлений имеют форму: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}

ad_ group

string

Группа объявлений, к которой прикреплен ярлык.

label

string

Ярлык, присвоенный группе объявлений.

owner_ customer_ id

int64

Идентификатор клиента, которому принадлежит этикетка.

Возрастной диапазонПросмотр

Представление о возрастном диапазоне.

Поля
resource_ name

string

Имя ресурса представления возрастного диапазона. Имена ресурсов представления возрастного диапазона имеют вид:

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

Объект

Актив – это часть объявления, которую можно использовать в нескольких объявлениях. Это может быть изображение (ImageAsset), видео (YoutubeVideoAsset) и т. д. Ресурсы неизменяемы и не могут быть удалены. Чтобы остановить показ объекта, удалите его из организации, которая его использует.

Поля
resource_ name

string

Имя ресурса актива. Имена ресурсов активов имеют форму:

customers/{customer_id}/assets/{asset_id}

type

AssetType

Тип актива.

final_ urls[]

string

Список возможных конечных URL-адресов после всех междоменных перенаправлений.

status

AssetStatus

Статус актива.

creation_ time

string

Временная метка создания этого актива. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс».

last_ modified_ time

string

Дата и время последнего изменения этого актива. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс».

id

int64

Идентификатор актива.

name

string

Необязательное имя актива.

tracking_ url_ template

string

Шаблон URL-адреса для создания URL-адреса отслеживания.

engine_ status

AssetEngineStatus

Статус механизма для актива.

Поле объединения asset_data . Конкретный тип актива. asset_data может быть только одним из следующих:
youtube_ video_ asset

YoutubeVideoAsset

Видеоресурс YouTube.

image_ asset

ImageAsset

Имиджевый актив.

text_ asset

TextAsset

Текстовый ресурс.

callout_ asset

UnifiedCalloutAsset

Единый объект выноски.

page_ feed_ asset

UnifiedPageFeedAsset

Единый ресурс фида страниц.

mobile_ app_ asset

MobileAppAsset

Актив мобильного приложения.

call_ asset

UnifiedCallAsset

Единый актив вызова.

call_ to_ action_ asset

CallToActionAsset

Призыв к действию.

location_ asset

UnifiedLocationAsset

Единый объект местоположения.

Группа активов

Группа активов. AssetGroupAsset используется для привязки актива к группе активов. AssetGroupSignal используется для привязки сигнала к группе активов.

Поля
resource_ name

string

Имя ресурса группы активов. Имена ресурсов группы активов имеют форму:

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

Идентификатор группы активов.

campaign

string

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

name

string

Необходимый. Название группы активов. Необходимый. Он должен иметь минимальную длину 1 и максимальную длину 128. Он должен быть уникальным в рамках кампании.

final_ urls[]

string

Список конечных URL-адресов после всех междоменных перенаправлений. В режиме максимальной эффективности URL-адреса по умолчанию можно расширять, если этот параметр не отключен.

final_ mobile_ urls[]

string

Список конечных мобильных URL-адресов после всех междоменных перенаправлений. В режиме максимальной эффективности по умолчанию URL-адреса можно расширять, если этот параметр не отключен.

status

AssetGroupStatus

Статус группы активов.

path1

string

Первая часть текста, которая может быть добавлена ​​к URL-адресу, отображаемому в объявлении.

path2

string

Вторая часть текста, которая может быть добавлена ​​к URL-адресу, отображаемому в объявлении. Это поле можно задать только в том случае, если задан путь1.

ad_ strength

AdStrength

Общая эффективность рекламы для этой группы объектов.

Группа АктивовАктив

AssetGroupAsset — это связь между активом и группой активов. Добавление AssetGroupAsset связывает актив с группой активов.

Поля
resource_ name

string

Имя ресурса актива группы активов. Имя ресурса актива группы активов имеет вид:

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

asset_ group

string

Группа активов, с которой связан этот актив группы активов.

asset

string

Актив, с которым связан этот актив группы активов.

field_ type

AssetFieldType

Описание размещения актива в группе активов. Например: HEADLINE, YOUTUBE_VIDEO и т. д.

status

AssetLinkStatus

Статус связи между активом и группой активов.

AssetGroupAssetCombinationData

Данные о комбинации активов группы активов

Поля
asset_ combination_ served_ assets[]

AssetUsage

Обслуженные активы.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter представляет узел дерева фильтров группы списков в группе активов.

Поля
resource_ name

string

Имя ресурса фильтра группы списков групп активов. Имя ресурса фильтра группы списка активов имеет форму:

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

asset_ group

string

Группа активов, частью которой является этот фильтр группы списков групп активов.

id

int64

Идентификатор ListingGroupFilter.

type

ListingGroupFilterType

Тип узла фильтра группы списков.

vertical

ListingGroupFilterVertical

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

case_ value

ListingGroupFilterDimension

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

parent_ listing_ group_ filter

string

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

path

ListingGroupFilterDimensionPath

Путь к измерениям, определяющим этот фильтр группы списков.

Группа АктивовСигнал

AssetGroupSignal представляет сигнал в группе активов. Наличие сигнала сообщает кампании с максимальной эффективностью, кто с наибольшей вероятностью совершит конверсию. Эффективность с максимальной эффективностью использует этот сигнал для поиска новых людей с похожим или более сильным намерением получить конверсии в поиске, медийной рекламе, видео и т. д.

Поля
resource_ name

string

Имя ресурса сигнала группы активов. Имя ресурса сигнала группы активов имеет вид:

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}

asset_ group

string

Группа активов, к которой принадлежит этот сигнал группы активов.

Полевой signal Союза. Сигнал группы активов. signal может быть только одним из следующих:
audience

AudienceInfo

Сигнал аудитории, который будет использоваться в кампании с максимальной эффективностью.

AssetGroupTopCombinationView

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

Поля
resource_ name

string

Имя ресурса верхнего комбинированного представления группы активов. Имена ресурсов представления Top Combination AssetGroup имеют форму: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

asset_ group_ top_ combinations[]

AssetGroupAssetCombinationData

Лучшие комбинации активов, которые служили вместе.

Набор активов

Набор активов, представляющий коллекцию активов. Используйте AssetSetAsset, чтобы связать актив с набором активов.

Поля
id

int64

Идентификатор набора активов.

resource_ name

string

Имя ресурса набора активов. Имена ресурсов набора активов имеют форму:

customers/{customer_id}/assetSets/{asset_set_id}

АктивСетАссет

AssetSetAsset — это связь между активом и набором активов. Добавление AssetSetAsset связывает актив с набором активов.

Поля
resource_ name

string

Имя ресурса набора активов. Имена ресурсов набора активов имеют форму:

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

asset_ set

string

Набор активов, с которым связан этот актив набора активов.

asset

string

Актив, с которым связан этот актив набора активов.

status

AssetSetAssetStatus

Статус набора активов. Только для чтения.

Аудитория

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

Поля
resource_ name

string

Имя ресурса аудитории. Имена аудиторий имеют вид:

customers/{customer_id}/audiences/{audience_id}

id

int64

Идентификатор аудитории.

name

string

Необходимый. Название аудитории. Оно должно быть уникальным для всех аудиторий. Он должен иметь минимальную длину 1 и максимальную длину 255.

description

string

Описание этой аудитории.

Стратегия торгов

Стратегия ставок.

Поля
resource_ name

string

Название ресурса стратегии назначения ставок. Имена ресурсов стратегии назначения ставок имеют вид:

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

Статус стратегии назначения ставок.

Это поле доступно только для чтения.

type

BiddingStrategyType

Тип стратегии назначения ставок. Создайте стратегию назначения ставок, задав схему назначения ставок.

Это поле доступно только для чтения.

currency_ code

string

Валюта, используемая в стратегии назначения ставок (трехбуквенный код ISO 4217).

Для стратегий назначения ставок для клиентов-менеджеров эта валюта может быть установлена ​​при создании и по умолчанию равна валюте клиента-менеджера. Для обслуживания клиентов это поле задать невозможно; все стратегии обслуживающего клиента неявно используют валюту обслуживающего клиента. Во всех случаях поле effect_currency_code возвращает валюту, используемую стратегией.

id

int64

Идентификатор стратегии назначения ставок.

name

string

Название стратегии назначения ставок. Все стратегии назначения ставок в аккаунте должны иметь четкое название.

Длина этой строки должна быть от 1 до 255 включительно в байтах UTF-8 (обрезанная).

effective_ currency_ code

string

Валюта, используемая в стратегии назначения ставок (трехбуквенный код ISO 4217).

Для стратегий назначения ставок для клиентов-менеджеров это валюта, заданная рекламодателем при создании стратегии. Для обслуживания клиентов это код валюты клиента.

Показатели стратегии назначения ставок указываются в этой валюте.

Это поле доступно только для чтения.

campaign_ count

int64

Количество кампаний, привязанных к этой стратегии назначения ставок.

Это поле доступно только для чтения.

non_ removed_ campaign_ count

int64

Количество неудаленных кампаний, привязанных к этой стратегии назначения ставок.

Это поле доступно только для чтения.

scheme поля Союза. Схема торгов.

Можно установить только один. scheme может быть только одной из следующих:

enhanced_ cpc

EnhancedCpc

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

maximize_ conversion_ value

MaximizeConversionValue

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

maximize_ conversions

MaximizeConversions

Стратегия автоматического назначения ставок, которая поможет получить максимальное количество конверсий в ваших кампаниях, расходуя при этом бюджет.

target_ cpa

TargetCpa

Стратегия назначения ставок, позволяющая получить как можно больше конверсий по заданной вами целевой цене за конверсию.

target_ impression_ share

TargetImpressionShare

Стратегия назначения ставок, которая автоматически оптимизируется в соответствии с выбранным процентом показов.

target_ outrank_ share

TargetOutrankShare

Стратегия назначения ставок, которая устанавливает ставки на основе целевой доли аукционов, на которых рекламодатель должен превзойти конкретного конкурента. Это поле устарело. Создать новую стратегию назначения ставок с этим полем или прикрепить стратегии назначения ставок с этим полем к кампании не удастся. Допускаются мутации в стратегии, в которых эта схема уже заполнена.

target_ roas

TargetRoas

Стратегия назначения ставок, которая поможет вам максимизировать доход, обеспечивая при этом среднюю целевую рентабельность инвестиций в рекламу (ROAS).

target_ spend

TargetSpend

Стратегия назначения ставок, которая устанавливает ставки так, чтобы получить как можно больше кликов в рамках вашего бюджета.

Кампания

Кампания.

Поля
resource_ name

string

Имя ресурса кампании. Имена ресурсов кампании имеют вид:

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

Статус кампании.

При добавлении новой кампании статус по умолчанию становится ВКЛЮЧЕНО.

serving_ status

CampaignServingStatus

Статус показа объявлений в кампании.

bidding_ strategy_ system_ status

BiddingStrategySystemStatus

Системный статус стратегии назначения ставок кампании.

ad_ serving_ optimization_ status

AdServingOptimizationStatus

Статус оптимизации показа объявлений в кампании.

advertising_ channel_ type

AdvertisingChannelType

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

Это поле является обязательным и не должно быть пустым при создании новых кампаний.

Можно задать только при создании кампаний. После создания кампании поле нельзя изменить.

advertising_ channel_ sub_ type

AdvertisingChannelSubType

Необязательное уточнение advertising_channel_type . Должен быть допустимым подтипом типа родительского канала.

Можно задать только при создании кампаний. После создания кампании поле нельзя изменить.

url_ custom_ parameters[]

CustomParameter

Список сопоставлений, используемых для замены тегов специальных параметров в tracking_url_template , final_urls или mobile_final_urls .

real_ time_ bidding_ setting

RealTimeBiddingSetting

Настройки назначения ставок в реальном времени — функция, доступная только для кампаний, ориентированных на сеть Ad Exchange.

network_ settings

NetworkSettings

Настройки сети для кампании.

dynamic_ search_ ads_ setting

DynamicSearchAdsSetting

Настройка управления динамическими поисковыми объявлениями (DSA).

shopping_ setting

ShoppingSetting

Настройка управления торговыми кампаниями.

geo_ target_ type_ setting

GeoTargetTypeSetting

Настройка геотаргетинга объявлений.

effective_ labels[]

string

Названия ресурсов эффективных ярлыков, прикрепленных к этой кампании. Эффективный ярлык – это ярлык, унаследованный или напрямую назначенный этой кампании.

labels[]

string

Названия ресурсов ярлыков, прикрепленных к этой кампании.

bidding_ strategy_ type

BiddingStrategyType

Тип стратегии назначения ставок.

Стратегию назначения ставок можно создать, задав либо схему назначения ставок для создания стандартной стратегии назначения ставок, либо поле bidding_strategy для создания портфельной стратегии назначения ставок.

Это поле доступно только для чтения.

accessible_ bidding_ strategy

string

Имя ресурса AccessibleBiddingStrategy — доступное только для чтения представление неограниченных атрибутов прикрепленной портфельной стратегии назначения ставок, идентифицируемой как «bidding_strategy». Пусто, если в кампании не используется портфельная стратегия. Неограниченные атрибуты стратегии доступны всем клиентам, которым предоставлен общий доступ к стратегии, и считываются из ресурса AccessibleBiddingStrategy. Напротив, ограниченные атрибуты доступны только владельцу стратегии и его менеджерам. Атрибуты с ограниченным доступом можно прочитать только из ресурса BiddingStrategy.

frequency_ caps[]

FrequencyCapEntry

Список, ограничивающий частоту просмотра рекламы этой кампании каждым пользователем.

selective_ optimization

SelectiveOptimization

Настройка выборочной оптимизации для этой кампании, которая включает в себя набор действий-конверсий для оптимизации этой кампании. Эта функция применима только к кампаниям для приложений, которые используют MULTI_CHANNEL в качестве типа AdvertisingChannelType и APP_CAMPAIGN или APP_CAMPAIGN_FOR_ENGAGEMENT в качестве AdvertisingChannelSubType.

optimization_ goal_ setting

OptimizationGoalSetting

Настройка цели оптимизации для этой кампании, которая включает набор типов целей оптимизации.

tracking_ setting

TrackingSetting

Настройки на уровне кампании для отслеживания информации.

engine_ id

string

Идентификатор кампании во внешнем аккаунте системы. Это поле предназначено только для аккаунтов, не принадлежащих Google Реклама, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта Google Реклама вместо этого используйте «campaign.id».

excluded_ parent_ asset_ field_ types[]

AssetFieldType

Типы полей активов, которые следует исключить из этой кампании. Ссылки на активы с этими типами полей не будут унаследованы этой кампанией с верхнего уровня.

create_ time

string

Временная метка создания этой кампании. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». create_time будет устаревшим в версии v1. Вместо этого используйтеcreation_time.

creation_ time

string

Временная метка создания этой кампании. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс».

last_ modified_ time

string

Дата и время последнего изменения этой кампании. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс».

id

int64

Идентификатор кампании.

name

string

Название кампании.

Это поле является обязательным и не должно быть пустым при создании новых кампаний.

Он не должен содержать нулевых символов (кодовая точка 0x0), перевода строки NL (кодовая точка 0xA) или возврата каретки (кодовая точка 0xD).

tracking_ url_ template

string

Шаблон URL-адреса для создания URL-адреса отслеживания.

campaign_ budget

string

Имя ресурса бюджета кампании.

start_ date

string

Дата начала кампании в часовом поясе обслуживающего клиента в формате ГГГГ-ММ-ДД.

end_ date

string

Последний день кампании по обслуживанию часового пояса клиента в формате ГГГГ-ММ-ДД. При создании по умолчанию используется 30 декабря 2037 г., что означает, что кампания будет длиться неопределенное время. Чтобы настроить существующую кампанию на неопределенный срок, установите в этом поле значение 30 декабря 2037 г.

final_ url_ suffix

string

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

url_ expansion_ opt_ out

bool

Представляет собой отказ от расширения URL-адресов до более целевых URL-адресов. Если этот параметр отключен (true), таргетингом будут выбраны только конечные URL-адреса в группе объектов или URL-адреса, указанные в Google Merchant Center или фидах бизнес-данных рекламодателя. Если выбрано значение (false), целью будет весь домен. Это поле можно задать только для кампаний с максимальной эффективностью, где значение по умолчанию — false.

Поле объединения campaign_bidding_strategy . Стратегия назначения ставок для кампании.

Должен быть либо портфель (созданный через сервис Biddingstrategy), либо стандарт, который встроен в кампанию. campaign_bidding_strategy может быть только одним из следующих:

bidding_ strategy

string

Название ресурса стратегии торгов портфелем, используемой кампанией.

manual_ cpa

ManualCpa

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

manual_ cpc

ManualCpc

Стандартная стратегия ставок на CPC. Руководство на основе кликов, где пользователь оплачивает за клик.

manual_ cpm

ManualCpm

Стандартная стратегия ставок на CPM. Ручные впечатления, основанные на торгах, где пользователь платит за тысячу впечатлений.

maximize_ conversions

MaximizeConversions

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

maximize_ conversion_ value

MaximizeConversionValue

Стандартная стратегия преобразования преобразования, которая автоматически устанавливает предложения для максимизации дохода при трати в свой бюджет.

target_ cpa

TargetCpa

Стандартная целевая стратегия ставок CPA, которая автоматически устанавливает ставки, чтобы помочь получить как можно больше конверсий на целевой стоимости за затраты на получение (CPA), которую вы устанавливаете.

target_ impression_ share

TargetImpressionShare

Целевое впечатление от стратегии торгов. Автоматизированная стратегия торгов, которая устанавливает ставки для достижения выбранного процента впечатлений.

target_ roas

TargetRoas

Стандартная целевая стратегия ставок ROAS, которая автоматически максимизирует доход, в среднем определенную целевую доходность по расходам на рекламу (ROAS).

target_ spend

TargetSpend

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

percent_ cpc

PercentCpc

Стандартная процентная стратегия ставок CPC, где ставки - это часть рекламируемой цены на что -то хорошее или услуги.

target_ cpm

TargetCpm

Стратегия торга, которая автоматически оптимизирует стоимость за тысячу впечатлений.

DynamicSearchAdsSetting

Настройка для управления динамическим поисковым объявлением (DSA).

Поля
domain_ name

string

Необходимый. Имя домена в Интернете, которое эта настройка представляет, например, «Google.com» или «www.google.com».

language_ code

string

Необходимый. Языковой код, определяющий язык домена, например, «en».

use_ supplied_ urls_ only

bool

Использует ли кампания только URL -адреса.

GeotargetTypesetting

Представляет коллекцию настроек, связанных с геотаргетинг рекламы.

Поля
positive_ geo_ target_ type

PositiveGeoTargetType

Установка, используемая для положительной геотаргетирования в этой конкретной кампании.

negative_ geo_ target_ type

NegativeGeoTargetType

Настройка, используемая для негативной геотаргетинг в этой конкретной кампании.

Networksettings

Настройки сети для кампании.

Поля
target_ search_ network

bool

Будет ли объявлена ​​реклама на сайтах партнеров в сети поиска Google (требует target_google_search , чтобы также быть true ).

target_ content_ network

bool

Будет ли подано реклама в указанных размещениях в сети дисплея Google. Размещение указывается с использованием критерия размещения.

target_ partner_ search_ network

bool

Будет ли подано реклама в Google Partner Network. Это доступно только для некоторых выбранных учетных записей Google.

Оптимизация GoalSetting

Установка целей оптимизации для этой кампании, которая включает в себя набор типов целей оптимизации.

Поля
optimization_ goal_ types[]

OptimizationGoalType

Список типов целей оптимизации.

Селективоптимизация

Селективная настройка оптимизации для этой кампании, которая включает в себя набор действий по конверсии для оптимизации этой кампании. Эта функция применяется только к кампаниям приложений, которые используют multi_channel в качестве рекламы changanneltype и app_campaign или app_campaign_for_engagement в качестве рекламы.

Поля
conversion_ actions[]

string

Выбранный набор имен ресурсов для действий по преобразованию для оптимизации этой кампании.

Shoppingsetting

Установка для покупок. Определяет вселенную продуктов, которая может быть рекламирована кампанией, и как эта кампания взаимодействует с другими покупками.

Поля
feed_ label

string

Кормовая метка продуктов для включения в кампанию. Может быть установлен только один из FEED_LABEL или Sales_country. Если используется вместо Sales_country, поле FEED_LABEL принимает коды страны в одном и том же формате, например: 'xx'. В противном случае может быть любая строка, используемая для метки подачи в Google Merchant Center.

use_ vehicle_ inventory

bool

Нацеливаться ли инвентаризацию перечисления транспортных средств.

merchant_ id

int64

Удостоверение личности с учетной записью центрального центра. Это поле требуется для создания операций. Это поле неизбежно для покупок.

sales_ country

string

Страна продаж продукции для включения в кампанию.

campaign_ priority

int32

Приоритет кампании. Кампании с численно более высокими приоритетами имеют приоритет над теми с более низкими приоритетами. Это поле требуется для покупок, со значениями от 0 до 2, включительно. Это поле не является обязательным для интеллектуальных покупок, но должно быть равным 3, если установлено.

enable_ local

bool

Должны ли включать местные продукты.

Отслеживание

Настройки на уровне кампании для отслеживания информации.

Поля
tracking_ url

string

URL используется для динамического отслеживания.

Кампания

Связь между кампанией и активом.

Поля
resource_ name

string

Название ресурса актива кампании. Имена ресурсов кампании имеет форму:

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

status

AssetLinkStatus

Статус актива кампании.

campaign

string

Кампания, с которой связан актив.

asset

string

Актив, который связан с кампанией.

Кампания

Кампания - это связь между кампанией и набором активов. Добавление кампании, нанявших набор активов с кампанией.

Поля
resource_ name

string

Название ресурса набора активов кампании. Набор активов имена ресурсов активов есть форма:

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

Кампания, с которой этот набор активов связана.

asset_ set

string

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

status

AssetSetLinkStatus

Статус актива активов кампании. Только для чтения.

Кампания AudienceView

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

Поля
resource_ name

string

Название ресурса представления аудитории кампании. Аудитория кампании. Название ресурсов имеет форму:

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

Кампания Budget

Бюджет кампании.

Поля
resource_ name

string

Название ресурса бюджета кампании. Имена ресурсов бюджета кампании имеют форму:

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

delivery_ method

BudgetDeliveryMethod

Метод доставки, который определяет ставку, на которую тратится бюджет кампании.

По умолчанию стандартные, если не указано в операции создания.

period

BudgetPeriod

Период, на который можно тратить бюджет. По умолчанию ежедневно, если не указано.

amount_ micros

int64

Сумма бюджета в местной валюте для счета. Сумма указана в микросхеме, где один миллион эквивалентен одной валютной единице. Ежемесячные расходы ограничены в 30,4 раза больше этой суммы.

Кампания

Критерий кампании.

Поля
resource_ name

string

Название ресурса критерия кампании. Названия ресурсов критерия кампании имеют форму:

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

display_ name

string

Отображаемое имя критерия.

Это поле игнорируется для мутатов.

type

CriterionType

Тип критерия.

status

CampaignCriterionStatus

Статус критерия.

last_ modified_ time

string

DateTime, когда этот критерий кампании был в последний раз изменен. DateTime находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: Ss.sssssss».

criterion_ id

int64

Идентификатор критерия.

Это поле игнорируется во время мутата.

bid_ modifier

float

Модификатор для заявок, когда критерий соответствует. Модификатор должен быть в диапазоне: 0,1 - 10,0. Большинство целевых типов критериев поддерживают модификаторы. Используйте 0, чтобы отказаться от типа устройства.

negative

bool

Нацеливаться ли ( false ) или исключить ( true ) критерий.

Полевой criterion Союза. Критерий кампании.

Именно один должен быть установлен. criterion может быть только одним из следующих:

keyword

KeywordInfo

Ключевое слово.

location

LocationInfo

Расположение.

device

DeviceInfo

Устройство.

age_ range

AgeRangeInfo

Возрастной диапазон.

gender

GenderInfo

Пол.

user_ list

UserListInfo

Список пользователей.

language

LanguageInfo

Язык.

webpage

WebpageInfo

Веб-страница.

location_ group

LocationGroupInfo

Группа местоположения

CampaignefcecteVelabel

Представляет собой связь между кампанией и эффективным лейблом. Эффективный ярлык - это этикетка, унаследованная или непосредственно назначенная для этой кампании.

Поля
resource_ name

string

Название ресурса. Имена ресурсов AffeefcecteVelabel есть форма: customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}

campaign

string

Кампания, к которой прикреплен эффективная этикетка.

label

string

Эффективный ярлык, назначенный для кампании.

owner_ customer_ id

int64

Идентификатор клиента, который владеет эффективной этикеткой.

Кампания

Представляет отношения между кампанией и ярлыком.

Поля
resource_ name

string

Название ресурса. Имена ресурсов метки кампании имеет форму: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}

campaign

string

Кампания, к которой прикреплен этикетка.

label

string

Этикетка назначена для кампании.

owner_ customer_ id

int64

Идентификатор клиента, который владеет этикеткой.

Cartdatasalesview

Cart Data Sales View.

Поля
resource_ name

string

Название ресурса представления продаж данных CART. Названия ресурсов с продажей корзины имеют форму: customers/{customer_id}/cartDataSalesView

Конверсия

Конверсия.

Поля
resource_ name

string

Название ресурса конверсии. Имена ресурсов конверсии имеют форму:

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

id

int64

Идентификатор конверсии

criterion_ id

int64

Поиск объявлений 360 идентификатор критерия. Значение 0 указывает на то, что критерий не приспособлен.

merchant_ id

int64

Поисковая реклама 360 Идентификатор учетной записи инвентаризации, содержащий продукт, на который был нажат. Поиск объявлений 360 генерирует этот идентификатор, когда вы ссылаетесь на учетную запись инвентаризации в поисковом объявлении 360.

ad_ id

int64

Рекламный идентификатор Значение 0 указывает на то, что объявление не привлечено.

click_ id

string

Уникальная строка для посещения, к которому приписывается преобразование, которая передается на целевую страницу в качестве параметра URL -адреса Click.

visit_ id

int64

Поиск объявлений 360 посещает идентификатор, с которым приписывается конверсия.

advertiser_ conversion_ id

string

Для автономных преобразований это идентификатор, предоставленный рекламодателями. Если рекламодатель не указывает такой идентификатор, поиск объявления 360 генерирует один. Для онлайн -преобразований это равна столбцу ID или столбца Floodlight_order_id в зависимости от инструкций по прожектор рекламодателя.

product_ id

string

Идентификатор продукта нажал на.

product_ channel

ProductChannel

Канал продаж продукта, который был нажат на: онлайн или локальный.

product_ language_ code

string

Язык (ISO-639-1), который был установлен для корма торгового центра, содержащего данные о продукте.

product_ store_ id

string

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

product_ country_ code

string

Страна (ISO-3166-формат) зарегистрирована для подачи инвентаризации, которая содержит нажатый продукт.

attribution_ type

AttributionType

На что приписывается конверсия: посетить или ключевое слово+ad.

conversion_ date_ time

string

TimeStamp of the Convertion Event.

conversion_ last_ modified_ date_ time

string

Неэппаратная метка прошлого раз преобразования была изменена.

conversion_ visit_ date_ time

string

Неэппаратная метка визита, с которой приписывается преобразование.

conversion_ quantity

int64

Количество элементов, записанных преобразованием, как определено параметром QTY URL. Рекламодатель отвечает за динамически заполнение параметра (например, количество предметов, продаваемых при преобразовании), в противном случае он по умолчанию до 1.

conversion_ revenue_ micros

int64

Скорректированный доход в микросхеме для события конверсии. Это всегда будет в валюте сервировочного счета.

floodlight_ original_ revenue

int64

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

floodlight_ order_ id

string

Идентификатор заказа прожектора, предоставленный рекламодателем для преобразования.

status

ConversionStatus

Состояние конверсии, включенное или удаленное ..

asset_ id

int64

ID актива, с которым взаимодействовали во время конверсии.

asset_ field_ type

AssetFieldType

Тип поля актива события конверсии.

Преобразование

Действие конверсии.

Поля
resource_ name

string

Имя ресурса действия преобразования. Имена ресурсов действий преобразования имеют форму:

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_ time

string

Неэппаратная метка создания деятельности прожектора, отформатированная в ISO 8601.

status

ConversionActionStatus

Статус этого действия преобразования для начисления события конверсии.

type

ConversionActionType

Тип этого действия преобразования.

category

ConversionActionCategory

Категория конверсий, представленная для этого действия по конверсии.

value_ settings

ValueSettings

Настройки, связанные со значением событий конверсии, связанных с этим действием конверсии.

attribution_ model_ settings

AttributionModelSettings

Настройки, связанные с моделью атрибуции действия этой преобразования.

floodlight_ settings

FloodlightSettings

Настройки прожектора для типов преобразования прожектора.

id

int64

Идентификатор действия преобразования.

name

string

Имя действия преобразования.

Это поле требуется и не должно быть пустым при создании новых действий конверсии.

primary_ for_ goal

bool

Если бит первичного действия по обращению с преобразованием является ложным, действие по преобразованию не является разбитым для всех кампаний независимо от цели их преобразования клиентов или цели преобразования кампании. Тем не менее, пользовательские цели преобразования не уважают primary_for_goal, поэтому, если кампания имеет пользовательскую цель преобразования, настроенная с помощью действия Primary_for_goal = false преобразования, это действие преобразования по -прежнему остается в курсе. По умолчанию, Promaning_FOR_GOAL будет правдой, если не установлен. В V9 Primary_FOR_GOAL может быть установлен на FALSE только после создания через операцию «обновления», потому что она не объявлена ​​необязательной.

owner_ customer

string

Имя ресурса клиента владельца действий по конверсии или NULL, если это системное действие конверсии.

include_ in_ client_ account_ conversions_ metric

bool

Должно ли это действие преобразования быть включено в метрику "client_account_conversions".

include_ in_ conversions_ metric

bool

Должно ли это действие преобразования быть включено в метрику «преобразования».

click_ through_ lookback_ window_ days

int64

Максимальное количество дней, которые могут пройти между взаимодействием (например, кликом) и событием конверсии.

app_ id

string

Идентификатор приложения для действия преобразования приложения.

Attributionmodelsettings

Настройки, связанные с моделью атрибуции действия этой преобразования.

Поля
attribution_ model

AttributionModel

Тип модели атрибуции этого действия преобразования.

data_ driven_ model_ status

DataDrivenModelStatus

Состояние модели атрибуции, управляемой данными, для действия преобразования.

Заборы прожекторов

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

Поля
activity_ group_ tag

string

Строка, используемая для идентификации группы активности прожектора при отчетности.

activity_ tag

string

Строка, используемая для идентификации активности прожектора при отчетности.

activity_ id

int64

Идентификация деятельности прожектора в DoubleClick Manager кампании (DCM).

ValueSettings

Настройки, связанные со значением событий конверсии, связанных с этим действием конверсии.

Поля
default_ value

double

Значение для использования, когда события преобразования для этого действия преобразования отправляются с недопустимым, запрещенным или отсутствующим значением, или когда это действие преобразования настроено, чтобы всегда использовать значение по умолчанию.

default_ currency_ code

string

Код валюты для использования, когда события преобразования для этого действия преобразования отправляются с неверным или отсутствующим кодом валюты, или когда это действие преобразования настроено, чтобы всегда использовать значение по умолчанию.

always_ use_ default_ value

bool

Управляет, используются ли значение значения по умолчанию и код валюты по умолчанию вместо значения и кода валюты, указанного в событиях преобразования для этого действия преобразования.

ConversionCustomVariable

Пользовательская переменная преобразования. См. «О настраиваемых показателях и размерах прожектора прожектора в новой поисковой рекламе 360» по адресу https://support.google.com/sa360/answer/13567857

Поля
resource_ name

string

Имя ресурса пользовательской переменной конверсии. Преобразование пользовательские имена ресурсов имеют форму:

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

id

int64

Идентификатор конверсии пользовательской переменной.

name

string

Необходимый. Название пользовательской переменной преобразования. Имя должно быть уникальным. Максимальная длина имени составляет 100 символов. Не должно быть никаких дополнительных пространств до и после.

tag

string

Необходимый. Тег пользовательской переменной преобразования. Тег должен быть уникальным и состоять из символа «u», следовавшего непосредственно с числом меньше, чем Ormequal до 100. Например: «U4».

status

ConversionCustomVariableStatus

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

owner_ customer

string

Имя ресурса клиента, которая владеет пользовательской переменной конверсии.

family

ConversionCustomVariableFamily

Семейство из пользовательской переменной конверсии.

cardinality

ConversionCustomVariableCardinality

Кардинальность пользовательской переменной конверсии.

floodlight_ conversion_ custom_ variable_ info

FloodlightConversionCustomVariableInfo

Поля для поисковой рекламы 360 Конверсии прожектора пользовательских переменных.

custom_ column_ ids[]

int64

Идентификаторы пользовательских столбцов, которые используют эту пользовательскую переменную преобразования.

FlorlightConversionCustomVariableInfo

Информация для поиска объявлений 360 Преобразование прожектора пользовательских переменных.

Поля
floodlight_ variable_ type

FloodlightVariableType

Тип переменной прожектора, определенный в поисковой рекламе 360.

floodlight_ variable_ data_ type

FloodlightVariableDataType

Тип данных переменной прожектора, определенный в поисковой рекламе 360.

ConversionTrackingSetting

Коллекция настройки по всему клиенту, связанные с отслеживанием конверсии 360.

Поля
accepted_ customer_ data_ terms

bool

Принял ли клиент условия данных клиента. При использовании отслеживания преобразования перекрестного дохода это значение унаследовано от менеджера. Это поле только для чтения. Для получения дополнительной информации см . Https://support.google.com/adspolicy/answer/7475709 .

conversion_ tracking_ status

ConversionTrackingStatus

Статус отслеживания конверсии. Это указывает, использует ли клиент отслеживание конверсии, и кто является владельцем отслеживания конверсий этого клиента. Если этот клиент использует отслеживание преобразования перекрестного аккунтирования, возвращаемое значение будет отличаться в зависимости от login-customer-id запроса.

enhanced_ conversions_ for_ leads_ enabled

bool

Будет ли клиент выбрано для улучшенных конверсий для потенциальных клиентов. При использовании отслеживания преобразования перекрестного дохода это значение унаследовано от менеджера. Это поле только для чтения.

google_ ads_ conversion_ customer

string

Название ресурса клиента, где конверсии создаются и управляются. Это поле только для чтения.

conversion_ tracking_ id

int64

Идентификатор отслеживания преобразования, используемый для этой учетной записи. Этот идентификатор не указывает, использует ли клиент отслеживание конверсии (это делает Conversion_tracking_status). Это поле только для чтения.

google_ ads_ cross_ account_ conversion_ tracking_ id

int64

Идентификатор отслеживания конверсии менеджера клиента. Это устанавливается, когда клиент выбирается в отслеживание конверсии, и он переопределяет Conversion_tracking_id. Это поле можно управлять только через пользовательский интерфейс Google Ads. Это поле только для чтения.

cross_ account_ conversion_ tracking_ id

int64

Идентификатор отслеживания конверсии менеджера клиента. Это устанавливается, когда клиент выбирается в отслеживание преобразования перекрестного аккаунта, и он переопределяет Conversion_tracking_id.

Customcolumn

Пользовательский столбец. См. Поиск объявлений 360 пользовательский столбец по адресу https://support.google.com/sa360/answer/9633916

Поля
resource_ name

string

Имя ресурса пользовательского столбца. Пользовательские имена ресурсов столбца имеют форму:

customers/{customer_id}/customColumns/{custom_column_id}

id

int64

Идентификатор пользовательского столбца.

name

string

Пользовательский название пользовательского столбца.

description

string

Пользовательский описание пользовательского столбца.

value_ type

CustomColumnValueType

Тип значения результата пользовательского столбца.

references_ attributes

bool

TRUE, когда пользовательский столбец ссылается на один или несколько атрибутов.

references_ metrics

bool

Верно, когда пользовательский столбец ссылается на один или несколько метрик.

queryable

bool

TRUE, когда пользовательский столбец доступен для использования в запросе searchAds360service.search и searchads360service.searchstream.

referenced_ system_ columns[]

string

Список ссылочных системных столбцов этого пользовательского столбца. Например, пользовательский столбец «Сумма впечатлений и щелчков» ссылается на системные столбцы {"metrics.clicks", "metrics.impressions"}.

render_ type

CustomColumnRenderType

Как следует интерпретировать значение результата пользовательского столбца.

Клиент

Клиент.

Поля
resource_ name

string

Название ресурса клиента. Имена ресурсов клиентов имеют форму:

customers/{customer_id}

conversion_ tracking_ setting

ConversionTrackingSetting

Настройка отслеживания конверсии для клиента.

account_ type

AccountType

Тип учетной записи двигателя, например, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Track и т. Д.

double_ click_ campaign_ manager_ setting

DoubleClickCampaignManagerSetting

Настройка менеджера кампании DoubleClick (DCM) для клиента менеджера.

account_ status

AccountStatus

Статус учетной записи, например, включен, приостановлен, удален и т. Д.

last_ modified_ time

string

DateTime, когда этот клиент был в последний раз изменен. DateTime находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: Ss.sssssss».

engine_ id

string

ID учетной записи в учетной записи внешнего двигателя.

status

CustomerStatus

Статус клиента.

creation_ time

string

Неэппредактирование, когда этот клиент был создан. Неэпби времени находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: SS».

id

int64

Идентификатор клиента.

descriptive_ name

string

Необязательное, не одночернее описательное название клиента.

currency_ code

string

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

time_ zone

string

Местный идентификатор часового пояса клиента.

tracking_ url_ template

string

Шаблон URL для построения URL -адреса отслеживания из параметров.

final_ url_ suffix

string

Шаблон URL для добавления параметров к окончательному URL.

auto_ tagging_ enabled

bool

Удалена ли автоматическая загрязнение для клиента.

manager

bool

Является ли клиент менеджером.

CustomerAsset

Связь между клиентом и активом.

Поля
resource_ name

string

Название ресурса актива клиента. Названия ресурсов CustomerAsset имеют форму:

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

asset

string

Необходимый. Актив, который связан с клиентом.

status

AssetLinkStatus

Статус актива клиента.

CustomerAssetSet

CustomerAssetSet - это связь между клиентом и набором активов. Добавление клиентских ссылок набор активов с клиентом.

Поля
resource_ name

string

Имя ресурса набора активов клиента. Набор активов имена ресурсов активов есть форма:

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_ set

string

Набор активов, который связан с клиентом.

customer

string

Клиент, с которым этот набор активов связан.

status

AssetSetLinkStatus

Статус актива актива клиента. Только для чтения.

CustomerClient

Связь между данным клиентом и клиентом клиента. Customerclients существуют только для клиентов менеджера. Все прямые и косвенные клиенты включены, а также самого менеджера.

Поля
resource_ name

string

Имя ресурса клиента. Имена ресурсов CustomerClient имеют форму: customers/{customer_id}/customerClients/{client_customer_id}

applied_ labels[]

string

Названия ресурсов меток, принадлежащих запрашивающему клиенту, которые применяются к клиенту. Имена ресурсов метки имеют форму:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

Статус клиента клиента. Только чтение.

client_ customer

string

Имя ресурса клиента-клиента, которое связано с данным клиентом. Только чтение.

hidden

bool

Указывает, является ли это скрытой учетной записью.

Только чтение.

level

int64

Расстояние между данным клиентом и клиентом. Для самооценки значение уровня будет 0. Только для чтения.

time_ zone

string

Обычное представление строки данных общего локали (CLDR) часового пояса клиента, например, America/Los_angeles. Только чтение.

test_ account

bool

Определяет, является ли клиент тестовой учетной записью. Только чтение.

manager

bool

Определяет, является ли клиент менеджером. Только чтение.

descriptive_ name

string

Описательное имя для клиента. Только чтение.

currency_ code

string

Валютный код (например, «USD», «EUR») для клиента. Только чтение.

id

int64

Идентификатор клиента клиента. Только чтение.

DoubleClickCampaignmanagersetting

Настройка менеджера кампании DoubleClick (DCM) для клиента менеджера.

Поля
advertiser_ id

int64

Удостоверение личности рекламодателя менеджера кампании, связанного с этим клиентом.

network_ id

int64

Удостоверение личности сети менеджера кампании, связанная с этим клиентом.

time_ zone

string

Часовой пояс сети менеджера кампании, связанная с этим клиентом в формате базы данных IANA TOMES, таких как America/New_york.

DynamicSearchAdsSearchVermView

Динамический поисковый поисковый просмотр.

Поля
resource_ name

string

Имя ресурса просмотра поиска динамического поиска. Динамический поиск объявлений об поиске термин «Просмотр имен ресурсов» есть форма:

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landing_ page

string

Динамически выбранная URL -адрес -страницы впечатления.

Это поле только для чтения.

Genderview

Гендерный вид. Ресурс Gender_view отражает эффективное состояние обслуживания, а не то, что были добавлены критерии. Группа AD без гендерных критериев по умолчанию показывает все полов, поэтому все половины появляются в Gender_view со статистикой.

Поля
resource_ name

string

Имя ресурса гендерного представления. Гендерное представление имена ресурсов имеют форму:

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeotargetConstant

Гео -целевая постоянная.

Поля
resource_ name

string

Название ресурса константы GEO Target. Имена ресурсов GEO Target имеют форму:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Гео целевой постоянный статус.

id

int64

Идентификатор константы Geo Target.

name

string

Geo Target Constant English Name.

country_ code

string

ISO-3166-1 Код страны Альфа-2, который связан с целью.

target_ type

string

Гео целевой постоянный тип цели.

canonical_ name

string

Полностью квалифицированное английское название, состоящее из имени цели и имени его родителя и страны.

parent_ geo_ target

string

Имя ресурса родительской целевой константы GEO. Имена ресурсов GEO Target имеют форму:

geoTargetConstants/{parent_geo_target_constant_id}

Ключевое слово

Представление ключевого слова.

Поля
resource_ name

string

Имя ресурса представления ключевого слова. Ключевое слово имена ресурсов имеют форму:

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Этикетка

Ярлык.

Поля
resource_ name

string

Название ресурса. Имена ресурсов метки имеют форму: customers/{customer_id}/labels/{label_id}

status

LabelStatus

Статус ярлыка. Только чтение.

text_ label

TextLabel

Тип метки, отображающего текст на цветном фоне.

id

int64

Удостоверение личности этикетки. Только чтение.

name

string

Имя этикетки.

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

Длина этой строки должна составлять от 1 до 80, включительно.

LanguageConstant

Язык.

Поля
resource_ name

string

Название ресурса постоянной языка. Имена ресурсов с постоянными языками имеют форму:

languageConstants/{criterion_id}

id

int64

Идентификатор языковой постоянной.

code

string

Языковой код, например, "en_us", "en_au", "es", "Fr" и т. Д.

name

string

Полное имя языка на английском, например, «английский (США)», «Испанский» и т. Д.

targetable

bool

Является ли язык нацеленным.

ListingGroupFilterDimension

Листинг измерений для группового фильтра группы Acset Group.

Поля
Объединенное dimension . Размер одного из приведенных ниже типов всегда присутствует. dimension может быть только одним из следующих:
product_ bidding_ category

ProductBiddingCategory

Категория ставок предложения о продукте.

product_ brand

ProductBrand

Бренд предложения продукта.

product_ channel

ProductChannel

Местность предложения продукта.

product_ condition

ProductCondition

Состояние предложения продукта.

product_ custom_ attribute

ProductCustomAttribute

Пользовательский атрибут предложения продукта.

product_ item_ id

ProductItemId

Идентификатор предложения предложения продукта.

product_ type

ProductType

Тип предложения продукта.

ProductBiddingCategory

Один элемент категории торгов на определенном уровне. Категории высшего уровня находятся на уровне 1, их дети на уровне 2 и так далее. В настоящее время мы поддерживаем до 5 уровней. Пользователь должен указать тип измерения, который указывает уровень категории. Все случаи одного и того же подразделения должны иметь одинаковый тип измерения (уровень категории).

Поля
level

ListingGroupFilterBiddingCategoryLevel

Указывает уровень категории в таксономии.

id

int64

Удостоверение личности категории ставок продукта.

Этот идентификатор эквивалентен идентификатору Google_product_category, как описано в этой статье: https://support.google.com/merchants/answer/6324436

Продукт

Бренд продукта.

Поля
value

string

Строковое значение бренда продукта.

ProductChannel

Местность предложения продукта.

Поля
channel

ListingGroupFilterProductChannel

Ценность местности.

ProductCondition

Состояние предложения продукта.

Поля
condition

ListingGroupFilterProductCondition

Значение условия.

ProductCustomattribute

Пользовательский атрибут предложения продукта.

Поля
index

ListingGroupFilterCustomAttributeIndex

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

value

string

Строковое значение продукта пользовательское атрибут.

ProductiTemid

Идентификатор предложения предложения продукта.

Поля
value

string

Значение идентификатора.

ProductType

Тип предложения продукта.

Поля
level

ListingGroupFilterProductTypeLevel

Уровень типа.

value

string

Значение типа.

ListingGroupFilterDimensionPath

Путь, определяющий измерения, определяющие фильтр группы листинга.

Поля
dimensions[]

ListingGroupFilterDimension

Полный путь измерений через иерархию фильтра группы листинга (исключая корневой узел) к этому фильтру группы листинга.

LocationView

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

Поля
resource_ name

string

Название ресурса представления местоположения. Расположение имена ресурсов имеют форму:

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

Категория ставок продукта.

Поля
resource_ name

string

Название ресурса категории ставок продукта. Имена ресурсов категории категории продукта имеют форму:

productBiddingCategoryConstants/{country_code}~{level}~{id}

level

ProductBiddingCategoryLevel

Уровень категории ставок продукта.

status

ProductBiddingCategoryStatus

Статус категории торгов.

id

int64

Удостоверение личности категории ставок продукта.

Этот идентификатор эквивалентен идентификатору Google_product_category, как описано в этой статье: https://support.google.com/merchants/answer/6324436 .

country_ code

string

Двухбуктный код страны в верхнем случае категории ставок продукта.

product_ bidding_ category_ constant_ parent

string

Название ресурса категории ставок родительского продукта.

language_ code

string

Языковой код категории ставок продукта.

localized_ name

string

Значение отображения категории ставок на продукт локализован в соответствии с Language_Code.

ProductGroupView

Просмотр группы продуктов.

Поля
resource_ name

string

Название ресурса представления группы продуктов. Группа продукта Просмотр Имен ресурсов имеет форму:

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

Поле или ресурс (артефакт), используемый SearchAds360service.

Поля
resource_ name

string

Название ресурса артефакта. Имена ресурсов артефакта имеют форму:

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

Категория артефакта.

selectable_ with[]

string

Названия всех ресурсов, сегментов и метрик, которые выбираются с описанным артефактом.

attribute_ resources[]

string

Названия всех ресурсов, которые выбираются с описанным артефактом. Поля из этих ресурсов не сегментируют метрики при включении в поисковые запросы.

Это поле подходит только для артефактов, категория которых является ресурсом.

metrics[]

string

В этом поле перечислены имена всех метрик, которые выбираются с описанным артефактом, когда он используется в предложении FAR. Он настроен только для артефактов, категория которых является ресурсом.

segments[]

string

В этом поле перечислены имена всех артефактов, будь то сегмент или другой ресурс, этот сегмент метрики при включении в поисковые запросы и когда описанный артефакт используется в пункте From. Он настроен только для артефактов, категория которых является ресурсом.

enum_ values[]

string

Значения артефакта могут предположить, если это поле enum типа.

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

data_ type

SearchAds360FieldDataType

Это поле определяет операторов, которые можно использовать с артефактом, где есть положения.

name

string

Название артефакта.

selectable

bool

Можно ли использовать артефакт в предложении Select в поисковых запросах.

filterable

bool

Можно ли использовать артефакт в предложении, где в поисковых запросах.

sortable

bool

Можно ли использовать артефакт в пункте «Заказ в поисках».

type_ url

string

URL -адрес прото, описывающий тип данных артефакта.

is_ repeated

bool

Повторяется ли полевой артефакт.

ShoppingPerformanceView

Просмотр производительности покупок. Обеспечивает статистику кампании покупок, агрегированную на нескольких уровнях измерения продукта. Значения размеров продукта от торгового центра, таких как бренд, категория, пользовательские атрибуты, состояние продукта и тип продукта, будут отражать состояние каждого измерения на дату и времени, когда было записано соответствующее событие.

Поля
resource_ name

string

Название ресурса представления о производительности покупок. Производительность покупок имена ресурсов есть форма: customers/{customer_id}/shoppingPerformanceView

Пользовательский список

Список пользователей. Это список пользователей, на которые клиент может нацелиться.

Поля
resource_ name

string

Имя ресурса списка пользователей. Имена ресурсов в списке пользователей имеют форму:

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Тип этого списка.

Это поле только для чтения.

id

int64

Идентификатор списка пользователей.

name

string

Имя этого списка пользователей. В зависимости от его access_reess, имя списка пользователей не может быть уникальным (например, если access_reason = shared)

UserLocationView

Представление о местоположении пользователя.

Просмотр местоположения пользователя включает в себя все метрики, агрегированные на уровне страны, один ряд на страну. Он сообщает метрики в фактическом физическом месте пользователя по целевым или не целенаправленному месту. Если используются другие поля сегмента, вы можете получить более одного ряда на страну.

Поля
resource_ name

string

Имя ресурса представления местоположения пользователя. UserLocation View имена ресурсов имеют форму:

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

country_ criterion_ id

int64

Критерий идентификатор для страны.

targeting_ location

bool

Указывает, было ли местоположение целевым или нет.

Посещать

Визит.

Поля
resource_ name

string

Название ресурса визита. Посетите имена ресурсов имеют форму:

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

id

int64

Идентификатор визита.

criterion_ id

int64

Поиск объявлений 360 идентификатор ключевого слова. Значение 0 указывает на то, что ключевое слово не привлечено.

merchant_ id

int64

Поисковая реклама 360 Идентификатор учетной записи инвентаризации, содержащий продукт, на который был нажат. Поиск объявлений 360 генерирует этот идентификатор, когда вы ссылаетесь на учетную запись инвентаризации в поисковом объявлении 360.

ad_ id

int64

Рекламный идентификатор Значение 0 указывает на то, что объявление не привлечено.

click_ id

string

Уникальная строка для каждого посещения, которое передается на целевую страницу в качестве параметра URL -адреса Click.

visit_ date_ time

string

TimeStamp of the Visit Event. Неэпби времени находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: SS».

product_ id

string

Идентификатор продукта нажал на.

product_ channel

ProductChannel

Канал продаж продукта, который был нажат на: онлайн или локальный.

product_ language_ code

string

Язык (ISO-639-1), который был установлен для корма торгового центра, содержащего данные о продукте.

product_ store_ id

string

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

product_ country_ code

string

Страна (формат ISO-3166), зарегистрированная для подачи инвентаризации, которая содержит нажатый продукт.

asset_ id

int64

Удостоверение личности актива, с которым взаимодействовали во время визита.

asset_ field_ type

AssetFieldType

Активы поля типа посещения.

WebPageView

Представление веб -страницы.

Поля
resource_ name

string

Имя ресурса представления веб -страницы. Имена ресурсов на веб -странице есть форма:

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}