v16.1.0 (24 апреля 2024 г.)
Следующие функции и изменения были добавлены в версию 16.1.
Управление аккаунтом
-
CustomerNegativeCriterion.ip_block
, который поддерживает добавление IP-адреса в качестве отрицательного критерия на уровне клиента. - Новое значение перечисления:
ProductLinkError.LINK_EXISTS
. - Новое значение перечисления:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
Ресурсы
- Поддержка объектов, связанных с формированием спроса, для
ad_group_ad_asset_view
иasset_field_type_view
. - Новое значение перечисления:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
Аудитории
- Новое значение перечисления:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
, которое ограничивает количество похожих списков пользователей, которые может иметь клиент, до 1000.
Кампании
- Поддержка возврата имитаций ставок кампании с целевой рентабельностью инвестиций в рекламу для кампаний для приложений с помощью отчета
campaign_simulation
. - Новое значение перечисления:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
. - Новое значение перечисления:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
. - Новое значение перечисления:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
.
Конверсии
-
SkAdNetworkConversionValueSchema.postback_mappings
, который поддерживает функции SKAdNetwork 4.0 . - Добавлена поддержка предупреждений для
CustomerSkAdNetworkConversionValueSchemaService
какMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
. Если установлено значениеtrue
, любые неблокирующие ошибки, относящиеся к сбоям операций, будут возвращены какMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
. - Новые значения перечисления в
CustomerSkAdNetworkConversionValueSchemaError
:-
INVALID_EVENT_COUNTER
-
INVALID_EVENT_NAME
-
Критерии
- Новые поля в
BrandInfo
:-
display_name
-
primary_url
-
rejection_reason
-
status
-
- Новое перечисление:
BrandRequestRejectionReason
. - Новое значение перечисления:
CriterionType.LIFE_EVENT
.
Эксперименты
- Новое значение перечисления:
ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT
.
Местные услуги
-
local_services_lead.credit_details.credit_state
иlocal_services_lead.credit_details.credit_state_last_update_date_time
, которые возвращают состояние кредита и временную метку обновления состояния кредита соответственно. -
local_services_lead_conversation.message_details.attachment_urls
, который возвращает URL-адреса, которые можно использовать для загрузки содержимого вложения.
Видео
-
customer.video_brand_safety_suitability
иBrandSafetySuitability
, которые поддерживают получение информации о пригодности бренда видео для обеспечения безопасности на уровне клиента. - Новое значение перечисления:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
v16 (21 февраля 2024 г.)
Следующие функции и изменения были добавлены в v16.
Управление аккаунтом
-
advertising_partner
перенесен изAccountLink
вProductLink
иProductLinkInvitation
. - Удалены
data_partner
иgoogle_ads
изAccountLink
. - Добавлен
IdentityVerificationService
для управления проверкой рекламодателей.-
StartIdentityVerification()
используется для запуска сеанса проверки с использованием предоставленнойverification_program
. Он создает новый сеанс проверки и возвращает пустой ответ для успешно созданной проверки. -
GetIdentityVerification()
можно использовать для получения проверочной информации, которая возвращает несколько объектовIdentityVerification
. КаждаяIdentityVerification
включает в себя:-
verification_program
— тип программы проверки личности. -
identity_verification_requirement
, содержащий сведения о крайнем сроке, к которому рекламодатель должен завершить проверку. -
verification_progress
, который содержит подробную информацию, связанную с сеансом проверки, включая:-
program_status
представляет текущий статус этого сеанса проверки. -
action_url
направляет клиента на URL-адрес для завершения проверки. -
invitation_link_expiration_time
представляет дату истечения срока действияaction_url
-
-
- Перечисления:
- Ошибки:
-
- Добавлен
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
.
Ресурсы
- Изменения в
asset_group
:- Добавлена поддержка сегментов, связанных со временем, таких как
segments.year
иsegments.month
. -
campaign
стала атрибутивным ресурсом вместо сегментированного ресурса.
- Добавлена поддержка сегментов, связанных со временем, таких как
Кампании
- Изменения в кампаниях по формированию спроса:
- Добавлена поддержка настройки
Campaign.shopping_setting
для существующей кампании по формированию спроса. - Добавлен
ShoppingSetting.disable_product_feed
для отключения дополнительного фида товаров в кампаниях по формированию спроса. - Добавлен
Ad.demand_gen_product_ad
и соответствующийDemandGenProductAdInfo
, доступный для кампаний формирования спроса с ненулевым значениемCampaign.shopping_setting
.
- Добавлена поддержка настройки
- В следующие поля в
AdGroup
добавлено, чтобы показать, показывается ли группа объявлений или почему она не показывается:-
primary_status
-
primary_status_reasons
-
- В следующие поля в
AdGroupAd
добавлено, чтобы показать, показывается ли объявление группы объявлений или причины, по которым оно не показывается:-
primary_status
-
primary_status_reasons
-
- В
AdGroupError
добавлены следующие значения:-
CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
-
INVALID_STATUS
-
Эксперимент
- Добавлен
Experiment.sync_enabled
, чтобы указать, следует ли включать синхронизацию в эксперименте. Если синхронизация включена , изменения, внесенные в исходную кампанию во время эксперимента, автоматически копируются в экспериментальную кампанию. - Добавлен
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
. - Добавлен
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
.
Отель и путешествия
- В
ListingDimensionInfo
для объявления «Что делать» добавлены следующие поля, позволяющие создавать группы объявлений на основе штата и города, где доступна туристическая деятельность: - В
travel_activity_performance_view
добавлена поддержка следующих сегментов:
Местные услуги
- Добавлены
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
иBusinessRegistrationCheckArtifact
, позволяющие рекламодателям отслеживать ход процесса проверки регистрации компании. - Добавлен новый ресурс
local_services_employee
, позволяющий рекламодателям получать добавленную ими информацию о сотрудниках.
Планирование
- Удалена
score
изAudienceInsightsAttributeMetadata
.
Рекомендации
- Добавлена
RecommendationService.GenerateRecommendations()
, которая возвращает рекомендации на основе указанных настроек, таких как типы рекомендаций и типы рекламных каналов. Это особенно полезно во время разработки кампании. - Добавлена
RecommendationMetrics.conversions_value
. - Для рекомендуемых ключевых слов с неустановленным типом соответствия ключевого слова теперь
recommended_match_type
имеет значениеUNSPECIFIED
вместоUNKNOWN
. - Добавлены следующие типы рекомендаций:
-
MAXIMIZE_CONVERSION_VALUE_OPT_IN
, который рекомендует выбрать стратегию назначения ставок "Максимальная ценность конверсии". -
IMPROVE_GOOGLE_TAG_COVERAGE
, который рекомендует использовать тег Google на большем количестве страниц. -
PERFORMANCE_MAX_FINAL_URL_OPT_IN
, в котором рекомендуется включить расширение конечного URL для кампаний с максимальной эффективностью. -
REFRESH_CUSTOMER_MATCH_LIST
, который рекомендует обновить список клиентов, который не обновлялся в течение последних 90 дней. -
CUSTOM_AUDIENCE_OPT_IN
, который рекомендует создать собственную аудиторию. -
LEAD_FORM_ASSET
, который рекомендует добавлять активы форм для потенциальных клиентов на уровне кампании или клиента. -
IMPROVE_DEMAND_GEN_AD_STRENGTH
, который рекомендует повысить эффективность рекламы в кампаниях по формированию спроса.
-
Покупка
- Добавлены
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
иCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
, чтобы предоставить более подробную информацию об ошибках для торговых кампаний, связанных с аккаунтом Сервисного центра сравнения цен . - В
AssetGroupListingGroupFilterError
добавлены следующие значения:-
DIMENSION_TYPE_NOT_ALLOWED
-
DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
-
FILTER_EXCLUSION_NOT_ALLOWED
-
LISTING_SOURCE_NOT_ALLOWED
-
MULTIPLE_LISTING_SOURCES
-
MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
-
MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
-
PAGE_FEED_FILTER_HAS_PARENT
-
Цели жизненного цикла
- Добавлено
update
дляCustomerLifecycleGoalOperation
иCampaignLifecycleGoalOperation
, чтобы эти типы операций соответствовали другим типам операций в API.
версия 15 (18 октября 2023 г.)
Следующие новые функции и обновления были представлены в версии 15.
Управление аккаунтом
- Если ваша учетная запись заблокирована из-за несанкционированной активности ,
customer.status
иcustomer_client.status
теперь возвращаются какSUSPENDED
. Раньше они возвращались какENABLED
. - Добавлена поддержка добавления и удаления связи между аккаунтом Google Ads и аккаунтом Merchant Center:
- Добавлены
ProductLink.merchant_center
иMerchantCenterIdentifier
. - Добавлен
LinkedProductType.MERCHANT_CENTER
.
- Добавлены
- Добавлены
ProductLinkInvitationService
иProductLinkInvitation
для поддержки обновления приглашения по ссылке, отправленного из других продуктов, доступных для аккаунтов Hotel Center и Merchant Center . - Удален
MerchantCenterLinkService
.- Чтобы связать аккаунты Google Рекламы с аккаунтами Merchant Center, используйте
ProductLinkInvitationService
иProductLinkService
.
- Чтобы связать аккаунты Google Рекламы с аккаунтами Merchant Center, используйте
- Удален
AccountLink.hotel_center
и поддержка обновления приглашений на ссылку из учетных записей Hotel Center с помощьюAccountLinkService
.- Чтобы обновить приглашение по ссылке из учетной записи Hotel Center, используйте
ProductLinkInvitationService
.
- Чтобы обновить приглашение по ссылке из учетной записи Hotel Center, используйте
Ресурсы
-
ImageAdInfo.media_file
заменен наImageAdInfo.image_asset
для поддержки добавления и удаления изображений с использованием ресурсов. В результате мы также удалилиMediaFileService
, который больше не нужен. - Добавлен
ListingGroupFilterDimension.webpage
для поддержки создания фильтра группы списков на основе пользовательских меток и подстрок URL-адресов.- Также заменен
AssetGroupListingGroupFilter.vertical
наAssetGroupListingGroupFilter.listing_source
иListingGroupFilterListingSource
- Также заменен
- Добавлен
asset_group_asset.source
, чтобы показать источник актива группы активов. - Добавлен
ad_group_ad_asset_view.source
, чтобы показать источник рекламного объекта группы объявлений.
Аудитории
- Для списка электронных адресов добавлен
CustomerMatchUserListMetadata.consent
для поддержки предоставления согласия. Начиная с 6 марта 2024 г., если согласие отсутствует для пользователей из ЕЭЗ, значение согласия определяется как несогласованное. Данные пользователей из ЕЭЗ, не получивших согласия, не будут обрабатываться и не могут использоваться для персонализации рекламы с помощью списков электронных адресов. Более подробную информацию можно найти в нашем руководстве по спискам электронных адресов . - Для продаж в магазине добавлен
UserData.consent
для поддержки предоставления согласия. Более подробную информацию можно найти в нашем руководстве по продажам в магазине . Если вы используете списки электронных адресов для продаж в магазине, дополнительную информацию можно найти в разделе часто задаваемых вопросов . - Добавлен
UserList.lookalike_user_list
для поддержки создания сегмента Lookalike — аудитории, созданной на основе предоставленной существующей исходной аудитории. Похожие сегменты можно использовать только в кампаниях по формированию спроса .
Кампании
Обновления в кампаниях с максимальной эффективностью:
-
AssetGroupSignal
теперь поддерживает два типа сигналов, которые можно прикрепить к группе активов для расширенного таргетинга:-
AssetGroupSignal.audience
- Добавлены
Audience.scope
иAudience.asset_group
, чтобы ограничить использование аудитории определенной группой активов.Audience.asset_group
должен быть установлен тогда и только тогда, когдаAudience.scope
имеет значениеASSET_GROUP
.
- Добавлены
-
AssetGroupSignal.search_theme
- Добавлен
CriterionType.SEARCH_THEME
для поддержки этого нового типа критерия. Этот новый тип критерия можно использовать только в кампаниях с максимальной эффективностью для созданияAssetGroupSignal
путем заполненияAssetGroupSignal.search_theme
критериемSearchThemeInfo
.
- Добавлен
-
- Добавлен
AssetGroupSignalOperation.exempt_policy_violation_keys
для поддержки запроса освобождения при добавлении сигналов группы активов. - Добавлен новый
asset_group_top_combination_view
для отчета о наиболее эффективных активах на уровне группы активов. - Чтобы получить данные об эффективности кампании с максимальной эффективностью, теперь можно запрашивать
asset_group
с полями показателей. - В
PerformanceMaxUpgradeStatus
переименован вUPGRADE_ELIGIBLE
вUPGRADE_ELIGIBLE
.
-
Для кампаний «Создание спроса» и «Целевая цена за конверсию Discovery» моделирование ставок целевой цены за конверсию на уровне кампании (
campaign_simulation.target_cpa_point_list.points
) теперь возвращаетTargetCpaSimulationPoint.interactions
вместоTargetCpaSimulationPoint.clicks
.Добавлен
BrandSuggestionService
, который может предлагать бренды на основе предоставленного префикса бренда и исключенного списка брендов. Эти бренды можно использовать для создания критерияBRAND
, добавления в общий наборBRANDS
, а затем прикрепить к кампании, создавCampaignCriterion
с наборомbrand_list
для общего набора. Критерии кампании можно настроить в поисковых кампаниях и исключить из кампаний с максимальной эффективностью соответственно.Добавлен
Campaign.asset_automation_settings[]
для отображения статуса автоматизации каждого типа активов.В перечисление
CampaignPrimaryStatusReason
добавлены следующие значения:-
NO_ASSET_GROUPS
-
ASSET_GROUPS_PAUSED
-
Конверсии
- Добавлены
CallConversion.consent
иClickConversion.consent
для поддержки предоставления согласия. Ознакомьтесь с нашим руководством по конверсии звонков и руководством по конверсиям по кликам для получения более подробной информации. - Добавлены следующие поля, связанные с конверсиями SKAdNetwork , доступные при запросе их у
customer
илиcampaign
: -
metrics.sk_ad_network_conversions
заменен наmetrics.sk_ad_network_installs
. - Добавлена поддержка диагностики загрузки офлайн-конверсий.
-
offline_conversion_upload_client_summary
перенесено из поля ресурсаcustomer
в отчет верхнего уровня. Используйте этот отчет, чтобы получить полезную информацию о статусе загрузки конверсий, такую как количество успешных событий, уровень успеха и процент ошибок.- Предостережение : преобразование, которое загружено, но приводит к ошибке
ConversionUploadError.CLICK_NOT_FOUND
, по-прежнему считается успешным, но оно также помечается какOfflineConversionAlert
.
- Предостережение : преобразование, которое загружено, но приводит к ошибке
- Добавлен
job_id
в качестве необязательного параметра для следующих типов запросов, чтобы вы могли логически сгруппировать несколько запросов на загрузку в одно концептуальное задание: - Добавлен
INVALID_JOB_ID
к следующим ошибкам: -
INVALID_CONVERSION_ACTION
заменен наNO_CONVERSION_ACTION_FOUND
иINVALID_CONVERSION_ACTION_TYPE
в следующих ошибках:
-
- Добавлены три отчета для поддержки межсетевой атрибуции Android Privacy Sandbox без перенаправлений :
-
android_privacy_shared_key_google_campaign
, которыйshared_campaign_key
и некоторые поля, которые помогают закодировать ключ. -
android_privacy_shared_key_google_ad_group
, который содержитshared_ad_group_key
и некоторые поля, которые помогают закодировать ключ. -
android_privacy_shared_key_google_network_type
, который содержитshared_network_type_key
и некоторые поля, которые помогают закодировать ключ.
-
- Добавлен
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
.ConversionActionOperation
, пытающаяся использовать одну из устаревших моделей атрибуции на основе правил, теперь завершается с этой ошибкой. Раньше операция завершалась неудачей из-заUNKNOWN
ошибки.
Отель и путешествия
- Добавлена поддержка следующих полей в
travel_activity_group_view
иtravel_activity_performance_view
:- Сегменты:
- Метрики:
-
metrics.search_absolute_top_impression_share
-
metrics.search_budget_lost_absolute_top_impression_share
-
metrics.search_budget_lost_impression_share
-
metrics.search_budget_lost_top_impression_share
-
metrics.search_impression_share
-
metrics.search_rank_lost_absolute_top_impression_share
-
metrics.search_rank_lost_impression_share
-
metrics.search_rank_lost_top_impression_share
-
metrics.search_top_impression_share
-
Реклама местных услуг
- В отчет
customer
добавленLocalServicesSettings
и его поля для возврата подробной информации о лицензии и статусах страхования рекламодателя местных услуг. - Добавлены следующие новые отчеты для местных служб :
-
local_services_lead
содержит все сведения, относящиеся к потенциальным клиентам из Рекламы местных услуг, такие какlead_charged
,lead_type
,lead_status
.- Перечисления:
-
local_services_lead_conversation
содержит сведения о сообщениях и телефонных разговорах, такие какconversation_channel
,call_duration_millis
,call_recording_url
.- URL-адрес записи телефонного звонка аутентифицируется по целевой учетной записи клиента и ее управляющим учетным записям.
-
local_services_verification_artifact
возвращает артефакты рекламодателя местных услуг, такие как проверка анкетных данных, бизнес-лицензии и данные бизнес-страхования. Доступ к любым документам, связанным с лицензией и страховкой, можно получить через URL-адрес.
-
Планирование
- Добавлена поддержка возврата
Forecast.views
иPlannedProductForecast.views
дляReachPlanService.ListPlannableProducts
для применимых типов продуктов. - Добавлена поддержка возврата
PlannableTargeting.surface_targeting
дляReachPlanService.ListPlannableProducts
, который описывает доступные поверхности для продукта. - Добавлено новое перечисление
ReachPlanSurface
. - Добавлена поддержка таргетинга на целевую частоту с помощью
AdvancedProductTargeting.target_frequency_settings
Frequency_settings , который возвращаетPlannedProductForecast.average_frequency
. - Добавлен
AudienceInsightsService.GenerateSuggestedTargetingInsights
для возврата предлагаемых целевых аудиторий. - В
ReachPlanError
добавлены следующие значения:-
NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
-
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
-
Рекомендации
- Добавлена
RecommendationSubscriptionService
, которая управляет подписками на рекомендации: - Добавлены следующие типы рекомендаций:
-
FORECASTING_SET_TARGET_CPA
, который рекомендует установить целевую цену за конверсию для кампаний, для которых она не указана, до наступления сезонного события, которое, по прогнозам, приведет к увеличению трафика. -
SET_TARGET_CPA
, который рекомендует установить целевую цену за конверсию для кампаний, для которых она не указана. -
SET_TARGET_ROAS
, который рекомендует установить целевую рентабельность инвестиций в рекламу для кампаний, для которых она не указана.
-
Составление отчетов
- Добавлены следующие новые показатели, которые можно запросить с помощью
campaign
(доступно для кампаний в контекстно-медийной сети, видео, Discovery и кампаний для приложений) иsegments.device
:
Покупка
- Удален
ShoppingSetting.sales_country
, значения которого теперь возвращаются какShoppingSetting.feed_label
.- Вы можете продолжать использовать определенный фид Merchant Center для кампании, используя поле
ShoppingSetting.feed_label
. В качестве значения должно быть установлено значение метки фида или двухбуквенный код страны, ранее использовавшийся дляShoppingSetting.sales_country
. Более подробную информацию можно найти в статье поддержки ярлыков фидов .
- Вы можете продолжать использовать определенный фид Merchant Center для кампании, используя поле
- Убрана зависимость категорий товаров от кода страны в отчетности. Набор поддерживаемых идентификаторов категорий не изменился.
- Заменены следующие поля, используемые в
shopping_performance_view
:-
segments.product_bidding_category_level1
сsegments.product_category_level1
-
segments.product_bidding_category_level2
сsegments.product_category_level2
-
segments.product_bidding_category_level3
сsegments.product_category_level3
-
segments.product_bidding_category_level4
сsegments.product_category_level4
-
segments.product_bidding_category_level5
сsegments.product_category_level5
-
-
product_bidding_category_constant
заменен наproduct_category_constant
, который возвращает все доступные локализации категории в повторяющемся поле. -
ListingDimensionInfo.product_bidding_category
заменен наListingDimensionInfo.product_category
. -
ListingGroupFilterDimension.product_bidding_category
заменен наListingGroupFilterDimension.product_category
.
- Заменены следующие поля, используемые в
- Удалена поддержка добавления
Campaign.shopping_setting
в поисковые кампании. Попытка создать поисковую кампанию сCampaign.shopping_setting
или добавитьCampaign.shopping_setting
к существующей поисковой кампании теперь приводит кOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Удалена поддержка добавления
CampaignCriterion.listing_scope
в поисковые кампании. Попытка добавитьCampaignCriterion.listing_scope
к существующей поисковой кампании теперь приводит кOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Добавлены следующие конверсии с показателями данных корзины :
-
metrics.orders
-
metrics.average_order_value_micros
-
metrics.average_cart_size
-
metrics.cost_of_goods_sold_micros
-
metrics.gross_profit_micros
-
metrics.gross_profit_margin
-
metrics.revenue_micros
-
metrics.units_sold
-
metrics.cross_sell_cost_of_goods_sold_micros
-
metrics.cross_sell_gross_profit_micros
-
metrics.cross_sell_revenue_micros
-
metrics.cross_sell_units_sold
-
metrics.lead_cost_of_goods_sold_micros
-
metrics.lead_gross_profit_micros
-
metrics.lead_revenue_micros
-
metrics.lead_units_sold
- Все эти показатели можно выбрать с помощью следующих отчетов:
-
Единые цели
- Добавлен
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
для настройки целей привлечения клиентов на уровне клиента.- Отчет:
customer_lifecycle_goal
- Отчет:
- Добавлен
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
для настройки целей привлечения клиентов на уровне кампании.- Отчет:
campaign_lifecycle_goal
- Отчет:
- Добавлен
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
. - В
ConversionGoalCampaignConfigError
добавлены следующие значения:-
EMPTY_CONVERSION_GOALS
-
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
-
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
-
Видео
- Добавлена поддержка таргетинга Google TV на уровне кампании:
- Добавлен
NetworkSettings.target_google_tv_network
. - Добавлен
AdNetworkType.GOOGLE_TV
.
- Добавлен
- Добавлена поддержка таргетинга на YouTube на уровне кампании:
- Добавлен
NetworkSettings.target_youtube
- В
AdNetworkType
объединеныYOUTUBE_WATCH
иYOUTUBE_SEARCH
вYOUTUBE
. - Добавлен
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
.
- Добавлен
v14.1.0 (09.08.2023)
Следующие новые функции и обновления были представлены в версии 14.1.
Управление аккаунтом
-
Customer.customer_agreement_setting
, который показывает, принял ли клиент условия обслуживания формы для потенциальных клиентов.
Ресурсы
- Новые поля в
AssetGroup
, показывающие, показывается ли группа объектов или причины, по которым она не показывается:-
primary_status
-
primary_status_reasons
-
- Новые поля в
AssetGroupAsset
, показывающие, обслуживается ли актив группы активов, или причины, по которым он не обслуживается:-
primary_status
-
primary_status_details
-
primary_status_reasons
-
- Новые значения в перечислении
CallToActionType
:-
BUY_NOW
-
DONATE_NOW
-
ORDER_NOW
-
PLAY_NOW
-
SEE_MORE
-
START_NOW
-
VISIT_SITE
-
WATCH_NOW
-
- Новые значения в перечислении
AssetLinkError
:-
CUSTOMER_NOT_VERIFIED
-
UNSUPPORTED_CALL_TO_ACTION
-
PAGE_FEED_INVALID_LABEL_TEXT
-
Биллинг
- Новые поля в
Invoice
иAccountSummary
:-
export_charge_subtotal_amount_micros
-
export_charge_tax_amount_micros
-
export_charge_total_amount_micros
-
Кампании
Новые значения в перечислении
CampaignPrimaryStatusReason
:-
HAS_ASSET_GROUPS_DISAPPROVED
-
HAS_ASSET_GROUPS_LIMITED_BY_POLICY
-
MOST_ASSET_GROUPS_UNDER_REVIEW
-
(Только учетные записи из белого списка)
DiscoveryCampaignSettings
сupgraded_targeting
:- Если для
upgraded_targeting
установлено значениеtrue
, вы можете добавить местоположение и язык в качестве критерия группы объявлений.
- Если для
Критерии
Новое значение перечисления:
CriterionError.INVALID_DETAILED_DEMOGRAPHIC
(Только учетные записи из белого списка) Поддержка добавления
LanguageInfo
иLocationInfo
в качествеAdGroupCriterion
:- Это доступно только для кампании Discovery с включенным обновленным таргетингом.
Эксперименты
- Новые значения в перечислении
ExperimentError
:-
DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
-
CANNOT_REMOVE_IN_CREATION_EXPERIMENT
-
CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES
-
Рекомендации
- Новые типы рекомендаций:
-
PerformanceMaxOptInRecommendation
, который рекомендует создать первую кампанию с максимальной эффективностью в аккаунте. -
ImprovePerformanceMaxAdStrengthRecommendation
, который рекомендует повысить эффективность группы объектов в кампании с максимальной эффективностью. -
MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
, в котором рекомендуется перенести кампанию с динамическими поисковыми объявлениями в кампанию с максимальной эффективностью.
-
Составление отчетов
- Новые показатели и сегменты о новых и вернувшихся клиентах:
- Новые представления
customer_search_term_insight
иcampaign_search_term_insight
:-
metrics.search_volume
показывает диапазон объема для категории статистики поисковых запросов.
-
Покупка
- Новые поля для групп объявлений:
- Новое поле:
ShoppingSetting.advertising_partner_ids
- Новые значения в перечислении
CampaignError
:-
NOT_LINKED_ADVERTISING_PARTNER
-
INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS
-
Видео
- (Только аккаунты из белого списка)
AdType.DISCOVERY_VIDEO_RESPONSIVE_AD
и соответствующий емуDiscoveryVideoResponsiveAdInfo
v14 (07.06.2023)
Следующие новые функции и обновления были представлены в версии 14.
Кампании
Конверсии
Добавлена поддержка идентификации конверсий Google Analytics и определения того, импортирована ли конверсия из ресурса Universal Analytics или GA4:
- В
ConversionActionType
добавлены следующие значения:-
UNIVERSAL_ANALYTICS_GOAL
-
UNIVERSAL_ANALYTICS_TRANSACTION
-
GOOGLE_ANALYTICS_4_CUSTOM
-
GOOGLE_ANALYTICS_4_PURCHASE
-
- Добавлен
ConversionAction.google_analytics_4_settings
- В
Добавлен
Customer.offline_conversion_client_summaries
, который суммирует статус и диагностическую информацию о загрузках и корректировках офлайн-конверсий клиента.- Перечисления
-
OfflineEventUploadClient
:-
GOOGLE_ADS_API
-
GOOGLE_ADS_WEB_CLIENT
-
ADS_DATA_CONNECTOR
-
-
OfflineConversionDiagnosticStatus
:-
EXCELLENT
-
GOOD
-
NEEDS_ATTENTION
-
NO_RECENT_UPLOAD
-
-
- Перечисления
В ответы, возвращаемые
ConversionAdjustmentUploadService.UploadConversionAdjustments
иConversionUploadService.UploadClickConversions
добавленjob_id
для связи ответа сOfflineConversionUploadSummary.job_id
.
Критерии
Добавлена поддержка получения, создания и обновления минус-слов на уровне аккаунта :
- Поля:
- Перечисления:
-
CriterionType.NEGATIVE_KEYWORD_LIST
-
SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
-
ResourceLimitType
-
SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
-
ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
-
-
- Ошибки:
-
CriterionError
-
NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
-
CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
-
CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
-
CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
-
-
Реклама отелей
-
SuggestTravelAssetsRequest.place_id
переименован вSuggestTravelAssetsRequest.place_ids
.
Планирование
- Из
KeywordPlanService
удалены следующие методы:-
GenerateForecastCurve
-
GenerateForecastMetrics
-
GenerateForecastTimeSeries
-
GenerateHistoricalMetrics
-
- Добавлен
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
для поддержки создания показателей прогноза кампании по ключевым словам без необходимости предварительного создания плана ключевых слов. - Удалена поддержка получения отчета
campaign_criterion_simulation
. - Добавлена поддержка
YOUTUBE_DYNAMIC_LINEUP
в качестве измерения вAudienceInsightsService.ListAudienceInsightsAttributes
. - Добавлен
DynamicLineupAttributeMetadata.sample_channels
, используемый в ответахGenerateAudienceCompositionInsights
для предоставления образцов каналов в составах.
Рекомендации
- Добавлен
DynamicImageExtensionOptInRecommendation
, который рекомендует включить динамические расширения изображений в учетной записи. - Добавлена
LowerTargetRoasRecommendation
, которая рекомендует снизить целевую рентабельность инвестиций в рекламу. - Добавлен
RaiseTargetCpaRecommendation
, рекомендующий повысить целевую цену за конверсию. - Добавлен
ResponsiveSearchAdAssetRecommendation.current_ad
.
Составление отчетов
- В
ServedAssetFieldType
добавлены следующие значения, доступные изad_group_ad_asset_view.pinned_field
:-
SITELINK
-
CALL
-
MOBILE_APP
-
CALLOUT
-
STRUCTURED_SNIPPET
-
PRICE
-
PROMOTION
-
AD_IMAGE
-
LEAD_FORM
-
BUSINESS_LOGO
-
Архивированные примечания к выпуску
Архивные примечания к выпуску см. в разделе «Версии с прекращением действия» .