Storebuilder Blueprint | Google for Developers

Bu sayfa, Cloud Translation API ile çevrilmiştir.

4.1.5 Dönüşüm İzleme

Değer ve İşletme Etkisi

Google ekosisteminin güçlü makine öğrenimini ve Analytics'i kullanmak istiyorsanız, dönüşüm ve optimizasyon için İzleme ve yeniden pazarlama etiketleri gibi.

Google Ads'de dönüşüm, kullanıcının belirli bir işlem yapmasıdır. bir reklamı tıkladıktan sonra (ör. ürün satın alma, mobil uygulama veya bir e-posta listesine kaydolun. Dönüşüm izleme sayesinde önemli analizler elde edebilirsiniz kullanıcılara reklam görüntüledikten veya tıkladıktan sonra gerçekleştirilen işlemlere Müşterilerinize yardımcı olmak için yatırım getirisini (YG) hesaplama ve karşılaştırma reklam harcamalarını nereye odaklayacağınıza dair kararlar verebilirsiniz. Takip ayrıca projenin verilerin mutabakat için kullanılabilir olmasını sağlar. Sıralamalar şu ölçütlere göre farklılık gösterir: gösterir. Bu nedenle dönüşüm izleme, bir reklamın nasıl daha fazla Belirli listeleme gruplarının satışa dönüştüğünü gösterir.

Dönüşüm hedefi, aynı hedefe sahip dönüşüm işlemleri belirlemektir. Örneğin, "Satın alma" sahip bir dönüşüm hedefi olabilir "Web sitesi satın alma işlemleri" ve "Mağaza satışları" dönüşüm işlemleri olarak kabul edilir.

Dönüşüm işlemleri, dönüşümleri izlemek ve pek de iyi olmadığını unutmayın. Dönüşüm işlemleri oluşturursunuz ve Google bunları dönüşümde gruplandırırsınız hedefler.

Satın alma dönüşümü işlemi

Burada açıklanan dönüşüm izlemeyi uygulamak, satın alma dönüşümlerinin sayısını ve değeri ölçmek için kullanılan Google Ads hesabı elde edebilirsiniz. Dönüşüm izleme olmadan şunları yapamazsınız: ROAS (gelir getirisi) açısından kampanyanın sağladığı işletme değerini reklam harcaması) için geçerli değildir. Ayrıca, kampanyanın daha hızlı ve daha verimli olması için performansı optimize edebilirsiniz.

Diğer dönüşüm işlemleri

Yalnızca satın alma dönüşümü işlemi gerekli olsa da ek izleme işlemleri dönüşüm işlemleri satıcılarınıza ek analizler sağlayabilir. Biz mümkün olan her şeyi günlüğe kaydetmenizi ve mümkün olduğunca çok sayıda temel dönüşüm işlemlerini ifade eder. Önerilen dönüşüm işlemlerinin tam listesi bölümünde açıklanmıştır.

Genel olarak, aşağıdakileri yakalamanız önerilir:

Değerle doğrudan ilişkili tüm başarılı etkinlikler
add_to_cart ve gibi temel dönüşümlere katkıda bulunan başarı etkinlikleri kayıt.
Etkileşimler ve kullanıcı etkileşimleri, reklamverenlerin son kullanıcılarının ilgisini çekmeyi

İkincil dönüşüm işlemleri yalnızca gözlem ve raporlama amaçlıdır. teklifleri etkileyebilir.Birincil ve ikincil dönüşüm işlemleri hakkında daha fazla bilgi edinin.

Kullanıcı Deneyimi Yönergeleri

Hata riskini en aza indirmek için, dönüşüm işlemlerini otomatik olarak programlı olarak izleme olanağı sunar. Satıcının fikrini almazsanız satıcılarınızın dönüşüm izlemenin ayarlandığını bilmesi gerekir.

Satıcılar mevcut bir Google Ads hesabını bağladığında, hesabında dönüşüm izleme özelliğinin bulunuyor olabileceğine dair bildirim çünkü çözülmesi gereken çakışmalar olabilir. Bir örnek gösteriliyor bölümüne göz atın.

connect_your_google_ads_account

Teknoloji Rehberliği

Dönüşüm izleme şu şekilde çalışır. Bu bölümde her proje için adım:

Satıcınızın Ads hesabında bir "ConversionAction" öğesini oluşturursanız Web sitesinde gerçekleştirilen satın alma işlemlerini (ve isteğe bağlı olarak diğer müşteri işlemlerini) takip edebilir.
Bu dönüşüm işlemi için etiketi veya kod snippet'ini bir web sitesine ya da mobil uygulama. Ayrıntılı bilgi için Web siteniz için dönüşüm izlemeyi ayarlama bölümüne bakın.
Bir müşteri reklamı tıkladığında, sayfanın üst kısmına geçici bir çerez yerleştirilir. bilgisayar veya mobil cihaz kullanıyor.
Müşteri, reklamveren için tanımlanan işlemi tamamladığında Google, çerezi tanır (eklenen kod snippet'i yoluyla) ve bir kayıt "value" gibi diğer parametrelerle birlikte dönüşüm belirtin.

Ön koşullar

Başlamadan önce bir Google etiketi Geliştirici Kimliğiniz olduğundan emin olun. Şunu yapmazsanız: Google etiketi Geliştirici Kimliğiniz varsa Google etiketi geliştirici kimliği istek formu. Geliştirici kimliğiniz farklı diğer kimliklerden (örneğin, Ölçüm Kimliği veya Dönüşüm Kimliği) web sitesi ölçüm kodlarına ekleme yapıyor.

Dönüşüm işlemleri oluşturun ve yapılandırın

Aşağıdaki örneklerde, dönüşüm işleminin nasıl oluşturulacağı ve dönüşüm işleminin nasıl ekleneceği gösterilmektedir Ads hesabı. Her örnek, arka plan kimlik doğrulaması görevlerinin tümünü ele alır. ve dönüşüm işlemi oluşturma konusunda size yol gösterir:

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

Yukarıdaki örnekler genel yapıda olduğundan, aşağıda verilen ek notları ConversionAction özelliğinin Maksimum Performans için doğru şekilde yapılandırıldığından emin olun. Dönüşüm işlemlerinizin her biri aşağıdaki gibi yapılandırılmalıdır:

Tür - Bu satın alma işlemleri, nedeniyle ConversionActionType öğesini WEBPAGE olarak ayarlayın bir web sitesinde gerçekleşen etkinlikleri ifade eder.
Teklif verilebilir: Birincil kampanyanız için true olarak ayarlanır. dönüşüm işlemi (satın alma) kampanyaları satışa yönelik olarak optimize edebilir. İkincil dönüşüm işlemleri (ör.alışveriş sepetine ekleme) için değeri false olarak ayarlayın.
Kategori - Dönüşüm işlemlerinizin her biri (birincil veya ikincil olarak) ConversionActionCategory öğesini ayarlayın. Aşağıda ilgili görüşme işlemi kategorisini bulabilirsiniz. her biri için ayrı bir teklif verme stratejisidir. Google Ads'in dönüşümleri otomatik olarak atadığını unutmayın işlemlerini standart bir dönüşüm hedefine dönüştürebilir. Örneğin, satın alma dönüşümü işlemleri belirli bir . Daha sonra, Maksimum Performans kampanyalarını bu Satın Alma İşlemleri hedefi için optimize edilecek.

Önerilen dönüşüm işlemlerinin listesini aşağıda bulabilirsiniz. Önerilerimiz: bunların en az ilk dört dönüşüm işlemini ve önerilen diğer işlemler konusunda size yardımcı olabilir.

Matbu kataloğun boyutlarını, online satışlarla ilgili ek etkinlikler. Daha ayrıntılı ek dönüşüm işlemleri veya özelleştirilmiş dönüşümler de dönüşüm işlemleri (örneğin, "ödeme bilgileri ekleme" işlemi Kullanıcı web sitesindeki arama seçeneğini her kullandığında veya "arama" Kullanıcı web sitesindeki arama seçeneğini her kullandığında). İkincil dönüşüm işlemleri satıcılarınız için ek izleme sağlar ve Google Ads tarafından gözlem amacıyla kullanılır.

Öncelik	Dönüşüm İşlemi	Dönüşüm İşlemi Kategorisi	Google Etiketi Etkinlik Adı	Açıklama
Zorunlu	Satın al	SATIN ALMA	purchase	Kullanıcı bir satın alma işlemini tamamlar
Tüm mağaza geliştiricileri için şiddetle önerilir	Sepete ekle	ADD_TO_CART	add_to_cart	Kullanıcı sepete bir ürün ekler
Tüm mağaza geliştiricileri için şiddetle önerilir	Ödeme başlatma	BEGIN_CHECKOUT	begin_checkout	Kullanıcı ödeme işlemini başlatır
Tüm mağaza geliştiricileri için şiddetle önerilir	Ürünü görüntüle	PAGE_VIEW	page_view	Kullanıcı bir ürün sayfası açar
Uygun olduğunda önemle tavsiye edilir (genellikle mağaza geliştiricileri için geçerli değildir)	Kaydol	KAYDOL	sign_up	Kullanıcı bir hesaba kaydolur
Uygun olduğunda önemle tavsiye edilir (genellikle mağaza geliştiricileri için geçerli değildir)	Potansiyel müşteri oluşturma	SUBMIT_LEAD_FORM	generate_lead	Kullanıcı, bir form aracılığıyla potansiyel müşteri oluşturur
Uygun olduğunda önemle tavsiye edilir (genellikle mağaza geliştiricileri için geçerli değildir)	Abone ol	SUBSCRIBE_PAID	geçerli değil (özel)	Kullanıcı, ücretli bir hizmete abone olur
Uygun olduğunda önemle tavsiye edilir (genellikle mağaza geliştiricileri için geçerli değildir)	Randevu alma	BOOK_APPOINTMENT	geçerli değil (özel)	Kullanıcı randevu alır
Uygun olduğunda önemle tavsiye edilir (genellikle mağaza geliştiricileri için geçerli değildir)	Fiyat teklifi isteyin	REQUEST_QUOTE	geçerli değil (özel)	Kullanıcı, fiyat tahmini talep eden bir form gönderir

Ads hesabı olan satıcılar

Satıcıların mevcut bir Ads hesabıyla ilk katılım gerçekleştirmesine izin veriyorsanız hesapta dönüşüm işlemlerinin olması anlamına gelir. Yapmadığımız Bu işlem, her defasında yeni bir dönüşüm işleminin gerçekleşmesini garanti edemeyeceğinden doğru bir şekilde ayarlandı. Ayrıca, izlemeniz gereken ek adımlar var. netleştirmeye yardımcı olmaktır:

Hesabın birden fazla hedefi var (örneğin, Satın Alma İşlemleri + Sayfa görüntülemeleri + Kişiler) Bunlar "hesap varsayılanı" olarak işaretlenir. Yeni bir kampanya oluşturulduğunda varsayılan olarak bu hedeflerin tümü için optimizasyon yapar. Şunun için bunu istemezsiniz: Maksimum Performans kampanyası.
Hesapta satın alma işlemlerini izlemek için zaten bir (veya daha fazla) dönüşüm işlemi var ve Satın Alma İşlemleri hedefinin altında gruplandırılır. Bu, siz bu işlemi tamamladıktan sonra etkinleşen iki dönüşüm etiketi olduğu için kampanya, bir satın alma işlemini iki katına çıkarır.

Maksimum Performans kampanyasının özel dönüşüm işleminizi kullandığından emin olmak için yalnızca şu işlemle:

CustomConversionGoal oluşturun ve satın alma dönüşüm işleminizi ekleyin hedefin conversion_actions[] listesine. Durumu ETKİN olarak ayarlayın.
Maksimum Performans kampanyasının ConversionGoalCampaignConfig bölümünde, custom_conversion_goal değerini de ekleyebilirsiniz.
2. adımın sonucunda, Google Ads kampanyanın ConversionGoalCampaignConfig ayarını, goal_config_level değerine ayarlayın. CAMPAIGN adresine (MÜŞTERİ yerine) hesap varsayılan hedefleri), ancak bunun gerçekten yaşanmıştır.

Dönüşüm işlemine ait etiketi alın

Dönüşüm işlemini oluşturduktan sonra web sitesindeki dönüşüm sayfasına yönlendiren bir etiket adı verilen karşılık gelen reklamverenin web sitesine. Google Ads'in tüm dönüşümleri ölçebildiğinden emin olmak için müşterinin tarayıcısından bağımsız olarak Güncellenmiş Google Ads dönüşüm izleme etiketi. Bu etiket iki reklamdan oluşur parçalar:

Sitenizin her sayfasına yüklenmesi gereken global_site_tag reklamverenin web sitesine.
Web'de gezinmenin bir parçası olan web sayfalarında event_snippet ödeme onayı veya potansiyel müşteri gönderme sayfası gibi dönüşüm işlemi

Bu iki bölümü ConversionActionService ile alabilirsiniz.

Etiket, müşteri veya reklam için benzersiz bir tanımlayıcı depolayan çerezler ayarlar kullanıcıyı siteye yönlendiren tıklamadır. Çerezler reklam tıklamasını alır Google Tıklama Kimliği (GCLID) parametresindeki bilgiler değerini değiştirin. Reklamverenin web sitesini etkinleştirmeniz gerekir. benzersiz bir kimlik olan GCLID’yi kaydedip depolamak için bir olası satış izleme sistemi Google Ads, bir Google reklamının her gösterimi için geçerlidir.

Global etiket ve nereye yükleneceği hakkında daha fazla bilgi

Google etiketi (gtag.js) bir etiketleme çerçevesi ve API'sidir. Etkinlik verilerini hem Google Ads'e hem de Google Analytics'e gönderebilirsiniz. Global site etiketi verilerinizi dönüşümlerinin sayısını gösterir. Her sayfanın <head> bölümüne Google etiketini ekleyin sitesinde düzenleme ve Google Ads'le çalışacak şekilde yapılandırma. Ardından etkinlikleri yakalamak ve verileri Google Ads'e göndermek için gtag() komutlarını kullanın. Bunun işleyiş şeklini anlamak için bkz. Google Ads dönüşüm izleme için global site etiketini kullanın.

Google etiketiyle aşağıdaki komutları kullanırsınız:

config: Bir Google ürününü (Google Ads, Analytics vb.) başlatın, ve bir hesaba veri göndermeye hazırlanmanızı sağlar.
event: Aşağıdaki gibi bir etkinlik göndererek bir dönüşüm kaydedin: satın alma (önerilir) veya alışveriş sepetine ekleme (ikincil dönüşüm işlemleri). gtag.js Etkinlik referans kılavuzunu incelemenizi öneririz.
set: Sayfadaki tüm etkinlikler için ortak olan para birimi gibi parametreleri ayarlayın.

Aşağıdaki örnekte, Google Etiket Yöneticisi'ni kullanarak Google Ads’e veri gönder. GOOGLE_CONVERSION_ID yer tutucu değeri, tek bir reklamveren hesabının benzersiz sayısal kimliğidir.

<!-- 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>

Google etiketi snippet'i sayfa başına yalnızca bir kez görünmelidir. Bir durumunda, mevcut etikete yeni etiket kimlikleri eklemeniz gerekir. Göndermek için verilerini birden fazla hesaba kopyalarsanız "config" öğesine bir komutu değeri: dönüşüm kimliğini belirterek, aşağıda gösterildiği gibi her bir hesabın dönüşüm kimliğini aşağıdaki örnekte:

<!-- 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>

Etkinlik snippet'i ve nereye yükleneceği hakkında daha fazla bilgi

Satın alma dönüşümü izleme özelliğinin çalışması için satın alma etkinlik snippet'i doğrudan dönüşüm sayfasına yüklenmelidir. Bu genellikle bir sonraki onay sayfası. Kodun içinde global etiketten sonra herhangi bir yere yerleştirilebilir snippet'i İkincil dönüşüm işlemleri için etkinlik snippet'leri (örneğin: sepete ekleme) ilgili sayfalara yerleştirilmelidir.

Aşağıdaki örnek snippet'te, AW-CONVERSION_ID ve gTag_developer_ID Google Ads hesabınıza ve Google Hesabınıza özel dönüşüm kimliğini Etiket geliştirici hesabı, AW-CONVERSION_LABEL ise dönüşüm anlamına gelir etiketi (dönüşüm işlemi başına benzersizdir):

<!-- 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>

Bazı parametreler isteğe bağlı olsa da, mümkün olduğunca çok parametre eklemeniz önerilir. mümkün olduğunca çok bilgi sağlar. Hangi parametrelerle ilgili daha fazla bilgi edinin? kullanılabilir olduğundan da emin olun.

Parametreler, kullanıcıların etkileşim kurma yöntemleri hakkında ek bilgi sağlar. test edebilirsiniz.

Bir dönüşüm etkinliğini tıklamaya göre ölçmek istiyorsanız (Ör.bir düğme üzerinde veya AJAX kullanan bir site için dinamik yanıt) onun yerine aşağıdaki snippet'i de kullanabilirsiniz:

<!-- 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>

Consent API'yi (İzin Modu olarak da bilinir) uygulama

Google etiketinde, kullanıcı rızasını yönetmek için kullanılan yerleşik bir Consent API'ye sahiptir. Şunları yapabilir: Reklam amaçlı çerezlere ilişkin kullanıcı rızasını analiz amaçlı olanlardan ayırt etmek amaçlar.

Beklenen sonuç, müşterilerin en azından gtag('consent', 'update' öğesini almasıdır. {...}) çağrı entegre edildi ve müşterinin hiçbir işlem yapmasına gerek yok. Bu Google etiketlerinin (Google Ads, Floodlight, Google Analytics, Dönüşüm Bağlayıcı) sağlandığından emin olun en son kullanıcı izin durumunu okuyabilir ve durumu ağa dahil edebilir. (&gcs parametresi aracılığıyla) Google'a iletebilir.

Ek uygulama adımları, gtag('consent', default' {...}) durumunu dağıtmak (ör. kullanıcı arayüzü üzerinden) Google etiketlerinin engelini kaldırmak (örneğin: izne dayalı koşullu tetikleme yok) bu reklamları izinleri gözeten bir şekilde tetiklemek için izin modunu etkinleştirmenizi öneririz.

Uygulama ayrıntıları için İzin ayarlarını yönetme (web) başlıklı makaleyi inceleyin.

İpuçları

Google Ads yönetici hesabından,tüm kampanyalarınızda dönüşümleri tek bir dönüşüm kodu etiketi kullanan reklamveren hesapları. Görüntüleyin hakkında daha fazla bilgi edinin.

Dönüşüm izleme uygulamanızın satıcılarınızdan birine gidip web sitelerinde (veya dahili test web sitesi) ve gerçek bir satın alma işlemi gerçekleştirir. Ardından Google Tag Assistant aracında gözlem yapabilirsiniz. bu sorun giderme kılavuzunu kullanın Google Ads'in etiketinizi gördüğünü doğrulamak için ve dönüşümleri başarılı bir şekilde kaydediyor olması. Ek sorun giderme adımları için site geneline etiket uygulamayla ilgili sorunları giderme başlıklı makaleyi inceleyin.

Önceki dönüşüm etiketini gelişmiş dönüşümlerle destekleyebilirsiniz. Bu da dönüşüm ölçümünüzün doğruluğunu artırabilir ve daha güçlü teklifler verin. Gelişmiş dönüşümleri ayarlama hakkında daha fazla bilgi edinin. Gelişmiş dönüşümleri uygulamadan önce satıcılarınızın bu politikalara uymasını sağlamanız gerekir: gelişmiş dönüşüm müşteri verisi politikalarını aşağıda bulabilirsiniz.

Google Ads Hesabını Bağlama

4.2 Reklam Kampanyası Oluşturma