Начало работы

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

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

Настройте свой сайт для отслеживания конверсий

Если вы начинаете интеграцию импорта офлайн-конверсий, первым шагом будет выполнение шагов в руководстве Configure the Google tag for extended conversions for leads, чтобы настроить свой веб-сайт для отслеживания расширенных конверсий для лидов. Вы также можете использовать Google Tag Manager для настройки своего веб-сайта, выполнив шаги в руководстве Configure Google Tag Manager for extended conversions for leads .

Включите отслеживание конверсий в своем аккаунте конверсий Google Ads

Получите информацию о настройках отслеживания конверсий

Вы можете проверить настройки отслеживания конверсий вашего аккаунта и подтвердить, что отслеживание конверсий включено, запросив ресурс Customer для ConversionTrackingSetting . Выполните следующий запрос с помощью GoogleAdsService.SearchStream :

SELECT
  customer.conversion_tracking_setting.google_ads_conversion_customer,
  customer.conversion_tracking_setting.conversion_tracking_status,
  customer.conversion_tracking_setting.conversion_tracking_id,
  customer.conversion_tracking_setting.cross_account_conversion_tracking_id
FROM customer

Поле google_ads_conversion_customer указывает аккаунт Google Ads, который создает и управляет конверсиями для этого клиента. Для клиентов, использующих отслеживание конверсий между аккаунтами , это идентификатор управляющего аккаунта. Идентификатор клиента конверсии Google Ads должен быть указан как customer_id в запросах API Google Ads для создания и управления конверсиями. Обратите внимание, что это поле заполняется, даже если отслеживание конверсий не включено.

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

Создайте действие конверсии в клиенте конверсии Google Ads

Если значение conversion_tracking_status равно NOT_CONVERSION_TRACKED , отслеживание конверсий не включено для аккаунта. Включите отслеживание конверсий, создав хотя бы одно ConversionAction в аккаунте конверсий Google Ads, как в следующем примере. Кроме того, вы можете создать действие конверсии в пользовательском интерфейсе, следуя инструкциям в Справочном центре для типа конверсии, который вы хотите включить.

Обратите внимание, что расширенные конверсии включаются автоматически при отправке через API Google Ads, но их можно отключить через пользовательский интерфейс Google Ads.

Пример кода

Ява

private void runExample(GoogleAdsClient googleAdsClient, long customerId) {

  // Creates a ConversionAction.
  ConversionAction conversionAction =
      ConversionAction.newBuilder()
          // Note that conversion action names must be unique. If a conversion action already
          // exists with the specified conversion_action_name the create operation will fail with
          // a ConversionActionError.DUPLICATE_NAME error.
          .setName("Earth to Mars Cruises Conversion #" + getPrintableDateTime())
          .setCategory(ConversionActionCategory.DEFAULT)
          .setType(ConversionActionType.WEBPAGE)
          .setStatus(ConversionActionStatus.ENABLED)
          .setViewThroughLookbackWindowDays(15L)
          .setValueSettings(
              ValueSettings.newBuilder()
                  .setDefaultValue(23.41)
                  .setAlwaysUseDefaultValue(true)
                  .build())
          .build();

  // Creates the operation.
  ConversionActionOperation operation =
      ConversionActionOperation.newBuilder().setCreate(conversionAction).build();

  try (ConversionActionServiceClient conversionActionServiceClient =
      googleAdsClient.getLatestVersion().createConversionActionServiceClient()) {
    MutateConversionActionsResponse response =
        conversionActionServiceClient.mutateConversionActions(
            Long.toString(customerId), Collections.singletonList(operation));
    System.out.printf("Added %d conversion actions:%n", response.getResultsCount());
    for (MutateConversionActionResult result : response.getResultsList()) {
      System.out.printf(
          "New conversion action added with resource name: '%s'%n", result.getResourceName());
    }
  }
}
      

С#

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V20.ConversionActionService);

    // Note that conversion action names must be unique.
    // If a conversion action already exists with the specified name the create operation
    // will fail with a ConversionAction.DUPLICATE_NAME error.
    string ConversionActionName = "Earth to Mars Cruises Conversion #"
        + ExampleUtilities.GetRandomString();

    // Add a conversion action.
    ConversionAction conversionAction = new ConversionAction()
    {
        Name = ConversionActionName,
        Category = ConversionActionCategory.Default,
        Type = ConversionActionType.Webpage,
        Status = ConversionActionStatus.Enabled,
        ViewThroughLookbackWindowDays = 15,
        ValueSettings = new ConversionAction.Types.ValueSettings()
        {
            DefaultValue = 23.41,
            AlwaysUseDefaultValue = true
        }
    };

    // Create the operation.
    ConversionActionOperation operation = new ConversionActionOperation()
    {
        Create = conversionAction
    };

    try
    {
        // Create the conversion action.
        MutateConversionActionsResponse response =
            conversionActionService.MutateConversionActions(customerId.ToString(),
                    new ConversionActionOperation[] { operation });

        // Display the results.
        foreach (MutateConversionActionResult newConversionAction in response.Results)
        {
            Console.WriteLine($"New conversion action with resource name = " +
                $"'{newConversionAction.ResourceName}' was added.");
        }
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
      

PHP

public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId)
{
    // Creates a conversion action.
    $conversionAction = new ConversionAction([
        // Note that conversion action names must be unique.
        // If a conversion action already exists with the specified conversion_action_name
        // the create operation will fail with a ConversionActionError.DUPLICATE_NAME error.
        'name' => 'Earth to Mars Cruises Conversion #' . Helper::getPrintableDatetime(),
        'category' => ConversionActionCategory::PBDEFAULT,
        'type' => ConversionActionType::WEBPAGE,
        'status' => ConversionActionStatus::ENABLED,
        'view_through_lookback_window_days' => 15,
        'value_settings' => new ValueSettings([
            'default_value' => 23.41,
            'always_use_default_value' => true
        ])
    ]);

    // Creates a conversion action operation.
    $conversionActionOperation = new ConversionActionOperation();
    $conversionActionOperation->setCreate($conversionAction);

    // Issues a mutate request to add the conversion action.
    $conversionActionServiceClient = $googleAdsClient->getConversionActionServiceClient();
    $response = $conversionActionServiceClient->mutateConversionActions(
        MutateConversionActionsRequest::build($customerId, [$conversionActionOperation])
    );

    printf("Added %d conversion actions:%s", $response->getResults()->count(), PHP_EOL);

    foreach ($response->getResults() as $addedConversionAction) {
        /** @var ConversionAction $addedConversionAction */
        printf(
            "New conversion action added with resource name: '%s'%s",
            $addedConversionAction->getResourceName(),
            PHP_EOL
        );
    }
}
      

Питон

def main(client, customer_id):
    conversion_action_service = client.get_service("ConversionActionService")

    # Create the operation.
    conversion_action_operation = client.get_type("ConversionActionOperation")

    # Create conversion action.
    conversion_action = conversion_action_operation.create

    # Note that conversion action names must be unique. If a conversion action
    # already exists with the specified conversion_action_name, the create
    # operation will fail with a ConversionActionError.DUPLICATE_NAME error.
    conversion_action.name = f"Earth to Mars Cruises Conversion {uuid.uuid4()}"
    conversion_action.type_ = (
        client.enums.ConversionActionTypeEnum.UPLOAD_CLICKS
    )
    conversion_action.category = (
        client.enums.ConversionActionCategoryEnum.DEFAULT
    )
    conversion_action.status = client.enums.ConversionActionStatusEnum.ENABLED
    conversion_action.view_through_lookback_window_days = 15

    # Create a value settings object.
    value_settings = conversion_action.value_settings
    value_settings.default_value = 15.0
    value_settings.always_use_default_value = True

    # Add the conversion action.
    conversion_action_response = (
        conversion_action_service.mutate_conversion_actions(
            customer_id=customer_id,
            operations=[conversion_action_operation],
        )
    )

    print(
        "Created conversion action "
        f'"{conversion_action_response.results[0].resource_name}".'
    )
      

Рубин

def add_conversion_action(customer_id)
  # GoogleAdsClient will read a config file from
  # ENV['HOME']/google_ads_config.rb when called without parameters
  client = Google::Ads::GoogleAds::GoogleAdsClient.new


  # Add a conversion action.
  conversion_action = client.resource.conversion_action do |ca|
    ca.name = "Earth to Mars Cruises Conversion #{(Time.new.to_f * 100).to_i}"
    ca.type = :UPLOAD_CLICKS
    ca.category = :DEFAULT
    ca.status = :ENABLED
    ca.view_through_lookback_window_days = 15

    # Create a value settings object.
    ca.value_settings = client.resource.value_settings do |vs|
      vs.default_value = 15
      vs.always_use_default_value = true
    end
  end

  # Create the operation.
  conversion_action_operation = client.operation.create_resource.conversion_action(conversion_action)

  # Add the ad group ad.
  response = client.service.conversion_action.mutate_conversion_actions(
    customer_id: customer_id,
    operations: [conversion_action_operation],
  )

  puts "New conversion action with resource name = #{response.results.first.resource_name}."
end
      

Перл

sub add_conversion_action {
  my ($api_client, $customer_id) = @_;

  # Note that conversion action names must be unique.
  # If a conversion action already exists with the specified conversion_action_name,
  # the create operation fails with error ConversionActionError.DUPLICATE_NAME.
  my $conversion_action_name = "Earth to Mars Cruises Conversion #" . uniqid();

  # Create a conversion action.
  my $conversion_action =
    Google::Ads::GoogleAds::V20::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V20::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V20::Services::ConversionActionService::ConversionActionOperation
    ->new({create => $conversion_action});

  # Add the conversion action.
  my $conversion_actions_response =
    $api_client->ConversionActionService()->mutate({
      customerId => $customer_id,
      operations => [$conversion_action_operation]});

  printf "New conversion action added with resource name: '%s'.\n",
    $conversion_actions_response->{results}[0]{resourceName};

  return 1;
}
      

Убедитесь, что conversion_action_type установлен на правильное значение ConversionActionType . Для получения дополнительных рекомендаций по созданию действий конверсии в API Google Ads см. раздел Создание действий конверсии .

Получить существующее действие конверсии

Вы можете получить сведения о существующем действии конверсии, выполнив следующий запрос. Убедитесь, что идентификатор клиента в запросе установлен на клиента конверсии Google Ads, которого вы определили выше, а тип действия конверсии установлен на правильное значение ConversionActionType .

SELECT
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.status
FROM conversion_action
WHERE conversion_action.type = 'INSERT_CONVERSION_ACTION_TYPE'

Отслеживание конверсий между аккаунтами

Если вы используете отслеживание конверсий между аккаунтами , ConversionActionService возвращает следующие действия конверсии:

  • Все действия по конверсии, определенные учетной записью менеджера, используемые учетной записью для отслеживания конверсий между учетными записями.
  • Все действия по конверсии, по которым клиент накопил статистику, включая действия, определенные системой, и действия, принадлежащие менеджеру, даже если этот менеджер впоследствии отменит связь
  • Все действия, которые клиент определил в своей учетной записи
  • Конверсии Analytics, созданные в связанных свойствах Google Analytics. Это включает действия для конверсий Analytics, не импортированных в Google Ads, которые имеют статус HIDDEN .

Начиная с v19.1 вы можете использовать API Google Ads для включения отслеживания перекрестных конверсий при создании клиентских аккаунтов.

При создании нового Customer установите conversion_tracking_setting.google_ads_conversion_customer на имя ресурса аккаунта менеджера, который должен управлять действиями конверсии от имени аккаунта клиента. Этот аккаунт менеджера также должен быть аккаунтом, который отправляет запрос на create нового аккаунта клиента.

Начиная с v20 вы можете использовать API Google Ads для включения отслеживания перекрестных конверсий как при создании , так и при обновлении клиентских аккаунтов.

При обновлении существующей клиентской учетной записи вы можете включить отслеживание конверсий между учетными записями, установив поле conversion_tracking_setting.google_ads_conversion_customer . Это поле должно быть установлено на имя ресурса управляющей учетной записи, которая должна управлять действиями конверсии от имени клиентской учетной записи. Эта управляющая учетная запись также должна быть учетной записью, которая отправляет запрос update для клиентской учетной записи.

Когда вы выбираете отслеживание конверсий между аккаунтами или переключаете менеджер отслеживания конверсий для существующего клиентского аккаунта, применяются те же предостережения, как если бы вы вносили это изменение в UI . В частности:

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

Создать действия по конверсии

Для измерения конверсий настройте ConversionAction для type действия конверсии, которое вы хотите отслеживать. Например, онлайн-покупка и телефонный звонок требуют разных действий конверсии.

Лучший способ настроить новые действия конверсии в API — использовать пример кода Add Conversion Action ниже . Пример обрабатывает все фоновые задачи аутентификации для вас и проведет вас через создание ConversionAction .

Большинство действий по конверсии также требуют дополнительных шагов с вашей стороны для их отслеживания. Например, чтобы отслеживать конверсии на вашем веб-сайте, вы должны добавить фрагмент кода, называемый тегом, на страницу конверсии на вашем веб-сайте. Подробные требования к другим типам действий по конверсии см. в статье нашего Справочного центра .

Пример кода

Следующий пример кода проведет вас через процесс создания нового действия конверсии. В частности, он создает действие конверсии с type UPLOAD_CLICKS . Он также устанавливает category DEFAULT .

Применяются следующие настройки по умолчанию:

Ява

private void runExample(GoogleAdsClient googleAdsClient, long customerId) {

  // Creates a ConversionAction.
  ConversionAction conversionAction =
      ConversionAction.newBuilder()
          // Note that conversion action names must be unique. If a conversion action already
          // exists with the specified conversion_action_name the create operation will fail with
          // a ConversionActionError.DUPLICATE_NAME error.
          .setName("Earth to Mars Cruises Conversion #" + getPrintableDateTime())
          .setCategory(ConversionActionCategory.DEFAULT)
          .setType(ConversionActionType.WEBPAGE)
          .setStatus(ConversionActionStatus.ENABLED)
          .setViewThroughLookbackWindowDays(15L)
          .setValueSettings(
              ValueSettings.newBuilder()
                  .setDefaultValue(23.41)
                  .setAlwaysUseDefaultValue(true)
                  .build())
          .build();

  // Creates the operation.
  ConversionActionOperation operation =
      ConversionActionOperation.newBuilder().setCreate(conversionAction).build();

  try (ConversionActionServiceClient conversionActionServiceClient =
      googleAdsClient.getLatestVersion().createConversionActionServiceClient()) {
    MutateConversionActionsResponse response =
        conversionActionServiceClient.mutateConversionActions(
            Long.toString(customerId), Collections.singletonList(operation));
    System.out.printf("Added %d conversion actions:%n", response.getResultsCount());
    for (MutateConversionActionResult result : response.getResultsList()) {
      System.out.printf(
          "New conversion action added with resource name: '%s'%n", result.getResourceName());
    }
  }
}
      

С#

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V20.ConversionActionService);

    // Note that conversion action names must be unique.
    // If a conversion action already exists with the specified name the create operation
    // will fail with a ConversionAction.DUPLICATE_NAME error.
    string ConversionActionName = "Earth to Mars Cruises Conversion #"
        + ExampleUtilities.GetRandomString();

    // Add a conversion action.
    ConversionAction conversionAction = new ConversionAction()
    {
        Name = ConversionActionName,
        Category = ConversionActionCategory.Default,
        Type = ConversionActionType.Webpage,
        Status = ConversionActionStatus.Enabled,
        ViewThroughLookbackWindowDays = 15,
        ValueSettings = new ConversionAction.Types.ValueSettings()
        {
            DefaultValue = 23.41,
            AlwaysUseDefaultValue = true
        }
    };

    // Create the operation.
    ConversionActionOperation operation = new ConversionActionOperation()
    {
        Create = conversionAction
    };

    try
    {
        // Create the conversion action.
        MutateConversionActionsResponse response =
            conversionActionService.MutateConversionActions(customerId.ToString(),
                    new ConversionActionOperation[] { operation });

        // Display the results.
        foreach (MutateConversionActionResult newConversionAction in response.Results)
        {
            Console.WriteLine($"New conversion action with resource name = " +
                $"'{newConversionAction.ResourceName}' was added.");
        }
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
      

PHP

public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId)
{
    // Creates a conversion action.
    $conversionAction = new ConversionAction([
        // Note that conversion action names must be unique.
        // If a conversion action already exists with the specified conversion_action_name
        // the create operation will fail with a ConversionActionError.DUPLICATE_NAME error.
        'name' => 'Earth to Mars Cruises Conversion #' . Helper::getPrintableDatetime(),
        'category' => ConversionActionCategory::PBDEFAULT,
        'type' => ConversionActionType::WEBPAGE,
        'status' => ConversionActionStatus::ENABLED,
        'view_through_lookback_window_days' => 15,
        'value_settings' => new ValueSettings([
            'default_value' => 23.41,
            'always_use_default_value' => true
        ])
    ]);

    // Creates a conversion action operation.
    $conversionActionOperation = new ConversionActionOperation();
    $conversionActionOperation->setCreate($conversionAction);

    // Issues a mutate request to add the conversion action.
    $conversionActionServiceClient = $googleAdsClient->getConversionActionServiceClient();
    $response = $conversionActionServiceClient->mutateConversionActions(
        MutateConversionActionsRequest::build($customerId, [$conversionActionOperation])
    );

    printf("Added %d conversion actions:%s", $response->getResults()->count(), PHP_EOL);

    foreach ($response->getResults() as $addedConversionAction) {
        /** @var ConversionAction $addedConversionAction */
        printf(
            "New conversion action added with resource name: '%s'%s",
            $addedConversionAction->getResourceName(),
            PHP_EOL
        );
    }
}
      

Питон

def main(client, customer_id):
    conversion_action_service = client.get_service("ConversionActionService")

    # Create the operation.
    conversion_action_operation = client.get_type("ConversionActionOperation")

    # Create conversion action.
    conversion_action = conversion_action_operation.create

    # Note that conversion action names must be unique. If a conversion action
    # already exists with the specified conversion_action_name, the create
    # operation will fail with a ConversionActionError.DUPLICATE_NAME error.
    conversion_action.name = f"Earth to Mars Cruises Conversion {uuid.uuid4()}"
    conversion_action.type_ = (
        client.enums.ConversionActionTypeEnum.UPLOAD_CLICKS
    )
    conversion_action.category = (
        client.enums.ConversionActionCategoryEnum.DEFAULT
    )
    conversion_action.status = client.enums.ConversionActionStatusEnum.ENABLED
    conversion_action.view_through_lookback_window_days = 15

    # Create a value settings object.
    value_settings = conversion_action.value_settings
    value_settings.default_value = 15.0
    value_settings.always_use_default_value = True

    # Add the conversion action.
    conversion_action_response = (
        conversion_action_service.mutate_conversion_actions(
            customer_id=customer_id,
            operations=[conversion_action_operation],
        )
    )

    print(
        "Created conversion action "
        f'"{conversion_action_response.results[0].resource_name}".'
    )
      

Рубин

def add_conversion_action(customer_id)
  # GoogleAdsClient will read a config file from
  # ENV['HOME']/google_ads_config.rb when called without parameters
  client = Google::Ads::GoogleAds::GoogleAdsClient.new


  # Add a conversion action.
  conversion_action = client.resource.conversion_action do |ca|
    ca.name = "Earth to Mars Cruises Conversion #{(Time.new.to_f * 100).to_i}"
    ca.type = :UPLOAD_CLICKS
    ca.category = :DEFAULT
    ca.status = :ENABLED
    ca.view_through_lookback_window_days = 15

    # Create a value settings object.
    ca.value_settings = client.resource.value_settings do |vs|
      vs.default_value = 15
      vs.always_use_default_value = true
    end
  end

  # Create the operation.
  conversion_action_operation = client.operation.create_resource.conversion_action(conversion_action)

  # Add the ad group ad.
  response = client.service.conversion_action.mutate_conversion_actions(
    customer_id: customer_id,
    operations: [conversion_action_operation],
  )

  puts "New conversion action with resource name = #{response.results.first.resource_name}."
end
      

Перл

sub add_conversion_action {
  my ($api_client, $customer_id) = @_;

  # Note that conversion action names must be unique.
  # If a conversion action already exists with the specified conversion_action_name,
  # the create operation fails with error ConversionActionError.DUPLICATE_NAME.
  my $conversion_action_name = "Earth to Mars Cruises Conversion #" . uniqid();

  # Create a conversion action.
  my $conversion_action =
    Google::Ads::GoogleAds::V20::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V20::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V20::Services::ConversionActionService::ConversionActionOperation
    ->new({create => $conversion_action});

  # Add the conversion action.
  my $conversion_actions_response =
    $api_client->ConversionActionService()->mutate({
      customerId => $customer_id,
      operations => [$conversion_action_operation]});

  printf "New conversion action added with resource name: '%s'.\n",
    $conversion_actions_response->{results}[0]{resourceName};

  return 1;
}
      

Этот пример можно увидеть в папке «Ремаркетинг» вашей клиентской библиотеки и в коллекции примеров кода: Пример кода «Добавить действие конверсии» .

Проверки

Google Ads и API Google Ads поддерживают широкий спектр конверсионных действий, поэтому некоторые правила проверки различаются в зависимости от type действия.

Наиболее распространенной ошибкой при создании действия конверсии является DUPLICATE_NAME . Убедитесь, что вы используете уникальное имя для каждого действия конверсии.

Вот несколько советов по настройке полей ConversionAction :

Все поля перечисления
Попытка установить для любого поля перечисления значение UNKNOWN приводит к ошибке RequestError.INVALID_ENUM_VALUE .
app_id
Атрибут app_id является неизменяемым и может быть установлен только при создании новой конверсии приложения.
attribution_model_settings
Установка этого параметра в качестве устаревшего приводит к ошибке CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS . Google Ads поддерживает только GOOGLE_ADS_LAST_CLICK и GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN .
click_through_lookback_window_days

Установка для этого атрибута значения, выходящего за пределы допустимого диапазона, приводит к ошибке RangeError.TOO_LOW или RangeError.TOO_HIGH .

Этот атрибут должен быть в диапазоне [1,60] для действия конверсии AD_CALL или WEBSITE_CALL . Для большинства других действий конверсии допустимый диапазон — [1,30] .

include_in_conversions_metric

Установка этого значения в операции create или update завершается ошибкой FieldError.IMMUTABLE_FIELD . Вместо этого установите primary_for_goal , как описано в руководстве по целям конверсии .

phone_call_duration_seconds

Попытка задать этот атрибут для действия конверсии, которое не предназначено для вызовов, приводит к ошибке FieldError.VALUE_MUST_BE_UNSET .

type

Атрибут type является неизменяемым и может быть установлен только при создании нового преобразования.

Обновление действия преобразования с type , равным UNKNOWN приводит к ошибке MutateError.MUTATE_NOT_ALLOWED .

value_settings

value_settings для действия преобразования WEBSITE_CALL или AD_CALL должно иметь always_use_default_value равным true . Указание значения false при создании или обновлении этого значения приводит к ошибке INVALID_VALUE .

view_through_lookback_window_days

Установка этого атрибута на значение вне допустимого диапазона приводит к ошибке RangeError.TOO_LOW или RangeError.TOO_HIGH . Для большинства действий преобразования допустимый диапазон — [1,30] .

Этот атрибут не может быть установлен для действий конверсии AD_CALL или WEBSITE_CALL . Указание значения приводит к ошибке VALUE_MUST_BE_UNSET .