Индекс
-
AccessibleBiddingStrategy
(сообщение) -
AccessibleBiddingStrategy.MaximizeConversionValue
(сообщение) -
AccessibleBiddingStrategy.MaximizeConversions
(сообщение) -
AccessibleBiddingStrategy.TargetCpa
(сообщение) -
AccessibleBiddingStrategy.TargetImpressionShare
(сообщение) -
AccessibleBiddingStrategy.TargetRoas
(сообщение) -
AccessibleBiddingStrategy.TargetSpend
(сообщение) -
Ad
(сообщение) -
AdGroup
(сообщение) -
AdGroupAd
(сообщение) -
AdGroupAdLabel
(сообщение) -
AdGroupAsset
(сообщение) -
AdGroupAssetSet
(сообщение) -
AdGroupAudienceView
(сообщение) -
AdGroupBidModifier
(сообщение) -
AdGroupCriterion
(сообщение) -
AdGroupCriterion.PositionEstimates
(сообщение) -
AdGroupCriterion.QualityInfo
(сообщение) -
AdGroupCriterionLabel
(сообщение) -
AdGroupLabel
(сообщение) -
AgeRangeView
(сообщение) -
Asset
(сообщение) -
AssetGroup
(сообщение) -
AssetGroupAsset
(сообщение) -
AssetGroupAssetCombinationData
(сообщение) -
AssetGroupListingGroupFilter
(сообщение) -
AssetGroupSignal
(сообщение) -
AssetGroupTopCombinationView
(сообщение) -
AssetSet
(сообщение) -
AssetSetAsset
(сообщение) -
Audience
(сообщение) -
BiddingStrategy
(сообщение) -
Campaign
(сообщение) -
Campaign.DynamicSearchAdsSetting
(сообщение) -
Campaign.GeoTargetTypeSetting
(сообщение) -
Campaign.NetworkSettings
(сообщение) -
Campaign.OptimizationGoalSetting
(сообщение) -
Campaign.SelectiveOptimization
(сообщение) -
Campaign.ShoppingSetting
(сообщение) -
Campaign.TrackingSetting
(сообщение) -
CampaignAsset
(сообщение) -
CampaignAssetSet
(сообщение) -
CampaignAudienceView
(сообщение) -
CampaignBudget
(сообщение) -
CampaignCriterion
(сообщение) -
CampaignLabel
(сообщение) -
CartDataSalesView
(сообщение) -
Conversion
(сообщение) -
ConversionAction
(сообщение) -
ConversionAction.AttributionModelSettings
(сообщение) -
ConversionAction.FloodlightSettings
(сообщение) -
ConversionAction.ValueSettings
(сообщение) -
ConversionCustomVariable
(сообщение) -
ConversionCustomVariable.FloodlightConversionCustomVariableInfo
(сообщение) -
ConversionTrackingSetting
(сообщение) -
CustomColumn
(сообщение) -
Customer
(сообщение) -
CustomerAsset
(сообщение) -
CustomerAssetSet
(сообщение) -
CustomerClient
(сообщение) -
CustomerManagerLink
(сообщение) -
DoubleClickCampaignManagerSetting
(сообщение) -
DynamicSearchAdsSearchTermView
(сообщение) -
GenderView
(сообщение) -
GeoTargetConstant
(сообщение) -
KeywordView
(сообщение) -
Label
(сообщение) -
LanguageConstant
(сообщение) -
ListingGroupFilterDimension
(сообщение) -
ListingGroupFilterDimension.ProductBiddingCategory
(сообщение) -
ListingGroupFilterDimension.ProductBrand
(сообщение) -
ListingGroupFilterDimension.ProductChannel
(сообщение) -
ListingGroupFilterDimension.ProductCondition
(сообщение) -
ListingGroupFilterDimension.ProductCustomAttribute
(сообщение) -
ListingGroupFilterDimension.ProductItemId
(сообщение) -
ListingGroupFilterDimension.ProductType
(сообщение) -
ListingGroupFilterDimensionPath
(сообщение) -
LocationView
(сообщение) -
ProductBiddingCategoryConstant
(сообщение) -
ProductGroupView
(сообщение) -
SearchAds360Field
(сообщение) -
ShoppingPerformanceView
(сообщение) -
UserList
(сообщение) -
Visit
(сообщение) -
WebpageView
(сообщение)
Доступная стратегия ставок
Представляет представление BiddingStrategies, принадлежащее клиенту и доступное ему.
В отличие от BiddingStrategy, этот ресурс включает стратегии, принадлежащие менеджерам клиента и доступные этому клиенту, в дополнение к стратегиям, принадлежащим этому клиенту. Этот ресурс не предоставляет показателей и предоставляет только ограниченное подмножество атрибутов BiddingStrategy.
Поля | |
---|---|
resource_name | Название ресурса доступной стратегии назначения ставок. Имена ресурсов AccessibleBiddingStrategy имеют вид: |
id | Идентификатор стратегии назначения ставок. |
name | Название стратегии назначения ставок. |
type | Тип стратегии назначения ставок. |
owner_customer_id | Идентификатор клиента, которому принадлежит стратегия назначения ставок. |
owner_descriptive_name | descriptive_name клиента, которому принадлежит стратегия назначения ставок. |
Можно установить только один. | |
maximize_conversion_value | Стратегия автоматического назначения ставок, которая поможет получить максимальную ценность конверсий для ваших кампаний, расходуя при этом бюджет. |
maximize_conversions | Стратегия автоматического назначения ставок, которая поможет получить максимальное количество конверсий в ваших кампаниях, расходуя при этом бюджет. |
target_cpa | Стратегия назначения ставок, позволяющая получить как можно больше конверсий по заданной вами целевой цене за конверсию. |
target_impression_share | Стратегия назначения ставок, которая автоматически оптимизируется в соответствии с выбранным процентом показов. |
target_roas | Стратегия назначения ставок, которая поможет вам максимизировать доход, обеспечивая при этом среднюю целевую рентабельность инвестиций в рекламу (ROAS). |
target_spend | Стратегия назначения ставок, которая устанавливает ставки так, чтобы получить как можно больше кликов в рамках вашего бюджета. |
Максимизироватьконверсионвалуе
Стратегия автоматического назначения ставок, которая поможет получить максимальную ценность конверсий для ваших кампаний, расходуя при этом бюджет.
Поля | |
---|---|
target_roas | Опция целевой рентабельности инвестиций в рекламу (ROAS). Если этот параметр установлен, стратегия назначения ставок будет максимизировать доход при усреднении целевой рентабельности инвестиций в рекламу. Если целевая рентабельность инвестиций в рекламу высока, стратегия назначения ставок может оказаться не в состоянии израсходовать весь бюджет. Если целевая рентабельность инвестиций в рекламу не задана, стратегия назначения ставок будет направлена на достижение максимально возможной рентабельности инвестиций в рекламу в рамках бюджета. |
Максимизация конверсий
Стратегия автоматического назначения ставок, которая поможет получить максимальное количество конверсий в ваших кампаниях, расходуя при этом бюджет.
Поля | |
---|---|
target_cpa | Опция целевой цены за приобретение (CPA). Это средняя сумма, которую вы готовы потратить на одно приобретение. |
target_cpa_micros | Опция целевой цены за приобретение (CPA). Это средняя сумма, которую вы готовы потратить на одно приобретение. |
Целевая цена за конверсию
Стратегия автоматического назначения ставок, позволяющая получить как можно больше конверсий по заданной вами целевой цене за конверсию.
Поля | |
---|---|
target_cpa_micros | Целевая средняя цена за конверсию. Эта цель должна быть больше или равна минимальной единице оплаты в зависимости от валюты аккаунта. |
Целевая рентабельность инвестиций в рекламу
Стратегия автоматического назначения ставок, которая поможет вам максимизировать доход, обеспечивая при этом среднюю целевую рентабельность инвестиций в рекламу (ROAS).
Поля | |
---|---|
target_roas | Выбранный доход (на основе данных о конверсиях) на единицу расходов. |
Целевые расходы
Автоматизированная стратегия назначения ставок, которая устанавливает ставки так, чтобы получить как можно больше кликов в рамках вашего бюджета.
Поля | |
---|---|
target_spend_micros | Целевой показатель расходов, при достижении которого можно получить максимальное количество кликов. Участник торгов TargetSpend попытается потратить меньшую из этих величин или суммы расходов при естественном регулировании. Если не указано, бюджет используется в качестве целевого показателя расходов. Это поле устарело и больше не должно использоваться. Подробности см. на странице https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html . |
cpc_bid_ceiling_micros | Максимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. |
Объявление
Реклама.
Поля | |
---|---|
resource_name | Имя ресурса объявления. Имена рекламных ресурсов имеют вид: |
final_urls[] | Список возможных конечных URL-адресов после всех междоменных перенаправлений объявления. |
type | Тип объявления. |
id | Идентификатор объявления. |
display_url | URL-адрес, который отображается в описании объявления для некоторых форматов объявлений. |
name | Название объявления. Это используется только для идентификации объявления. Он не обязательно должен быть уникальным и не влияет на отображаемое объявление. Поле имени в настоящее время поддерживается только для DisplayUploadAd, ImageAd, ShoppingComparisonListingAd и VideoAd. |
Поле объединения ad_data . Подробности, относящиеся к типу объявления. Должно быть установлено ровно одно значение. ad_data может быть только одним из следующих: | |
text_ad | Подробности, относящиеся к текстовому объявлению. |
expanded_text_ad | Подробная информация о развернутом текстовом объявлении. |
responsive_search_ad | Подробная информация об адаптивном поисковом объявлении. |
product_ad | Подробности, относящиеся к рекламе продукта. |
expanded_dynamic_search_ad | Подробная информация о расширенном динамическом поисковом объявлении. |
Группа объявлений
Группа объявлений.
Поля | |
---|---|
resource_name | Имя ресурса группы объявлений. Названия ресурсов группы объявлений имеют вид: |
status | Статус группы объявлений. |
type | Тип группы объявлений. |
ad_rotation_mode | Режим ротации объявлений в группе объявлений. |
creation_time | Временная метка создания этой группы объявлений. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». |
targeting_setting | Настройка таргетинга на связанные функции. |
labels[] | Имена ресурсов ярлыков, прикрепленных к этой группе объявлений. |
engine_id | Идентификатор группы объявлений во внешнем аккаунте системы. Это поле предназначено только для аккаунтов, не принадлежащих Google Реклама, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта Google Реклама вместо этого используйте «ad_group.id». |
start_date | Дата, когда в этой группе объявлений начнется показ объявлений. По умолчанию группа объявлений начинается сейчас или в дату начала группы объявлений, в зависимости от того, что наступит позже. Если это поле задано, то группа объявлений начинается в начале указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и шлюза Facebook. Формат: ГГГГ-ММ-ДД. Пример: 14.03.2019. |
end_date | Дата прекращения показа объявлений в группе объявлений. По умолчанию группа объявлений заканчивается в дату окончания группы объявлений. Если это поле задано, группа объявлений заканчивается в конце указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и шлюза Facebook. Формат: ГГГГ-ММ-ДД. Пример: 14.03.2019. |
language_code | Язык объявлений и ключевых слов в группе объявлений. Это поле доступно только для учетных записей Microsoft Advertising. Более подробная информация: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage . |
last_modified_time | Дата и время последнего изменения этой группы объявлений. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
id | Идентификатор группы объявлений. |
name | Название группы объявлений. Это поле является обязательным и не должно быть пустым при создании новых групп объявлений. Он должен содержать менее 255 символов полной ширины UTF-8. Он не должен содержать нулевых символов (кодовая точка 0x0), перевода строки NL (кодовая точка 0xA) или возврата каретки (кодовая точка 0xD). |
cpc_bid_micros | Максимальная ставка CPC (цена за клик). |
engine_status | Статус системы для группы объявлений. |
Группа объявленийОбъявление
Объявление группы объявлений.
Поля | |
---|---|
resource_name | Имя ресурса объявления. Названия рекламных ресурсов группы объявлений имеют следующий вид: |
status | Статус объявления. |
ad | Реклама. |
creation_time | Временная метка создания объявления ad_group_ad. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
labels[] | Имена ресурсов ярлыков, прикрепленных к этому объявлению группы объявлений. |
engine_id | Идентификатор объявления во внешнем аккаунте системы. Это поле предназначено только для учетной записи Search Ads 360, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта, не относящегося к Search Ads 360, вместо этого используйте «ad_group_ad.ad.id». |
engine_status | Дополнительный статус объявления во внешнем аккаунте движка. Возможные статусы (в зависимости от типа внешней учетной записи) включают активный, соответствующий требованиям, ожидающий проверки и т. д. |
last_modified_time | Дата и время последнего изменения этого объявления группы объявлений. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
Группа объявленийAdLabel
Связь между объявлением группы объявлений и ярлыком.
Поля | |
---|---|
resource_name | Имя ресурса ярлыка объявления группы объявлений. Имена ресурсов меток объявлений группы объявлений имеют форму: |
ad_group_ad | Объявление группы объявлений, к которому прикреплен ярлык. |
label | Ярлык, присвоенный объявлению группы объявлений. |
owner_customer_id | Идентификатор клиента, которому принадлежит этикетка. |
Актив группы объявлений
Связь между группой объявлений и объектом.
Поля | |
---|---|
resource_name | Имя ресурса объекта группы объявлений. Имена ресурсов AdGroupAsset имеют вид: |
ad_group | Необходимый. Группа объявлений, с которой связан объект. |
asset | Необходимый. Объект, связанный с группой объявлений. |
status | Статус объекта группы объявлений. |
AdGroupAssetSet
AdGroupAssetSet – это связь между группой объявлений и набором объектов. Создание AdGroupAssetSet связывает набор объектов с группой объявлений.
Поля | |
---|---|
resource_name | Имя ресурса набора объектов группы объявлений. Названия ресурсов набора объектов группы объявлений имеют следующий вид: |
ad_group | Группа объявлений, с которой связан этот набор объектов. |
asset_set | Набор объектов, связанный с группой объявлений. |
status | Статус набора объектов группы объявлений. Только для чтения. |
Группа объявленийАудиторияView
Просмотр аудитории группы объявлений. Включает данные об эффективности по интересам и спискам ремаркетинга для рекламы в контекстно-медийной сети и сети YouTube, а также списки ремаркетинга для поисковых объявлений (RLSA), агрегированные на уровне аудитории.
Поля | |
---|---|
resource_name | Имя ресурса представления аудитории группы объявлений. Названия ресурсов представления аудитории группы объявлений имеют следующий вид: |
Модификатор ставки группы объявлений
Представляет модификатор ставки на уровне группы объявлений.
Поля | |
---|---|
resource_name | Имя ресурса модификатора ставок на уровне группы объявлений. Названия ресурсов модификаторов ставок группы объявлений имеют следующий вид: |
bid_modifier | Модификатор ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 – 10,0. Диапазон составляет 1,0–6,0 для PreferredContent. Используйте 0, чтобы отказаться от типа устройства. |
Требуется при операциях создания, начиная с V5. | |
device | Критерий устройства. |
Критерий группы объявлений
Критерий группы объявлений. Отчет ad_group_criterion возвращает только те критерии, которые были явно добавлены в группу объявлений.
Поля | |
---|---|
resource_name | Имя ресурса критерия группы объявлений. Названия ресурсов критерия группы объявлений имеют следующий вид: |
creation_time | Временная метка создания критерия группы объявлений. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». |
status | Статус критерия. Это статус объекта критерия группы объявлений, установленный клиентом. Примечание. Отчеты пользовательского интерфейса могут включать дополнительную информацию, влияющую на возможность применения критерия. В некоторых случаях критерий, УДАЛЕННЫЙ в API, все равно может отображаться в пользовательском интерфейсе как включенный. Например, кампании по умолчанию показываются пользователям всех возрастных диапазонов, если они не исключены. В пользовательском интерфейсе каждая возрастная группа будет отображаться как «включенная», поскольку они имеют право видеть рекламу; но в AdGroupCriterion.status будет указано «удалено», поскольку положительный критерий не был добавлен. |
quality_info | Информация о качестве критерия. |
type | Тип критерия. |
labels[] | Имена ресурсов ярлыков, прикрепленных к этому критерию группы объявлений. |
position_estimates | Оценки критериальных ставок на различных позициях. |
final_urls[] | Список возможных конечных URL-адресов после всех междоменных перенаправлений объявления. |
engine_id | Идентификатор критерия группы объявлений во внешнем аккаунте системы. Это поле предназначено только для аккаунтов, не принадлежащих Google Реклама, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта Google Реклама вместо этого используйте «ad_group_criterion.criterion_id». |
last_modified_time | Дата и время последнего изменения этого критерия группы объявлений. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
criterion_id | Идентификатор критерия. |
ad_group | Группа объявлений, к которой относится критерий. |
negative | Нацеливать ( Это поле неизменяемо. Чтобы переключить критерий с положительного на отрицательный, удалите его, а затем добавьте заново. |
bid_modifier | Модификатор ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 – 10,0. Большинство типов таргетируемых критериев поддерживают модификаторы. |
cpc_bid_micros | Ставка CPC (цена за клик). |
effective_cpc_bid_micros | Эффективная ставка CPC (цена за клик). |
engine_status | Статус системы для критерия группы объявлений. |
final_url_suffix | Шаблон URL-адреса для добавления параметров к конечному URL-адресу. |
tracking_url_template | Шаблон URL-адреса для создания URL-адреса отслеживания. |
Должен быть установлен именно один. | |
keyword | Ключевое слово. |
listing_group | Группа листингов. |
age_range | Возрастной диапазон. |
gender | Пол. |
user_list | Список пользователей. |
webpage | Веб-страница |
location | Расположение. |
ПозицияОценки
Оценки критериальных ставок на различных позициях.
Поля | |
---|---|
top_of_page_cpc_micros | Оценка ставки CPC, необходимой для показа объявления вверху первой страницы результатов поиска. |
Информация о качестве
Контейнер для информации о качестве критериев группы объявлений.
Поля | |
---|---|
quality_score | Показатель качества. Это поле может быть не заполнено, если у Google недостаточно информации для определения значения. |
AdGroupCriterionLabel
Связь между критерием группы объявлений и ярлыком.
Поля | |
---|---|
resource_name | Имя ресурса метки критерия группы объявлений. Имена ресурсов меток критерия группы объявлений имеют форму: |
ad_group_criterion | Критерий группы объявлений, к которому прикреплен ярлык. |
label | Ярлык, присвоенный критерию группы объявлений. |
owner_customer_id | Идентификатор клиента, которому принадлежит этикетка. |
Ярлык группы объявлений
Связь между группой объявлений и ярлыком.
Поля | |
---|---|
resource_name | Имя ресурса ярлыка группы объявлений. Названия ресурсов ярлыков групп объявлений имеют форму: |
ad_group | Группа объявлений, к которой прикреплен ярлык. |
label | Ярлык, присвоенный группе объявлений. |
owner_customer_id | Идентификатор клиента, которому принадлежит этикетка. |
Возрастной диапазонПросмотр
Представление о возрастном диапазоне.
Поля | |
---|---|
resource_name | Имя ресурса представления возрастного диапазона. Имена ресурсов представления возрастного диапазона имеют вид: |
Объект
Актив – это часть объявления, которую можно использовать в нескольких объявлениях. Это может быть изображение (ImageAsset), видео (YoutubeVideoAsset) и т. д. Ресурсы неизменяемы и не могут быть удалены. Чтобы остановить показ объекта, удалите его из организации, которая его использует.
Поля | |
---|---|
resource_name | Имя ресурса актива. Имена ресурсов активов имеют форму: |
type | Тип актива. |
final_urls[] | Список возможных конечных URL-адресов после всех междоменных перенаправлений. |
status | Статус актива. |
creation_time | Временная метка создания этого актива. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». |
last_modified_time | Дата и время последнего изменения этого актива. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
id | Идентификатор актива. |
name | Необязательное имя актива. |
tracking_url_template | Шаблон URL-адреса для создания URL-адреса отслеживания. |
engine_status | Статус механизма для актива. |
Поле объединения asset_data . Конкретный тип актива. asset_data может быть только одним из следующих: | |
youtube_video_asset | Видеоресурс YouTube. |
image_asset | Имиджевый актив. |
text_asset | Текстовый ресурс. |
callout_asset | Единый объект выноски. |
sitelink_asset | Единый ресурс дополнительной ссылки. |
page_feed_asset | Единый ресурс фида страниц. |
mobile_app_asset | Актив мобильного приложения. |
call_asset | Единый актив вызова. |
call_to_action_asset | Призыв к действию. |
location_asset | Единый объект местоположения. |
Группа активов
Группа активов. AssetGroupAsset используется для привязки актива к группе активов. AssetGroupSignal используется для привязки сигнала к группе активов.
Поля | |
---|---|
resource_name | Имя ресурса группы активов. Имена ресурсов группы активов имеют форму: |
id | Идентификатор группы активов. |
campaign | Кампания, с которой связана эта группа объектов. Актив, связанный с группой активов. |
name | Необходимый. Название группы активов. Необходимый. Он должен иметь минимальную длину 1 и максимальную длину 128. Он должен быть уникальным в рамках кампании. |
final_urls[] | Список конечных URL-адресов после всех междоменных перенаправлений. В режиме максимальной эффективности по умолчанию URL-адреса можно расширять, если этот параметр не отключен. |
final_mobile_urls[] | Список конечных мобильных URL-адресов после всех междоменных перенаправлений. В режиме максимальной эффективности по умолчанию URL-адреса можно расширять, если этот параметр не отключен. |
status | Статус группы активов. |
path1 | Первая часть текста, которая может быть добавлена к URL-адресу, отображаемому в объявлении. |
path2 | Вторая часть текста, которая может быть добавлена к URL-адресу, отображаемому в объявлении. Это поле можно задать только в том случае, если задан путь1. |
ad_strength | Общая эффективность рекламы для этой группы объектов. |
Группа АктивовАктив
AssetGroupAsset — это связь между активом и группой активов. Добавление AssetGroupAsset связывает актив с группой активов.
Поля | |
---|---|
resource_name | Имя ресурса актива группы активов. Имя ресурса актива группы активов имеет вид: |
asset_group | Группа активов, с которой связан этот актив группы активов. |
asset | Актив, с которым связан этот актив группы активов. |
field_type | Описание размещения актива в группе активов. Например: HEADLINE, YOUTUBE_VIDEO и т. д. |
status | Статус связи между активом и группой активов. |
AssetGroupAssetCombinationData
Данные о комбинации активов группы активов
Поля | |
---|---|
asset_combination_served_assets[] | Обслуженные активы. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter представляет узел дерева фильтров группы списков в группе активов.
Поля | |
---|---|
resource_name | Имя ресурса фильтра группы списков групп активов. Имя ресурса фильтра группы списка активов имеет форму: |
asset_group | Группа активов, частью которой является этот фильтр группы списков групп активов. |
id | Идентификатор ListingGroupFilter. |
type | Тип узла фильтра группы списков. |
vertical | Вертикаль, которую представляет текущее дерево узлов. Все узлы одного дерева должны принадлежать к одной вертикали. |
case_value | Значение параметра, с помощью которого эта группа объявлений уточняет своего родительского элемента. Не определено для корневой группы. |
parent_listing_group_filter | Имя ресурса подразделения родительской группы объявлений. Нулевое значение для узла фильтра корневой группы списков. |
path | Путь к измерениям, определяющим этот фильтр группы списков. |
Группа АктивовСигнал
AssetGroupSignal представляет сигнал в группе активов. Наличие сигнала сообщает кампании с максимальной эффективностью, кто с наибольшей вероятностью совершит конверсию. Эффективность с максимальной эффективностью использует этот сигнал для поиска новых людей с похожим или более сильным намерением получить конверсии в поиске, медийной рекламе, видео и т. д.
Поля | |
---|---|
resource_name | Имя ресурса сигнала группы активов. Имя ресурса сигнала группы активов имеет вид: |
asset_group | Группа активов, к которой принадлежит этот сигнал группы активов. |
Полевой signal Союза. Сигнал группы активов. signal может быть только одним из следующих: | |
audience | Сигнал аудитории, который будет использоваться в кампании с максимальной эффективностью. |
Ассетгрупптопкомбинатионвиев
Представление об использовании комбинации рекламных объектов группы объявлений.
Поля | |
---|---|
resource_name | Имя ресурса верхнего комбинированного представления группы активов. Имена ресурсов представления Top Combination AssetGroup имеют форму: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}" |
asset_group_top_combinations[] | Лучшие комбинации активов, которые служили вместе. |
Набор активов
Набор активов, представляющий коллекцию активов. Используйте AssetSetAsset, чтобы связать актив с набором активов.
Поля | |
---|---|
id | Идентификатор набора активов. |
resource_name | Имя ресурса набора активов. Имена ресурсов набора активов имеют форму: |
АктивСетАссет
AssetSetAsset — это связь между активом и набором активов. Добавление AssetSetAsset связывает актив с набором активов.
Поля | |
---|---|
resource_name | Имя ресурса набора активов. Имена ресурсов набора активов имеют форму: |
asset_set | Набор активов, с которым связан этот актив набора активов. |
asset | Актив, с которым связан этот актив набора активов. |
status | Статус набора активов. Только для чтения. |
Аудитория
Аудитория – это эффективный вариант таргетинга, который позволяет вам пересекать различные атрибуты сегмента, такие как подробные демографические данные и интересы, для создания аудиторий, представляющих разделы ваших целевых сегментов.
Поля | |
---|---|
resource_name | Имя ресурса аудитории. Имена аудиторий имеют вид: |
id | Идентификатор аудитории. |
name | Необходимый. Название аудитории. Оно должно быть уникальным для всех аудиторий. Он должен иметь минимальную длину 1 и максимальную длину 255. |
description | Описание этой аудитории. |
Стратегия торгов
Стратегия ставок.
Поля | |
---|---|
resource_name | Название ресурса стратегии назначения ставок. Имена ресурсов стратегии назначения ставок имеют вид: |
status | Статус стратегии назначения ставок. Это поле доступно только для чтения. |
type | Тип стратегии назначения ставок. Создайте стратегию назначения ставок, задав схему назначения ставок. Это поле доступно только для чтения. |
currency_code | Валюта, используемая в стратегии назначения ставок (трехбуквенный код ISO 4217). Для стратегий назначения ставок для клиентов-менеджеров эта валюта может быть установлена при создании и по умолчанию равна валюте клиента-менеджера. Для обслуживания клиентов это поле задать невозможно; все стратегии обслуживающего клиента неявно используют валюту обслуживающего клиента. Во всех случаях поле effect_currency_code возвращает валюту, используемую стратегией. |
id | Идентификатор стратегии назначения ставок. |
name | Название стратегии назначения ставок. Все стратегии назначения ставок в аккаунте должны иметь четкое название. Длина этой строки должна быть от 1 до 255 включительно в байтах UTF-8 (обрезанная). |
effective_currency_code | Валюта, используемая в стратегии назначения ставок (трехбуквенный код ISO 4217). Для стратегий назначения ставок для клиентов-менеджеров это валюта, заданная рекламодателем при создании стратегии. Для обслуживания клиентов это код валюты клиента. Показатели стратегии назначения ставок указываются в этой валюте. Это поле доступно только для чтения. |
campaign_count | Количество кампаний, привязанных к этой стратегии назначения ставок. Это поле доступно только для чтения. |
non_removed_campaign_count | Количество неудаленных кампаний, привязанных к этой стратегии назначения ставок. Это поле доступно только для чтения. |
Можно установить только один. | |
enhanced_cpc | Стратегия назначения ставок, которая повышает ставки для кликов, которые с большей вероятностью приведут к конверсии, и снижает их для тех кликов, которые кажутся менее вероятными. |
maximize_conversion_value | Стратегия автоматического назначения ставок, которая поможет получить максимальную ценность конверсий для ваших кампаний, расходуя при этом бюджет. |
maximize_conversions | Стратегия автоматического назначения ставок, которая поможет получить максимальное количество конверсий в ваших кампаниях, расходуя при этом бюджет. |
target_cpa | Стратегия назначения ставок, позволяющая получить как можно больше конверсий по заданной вами целевой цене за конверсию. |
target_impression_share | Стратегия назначения ставок, которая автоматически оптимизируется в соответствии с выбранным процентом показов. |
target_outrank_share | Стратегия назначения ставок, которая устанавливает ставки на основе целевой доли аукционов, на которых рекламодатель должен превзойти конкретного конкурента. Это поле устарело. Создать новую стратегию назначения ставок с этим полем или прикрепить стратегии назначения ставок с этим полем к кампании не удастся. Допускаются мутации в стратегии, в которых эта схема уже заполнена. |
target_roas | Стратегия назначения ставок, которая поможет вам максимизировать доход, обеспечивая при этом среднюю целевую рентабельность инвестиций в рекламу (ROAS). |
target_spend | Стратегия назначения ставок, которая устанавливает ставки так, чтобы получить как можно больше кликов в рамках вашего бюджета. |
Кампания
Кампания.
Поля | |
---|---|
resource_name | Имя ресурса кампании. Имена ресурсов кампании имеют вид: |
status | Статус кампании. При добавлении новой кампании статус по умолчанию становится ВКЛЮЧЕНО. |
serving_status | Статус показа объявлений в кампании. |
bidding_strategy_system_status | Системный статус стратегии назначения ставок кампании. |
ad_serving_optimization_status | Статус оптимизации показа объявлений в кампании. |
advertising_channel_type | Основная цель показа объявлений в рамках кампании. Параметры таргетинга можно уточнить в Это поле является обязательным и не должно быть пустым при создании новых кампаний. Можно задать только при создании кампаний. После создания кампании поле нельзя изменить. |
advertising_channel_sub_type | Необязательное уточнение Можно задать только при создании кампаний. После создания кампании поле нельзя изменить. |
url_custom_parameters[] | Список сопоставлений, используемых для замены тегов специальных параметров в |
real_time_bidding_setting | Настройки назначения ставок в реальном времени — функция, доступная только для кампаний, ориентированных на сеть Ad Exchange. |
network_settings | Настройки сети для кампании. |
dynamic_search_ads_setting | Настройка управления динамическими поисковыми объявлениями (DSA). |
shopping_setting | Настройка управления торговыми кампаниями. |
geo_target_type_setting | Настройка геотаргетинга объявлений. |
labels[] | Названия ресурсов ярлыков, прикрепленных к этой кампании. |
bidding_strategy_type | Тип стратегии назначения ставок. Стратегию назначения ставок можно создать, задав либо схему назначения ставок для создания стандартной стратегии назначения ставок, либо поле Это поле доступно только для чтения. |
accessible_bidding_strategy | Имя ресурса AccessibleBiddingStrategy — доступное только для чтения представление неограниченных атрибутов прикрепленной портфельной стратегии назначения ставок, идентифицируемой как «bidding_strategy». Пусто, если в кампании не используется портфельная стратегия. Неограниченные атрибуты стратегии доступны всем клиентам, которым предоставлен общий доступ к стратегии, и считываются из ресурса AccessibleBiddingStrategy. Напротив, ограниченные атрибуты доступны только владельцу стратегии и его менеджерам. Атрибуты с ограниченным доступом можно прочитать только из ресурса BiddingStrategy. |
frequency_caps[] | Список, ограничивающий частоту просмотра рекламы этой кампании каждым пользователем. |
selective_optimization | Настройка выборочной оптимизации для этой кампании, которая включает в себя набор действий-конверсий для оптимизации этой кампании. Эта функция применима только к кампаниям для приложений, которые используют MULTI_CHANNEL в качестве типа AdvertisingChannelType и APP_CAMPAIGN или APP_CAMPAIGN_FOR_ENGAGEMENT в качестве AdvertisingChannelSubType. |
optimization_goal_setting | Настройка цели оптимизации для этой кампании, которая включает набор типов целей оптимизации. |
tracking_setting | Настройки на уровне кампании для отслеживания информации. |
engine_id | Идентификатор кампании во внешнем аккаунте системы. Это поле предназначено только для аккаунтов, не принадлежащих Google Реклама, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта Google Реклама вместо этого используйте «campaign.id». |
excluded_parent_asset_field_types[] | Типы полей активов, которые следует исключить из этой кампании. Ссылки на активы с этими типами полей не будут унаследованы этой кампанией с верхнего уровня. |
create_time | Временная метка создания этой кампании. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». create_time будет устаревшим в версии v1. Вместо этого используйтеcreation_time. |
creation_time | Временная метка создания этой кампании. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». |
last_modified_time | Дата и время последнего изменения этой кампании. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
id | Идентификатор кампании. |
name | Название кампании. Это поле является обязательным и не должно быть пустым при создании новых кампаний. Он не должен содержать нулевых символов (кодовая точка 0x0), перевода строки NL (кодовая точка 0xA) или возврата каретки (кодовая точка 0xD). |
tracking_url_template | Шаблон URL-адреса для создания URL-адреса отслеживания. |
campaign_budget | Имя ресурса бюджета кампании. |
start_date | Дата начала кампании в часовом поясе обслуживающего клиента в формате ГГГГ-ММ-ДД. |
end_date | Последний день кампании по обслуживанию часового пояса клиента в формате ГГГГ-ММ-ДД. При создании по умолчанию используется 30 декабря 2037 г., что означает, что кампания будет длиться неопределенное время. Чтобы настроить существующую кампанию на неопределенный срок, установите в этом поле значение 30 декабря 2037 г. |
final_url_suffix | Суффикс, используемый для добавления параметров запроса к целевым страницам, которые обслуживаются с помощью параллельного отслеживания. |
url_expansion_opt_out | Представляет собой отказ от расширения URL-адресов до более целевых URL-адресов. Если этот параметр отключен (true), таргетингом будут выбраны только конечные URL-адреса в группе объектов или URL-адреса, указанные в Google Merchant Center или фидах бизнес-данных рекламодателя. Если выбрано значение (false), целью будет весь домен. Это поле можно задать только для кампаний с максимальной эффективностью, где значение по умолчанию — false. |
Поле объединения Должно быть либо портфолио (созданное с помощью сервиса BiddingStrategy), либо стандартное, встроенное в кампанию. | |
bidding_strategy | Название ресурса пакетной стратегии назначения ставок, используемой в кампании. |
manual_cpa | Стандартная стратегия назначения ставок CPA вручную. Стратегия назначения ставок вручную, которая позволяет рекламодателю устанавливать ставку за каждое действие, указанное рекламодателем. Поддерживается только для кампаний "Местные услуги". |
manual_cpc | Стандартная стратегия назначения цен за клик вручную. Назначение ставок вручную на основе кликов, при котором пользователь платит за клик. |
manual_cpm | Стандартная стратегия назначения ставок вручную с ценой за тысячу показов. Назначение ставок на основе количества показов вручную, при котором пользователь платит за тысячу показов. |
maximize_conversions | Стандартная стратегия назначения ставок "Максимум конверсий", которая автоматически увеличивает количество конверсий при расходе бюджета. |
maximize_conversion_value | Стандартная стратегия назначения ставок "Максимальная ценность конверсии", которая автоматически назначает ставки для максимального увеличения дохода при расходовании бюджета. |
target_cpa | Стандартная стратегия назначения ставок «Целевая цена за конверсию», которая автоматически назначает ставки, чтобы помочь получить как можно больше конверсий по заданной вами целевой цене за конверсию. |
target_impression_share | Стратегия назначения ставок «Целевой процент полученных показов». Стратегия автоматического назначения ставок, которая устанавливает ставки для достижения выбранного процента показов. |
target_roas | Стратегия назначения ставок «Стандартная целевая рентабельность инвестиций в рекламу», которая автоматически максимизирует доход, обеспечивая при этом среднюю целевую рентабельность инвестиций в рекламу (ROAS). |
target_spend | Стандартная стратегия назначения ставок с целевыми расходами, которая автоматически устанавливает ставки так, чтобы получить как можно больше кликов в рамках вашего бюджета. |
percent_cpc | Стандартная стратегия назначения ставок в виде процента за клик, при которой ставки представляют собой долю рекламируемой цены на какой-либо товар или услугу. |
target_cpm | Стратегия назначения ставок, которая автоматически оптимизирует цену за тысячу показов. |
Настройка динамической поисковой рекламы
Настройка управления динамическими поисковыми объявлениями (DSA).
Поля | |
---|---|
domain_name | Необходимый. Имя интернет-домена, которое представляет этот параметр, например «google.com» или «www.google.com». |
language_code | Необходимый. Код языка, определяющий язык домена, например «en». |
use_supplied_urls_only | Используются ли в кампании исключительно URL-адреса, предоставленные рекламодателем. |
Настройка геотаржеттипесеттинг
Представляет собой набор настроек, связанных с геотаргетингом объявлений.
Поля | |
---|---|
positive_geo_target_type | Настройка, используемая для позитивного геотаргетинга в этой конкретной кампании. |
negative_geo_target_type | Настройка, используемая для негативного геотаргетинга в этой конкретной кампании. |
Настройки сети
Настройки сети для кампании.
Поля | |
---|---|
target_google_search | Будет ли реклама показываться в результатах поиска google.com. |
target_search_network | Будут ли показываться объявления на партнерских сайтах в поисковой сети Google (требуется, чтобы |
target_content_network | Будет ли подано реклама в указанных размещениях в сети дисплея Google. Размещение указывается с использованием критерия размещения. |
target_partner_search_network | Будет ли подано реклама в Google Partner Network. Это доступно только для некоторых выбранных учетных записей Google. |
Оптимизация GoalSetting
Установка целей оптимизации для этой кампании, которая включает в себя набор типов целей оптимизации.
Поля | |
---|---|
optimization_goal_types[] | Список типов целей оптимизации. |
Селективоптимизация
Селективная настройка оптимизации для этой кампании, которая включает в себя набор действий по конверсии для оптимизации этой кампании. Эта функция применяется только к кампаниям приложений, которые используют multi_channel в качестве рекламы SchannelType и APP_CAMPAIN или APP_CAMPAIN_FOR_ENGENTION AS ADMARKCHANNELSUBTYPE.
Поля | |
---|---|
conversion_actions[] | Выбранный набор имен ресурсов для действий по преобразованию для оптимизации этой кампании. |
Shoppingsetting
Установка для покупок. Определяет вселенную продуктов, которая может быть рекламирована кампанией, и как эта кампания взаимодействует с другими покупками.
Поля | |
---|---|
feed_label | Кормовая метка продуктов для включения в кампанию. Может быть установлен только один из FEED_LABEL или Sales_country. Если используется вместо Sales_country, поле FEED_LABEL принимает коды страны в одном и том же формате, например: 'xx'. В противном случае может быть любая строка, используемая для метки подачи в Google Merchant Center. |
use_vehicle_inventory | Нацеливаться ли инвентаризацию перечисления транспортных средств. |
merchant_id | Удостоверение личности с учетной записью центрального центра. Это поле требуется для создания операций. Это поле неизбежно для покупок. |
sales_country | Страна продаж продукции для включения в кампанию. |
campaign_priority | Приоритет кампании. Кампании с численно более высокими приоритетами имеют приоритет над теми с более низкими приоритетами. Это поле требуется для покупок, со значениями от 0 до 2, включительно. Это поле не является обязательным для интеллектуальных покупок, но должно быть равным 3, если установлено. |
enable_local | Должны ли включать местные продукты. |
Отслеживание
Настройки на уровне кампании для отслеживания информации.
Поля | |
---|---|
tracking_url | URL используется для динамического отслеживания. |
Кампания
Связь между кампанией и активом.
Поля | |
---|---|
resource_name | Название ресурса актива кампании. Имена ресурсов кампании имеет форму: |
status | Статус актива кампании. |
campaign | Кампания, с которой связан актив. |
asset | Актив, который связан с кампанией. |
Кампания
Кампания - это связь между кампанией и набором активов. Добавление кампании, нанявших набор активов с кампанией.
Поля | |
---|---|
resource_name | Название ресурса набора активов кампании. Набор активов имена ресурсов активов есть форма: |
campaign | Кампания, с которой этот набор активов связана. |
asset_set | Набор активов, который связан с кампанией. |
status | Статус актива активов кампании. Только для чтения. |
Кампания AudienceView
Представление об аудитории кампании. Включает данные о производительности из интересов и списков ремаркетинга для отображения сети и сетевых объявлений YouTube, а также списки ремаркетинга для поисковой рекламы (RLSA), агрегированы по кампании и критерию аудитории. Эта точка зрения включает в себя только аудиторию, прикрепленную на уровне кампании.
Поля | |
---|---|
resource_name | Название ресурса представления аудитории кампании. Аудитория кампании. Название ресурсов имеет форму: |
Кампания Budget
Бюджет кампании.
Поля | |
---|---|
resource_name | Название ресурса бюджета кампании. Имена ресурсов бюджета кампании имеют форму: |
delivery_method | Метод доставки, который определяет ставку, на которую тратится бюджет кампании. По умолчанию стандартные, если не указано в операции создания. |
period | Период, на который можно тратить бюджет. По умолчанию ежедневно, если не указано. |
amount_micros | Сумма бюджета в местной валюте для счета. Сумма указана в микросхеме, где один миллион эквивалентен одной валютной единице. Ежемесячные расходы ограничены в 30,4 раза больше этой суммы. |
Кампания
Критерий кампании.
Поля | |
---|---|
resource_name | Название ресурса критерия кампании. Названия ресурсов критерия кампании имеют форму: |
display_name | Отображаемое имя критерия. Это поле игнорируется для мутатов. |
type | Тип критерия. |
status | Статус критерия. |
last_modified_time | DateTime, когда этот критерий кампании был в последний раз изменен. DateTime находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: Ss.sssssss». |
criterion_id | Идентификатор критерия. Это поле игнорируется во время мутата. |
bid_modifier | Модификатор для заявок, когда критерий соответствует. Модификатор должен быть в диапазоне: 0,1 - 10,0. Большинство целевых типов критериев поддерживают модификаторы. Используйте 0, чтобы отказаться от типа устройства. |
negative | Нацеливаться ли ( |
Полевой Именно один должен быть установлен. | |
keyword | Ключевое слово. |
location | Расположение. |
device | Устройство. |
age_range | Возрастной диапазон. |
gender | Пол. |
user_list | Список пользователей. |
language | Язык. |
webpage | Веб-страница. |
location_group | Группа местоположения |
Кампания
Представляет отношения между кампанией и ярлыком.
Поля | |
---|---|
resource_name | Название ресурса. Имена ресурсов метки кампании имеет форму: |
campaign | Кампания, к которой прикреплен этикетка. |
label | Этикетка назначена для кампании. |
owner_customer_id | Идентификатор клиента, который владеет этикеткой. |
Cartdatasalesview
Cart Data Sales View.
Поля | |
---|---|
resource_name | Название ресурса представления продаж данных CART. Названия ресурсов с продажей корзины имеют форму: |
Конверсия
Конверсия.
Поля | |
---|---|
resource_name | Название ресурса конверсии. Имена ресурсов конверсии имеют форму: |
id | Идентификатор конверсии |
criterion_id | Поиск объявлений 360 идентификатор критерия. Значение 0 указывает на то, что критерий не приспособлен. |
merchant_id | Поисковая реклама 360 Идентификатор учетной записи инвентаризации, содержащий продукт, на который был нажат. Поиск объявлений 360 генерирует этот идентификатор, когда вы ссылаетесь на учетную запись инвентаризации в поисковом объявлении 360. |
ad_id | Рекламный идентификатор Значение 0 указывает на то, что объявление не привлечено. |
click_id | Уникальная строка для посещения, к которому приписывается преобразование, которая передается на целевую страницу в качестве параметра URL -адреса Click. |
visit_id | Поиск объявлений 360 посещает идентификатор, с которым приписывается конверсия. |
advertiser_conversion_id | Для автономных преобразований это идентификатор, предоставленный рекламодателями. Если рекламодатель не указывает такой идентификатор, поиск объявления 360 генерирует один. Для онлайн -преобразований это равна столбцу ID или столбца Floodlight_order_id в зависимости от инструкций по прожектор рекламодателя. |
product_id | Идентификатор продукта нажал на. |
product_channel | Канал продаж продукта, который был нажат на: онлайн или локальный. |
product_language_code | Язык (ISO-639-1), который был установлен для корма торгового центра, содержащего данные о продукте. |
product_store_id | Магазин в локальном инвентарном объявлении, на который нажимались. Это должно соответствовать идентификаторам магазина, используемым в вашей местной продукции. |
product_country_code | Страна (ISO-3166-формат) зарегистрирована для подачи инвентаризации, которая содержит нажатый продукт. |
attribution_type | На что приписывается конверсия: посетить или ключевое слово+ad. |
conversion_date_time | TimeStamp of the Convertion Event. |
conversion_last_modified_date_time | Неэппаратная метка прошлого раз преобразования была изменена. |
conversion_visit_date_time | Неэппаратная метка визита, с которой приписывается преобразование. |
conversion_quantity | Количество элементов, записанных преобразованием, как определено параметром QTY URL. Рекламодатель отвечает за динамически заполнение параметра (например, количество предметов, продаваемых при преобразовании), в противном случае он по умолчанию до 1. |
conversion_revenue_micros | Скорректированный доход в микросхеме для события конверсии. Это всегда будет в валюте сервировочного счета. |
floodlight_original_revenue | Первоначальный, неизменный доход, связанный с событием прожектора (в валюте текущего отчета), перед модификациями инструкции по валюте прожектора. |
floodlight_order_id | Идентификатор заказа прожектора, предоставленный рекламодателем для преобразования. |
status | Состояние конверсии, включенное или удаленное .. |
asset_id | ID актива, с которым взаимодействовали во время конверсии. |
asset_field_type | Тип поля актива события конверсии. |
Преобразование
Действие конверсии.
Поля | |
---|---|
resource_name | Имя ресурса действия преобразования. Имена ресурсов действий преобразования имеют форму: |
creation_time | Неэппаратная метка создания деятельности прожектора, отформатированная в ISO 8601. |
status | Статус этого действия преобразования для начисления события конверсии. |
type | Тип этого действия преобразования. |
category | Категория конверсий, представленная для этого действия по конверсии. |
value_settings | Настройки, связанные со значением событий конверсии, связанных с этим действием конверсии. |
attribution_model_settings | Настройки, связанные с моделью атрибуции действия этой преобразования. |
floodlight_settings | Настройки прожектора для типов преобразования прожектора. |
id | Идентификатор действия преобразования. |
name | Имя действия преобразования. Это поле требуется и не должно быть пустым при создании новых действий конверсии. |
primary_for_goal | Если бит первичного действия по обращению с преобразованием является ложным, действие по преобразованию не является разбитым для всех кампаний независимо от цели их преобразования клиентов или цели преобразования кампании. Тем не менее, пользовательские цели преобразования не уважают primary_for_goal, поэтому, если кампания имеет пользовательскую цель преобразования, настроенная с помощью действия Primary_for_goal = false преобразования, это действие преобразования по -прежнему остается в курсе. По умолчанию, Promaning_FOR_GOAL будет правдой, если не установлен. В V9 Primary_FOR_GOAL может быть установлен на FALSE только после создания через операцию «обновления», потому что она не объявлена необязательной. |
owner_customer | Имя ресурса клиента владельца действий по конверсии или NULL, если это системное действие конверсии. |
include_in_client_account_conversions_metric | Должно ли это действие преобразования быть включено в метрику "client_account_conversions". |
include_in_conversions_metric | Должно ли это действие преобразования быть включено в метрику «преобразования». |
click_through_lookback_window_days | Максимальное количество дней, которые могут пройти между взаимодействием (например, кликом) и событием конверсии. |
app_id | Идентификатор приложения для действия преобразования приложения. |
Attributionmodelsettings
Настройки, связанные с моделью атрибуции действия этой преобразования.
Поля | |
---|---|
attribution_model | Тип модели атрибуции этого действия преобразования. |
data_driven_model_status | Состояние модели атрибуции, управляемой данными, для действия преобразования. |
Заборы прожекторов
Настройки, связанные с действием преобразования прожектора.
Поля | |
---|---|
activity_group_tag | Строка, используемая для идентификации группы активности прожектора при отчетности. |
activity_tag | Строка, используемая для идентификации активности прожектора при отчетности. |
activity_id | Идентификация деятельности прожектора в DoubleClick Manager кампании (DCM). |
ValueSettings
Настройки, связанные со значением событий конверсии, связанных с этим действием конверсии.
Поля | |
---|---|
default_value | Значение для использования, когда события преобразования для этого действия преобразования отправляются с недопустимым, запрещенным или отсутствующим значением, или когда это действие преобразования настроено, чтобы всегда использовать значение по умолчанию. |
default_currency_code | Код валюты для использования, когда события преобразования для этого действия преобразования отправляются с неверным или отсутствующим кодом валюты, или когда это действие преобразования настроено, чтобы всегда использовать значение по умолчанию. |
always_use_default_value | Управляет, используются ли значение значения по умолчанию и код валюты по умолчанию вместо значения и кода валюты, указанного в событиях преобразования для этого действия преобразования. |
ConversionCustomVariable
Пользовательская переменная преобразования. См. «О настраиваемых показателях и размерах прожектора прожектора в новой поисковой рекламе 360» по адресу https://support.google.com/sa360/answer/13567857
Поля | |
---|---|
resource_name | Имя ресурса пользовательской переменной конверсии. Преобразование пользовательские имена ресурсов имеют форму: |
id | Идентификатор конверсии пользовательской переменной. |
name | Необходимый. Название пользовательской переменной преобразования. Имя должно быть уникальным. Максимальная длина имени составляет 100 символов. Не должно быть никаких дополнительных пространств до и после. |
tag | Необходимый. Тег пользовательской переменной преобразования. Тэг должен быть уникальным и состоять из символа «U», следовавшего непосредственно с числом, меньше, чем Ormequal, до 100. Например: «U4». |
status | Статус пользовательской переменной конверсии для начисления событий конверсии. |
owner_customer | Имя ресурса клиента, которая владеет пользовательской переменной конверсии. |
family | Семейство из пользовательской переменной конверсии. |
cardinality | Кардинальность пользовательской переменной конверсии. |
floodlight_conversion_custom_variable_info | Поля для поисковой рекламы 360 Конверсии прожектора пользовательских переменных. |
custom_column_ids[] | Идентификаторы пользовательских столбцов, которые используют эту пользовательскую переменную преобразования. |
FlorlightConversionCustomVariableInfo
Информация для поиска объявлений 360 Преобразование прожектора пользовательских переменных.
Поля | |
---|---|
floodlight_variable_type | Тип переменной прожектора, определенный в поисковой рекламе 360. |
floodlight_variable_data_type | Тип данных переменной прожектора, определенный в поисковой рекламе 360. |
ConversionTrackingSetting
Коллекция настройки по всему клиенту, связанные с отслеживанием конверсии 360.
Поля | |
---|---|
accepted_customer_data_terms | Принял ли клиент условия данных клиента. При использовании отслеживания преобразования перекрестного дохода это значение унаследовано от менеджера. Это поле только для чтения. Для получения дополнительной информации см . Https://support.google.com/adspolicy/answer/7475709 . |
conversion_tracking_status | Статус отслеживания конверсии. Это указывает, использует ли клиент отслеживание конверсии, и кто является владельцем отслеживания конверсий этого клиента. Если этот клиент использует отслеживание преобразования перекрестного аккунтирования, возвращаемое значение будет отличаться в зависимости от |
enhanced_conversions_for_leads_enabled | Будет ли клиент выбрано для улучшенных конверсий для потенциальных клиентов. При использовании отслеживания преобразования перекрестного дохода это значение унаследовано от менеджера. Это поле только для чтения. |
google_ads_conversion_customer | Название ресурса клиента, где конверсии создаются и управляются. Это поле только для чтения. |
conversion_tracking_id | Идентификатор отслеживания преобразования, используемый для этой учетной записи. Этот идентификатор не указывает, использует ли клиент отслеживание конверсии (это делает Conversion_tracking_status). Это поле только для чтения. |
google_ads_cross_account_conversion_tracking_id | Идентификатор отслеживания конверсии менеджера клиента. Это устанавливается, когда клиент выбирается в отслеживание конверсии, и он переопределяет Conversion_tracking_id. Это поле можно управлять только через пользовательский интерфейс Google Ads. Это поле только для чтения. |
cross_account_conversion_tracking_id | Идентификатор отслеживания конверсии менеджера клиента. Это устанавливается, когда клиент выбирается в отслеживание преобразования перекрестного аккаунта, и он переопределяет Conversion_tracking_id. |
Customcolumn
Пользовательский столбец. См. Поиск объявлений 360 пользовательский столбец по адресу https://support.google.com/sa360/answer/9633916
Поля | |
---|---|
resource_name | Имя ресурса пользовательского столбца. Пользовательские имена ресурсов столбца имеют форму: |
id | Идентификатор пользовательского столбца. |
name | Пользовательский название пользовательского столбца. |
description | Пользовательский описание пользовательского столбца. |
value_type | Тип значения результата пользовательского столбца. |
references_attributes | TRUE, когда пользовательский столбец ссылается на один или несколько атрибутов. |
references_metrics | Верно, когда пользовательский столбец ссылается на один или несколько метрик. |
queryable | TRUE, когда пользовательский столбец доступен для использования в запросе searchAds360service.search и searchads360service.searchstream. |
referenced_system_columns[] | Список ссылочных системных столбцов этого пользовательского столбца. Например, пользовательский столбец «Сумма впечатлений и щелчков» ссылается на системные столбцы {"metrics.clicks", "metrics.impressions"}. |
render_type | Как следует интерпретировать значение результата пользовательского столбца. |
Клиент
Клиент.
Поля | |
---|---|
resource_name | Название ресурса клиента. Имена ресурсов клиентов имеют форму: |
conversion_tracking_setting | Настройка отслеживания конверсии для клиента. |
account_type | Тип учетной записи двигателя, например, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Track и т. Д. |
double_click_campaign_manager_setting | Настройка менеджера кампании DoubleClick (DCM) для клиента менеджера. |
account_status | Статус учетной записи, например, включен, приостановлен, удален и т. Д. |
last_modified_time | DateTime, когда этот клиент был в последний раз изменен. DateTime находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: Ss.sssssss». |
engine_id | ID учетной записи в учетной записи внешнего двигателя. |
status | Статус клиента. |
creation_time | Неэппредактирование, когда этот клиент был создан. Неэпби времени находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: SS». |
id | Идентификатор клиента. |
descriptive_name | Необязательное, не одночернее описательное название клиента. |
currency_code | Валюта, в которой работает учетная запись. Подмножество валютных кодов из стандарта ISO 4217 поддерживается. |
time_zone | Местный идентификатор часового пояса клиента. |
tracking_url_template | Шаблон URL для построения URL -адреса отслеживания из параметров. |
final_url_suffix | Шаблон URL для добавления параметров к окончательному URL. |
auto_tagging_enabled | Удалена ли автоматическая загрязнение для клиента. |
manager | Является ли клиент менеджером. |
CustomerAsset
Связь между клиентом и активом.
Поля | |
---|---|
resource_name | Название ресурса актива клиента. Названия ресурсов CustomerAsset имеют форму: |
asset | Необходимый. Актив, который связан с клиентом. |
status | Статус актива клиента. |
CustomerAssetSet
CustomerAssetSet - это связь между клиентом и набором активов. Добавление клиентских ссылок набор активов с клиентом.
Поля | |
---|---|
resource_name | Имя ресурса набора активов клиента. Набор активов имена ресурсов активов есть форма: |
asset_set | Набор активов, который связан с клиентом. |
customer | Клиент, с которым этот набор активов связан. |
status | Статус актива актива клиента. Только для чтения. |
CustomerClient
Связь между данным клиентом и клиентом клиента. Customerclients существуют только для клиентов менеджера. Все прямые и косвенные клиенты включены, а также самого менеджера.
Поля | |
---|---|
resource_name | Имя ресурса клиента. Имена ресурсов CustomerClient имеют форму: |
applied_labels[] | Названия ресурсов меток, принадлежащих запрашивающему клиенту, которые применяются к клиенту. Имена ресурсов метки имеют форму: |
status | Статус клиента клиента. Читать только. |
client_customer | Имя ресурса клиента-клиента, которое связано с данным клиентом. Читать только. |
level | Расстояние между данным клиентом и клиентом. Для самооценки значение уровня будет 0. Только чтение. |
time_zone | Обычное представление строки данных общего локали (CLDR) часового пояса клиента, например, America/Los_angeles. Читать только. |
test_account | Определяет, является ли клиент тестовой учетной записью. Читать только. |
manager | Определяет, является ли клиент менеджером. Читать только. |
descriptive_name | Описательное имя для клиента. Читать только. |
currency_code | Валютный код (например, «USD», «EUR») для клиента. Читать только. |
id | Идентификатор клиента клиента. Читать только. |
Customer ManagerLink
Представляет отношения клиента и менеджера.
Поля | |
---|---|
resource_name | Название ресурса. Имена ресурсов Customer ManAgerLink Имеет форму: |
status | Статус связи между клиентом и менеджером. |
manager_customer | Клиент менеджера связан с клиентом. |
manager_link_id | ID ссылки клиента-менеджер. Это поле читается только. |
start_time | The TimeStamp, когда Customer ManagerLink была создана. Неэпби времени находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: SS». |
DoubleClickCampaignmanagersetting
Настройка менеджера кампании DoubleClick (DCM) для клиента менеджера.
Поля | |
---|---|
advertiser_id | Удостоверение личности рекламодателя менеджера кампании, связанного с этим клиентом. |
network_id | Удостоверение личности сети менеджера кампании, связанная с этим клиентом. |
time_zone | Часовой пояс сети менеджера кампании, связанная с этим клиентом в формате базы данных IANA TOMES, таких как America/New_york. |
DynamicSearchAdsSearchVermView
Динамический поисковый поисковый просмотр.
Поля | |
---|---|
resource_name | Имя ресурса просмотра поиска динамического поиска. Динамический поиск объявлений об поиске термин «Просмотр имен ресурсов» есть форма: |
landing_page | Динамически выбранная URL -адрес -страницы впечатления. Это поле только для чтения. |
Genderview
Гендерный вид. Ресурс Gender_view отражает эффективное состояние обслуживания, а не то, что были добавлены критерии. Группа AD без гендерных критериев по умолчанию показывает все полов, поэтому все половины появляются в Gender_view со статистикой.
Поля | |
---|---|
resource_name | Имя ресурса гендерного представления. Гендерное представление имена ресурсов имеют форму: |
GeotargetConstant
Гео -целевая постоянная.
Поля | |
---|---|
resource_name | Название ресурса константы GEO Target. Имена ресурсов GEO Target имеют форму: |
status | Гео целевой постоянный статус. |
id | Идентификатор константы Geo Target. |
name | Geo Target Constant English Name. |
country_code | ISO-3166-1 Код страны Альфа-2, который связан с целью. |
target_type | Гео целевой постоянный тип цели. |
canonical_name | Полностью квалифицированное английское название, состоящее из имени цели и имени его родителя и страны. |
parent_geo_target | Имя ресурса родительской целевой константы GEO. Имена ресурсов GEO Target имеют форму: |
Ключевое слово
Представление ключевого слова.
Поля | |
---|---|
resource_name | Имя ресурса представления ключевого слова. Ключевое слово имена ресурсов имеют форму: |
Этикетка
Ярлык.
Поля | |
---|---|
resource_name | Название ресурса. Имена ресурсов метки имеют форму: |
status | Статус ярлыка. Читать только. |
text_label | Тип метки, отображающего текст на цветном фоне. |
id | Удостоверение личности этикетки. Читать только. |
name | Имя этикетки. Это поле требуется и не должно быть пустым при создании нового ярлыка. Длина этой строки должна составлять от 1 до 80, включительно. |
LanguageConstant
Язык.
Поля | |
---|---|
resource_name | Название ресурса постоянной языка. Имена ресурсов с постоянными языками имеют форму: |
id | Идентификатор языковой постоянной. |
code | Языковой код, например, "en_us", "en_au", "es", "Fr" и т. Д. |
name | Полное имя языка на английском, например, «английский (США)», «Испанский» и т. Д. |
targetable | Является ли язык нацеленным. |
ListingGroupFilterDimension
Листинг измерений для группового фильтра группы Acset Group.
Поля | |
---|---|
Объединенное dimension . Размер одного из приведенных ниже типов всегда присутствует. dimension может быть только одним из следующих: | |
product_bidding_category | Категория ставок предложения о продукте. |
product_brand | Бренд предложения продукта. |
product_channel | Местность предложения продукта. |
product_condition | Состояние предложения продукта. |
product_custom_attribute | Пользовательский атрибут предложения продукта. |
product_item_id | Идентификатор предложения предложения продукта. |
product_type | Тип предложения продукта. |
ProductBiddingCategory
Один элемент категории торгов на определенном уровне. Категории высшего уровня находятся на уровне 1, их дети на уровне 2 и так далее. В настоящее время мы поддерживаем до 5 уровней. Пользователь должен указать тип измерения, который указывает уровень категории. Все случаи одного и того же подразделения должны иметь одинаковый тип измерения (уровень категории).
Поля | |
---|---|
level | Указывает уровень категории в таксономии. |
id | Удостоверение личности категории ставок продукта. Этот идентификатор эквивалентен идентификатору Google_product_category, как описано в этой статье: https://support.google.com/merchants/answer/6324436 |
Продукт
Бренд продукта.
Поля | |
---|---|
value | Строковое значение бренда продукта. |
ProductChannel
Местность предложения продукта.
Поля | |
---|---|
channel | Ценность местности. |
ProductCondition
Состояние предложения продукта.
Поля | |
---|---|
condition | Значение условия. |
ProductCustomattribute
Пользовательский атрибут предложения продукта.
Поля | |
---|---|
index | Указывает индекс пользовательского атрибута. |
value | Строковое значение продукта пользовательское атрибут. |
ProductiTemid
Идентификатор предложения предложения продукта.
Поля | |
---|---|
value | Значение идентификатора. |
ProductType
Тип предложения продукта.
Поля | |
---|---|
level | Уровень типа. |
value | Значение типа. |
ListingGroupFilterDimensionPath
Путь, определяющий измерения, определяющие фильтр группы листинга.
Поля | |
---|---|
dimensions[] | Полный путь измерений через иерархию фильтра группы листинга (исключая корневой узел) к этому фильтру группы листинга. |
LocationView
В просмотре местоположения суммируется выполнение кампаний по критерию местоположения.
Поля | |
---|---|
resource_name | Название ресурса представления местоположения. Расположение имена ресурсов имеют форму: |
ProductBiddingCategoryConstant
Категория ставок продукта.
Поля | |
---|---|
resource_name | Название ресурса категории ставок продукта. Имена ресурсов категории категории продукта имеют форму: |
level | Уровень категории ставок продукта. |
status | Статус категории торгов. |
id | Удостоверение личности категории ставок продукта. Этот идентификатор эквивалентен идентификатору Google_product_category, как описано в этой статье: https://support.google.com/merchants/answer/6324436 . |
country_code | Двухбуктный код страны в верхнем случае категории ставок продукта. |
product_bidding_category_constant_parent | Название ресурса категории ставок родительского продукта. |
language_code | Языковой код категории ставок продукта. |
localized_name | Значение отображения категории ставок на продукт локализован в соответствии с Language_Code. |
ProductGroupView
Просмотр группы продуктов.
Поля | |
---|---|
resource_name | Название ресурса представления группы продуктов. Группа продукта Просмотр Имен ресурсов имеет форму: |
SearchAds360Field
Поле или ресурс (артефакт), используемый SearchAds360service.
Поля | |
---|---|
resource_name | Название ресурса артефакта. Имена ресурсов артефакта имеют форму: |
category | Категория артефакта. |
selectable_with[] | Названия всех ресурсов, сегментов и метрик, которые выбираются с описанным артефактом. |
attribute_resources[] | Названия всех ресурсов, которые выбираются с описанным артефактом. Поля из этих ресурсов не сегментируют метрики при включении в поисковые запросы. Это поле подходит только для артефактов, категория которых является ресурсом. |
metrics[] | В этом поле перечислены имена всех метрик, которые выбираются с описанным артефактом, когда он используется в предложении FAR. Он настроен только для артефактов, категория которых является ресурсом. |
segments[] | В этом поле перечислены имена всех артефактов, будь то сегмент или другой ресурс, этот сегмент метрики при включении в поисковые запросы и когда описанный артефакт используется в пункте From. Он настроен только для артефактов, категория которых является ресурсом. |
enum_values[] | Значения артефакта могут предположить, если это поле enum типа. Это поле установлено только для артефактов сегмента категории или атрибута. |
data_type | Это поле определяет операторов, которые можно использовать с артефактом, где есть положения. |
name | Название артефакта. |
selectable | Можно ли использовать артефакт в предложении Select в поисковых запросах. |
filterable | Можно ли использовать артефакт в предложении, где в поисковых запросах. |
sortable | Можно ли использовать артефакт в пункте «Заказ в поисках». |
type_url | URL -адрес прото, описывающий тип данных артефакта. |
is_repeated | Повторяется ли полевой артефакт. |
ShoppingPerformanceView
Просмотр производительности покупок. Обеспечивает статистику кампании покупок, агрегированную на нескольких уровнях измерения продукта. Значения размеров продукта от торгового центра, таких как бренд, категория, пользовательские атрибуты, состояние продукта и тип продукта, будут отражать состояние каждого измерения на дату и времени, когда было записано соответствующее событие.
Поля | |
---|---|
resource_name | Название ресурса представления о производительности покупок. Производительность покупок имена ресурсов есть форма: |
Пользовательский список
Список пользователей. Это список пользователей, на которые клиент может нацелиться.
Поля | |
---|---|
resource_name | Имя ресурса списка пользователей. Имена ресурсов в списке пользователей имеют форму: |
type | Тип этого списка. Это поле только для чтения. |
id | Идентификатор списка пользователей. |
name | Имя этого списка пользователей. В зависимости от его access_reess, имя списка пользователей не может быть уникальным (например, если access_reason = shared) |
Посещать
Визит.
Поля | |
---|---|
resource_name | Название ресурса визита. Посетите имена ресурсов имеют форму: |
id | Идентификатор визита. |
criterion_id | Поиск объявлений 360 идентификатор ключевого слова. Значение 0 указывает на то, что ключевое слово не привлечено. |
merchant_id | Поисковая реклама 360 Идентификатор учетной записи инвентаризации, содержащий продукт, на который был нажат. Поиск объявлений 360 генерирует этот идентификатор, когда вы ссылаетесь на учетную запись инвентаризации в поисковом объявлении 360. |
ad_id | Рекламный идентификатор Значение 0 указывает на то, что объявление не привлечено. |
click_id | Уникальная строка для каждого посещения, которое передается на целевую страницу в качестве параметра URL -адреса Click. |
visit_date_time | TimeStamp of the Visit Event. Неэпби времени находится в часовом поясе клиента и в формате «Yyyy-MM-DD HH: MM: SS». |
product_id | Идентификатор продукта нажал на. |
product_channel | Канал продаж продукта, который был нажат на: онлайн или локальный. |
product_language_code | Язык (ISO-639-1), который был установлен для корма торгового центра, содержащего данные о продукте. |
product_store_id | Магазин в локальном инвентарном объявлении, на который нажимались. Это должно соответствовать идентификаторам магазина, используемым в вашей местной продукции. |
product_country_code | Страна (формат ISO-3166), зарегистрированная для подачи инвентаризации, которая содержит нажатый продукт. |
asset_id | Удостоверение личности актива, с которым взаимодействовали во время визита. |
asset_field_type | Активы поля типа посещения. |
WebPageView
Представление веб -страницы.
Поля | |
---|---|
resource_name | Имя ресурса представления веб -страницы. Имена ресурсов на веб -странице есть форма: |