4.1.5 전환 추적
가치 및 비즈니스에 미치는 영향
Google 생태계의 강력한 머신러닝과 Google 애널리틱스를 사용하려면 전환을 추적 및 리마케팅 태그를 제공합니다.
Google Ads에서 전환은 사용자가 지정된 액션을 취하는 경우를 말합니다. 제품을 구매하거나 모바일 앱을 설치하는 등 광고를 클릭한 후 이메일 목록 가입 등입니다. 전환 추적은 주요 통계를 제공합니다. 사용자의 의도를 광고를 보거나 클릭한 후의 액션, 투자수익 (ROI)을 계산 및 비교하여 광고주가 더욱 정확한 광고 비용을 어디에 집중해야 할지 결정하는 데 도움이 됩니다 또한 추적은 데이터를 조정 목적으로 사용할 수 있다는 의미입니다. 주문은 추적해야 하므로 전환 추적이 특정 등록정보 그룹이 판매로 전환됨
전환 목표는 동일한 목표가 있는 전환 액션의 그룹입니다 근본적인 목표를 달성할 수 있습니다 예: '구매' 전환 목표가 될 수 있습니다 '웹사이트 구매' '매장 판매' 전환 액션으로 사용하세요
전환 액션은 계속해서 전환을 추적하고 확인할 수 있습니다. 전환 액션을 만들고 Google에서 전환 액션을 그룹화합니다. 목표를 달성할 수 있습니다.
구매 전환 액션
여기에 설명된 전환 추적을 구현하면 판매자의 구매 전환수와 가치를 측정할 수 있는 Google Ads 계정 확인할 수 있습니다 전환 추적이 없으면 ROAS (ROAS) 측면에서 캠페인이 얻고 있는 비즈니스 가치를 측정 (광고 지출) 또한 캠페인이 다음과 같이 하도록 설정하는 추가 데이터 신호를 보냅니다. 성능을 최적화할 수 있습니다
기타 전환 액션
구매 전환 액션만 필요하지만 전환 액션이 판매자에게 추가 통계를 제공할 수 있습니다. 최대한 많이 구현하는 동시에 가능한 한 모든 것을 핵심 전환 액션 추천 전환 액션의 전체 목록은 기술 API 안내 섹션에 설명되어 있습니다.
일반적으로 다음을 캡처하는 것이 좋습니다.
- 값과 직접 연결된 성공 이벤트
- add_to_cart와 같은 핵심 전환에 기여하는 성공 이벤트 sign_up을 클릭하세요.
- 광고주가 최종 사용자와의 소통 방식을 이해하는 데 도움이 되는 참여 및 사용자 상호작용
보조 전환 액션은 관찰 및 보고 전용입니다. 기본 및 보조 전환 액션에 대해 자세히 알아보기
UX 안내
오류 위험을 최소화하려면 판매자의 입력 없이 프로그래매틱 방식으로 추적하고 있지만, 판매자가 전환 추적이 설정되었음을 알고 있어야 합니다.
판매자가 기존 Google Ads 계정을 연결하는 경우 계정에 이미 전환 추적이 설정되어 있을 수 있음을 알림 해결해야 할 충돌이 있을 수 있기 때문입니다. 예시 참조하세요.
기술 가이드
전환 추적의 작동 방식은 다음과 같습니다. 이 섹션에서는 각 광고 유형에 대해 단계:
판매자의 Google Ads 계정에서 'ConversionAction'을 만들어 웹사이트에서 이루어진 구매 (및 원하는 경우 기타 고객 액션) 추적
해당 전환 액션에 대한 태그 또는 코드 스니펫을 웹사이트에 추가하거나 확인할 수 있습니다. 자세한 내용은 웹사이트에 전환 추적 설정을 참고하세요.
고객이 광고를 클릭하면 모바일 장치를 사용할 수 있습니다.
고객이 광고주에 대해 정의된 작업을 완료하면 추가된 코드 스니펫을 통해 쿠키를 인식하고 'value' 등의 다른 매개변수와 함께 전환수 집계 변경할 수 있습니다.
자격 요건
시작하기 전에 Google 태그 개발자 ID가 있는지 확인하세요. 그렇지 않은 경우 Google 태그 개발자 ID가 있다면 Google 태그 개발자 ID 요청 양식 개발자 ID가 다릅니다 다른 ID(예: 측정 ID 또는 전환 ID)의 데이터를 사용자가 웹사이트 측정 코드에 추가합니다.
전환 액션 생성 및 구성
다음 예는 전환 액션을 만들어 Google Ads 계정 각 샘플은 전환 액션을 만드는 방법을 확인할 수 있습니다.
자바
// 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());
}
}
}
}
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;
}
}
}
}
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();
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)
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
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
앞의 예는 일반적이기 때문에 여기에 추가 참고사항이 있습니다. ConversionAction이 실적 최대화 캠페인에 맞게 올바르게 구성되었는지 확인합니다. 각 전환 액션은 다음과 같이 구성해야 합니다.
유형 - ConversionActionType을 WEBPAGE로 설정합니다. 구매가 이뤄지기 때문입니다. 이벤트가 웹사이트에서 발생하는 경우
입찰 가능 – 기본 광고그룹에
true로 설정 전환 액션 (구매) 판매를 위해 캠페인을 최적화하세요 보조 전환 액션 (예: 장바구니에 추가)의 경우 값을false로 설정합니다.카테고리 - 각 전환 액션 (기본 또는 보조) ConversionActionCategory를 설정합니다. 아래에서 관련 대화 작업 카테고리를 확인할 수 있습니다. (권장되는 7개의 전환 액션 각각에 대해). Google Ads에서 전환을 자동으로 할당합니다. 카테고리를 기준으로 표준 전환 목표에 추가하세요. 예를 들어 구매 전환 액션이 '구매'라는 표준 전환 목표로 변경됩니다. 나중에 실적 최대화 캠페인을 구성할 수 있습니다. 이 구매 목표에 맞게 최적화됩니다.
아래에서 추천 전환 액션 목록을 확인할 수 있습니다. 권장 조치 최소한 처음 4개의 전환 액션을 구현하고 기타 권장 조치를 취할 수 있습니다.
또한 모바일 인앱 인벤토리에 대한 온라인 판매 관련 추가 이벤트 더욱 세분화된 또한 추가 전환 액션을 만들거나 전환 액션 (예: '결제 정보 추가' 액션) 사용자가 웹사이트에서 검색 옵션을 사용하거나 "검색" 사용자가 웹사이트에서 검색 옵션을 사용할 때마다) 2차 전환 액션은 판매자에게 추가 추적을 제공하며 Google Ads에서 관찰에 사용됩니다.
| 우선순위 | 전환 액션 | 전환 액션 카테고리 | 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 Ads 계정이 있는 판매자
판매자가 기존 Google Ads 계정으로 온보딩하도록 허용하는 경우 계정에 이미 전환 액션이 있는 상황 실제로 기존 전환 액션을 사용할 것을 권장하지만 올바르게 설정되었습니다. 또한 계정 복구를 위해 몇 가지 예가 있습니다
계정에 여러 목표 (예: 구매 + 페이지 조회 + 연락처)가 있음 모두 '계정 기본값'으로 표시되어 있습니다. 새 캠페인을 만들면 기본적으로 이러한 목표에 모두 최적화됩니다 여러분이 실적 최대화 캠페인
계정에 구매 추적을 위한 전환 액션이 하나 이상 있음 이미 구매 목표에 그룹화되어 있습니다. 다시 말해서 캠페인에서 2개의 전환 태그가 실행되고 있으므로 구매가 두 배로 집계됩니다.
실적 최대화 캠페인에서 맞춤 전환 액션을 사용하기 위해 이 작업만 수행할 수 있습니다.
CustomConversionGoal을 만들고 구매 전환 액션을 추가합니다.
conversion_actions[]목록에 추가합니다. 상태를 사용 설정됨으로 설정합니다.실적 최대화 캠페인의 ConversionGoalCampaignConfig에서
custom_conversion_goal에서 (1)단계에서 만든 맞춤 목표에 추가합니다.(2)단계를 수행한 결과, Google Ads에서 자동으로 캠페인의 ConversionGoalCampaignConfig를 사용하여
goal_config_level를 CUSTOMER 대신 CAMPAIGN으로 이전하여 기본 목표)이지만 실제로 이것이 확인할 수 있습니다
전환 액션 태그 가져오기
전환 액션을 만든 후에는 태그라고 하는 해당 코드 스니펫을 확인할 수 있습니다. Google Ads에서 모든 전환을 측정할 수 있도록 하기 위해 고객의 브라우저에 상관없이 업데이트된 Google Ads 전환 추적 태그를 사용해야 합니다. 이 태그는 파트:
global_site_tag: 확인할 수 있습니다.event_snippet은 전환 액션(예: 결제 확인, 리드 제출 페이지)
ConversionActionService를 사용하여 이 두 부분을 검색할 수 있습니다.
태그는 고객 또는 광고의 고유 식별자를 저장하는 쿠키를 설정합니다. 광고를 클릭할 수 있습니다. 쿠키는 광고 클릭을 수신합니다. Google 클릭 식별자 (GCLID) 매개변수의 정보 포함 를 사용해야 합니다. 광고주의 웹사이트를 사용 설정해야 하며 리드 추적 시스템을 통해 Google 고유 ID를 통해 GCLID를 Google Ads에서는 Google 광고의 모든 노출이 발생합니다.
전체 태그 및 태그 설치 위치 자세히 알아보기
Google 태그 (gtag.js)는 태그 지정 프레임워크 및 API로,
Google Ads와 Google 애널리틱스로 이벤트 데이터를 전송합니다. 전체 사이트 태그
이벤트 스니펫 또는 전화 스니펫과 함께 작동하여
전환 모든 페이지의 <head> 섹션에 Google 태그를 추가합니다.
Google Ads에서 작동하도록 구성해야 합니다. 그런 다음
gtag() 명령어를 사용하여 이벤트를 캡처하고 Google Ads에 데이터를 전송합니다.
작동 방식을 이해하려면 다음을 참조하세요.
Google Ads 전환 추적에 전체 사이트 태그를 사용합니다.
Google 태그와 함께 다음 명령어를 사용합니다.
config: Google 제품 (Google Ads, 애널리틱스 등)을 초기화합니다. 설정을 구성하고 계정으로 데이터를 전송할 준비를 합니다.
이벤트: 다음과 같은 이벤트를 전송하여 전환을 등록합니다. 구매 (권장) 또는 장바구니에 추가 (보조 전환 액션) gtag.js 이벤트 참조 가이드를 검토하시기 바랍니다.
set: 통화 등 페이지의 모든 이벤트에 공통된 매개변수를 설정합니다.
다음 예는 전체 사이트 태그의 JavaScript 코드 스니펫입니다. Google Ads로 데이터를 전송할 수 없습니다. GOOGLE_CONVERSION_ID 자리표시자 값은 고유한 숫자 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 태그 스니펫은 페이지당 한 번만 표시되어야 합니다. 기존 gtag.js 인스턴스를 사용하고 있다면 기존 태그에 새 태그 ID를 추가해야 합니다. 보내기 여러 계정에 데이터를 추가하려면 'config'에 '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 Ads 계정과 Google Ads 계정에 고유한 전환 ID를 개발자 계정에 태그 지정(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>
Consent API (동의 모드라고도 함) 구현하기
Google 태그에는 사용자 동의를 관리하기 위한 Consent API가 기본으로 포함되어 있습니다. 다음을 할 수 있습니다. 광고 목적의 쿠키에 대한 사용자 동의와 분석용 사용자 동의를 구별합니다. 있습니다.
예상되는 결과는 고객이 최소한 gtag('consent', 'update' {...} 통화를 통합했으며 고객이 조치를 취할 필요가 없습니다. 이렇게 해야 Google 태그 (Google Ads, 플러드라이트, Google 애널리틱스, 전환 링커)를 확인하세요. 최신 사용자 동의 상태를 읽고 상태를 네트워크에 포함할 수 있음 &gcs 매개변수를 통해 Google에 요청합니다.
추가 구현 단계는 gtag('consent', default' {...}) 상태 배포(예: UI를 통해) Google 태그를 차단 해제 (예: 동의를 기반으로 하지 않는 조건부 실행)하여 동의 모드를 사용 설정하여 동의를 인식하는 방식으로 광고를 실행할 수 있습니다.
구현에 관한 자세한 내용은 동의 설정 관리하기 (웹)를 참고하세요.
팁
Google Ads 관리자 계정에서 모든 계정의 전환을 추적할 수 있습니다. 광고주 계정을 만들 수 있습니다. 자세한 내용은 교차 계정 전환 추적에 대해 자세히 알아보세요.
전환 추적이 제대로 구현되어 있는지 여부를 테스트하는 가장 좋은 방법은 판매자의 데이터 센터로 이동하여 웹사이트 (또는 내부 테스트 웹사이트) 실제로 구매할 수 있습니다. 그런 다음 Google Tag Assistant 도구에서 관찰할 수 있습니다. 이 문제 해결 가이드를 사용하세요 Google Ads에서 태그를 인식했는지 확인하세요 전환이 기록되고 있는지 확인하세요 다른 문제 해결 방법은 사이트 전체 태그 문제 해결하기를 참고하세요.
위의 전환 태그를 향상된 전환으로 보완할 수 있습니다. 전환 측정의 정확성을 높일 수 있습니다 입찰의 효과를 높일 수 있습니다 향상된 전환 설정에 대해 자세히 알아보세요. 향상된 전환을 구현하기 전에 판매자가 판매자는 Google Ads의 향상된 전환 고객 데이터 정책