4.1.5 Tracking Konversi

Nilai dan Dampak Bisnis

Untuk menyediakan layanan machine learning yang canggih dan canggih pada ekosistem Google secara efektif, Analytics untuk kampanye iklan klien penjual, Anda harus melakukan konversi tag pelacakan dan pemasaran ulang di situs klien.

Konversi di Google Ads terjadi saat pengguna melakukan beberapa tindakan tertentu setelah mengklik iklan, seperti membeli produk, menginstal aplikasi seluler, atau mendaftar milis. Tracking konversi memberikan insight penting menjadi pengguna tindakan setelah melihat atau mengklik iklan, termasuk informasi untuk menghitung dan membandingkan laba atas investasi (ROI) untuk membantu klien Anda membuat keputusan tentang di mana harus memfokuskan pembelanjaan iklan. Pelacakan juga membantu memastikan bahwa data tersedia untuk tujuan rekonsiliasi. Pesanan berbeda bergantung pada produk atau kategori, jadi pelacakan konversi juga dapat berguna untuk menunjukkan bagaimana grup listingan tertentu diubah menjadi penjualan.

Sasaran konversi adalah grup tindakan konversi dengan tujuan yang mendasarinya. Misalnya, 'Pembelian' dapat berupa sasaran konversi yang 'Pembelian situs' dan 'Penjualan toko' sebagai tindakan konversi.

Tindakan konversi masih digunakan untuk melacak konversi dan mengoptimalkan kampanye. Anda membuat tindakan konversi dan Google mengelompokkannya dalam konversi tujuan tersebut.

Tindakan konversi pembelian

Menerapkan tracking konversi yang dijelaskan di sini memungkinkan Akun Google Ads untuk mengukur jumlah konversi Pembelian dan nilainya konversi tersebut. Tanpa pelacakan konversi, Anda tidak dapat mengukur nilai bisnis yang didorong kampanye dalam hal ROAS (laba atas pembelanjaan iklan). Tag tersebut juga mengirimkan sinyal data tambahan yang memungkinkan kampanye untuk mengoptimalkan performa.

Tindakan konversi lainnya

Meskipun tindakan konversi pembelian hanya diperlukan, melacak tindakan konversi dapat memberikan insight tambahan kepada penjual Anda. Rab menyarankan untuk mencatat semua hal yang mungkin dilakukan, sambil menerapkan sebanyak tindakan konversi utama kami. Daftar lengkap tindakan konversi yang direkomendasikan yang dijelaskan di bagian panduan Tech API.

Secara umum, rekomendasinya adalah untuk menangkap hal berikut:

  • Semua peristiwa sukses yang terkait langsung dengan nilai
  • Peristiwa sukses yang berkontribusi pada konversi inti seperti add_to_cart dan sign_up.
  • Engagement dan interaksi pengguna yang membantu pengiklan memahami cara mereka berinteraksi dengan pengguna akhir

Tindakan konversi sekunder hanya untuk pengamatan dan pelaporan, memengaruhi bidding.Pelajari tindakan konversi utama dan sekunder lebih lanjut.

Panduan UX

Untuk meminimalkan risiko error, sebaiknya terapkan konversi pelacakan secara terprogram tanpa input penjual, tetapi Anda harus memastikan bahwa penjual Anda tahu bahwa tracking konversi telah disiapkan.

Saat penjual menautkan akun Google Ads yang sudah ada, sebaiknya tampilkan notifikasi bahwa akun mereka mungkin sudah memiliki tracking konversi diatur, karena mungkin ada konflik yang harus diselesaikan. Contoh ditampilkan di bawah ini.

connect_your_google_ads_account

Panduan Teknologi

Berikut cara kerja tracking konversi. Bagian ini menguraikan lebih lanjut masing-masing langkah:

  1. Anda membuat 'ConversionAction' di akun Google Ads penjual untuk melacak pembelian (dan secara opsional, tindakan pelanggan lainnya) yang dilakukan di situs mereka.

  2. Anda menambahkan tag, atau cuplikan kode, untuk tindakan konversi tersebut ke situs atau aplikasi seluler. Untuk mengetahui detailnya, lihat Menyiapkan tracking konversi untuk situs.

  3. Saat pelanggan mengklik iklan, cookie sementara ditempatkan di komputer atau perangkat seluler pelanggan.

  4. Saat pelanggan menyelesaikan tindakan yang telah ditentukan untuk pengiklan, Google mengenali cookie (melalui cuplikan kode yang ditambahkan), dan mencatat konversi bersama dengan parameter lain, seperti 'value' jika sesuai.

Prasyarat

Sebelum memulai, pastikan Anda memiliki ID Developer tag Google. Jika Anda tidak memiliki ID Developer tag Google, isi Formulir permintaan ID Developer tag Google. ID Developer Anda berbeda dari ID lain, seperti ID Pengukuran atau ID Konversi, yang yang ditambahkan pengguna ke kode pengukuran situs mereka.

Membuat dan mengonfigurasi tindakan konversi

Contoh berikut menunjukkan cara membuat tindakan konversi dan menambahkannya ke akun Google Ads. Setiap sampel menangani semua tugas otentikasi latar belakang untuk dan memandu Anda dalam membuat tindakan konversi:

Java

// Copyright 2018 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.

package com.google.ads.googleads.examples.remarketing;

import static com.google.ads.googleads.examples.utils.CodeSampleHelper.getPrintableDateTime;

import com.beust.jcommander.Parameter;
import com.google.ads.googleads.examples.utils.ArgumentNames;
import com.google.ads.googleads.examples.utils.CodeSampleParams;
import com.google.ads.googleads.lib.GoogleAdsClient;
import com.google.ads.googleads.v17.enums.ConversionActionCategoryEnum.ConversionActionCategory;
import com.google.ads.googleads.v17.enums.ConversionActionStatusEnum.ConversionActionStatus;
import com.google.ads.googleads.v17.enums.ConversionActionTypeEnum.ConversionActionType;
import com.google.ads.googleads.v17.errors.GoogleAdsError;
import com.google.ads.googleads.v17.errors.GoogleAdsException;
import com.google.ads.googleads.v17.resources.ConversionAction;
import com.google.ads.googleads.v17.resources.ConversionAction.ValueSettings;
import com.google.ads.googleads.v17.services.ConversionActionOperation;
import com.google.ads.googleads.v17.services.ConversionActionServiceClient;
import com.google.ads.googleads.v17.services.MutateConversionActionResult;
import com.google.ads.googleads.v17.services.MutateConversionActionsResponse;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.util.Collections;

/** Adds a conversion action. */
public class AddConversionAction {

  private static class AddConversionActionParams extends CodeSampleParams {

    @Parameter(names = ArgumentNames.CUSTOMER_ID, required = true)
    private Long customerId;
  }

  public static void main(String[] args) {
    AddConversionActionParams params = new AddConversionActionParams();
    if (!params.parseArguments(args)) {

      // Either pass the required parameters for this example on the command line, or insert them
      // into the code here. See the parameter class definition above for descriptions.
      params.customerId = Long.parseLong("INSERT_CUSTOMER_ID_HERE");
    }

    GoogleAdsClient googleAdsClient = null;
    try {
      googleAdsClient = GoogleAdsClient.newBuilder().fromPropertiesFile().build();
    } catch (FileNotFoundException fnfe) {
      System.err.printf(
          "Failed to load GoogleAdsClient configuration from file. Exception: %s%n", fnfe);
      System.exit(1);
    } catch (IOException ioe) {
      System.err.printf("Failed to create GoogleAdsClient. Exception: %s%n", ioe);
      System.exit(1);
    }

    try {
      new AddConversionAction().runExample(googleAdsClient, params.customerId);
    } catch (GoogleAdsException gae) {
      // GoogleAdsException is the base class for most exceptions thrown by an API request.
      // Instances of this exception have a message and a GoogleAdsFailure that contains a
      // collection of GoogleAdsErrors that indicate the underlying causes of the
      // GoogleAdsException.
      System.err.printf(
          "Request ID %s failed due to GoogleAdsException. Underlying errors:%n",
          gae.getRequestId());
      int i = 0;
      for (GoogleAdsError googleAdsError : gae.getGoogleAdsFailure().getErrorsList()) {
        System.err.printf("  Error %d: %s%n", i++, googleAdsError);
      }
      System.exit(1);
    }
  }

  /**
   * Runs the example.
   *
   * @param googleAdsClient the Google Ads API client.
   * @param customerId the client customer ID.
   * @throws GoogleAdsException if an API request failed with one or more service errors.
   */
  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#

// 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
//
//     http://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.

using CommandLine;
using Google.Ads.Gax.Examples;
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V17.Errors;
using Google.Ads.GoogleAds.V17.Resources;
using Google.Ads.GoogleAds.V17.Services;
using System;
using static Google.Ads.GoogleAds.V17.Enums.ConversionActionCategoryEnum.Types;
using static Google.Ads.GoogleAds.V17.Enums.ConversionActionStatusEnum.Types;
using static Google.Ads.GoogleAds.V17.Enums.ConversionActionTypeEnum.Types;

namespace Google.Ads.GoogleAds.Examples.V17
{
    /// <summary>
    /// This code example illustrates adding a conversion action.
    /// </summary>
    public class AddConversionAction : ExampleBase
    {
        /// <summary>
        /// Command line options for running the <see cref="AddConversionAction"/> example.
        /// </summary>
        public class Options : OptionsBase
        {
            /// <summary>
            /// The Google Ads customer ID for which the conversion action is added.
            /// </summary>
            [Option("customerId", Required = true, HelpText =
                "The Google Ads customer ID for which the conversion action is added.")]
            public long CustomerId { get; set; }
        }

        /// <summary>
        /// Main method, to run this code example as a standalone application.
        /// </summary>
        /// <param name="args">The command line arguments.</param>
        public static void Main(string[] args)
        {
            Options options = ExampleUtilities.ParseCommandLine<Options>(args);

            AddConversionAction codeExample = new AddConversionAction();
            Console.WriteLine(codeExample.Description);
            codeExample.Run(new GoogleAdsClient(), options.CustomerId);
        }

        /// <summary>
        /// Returns a description about the code example.
        /// </summary>
        public override string Description =>
            "This code example illustrates adding a conversion action.";

        /// <summary>
        /// Runs the code example.
        /// </summary>
        /// <param name="client">The Google Ads client.</param>
        /// <param name="customerId">The Google Ads customer ID for which the conversion action is
        /// added.</param>
        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

<?php

/**
 * Copyright 2018 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.
 */

namespace Google\Ads\GoogleAds\Examples\Remarketing;

require __DIR__ . '/../../vendor/autoload.php';

use GetOpt\GetOpt;
use Google\Ads\GoogleAds\Examples\Utils\ArgumentNames;
use Google\Ads\GoogleAds\Examples\Utils\ArgumentParser;
use Google\Ads\GoogleAds\Examples\Utils\Helper;
use Google\Ads\GoogleAds\Lib\V17\GoogleAdsClient;
use Google\Ads\GoogleAds\Lib\V17\GoogleAdsClientBuilder;
use Google\Ads\GoogleAds\Lib\V17\GoogleAdsException;
use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder;
use Google\Ads\GoogleAds\V17\Enums\ConversionActionCategoryEnum\ConversionActionCategory;
use Google\Ads\GoogleAds\V17\Enums\ConversionActionStatusEnum\ConversionActionStatus;
use Google\Ads\GoogleAds\V17\Enums\ConversionActionTypeEnum\ConversionActionType;
use Google\Ads\GoogleAds\V17\Errors\GoogleAdsError;
use Google\Ads\GoogleAds\V17\Resources\ConversionAction;
use Google\Ads\GoogleAds\V17\Resources\ConversionAction\ValueSettings;
use Google\Ads\GoogleAds\V17\Services\ConversionActionOperation;
use Google\Ads\GoogleAds\V17\Services\MutateConversionActionsRequest;
use Google\ApiCore\ApiException;

/** This example illustrates adding a conversion action. */
class AddConversionAction
{
    private const CUSTOMER_ID = 'INSERT_CUSTOMER_ID_HERE';

    public static function main()
    {
        // Either pass the required parameters for this example on the command line, or insert them
        // into the constants above.
        $options = (new ArgumentParser())->parseCommandArguments([
            ArgumentNames::CUSTOMER_ID => GetOpt::REQUIRED_ARGUMENT
        ]);

        // Generate a refreshable OAuth2 credential for authentication.
        $oAuth2Credential = (new OAuth2TokenBuilder())->fromFile()->build();

        // Construct a Google Ads client configured from a properties file and the
        // OAuth2 credentials above.
        $googleAdsClient = (new GoogleAdsClientBuilder())
            ->fromFile()
            ->withOAuth2Credential($oAuth2Credential)
            // We set this value to true to show how to use GAPIC v2 source code. You can remove the
            // below line if you wish to use the old-style source code. Note that in that case, you
            // probably need to modify some parts of the code below to make it work.
            // For more information, see
            // https://developers.devsite.corp.google.com/google-ads/api/docs/client-libs/php/gapic.
            ->usingGapicV2Source(true)
            ->build();

        try {
            self::runExample(
                $googleAdsClient,
                $options[ArgumentNames::CUSTOMER_ID] ?: self::CUSTOMER_ID
            );
        } catch (GoogleAdsException $googleAdsException) {
            printf(
                "Request with ID '%s' has failed.%sGoogle Ads failure details:%s",
                $googleAdsException->getRequestId(),
                PHP_EOL,
                PHP_EOL
            );
            foreach ($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) {
                /** @var GoogleAdsError $error */
                printf(
                    "\t%s: %s%s",
                    $error->getErrorCode()->getErrorCode(),
                    $error->getMessage(),
                    PHP_EOL
                );
            }
            exit(1);
        } catch (ApiException $apiException) {
            printf(
                "ApiException was thrown with message '%s'.%s",
                $apiException->getMessage(),
                PHP_EOL
            );
            exit(1);
        }
    }

    /**
     * Runs the example.
     *
     * @param GoogleAdsClient $googleAdsClient the Google Ads API client
     * @param int $customerId the customer ID
     */
    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::main();

AddConversionAction.php

Python

#!/usr/bin/env python
# Copyright 2018 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.
"""This example illustrates adding a conversion action."""


import argparse
import sys
import uuid

from google.ads.googleads.client import GoogleAdsClient
from google.ads.googleads.errors import GoogleAdsException


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


if __name__ == "__main__":
    parser = argparse.ArgumentParser(
        description="Adds a conversion action 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()

    # 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")

    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)

add_conversion_action.py

Ruby

#!/usr/bin/env ruby
# Encoding: utf-8
#
# Copyright 2018 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.
#
# This code example illustrates adding a conversion action.

require 'optparse'
require 'google/ads/google_ads'
require 'date'

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

if __FILE__ == $0
  options = {}
  # The following parameter(s) should be provided to run the example. You can
  # either specify these by changing the INSERT_XXX_ID_HERE values below, or on
  # the command line.
  #
  # Parameters passed on the command line will override any parameters set in
  # code.
  #
  # Running the example with -h will print the command line usage.
  options[:customer_id] = 'INSERT_CUSTOMER_ID_HERE'

  OptionParser.new do |opts|
    opts.banner = sprintf('Usage: %s [options]', File.basename(__FILE__))

    opts.separator ''
    opts.separator 'Options:'

    opts.on('-C', '--customer-id CUSTOMER-ID', String, 'Customer ID') do |v|
      options[:customer_id] = v
    end

    opts.separator ''
    opts.separator 'Help:'

    opts.on_tail('-h', '--help', 'Show this message') do
      puts opts
      exit
    end
  end.parse!

  begin
    add_conversion_action(options.fetch(:customer_id).tr("-", ""))
  rescue Google::Ads::GoogleAds::Errors::GoogleAdsError => e
    e.failure.errors.each do |error|
      STDERR.printf("Error with message: %s\n", error.message)
      if error.location
        error.location.field_path_elements.each do |field_path_element|
          STDERR.printf("\tOn field: %s\n", field_path_element.field_name)
        end
      end
      error.error_code.to_h.each do |k, v|
        next if v == :UNSPECIFIED
        STDERR.printf("\tType: %s\n\tCode: %s\n", k, v)
      end
    end
    raise
  end
end

add_conversion_action.rb

Perl

#!/usr/bin/perl -w
#
# 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
#
#     http://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.
#
# This example illustrates adding a conversion action.

use strict;
use warnings;
use utf8;

use FindBin qw($Bin);
use lib "$Bin/../../lib";
use Google::Ads::GoogleAds::Client;
use Google::Ads::GoogleAds::Utils::GoogleAdsHelper;
use Google::Ads::GoogleAds::V17::Resources::ConversionAction;
use Google::Ads::GoogleAds::V17::Resources::ValueSettings;
use Google::Ads::GoogleAds::V17::Enums::ConversionActionCategoryEnum
  qw(DEFAULT);
use Google::Ads::GoogleAds::V17::Enums::ConversionActionTypeEnum   qw(WEBPAGE);
use Google::Ads::GoogleAds::V17::Enums::ConversionActionStatusEnum qw(ENABLED);
use
  Google::Ads::GoogleAds::V17::Services::ConversionActionService::ConversionActionOperation;

use Getopt::Long qw(:config auto_help);
use Pod::Usage;
use Cwd          qw(abs_path);
use Data::Uniqid qw(uniqid);

# The following parameter(s) should be provided to run the example. You can
# either specify these by changing the INSERT_XXX_ID_HERE values below, or on
# the command line.
#
# Parameters passed on the command line will override any parameters set in
# code.
#
# Running the example with -h will print the command line usage.
my $customer_id = "INSERT_CUSTOMER_ID_HERE";

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

# Don't run the example if the file is being included.
if (abs_path($0) ne abs_path(__FILE__)) {
  return 1;
}

# Get Google Ads Client, credentials will be read from ~/googleads.properties.
my $api_client = Google::Ads::GoogleAds::Client->new();

# By default examples are set to die on any server returned fault.
$api_client->set_die_on_faults(1);

# Parameters passed on the command line will override any parameters set in code.
GetOptions("customer_id=s" => \$customer_id);

# Print the help message if the parameters are not initialized in the code nor
# in the command line.
pod2usage(2) if not check_params($customer_id);

# Call the example.
add_conversion_action($api_client, $customer_id =~ s/-//gr);

=pod

=head1 NAME

add_conversion_action

=head1 DESCRIPTION

This example illustrates adding a conversion action.

=head1 SYNOPSIS

add_conversion_action.pl [options]

    -help                       Show the help message.
    -customer_id                The Google Ads customer ID.

=cut

add_conversion_action.pl

Karena contoh sebelumnya bersifat umum, berikut adalah catatan tambahan, jadi bahwa ConversionAction dikonfigurasi dengan benar untuk Performa Maksimal. Setiap tindakan konversi Anda harus dikonfigurasi sebagai berikut:

  • Jenis - Tetapkan ConversionActionType sebagai HALAMAN WEB, karena pembelian ini peristiwa terjadi di situs.

  • Dapat di-bid – Tetapkan ke true untuk utama tindakan konversi (pembelian) untuk mengoptimalkan kampanye untuk mendorong penjualan. Untuk tindakan konversi sekunder (misalnya tambahkan ke keranjang), tetapkan nilai ke false.

  • Kategori - Untuk setiap tindakan konversi (utama atau sekunder),tetapkan ConversionActionCategory. Di bawah ini, Anda dapat menemukan kategori tindakan percakapan yang relevan untuk masing-masing dari 7 tindakan konversi yang kami rekomendasikan untuk diterapkan. Perhatikan bahwa Google Ads menetapkan konversi secara otomatis tindakan pada sasaran konversi standar berdasarkan kategorinya. Misalnya, tindakan konversi pembelian ditetapkan ke sasaran konversi standar yang disebut "Purchases". Nanti, Anda dapat mengonfigurasi kampanye Performa Maksimal kampanye untuk mengoptimalkan sasaran Pembelian ini.

Anda dapat menemukan daftar tindakan konversi yang disarankan di bawah ini. Saran dari kami menerapkan setidaknya empat tindakan konversi pertama dan sebanyak tindakan lain yang disarankan.

Anda juga dapat mempertimbangkan untuk menerapkan acara tambahan yang relevan untuk penjualan online. Untuk lebih terperinci Anda juga dapat membuat tindakan konversi tambahan atau setelan tindakan konversi (misalnya, tindakan untuk "tambahkan informasi pembayaran" setiap kali pengguna menggunakan opsi pencarian di {i>website<i}, atau tindakan untuk "telusuri" setiap kali pengguna menggunakan opsi penelusuran di situs). Sekunder tindakan konversi akan memberikan pelacakan tambahan untuk penjual dan digunakan oleh Google Ads untuk pengamatan.

Prioritas Tindakan Konversi Kategori Tindakan Konversi Nama Peristiwa Tag Google Deskripsi
Wajib Beli PEMBELIAN purchase Pengguna menyelesaikan pembelian
Sangat direkomendasikan untuk semua pembuat toko Menambahkan ke keranjang ADD_TO_CART add_to_cart Pengguna menambahkan produk ke keranjang
Sangat direkomendasikan untuk semua pembuat toko Memulai checkout BEGIN_CHECKOUT begin_checkout Pengguna memulai proses checkout
Sangat direkomendasikan untuk semua pembuat toko Lihat item PAGE_VIEW page_view Pengguna membuka halaman produk
Sangat disarankan jika ada (biasanya tidak berlaku untuk pembuat toko) Daftar DAFTAR sign_up Pengguna mendaftar untuk mendapatkan akun
Sangat disarankan jika ada (biasanya tidak berlaku untuk pembuat toko) Menghasilkan prospek SUBMIT_LEAD_FORM generate_lead Pengguna membuat prospek melalui formulir
Sangat disarankan jika ada (biasanya tidak berlaku untuk pembuat toko) Langganan SUBSCRIBE_PAID tidak berlaku (kustom) Pengguna berlangganan layanan berbayar
Sangat disarankan jika ada (biasanya tidak berlaku untuk pembuat toko) Membuat janji temu BOOK_APPOINTMENT tidak berlaku (kustom) Pengguna membuat janji temu
Sangat disarankan jika ada (biasanya tidak berlaku untuk pembuat toko) Meminta penawaran harga REQUEST_QUOTE tidak berlaku (kustom) Pengguna mengirimkan formulir yang meminta perkiraan harga

Penjual dengan akun Google Ads yang sudah ada

Jika Anda mengizinkan penjual untuk melakukan aktivasi dengan akun Google Ads yang sudah ada, Anda dapat menjalankan ke dalam situasi saat akun sudah memiliki tindakan konversi. Kami tidak sarankan untuk menggunakan tindakan konversi yang sudah ada, karena tidak ada jaminan bahwa tindakan tersebut telah diatur dengan benar. Selain itu, ada langkah-langkah tambahan yang harus Anda ambil untuk menangani skenario potensial ini:

  • Akun memiliki beberapa sasaran (misalnya, Pembelian + Kunjungan halaman + Kontak) yang semuanya ditandai sebagai "{i>account default<i}." Saat kampanye baru dibuat, kampanye tersebut dan secara default dioptimalkan untuk mencapai semua sasaran tersebut. Anda tidak ingin ini untuk Kampanye Performa Maksimal.

  • Akun sudah memiliki satu (atau beberapa) tindakan konversi untuk melacak pembelian dan itu sudah dikelompokkan dalam sasaran Pembelian. Ini berarti bahwa setelah Anda kampanye ganda menghitung pembelian, karena ada dua pengaktifan tag konversi.

Untuk memastikan kampanye Performa Maksimal menggunakan tindakan konversi kustom Anda dan tindakan tersebut saja:

  1. Buat CustomConversionGoal, lalu tambahkan tindakan konversi Pembelian ke daftar conversion_actions[] sasaran. Setel status ke ENABLED.

  2. Di ConversionGoalCampaignConfig kampanye Performa Maksimal, tetapkan custom_conversion_goal ke sasaran kustom yang Anda buat di langkah (1).

  3. Sebagai hasil dari langkah (2), Google Ads seharusnya secara otomatis memperbarui ConversionGoalCampaignConfig kampanye sehingga goal_config_level ditetapkan ke CAMPAIGN (bukan CUSTOMER, yang akan mengarahkannya untuk menggunakan sasaran default akun), tetapi sebaiknya periksa ulang terjadi.

Ambil tag untuk tindakan konversi

Setelah membuat tindakan konversi, Anda harus memasukkan cuplikan kode yang sesuai yang disebut tag ke halaman konversi di situs pengiklan Anda. Untuk memastikan Google Ads dapat mengukur semua konversi terlepas dari browser pelanggan, gunakan tag tracking konversi Google Ads yang diperbarui. Tag ini terdiri dari dua suku cadang:

  • global_site_tag yang harus diinstal di setiap halaman situs pengiklan Anda.

  • event_snippet, yang harus ditempatkan di halaman web yang menunjukkan tindakan konversi seperti halaman konfirmasi checkout atau pengiriman prospek.

Anda dapat mengambil dua bagian ini dengan ConversionActionService.

Tag menetapkan cookie yang menyimpan ID unik untuk pelanggan atau iklan klik yang mengarahkan pelanggan ke situs. Cookie tersebut menerima klik iklan informasi dari parameter ID Klik Google (GCLID) yang disertakan di tag tracking konversi. Anda harus mengaktifkan situs pengiklan dan sistem pelacakan prospek untuk menangkap dan menyimpan GCLID, yang merupakan ID unik Google Ads memberikan untuk setiap tayangan iklan Google.

Selengkapnya tentang tag global dan tempat untuk menginstalnya

Tag Google (gtag.js) adalah framework pemberian tag dan API yang memungkinkan Anda mengirim data peristiwa ke Google Ads dan Google Analytics. Tag situs global berfungsi bersama cuplikan peristiwa atau cuplikan kode telepon untuk melacak konversi. Tambahkan tag Google ke bagian <head> di setiap halaman di situs pengiklan dan mengonfigurasinya agar berfungsi dengan Google Ads. Anda kemudian dapat gunakan perintah gtag() untuk mengambil peristiwa dan mengirim data ke Google Ads. Untuk memahami cara kerjanya, lihat Gunakan tag situs global untuk tracking konversi Google Ads.

Anda menggunakan perintah berikut dengan tag Google:

  • config: Melakukan inisialisasi produk Google (Google Ads, Analytics, dll.), mengkonfigurasi pengaturan, dan bersiap untuk mengirim data ke akun.

  • event: Mendaftarkan konversi dengan mengirimkan peristiwa seperti pembelian (disarankan) atau menambahkan ke keranjang belanja (tindakan konversi sekunder). Sebaiknya tinjau panduan referensi Peristiwa gtag.js.

  • set: Menetapkan parameter yang umum untuk semua peristiwa di halaman, seperti mata uang.

Contoh berikut adalah cuplikan kode JavaScript dari tag situs global untuk mengirim data ke Google Ads. Nilai placeholder GOOGLE_CONVERSION_ID adalah ID numerik unik untuk satu akun pengiklan.

<!-- Google Tag (gtag.js) - Google Ads: GOOGLE_CONVERSION_ID -->
<script async src="https://www.googletagmanager.com/gtag/js?id=AW-GOOGLE_CONVERSION_ID">
</script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());
   gtag('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID
  gtag('config', 'AW-GOOGLE_CONVERSION_ID');
</script>

Cuplikan tag Google hanya boleh muncul sekali per halaman. Jika ada gtag.js, Anda harus menambahkan ID tag baru ke tag yang ada. Untuk mengirim ke beberapa akun, Anda dapat menambahkan panggilan ke server 'config' untuk setiap akun yang Anda gunakan, dengan menentukan setiap ID konversi akun, seperti yang ditunjukkan dalam contoh berikut:

<!-- Google Tag (gtag.js) - Google Ads: GOOGLE_CONVERSION_ID_1 -->
<script async src="https://www.googletagmanager.com/gtag/js?id=AW-GOOGLE_CONVERSION_ID_1"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());
  gtag('config', 'AW-GOOGLE_CONVERSION_ID_1');
  gtag('config', 'AW-GOOGLE_CONVERSION_ID_2');
</script>

Selengkapnya tentang cuplikan peristiwa dan tempat untuk menginstalnya

Agar tracking konversi pembelian berfungsi, cuplikan peristiwa pembelian harus diinstal pada halaman konversi itu sendiri. Ini biasanya adalah urutan halaman konfirmasi. Dapat ditempatkan di mana saja dalam kode, setelah tag global cuplikan kode. Cuplikan peristiwa untuk tindakan konversi sekunder (misalnya: tambahkan ke keranjang) harus ditempatkan di halaman masing-masing.

Dalam contoh cuplikan di bawah, AW-CONVERSION_ID dan gTag_developer_ID adalah ID konversi unik untuk akun Google Ads dan akun Google Ads Akun developer tag, sementara AW-CONVERSION_LABEL adalah konversi , yang unik per tindakan konversi:

<!-- Event snippet for a purchase conversion page -->
<script>
  gtag('event', 'conversion', {
       'send_to':'AW-CONVERSION_ID/CONVERSION_LABEL',
       'developer_id.<gTag developer ID>': true,
       'transaction_id': '<transaction_id (string)>' //unique ID for the transaction (e.g. an order ID); it's used for de-duplication purposes
       'value': 1.0,
       'currency': 'USD', //three-letter currency code, useful for advertisers who accept multiple currencies
       'country': 'US',
       'new_customer': false, //new customer acquisition goal
       'tax': 1.24, //tax cost-US only
       'shipping': 0.00, //shipping cost-US only
       'delivery_postal_code': '94043', //shipping data validation-US only
       'estimated_delivery_date': '2020-07-31', //shipping validation-US only
       'aw_merchant_id': 12345, //shipping validation-US only
       'aw_feed_country': 'US', //shipping validation-US only
       'aw_feed_language': 'EN', //shipping validation-US only
       'items': [
       {
             'id': 'P12345',
             'name': 'Android Warhol T-Shirt',
             'quantity': 2,
             'price': 12.04,
             'estimated_delivery_date': '2020-07-31', //shipping-US only
              'google_business_vertical': 'retail'
       }, …],
  });
</script>

Meskipun beberapa parameter bersifat opsional, sebaiknya Anda menyertakan sebanyak mungkin yang tersedia untuk setiap peristiwa. Pelajari lebih lanjut parameter tersedia untuk setiap jenis peristiwa.

Parameter memberikan informasi tambahan tentang interaksi pengguna dengan situs atau aplikasi Anda.

Jika Anda ingin mengukur peristiwa konversi berdasarkan klik (Mis.pada tombol atau respons dinamis untuk situs yang menggunakan AJAX), Anda juga dapat menggunakan cuplikan berikut:

<!-- Event snippet for test conversion click -->
In your html page, add the snippet and call gtag_report_conversion when someone clicks on the chosen link or button. -->
<script>
function gtag_report_conversion(url) {
  var callback = function () {
    if (typeof(url) != 'undefined') {
      window.location = url;
    }
  };
  gtag('event', 'conversion', {
      'send_to': 'AW-CONVERSION_ID/CONVERSION_LABEL',
      'value': 1.0,
      'event_callback': callback,
      //other parameters
  });
  return false;
}
</script>

Tag Google memiliki Consent API bawaan untuk mengelola izin pengguna. Aplikasi ini mampu membedakan izin pengguna cookie untuk tujuan iklan dengan izin untuk analisis tujuan.

Hasil yang diharapkan adalah pelanggan mendapatkan setidaknya gtag('consent', 'update' {...}) panggilan terintegrasi tanpa perlu tindakan apa pun dari pelanggan. Seharusnya memastikan tag Google (Google Ads, Floodlight, Google Analytics, Conversion Linker) dapat membaca status izin pengguna terbaru dan menyertakan status dalam jaringan ke Google (melalui parameter &gcs).

Langkah penerapan tambahan adalah menerapkan atau membantu pengiklan dalam menerapkan (misalnya, melalui UI) status gtag('consent', default' {...}) dan membatalkan pemblokiran tag Google (contoh: tidak ada pengaktifan bersyarat berbasis izin) untuk mengaktifkan mode izin untuk mengaktifkannya dengan cara yang berbasis izin.

Untuk mengetahui detail penerapan, lihat Mengelola setelan izin (web).

Tips

Dari akun pengelola Google Ads,Anda dapat melacak konversi di seluruh akun pengiklan menggunakan satu tag kode konversi. Lihat tentang tracking konversi lintas-akun.

Cara terbaik untuk menguji apakah penerapan tracking konversi Anda adalah pergi ke salah satu akun penjual situs (atau situs pengujian internal) dan melakukan pembelian nyata. Anda kemudian dapat mengamati di alat Google Tag Assistant untuk menggunakan panduan pemecahan masalah ini untuk memverifikasi bahwa Google Ads telah melihat tag Anda dan berhasil mencatat konversi. Untuk pemecahan masalah lainnya, baca artikel memecahkan masalah pemberian tag di seluruh situs.

Anda dapat melengkapi tag konversi sebelumnya dengan konversi yang disempurnakan, yang dapat meningkatkan akurasi pengukuran konversi Anda dan memungkinkan bidding yang lebih efektif. Pelajari lebih lanjut cara menyiapkan konversi yang disempurnakan. Sebelum menerapkan konversi yang disempurnakan, Anda harus memastikan bahwa penjual dapat mematuhi Kebijakan data pelanggan untuk konversi yang disempurnakan di Google Ads.

Sebelumnya
Menautkan Akun Google Ads
Berikutnya
4.2 Pembuatan Kampanye Iklan