Google выпустила версию 12.0 Google Ads API. Версия 11.0 Google Ads API была выпущена в июне, а версия 11.1 — в августе. Версия 12.0 — это крупное обновление.

Также 27 апреля 2022 г. была выпущена версия 10.1, а 9 февраля 2022 г. — версия 10.0. А 27 апреля Google прекратил работу API AdWords, который полностью перестанет работать в конце июля.

Google опубликовано видео махорских изменений в 12.0:

Вот все анонсированное в версии 12.0:

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

  • Добавлен новый тип привязки учетной записи ADVERTISING_PARTNER для привязки учетной записи клиента к другой. Это подготовка к предстоящей функции в следующем выпуске.

  • Добавлена ​​ошибка AccountLinkError.PERMISSION_DENIED для случая, когда пользователь без прав администратора пытается создать ссылку на учетную запись.

Объявления

  • Удалена поддержка создания нового объявления Gmail. Вместо этого используйте кампании Discovery.

Ресурсы

  • Добавлена ​​поддержка получения CustomLeadFormSubmissionField через LeadFormSubmissionData с помощью GoogleAdsService.SearchStream или GoogleAdsService.Search.

  • Добавлена ​​поддержка добавления, обновления и удаления CampaignAsset и AdGroupAsset с field_type как AD_IMAGE (только для клиентов из белого списка).

  • Вы можете получить статистику для изображений (asset_field_type_view.field_type = AD_IMAGE) с помощью отчета assets_field_type_view.

  • Отчет assets_set_asset теперь поддерживает метрики и сегменты.

  • Добавлено поле ad_group_ad_asset_view.pinned_field, позволяющее фильтровать по закрепленному ресурсу.

  • В отчет ad_group_ad_asset_view добавлена ​​поддержка segment.conversion_action.

  • Добавлена ​​поддержка связывания клиентов и групп объявлений с наборами активов только для тестовых аккаунтов.

  • CustomerAssetSetService для добавления/обновления/удаления CustomerAssetSet, который представляет собой связь между Customer и AssetSet.

  • AdGroupAssetSetService для добавления/обновления/удаления AdGroupAssetSet, который представляет собой связь между AdGroup и AssetSet.

    • Добавлена ​​поддержка изменения и извлечения активов местоположения только для тестовых учетных записей.

  • Поля:

  • Добавлен Asset.location_asset, тип которого — LocationAsset.

  • В AssetSet добавлены следующие поля:

  • location_group_parent_asset_set_id

  • assets_set_source (одно из полей)

  • location_set (используйте с CustomerAssetSet)

  • business_profile_location_group (используйте с CampaignAssetSet и AdGroupAssetSet)

  • chain_location_group (используйте с CampaignAssetSet и AdGroupAssetSet)

  • Добавлены exclude_parent_asset_set_types в Campaign и AdGroup.

  • Перечисления:

  • Добавлен AssetType.LOCATION.

  • В AssetSetType добавлены следующие значения:

  • LOCATION_SYNC

  • BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP

  • CHAIN_DYNAMIC_LOCATION_GROUP

  • STATIC_LOCATION_GROUP

  • Отчеты (доступны для всех аккаунтов):

  • per_store_view возвращает статистику на уровне идентификатора места.

  • assets_set_type_view возвращает статистику на уровне AssetSetType, который в настоящее время поддерживает только набор активов местоположения.

Аудитории

  • В OfflineUserDataJobFailureReason добавлены следующие значения: HIGH_AVERAGE_TRANSACTION_VALUE, LOW_AVERAGE_TRANSACTION_VALUE, NEWLY_OBSERVED_CURRENCY_CODE.

Торги

  • Добавлена ​​поддержка связанных пакетных стратегий назначения ставок и бюджета кампании. Стратегии назначения ставок и бюджеты кампаний могут изменять эти ссылки с помощью массовых изменений:

  • BiddingStrategy.aligned_campaign_budget_id

  • CampaignBudget.aligned_bidding_strategy_id

Выставление счетов

  • Добавлен AccountSummary как Invoice.account_summaries.[] для отчета о сверке (только для клиентов из белого списка).

  • Добавлен BillingSetupError.TOO_MANY_BILLING_SETUPS_FOR_PAYMENTS_ACCOUNT.

  • Добавлен AccountBudgetProposalError.INVALID_MASTER_SERVICE_AGREEMENT.

Кампании

  • Изменения в умных кампаниях:

  • Обновлен SmartCampaignSuggestService.SuggestKeywordThemes, чтобы генерировать больше предложений тем ключевых слов для умных кампаний и в некоторых случаях предлагать темы ключевых слов в произвольной форме.

  • Улучшена обработка ошибок и добавлено больше кодов ошибок для SmartCampaignSuggestService.SuggestKeywordThemes.

  • Удалена поддержка создания новых умных кампаний в контекстно-медийной сети. Существующие умные кампании в контекстно-медийной сети по-прежнему работают как обычно.

  • OperationAccessDeniedError.CREATE_OPERATION_NOT_PERMITTED возникает, если вы пытаетесь создать новую умную кампанию в контекстно-медийной сети.

  • В кампанию добавлены следующие поля:

  • primary_status, чтобы понять, почему кампания не работает или работает неоптимально.

  • primary_status_reasons, чтобы указать причины, по которым кампания не работает или работает неоптимально. Эти причины объединяются для определения primary_status.

  • Включено добавление и удаление таргетинга на местоположение в кампаниях местных услуг, за исключением таргетинга на близость.

  • Добавлены следующие ошибки в CampaignCriterionError для локальных сервисных кампаний:

  • AT_LEAST_ONE_POSITIVE_LOCATION_REQUIRED_FOR_LOCAL_SERVICES_CAMPAIGN

  • CANNOT_ADD_OR_REMOVE_LOCATION_FOR_LOCAL_SERVICES_CAMPAIGN

  • CANNOT_TARGET_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN

  • LOCATION_INVALID_FOR_LOCAL_SERVICES_CAMPAIGN

  • LOCATION_NOT_IN_HOME_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN

  • LOCATION_NOT_LAUNCHED_FOR_LOCAL_SERVICES_CAMPAIGN

Конверсии

  • convert_tracking_id всегда будет > 0 для всех клиентов. Раньше это поле могло быть равно 0 для клиентов, которые раньше не создавали никаких действий-конверсий.

  • Добавлен параметр debug_enabled для выполнения всех проверок и возврата ошибок, если они обнаружены при загрузке расширенных конверсий.

Критерии

  • В LocationGroupInfo для тестовых аккаунтов добавлены следующие поля набора активов:

  • enable_customer_level_location_asset_set

  • location_group_asset_sets

  • В CriterionError добавлены следующие значения:

  • CANNOT_SET_ASSET_SET_FIELD_FOR_CUSTOMER

  • CANNOT_SET_ASSET_SETS_WITH_FEED_ITEM_SETS

  • CANNOT_SET_BOTH_ASSET_SET_AND_FEED

  • CANNOT_SET_FEED_OR_FEED_ITEM_SETS_FOR_CUSTOMER

  • CANNOT_SET_GEO_TARGET_CONSTANTS_WITH_ASSET_SETS

  • INVALID_LOCATION_GROUP_ASSET_SETS

Ошибки

  • Коды ошибок, возвращаемые для некоторых недопустимых операций, изменились для следующих полей.
  • BiddingStrategy.currency_code
  • BiddingStrategy.scheme
  • BiddingStrategy.type
  • TargetCpa.target_cpa_micros
  • TargetImpressionShare.cpc_bid_ceiling_micros
  • TargetSpend.target_spend_micros (устарело)

Эксперименты

  • Служба CampaignExperimentService удалена в пользу ранее добавленных новых экспериментов. ExperimentArm.trial переименован в ExperimentArm.experiment.

  • Когда вы создаете новую экспериментальную группу с помощью MutateExperimentArms и устанавливаете для response_content_type вашего запроса на изменение значение MUTABLE_RESOURCE, теперь он также заполняет значения в ExperimentArm.in_design_campaigns.

Фиды

  • Добавлено LEGACY_FEED_TYPE_READ_ONLY в следующие перечисления: CampaignFeedError, FeedItemError, FeedMappingError.

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

  • AudienceInsightsService.ListAudienceInsightsAttributes теперь принимает AudienceInsightsDimension.GEO_TARGET_COUNTRY и AudienceInsightsDimension.SUB_COUNTRY_LOCATION, что позволяет клиентам обнаруживать критерии местоположения, которые можно использовать в AudienceInsightsService.

  • Добавлен AudienceInsightsService.ListInsightsEligibleDates (доступно только для учетных записей из белого списка), позволяющий клиентам обнаруживать набор диапазонов дат, которые можно использовать в AudienceInsightsService.

  • Удалено GenerateProductMixIdeas из ReachPlanService.

  • Добавлен Targeting.plannable_location_ids, который поддерживает таргетинг на несколько географических местоположений в одном и том же родительском местоположении в одном прогнозе охвата.

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

  • Добавлена ​​рекомендация RaiseTargetCpaBidTooLowRecommendation, которая определяет корректировки целевой цены за конверсию, чтобы помочь кампаниям начать показ.

  • Добавлена ​​рекомендация ForecastingSetTargetRoasRecommendation, которая определяет корректировки целевой рентабельности инвестиций для получения дополнительной ценности конверсии за счет ожидаемого увеличения трафика.

Составление отчетов

  • Добавлена ​​поддержка возврата количества кликов для дополнительных ссылок (когда segments.click_type = SITELINKS) в отчете Landing_Page_view.

  • Добавлены следующие метрики купленного трафика: metrics.publisher_purchased_clicks, metrics.publisher_organic_clicks, metrics.publisher_unknown_clicks.

Обсуждение форума на Твиттер.





Source link

ЧИТАТЬ  Волатильность поискового рейтинга Google снова возросла (28-29 июня)