v17.1.0 (07.08.2024)
Следующие новые функции и обновления были добавлены в версию 17_1.
Ресурсы
-
AdGroupAdService.RemoveAutomaticallyCreatedAssets()
позволяет удалить указанные автоматически созданные объекты, связанные с адаптивными поисковыми объявлениями .
Аудитории
- Новые значения перечисления в
UserListCustomerTypeCategory
:-
LOYALTY_TIER_1_MEMBERS
-
LOYALTY_TIER_2_MEMBERS
-
LOYALTY_TIER_3_MEMBERS
-
LOYALTY_TIER_4_MEMBERS
-
LOYALTY_TIER_5_MEMBERS
-
LOYALTY_TIER_6_MEMBERS
-
LOYALTY_TIER_7_MEMBERS
-
Кампании
-
ShareablePreviewService.GenerateShareablePreviews()
генерирует URL-адреса (shareable_preview_url
в ответе) для совместного предварительного просмотра объявлений для включенных и приостановленных групп активов .- Поле
expiration_date_time
указывает дату истечения срока действия URL-адресов в ответе. - В случае возникновения ошибки метод вернет
partial_failure_error
вместо URL-адресов.
- Поле
История изменений
- Новый тип ресурса статуса изменения:
ASSET_GROUP
.
Конверсии
- Новое поле сегмента для версии SKAdNetwork :
segments.sk_ad_network_version
. -
offline_conversion_upload_conversion_action_summary
, который предоставляет диагностику загрузки конверсий на уровне действия-конверсии . - В отчеты об автономной диагностике добавляются следующие показатели, чтобы показать количество загруженных конверсий, которые все еще обрабатываются:
Планирование
-
AudienceInsights.GenerateAudienceOverlapInsights()
, который принимает входной основной атрибут и набор атрибутов аудитории и возвращает оценки перекрытия потенциального охвата YouTube между основным атрибутом и атрибутами аудитории.
Составление отчетов
- Поддержка сегментации
per_store_view
на основеsegments.date
Видео
- Поддержка получения информации, связанной со следующими стандартными стратегиями назначения ставок для видеокампаний, с использованием отчетов, таких как
ad_group
,campaign
:-
Campaign.fixed_cpm
(Фиксированная цена за тысячу показов (стоимость за тысячу показов)) -
Campaign.target_cpv
(Целевая цена за просмотр (стоимость за просмотр))
-
-
Campaign.video_campaign_settings
, который позволяет вам определить, на каких ресурсах можно показывать видеорекламу, используя следующие поля отчета: -
segments.ad_format_type
, который позволяет сегментировать следующие отчеты по типу формата видеообъявления:
v17 (05.06.2024)
Следующие функции и изменения были добавлены в v17.
Объявления
- Удален
AdService.getAd
. Это приводитAdService
в соответствие с другими сервисами Google Ads API. Рекомендуемый способ получения рекламы и других типов ресурсов см. в разделе «Извлечение объектов». - Добавлены дополнительные проверки для
ImageAdInfo.image_asset
относительно размеров и формата. Если изображение недействительно, могут возникнуть следующие ошибки:
Ресурсы
- Добавлено новое перечисление:
ClickType.AD_IMAGE
- Добавлены следующие новые отчеты с новыми показателями для кампаний с максимальной эффективностью и кампаний в поисковой сети:
Аудитории
Пакетные задания
- Добавлен
BatchJobError.REQUEST_TOO_LARGE
, который будет выдан, если отправленныйAddBatchJobOperationsRequest
превышает 10484504 байта. - Добавлена поддержка настройки
MutateOperation.asset_group_operation
при использованииBatchJobService
. Это позволяет использовать пакетную обработку для создания целых кампаний с максимальной эффективностью и управления ими. См. наше новое специальное руководство .
Кампании
- Обнаружение переименовано в Генерирование спроса во всех полях, перечислениях и ошибках всех ресурсов в API Google Рекламы, таких как кампании, объявления и активы. Например,
AdvertisingChannelType.DISCOVERY
теперь называетсяAdvertisingChannelType.DEMAND_GEN
. - Добавлен
Campaign.keyword_match_type
, позволяющий установить тип соответствия ключевых слов для всех ключевых слов в кампании.
Конверсии
- Для конверсий SKAdNetwork
-
segments.sk_ad_network_conversion_value
переименованы вsegments.sk_ad_network_fine_conversion_value
. - Добавлен
segments.sk_ad_network_redistributed_fine_conversion_value
.
-
- Следующие метрики теперь возвращаются вместе с ответом, даже если они равны нулю. Это делает их совместимыми с другими показателями.
Критерии
- В следующие поля
AdGroupCriterion
добавлено, чтобы показать, выполняется ли критерий группы объявлений или причины, по которым он не показывается:-
primary_status
-
primary_status_reasons
-
- Добавлена поддержка
metrics.search_impression_share
дляgender_view
- Добавлена поддержка
metrics.phone_calls
дляkeyword_view
Местные услуги
- Добавлен
LocalServicesLeadService.AppendLeadConversation()
используемый для добавления новогоLocalServicesLeadConversation
кLocalServicesLead
, который отправляет сообщения пользователям через соответствующие каналы, такие как SMS, в зависимости от того, как был создан интерес.- Размер
AppendLeadConversationRequest.conversations
ограничен 1000. - В
Conversation.local_services_lead
можно указать толькоLocalServicesLead
сlead_type
установленным вLeadType.MESSAGE
.
- Размер
- Добавлены новые значения перечисления в
ConversationType
:-
WHATSAPP
для представления разговора, начатого через WhatsApp. -
ADS_API
для представления диалога, введенного с помощью нового методаLocalServicesLeadService.AppendLeadConversation()
.
-
- В
local_services_verification_artifact
добавлены следующие новые поля:-
local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
-
local_services_verification_artifact.license_verification_artifact.expiration_date_time
-
Составление отчетов
- Теперь при запросе
product_link
можно выбирать только поля, относящиеся к одному связанному продукту . Выбор нескольких полей нескольких связанных продуктов приведет к возникновению ошибкиQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
. Например,product_link.advertising_partner.customer
иproduct_link.data_partner.data_partner_id
не могут быть выбраны в одном запросе. - Передача
page_size
вGoogleAdsService.Search
приведет к ошибкеRequestError.PAGE_SIZE_NOT_SUPPORTED
.
Покупка
- Добавлен новый отчет
shopping_product
, который соответствует странице «Товары» в пользовательском интерфейсе Google Рекламы. Он поддерживает возврат данных о текущем состоянии продуктов из учетных записей Google Merchant Center, связанных с учетной записью Google Рекламы.- Вы можете фильтровать показатели из отчета
shopping_product
, используяsegments.date
при использованииGoogleAdsService.Search
илиGoogleAdsService.SearchStream
. Сегментация по дате не разрешена. В результате будет возвращена ошибкаShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- Вы можете фильтровать показатели из отчета
Единые цели
- Добавлен
UserListCustomerTypeService.MutateUserListCustomerTypes()
для настройки типов клиентов аудитории . - Удален
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
. Чтобы настроить параметры аудитории для целей жизненного цикла клиента, используйте вместо этогоUserListCustomerTypeService.MutateUserListCustomerTypes()
.- Прикрепите или отсоедините список пользователей, задав для
UserListCustomerType.customer_type_category
значениеUserListCustomerTypeCategory.PURCHASERS
, чтобы включить его в существующее определение клиента или исключить из него для целей жизненного цикла клиента соответственно. Посетите раздел «Сегментируйте свою аудиторию», чтобы получить более подробную информацию.
- Прикрепите или отсоедините список пользователей, задав для
Видео
- В
ContentLabelType
добавлены следующие значения. Вы можете исключить этиContentLabelTypes
на уровне клиента:-
BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
-
BRAND_SUITABILITY_GAMES_FIGHTING
-
BRAND_SUITABILITY_GAMES_MATURE
-
BRAND_SUITABILITY_HEALTH_SENSITIVE
-
BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
-
BRAND_SUITABILITY_NEWS_RECENT
-
BRAND_SUITABILITY_NEWS_SENSITIVE
-
BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
-
BRAND_SUITABILITY_POLITICS
-
BRAND_SUITABILITY_RELIGION
-
- Добавлен
AdVideoAsset.ad_video_asset_info
для поддержки настроек инвентаря для видеоресурсов при созданииDemandGenVideoResponsiveAdInfo
. - (Только учетные записи из белого списка)
Campaign.video_brand_safety_suitability
стал изменяемым.
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.
v15 (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
.
- Добавлен
Архивированные примечания к выпуску
Архивные примечания к выпуску см. в разделе «Версии с прекращением действия» .