4.1.5 コンバージョン トラッキング

価値とビジネスへの影響

Google エコシステムの強力な機械学習と AI を効果的に提供し、 貴社の Google 広告キャンペーンを ウェブサイトのトラッキング タグとリマーケティング タグ。

Google 広告のコンバージョンは、ユーザーが特定のアクションを行うことです 広告をクリックした後（商品の購入、モバイルアプリのインストール、 メーリング リストへの登録も可能です。コンバージョン トラッキングから得られる重要なインサイト ユーザーのユーザーが広告を表示またはクリックした後に行った操作 費用対効果（ROI）の計算と比較を行い、クライアントを支援 重点的に広告費を 投入する部門を決定できますまた、追跡によって そのデータが調整に利用できることが わかります注文は、 です。コンバージョン トラッキングは、ユーザーが商品やカテゴリを 特定のリスティング グループが売り上げにつながっている。

コンバージョン目標とは、同じ 理解することが重要です。例: 「購入」コンバージョンの目標として 'ウェブサイトでの購入'[店舗販売][コンバージョンアクション]を選択します

コンバージョンのトラッキングと最適化には、引き続きコンバージョン アクションが使用されます ありますコンバージョン アクションを作成して Google がコンバージョンにグループ化する あります。

購入コンバージョン アクション

ここで説明するコンバージョン トラッキングを実装すると、販売者の 購入コンバージョンの数とコンバージョン値を測定する Google 広告アカウント 測定しますコンバージョン トラッキングがないと、次のことはできない。 キャンペーンがもたらしているビジネス価値を ROAS（広告費用対効果）の観点から測定する 。また、キャンペーンで以下を可能にする追加のデータシグナルも送信されます。 パフォーマンスを最適化できます

その他のコンバージョン アクション

購入コンバージョン アクションは必須ですが、追加のコンバージョン アクションをトラッキングします。 コンバージョン アクションを追加すると、販売者に詳細な分析情報を提供できます。水 可能な限りすべてロギングすることをおすすめします。ただし、できるだけ多くの 確認できます推奨されるコンバージョン アクションの全一覧は次のとおりです。 をご覧ください。

一般に、以下の情報を取得することをおすすめします。

  • 価値に直結する成功イベント
  • コア コンバージョンに寄与する成功イベント（add_to_cart や sign_up。
  • 広告主がエンドユーザーに対するエンゲージメントを理解するための、エンゲージメントとユーザー インタラクション

サブのコンバージョン アクションはモニタリングとレポート専用です。 入札に影響します。メインとサブのコンバージョン アクションの詳細

UX ガイダンス

エラーのリスクを最小限に抑えるため、コンバージョン トラッキングの実装をおすすめします プログラマティックにトラッキングできますが、 コンバージョン トラッキングが設定されていることを販売者に知らせます。

販売者が既存の広告アカウントをリンクする場合は、 アカウントですでにコンバージョン トラッキングが設定されている可能性があることを知らせる通知 競合を解決する必要がある可能性があるためです。この例で ご覧ください

connect_your_google_ads_account

技術ガイダンス

コンバージョン トラッキングの仕組みは次のとおりです。このセクションでは、 手順:

  1. 販売者の Google 広告アカウントで 'ConversionAction' を作成し、 ウェブサイトで行われた購入（およびその他のユーザー行動）をトラッキングする。

  2. そのコンバージョン アクションのタグ（コード スニペット）をウェブサイトに追加するか、 説明します。詳しくは、ウェブサイトでのコンバージョン トラッキングを設定するをご覧ください。

  3. ユーザーが広告をクリックすると、一時的な Cookie が パソコンやモバイルデバイスなどです

  4. 広告主様に対して指定された操作をユーザーが完了すると、Google （追加されたコード スニペットによって）Cookie を認識し、 他のパラメータ（値やできます。

前提条件

開始する前に、Google タグのデベロッパー ID があることを確認してください。この操作を Google タグのデベロッパー ID がある場合は、 Google タグ デベロッパー ID リクエスト フォームデベロッパー ID が異なります 測定 ID やコンバージョン ID など他の ID から、 ユーザーがウェブサイトの測定コードに追加します。

コンバージョン アクションを作成、設定する

コンバージョン アクションを作成して追加する方法の例 Google 広告アカウント各サンプルは、すべてのバックグラウンド認証タスクを処理し、 コンバージョン アクションを作成する手順が示されます。

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

上記の例は本質的に汎用的なものなので、ここに追加の注記があります。 ConversionAction が P-MAX で正しく設定されていることをご確認ください。 各コンバージョン アクションは、次のように設定する必要があります。

  • タイプ - ConversionActionType を WEBPAGE となるよう設定します。これは購入が伴うためです。 イベントの数を示す指標です。

  • 入札対象 – メインの取引先を true に設定 コンバージョン アクション（購入） 売り上げを重視してキャンペーンを最適化します サブのコンバージョン アクション（カートに追加など）の場合: 値を false に設定します。

  • カテゴリ - コンバージョン アクションごと（メインまたは セカンダリ）、ConversionActionCategory を設定します。 以下に、関連する会話のアクション カテゴリを示します 設定することをおすすめします 注: Google 広告によってコンバージョンが自動的に割り当てられる 標準のコンバージョン目標にカテゴリに応じて分類します。 たとえば 購入コンバージョンアクションは 標準のコンバージョン目標「購入」にマッピングされます。 後で P-MAX キャンペーンと 「購入」の目標に向けて最適化できます

以下に、推奨されるコンバージョン アクションのリストを示します。おすすめの方法 少なくとも最初の 4 つのコンバージョン アクションと 示されます。

また、Terraform などの オンライン販売に関連する追加イベントをご覧ください。さらに詳細な 追加のコンバージョン アクションを作成したり、 コンバージョン アクション（「お支払い情報を追加する」などのアクション） ユーザーがウェブサイトで検索オプションを使用したり、 「検索」ユーザーがウェブサイトで検索オプションを使用するたび）。セカンダリ コンバージョンアクションは 販売者向けの追加のトラッキング機能として 使用されるデータです。

優先度 コンバージョン アクション コンバージョン アクションのカテゴリ Google タグのイベント名 説明
必須 購入 購入 purchase ユーザーが購入を完了
すべての店舗ビルダーに強く推奨 カートに追加 ADD_TO_CART add_to_cart ユーザーが商品をカートに追加
すべての店舗ビルダーに強く推奨 決済手続きの開始 BEGIN_CHECKOUT begin_checkout ユーザーが購入手続きを開始
すべての店舗ビルダーに強く推奨 商品を見る PAGE_VIEW page_view ユーザーが商品ページを開く
該当する場合は強く推奨（通常はネットショップビルダーには適用されない） 登録 登録 sign_up ユーザーがアカウントに登録
該当する場合は強く推奨（通常はネットショップビルダーには適用されない） 見込み顧客の獲得 SUBMIT_LEAD_FORM generate_lead ユーザーがフォームを通じて見込み顧客を発掘する
該当する場合は強く推奨（通常はネットショップビルダーには適用されない） 登録 SUBSCRIBE_PAID 該当なし（カスタム） ユーザーが有料サービスに加入する
該当する場合は強く推奨（通常はネットショップビルダーには適用されない） 予約 BOOK_APPOINTMENT 該当なし（カスタム） ユーザーが予定を予約する
該当する場合は強く推奨（通常はネットショップビルダーには適用されない） 見積もりのリクエスト REQUEST_QUOTE 該当なし（カスタム） ユーザーが価格の見積もりを求めるフォームを送信する

既存の Google 広告アカウントを持つ販売者

販売者が既存の Google 広告アカウントでのオンボーディングを許可している場合、 アカウントにすでにコンバージョン アクションがある場合。Google が 既存のコンバージョン アクションの使用を推奨します。 確認しますまた、Google Meet の設定を管理する際、 適切なツールが必要になります

  • アカウントに複数の目標がある（例: 購入 + ページビュー + コンタクト） すべて「アカウントのデフォルト」とマークされます新しいキャンペーンが作成されると デフォルトではこれらの目標の すべてを重視して最適化されますこれは、 P-MAX キャンペーンのテストです

  • アカウントに、購入をトラッキングするコンバージョン アクションが 1 つ以上設定されており、 すでに「購入」目標にグループ化されていますつまり 2 つのコンバージョン タグが配信されているため、キャンペーンで購入が 2 倍にカウントされます。

P-MAX キャンペーンでカスタム コンバージョン アクションが使用されるようにする そのアクションのみ:

  1. CustomConversionGoal を作成し、購入コンバージョン アクションを追加します。 目標の conversion_actions[] のリストに追加されます。ステータスを [ENABLED] に設定します。

  2. P-MAX キャンペーンの ConversionGoalCampaignConfig で、次のように設定します。 custom_conversion_goal を、ステップ（1）で作成したカスタム目標に追加します。

  3. ステップ（2）の結果、 キャンペーンの ConversionGoalCampaignConfig（goal_config_level を設定する） CAMPAIGN に送信します（CUSTOMER は使用せず、 アカウントのデフォルトのコンバージョン目標など）が使用されますが、 発生しました。

コンバージョン アクションのタグを取得する

コンバージョン アクションを作成したら、 対応するコード スニペットが、コンバージョン ページにタグと呼ばれる 広告主のウェブサイトのGoogle 広告ですべてのコンバージョンを確実に測定できるようにする 使用するブラウザに関係なく、 更新版の Google 広告コンバージョン トラッキング タグこのタグは次の 2 つで構成されます part:

  • global_site_tag: ページのすべてのページにインストールする必要があります。 広告主のウェブサイトの

  • event_snippet: コンバージョン アクション（購入手続きの確認や見込み顧客の送信ページなど）

この 2 つの部分は ConversionActionService で取得できます。

このタグでは、顧客または広告の一意の識別子を格納する Cookie を設定します サイトへユーザーを誘導したクリック広告クリックを受け取る Cookie Google クリック ID（GCLID）パラメータの情報を含む 指定する必要があります。広告主のウェブサイトを有効にして、 取得して保存します。GCLID（顧客は Google 広告は、Google 広告のすべてのインプレッションを記録します。

グローバルタグの詳細と設置場所

Google タグ（gtag.js）は、 Google 広告と Google アナリティクスの両方にイベントデータを送信する。グローバル サイトタグ イベント スニペットや電話番号スニペットと連携して、 できます。すべてのページの <head> セクションに Google タグを追加します。 Google 広告と連携するように設定する。その後、 gtag() コマンドを使用してイベントを取得し、データを送信する この仕組みを理解するには、 Google 広告のコンバージョン トラッキングにグローバル サイトタグを使用します。

Google タグでは、次のコマンドを使用します。

  • config: Google サービス（Google 広告、アナリティクスなど）を初期化する。 設定、アカウントへのデータ送信の準備を行います。

  • event: 次のようなイベントを送信してコンバージョンを登録します。 購入（推奨）、またはショッピング カートへの追加 （サブのコンバージョン アクション）。 gtag.js イベント リファレンス ガイドを確認することをおすすめします。

  • set: ページ上のすべてのイベントに共通するパラメータ（通貨など）を設定します。

以下は、グローバル サイトタグの JavaScript コード スニペットです。 Google 広告にデータを送信します。GOOGLE_CONVERSION_ID プレースホルダ値は、 1 つの広告主アカウントの一意の数値 ID です。

<!-- 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 タグスニペットは 1 ページに 1 回だけ配置する必要があります。既存の 新しいタグ ID を既存のタグに追加する必要があります。送金先 複数のアカウントにデータを転送したい場合は、「config」関数の呼び出しをコマンドを 各アカウントのコンバージョン ID を指定します（下の図を参照）。 使用します。

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

イベント スニペットの詳細とインストール場所

購入コンバージョン トラッキングを使用するには、購入イベント スニペット コンバージョン ページ自体にインストールする。通常は 確認ページが開きますコード内の任意の場所に配置でき、グローバル タグの後に配置できます。 スニペットです。サブのコンバージョン アクションのイベント スニペット （例: カートに追加）をそれぞれのページに配置する必要があります。

以下のスニペットのサンプルでは、AW-CONVERSION_ID と gTag_developer_ID です。 は、Google 広告アカウントと Google デベロッパー アカウントにタグを付けます。AW-CONVERSION_LABEL はコンバージョンを表します。 このラベルはコンバージョン アクションごとに一意です。

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

一部のパラメータは省略可能ですが、できる限り多くのパラメータを含めることをおすすめします。 各イベントで利用可能な 追加の情報を提供しますパラメータの詳細 （イベントタイプごとに利用可能）をご覧ください。

パラメータは、ユーザーによる操作に関する追加情報を提供します。 確認しましょう

クリックに基づいてコンバージョン イベントを測定する場合 （例: ボタン、または AJAX を使用したサイトの動的な応答）。 代わりに次のスニペットを使用することもできます。

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

Google タグには、ユーザーの同意を管理する Consent API が組み込まれています。できること 広告目的での Cookie 使用と分析目的でのユーザー同意を区別する あります。

想定される結果: 少なくとも gtag（'consent'、'update'） {...}）通話が組み込まれており、お客様による操作は不要です。これにより、 Google タグ（Google 広告、Floodlight、Google アナリティクス、コンバージョン リンカー）を確認する ユーザーの同意ステータスを読み取り、ネットワーク リクエストを Google に送信します（パラメータ &gcs を使用）。

次の実装ステップでは、 gtag('consent', default' {...}) 状態を（UI などを介して）デプロイし、 Google タグ（例: 同意に基づく条件付き配信なし）のブロックを解除して、 同意モードを有効にして、同意ステータスに応じた形で配信されるようにします。

実装について詳しくは、同意設定を管理する（ウェブ）をご覧ください。

ヒント

Google 広告クライアント センター（MCC）アカウントを使用すると、 1 つのコンバージョン コードタグを使用する。詳しくは、 クロスアカウント コンバージョン トラッキングの概要をご確認ください。

コンバージョン トラッキングの実装状況をテストする最善の方法は、 まずは販売者のページにアクセスして ウェブサイト（または内部テスト ウェブサイト） 実際に購入します その後、Google Tag Assistant ツールでモニタリングできます。 このトラブルシューティング ガイドを使用してください タグが認識されたことを確認する コンバージョンが記録されています その他のトラブルシューティングについては、サイトワイドのタグ設定に関するトラブルシューティングをご覧ください。

上記のコンバージョン タグは、拡張コンバージョンで補完できます。 コンバージョン測定の精度が向上する より効果的な入札が可能になります 詳しくは、拡張コンバージョンを設定するをご覧ください。 拡張コンバージョンを実装する前に、 販売者がポリシーに準拠する必要があります Google 広告の拡張コンバージョンの顧客データに関するポリシー

前へ
Google 広告アカウントのリンク
次へ
4.2 広告キャンペーンの作成