Начните работу с расширенным отслеживанием конверсий для потенциальных клиентов

Как работает расширенное преобразование для потенциальных клиентов

Для расширенного преобразования потенциальных клиентов необходимо настроить тег, который автоматически отправляет GCLID в Google Рекламу, когда пользователь отправляет форму для потенциальных клиентов. Тег Google можно настроить через Google Рекламу, Диспетчер тегов Google, Google Analytics или Менеджер кампаний 360. Тег отправляет данные отправки формы для потенциальных клиентов — например, адрес электронной почты пользователя — вместе с GCLID в Google Рекламу, когда пользователь отправляет форму для потенциальных клиентов. Когда пользователь позднее совершит конверсию, вы можете либо загрузить конверсию через пользовательский интерфейс Google Рекламы, как описано в Справочном центре , либо загрузить конверсию с информацией из формы для потенциальных клиентов через API Google Рекламы.

Расширенное преобразование потенциальных клиентов в API Google Рекламы отражает шаг 5 в следующем порядке.

Улучшенные конверсии для потенциальных клиентов

Реализация предварительных условий

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

  1. Включите отслеживание конверсий в вашем клиенте-конверсионисте Google Рекламы.

  2. Примите условия использования данных клиентов и включите расширенное преобразование потенциальных клиентов.

  3. Настройте тегирование.

1. Включите отслеживание конверсий в вашем клиенте-конверсионисте Google Рекламы.

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

Вы можете проверить настройку отслеживания конверсий вашей учетной записи и убедиться, что отслеживание конверсий включено, запросив у ресурса 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 Рекламы, который создает конверсии для этого клиента и управляет ими. Для клиентов, использующих отслеживание конверсий между аккаунтами , это идентификатор управляющего аккаунта. Идентификатор клиента конверсий Google Рекламы следует указывать в качестве customer_id в запросах API Google Рекламы для создания конверсий и управления ими. Обратите внимание, что это поле заполняется, даже если отслеживание конверсий не включено.

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

Создайте действие-конверсию для клиента-конверсии Google Рекламы.

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

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

Пример кода

Ява

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.V17.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::V17::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V17::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V17::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 . Дополнительные инструкции по созданию действий-конверсий в Google Ads API см. в разделе Создание действий-конверсий .

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

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

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

2. Примите условия использования данных клиентов и включите расширенное преобразование потенциальных клиентов.

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

SELECT
  customer.id,
  customer.conversion_tracking_setting.accepted_customer_data_terms,
  customer.conversion_tracking_setting.enhanced_conversions_for_leads_enabled
FROM customer

Если для параметра accepted_customer_data_terms или enhanced_conversions_for_leads_enabled установлено значение false , следуйте инструкциям в Справочном центре , чтобы выполнить эти предварительные требования.

3. Настройте тегирование

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

Следующие шаги

Выполнив все предварительные требования, вы готовы реализовать расширенное преобразование для потенциальных клиентов .