v17.1.0 (07.08.2024)
Следующие новые функции и обновления были добавлены в v17_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. ## Архивированные примечания к выпуску
Архивные примечания к выпуску см. в разделе «Версии с прекращением действия» .