Memulai Konversi yang Disempurnakan untuk Prospek

Cara kerja konversi yang disempurnakan untuk prospek

Konversi yang disempurnakan untuk prospek memerlukan penyiapan tag yang secara otomatis mengirim GCLID ke Google Ads saat pengguna mengirim formulir prospek. Anda dapat menyiapkan tag Google melalui Google Ads, Google Tag Manager, Google Analytics, atau Campaign Manager 360. Tag mengirim data pengiriman formulir prospek — misalnya, alamat email pengguna — beserta GCLID, ke Google Ads saat pengguna mengirimkan formulir prospek. Saat pengguna melakukan konversi di lain waktu, Anda dapat mengupload konversi tersebut melalui UI Google Ads, yang dijelaskan di Pusat Bantuan, atau Anda dapat mengupload konversi dengan informasi formulir prospek melalui API Google Ads.

Konversi yang disempurnakan untuk prospek di Google Ads API mencakup langkah 5 dalam hal berikut alur kerja.

Konversi yang disempurnakan untuk prospek

Menerapkan prasyarat

Ada beberapa prasyarat agar penyiapan konversi yang disempurnakan berfungsi. Pastikan semua prasyarat terpenuhi sebelum melanjutkan penerapan:

  1. Aktifkan tracking konversi di pelanggan konversi Google Ads Anda.

  2. Setujui persyaratan data pelanggan dan aktifkan konversi yang disempurnakan untuk prospek.

  3. Mengonfigurasi pemberian tag.

1. Mengaktifkan tracking konversi di pelanggan konversi Google Ads Anda

Mengambil informasi tentang penyiapan tracking konversi

Anda dapat memeriksa penyiapan tracking konversi akun dan mengonfirmasi konversi pelacakan diaktifkan dengan membuat kueri resource Customer untuk ConversionTrackingSetting. Terbitkan kueri berikut ini 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 seharusnya diberikan sebagai customer_id di Google Ads API meminta untuk membuat dan mengelola konversi. Perhatikan bahwa kolom ini akan terisi meskipun tracking konversi tidak diaktifkan.

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

Buat tindakan konversi di bagian 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 dapat membuat tindakan konversi di UI dengan mengikuti petunjuk di Pusat Bantuan 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());
    }
  }
}
AddConversionAction.java

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;
    }
}
AddConversionAction.cs

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
        );
    }
}
AddConversionAction.php

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}".'
    )
add_conversion_action.py

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
add_conversion_action.rb

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;
}
add_conversion_action.pl

Pastikan conversion_action_type disetel ke nilai yang benar Nilai ConversionActionType. Untuk panduan lebih lanjut 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 menerbitkan kueri berikut. Pastikan ID pelanggan dalam permintaan ditetapkan ke Google Ads pelanggan konversi yang Anda identifikasi di atas, dan jenis tindakan konversi ditetapkan ke benar ConversionActionType dengan sejumlah nilai.

SELECT
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.status
FROM conversion_action
WHERE conversion_action.type = 'UPLOAD_CLICKS'

2. Setujui persyaratan data pelanggan dan aktifkan konversi yang disempurnakan untuk prospek

Anda harus mengaktifkan konversi yang disempurnakan untuk prospek dan menyetujui data pelanggan istilah penelusuran agar Anda dapat menggunakan konversi yang disempurnakan untuk prospek. Anda dapat memverifikasi apakah prasyarat tersebut telah dipenuhi dengan mengajukan kueri berikut ke akun Google Ads pelanggan konversi:

SELECT
  customer.id,
  customer.conversion_tracking_setting.accepted_customer_data_terms,
  customer.conversion_tracking_setting.enhanced_conversions_for_leads_enabled
FROM customer

Jika salah satu dari accepted_customer_data_terms atau enhanced_conversions_for_leads_enabled adalah false, ikuti petunjuk di ke Pusat Bantuan untuk menyelesaikan prasyarat ini.

3. Mengonfigurasi pemberian tag

Anda dapat mengonfigurasi tag Google untuk mengaktifkan konversi yang disempurnakan untuk prospek dengan dengan mengikuti petunjuk dalam Google. Untuk menyiapkan konversi yang disempurnakan untuk prospek dengan Google Tag Manager, ikuti langkah-langkah berikut petunjuk ini.

Langkah berikutnya

Setelah memenuhi prasyarat, Anda siap untuk menerapkan konversi untuk prospek.