Bu kılavuzda, yapabileceğiniz farklı dönüşüm işlemi türlerinin Google Ads API'yi kullanarak oluşturma, bunların Google Ads web ile nasıl eşlendiğine ilişkin bilgiler arayüzü ve Google Ads'de nasıl çalışacağınızı gösteren ayrıntılı bir kod örneği Yeni dönüşüm işlemleri oluşturabilirsiniz.
Dönüşümleri ölçmek için
Şu için ConversionAction
:
type
/
dönüşüm işlemini seçin. Örneğin, internetten satın alma işlemi ve telefon
çağrısı 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 İşlemi kodu örneğini ekleyin. Örnek herkese açık kullanıcı adları
arka plan kimlik doğrulaması görevlerini tamamlamanızı sağlar ve
ConversionAction
.
Çoğu dönüşüm işlemini izlemek için ek adımlar da gerekir gerekir. Örneğin, web sitenizdeki dönüşümleri izlemek için etiket adı verilen snippet . Diğer dönüşüm işlemleri için daha fazla bilgi için Yardım Merkezi makalesi.
Web sitesi dönüşümleri
Web sitesi dönüşümleri, online satış, pazarlama vb. gibi web sitesi işlemlerini bağlantı tıklamaları, sayfa görüntülemeleri ve kayıtlar.
Web sitenizdeki dönüşümleri izlemek için
ConversionAction
şununla:
ConversionActionType
WEBPAGE
olarak ayarlanıp dönüşüme etiket adı verilen bir kod snippet'i ekleyin
ekleyebilirsiniz.
ConversionAction
, pek çok özelliği kapsar.
farklı web sitesi dönüşümü türleri bulunur. Bunlar API'de
Her birinde type
alan
TagSnippet
tag_snippets alanı
ConversionAction
.
TagSnippet
, şu özelliklere sahip olması gereken izleme kodunu sağlar:
web sitenize dahil edilmelerini öneririz.
Web sitesi ve Telefon numarası tıklama dönüşümleri,
event_snippet
,
Bunlar,
ödeme onayı veya potansiyel müşteri formu gönderme sayfası olmalı ve
global_site_tag
,
ve web sitenizin her sayfasına
yüklenmesi gerekir. Hem
bu özellikleri
ConversionActionService
. Ödeme yap
Yardım Merkezimizi ziyaret ederek
Sayfalarınızı etiketleme hakkında bilgi edinin.
Aşağıdaki tabloda her bir öğe için kullanılacak eşdeğer API parametreleri Google Ads web arayüzündeki Kaynak:
İzleme Kodu Türü | Google Ads Kaynağı |
---|---|
WEBPAGE |
Web sitesi, web sitesi (Google Analytics (GA4)) |
WEBPAGE_ONCLICK |
Web sitesi, web sitesi (Google Analytics (GA4)) |
CLICK_TO_CALL |
Telefon numarası tıklamaları |
--- |
Web sitesi (Google Analytics (UA)) |
Uygulama dönüşümleri
Uygulama dönüşümü, mobil uygulama yüklemelerini veya uygulama içi satın alma işlemlerini Google Play Store.
Aşağıdaki tabloda, eşdeğer
ConversionActionType
Google Ads web arayüzündeki her bir Kaynak için kullanılacak API parametreleri:
Dönüşüm İşlemi Türü | Google Ads Kaynağı |
---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > Yükleme sayısı |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > Uygulama içi satın alımlar |
Google Analytics 4'ü kullanarak diğer mobil uygulama işlemlerini izlemek istiyorsanız veya üçüncü taraf uygulama analizleri. Ek Dönüşüm İşlemi Türleri bölümünü inceleyin.
Telefon araması dönüşümleri
Telefon araması dönüşümlerini izleme reklamlardan gelen ve web sitenizdeki numaralara yapılan aramaları izlemenize olanak tanır. Mobil sitelerdeki numaralara yapılan tıklamalar
Aşağıdaki tabloda, eşdeğer
ConversionActionType
Google Ads web arayüzündeki her bir Kaynak için kullanılacak API parametreleri:
Dönüşüm İşlemi Türü | Google Ads Kaynağı |
---|---|
AD_CALL |
Telefon uzantıları kullanan reklamlardan veya yalnızca telefon araması üreten reklamlardan gelen aramalar |
WEBSITE_CALL |
Web sitenizdeki bir telefon numarasına gelen aramalar |
CLICK_TO_CALL |
Mobil web sitenizdeki bir numaraya yapılan tıklamalar |
CLICK_TO_CALL
türü, sağladığı AD_CALL
türünden farklıdır.
gerçek telefon aramalarını izlemez. Bunun yerine, CLICK_TO_CALL
yalnızca
bir mobil cihazdan telefon numarası gibi. Bu, bir
Telefon aramalarını izlemek için Google yönlendirme numarası.
AD_CALL
AD_CALL
dönüşüm işlemi,
Ads dönüşümlerinin sayısı
web arayüzü. AD_CALL
dönüşüm işleminizi oluşturduktan sonra, dönüşüm işlemini belirtin
kaynak adını call_conversion_action
alanına girin.
CallAsset
. Telefon edin
öğeler, uygulamanızın
doğrudan reklamlarınıza ekleyebilirsiniz.
Belirtilen süreden uzun süren aramalar dönüşüm olarak raporlanır. Varsayılan değer 60 saniyedir.
WEBSITE_CALL
CEVAP
WEBSITE_CALL
dönüşüm işlemi, Google'dan gelen
web sitesi dönüşümü
Google Ads web arayüzü.
Beğenmeyi kaldır
AD_CALL
bu takip cihazı için event_snippet
gerekiyor
ve global_site_tag
şuraya eklenecek:
web sitenizi kullanarak arama izleme için dinamik Google yönlendirme numarasını alabilirsiniz
web sitenizde listelenen numaralarda kullanılabilir. Ayrıca, bir telefon görüşmesi
öğeyi şurada bağlayın:
müşteri, kampanya veya reklam grubu düzeyinde daha fazla bilgiye ulaşabilirsiniz.
Çevrimdışı dönüşümleri içe aktarın
Aşağıdaki tabloda, eşdeğer
ConversionActionType
Google Ads web arayüzündeki her Kaynak için kullanılacak API parametreleri
ve her bir dönüşüm işlemi türüyle ilgili dokümanların bağlantısı:
Dönüşüm İşlemi Türü | Google Ads Kaynağı | API Kurulum Kılavuzu |
---|---|---|
UPLOAD_CLICKS |
Şu reklam grupları için tıklamalardan ve gelişmiş dönüşümlerden elde edilen dönüşümleri izleyin: potansiyel müşteriler | Tıklama Rehberi Yükleme
Geliştirilmiş Potansiyel müşteriler için dönüşümler kılavuzu |
UPLOAD_CALLS |
Telefon aramalarından elde edilen dönüşümleri izleyin | API Kurulum Kılavuzu |
STORE_SALES |
Dönüşümler mağaza satışlarını izleyin | API Kurulumu Rehber |
Web için gelişmiş dönüşümler
Şunun için gelişmiş dönüşümler:
web'i kullanarak
Sonraki 24 saat içinde WEBPAGE
dönüşüm işlemi için birinci taraf dönüşüm verileri
bir dönüşüm etkinliği görürsünüz. Bu sayede, araçlar
Müşteri veritabanı veya CRM gibi çeşitli kaynaklardan gelen birinci taraf verileri
bahsedeceğim.
Ek dönüşüm işlemi türleri
Google Ads API, raporlarda ek dönüşüm işlemi türlerini kullanılabilir hale getirir. ancak bu işlemlerin oluşturulmasını veya değiştirilmesini sınırlayabilir ya da yasaklayabilir.
SKAdNetwork dönüşüm sayısı
iOS uygulama kampanyaları yayınlıyorsanız
ve bunları uyguladık.
SKAdNetwork'e erişebilirsiniz.
SKAdNetwork verileri Google'a Customer
ve Campaign
düzeyinde
şu kaynakları inceleyin:
Rapor alanı | Açıklama |
---|---|
metrics.sk_ad_network_installs |
Apple tarafından bildirilen yükleme sayısı. Bu metrik yalnızca segmentlere ayrılabilir
herhangi bir segments.sk_ad_network_conversion_value ve
segmentlere ayırın.
|
metrics.sk_ad_network_total_conversions |
Yüklemeler ve diğer Apple tarafından raporlanan dönüşüm. Bu metrik yalnızca şuna göre segmentlere ayrılabilir: SKAdNetwork ile ilgili segmentler ve tarihle ilgili segmentler. |
segments.sk_ad_network_ad_event_type |
Belirli bir dönüşüm için gerçekleşen etkinliğin türü. |
segments.sk_ad_network_attribution_credit |
İlişkilendirmenin belirli bir dönüşümle ilişkilendirilme şekli. |
segments.sk_ad_network_fine_conversion_value |
Bir dönüşümün Apple tarafından raporlanan değeri. Bu segment uygulanamaz
Apple şu değeri bildirirse |
segments.sk_ad_network_coarse_conversion_value |
Tek bir dönüşümün yaklaşık değeri. |
segments.sk_ad_network_postback_sequence_index |
Belirli bir dönüşüm için geri göndermenin sırayla konumu. |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id |
iOS Store Kit Ad Network yüklemesini artıran reklamın şu uygulama kimliği: gösteriliyor. |
segments.sk_ad_network_source_domain |
iOS Store Kit Ad Network yüklemesini artıran reklamın gösteriliyor. Boş değer, bu segmentin geçerli olmadığı anlamına gelir. Örneğin, iOS dışı bir kampanyada bulunmayan ya da Apple tarafından gönderilen geri göndermelerde yer almayan içerikler |
segments.sk_ad_network_source_type |
iOS Store Kit Ad Network yüklemesini artıran reklamın kaynak türü gösterilmişti. Boş değer, bu segmentin geçerli olmadığı anlamına gelir. Örneğin, iOS dışı kampanya veya ne kaynak alan ne de kaynak uygulama geri göndermelerini paylaşabilirsiniz. |
segments.sk_ad_network_user_type |
Belirli bir dönüşümü oluşturan kullanıcının türü. |
segments.sk_ad_network_redistributed_fine_conversion_value |
Bu segmentteki dönüşüm değerleri boş değerler içeriyor dönüşüm değerlerine yeniden dağıtılır. Bu segment, şunların toplamını temsil eder: Apple tarafından döndürülen ayrıntılı dönüşüm değerleri ve modellenmiş boş değerler Google'dan. |
segments.sk_ad_network_version |
Kullanılan iOS Store Kit Ad Network API sürümü. |
Ayrıca, bağlı olan belirli kampanyalar için SKAdNetwork dönüşüm değeri eşlemesi de kaydedebilirsiniz
CustomerSkAdNetworkConversionValueSchema
üzerinden iOS uygulamaları olan müşterilere.
Örnek Python kodu
#!/usr/bin/env python # Copyright 2019 Google LLC # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # https://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. import argparse import sys from google.ads.googleads.client import GoogleAdsClient from google.ads.googleads.errors import GoogleAdsException def main(client, customer_id): """Adds a keyword plan, campaign, ad group, etc. to the customer account. Also handles errors from the API and prints them. Args: client: An initialized instance of GoogleAdsClient customer_id: A str of the customer_id to use in requests. """ res = update_skan_cv_schema( client, customer_id, "my_app_id", "account_link_id" ) print(res) def update_skan_cv_schema(client, customer_id, app_id, account_link_id): skan_service = client.get_service( "CustomerSkAdNetworkConversionValueSchemaService" ) req = client.get_type( "MutateCustomerSkAdNetworkConversionValueSchemaRequest" ) operation = client.get_type( "CustomerSkAdNetworkConversionValueSchemaOperation" ) schema_instance = client.get_type( "CustomerSkAdNetworkConversionValueSchema" ) new_schema = operation.update new_schema.resource_name = ( skan_service.customer_sk_ad_network_conversion_value_schema_path( "customer_id", "account_link_id" ) ) new_schema.schema.app_id = app_id new_schema.schema.measurement_window_hours = 48 skan_cv_mapping = ( schema_instance.SkAdNetworkConversionValueSchema.FineGrainedConversionValueMappings() ) skan_cv_mapping.fine_grained_conversion_value = 0 # 0 - 63 skan_cv_mapping.conversion_value_mapping.min_time_post_install_hours = 0 skan_cv_mapping.conversion_value_mapping.max_time_post_install_hours = 48 skan_cv_event = schema_instance.SkAdNetworkConversionValueSchema.Event() skan_cv_event.mapped_event_name = "TEST" skan_cv_event.event_revenue_value = 10 skan_cv_mapping.conversion_value_mapping.mapped_events.append(skan_cv_event) new_schema.schema.fine_grained_conversion_value_mappings.append( skan_cv_mapping ) req.operation = operation req.customer_id = customer_id res = skan_service.mutate_customer_sk_ad_network_conversion_value_schema( req ) return res if __name__ == "__main__": # GoogleAdsClient will read the google-ads.yaml configuration file in the # home directory if none is specified. googleads_client = GoogleAdsClient.load_from_storage( version="v17" ) parser = argparse.ArgumentParser( description="Creates a keyword plan for specified customer." ) # The following argument(s) should be provided to run the example. parser.add_argument( "-c", "--customer_id", type=str, required=True, help="The Google Ads customer ID.", ) args = parser.parse_args() try: main(googleads_client, args.customer_id) except GoogleAdsException as ex: print( f'Request with ID "{ex.request_id}" failed with status ' f'"{ex.error.code().name}" and includes the following errors:' ) for error in ex.failure.errors: print(f'\tError with message "{error.message}".') if error.location: for field_path_element in error.location.field_path_elements: print(f"\t\tOn field: {field_path_element.field_name}") sys.exit(1)
Google Analytics
Bağlı bir Google Analytics mülkündeki dönüşümler aşağıdakilerden birine sahiptir:
type
değerleri:
GA4 mülkü dönüşümü:
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
GA4 mülk kimliğini, mülk adını ve etkinlik adını şuradan da alabilirsiniz: "the"
google_analytics_4_settings
girin.Universal Analytics mülkü dönüşümü:
UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
GA4 mülkü dönüşümünde aşağıdaki değişiklikleri yapabilirsiniz:
- GA4 mülkünüzdeki dönüşümü Google Ads hesabınıza aktarmak için:
status
alanınınHIDDEN
olan değeriENABLED
olarak değiştiriliyor. - Nasıl olması gerektiğini belirtmek için
primary_for_goal
vecategory
alanlarını değiştirerek Google Ads tekliflerini ve raporlarını etkileyebilir. name
veyavalue_settings
alanını güncelleyin.remove
işlemini kullanarak dönüşümü Google Ads hesabınızdan kaldırın.
İçe aktarılan bir GA4 dönüşümünün diğer özelliklerini veya herhangi bir
içe aktarılan bir Universal Analytics dönüşümünün özellikleri,
MUTATE_NOT_ALLOWED
hata. Bu değişiklikleri yalnızca Google Ads kullanıcı arayüzünü kullanarak yapabilirsiniz.
Firebase ve üçüncü taraf uygulama analizleri
İçe aktarmak için
üçüncü taraf uygulama analizleri
veya Firebase dönüşümlerini kullanıyorsanız
şunun status
değerini değiştirin:
mutate
yöntemini kullanarak HIDDEN
- ENABLED
arası ConversionAction
ConversionActionService
.
app_id
şunlar için desteklenmez:
dönüşüm işlemleri.
FIREBASE_ANDROID_FIRST_OPEN
FIREBASE_ANDROID_IN_APP_PURCHASE
FIREBASE_ANDROID_CUSTOM
FIREBASE_IOS_FIRST_OPEN
FIREBASE_IOS_IN_APP_PURCHASE
FIREBASE_IOS_CUSTOM
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
Mağaza satışları
STORE_SALES
veya STORE_SALES_DIRECT_UPLOAD
öğelerini oluşturamazsınız ancak
Google Ads API kullanılarak gerçekleştirilen dönüşüm işlemleri için mağaza yüklemeyi
satış işlemleri ile ilgili daha fazla bilgi edinin.
STORE_SALES
STORE_SALES_DIRECT_UPLOAD
Çeşitli
Aşağıdaki dönüşüm işlemi türleri Google Ads API'de salt okunurdur ve yalnızca raporlamaya uygun olacaktır.
ANDROID_APP_PRE_REGISTRATION
ANDROID_INSTALLS_ALL_OTHER_APPS
FLOODLIGHT_ACTION
FLOODLIGHT_TRANSACTION
GOOGLE_HOSTED
LEAD_FORM_SUBMIT
SALESFORCE
SEARCH_ADS_360
SMART_CAMPAIGN_AD_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS
SMART_CAMPAIGN_TRACKED_CALLS
STORE_VISITS
WEBPAGE_CODELESS
Bilinmiyor
Google Ads hesabınız başka dönüşüm işlemi türlerini içeriyorsa
dönüşüm işlemlerini döndürdüğünden emin olmak için
ConversionAction.type
için UNKNOWN
.
API bu dönüşüm işlemlerinin yönetilmesini desteklemez ancak bunları
gibi temel dönüşüm metrikleri için eksiksiz sonuçlar sunmak üzere Google Analytics raporlarını kullanabilirsiniz.
metrics.conversions
ve metrics.conversions_value
.
Kod örneği
Aşağıdaki kod örneği, yeni bir veri kaynağı oluşturma işleminde size
dönüşüm işlemidir. Daha ayrıntılı ifade etmek gerekirse,
type
şu şekilde ayarlandı:
UPLOAD_CLICKS
.
Bu,
İçe aktar > API veya yüklemelerle manuel içe aktarma > Şu tarihten itibaren gerçekleşen dönüşümleri izleyin:
tıklama sayısı. Ayrıca category
Hedef: DEFAULT
.
Aşağıdaki varsayılan ayarlar geçerlidir:
Google Ads API,
primary_for_goal
alanı ancak bu alanı, bir dönüşüm izleme aracının nasıl dönüşüm işlemi, birlikte kullanıldığında hesabınızdaki raporlama ve teklifleri etkiler etkinleştirmeniz gerektiğini unutmayın.Google Ads API, Otomatik olarak
counting_type
Hedef:MANY_PER_CLICK
. Daha fazla ayrıntı için Dönüşüm sayma seçenekleri hakkında bölümüne bakın.Google Ads API, ilişkilendirme modelini Veri önceliklerini belirleyebilirsiniz
attribution_model_settings
alanınıGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN
değeriAttributionModel
.
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.V17.ConversionActionService); // Note that conversion action names must be unique. // If a conversion action already exists with the specified name the create operation // will fail with a ConversionAction.DUPLICATE_NAME error. string ConversionActionName = "Earth to Mars Cruises Conversion #" + ExampleUtilities.GetRandomString(); // Add a conversion action. ConversionAction conversionAction = new ConversionAction() { Name = ConversionActionName, Category = ConversionActionCategory.Default, Type = ConversionActionType.Webpage, Status = ConversionActionStatus.Enabled, ViewThroughLookbackWindowDays = 15, ValueSettings = new ConversionAction.Types.ValueSettings() { DefaultValue = 23.41, AlwaysUseDefaultValue = true } }; // Create the operation. ConversionActionOperation operation = new ConversionActionOperation() { Create = conversionAction }; try { // Create the conversion action. MutateConversionActionsResponse response = conversionActionService.MutateConversionActions(customerId.ToString(), new ConversionActionOperation[] { operation }); // Display the results. foreach (MutateConversionActionResult newConversionAction in response.Results) { Console.WriteLine($"New conversion action with resource name = " + $"'{newConversionAction.ResourceName}' was added."); } } catch (GoogleAdsException e) { Console.WriteLine("Failure:"); Console.WriteLine($"Message: {e.Message}"); Console.WriteLine($"Failure: {e.Failure}"); Console.WriteLine($"Request ID: {e.RequestId}"); throw; } }
PHP
public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId) { // Creates a conversion action. $conversionAction = new ConversionAction([ // Note that conversion action names must be unique. // If a conversion action already exists with the specified conversion_action_name // the create operation will fail with a ConversionActionError.DUPLICATE_NAME error. 'name' => 'Earth to Mars Cruises Conversion #' . Helper::getPrintableDatetime(), 'category' => ConversionActionCategory::PBDEFAULT, 'type' => ConversionActionType::WEBPAGE, 'status' => ConversionActionStatus::ENABLED, 'view_through_lookback_window_days' => 15, 'value_settings' => new ValueSettings([ 'default_value' => 23.41, 'always_use_default_value' => true ]) ]); // Creates a conversion action operation. $conversionActionOperation = new ConversionActionOperation(); $conversionActionOperation->setCreate($conversionAction); // Issues a mutate request to add the conversion action. $conversionActionServiceClient = $googleAdsClient->getConversionActionServiceClient(); $response = $conversionActionServiceClient->mutateConversionActions( MutateConversionActionsRequest::build($customerId, [$conversionActionOperation]) ); printf("Added %d conversion actions:%s", $response->getResults()->count(), PHP_EOL); foreach ($response->getResults() as $addedConversionAction) { /** @var ConversionAction $addedConversionAction */ printf( "New conversion action added with resource name: '%s'%s", $addedConversionAction->getResourceName(), PHP_EOL ); } }
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::V17::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V17::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V17::Services::ConversionActionService::ConversionActionOperation ->new({create => $conversion_action}); # Add the conversion action. my $conversion_actions_response = $api_client->ConversionActionService()->mutate({ customerId => $customer_id, operations => [$conversion_action_operation]}); printf "New conversion action added with resource name: '%s'.\n", $conversion_actions_response->{results}[0]{resourceName}; return 1; }
Bu örnek, müşteri kitaplığınızın Yeniden Pazarlama klasöründe de bulunabilir ve kod örnekleri koleksiyonunda: Dönüşüm İşlemi kodunu ekle örnek bölümüne bakın.
Doğrulamalar
Google Ads ve Google Ads API çok çeşitli dönüşüm işlemlerini destekler. Dolayısıyla
doğrulama kuralları şuna göre değişir: type
eyleme dökülebilir.
Dönüşüm işlemi oluştururken bugüne kadar yapılan en yaygın hatalardan biri
DUPLICATE_NAME
.
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 sıralama alanları
- Herhangi bir numaralandırma alanı
UNKNOWN
olarak ayarlanmaya çalışıldığındaRequestError.INVALID_ENUM_VALUE
hata. app_id
app_id
özelliği sabittir ve yalnızca yeni bir öğe oluştururken ayarlanabilir en iyi uygulamaları görelim.attribution_model_settings
- Bunu desteği sonlanan bir
seçeneği
ile sonuçlanır
CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
hatası. Google Ads yalnızcaGOOGLE_ADS_LAST_CLICK
veGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN
. click_through_lookback_window_days
Bu özelliğin izin verilen aralığın dışında bir değere ayarlanması,
RangeError.TOO_LOW
veyaRangeError.TOO_HIGH
hata.Bu özellik,
AD_CALL
için[1,60]
veyaWEBSITE_CALL
dönüşüm işlemi. Diğer dönüşüm işlemlerinin çoğunda izin verilen aralık:[1,30]
.include_in_conversions_metric
create
veyaupdate
işleminde bu değerin ayarlanmasıFieldError.IMMUTABLE_FIELD
hata. Bunun yerine,primary_for_goal
değerini şu şekilde ayarla: Dönüşüm hedefleri kılavuzunda açıklanmıştır.phone_call_duration_seconds
Telefon aramasıyla ilgili olmayan bir dönüşüm işleminde bu özellik ayarlanmaya çalışılıyor
FieldError.VALUE_MUST_BE_UNSET
hatasıyla sonuçlanır.type
type
özelliği sabittir ve yalnızca yeni bir öğe oluştururken ayarlanabilir. gösterir.Bir dönüşüm işlemini
type
eşit olacak şekilde güncelleme:UNKNOWN
sonuçtaMutateError.MUTATE_NOT_ALLOWED
hata.value_settings
WEBSITE_CALL
veyaAD_CALL
dönüşüm işlemi içinvalue_settings
always_use_default_value
,true
olarak ayarlanmış.false
değeri belirtiliyorINVALID_VALUE
hatasıyla sonuçlanıyor.view_through_lookback_window_days
Bu özelliğin izin verilen aralığın dışında bir değere ayarlanması,
RangeError.TOO_LOW
veyaRangeError.TOO_HIGH
hata. Çoğu dönüşüm için işlemleri için izin verilen aralık:[1,30]
.Bu özellik,
AD_CALL
veyaWEBSITE_CALL
dönüşümünde ayarlanamaz işlemlerdir. Değer belirtildiğindeVALUE_MUST_BE_UNSET
hatası verilir.