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

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

Прежде чем начать, убедитесь, что у вас есть проект Google Cloud, одобренный для доступа к рабочей версии. Подробнее об уровнях доступа и допустимом использовании…

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

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

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)

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

• Бюджет кампании
• Кампания
• Критерии кампании
• Группа геотаргетинга (AssetSet и AssetSetAsset)
• Набор объектов кампании
• Группы объектов
• Сигналы групп объектов

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

CampaignBudget (СОЗДАТЬ)

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

• 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 (СОЗДАТЬ)

Свяжите кампанию с набором объектов 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 (СОЗДАТЬ)

Настройте группу объектов местных услуг. В отличие от стандартных кампаний с максимальной эффективностью, в группах объектов кампаний с максимальной эффективностью для местных услуг не требуются ресурсы 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 (не более шести уточнений на группу объектов) с callout_id.

AssetGroupSignal (СОЗДАТЬ)

В отличие от стандартных кампаний с максимальной эффективностью, в которых сигналы необязательны, в кампаниях с максимальной эффективностью для Местных услуг требуется хотя бы один 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, а для других требуется управление через интерфейс.

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

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

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

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

Поддерживается только США (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. Подробнее об автоматическом создании целей конверсий…