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şlemini izlemek için sizin de 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 oluşturma kılavuzu'nu inceleyin.
Dönüşümleri izlemek için web sitenizi ayarlama
Çevrimdışı dönüşüm içe aktarma entegrasyonunu 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üşümlerle ilgili Google etiketini yapılandırma kılavuzundaki adımları uygulamaktır. Web sitenizi yapılandırmak için Google Etiket Yöneticisi'ni de kullanabilirsiniz. Bunun için Potansiyel müşteriler için gelişmiş dönüşümler özelliğini etkinleştirmek üzere Google Etiket Yöneticisi'ni yapılandırma başlıklı kılavuzdaki adımları uygulayın.
Google Ads dönüşüm hesabınızda dönüşüm izlemeyi etkinleştirin.
Dönüşüm izleme ayarlarınızla ilgili bilgileri alma
Hesabınızın dönüşüm izleme ayarlarını kontrol edebilir ve Customer kaynağını ConversionTrackingSetting için sorgulayarak dönüşüm izlemenin etkinleştirildiğini 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, bir yönetici hesabının kimliğidir. Google Ads dönüşümü müşteri kimliği, dönüşüm oluşturma ve yönetme için Google Ads API isteklerinde customer_id olarak verilmelidir.
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 izleme 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 etkinleştirilmemiştir. Google Ads dönüşüm hesabında aşağıdaki örnekteki 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 Yardım Merkezi'ndeki talimatları uygulayarak kullanıcı arayüzünde bir dönüşüm işlemi oluşturabilirsiniz.
Google Ads API aracılığıyla gönderildiğinde gelişmiş dönüşümlerin otomatik olarak etkinleştirildiğini ancak Google Ads kullanıcı arayüzü aracılığıyla 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.V22.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::V22::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V22::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V22::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ş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
Aşağıdaki sorguyu göndererek mevcut bir dönüşüm işleminin ayrıntılarını alabilirsiniz. İstekteki müşteri kimliğinin yukarıda tanımladığınız Google Ads dönüşüm müşterisi olarak ayarlandığından ve dönüşüm işlemi türünün doğru ConversionActionType değeri olarak 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 izlemeyi kullanıyorsanız ConversionActionService aşağıdaki dönüşüm işlemlerini döndürür:
- Hesabın hesaplar arası dönüşüm izleme için kullandığı yönetici hesabı tarafından tanımlanan tüm dönüşüm işlemleri
- Müşterinin istatistik topladığı tüm dönüşüm işlemleri (sistem tarafından tanımlanan işlemler ve yöneticiye ait işlemler dahil)
- Müşterinin kendi hesabında tanımladığı tüm işlemler
- Bağlı Google Analytics mülklerinde oluşturulan Analytics dönüşümleri.
Bu, Google Ads'e aktarılmayan ve
HIDDENdurumuna sahip Analytics dönüşümleriyle ilgili işlemleri içerir.
v19.1 itibarıyla, Google Ads API'yi kullanarak müşteri hesapları oluştururken dönüşümler arası izlemeyi etkinleştirebilirsiniz.
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ı olarak 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, Google Ads API'yi kullanarak hem müşteri hesapları oluştururken hem de bunları güncellerken dönüşümler arası izlemeyi etkinleştirebilirsiniz.
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, müşteri hesabı adına dönüşüm işlemlerini yönetmesi gereken yönetici hesabının kaynak adı olarak ayarlanmalıdır.
Bu yönetici hesabı, müşteri hesabı için update isteğini gönderen hesap da olmalıdır.
NOT: Bir müşteri hesabının hesaplar arası dönüşüm izleme ayarlarını değiştirmek için Google Ads API'sini kullanmak yalnızca izin verilenler listesi özelliğidir. Kullanmak için hesap yöneticinizle iletişime geçin.
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ı, varsayılan dönüşüm değeri kurallarını ve yeni dönüşüm izleme yöneticisinin varsayılan müşteri yaşam döngüsü hedeflerini kullanır.
- Belirli bir dönüşüm işlemini hedefleyen kampanyalar, dönüşüm yöneticisi hesabının varsayılan dönüşüm hedeflerini kullanmaya geçer. Belirli bir dönüşüm işlemini hedeflemeye devam ederseniz bu durum tutarsız davranışlara neden olabilir. Bunun nedeni, yönetici hesabının müşteri hesabıyla aynı hedeflere sahip olmamasıdır. Kampanyalarınızın doğru hedefler için 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 ConversionAction oluşturun. Örneğin, internetten 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 aşağıdaki dönüşüm işlemi ekleme kodu örneğini kullanmaktır. Örnek, arka plandaki tüm kimlik doğrulama görevlerini sizin için gerçekleştirir ve ConversionAction oluşturma sürecinde size yol gösterir.
Çoğu dönüşüm işlemini izlemek için sizin de 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 Yardım Merkezi makalemizi inceleyin.
Kod örneği
Aşağıdaki kod örneğinde yeni bir dönüşüm işlemi oluşturma süreci açıklanmaktadır. Daha net bir ifadeyle, bu işlem, type ayarı UPLOAD_CLICKS olarak belirlenmiş bir dönüşüm işlemi oluşturur.
Ayrıca category değerini DEFAULT olarak ayarlar.
Aşağıdaki varsayılan ayarlar geçerlidir:
Google Ads API,
primary_for_goalalanını otomatik olarak ayarlar ancak bu alanı açıkça ayarlayarak bir dönüşüm işleminin, dönüşüm hedeflerinizle birleştirildiğinde hesabınızdaki raporlamayı ve teklif vermeyi nasıl etkileyeceğini kontrol edebilirsiniz.Google Ads API,
counting_typeotomatik olarakMANY_PER_CLICKolarak ayarlar. Daha fazla bilgi için Dönüşüm sayma seçenekleri hakkında başlıklı makaleyi inceleyin.Google Ads API,
attribution_model_settingsalanınıGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVENdeğerineAttributionModelayarlayarak ilişkilendirme modelini Veriye Dayalı olarak ayarlar. İlişkilendirme modelleri hakkında daha fazla bilgi edinmek için bu Yardım Merkezi makalesini inceleyin.
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.V22.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::V22::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V22::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V22::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 kod örnekleri koleksiyonunda (Dönüşüm işlemi kodu ekleme örneği) görebilirsiniz.
Doğrulamalar
Google Ads ve Google Ads API, çok çeşitli dönüşüm işlemlerini destekler. Bu nedenle, bazı doğrulama kuralları type işlemine göre değişir.
Dönüşüm işlemi oluştururken en sık karşılaşılan hata DUPLICATE_NAME'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ını aşağıda bulabilirsiniz:
- Tüm enum alanları
- Herhangi bir enum alanını
UNKNOWNolarak ayarlamaya çalışmakRequestError.INVALID_ENUM_VALUEhatasıyla sonuçlanır. app_id-
app_idözelliği sabittir ve yalnızca yeni bir uygulama dönüşümü oluşturulurken ayarlanabilir. attribution_model_settings- Bunu kullanımdan kaldırılmış bir seçeneğe ayarlamak
CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELShatasına neden olur. Google Ads yalnızcaGOOGLE_ADS_LAST_CLICKveGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVENöğelerini destekler. click_through_lookback_window_daysBu özelliği izin verilen aralığın dışında bir değere ayarlamak
RangeError.TOO_LOWveyaRangeError.TOO_HIGHhatasına neden olur.Bu özellik,
AD_CALLveyaWEBSITE_CALLdö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].include_in_conversions_metricBu değeri bir
createveyaupdateişleminde ayarlamakFieldError.IMMUTABLE_FIELDhatasıyla başarısız olur. Bunun yerine,primary_for_goalDönüşüm hedefleri kılavuzunda açıklandığı şekilde ayarlayın.phone_call_duration_secondsBu özelliği, aramalar için olmayan bir dönüşüm işleminde ayarlamaya çalışmak
FieldError.VALUE_MUST_BE_UNSEThatasına neden olur.typetypeözelliği sabittir ve yalnızca yeni bir dönüşüm oluşturulurken ayarlanabilir.typedeğeriUNKNOWNolan bir dönüşüm işleminin güncellenmesiMutateError.MUTATE_NOT_ALLOWEDhatasına neden olur.value_settingsWEBSITE_CALLveyaAD_CALLdönüşüm işlemi içinvalue_settings,always_use_default_valuedeğeritrueolarak ayarlanmış olmalıdır. Bu değeri oluştururken veya güncellerkenfalsedeğerinin belirtilmesiINVALID_VALUEhatasına neden olur.view_through_lookback_window_daysBu özelliği izin verilen aralığın dışında bir değere ayarlamak
RangeError.TOO_LOWveyaRangeError.TOO_HIGHhatasına neden olur. Çoğu dönüşüm işlemi için izin verilen aralık[1,30]'dır.Bu özellik,
AD_CALLveyaWEBSITE_CALLdönüşüm işlemlerinde ayarlanamaz. Bir değer belirtmekVALUE_MUST_BE_UNSEThatasına neden olur.