4.1.5 Отслеживание конверсий
Ценность и влияние на бизнес
Чтобы эффективно использовать мощные возможности машинного обучения и аналитики экосистемы Google для рекламных кампаний ваших торговых клиентов, вам необходимо разместить теги отслеживания конверсий и ремаркетинга на веб-сайтах клиентов.
Конверсия в Google Рекламе — это когда пользователь выполняет определенное действие после нажатия на рекламу, например покупку продукта, установку мобильного приложения или подписку на рассылку по электронной почте. Отслеживание конверсий предоставляет ключевую информацию о действиях пользователей после просмотра или нажатия на рекламу, включая информацию для расчета и сравнения рентабельности инвестиций (ROI), чтобы помочь вашим клиентам принять решение о том, на чем сосредоточить расходы на рекламу. Отслеживание также помогает гарантировать доступность данных для целей сверки. Заказы различаются в зависимости от продукта или категории, поэтому отслеживание конверсий также может быть полезно, чтобы показать, как определенные группы объявлений конвертируются в продажи.
Цель конверсии – это группа действий-конверсий, имеющих одну и ту же основную цель. Например, «Покупка» может быть целью конверсии, в которой в качестве действий-конверсий указаны «Покупки на сайте» и «Продажи в магазине».
Действия-конверсии по-прежнему используются для отслеживания конверсий и оптимизации кампании. Вы создаете действия-конверсии, а Google группирует их в целях конверсии.
Действие-конверсия «Покупка»
Внедрение описанного здесь отслеживания конверсий позволяет аккаунту Google Рекламы вашего продавца измерять количество конверсий-покупок и ценность этих конверсий. Без отслеживания конверсий вы не сможете оценить коммерческую ценность кампании с точки зрения ROAS (рентабельности расходов на рекламу). Он также отправляет дополнительные сигналы данных, которые позволяют кампании оптимизировать эффективность.
Другие действия-конверсии
Хотя требуется только действие-конверсия «покупка», отслеживание дополнительных действий-конверсий может предоставить вашим продавцам дополнительную информацию. Мы рекомендуем регистрировать все возможное, одновременно реализуя как можно больше основных действий-конверсий. Полный список рекомендуемых действий-конверсий описан в разделе руководства по Tech API.
В целом рекомендуется фиксировать следующее:
- Любое событие успеха, напрямую связанное с ценностью
- Успешные события, которые способствуют основным конверсиям, например add_to_cart и Sign_up.
- Взаимодействие и взаимодействие с пользователем, которые помогают рекламодателям понять, как они привлекают своих конечных пользователей.
Вторичные действия-конверсии предназначены только для наблюдения и отчетности и влияют на назначение ставок. Узнайте больше об основных и дополнительных действиях-конверсиях.
UX-руководство
Чтобы свести к минимуму риск ошибок, мы рекомендуем вам реализовать отслеживание конверсий программно без участия продавцов, но вы должны убедиться, что ваши продавцы знают, что отслеживание конверсий настроено.
Когда продавцы связывают существующую учетную запись Ads, мы рекомендуем отображать уведомление о том, что в их учетной записи может быть уже настроено отслеживание конверсий, поскольку могут возникнуть конфликты, которые необходимо разрешить. Пример показан ниже.
Техническое руководство
Вот как работает отслеживание конверсий. В этом разделе более подробно описан каждый шаг:
Вы создаете «ConversionAction» в рекламном аккаунте своего продавца для отслеживания покупок (и, при необходимости, других действий клиентов), совершенных на его веб-сайте.
Вы добавляете тег или фрагмент кода для этого действия-конверсии на веб-сайт или в мобильное приложение. Подробную информацию см. в разделе Настройка отслеживания конверсий для вашего веб-сайта .
Когда клиент нажимает на объявление, на его компьютере или мобильном устройстве сохраняется временный файл cookie.
Когда клиент выполняет действие, определенное для рекламодателя, Google распознает файл cookie (через добавленный фрагмент кода) и записывает конверсию вместе с другими параметрами, такими как «ценность», если это необходимо.
Предварительные условия
Прежде чем начать, убедитесь, что у вас есть идентификатор разработчика тега Google. Если у вас нет идентификатора разработчика тегов Google, заполните форму запроса идентификатора разработчика тегов Google . Ваш идентификатор разработчика отличается от других идентификаторов, таких как идентификатор измерения или идентификатор конверсии, которые ваши конечные пользователи добавляют в код измерения своего веб-сайта.
Создание и настройка действий-конверсий
В следующих примерах показано, как создать действие-конверсию и добавить его в аккаунт Рекламы. Каждый пример выполняет за вас все задачи фоновой аутентификации и помогает создать действие-конверсию:
Джава
// 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());
}
}
}
}
С#
// 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();
Питон
#!/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)
Рубин
#!/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
Перл
#!/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 Реклама автоматически назначает действия-конверсии стандартной цели конверсии в зависимости от их категории. Например, действия-конверсии «Покупки» назначаются стандартной цели конверсии «Покупки». Позже вы сможете настроить кампанию с максимальной эффективностью для оптимизации этой цели "Покупки".
Ниже вы можете найти список рекомендуемых действий-конверсий. Мы рекомендуем выполнить хотя бы первые четыре действия-конверсии и как можно больше других рекомендуемых действий.
Вы также можете рассмотреть возможность проведения дополнительных мероприятий, имеющих отношение к онлайн-продажам . Для еще более детального отслеживания вы также можете создавать дополнительные действия-конверсии или настраиваемые действия-конверсии (например, действие «Добавить платежную информацию» каждый раз, когда пользователь использует функцию поиска на веб-сайте, или действие «Поиск» каждый раз). пользователь использует функцию поиска на сайте). Вторичные действия-конверсии обеспечивают дополнительное отслеживание ваших продавцов и используются Google Рекламой для наблюдения.
| Приоритет | Действие-конверсия | Категория действия-конверсии | Название события тега Google | Описание |
|---|---|---|---|---|
| Обязательный | Покупка | ПОКУПКА | покупка | Пользователь совершает покупку |
| Настоятельно рекомендуется всем строителям магазинов. | Добавить в корзину | ДОБАВИТЬ В КОРЗИНУ | добавить в корзину | Пользователь добавляет товар в корзину |
| Настоятельно рекомендуется всем строителям магазинов. | Начать оформление заказа | BEGIN_CHECKOUT | начать_чекаут | Пользователь начинает процесс оформления заказа |
| Настоятельно рекомендуется всем строителям магазинов. | Посмотреть элемент | ВИД СТРАНИЦЫ | Вид страницы | Пользователь открывает страницу продукта |
| Настоятельно рекомендуется, когда это применимо (обычно не применимо к строителям магазинов) | Зарегистрироваться | ЗАРЕГИСТРИРОВАТЬСЯ | зарегистрироваться | Пользователь регистрирует учетную запись |
| Настоятельно рекомендуется, когда это применимо (обычно не применимо к строителям магазинов) | Создать лид | SUBMIT_LEAD_FORM | генерировать_лида | Пользователь генерирует лид через форму |
| Настоятельно рекомендуется, когда это применимо (обычно не применимо к строителям магазинов) | Подписаться | SUBSCRIBE_PAID | неприменимо (по индивидуальному заказу) | Пользователь подписывается на платную услугу |
| Настоятельно рекомендуется, когда это применимо (обычно не применимо к строителям магазинов) | Записаться на прием | ЗАБРОНИРОВАТЬ_ВСТРЕЧУ | неприменимо (по индивидуальному заказу) | Пользователь записывает встречу |
| Настоятельно рекомендуется, когда это применимо (обычно не применимо к строителям магазинов) | Запросить цену | ЗАПРОСИТЬ ЦЕНУ | неприменимо (по индивидуальному заказу) | Пользователь отправляет форму с запросом оценки цены |
Продавцы с существующим аккаунтом Google Рекламы
Если вы разрешите продавцам подключаться к существующей учетной записи Рекламы , вы можете столкнуться с ситуацией, когда в учетной записи уже есть действия-конверсии. Мы не рекомендуем использовать существующее действие-конверсию, поскольку нет гарантии, что оно настроено правильно. Кроме того, есть дополнительные шаги, которые вам необходимо предпринять, чтобы справиться с этими потенциальными сценариями:
У учетной записи есть несколько целей (например, «Покупки + Просмотры страниц + Контакты»), которые помечены как «Учетная запись по умолчанию». Когда создается новая кампания, она по умолчанию оптимизируется для достижения всех этих целей. Вам не нужно этого для кампании с максимальной эффективностью.
В аккаунте уже есть одно (или несколько) действий-конверсий для отслеживания покупок, и они уже сгруппированы по цели «Покупки». Это означает, что после вас кампания дважды засчитывает покупку, потому что срабатывают два тега конверсии.
Чтобы гарантировать, что в кампании с максимальной эффективностью используется только ваше специальное действие-конверсия:
Создайте CustomConversionGoal и добавьте действие-конверсию «Покупка» в список
conversion_actions[]цели. Установите статус ВКЛЮЧЕНО .В ConversionGoalCampaignConfig кампании с максимальной эффективностью задайте
custom_conversion_goalдля специальной цели, созданной на шаге (1).В результате шага (2) Google Реклама должна была автоматически обновить ConversionGoalCampaignConfig кампании, чтобы для параметра
goal_config_levelбыло установлено значение CAMPAIGN (вместо CUSTOMER , что предписывало бы ей использовать цели аккаунта по умолчанию), но стоит еще раз проверить, что это действительно произошло.
Получите тег для действия-конверсии
После создания действия-конверсии вам необходимо вставить соответствующий фрагмент кода, называемый тегом, на страницу конверсии на сайте рекламодателя. Чтобы Google Реклама могла отслеживать все конверсии независимо от браузера клиента, используйте обновленный тег отслеживания конверсий Google Рекламы . Этот тег состоит из двух частей:
global_site_tag, который необходимо установить на каждой странице сайта рекламодателя.event_snippet, который следует размещать на веб-страницах, указывающих на действие-конверсию, например на странице подтверждения оформления заказа или отправки потенциального клиента.
Вы можете получить эти две части с помощью ConversionActionService .
Тег устанавливает файлы cookie, в которых сохраняется уникальный идентификатор клиента или клика по объявлению, который привел клиента на сайт. Файлы cookie получают информацию о кликах по объявлению из параметра идентификатора кликов Google ( GCLID ), включенного в тег отслеживания конверсий. Вы должны разрешить веб-сайту рекламодателя и системе отслеживания потенциальных клиентов фиксировать и сохранять GCLID, который представляет собой уникальный идентификатор, который Google Реклама предоставляет для каждого показа объявления Google.
Подробнее о глобальном теге и о том, где его установить
Тег Google (gtag.js) – это платформа тегов и API, позволяющая отправлять данные о событиях как в Google Ads, так и в Google Analytics. Глобальный тег сайта работает вместе с фрагментом события или фрагментом кода телефона для отслеживания конверсий. Добавьте тег Google в раздел <head> на каждой странице сайта рекламодателя и настройте его для работы с Google Ads. Затем вы можете использовать команды gtag() для регистрации событий и отправки данных в Google Рекламу. Чтобы понять, как это работает, ознакомьтесь со статьей Использование глобального тега сайта для отслеживания конверсий Google Рекламы .
С тегом Google вы используете следующие команды:
config: инициализируйте продукт Google (Google Ads, Analytics и т. д.), настройте параметры и подготовьтесь к отправке данных в учетную запись.
Событие: зарегистрируйте конверсию, отправив такое событие, как покупка (рекомендуется) или добавление в корзину ( вторичные действия-конверсии ). Рекомендуем ознакомиться со справочным руководством по мероприятиям gtag.js.
set: установите параметры, общие для всех событий на странице, например валюту.
Следующий пример представляет собой фрагмент кода JavaScript глобального тега сайта для отправки данных в Google Рекламу. Значение заполнителя GOOGLE_CONVERSION_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, вам следует добавить новые идентификаторы тегов к существующему тегу. Чтобы отправить данные в несколько учетных записей, вы можете добавить вызов команды «config» для каждой используемой вами учетной записи, указав идентификатор конверсии каждой учетной записи, как показано в следующем примере:
<!-- 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>
Внедрите API согласия (также известный как режим согласия).
Тег Google имеет встроенный API согласия для управления согласием пользователей. Он способен отличать согласие пользователя на использование файлов cookie для рекламных целей и для аналитических целей.
Ожидаемый результат заключается в том, что клиенты получат как минимум интегрированный вызов gtag('consent', 'update' {...}) без каких-либо действий со стороны клиента. Это должно гарантировать, что теги Google (Google Ads, Floodlight, Google Analytics, Conversion Linker) смогут считывать последнее состояние согласия пользователя и включать его в сетевые запросы к Google (через параметр &gcs).
Дополнительными шагами реализации могут быть развертывание или помощь рекламодателям в развертывании (например, через пользовательский интерфейс) состояния gtag('consent', default' {...}) и разблокировка тегов Google (пример: отсутствие условного запуска на основе согласия). чтобы включить режим согласия, чтобы запускать их с учетом согласия.
Подробные сведения о реализации см. в разделе Управление настройками согласия (через Интернет) .
Советы
Из управляющего аккаунта Google Рекламы вы можете отслеживать конверсии во всех ваших аккаунтах рекламодателей, используя единый тег кода конверсии. См . информацию об отслеживании конверсий между аккаунтами .
Лучший способ проверить, работает ли ваша реализация отслеживания конверсий, — это зайти на один из веб-сайтов ваших продавцов (или на внутренний тестовый веб-сайт) и совершить реальную покупку. Затем вы можете использовать это руководство по устранению неполадок в инструменте Google Tag Assistant , чтобы убедиться, что Google Ads увидел ваш тег и успешно записывает конверсии. Дополнительные сведения об устранении неполадок см. на странице устранения неполадок с тегами на всем сайте .
Вы можете дополнить предыдущий тег конверсии расширенным отслеживанием конверсий, что позволит повысить точность измерения конверсий и повысить эффективность назначения ставок. Узнайте больше о настройке расширенного отслеживания конверсий . Прежде чем внедрять расширенное отслеживание конверсий , убедитесь, что ваши продавцы соблюдают правила использования данных клиентов для расширенного отслеживания конверсий в Google Рекламе.