Başlangıç

Dönüşümleri kaydetmek için Google Ads dönüşüm hesabınızda dönüşüm izlemeyi etkinleştirmeniz gerekir. Bu kılavuzda, dönüşüm izlemenin etkin olup olmadığını nasıl onaylayacağınız, etkin değilse nasıl etkinleştireceğiniz ve mevcut dönüşüm işlemleri hakkında nasıl bilgi edineceğiniz açıklanmaktadır.

Çoğu dönüşüm işleminin izlenmesi için sizden de ek adımlar atmanız gerekir. Çeşitli dönüşüm işlemi türleri ve koşulları hakkında daha fazla bilgi için Dönüşüm işlemi oluşturma kılavuzuna bakın.

Web sitenizi dönüşümleri izleyecek şekilde ayarlama

Çevrimdışı dönüşüm içe aktarma entegrasyonunuzu başlatıyorsanız ilk adım, web sitenizi potansiyel müşteriler için gelişmiş dönüşümleri izleyecek şekilde yapılandırmak üzere Potansiyel müşteriler için gelişmiş dönüşümler için Google etiketini yapılandırma kılavuzundaki adımları uygulamaktır. Potansiyel müşteriler için gelişmiş dönüşümler özelliğini etkinleştirmek üzere Google Etiket Yöneticisi'ni yapılandırma kılavuzundaki adımları uygulayarak web sitenizi yapılandırmak için Google Etiket Yöneticisi'ni de kullanabilirsiniz.

Google Ads dönüşüm hesabınızda dönüşüm izlemeyi etkinleştirme

Dönüşüm izleme ayarlarınızla ilgili bilgileri alma

ConversionTrackingSetting için Customer kaynağını sorgulayarak hesabınızın dönüşüm izleme ayarlarını kontrol edebilir ve dönüşüm izlemenin etkin olduğunu onaylayabilirsiniz. GoogleAdsService.SearchStream ile aşağıdaki sorguyu gönderin:

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üşümleri oluşturan ve yöneten Google Ads hesabını gösterir. Hesaplar arası dönüşüm izleme özelliğini kullanan müşteriler için bu, 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 belirtilmelidir. Bu alanın, dönüşüm izleme etkin olmasa bile doldurulduğunu unutmayın.

conversion_tracking_status alanı, dönüşüm izlemenin etkin olup olmadığını ve hesabın hesaplar arası dönüşüm izlemeyi kullanıp kullanmadığını gösterir.

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 hesap için dönüşüm izleme etkin değildir. Aşağıdaki örnekte gösterildiği gibi Google Ads dönüşüm hesabında en az bir ConversionAction oluşturarak dönüşüm izlemeyi etkinleştirin. Alternatif olarak, etkinleştirmek istediğiniz dönüşüm türü için Yardım Merkezi'ndeki talimatları uygulayarak kullanıcı arayüzünde bir dönüşüm işlemi oluşturabilirsiniz.

Gelişmiş dönüşümlerin, Google Ads API üzerinden gönderildiğinde otomatik olarak etkinleştirildiğini ancak Google Ads kullanıcı arayüzü üzerinden devre dışı bırakılabileceğini unutmayın.

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

C#

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
        );
    }
}
      

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

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
      

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::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 değerinin doğru ConversionActionType değerine ayarlandığından emin olun. Google Ads API'de dönüşüm işlemi oluşturma hakkında daha fazla bilgi için Dönüşüm İşlemi Oluşturma başlıklı makaleyi inceleyin.

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

Aşağıdaki sorguyu göndererek mevcut bir dönüşüm işleminin ayrıntılarını alabilirsiniz. İstekte belirtilen müşteri kimliğinin, yukarıda tanımladığınız Google Ads dönüşüm müşterisine ayarlandığından ve dönüşüm işlemi türünün doğru ConversionActionType değerine ayarlandığından emin olun.

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

Hesaplar arası dönüşüm izleme

Hesaplar arası dönüşüm izleme özelliğini kullanıyorsanız ConversionActionService aşağıdaki dönüşüm işlemlerini döndürür:

  • Hesaplar arası dönüşüm izleme için hesap tarafından kullanılan yönetici hesabı tarafından tanımlanan tüm dönüşüm işlemleri
  • Sistem tarafından tanımlanan işlemler ve yöneticinin bağlantısını daha sonra kaldırsa bile yöneticinin sahip olduğu işlemler dahil olmak üzere müşterinin istatistikleri topladığı tüm dönüşüm işlemleri
  • Müşterinin kendi hesabında tanımladığı tüm işlemler
  • Bağlı Google Analytics mülklerinde oluşturulan Analytics dönüşümleri. Google Ads'e aktarılmayan ve HIDDEN durumuna sahip Analytics dönüşüm işlemleri de buna dahildir.

v19.1 sürümünden itibaren, istemci hesaplarını oluştururken dönüşümler arası izlemeyi etkinleştirmek için Google Ads API'yi kullanabilirsiniz.

Yeni bir Customer oluştururken conversion_tracking_setting.google_ads_conversion_customer değerini, müşteri hesabı adına dönüşüm işlemlerini yönetmesi gereken yönetici hesabının kaynak adına ayarlayın. Bu yönetici hesabı, yeni müşteri hesabı için create isteğini gönderen hesap da olmalıdır.

v20 itibarıyla, hem müşteri hesaplarını oluştururken hem de güncellerken dönüşümler arası izlemeyi etkinleştirmek için Google Ads API'yi kullanabilirsiniz.

Mevcut bir müşteri hesabını güncellerken conversion_tracking_setting.google_ads_conversion_customer alanını ayarlayarak hesaplar arası dönüşüm izlemeyi etkinleştirebilirsiniz. Bu alan, dönüşüm işlemlerini müşteri hesabı adına yönetmesi gereken yönetici hesabının kaynak adına ayarlanmalıdır. Bu yönetici hesabı, müşteri hesabı için update isteğini gönderen hesap da olmalıdır.

Hesaplar arası dönüşüm izlemeyi etkinleştirdiğinizde veya mevcut bir müşteri hesabının dönüşüm izleme yöneticisini değiştirdiğinizde, bu değişikliği kullanıcı arayüzünde yapıyormuşsunuz gibi aynı uyarılar geçerli olur. Özellikle:

  • Müşteri hesabı, yeni dönüşüm izleme yöneticisinin varsayılan dönüşüm değeri kurallarını ve varsayılan müşteri yaşam döngüsü hedeflerini benimser.
  • Belirli bir dönüşüm işlemini hedefleyen kampanyalar, dönüşüm yöneticisi hesabının varsayılan dönüşüm hedeflerini kullanmaya başlar. Belirli bir dönüşüm işlemini hedeflemeye devam ederseniz yönetici hesabının müşteri hesabıyla aynı hedeflere sahip olmayabileceğinden tutarsız davranışlar oluşabilir. Kampanyalarınızın doğru hedeflere göre optimize edildiğinden emin olun.
  • Bir hesap birden fazla yönetici hesabına aitse yalnızca tek bir yöneticinin dönüşüm işlemlerini kullanabilir. Dönüşüm izleme hesabı belirtilmezse hesap varsayılan olarak kendisini dönüşüm izleme hesabı olarak kullanır.

Dönüşüm işlemleri oluşturun

Dönüşümleri ölçmek için izlemek istediğiniz dönüşüm işleminin type için bir ConversionAction oluşturun. Örneğin, internetten satın alma ve telefon araması farklı dönüşüm işlemleri gerektirir.

API'de yeni dönüşüm işlemleri oluşturmanın en iyi yolu, aşağıdaki Dönüşüm İşlemi Ekle kod örneğini kullanmaktır. Örnek, arka plandaki tüm kimlik doğrulama görevlerini sizin için üstlenir ve ConversionAction oluşturma sürecinde size yol gösterir.

Çoğu dönüşüm işleminin izlenmesi için sizden ek adımlar da gerekir. Örneğin, web sitenizdeki dönüşümleri izlemek için web sitenizdeki dönüşüm sayfasına etiket adlı bir kod snippet'i eklemeniz gerekir. Diğer dönüşüm işlemi türlerinin ayrıntılı koşulları için Yardım Merkezi makalemizi inceleyin.

Kod örneği

Aşağıdaki kod örneği, yeni bir dönüşüm işlemi oluşturma sürecinde size yol gösterir. Daha açık belirtmek gerekirse, type parametresi UPLOAD_CLICKS olarak ayarlanmış bir dönüşüm işlemi oluşturur. Ayrıca category değerini DEFAULT olarak ayarlar.

Aşağıdaki varsayılan ayarlar geçerlidir:

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

C#

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
        );
    }
}
      

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

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
      

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::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;
}
      

Bu örneği, istemci kitaplığınızın Yeniden Pazarlama klasöründe ve Dönüşüm işlemi kodu örneği ekleme kod örnekleri koleksiyonunda bulabilirsiniz.

Doğrulamalar

Google Ads ve Google Ads API, çok çeşitli dönüşüm işlemlerini destekler. Bu nedenle, bazı doğrulama kuralları işlemin type durumuna göre değişir.

Dönüşüm işlemi oluştururken en sık karşılaşılan hata DUPLICATE_NAME hatasıdır. Her dönüşüm işlemi için benzersiz bir ad kullandığınızdan emin olun.

ConversionAction alanlarını ayarlamayla ilgili bazı ipuçları aşağıda verilmiştir:

Tüm enum alanları
Herhangi bir enum alanını UNKNOWN olarak ayarlamaya çalışmak RequestError.INVALID_ENUM_VALUE hatasıyla sonuçlanır.
app_id
app_id özelliği değiştirilemez ve yalnızca yeni bir uygulama dönüşümü oluştururken ayarlanabilir.
attribution_model_settings
Bu özelliği kullanımdan kaldırılmış bir seçeneğe ayarlamak CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS hatasına neden olur. Google Ads yalnızca GOOGLE_ADS_LAST_CLICK ve GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN'i destekler.
click_through_lookback_window_days

Bu özelliğin izin verilen aralığın dışında bir değere ayarlanması RangeError.TOO_LOW veya RangeError.TOO_HIGH hatasına neden olur.

Bu özellik, AD_CALL veya WEBSITE_CALL dönüşüm işlemi için [1,60] aralığında olmalıdır. Diğer dönüşüm işlemlerinin çoğu için izin verilen aralık [1,30]'tür.

include_in_conversions_metric

Bu değer, create veya update işleminde ayarlandığında FieldError.IMMUTABLE_FIELD hatası oluşur. Bunun yerine, primary_for_goal değerini Dönüşüm hedefleri kılavuzunda açıklandığı şekilde ayarlayın.

phone_call_duration_seconds

Bu özelliği, aramalar için olmayan bir dönüşüm işleminde ayarlamaya çalışmak FieldError.VALUE_MUST_BE_UNSET hatasına neden olur.

type

type özelliği değiştirilemez ve yalnızca yeni bir dönüşüm oluşturulurken ayarlanabilir.

type değerinin UNKNOWN olduğu bir dönüşüm işleminin güncellenmesi MutateError.MUTATE_NOT_ALLOWED hatasına neden olur.

value_settings

WEBSITE_CALL veya AD_CALL dönüşüm işlemi için value_settings'te always_use_default_value, true olarak ayarlanmalıdır. Bu değeri oluştururken veya güncellerken false değeri belirtmek INVALID_VALUE hatasına neden olur.

view_through_lookback_window_days

Bu özelliğin izin verilen aralığın dışında bir değere ayarlanması RangeError.TOO_LOW veya RangeError.TOO_HIGH hatasına neden olur. Çoğu dönüşüm işlemi için izin verilen aralık [1,30]'tür.

Bu özellik, AD_CALL veya WEBSITE_CALL dönüşüm işlemlerinde ayarlanamaz. Bir değer belirtmek VALUE_MUST_BE_UNSET hatasına neden olur.