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ı doğrulama, etkin değilse etkinleştirme ve mevcut dönüşüm işlemleri hakkında bilgi alma ile ilgili ayrıntılar verilmektedir.

Çoğu dönüşüm işleminde, dönüşümleri izlemek için ek adımlar uygulamanız gerekir. Çeşitli dönüşüm işlemi türleri ve bunların gereksinimleri hakkında daha fazla bilgi için Dönüşüm işlemi kategorileri ve Dönüşüm işlemleri oluşturma başlıklı makaleleri inceleyin.

Dönüşümleri veya kullanıcı verilerini içe aktarırken dönüşüm verilerini Google ile paylaşma izniniz olduğunu onaylamanız gerekir. Bunu iki şekilde yapabilirsiniz:

  1. Hesap düzeyinde varsayılan izin ayarlarını yapılandırın. Google Ads kullanıcı arayüzünde Araçlar > Veri Yöneticisi > İzin ayarları > Varsayılan izin ayarları'nı tıklayın.
  2. İçe aktarılan her dönüşüm veya kullanıcı verileri yükünde izin alanını ayarlayın (ör. ClickConversion.consent, CallConversion.consent veya UserData.consent).

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

Web sitesi dönüşümlerini izliyorsanız veya potansiyel müşteriler için gelişmiş dönüşümleri uyguluyorsanız önce web sitenizin etiketlemesini yapılandırın. Potansiyel müşteriler için gelişmiş dönüşümlerle ilgili olarak Google etiketini yapılandırma bölümündeki adımları uygulayın veya Potansiyel müşteriler için gelişmiş dönüşümlerle ilgili olarak Google Etiket Yöneticisi'ni yapılandırma bölümündeki adımları uygulayarak Google Etiket Yöneticisi'ni kullanın.

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

Hesabınızın dönüşüm izleme ayarlarını doğrulamak ve dönüşüm işlemleri oluşturmak veya almak için aşağıdaki adımları uygulayın.

Dönüşüm izlemeyi etkinleştirme adımları

Dönüşüm izleme ayarlarınızla ilgili bilgi 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 etkinleştirildiğini doğrulayabilirsiniz. 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, bir yönetici hesabının kimliğidir. Dönüşümleri oluşturmak ve yönetmek için Google Ads API isteklerinde Google Ads reklam dönüşüm müşteri kimliği customer_id olarak verilmelidir. Dönüşüm izleme etkinleştirilmemiş olsa bile bu alanın doldurulduğunu unutmayın.

conversion_tracking_status alanı, dönüşüm izlemenin etkinleştirilip etkinleştirilmediğini ve hesabın hesaplar arası dönüşüm izlemeyi kullanıp kullanmadığını gösterir.

Google Ads reklam 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 etkinleştirilmemiştir. Google Ads dönüşüm hesabında aşağıdaki örnekte olduğu gibi 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 dönüşüm izleme kurulumuyla ilgili Google Ads Yardım Merkezi makalesindeki talimatları uygulayarak kullanıcı arayüzünde bir dönüşüm işlemi oluşturabilirsiniz.

Gelişmiş dönüşümler, Google Ads API üzerinden gönderildiğinde otomatik olarak etkinleştirilir ancak Google Ads kullanıcı arayüzü üzerinden devre dışı bırakılabilir.

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.V26.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: GoogleAdsClient, customer_id: str) -> None:
    conversion_action_service: ConversionActionServiceClient = (
        client.get_service("ConversionActionService")
    )

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

    # Create conversion action.
    conversion_action: ConversionAction = 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: ConversionAction.ValueSettings = (
        conversion_action.value_settings
    )
    value_settings.default_value = 15.0
    value_settings.always_use_default_value = True

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

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V26::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;
}

curl

type değerinin doğru ConversionActionType değerine ayarlandığından emin olun. Google Ads API'de dönüşüm işlemleri oluşturma hakkında daha fazla bilgi için Dönüşüm işlemleri 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. İstekteki müşteri kimliğinin daha önce tanımladığınız Google Ads dönüşüm müşterisine, dönüşüm işlemi türünün ise doğru ConversionActionType değerine ayarlandığından emin olun.

SELECT
  conversion_action.id,
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.type,
  conversion_action.category,
  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, Google Ads hesaplarının, dönüşüm oluşturan reklamları trafiğe eklemiş olabilecek diğer hesaplar adına dönüşümleri içe aktarmasına olanak tanır. Bu, içe aktarma istekleri gönderen hesapları birleştirmenize olanak tanıyarak entegrasyonunuzu basitleştirebilir.

Google Ads API'de hesaplar arası dönüşüm izlemeyi etkinleştirme

Müşteri hesapları oluştururken veya güncellerken dönüşümler arası izlemeyi etkinleştirmek için Google Ads API'yi kullanabilirsiniz.

Bir Customer kaynağında, conversion_tracking_setting.google_ads_conversion_customer alanını, müşteri hesabı adına dönüşüm işlemlerini yönetmesi gereken yönetici hesabının kaynak adı olarak ayarlayın.

Bir müşteri hesabının dönüşüm müşterisini değiştiren istekler, müşterinin yeni dönüşüm müşterisi olan yönetici hesabı tarafından gönderilmelidir. Bunu yapmak için login-customer-id değerini yönetici hesabı kimliği olarak ayarlayın.

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 yapmanız durumunda geçerli olan 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şlayacak. Belirli bir dönüşüm işlemini hedeflemeye devam ederseniz yönetici hesabı, müşteri hesabıyla aynı hedeflere sahip olmayabileceğinden tutarsız davranışlar ortaya çıkabilir. 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 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.

Hesaplar arasında dönüşümleri içe aktarma

Hesaplar arası izleme etkinleştirildiğinde müşteri ve yönetici hesapları, reklam sunma hesabı adına dönüşümleri içe aktarabilir. Bu sayede, içe aktarma mantığınızı basitleştirebilirsiniz. Böylece, içe aktarma sırasında her dönüşüm için reklam sunma hesabını belirlemeniz gerekmez. Tüm dönüşümleri içe aktarmak için hesap ağacınızdan tek bir hesap seçebilirsiniz.

Bir dönüşümün başarıyla yüklenebilmesi için yükleme işlemini yapan hesabın dönüşüm işlemine erişimi olmalıdır. Hesaplar arası izleme hiyerarşisinde, yükleme hesabı, hesap ağacındaki dönüşüm işlemi sahibinin üst öğesi (yöneticisi) veya alt öğesiyse işleme erişebilir.

Aşağıdaki diyagramda, dönüşümleri içe aktarma için yetkilendirme yapısı gösterilmektedir. Burada C1, dönüşümü oluşturan reklamı yayınlayan müşteri hesabıdır. M2 ise dönüşüm işleminin sahibi ve C1'nin dönüşüm izleme üst hesabıdır. Yeşil renkle vurgulanan hesaplar C1 adına dönüşümleri içe aktarabilirken kırmızı renkle vurgulanan hesaplar bunu yapamaz.

Yetkilendirme yapısı

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, online satın alma ve telefon araması için farklı dönüşüm işlemleri gerekir.

API'de yeni dönüşüm işlemleri oluşturmanın en iyi yolu, Dönüşüm İşlemi Ekleme kod örneğini kullanmaktır. Örnek, tüm arka plan kimlik doğrulama görevlerini sizin için gerçekleştirir ve ConversionAction oluşturma konusunda size yol gösterir.

Çoğu dönüşüm işleminde, dönüşümleri izlemek için ek adımlar uygulamanız gerekir. Örneğin, web sitenizdeki dönüşümleri izlemek için web sitenizdeki dönüşüm sayfasına etiket adı verilen bir kod snippet'i eklemeniz gerekir. Diğer dönüşüm işlemi türlerinin ayrıntılı koşulları için Google Ads Yardım Merkezi'ndeki dönüşüm türleri hakkındaki makalemizi inceleyin.

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önetici daha sonra bağlantıyı kaldırsa bile yöneticiye ait işlemler dahil olmak üzere müşterinin istatistik 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 Analytics dönüşümleriyle ilgili işlemler de buna dahildir. Bu dönüşümlerin durumu HIDDEN şeklindedir.

Kod örneği

Aşağıdaki kod örneği, yeni bir dönüşüm işlemi oluşturma sürecinde size yol gösterir. Özellikle, type değeri 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.V26.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: GoogleAdsClient, customer_id: str) -> None:
    conversion_action_service: ConversionActionServiceClient = (
        client.get_service("ConversionActionService")
    )

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

    # Create conversion action.
    conversion_action: ConversionAction = 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: ConversionAction.ValueSettings = (
        conversion_action.value_settings
    )
    value_settings.default_value = 15.0
    value_settings.always_use_default_value = True

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

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V26::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;
}

curl

Bu örneği, istemci kitaplığınızın Remarketing klasöründe ve kod örnekleri koleksiyonunda görebilirsiniz: Dönüşüm İşlemi Ekleme kod örneği.

ConversionActionService.MutateConversionActions alanı referansı

Google Ads dönüşüm müşterisi altında dönüşüm işlemleri oluşturmak, güncellemek veya kaldırmak için ConversionActionService üzerinde MutateConversionActions kullanın:

POST https://googleads.googleapis.com/v26/customers/{customer_id}/conversionActions:mutate

Aşağıdaki tabloda, MutateConversionActionsRequest için üst düzey istek ve işlem alanları listelenmiştir:

Alan Gereksinim Açıklama
customer_id Zorunlu Google Ads reklam dönüşümü müşterisinin (google_ads_conversion_customer) kısa çizgi içermeyen 10 haneli kimliği (string).
partial_failure İsteğe bağlı true (bool) olduğunda, geçerli işlemler yürütülür ve başarısız işlemler partial_failure_error içinde hata döndürür. Varsayılan değer false'dir.
validate_only İsteğe bağlı true (bool) olduğunda, mutasyonları yürütmeden isteği doğrular.
response_content_type İsteğe bağlı Yanıtın yalnızca resource_name (RESOURCE_NAME_ONLY, varsayılan) veya değiştirilen ConversionAction nesnesini (MUTABLE_RESOURCE) döndürüp döndürmeyeceğini kontrol eden ResponseContentType.
operations[].create Zorunlu (oluşturma sırasında) Oluşturulacak ConversionAction kaynağı. resource_name beklenmiyor.
operations[].update Zorunlu (güncelleme sırasında) Güncellenecek ConversionAction kaynağı (ConversionActionOperation üzerinde resource_name ve eş düzey update_mask içermelidir).
operations[].update_mask Zorunlu (güncelleme sırasında) ConversionActionOperation (update ile aynı düzeyde, ConversionAction içinde iç içe yerleştirilmemiş) üzerinde FieldMask (snake_case içinde değiştirilmiş ConversionAction alan yollarının virgülle ayrılmış listesi; REST JSON updateMask, snake_case veya camelCase kabul ederken gRPC ve istemci kitaplıkları snake_case gerektirir).
operations[].remove Zorunlu (kaldırma sırasında) Kaldırılacak dönüşüm işleminin kaynak adı (customers/{customer_id}/conversionActions/{action_id}).

operations[].create veya operations[].update içinde bir ConversionAction yapılandırırken aşağıdaki alan gereksinimlerini ve değişkenlik kısıtlamalarını göz önünde bulundurun (türe özgü hata kuralları için Doğrulamalar bölümüne bakın):

ConversionAction alanı Gereklilik ve değişkenlik Açıklama
name Zorunlu (değiştirilebilir) Dönüşüm müşteri hesabında benzersiz görünen ad (string).
type create (IMMUTABLE) tarihinde zorunlu ConversionActionType (ör. WEBPAGE, UPLOAD_CLICKS, UPLOAD_CALLS, AD_CALL veya WEBSITE_CALL).
category İsteğe bağlı (değiştirilebilir) ConversionActionCategory (ör. DEFAULT, PURCHASE, SUBMIT_LEAD_FORM, SIGNUP veya PHONE_CALL_LEAD). Varsayılan olarak DEFAULT değerine ayarlanır.
status İsteğe bağlı (değiştirilebilir) ConversionActionStatus (ENABLED, REMOVED veya HIDDEN). Varsayılan olarak ENABLED değerine ayarlanır.
primary_for_goal İsteğe bağlı (değiştirilebilir) bool, işlemin standart müşteri ve kampanya dönüşüm hedeflerinde teklif verilebilir olup olmadığını kontrol eder (not: CustomConversionGoal kaynakları bu ayarı yoksayar). Varsayılan değer true'dir.
counting_type İsteğe bağlı (değiştirilebilir) ConversionActionCountingType (MANY_PER_CLICK varsayılan veya ONE_PER_CLICK).
value_settings İsteğe bağlı (değiştirilebilir) ValueSettings (default_value, default_currency_code, always_use_default_value).
attribution_model_settings İsteğe bağlı (değiştirilebilir) AttributionModelSettings (attribution_model: GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN varsayılan veya GOOGLE_ADS_LAST_CLICK).
click_through_lookback_window_days İsteğe bağlı (değiştirilebilir) int64 tıklama yeniden inceleme aralığı (çoğu tür için 1 - 90; telefon araması türleri için 1 - 60).
view_through_lookback_window_days İsteğe bağlı (değiştirilebilir) int64 tam görüntüleme yeniden inceleme aralığı (gün cinsinden) (çoğu tür için 1 ile 30 arasında; telefon araması türleri için ayarlanmamış).
phone_call_duration_seconds Yalnızca çağrı türleri (değiştirilebilir) int64 saniye cinsinden minimum telefon araması süresi (0 - 10000).
app_id Yalnızca uygulama türleri (oluşturulduktan sonra değiştirilemez) Mobil uygulama tanımlayıcısı (string); yalnızca uygulama dönüşümü işlemleri için create üzerinde ayarlanabilir.
include_in_conversions_metric Mutasyonlarda salt okunur Doğrudan değiştirilemez. Bunun yerine primary_for_goal ayarını yapılandırın.
tag_snippets[] OUTPUT_ONLY Web sitesi izleme kodu snippet'leri (TagSnippet) WEBPAGE dönüşüm işleminde dolduruldu.

REST isteği ve yanıt yapısı

REST üzerinden bir ConversionAction oluşturmak veya güncellemek için ConversionActionService.MutateConversionActions adresine bir POST isteği gönderin. Mevcut bir dönüşüm işlemini güncellerken işlem nesnesinde update ile eş düzeyde updateMask değerini belirtin:

POST https://googleads.googleapis.com/v26/customers/{customer_id}/conversionActions:mutate

{
  "operations": [
    {
      "create": {
        "name": "Earth to Mars Cruise Conversion",
        "type": "UPLOAD_CLICKS",
        "category": "DEFAULT",
        "status": "ENABLED",
        "primaryForGoal": true,
        "countingType": "ONE_PER_CLICK",
        "clickThroughLookbackWindowDays": "60",
        "valueSettings": {
          "defaultValue": 23.41,
          "defaultCurrencyCode": "USD",
          "alwaysUseDefaultValue": true
        }
      }
    },
    {
      "updateMask": "primary_for_goal,value_settings.default_value",
      "update": {
        "resourceName": "customers/{customer_id}/conversionActions/6666666666",
        "primaryForGoal": false,
        "valueSettings": {
          "defaultValue": 45.00
        }
      }
    }
  ]
}

Başarılı bir yanıt, results[] içinde MutateConversionActionResult girişlerini döndürür:

{
  "results": [
    {
      "resourceName": "customers/{customer_id}/conversionActions/7777777777"
    },
    {
      "resourceName": "customers/{customer_id}/conversionActions/6666666666"
    }
  ]
}

GAQL ile dönüşüm işlemi ayarlarını ve etiket snippet'lerini inceleme

Dönüşüm izlemeyi etkinleştirme adımları bölümünde gösterilen temel sorguya ek olarak, GoogleAdsService.SearchStream kullanarak conversion_action kaynağını sorgulayarak primary_for_goal, ilişkilendirme modeli durumu, yeniden inceleme aralıkları, değer ayarları ve web sitesi tag_snippets bilgilerini inceleyebilirsiniz:

SELECT
  conversion_action.id,
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.type,
  conversion_action.category,
  conversion_action.status,
  conversion_action.primary_for_goal,
  conversion_action.counting_type,
  conversion_action.click_through_lookback_window_days,
  conversion_action.view_through_lookback_window_days,
  conversion_action.value_settings.default_value,
  conversion_action.value_settings.default_currency_code,
  conversion_action.value_settings.always_use_default_value,
  conversion_action.attribution_model_settings.attribution_model,
  conversion_action.attribution_model_settings.data_driven_model_status,
  conversion_action.tag_snippets
FROM conversion_action
WHERE conversion_action.status = 'ENABLED'

Doğrulamalar

Google Ads ve Google Ads API çok çeşitli dönüşüm işlemlerini desteklediğinden bazı doğrulama kuralları, işlemin type değerine göre değişiklik gösterir.

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ı:

Tüm enum alanları
Herhangi bir enum alanını UNKNOWN olarak ayarlamaya çalışmak RequestError.INVALID_ENUM_VALUE hatasına neden olur.
app_id
app_id özelliği sabittir ve yalnızca yeni bir uygulama dönüşümü oluşturulurken ayarlanabilir.
attribution_model_settings
Bu ayarı desteği sonlandı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 dillerini 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 ile 60 gün arasında olmalıdır. Diğer dönüşüm işlemlerinin çoğunda izin verilen aralık 1 ila 90 gündür.

include_in_conversions_metric

Bu değerin bir create veya update işleminde ayarlanması FieldError.IMMUTABLE_FIELD hatasıyla başarısız olur. Bunun yerine, Dönüşüm hedefleri kılavuzunda açıklandığı şekilde primary_for_goal değerini ayarlayın.

phone_call_duration_seconds

Bu özelliği, telefon 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 sabittir ve yalnızca yeni bir dönüşüm oluşturulurken ayarlanabilir.

type değeri UNKNOWN olan 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, true olarak ayarlanmış always_use_default_value değerine sahip olmalı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 ila 30 gündü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.

Önceki
Dönüşüm işlemi kategorileri
Sonraki
Çevrimdışı dönüşümleri yönetme