Web İçin Gelişmiş Dönüşümleri Kullanmaya Başlayın

Web için gelişmiş dönüşümler nasıl çalışır?

Web için gelişmiş dönüşümler özelliğinde, dönüşüm işlemini otomatik olarak bir kullanıcı dönüşüm gerçekleştirdiğinde GCLID gibi bir tıklama tanımlayıcısı ve Google Ads için elde eder. Gelişmiş dönüşümleri Google Etiket Yöneticisi, Google etiketi veya Google Ads API'dir. Her bir Google Ads API, birinci taraf dönüşüm verilerini 24 saat içinde göndermenize olanak tanır. saatlere denk geliyor. Bu da, mümkün olan en iyi sonucu verir, örneğin, veya CRM sisteminden sorumludur.

Google Ads API'de web için gelişmiş dönüşümler, aşağıdaki 3. adımı tamamlar: akışı sağlar.

için gelişmiş dönüşümler web

Kullanıcı dönüşüm gerçekleştirdiğinde karma oluşturma işlemi uygulanmış kullanıcı bilgilerini göndermek yerine etiket, yalnızca GCLID ve sipariş kimliğini gönderir, karma oluşturma işlemi uygulanmış kullanıcı bilgilerini siz gönderirsiniz. daha sonra karma oluşturma işlemi uygulanmış verilerle birlikte sipariş kimliğini yükleyebilirsiniz.

Ön koşulları uygulama

Gelişmiş dönüşüm ayarlarının çalışması için birkaç ön koşul vardır. Şunlardan emin olun: Uygulamaya devam etmeden önce tüm ön koşulların yerine getirilmesi gerekir:

  1. Google Ads dönüşüm müşterinizde dönüşüm izlemeyi etkinleştirin.

  2. Müşteri verisi şartlarını kabul edin.

  3. Etiketlemeyi yapılandırın.

1. Google Ads dönüşüm müşterinizde dönüşüm izlemeyi etkinleştirme

Dönüşüm izleme ayarlarınız hakkında bilgi alma

Hesabınızın dönüşüm izleme ayarlarını kontrol edebilir ve dönüşümü onaylayabilirsiniz İzleme, Customer kaynağı sorgulanarak etkinleştirilir ConversionTrackingSetting için. Aşağıdaki sorguyu şununla yap: 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 alanı, bu müşteri için dönüşümler oluşturur ve yönetir. Şunu kullanan müşteriler için: hesaplar arası dönüşüm izleme Bu bir yönetici hesabının kimliğidir. Google Ads dönüşüm müşteri kimliği: dönüşüm oluşturmak ve yönetmek için Google Ads API isteklerinde customer_id olarak verilir. Bu alanın, dönüşüm izleme etkin olmasa bile doldurulduğunu unutmayın.

İlgili içeriği oluşturmak için kullanılan conversion_tracking_status alanı, dönüşüm izlemenin etkin olup olmadığını ve hesabın hesaplar arası dönüşüm izleme özelliğini kullanıyor.

Google Ads dönüşüm müşterisi altında bir dönüşüm işlemi oluşturun

conversion_tracking_status değeri NOT_CONVERSION_TRACKED ise Dönüşüm izleme hesap için etkinleştirilmemiştir. Dönüşüm izlemeyi etkinleştirme içinde en az bir ConversionAction oluşturarak aşağıdaki örnekte gösterildiği gibi Google Ads dönüşüm hesabı: Alternatif olarak şu talimatları uygulayarak kullanıcı arayüzünde bir dönüşüm işlemi oluşturabilir: Yardım Merkezi'nde dönüşüm türünü seçin.

Gelişmiş dönüşümlerin ancak Google Ads kullanıcı arayüzünden devre dışı bırakılabilirler.

.

Kod örneği

Java

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());
    }
  }
}
AddConversionAction.java

C#

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;
    }
}
AddConversionAction.cs

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
        );
    }
}
AddConversionAction.php

Python

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}".'
    )
add_conversion_action.py

Ruby

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
add_conversion_action.rb

Perl

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;
}
add_conversion_action.pl

conversion_action_type değerinin doğru şekilde ayarlandığından emin olun ConversionActionType değeri için geçerlidir. Google Ads API'de dönüşüm işlemleri oluşturma hakkında daha fazla bilgi için Dönüşüm İşlemleri Oluşturma başlıklı makaleyi inceleyin.

Mevcut bir dönüşüm işlemini alma

Mevcut bir dönüşüm işleminin ayrıntılarını, sorgudur. İstekteki müşteri kimliğinin Google Ads olarak ayarlandığından emin olun dönüşüm işlemi yapan müşteriniz ve dönüşüm işlemi türü olarak doğru ConversionActionType değer.

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

2. Müşteri verisi şartlarını kabul edin

Gelişmiş dönüşümleri kullanabilmek için müşteri verisi şartlarını kabul etmeniz gerekir web için. Müşteri verisi şartlarının Google Ads dönüşüm müşterisine aşağıdaki sorguyu gönderin:

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

accepted_customer_data_terms değeri false ise Yardım Merkezi tamamlamanız gerekir.

3. Etiketlemeyi yapılandırın

Şuradaki talimatları uygulayarak web siteniz için etiketlemeyi yapılandırabilirsiniz: Yardım Merkezi.

Dönüşümünüze, sipariş kimlikleri olarak da bilinen işlem kimliklerini de eklemeniz gerekir. Yardım Merkezimizdeki Merkezi. Google Ads için bunlar gereklidir dönüşümü bulabilmeniz gerekir.

Sonraki adımlar

Ön koşulları yerine getirdikten sonra, gelişmiş dönüşümleri uygulamaya web'deki dönüşümleri Google Ads API'si.

Önceki
Genel bakış
Sonraki
Uygulama