Google Одобренный исполнение 16 API Google Рекламы вчера. Обновление включает дополнительные типы рекомендаций, поддержку временных сегментов, поддержку проверки рекламодателей и многое другое.

Это крупное обновление с момента последнего обновления версии 15 в октябре 2023 года. До этого была версия 14.1, выпущенная в августе. Этой новой версии предшествовала версия 13.1, выпущенная в апреле 2023 года. Версия 12.0 была выпущена в октябре 2022 года, версия 11.0 Google Ads API — в июне, а версия 11.1 — в августе. Кроме того, версия 10.1 была выпущена 27 апреля 2022 г., а версия 10.0 — 9 февраля 2022 г. А 27 апреля Google закрыл API AdWords, который полностью перестанет работать в конце июля.

Вот релизное видео для версии 15:

Вот примечания к выпуску для Версия 16:

Управление аккаунтом:

• Advertising_partner перенесен из AccountLink в ProductLink и ProductLinkInvitation.
• data_partner и google_ads были удалены из AccountLink.
• Добавлен IdentityVerificationService для управления проверкой рекламодателей. StartIdentityVerification() используется для запуска сеанса проверки с помощью предоставленной программы проверки. Он создает новый сеанс проверки и возвращает пустой ответ для успешно созданной проверки. Добавлена ​​программа IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION. GetIdentityVerification() можно использовать для получения проверочной информации, возвращая несколько объектов IdentityVerification. Каждая проверка личности включает в себя: «Verification_program», обозначающую тип программы проверки личности, «Identity_verification_requirement», содержащую сведения о крайнем сроке, к которому рекламодатель должен завершить проверку; «Verification_progress» содержит подробную информацию о сеансе проверки, в том числе: «Program_status» представляет текущий статус этого сеанса проверки, «action_url» направляет клиента на URL-адрес для завершения проверки. Invitation_link_expiration_time представляет дату истечения срока действия action_url; Перечисления: IdentityVerificationProgram, IdentityVerificationProgramStatus; Ошибка: IdentityVerificationError,
• Добавлен AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT.

Финансовые активы:

• Изменения в assets_group: добавлена ​​поддержка сегментов, связанных со временем, таких как сегменты.год и сегменты.месяц.
• Изменения в assets_group: Campaign стала атрибутируемым ресурсом, а не ресурсом сегментации.

Кампании:

• Изменения в кампаниях по созданию спроса: добавлена ​​поддержка настройки Campaign.shopping_setting для существующей кампании по созданию спроса. Добавлен ShoppingSetting.disable_product_feed для отключения дополнительного фида товаров в кампаниях по формированию спроса. Добавлен Ad.demand_gen_product_ad и соответствующий DemandGenProductAdInfo, доступный для кампаний по формированию спроса с ненулевым Campaign.shopping_setting.
• В группу объявлений добавлены следующие поля, чтобы указать, активна ли группа объявлений или почему она не работает: 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 для отображения дел, чтобы обеспечить возможность создания групп списков на основе штата и города, в котором доступна туристическая деятельность: Activity_state и Activity_city.
• В travel_activity_ Performance_view добавлена ​​поддержка следующих сегментов: сегменты.активность_город, сегменты.активность_страна и сегменты.активность_состояние.

Местные службы:

• LocalServicesVerificationArtifact.business_registration_check_verification_artifact и BusinessRegistrationCheckArtifact были добавлены, чтобы рекламодатели могли отслеживать ход процесса проверки регистрации компании.
• Был добавлен новый ресурс local_services_employee, позволяющий рекламодателям получать добавленную ими информацию о сотрудниках.

Планирование:

• Оценка удалена из AudienceInsightsAttributeMetadata.

Рекомендации:

• Добавлена ​​РекомендацияService.GenerateRecommendations(), которая возвращает рекомендации на основе указанных настроек, например. Б. Типы рекомендаций и типы рекламных каналов. Это особенно полезно при создании кампаний.
• Добавлена ​​рекомендацияMetrics.conversions_value.
• Для рекомендуемых ключевых слов с неуказанным типом соответствия ключевого слова для параметра «рекомендуемый_тип_соответствия» теперь установлено значение «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_ALL OWED, MULTIPLE_WEBPAGE_TYPES _PER_ASSET_GROUP, PAGE_FEED_FILTER_HAS_PARENT

Цели жизненного цикла:

• Добавлено обновление для CustomerLifecycleGoalOperation и CampaignLifecycleGoalOperation, чтобы эти типы операций соответствовали другим типам операций в API.

Обсуждение на форуме ниже Икс.