Кампании с максимальной эффективностью для целей по плате за запрос от клиента

Кампании с максимальной эффективностью с целями по плате за запрос от клиента помогают местным компаниям привлекать клиентов. В таких кампаниях показывается реклама местных услуг, поэтому они также называются кампаниями с максимальной эффективностью для рекламы местных услуг. Они настраиваются с помощью полей и сервисов local_services_* в Google Ads API. При такой настройке расходы на маркетинг нацелены на прямое взаимодействие. Плата взимается не после клика по объявлению, а только если потенциальный клиент связывается с вами непосредственно через него.

Прежде чем начать, убедитесь, что у вас есть активный токен разработчика со стандартным доступом. Дополнительную информацию можно найти в кратком руководстве.

Рабочий процесс создания кампании

Чтобы создать кампанию с максимальной эффективностью и целями по плате за запрос от клиента, выполните следующие действия:

  1. Выполните предварительные требования на уровне аккаунта
  2. Как получить данные о компании и объекте адреса из профиля компании в Google
  3. Создание ресурсов кампании за один раз (GoogleAdsService.Mutate)
  4. Включите кампанию и подтвердите данные о компании

Выполните требования на уровне аккаунта

Если вы создаете кампании для существующего аккаунта Google Рекламы, выполните следующие предварительные требования в аккаунте, прежде чем создавать кампанию. Если вы одновременно создаете новый аккаунт Google Рекламы, выполните следующие действия, прежде чем создавать кампанию:

  1. Примите Условия использования (только в интерфейсе Google Рекламы). Вы должны принять Условия использования Рекламы местных услуг на странице настроек аккаунта Google Рекламы. Это соглашение нельзя принять программно через API. Если вы создадите или включите кампанию, не приняв соглашение, то получите ошибку CampaignError.LOCAL_SERVICES_AGREEMENT_REQUIRED.
  2. Связь с профилем компании в Google (интерфейс или API Google Рекламы). Свяжите профиль компании с аккаунтом Google Рекламы (в интерфейсе Google Рекламы выберите Менеджер данных > Связанные аккаунты или сделайте это программно, используя AssetSet типа LOCATION_SYNC). Обратите внимание, что создание AssetSet типа LOCATION_SYNC не активирует синхронизацию адресов для аккаунта. Вам также нужно связать его с клиентом, используя CustomerAssetSet (CustomerAssetSetService.MutateCustomerAssetSets), и предоставить http_authorization_token OAuth 2.0 с областью действия https://www.googleapis.com/auth/business.manage. Подробнее о том, как создать набор объектов синхронизации адресов и связать его с клиентом… Адреса компании будут синхронизированы с аккаунтом Google Рекламы в качестве объектов LOCATION.

Как получить данные о профиле компании в Google и объекте адреса

Запросите ресурс asset с помощью GoogleAdsService.Search, используя объекты LOCATION, синхронизированные после связывания профиля компании в Google в разделе Выполните предварительные требования на уровне аккаунта.

Запрос получает listing_id профиля компании в Google, необходимый для настроек кампании, и asset.resource_name, необходимый для связи с STATIC_LOCATION_GROUP кампании AssetSet с помощью AssetSetAsset:

SELECT
  asset.id,
  asset.name,
  asset.location_asset.place_id,
  asset.location_asset.business_profile_locations
FROM asset
WHERE asset.type = 'LOCATION'

Создание ресурсов кампании атомарно (GoogleAdsService.Mutate)

В кампаниях с целями по плате за запрос от клиента используются следующие ресурсы:

Учитывая особые требования к настройке кампаний с целями по плате за запрос от клиента, объедините все операции в один атомарный запрос GoogleAdsService.Mutate, чтобы предотвратить неполную настройку и обеспечить целостность транзакций.

CampaignBudget (CREATE)

Укажите дневной бюджет кампании:

  • amount_micros – сумма дневного бюджета в микроединицах.
  • delivery_method: STANDARD.
  • explicitly_shared: должно быть задано значение false. В кампаниях с максимальной эффективностью нельзя использовать общие бюджеты.

Campaign (СОЗДАТЬ)

В аккаунте клиента может быть только одна неудаленная кампания с максимальной эффективностью для местных услуг. При попытке создать вторую возвращается ошибка CampaignError.LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED.

  • name – обязательное название кампании.
  • campaign_budget – временное название ресурса CampaignBudget, созданного в том же запросе.
  • advertising_channel_type: должно быть задано значение PERFORMANCE_MAX.
  • brand_guidelines_enabled: должно быть задано значение false. В отличие от стандартных кампаний с максимальной эффективностью, в которых по умолчанию используется brand_guidelines_enabled = true и требуется связывание ресурсов BUSINESS_NAME и LOGO CampaignAsset, в кампаниях с максимальной эффективностью для Местных услуг задается brand_guidelines_enabled = false.
  • pmax_campaign_settings.local_services_enabled – должно быть задано значение true (неизменяемое логическое значение, которое нельзя изменить после создания).
  • pmax_campaign_settings.local_services_pmax_campaign_settings:
    • country_code – обязательный двухбуквенный код страны по стандарту ISO-3166 ('US'). Проверяется при создании.
    • listing_id – обязательный числовой идентификатор адреса поставщика в профиле компании в Google. Проверяется при создании кампании. Если идентификатор недействителен, возвращается ошибка CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID.
    • Необязательно. phone_numbers: повторяющееся сообщение LocalServicesPhoneNumber, в котором указаны специальные номера телефонов для отслеживания или номера телефонов компании (phone_number, country_code и GlsPhoneNumberType phone_number_type). Если этот параметр не указан, по умолчанию используется номер телефона из связанного профиля компании в Google. Если в профиле компании нет номера телефона, этот параметр обязателен. Поддерживаемые значения phone_number_type: DESTINATION_PHONE_NUMBER_FOR_ADS (для звонков от потенциальных клиентов) и DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY (необязательно, для SMS-уведомлений о сообщениях от потенциальных клиентов).
    • Необязательно: founding_year – год основания компании (например, 1998).
    • Необязательный параметр navigational_query_leads_enabled: логическое значение, указывающее, нужно ли получать лидов по навигационным брендированным запросам.
  • maximize_conversions: сообщение о необходимости настроить стратегию назначения ставок MAXIMIZE_CONVERSIONS (с необязательной target_cpa_micros). Стратегии "Целевая рентабельность инвестиций в рекламу" и назначение ставок вручную не поддерживаются.
  • status: при создании задайте значение PAUSED, пока не будут готовы группы объектов, сигналы и подтверждение данных о компании.

CampaignCriterion (СОЗДАТЬ)

Определите параметры таргетинга для кампании, объединив по одной операции на критерий и связав их с временным названием ресурса кампании:

  • Языковой таргетинг (language). В кампаниях для США строго применяется английский язык (languageConstants/1000). Другие языки отклоняются при изменении.
  • Геотаргетинг на территорию обслуживания (location). В кампаниях с максимальной эффективностью для местных услуг должен быть задан хотя бы один положительный критерий местоположения, определяющий территорию обслуживания. Если удалить все местоположения, возвращается ошибка CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN. Поддерживаются как положительные включения, так и исключения на уровне города, округа, почтового индекса или штата в пределах заявленной в кампании country_code (US). Таргетинг на уровне страны запрещен и отклоняется с ошибкой CampaignCriterionError.CANNOT_TARGET_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN. Чтобы сопоставить идентификаторы критериев с названиями, используйте GeoTargetConstantService.SuggestGeoTargetConstants, язык запросов Google Ads Query Language для запросов к geo_target_constant или справочную таблицу геотаргетинга Google Рекламы.
  • Необязательно. Планирование показа объявлений (ad_schedule). Если не указано, по умолчанию используется круглосуточный показ. Ограничьте показ с помощью ad_schedule критериев.

Группа геотаргетинга (AssetSet и AssetSetAsset) (СОЗДАТЬ)

Создайте AssetSet типа STATIC_LOCATION_GROUP, в котором для location_group_parent_asset_set_id задан идентификатор активного LOCATION_SYNC AssetSet аккаунта, и свяжите синхронизированный объект LOCATION с помощью AssetSetAsset.

Подробную информацию вы найдете в руководстве по объектам адресов.

CampaignAssetSet (CREATE)

Свяжите кампанию с набором объектов STATIC_LOCATION_GROUP. После того как связь будет установлена, ее нельзя будет изменить или удалить (AssetSetLinkError.ASSET_SET_LINK_CANNOT_BE_REMOVED).

Если задано значение partial_failure = false (по умолчанию для GoogleAdsService.Mutate), то при любой ошибке проверки в пакетных операциях вся транзакция откатывается атомарно. Применяются следующие три правила проверки CampaignAssetSet:

  1. С кампанией можно связать только один STATIC_LOCATION_GROUP AssetSet (AssetSetLinkError.DUPLICATE_ASSET_SET_LINK).
  2. В STATIC_LOCATION_GROUP может быть не более одного активного объекта LOCATION.
  3. Идентификатор связанного объекта LOCATION должен совпадать с campaign.pmax_campaign_settings.local_services_pmax_campaign_settings.listing_id (AssetSetLinkError.LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID).

AssetGroup (CREATE)

Настройте группу объектов местных услуг. В отличие от стандартных кампаний с максимальной эффективностью, в группах объектов кампаний с максимальной эффективностью для местных услуг не требуются ресурсы AssetGroupAsset (заголовки, описания или изображения) или final_urls.

  • name – обязательное название группы объектов.
  • campaign – временное название ресурса Campaign, созданного в том же запросе.
  • status: при создании необходимо задать значение ENABLED.
  • google_local_services_info.category_id – стандартный идентификатор категории, например xcat:service_area_business_plumber. Если указать неподдерживаемую категорию, возвращается ошибка AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY.
  • Необязательно. google_local_services_info.callouts: повторяющееся сообщение LocalServicesCallout (максимум 6 уточнений на группу объектов) с callout_id.

AssetGroupSignal (CREATE)

В отличие от стандартных кампаний с максимальной эффективностью, в которых сигналы необязательны, в кампаниях с максимальной эффективностью для Местных услуг требуется хотя бы один local_services_id AssetGroupSignal на группу объектов (если удалить все сигналы, возвращается AssetGroupSignalError.CANNOT_REMOVE_ALL_SIGNALS).

local_services_id – это сообщение LocalServiceIdInfo, в котором вы указываете в поле local_services_id.service_id действительный идентификатор типа задания (например, {"local_services_id": {"service_id": "install_faucet"}}). Ресурсы AssetGroupSignal являются неизменяемыми (только CREATE и REMOVE, без UPDATE).

Пример атомарного запроса mutate

В следующем примере REST JSON показано, как объединить все операции в один запрос POST /v26/customers/{customer_id}/googleAds:mutate с использованием временных названий ресурсов:

{
  "mutateOperations": [
    {
      "campaignBudgetOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/campaignBudgets/-1",
          "name": "Local Services PMax Budget",
          "amountMicros": "50000000",
          "deliveryMethod": "STANDARD",
          "explicitlyShared": false
        }
      }
    },
    {
      "campaignOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/campaigns/-2",
          "name": "Local Services PMax Campaign",
          "advertisingChannelType": "PERFORMANCE_MAX",
          "status": "PAUSED",
          "campaignBudget": "customers/{customer_id}/campaignBudgets/-1",
          "brandGuidelinesEnabled": false,
          "maximizeConversions": {},
          "pmaxCampaignSettings": {
            "localServicesEnabled": true,
            "localServicesPmaxCampaignSettings": {
              "countryCode": "US",
              "listingId": "123456789",
              "phoneNumbers": [
                {
                  "phoneNumber": "+18005550100",
                  "countryCode": "US",
                  "phoneNumberType": "DESTINATION_PHONE_NUMBER_FOR_ADS"
                }
              ],
              "foundingYear": "1998",
              "navigationalQueryLeadsEnabled": true
            }
          }
        }
      }
    },
    {
      "campaignCriterionOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "language": {
            "languageConstant": "languageConstants/1000"
          }
        }
      }
    },
    {
      "campaignCriterionOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "location": {
            "geoTargetConstant": "geoTargetConstants/1014221"
          }
        }
      }
    },
    {
      "campaignCriterionOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "adSchedule": {
            "dayOfWeek": "MONDAY",
            "startHour": 9,
            "startMinute": "ZERO",
            "endHour": 17,
            "endMinute": "ZERO"
          }
        }
      }
    },
    {
      "assetSetOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/assetSets/-3",
          "name": "Local Services Location Group",
          "type": "STATIC_LOCATION_GROUP",
          "locationGroupParentAssetSetId": "LOCATION_SYNC_ASSET_SET_ID"
        }
      }
    },
    {
      "assetSetAssetOperation": {
        "create": {
          "assetSet": "customers/{customer_id}/assetSets/-3",
          "asset": "customers/{customer_id}/assets/LOCATION_ASSET_ID"
        }
      }
    },
    {
      "campaignAssetSetOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "assetSet": "customers/{customer_id}/assetSets/-3"
        }
      }
    },
    {
      "assetGroupOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/assetGroups/-4",
          "campaign": "customers/{customer_id}/campaigns/-2",
          "name": "Local Services Plumbing Asset Group",
          "status": "ENABLED",
          "googleLocalServicesInfo": {
            "categoryId": "xcat:service_area_business_plumber",
            "callouts": [
              {
                "calloutId": "family_owned"
              }
            ]
          }
        }
      }
    },
    {
      "assetGroupSignalOperation": {
        "create": {
          "assetGroup": "customers/{customer_id}/assetGroups/-4",
          "localServicesId": {
            "serviceId": "install_faucet"
          }
        }
      }
    }
  ]
}

Автоматическое создание целей конверсий

Цели конверсий автоматически предоставляются и управляются серверной частью на основе соответствия аккаунта и партнера требованиям. Вам не нужно передавать операции с целями конверсий во время первоначального создания атомарной кампании.

В кампаниях местных услуг можно использовать только поддерживаемые категории конверсий в лидов. При попытке настроить другие цели возвращается ошибка CampaignConversionGoalError.GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN. Кроме того, в кампаниях для локальных услуг необходимо использовать цели, переопределяющие цели на уровне кампании. Если отключить их, возвращается ошибка ConversionGoalCampaignConfigError.CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN.

  • Кампании без купонов:
    • PHONE_CALL_LEAD (LOCAL_SERVICES_ADS): автоматически связывается как активная цель по умолчанию, доступная для назначения ставок (biddable = true), при создании кампании. Эта цель является обязательной и не может иметь значение biddable = false (в противном случае возвращается ошибка CampaignConversionGoalError.CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN).
    • MESSAGE_LEAD (LOCAL_SERVICES_ADS) – автоматически создается на уровне аккаунта, но по умолчанию отключено на уровне кампании (biddable = false). Чтобы включить текстовые запросы от клиентов (при создании или позже), измените цель конверсии кампании customers/{customer_id}/campaignConversionGoals/{campaign_id}~MESSAGE_LEAD~LOCAL_SERVICES_ADS на biddable = true с помощью CampaignConversionGoalOperation.
    • BOOK_APPOINTMENT (LOCAL_SERVICES_ADS): инициализируется и связывается с дочерним аккаунтом (biddable = true) асинхронно, как только в связанном адресе обнаруживается одобренный партнер Google сервиса "Забронировать через Google".
  • Кампании партнеров по купонам в точках продаж (Clover, Lightspeed, Express Oil):
    • CONVERTED_LEAD (LOCAL_SERVICES_ADS): автоматически связывается (использование офлайн-промоакции) как активная цель, доступная для назначения ставок, при создании. Кампании с партнерами по купонам оптимизируются только для цели CONVERTED_LEAD. В них нельзя использовать цели по лидам, связанные со звонками или сообщениями.

Включите кампанию и подтвердите данные о компании

  1. Активируйте кампанию. Измените статус кампании с PAUSED на ENABLED с помощью CampaignService.MutateCampaigns.
  2. Пройдите проверку на доверие и безопасность. Зарегистрируйте компанию, подтвердите личность, предоставьте лицензии и документы в интерфейсе Google Рекламы (Администратор > Правила). Показ объявлений начнется после завершения проверки.

Управление кампаниями с максимальной эффективностью и целями по плате за запрос от клиента и отчеты о них

Обзор доступности функций API

Хотя API позволяет партнерам управлять кампаниями в больших масштабах, он используется в сочетании с интерфейсом Google Рекламы для комплексного управления аккаунтами и кампаниями. Для некоторых путей клиента предлагается полная поддержка API, а для других требуется управление через интерфейс.

Функция Платформы и доступность Сведения
Создание аккаунта и кампании Полная поддержка API Поддерживается в GoogleAdsService.Mutate.
Настройки кампаний Полная поддержка API Поддерживается в CampaignService.MutateCampaigns.
Управление объектами Частичная поддержка API Загрузка изображений рекламодателем доступна только в интерфейсе.
Отчеты о политиках для объектов Полная поддержка API Запросите статусы правил через asset_group_asset.
Управление лидами и отчеты Полная поддержка API Запрашивайте лидов через local_services_lead и разговоры через local_services_lead_conversation. local_services_lead.campaign связывает записи о лидах с кампанией с максимальной эффективностью для местных услуг.
Лицензии Только в интерфейсе Выполнять задачи по проверке и просматривать статусы проверки можно только в интерфейсе (Администратор > Правила).
Настройте бюджет и назначение ставок Полная поддержка API Поддерживается MAXIMIZE_CONVERSIONS с необязательным target_cpa_micros.
Управление адресами Полная поддержка API Поддерживается через наборы объектов STATIC_LOCATION_GROUP.
Оплата и условия Только в интерфейсе Настроить платежную конфигурацию и принять Условия использования Рекламы местных услуг необходимо в интерфейсе Google Рекламы (Настройки аккаунта).

Сведения о полях данных

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

Ресурс Поле или компонент Изменяемый? Доступность и правила Местных услуг
Campaign name Да Название кампании (обязательно).
Campaign campaign_budget Да Название ресурса CampaignBudget, связанного с кампанией.
Campaign advertising_channel_type ТОЛЬКО СОЗДАНИЕ Необходимо указать следующее значение: PERFORMANCE_MAX. После создания изменить его нельзя.
Campaign pmax_campaign_settings.local_services_enabled ТОЛЬКО СОЗДАНИЕ Неизменяемое логическое значение. Чтобы включить функции и поведение Местных услуг, при создании необходимо задать значение true. Существующие стандартные кампании с максимальной эффективностью преобразовать нельзя.
Campaign pmax_campaign_settings.local_services_pmax_campaign_settings.country_code ТОЛЬКО СОЗДАНИЕ Обязательный двухбуквенный код страны по стандарту ISO. Строго соблюдается как 'US'. Значения, относящиеся к другим странам, отклоняются.
Campaign pmax_campaign_settings.local_services_pmax_campaign_settings.listing_id ТОЛЬКО СОЗДАНИЕ Обязательный числовой идентификатор профиля компании в Google, представляющий физический адрес поставщика. При создании кампании проверяется соответствие связанным объектам адресов.
Campaign pmax_campaign_settings.local_services_pmax_campaign_settings.phone_numbers Да Номера телефонов компании или номера для отслеживания звонков, связанные с кампанией, с помощью LocalServicesPhoneNumber. Если этот атрибут не указан, по умолчанию используется номер телефона из связанного профиля компании в Google. Если в профиле компании нет номера телефона, атрибут call_number является обязательным. Поддерживаемые значения GlsPhoneNumberType: DESTINATION_PHONE_NUMBER_FOR_ADS (для звонков от потенциальных клиентов) и DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY (необязательно, для SMS-уведомлений о сообщениях от потенциальных клиентов).
Campaign pmax_campaign_settings.local_services_pmax_campaign_settings.founding_year Да Год основания компании (например, 1998). Показывает значок доверия "Работает с…".
Campaign pmax_campaign_settings.local_services_pmax_campaign_settings.navigational_query_leads_enabled Да Необязательное логическое значение, указывающее, нужно ли получать лидов по навигационным запросам, в которых упоминается название вашей компании.
Campaign brand_guidelines_enabled ТОЛЬКО СОЗДАНИЕ Необходимо указать следующее значение: false. В отличие от стандартных кампаний с максимальной эффективностью, в кампаниях с максимальной эффективностью для местных услуг не используются правила фирменного оформления и объекты бренда на уровне кампании.
Campaign maximize_conversions Да Сообщение о необходимой стратегии назначения ставок. Настраивает MAXIMIZE_CONVERSIONS (с необязательным target_cpa_micros). Целевая рентабельность инвестиций в рекламу и назначение ставок вручную не поддерживаются.
Campaign bidding_strategy_type ТОЛЬКО ЧТЕНИЕ Поле Campaign, предназначенное только для вывода, автоматически заполнено значением MAXIMIZE_CONVERSIONS.
Campaign status Да Статус кампании (PAUSED, ENABLED, REMOVED). Рекомендуется использовать статус PAUSED, пока настройка не будет завершена.
CampaignBudget amount_micros Да Дневной бюджет кампании, заданный CampaignBudget.
CampaignBudget delivery_method Да Необходимо указать следующее значение: STANDARD.
CampaignBudget explicitly_shared ТОЛЬКО СОЗДАНИЕ Необходимо указать следующее значение: false. В кампаниях с максимальной эффективностью нельзя использовать общие бюджеты.
CampaignConversionGoal biddable Да Строго ограничено категориями конверсий в лидов для Местных услуг (PHONE_CALL_LEAD, MESSAGE_LEAD, BOOK_APPOINTMENT и CONVERTED_LEAD для партнеров по купонам в точках продаж; другие цели возвращают CampaignConversionGoalError.GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN). Для кампаний без купонов требуется PHONE_CALL_LEAD, и нельзя задать biddable = false (CampaignConversionGoalError.CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN). Отключение целей переопределения кампании возвращает ConversionGoalCampaignConfigError.CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN.
CampaignCriterion Языковой таргетинг (language / LANGUAGE) Да Критерий языка целевой аудитории. Для кампаний в США строго применяется английский язык (languageConstants/1000). Другие языки отклоняются при изменении.
CampaignCriterion Геотаргетинг (location / LOCATION) Да Геотаргетинг на уровне ниже национального (города, округа, медиарынки, почтовые индексы). Критерии должны находиться в стране кампании (US). Таргетинг на уровне страны (например, на все США) отклонен (CampaignCriterionError.CANNOT_TARGET_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN). В кампаниях с максимальной эффективностью для местных услуг должен быть хотя бы один положительный критерий местоположения (CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN).
CampaignCriterion Расписание показа объявлений (ad_schedule / AD_SCHEDULE) Да Собственное расписание показа объявлений (day_of_week, время начала и окончания). Если расписание не задано, показ будет выполняться круглосуточно.
AssetSet type = LOCATION_SYNC ТОЛЬКО СОЗДАНИЕ Набор объектов на уровне аккаунта, синхронизирующий адреса из профиля компании в Google с объектами LOCATION Google Рекламы. type нельзя изменить после создания.
AssetSet type = STATIC_LOCATION_GROUP ТОЛЬКО СОЗДАНИЕ Набор объектов, в который входит синхронизированный объект LOCATION, на который настроен таргетинг кампании. Требуется задать для location_group_parent_asset_set_id идентификатор набора объектов LOCATION_SYNC (type и location_group_parent_asset_set_id нельзя изменить после создания; для связей AssetSetAsset доступны только действия CREATE и REMOVE).
CampaignAssetSet Связь с набором объектов адресов ТОЛЬКО СОЗДАНИЕ Связывает STATIC_LOCATION_GROUP с кампанией. Принудительно откатывает транзакции: не более одной связи с группой адресов (AssetSetLinkError.DUPLICATE_ASSET_SET_LINK), не более одного активного объекта адреса, а идентификатор связанного объекта адреса должен совпадать с идентификатором кампании listing_id (AssetSetLinkError.LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID). Созданную связь нельзя удалить (AssetSetLinkError.ASSET_SET_LINK_CANNOT_BE_REMOVED).
AssetGroup name Да Название группы объектов (обязательно).
AssetGroup campaign ТОЛЬКО СОЗДАНИЕ Название ресурса Campaign, связанного с группой объектов.
AssetGroup status Да Статус группы объектов. При создании необходимо указать значение ENABLED.
AssetGroup google_local_services_info.category_id ТОЛЬКО СОЗДАНИЕ Стандартизированный идентификатор категории (например, xcat:service_area_business_plumber). Неизменяемый после создания. Проверяется по белому списку поддерживаемых отраслей (AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY).
AssetGroup google_local_services_info.callouts Да Стандартизированные теги уточнений для бизнеса, в которых используется повторяющийся символ LocalServicesCallout с callout_id. В группе объектов может быть не более шести уточнений. Должно соответствовать допустимым уточнениям для вертикали.
AssetGroupSignal local_services_id.service_id ТОЛЬКО СОЗДАНИЕ И УДАЛЕНИЕ Сигналы тем поиска, представляющие подробные предложения услуг в категории, с помощью LocalServiceIdInfo. В каждой группе объектов должен быть хотя бы один сигнал (AssetGroupSignalError.CANNOT_REMOVE_ALL_SIGNALS).
LocalServicesLead Записи о лидах и метаданные ТОЛЬКО ЧТЕНИЕ Данные о лидах, которые поставщик может запрашивать, включая тип лида, статус оплаты, статус кредита, временную метку создания и local_services_lead.campaign, связывающий лиды с кампанией.
LocalServicesLeadConversation Сведения о разговорах и записи ТОЛЬКО ЧТЕНИЕ Записи о взаимодействии с лидами, по которым можно выполнять запросы (длительность звонков, URL записей, текст сообщений).

Часто задаваемые вопросы

В каких странах доступны кампании с максимальной эффективностью и платой за запрос от клиента?

Поддерживается только США (US).

Как найти идентификатор профиля компании в Google?

Идентификатор адреса можно найти в интерфейсе профиля компании в Google или программно, запросив объекты LOCATION с помощью языка запросов Google Рекламы. Подробные инструкции и примеры запросов приведены в статье Как получить данные о компании из профиля компании в Google и объект адреса.

Как активировать лидов-купонов?

Лиды по купонам доступны только для некоторых партнеров по POS-терминалам (Clover, Lightspeed, Express Oil). Если вы хотите узнать больше, обратитесь к представителю Google.

Включены ли сообщения от клиентов по умолчанию?

PHONE_CALL_LEAD (LOCAL_SERVICES_ADS) включен по умолчанию. MESSAGE_LEAD (LOCAL_SERVICES_ADS) создается с biddable = false (отключено по умолчанию). Чтобы включить текстовые запросы от клиентов, измените цель конверсии кампании на biddable = true. Подробнее об автоматическом создании целей конверсий…