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 года. А Google прекратил работу API AdWords 27 апреля, который полностью перестанет работать в конце июля.
Вот релизное видео для версии 15:
Вот примечания к выпуску для версия 16:
Управление аккаунтом:
- Рекламный_партнер перенесен из AccountLink в ProductLink и ProductLinkInvitation.
- Удалены data_partner и google_ads из AccountLink.
- Добавлен IdentityVerificationService для управления проверкой рекламодателей. StartIdentityVerification() используется для запуска сеанса проверки с использованием предоставленной программы проверки. Он создает новый сеанс проверки и возвращает пустой ответ для успешно созданной проверки. Добавлена программа IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION. GetIdentityVerification() можно использовать для получения проверочной информации, которая возвращает несколько объектов IdentityVerification. Каждая IdentityVerification включает в себя: Verification_program, который представляет собой тип программы проверки личности, Identity_verification_requirement, который содержит сведения, связанные со сроком, к которому рекламодатель должен завершить проверку. Verification_progress, который содержит сведения, связанные с сеансом проверки, включая: program_status представляет текущий статус этого сеанса проверки, направляет action_url. клиент на URL-адрес для завершения проверки. приглашение_link_expiration_time представляет дату истечения срока действия action_url; Перечисления: IdentityVerificationProgram, IdentityVerificationProgramStatus; Ошибки: IdentityVerificationError,
- Добавлен AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT.
Ресурсы:
- Изменения в assets_group: добавлена поддержка сегментов, связанных со временем, таких как elements.year и elements.month.
- Изменения в assets_group: кампания стала атрибутируемым ресурсом вместо сегментированного ресурса.
Кампании:
- Изменения в кампаниях по формированию спроса: добавлена поддержка настройки 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 для объявления «Что делать» добавлены следующие поля, позволяющие создавать группы объявлений на основе штата и города, где доступна туристическая деятельность: 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.
- Added the following types of recommendations: MAXIMIZE_CONVERSION_VALUE_OPT_IN which recommends opting in to the Maximize conversion value bidding strategy and IMPROVE_GOOGLE_TAG_COVERAGE which recommends deploying Google Tag on more pages PERFORMANCE_MAX_FINAL_URL_OPT_IN which recommends turning on final URL expansion for your Performance Max campaigns and REFRESH_CUSTOMER_MATCH_LIST which recommends updating a customer 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
Цели жизненного цикла:
- Добавлено обновление для CustomerLifecycleGoalOperation и CampaignLifecycleGoalOperation, чтобы эти типы операций соответствовали другим типам операций в API.
Обсуждение на форуме Икс.
