Memulai

Anda harus mengaktifkan tracking konversi di akun konversi Google Ads untuk mencatat konversi. Panduan ini memberikan detail tentang cara mengonfirmasi apakah tracking konversi diaktifkan, mengaktifkannya jika belum diaktifkan, dan mengambil informasi tentang tindakan konversi yang ada.

Sebagian besar tindakan konversi juga memerlukan langkah tambahan dari Anda untuk melacaknya. Untuk informasi selengkapnya tentang berbagai jenis tindakan konversi dan persyaratannya, lihat Kategori tindakan konversi dan Membuat tindakan konversi.

Saat mengimpor konversi atau data pengguna, Anda harus mengonfirmasi bahwa Anda memiliki izin untuk membagikan data konversi kepada Google. Anda dapat melakukannya dengan salah satu dari dua cara berikut:

  1. Konfigurasi setelan izin default tingkat akun. Di UI Google Ads, klik Alat > Pengelola Data > Setelan izin > Setelan izin default.
  2. Tetapkan kolom izin pada setiap payload data pengguna atau konversi yang diimpor (misalnya, ClickConversion.consent, CallConversion.consent, atau UserData.consent).

Menyiapkan situs untuk melacak konversi

Jika Anda melacak konversi situs atau menerapkan konversi yang disempurnakan untuk prospek, konfigurasikan pemberian tag situs terlebih dahulu. Ikuti langkah-langkah di Mengonfigurasi tag Google untuk konversi yang disempurnakan untuk lead, atau gunakan Google Tag Manager dengan mengikuti Mengonfigurasi Google Tag Manager untuk konversi yang disempurnakan untuk lead.

Mengaktifkan tracking konversi di akun konversi Google Ads Anda

Ikuti langkah-langkah berikut untuk memverifikasi penyiapan tracking konversi akun Anda dan membuat atau mengambil tindakan konversi.

Langkah-langkah untuk mengaktifkan tracking konversi

Mengambil informasi tentang penyiapan tracking konversi Anda

Anda dapat memeriksa penyiapan tracking konversi akun dan mengonfirmasi bahwa tracking konversi diaktifkan dengan mengkueri resource Customer untuk ConversionTrackingSetting. Keluarkan kueri berikut dengan GoogleAdsService.SearchStream:

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

Kolom google_ads_conversion_customer menunjukkan akun Google Ads yang membuat dan mengelola konversi untuk pelanggan ini. Untuk pelanggan yang menggunakan tracking konversi lintas-akun, ini adalah ID akun pengelola. ID pelanggan konversi Google Ads harus diberikan sebagai customer_id dalam permintaan Google Ads API untuk membuat dan mengelola konversi. Perhatikan bahwa kolom ini diisi meskipun tracking konversi tidak diaktifkan.

Kolom conversion_tracking_status menunjukkan apakah tracking konversi diaktifkan dan apakah akun menggunakan tracking konversi lintas-akun.

Membuat tindakan konversi di pelanggan konversi Google Ads

Jika nilai conversion_tracking_status adalah NOT_CONVERSION_TRACKED, tracking konversi tidak diaktifkan untuk akun. Aktifkan tracking konversi dengan membuat setidaknya satu ConversionAction di akun konversi Google Ads, seperti dalam contoh berikut. Atau, Anda dapat membuat tindakan konversi di UI dengan mengikuti petunjuk dalam artikel Pusat Bantuan Google Ads tentang penyiapan tracking konversi untuk jenis konversi yang ingin Anda aktifkan.

Perhatikan bahwa konversi yang disempurnakan diaktifkan secara otomatis saat dikirim melalui Google Ads API, tetapi dapat dinonaktifkan melalui UI Google Ads.

Contoh kode

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

Pastikan type ditetapkan ke nilai ConversionActionType yang benar. Untuk panduan selengkapnya tentang cara membuat tindakan konversi di Google Ads API, lihat Membuat tindakan konversi.

Mengambil tindakan konversi yang ada

Anda dapat mengambil detail untuk tindakan konversi yang ada dengan mengeluarkan kueri berikut. Pastikan ID pelanggan dalam permintaan ditetapkan ke pelanggan konversi Google Ads yang Anda identifikasi sebelumnya, dan jenis tindakan konversi ditetapkan ke nilai ConversionActionType yang benar.

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'

Tracking konversi lintas-akun

Tracking konversi lintas-akun memungkinkan akun Google Ads mengimpor konversi atas nama akun lain, yang mungkin telah memproses iklan yang menghasilkan konversi. Hal ini dapat membantu menyederhanakan integrasi Anda dengan memungkinkan Anda menggabungkan akun yang membuat permintaan impor.

Mengaktifkan tracking konversi lintas-akun di Google Ads API

Anda dapat menggunakan Google Ads API untuk mengaktifkan tracking konversi silang saat membuat atau memperbarui akun klien.

Pada resource Customer, tetapkan kolom conversion_tracking_setting.google_ads_conversion_customer ke nama resource akun pengelola yang akan mengelola tindakan konversi atas nama akun klien.

Permintaan yang mengubah pelanggan konversi akun klien harus dikirim oleh akun pengelola yang menjadi pelanggan konversi baru untuk klien. Lakukan ini dengan menetapkan login-customer-id ke ID akun pengelola.

Saat Anda memilih menggunakan tracking konversi lintas-akun, atau beralih pengelola tracking konversi untuk akun klien yang ada, peringatan yang sama berlaku seolah-olah Anda membuat perubahan ini di UI. Khususnya:

  • Akun klien akan menggunakan aturan nilai konversi default, dan sasaran siklus proses pelanggan default dari pengelola tracking konversi barunya.
  • Kampanye yang menarget tindakan konversi tertentu akan beralih menggunakan sasaran konversi default akun pengelola konversi. Jika Anda terus menarget tindakan konversi tertentu, hal ini dapat menghasilkan perilaku yang tidak konsisten, karena akun pengelola mungkin tidak memiliki sasaran yang sama dengan akun klien. Pastikan kampanye Anda dioptimalkan untuk sasaran yang tepat.
  • Jika akun dimiliki oleh lebih dari satu akun pengelola, akun tersebut hanya dapat menggunakan tindakan konversi dari satu pengelola. Jika tidak ada akun tracking konversi yang ditentukan, akun tersebut akan menggunakan dirinya sendiri sebagai akun tracking konversi secara default.

Mengimpor konversi di berbagai akun

Dengan mengaktifkan pelacakan lintas-akun, akun klien dan pengelola dapat mengimpor konversi atas nama akun penayangan. Hal ini memungkinkan Anda menyederhanakan logika impor sehingga Anda tidak perlu menentukan akun penayangan untuk setiap konversi pada waktu impor, Anda cukup memilih satu akun dari hierarki akun untuk mengimpor semua konversi.

Agar berhasil mengupload konversi, akun yang mengupload harus memiliki akses ke tindakan konversi. Dalam hierarki tracking lintas-akun, akun yang mengupload memiliki akses ke tindakan jika akun tersebut adalah induk (pengelola) atau turunan dari pemilik tindakan konversi di hierarki akun.

Diagram berikut mengilustrasikan struktur otorisasi untuk mengimpor konversi. Di sini, C1 adalah akun klien yang menayangkan iklan yang menghasilkan konversi, dan M2 adalah pemilik tindakan konversi dan induk tracking konversi C1. Akun yang ditandai dengan warna hijau diizinkan untuk mengimpor konversi atas nama C1, sedangkan akun yang ditandai dengan warna merah tidak diizinkan.

Struktur otorisasi

Buat tindakan konversi

Untuk mengukur konversi, siapkan ConversionAction untuk type tindakan konversi yang ingin Anda lacak. Misalnya, pembelian online dan panggilan telepon memerlukan tindakan konversi yang berbeda.

Cara terbaik untuk menyiapkan tindakan konversi baru di API adalah menggunakan contoh kode Tambahkan Tindakan Konversi. Contoh ini menangani semua tugas autentikasi latar belakang untuk Anda, dan memandu Anda membuat ConversionAction.

Sebagian besar tindakan konversi juga memerlukan langkah tambahan dari Anda untuk melacaknya. Misalnya, untuk melacak konversi di situs, Anda harus menambahkan cuplikan kode yang disebut tag ke halaman konversi di situs Anda. Untuk persyaratan mendetail jenis tindakan konversi lainnya, lihat artikel Pusat Bantuan Google Ads tentang jenis konversi.

Jika Anda menggunakan tracking konversi lintas-akun, ConversionActionService akan menampilkan tindakan konversi berikut:

  • Semua tindakan konversi yang ditentukan oleh akun pengelola yang digunakan oleh akun untuk tracking konversi lintas-akun
  • Semua tindakan konversi yang telah mengumpulkan statistik pelanggan, termasuk tindakan yang ditentukan sistem, dan tindakan yang dimiliki oleh pengelola meskipun pengelola tersebut kemudian membatalkan tautan
  • Semua tindakan yang telah ditentukan pelanggan di akunnya sendiri
  • Konversi Analytics yang dibuat di properti Google Analytics tertaut. Tindakan ini mencakup tindakan untuk konversi Analytics yang tidak diimpor ke Google Ads, yang memiliki status HIDDEN.

Contoh kode

Contoh kode berikut akan memandu Anda melalui proses pembuatan tindakan konversi baru. Secara khusus, tindakan ini membuat tindakan konversi dengan type ditetapkan ke UPLOAD_CLICKS. Tindakan ini juga menetapkan category ke DEFAULT.

Setelan default berikut berlaku:

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

Anda dapat melihat contoh ini di folder Pemasaran Ulang pada library klien Anda dan di koleksi contoh kode: Contoh kode Tambahkan Tindakan Konversi.

Referensi kolom ConversionActionService.MutateConversionActions

Gunakan MutateConversionActions di ConversionActionService untuk membuat, memperbarui, atau menghapus tindakan konversi di pelanggan konversi Google Ads:

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

Tabel berikut mencantumkan kolom permintaan dan operasi tingkat teratas di MutateConversionActionsRequest:

Kolom Persyaratan Deskripsi
customer_id Wajib ID 10 digit (string) pelanggan konversi iklan Google Ads (google_ads_conversion_customer), tanpa tanda hubung.
partial_failure Opsional Jika true (bool), operasi yang valid akan dijalankan dan operasi yang gagal akan menampilkan error di partial_failure_error. Defaultnya adalah false.
validate_only Opsional Jika true (bool), memvalidasi permintaan tanpa menjalankan mutasi.
response_content_type Opsional ResponseContentType mengontrol apakah respons hanya menampilkan resource_name (RESOURCE_NAME_ONLY, default) atau objek ConversionAction yang diubah (MUTABLE_RESOURCE).
operations[].create Wajib (saat pembuatan) Resource ConversionAction yang akan dibuat. resource_name diperkirakan tidak akan terjadi.
operations[].update Wajib (saat update) Resource ConversionAction yang akan diupdate (harus menyertakan resource_name dan update_mask yang setara di ConversionActionOperation).
operations[].update_mask Wajib (saat update) FieldMask (daftar jalur kolom ConversionAction yang diubah dan dipisahkan koma di snake_case; updateMask REST JSON menerima snake_case atau camelCase, sedangkan gRPC dan library klien memerlukan snake_case) di ConversionActionOperation (induk yang sama dengan update, tidak bertingkat di dalam ConversionAction).
operations[].remove Wajib (saat penghapusan) Nama resource (customers/{customer_id}/conversionActions/{action_id}) tindakan konversi yang akan dihapus.

Saat mengonfigurasi ConversionAction di operations[].create atau operations[].update, perhatikan persyaratan kolom dan batasan mutabilitas berikut (lihat Validasi untuk aturan error khusus jenis):

Kolom ConversionAction Persyaratan dan mutabilitas Deskripsi
name Wajib (dapat diubah) Nama tampilan unik (string) dalam akun pelanggan konversi.
type Wajib di create (IMMUTABLE) ConversionActionType (seperti WEBPAGE, UPLOAD_CLICKS, UPLOAD_CALLS, AD_CALL, atau WEBSITE_CALL).
category Opsional (dapat diubah) ConversionActionCategory (seperti DEFAULT, PURCHASE, SUBMIT_LEAD_FORM, SIGNUP, atau PHONE_CALL_LEAD). Defaultnya adalah DEFAULT.
status Opsional (dapat diubah) ConversionActionStatus (ENABLED, REMOVED, atau HIDDEN). Defaultnya adalah ENABLED.
primary_for_goal Opsional (dapat diubah) bool mengontrol apakah tindakan dapat di-bid dalam sasaran konversi pelanggan dan kampanye standar (catatan: resource CustomConversionGoal mengabaikan setelan ini). Default-nya adalah true.
counting_type Opsional (dapat diubah) ConversionActionCountingType (MANY_PER_CLICK default, atau ONE_PER_CLICK).
value_settings Opsional (dapat diubah) ValueSettings (default_value, default_currency_code, always_use_default_value).
attribution_model_settings Opsional (dapat diubah) AttributionModelSettings (attribution_model: GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN default atau GOOGLE_ADS_LAST_CLICK).
click_through_lookback_window_days Opsional (dapat diubah) Periode lihat balik klik-tayang int64 dalam hari (1 hingga 90 untuk sebagian besar jenis; 1 hingga 60 untuk jenis panggilan).
view_through_lookback_window_days Opsional (dapat diubah) Periode lihat balik lihat-tayang int64 dalam hari (1 hingga 30 untuk sebagian besar jenis; tidak ditetapkan untuk jenis panggilan).
phone_call_duration_seconds Hanya jenis panggilan (dapat diubah) Durasi panggilan minimum int64 dalam detik (0 hingga 10000).
app_id Hanya jenis aplikasi (tidak dapat diubah setelah dibuat) ID aplikasi seluler (string); hanya dapat ditetapkan di create untuk tindakan konversi aplikasi.
include_in_conversions_metric Hanya baca dalam mutasi Tidak dapat diubah secara langsung; konfigurasikan primary_for_goal.
tag_snippets[] OUTPUT_ONLY Cuplikan kode pelacakan situs (TagSnippet) diisi di WEBPAGE tindakan konversi.

Struktur permintaan dan respons REST

Untuk membuat atau memperbarui ConversionAction melalui REST, kirim permintaan POST ke ConversionActionService.MutateConversionActions. Saat memperbarui tindakan konversi yang ada, tentukan updateMask pada objek operasi sebagai seinduk dari update:

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
        }
      }
    }
  ]
}

Respons yang berhasil akan menampilkan entri MutateConversionActionResult di results[]:

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

Memeriksa setelan tindakan konversi dan cuplikan tag dengan GAQL

Selain kueri dasar yang ditampilkan di Langkah-langkah untuk mengaktifkan tracking konversi, Anda dapat mengkueri resource conversion_action menggunakan GoogleAdsService.SearchStream untuk memeriksa primary_for_goal, status model atribusi, periode lihat balik, setelan nilai, dan tag_snippets situs:

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'

Validasi

Google Ads dan Google Ads API mendukung berbagai tindakan konversi, sehingga beberapa aturan validasi bervariasi berdasarkan type tindakan.

Sejauh ini, error yang paling umum saat membuat tindakan konversi adalah DUPLICATE_NAME. Pastikan Anda menggunakan nama yang unik untuk setiap tindakan konversi.

Berikut beberapa tips untuk menetapkan kolom ConversionAction:

Semua kolom enum
Mencoba menetapkan kolom enum ke UNKNOWN akan menghasilkan error RequestError.INVALID_ENUM_VALUE.
app_id
Atribut app_id tidak dapat diubah dan hanya dapat ditetapkan saat membuat konversi aplikasi baru.
attribution_model_settings
Menyetelnya ke opsi yang tidak digunakan lagi akan menghasilkan error CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Google Ads hanya mendukung GOOGLE_ADS_LAST_CLICK dan GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN.
click_through_lookback_window_days

Menetapkan atribut ini ke nilai di luar rentang yang diizinkan akan menghasilkan error RangeError.TOO_LOW atau RangeError.TOO_HIGH.

Atribut ini harus antara 1 dan 60 hari untuk tindakan konversi AD_CALL atau WEBSITE_CALL. Untuk sebagian besar tindakan konversi lainnya, rentang yang diizinkan adalah 1 hingga 90 hari.

include_in_conversions_metric

Menetapkan nilai ini dalam operasi create atau update akan gagal dengan error FieldError.IMMUTABLE_FIELD. Sebagai gantinya, tetapkan primary_for_goal seperti yang dijelaskan dalam Panduan sasaran konversi.

phone_call_duration_seconds

Jika Anda mencoba menetapkan atribut ini pada tindakan konversi yang bukan untuk panggilan telepon, error FieldError.VALUE_MUST_BE_UNSET akan muncul.

type

Atribut type tidak dapat diubah dan hanya dapat ditetapkan saat membuat konversi baru.

Memperbarui tindakan konversi dengan type sama dengan UNKNOWN akan menghasilkan error MutateError.MUTATE_NOT_ALLOWED.

value_settings

value_settings untuk tindakan konversi WEBSITE_CALL atau AD_CALL harus memiliki always_use_default_value yang ditetapkan ke true. Menentukan nilai false saat membuat atau memperbarui nilai ini akan menghasilkan error INVALID_VALUE.

view_through_lookback_window_days

Menetapkan atribut ini ke nilai di luar rentang yang diizinkan akan menghasilkan error RangeError.TOO_LOW atau RangeError.TOO_HIGH. Untuk sebagian besar tindakan konversi, rentang yang diizinkan adalah 1 hingga 30 hari.

Atribut ini tidak dapat ditetapkan pada tindakan konversi AD_CALL atau WEBSITE_CALL. Menentukan nilai akan menghasilkan error VALUE_MUST_BE_UNSET.

Sebelumnya
Kategori tindakan konversi
Berikutnya
Mengelola konversi offline