Dönüşüm İşlemleri Oluşturma

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'le 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 oluşturabilirsiniz. Ö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 için 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: Arama izleme için dinamik Google yönlendirme numarasını almak üzere web sitenizi 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 düzenleyebilirsiniz.

Ç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, trafiğin 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 metrics.sk_ad_network_installs dışındaki metriklere metrics.sk_ad_network_total_conversions ve yalnızca tarihle ilgili segmentlerle birleştirilebilir.

Apple şu değeri bildirirse 0 değeri döndürülür: 0, aksi takdirde herhangi bir değer yoktur. alanı varlığıyla kullanın.

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:

İç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ı

Ancak STORE_SALES veya STORE_SALES_DIRECT_UPLOAD öğelerini oluşturamazsınız 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ı arama sorguları gibi temel dönüşüm metrikleri için eksiksiz sonuçlar sunmak üzere 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:

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ığında RequestError.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ızca GOOGLE_ADS_LAST_CLICK ve GOOGLE_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 veya RangeError.TOO_HIGH hata.

Bu özellik AD_CALL için [1,60] veya WEBSITE_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 veya update 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

Bu özellik telefon aramasıyla ilgili olmayan bir dönüşüm işleminde 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çta MutateError.MUTATE_NOT_ALLOWED hata.

value_settings

WEBSITE_CALL veya AD_CALL dönüşüm işlemi için value_settings always_use_default_value, true olarak ayarlanmış. false değeri belirtiliyor INVALID_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 veya RangeError.TOO_HIGH hata. Çoğu dönüşüm için işlemleri için izin verilen aralık: [1,30].

Bu özellik, AD_CALL veya WEBSITE_CALL dönüşümünde ayarlanamaz işlemlerdir. Değer belirtildiğinde VALUE_MUST_BE_UNSET hatası verilir.