4.1.5 Отслеживание конверсий
Ценность и влияние на бизнес
Для эффективного использования мощных инструментов машинного обучения и аналитики экосистемы Google в рекламных кампаниях ваших клиентов-продавцов необходимо разместить теги отслеживания конверсий и ремаркетинга на сайтах клиентов.
В Google Ads конверсия — это действие, которое пользователь совершает после клика по объявлению, например, покупает товар, устанавливает мобильное приложение или подписывается на рассылку. Отслеживание конверсий предоставляет важную информацию о действиях пользователей после просмотра или клика по объявлению, включая данные для расчета и сравнения рентабельности инвестиций (ROI), что помогает вашим клиентам принимать решения о том, куда направить рекламные расходы. Отслеживание также помогает обеспечить доступность данных для целей сверки. Заказы различаются в зависимости от товара или категории, поэтому отслеживание конверсий может быть полезно для демонстрации того, как определенные группы объявлений конвертируются в продажи.
Цель конверсии — это группа действий конверсии, объединенных одной и той же целью. Например, «Покупка» может быть целью конверсии, включающей «Покупки на сайте» и «Продажи в магазине» в качестве действий конверсии.
Действия по конверсии по-прежнему используются для отслеживания конверсий и оптимизации кампании. Вы создаете действия по конверсии, а Google группирует их в цели конверсии.
действие конверсии покупки
Внедрение описанного здесь отслеживания конверсий позволяет аккаунту Google Ads вашего продавца измерять количество конверсий в покупки и ценность этих конверсий. Без отслеживания конверсий вы не сможете измерить коммерческую ценность, которую приносит кампания, с точки зрения ROAS (возврата инвестиций в рекламу). Кроме того, это отправляет дополнительные сигналы данных, которые позволяют оптимизировать эффективность кампании.
Другие действия по конверсии
Хотя отслеживание только действий, приводящих к покупке, является обязательным, отслеживание дополнительных действий, приводящих к конверсии, может предоставить вашим продавцам дополнительную информацию. Мы рекомендуем регистрировать все возможные действия, одновременно внедряя как можно больше основных действий, приводящих к конверсии. Полный список рекомендуемых действий, приводящих к конверсии, описан в разделе руководства по техническому API.
В целом рекомендуется фиксировать следующее:
- Любое событие, приведшее к успеху и напрямую связанное с ценностью.
- События успеха, способствующие основным конверсиям, таким как добавление в корзину и регистрация.
- Анализ взаимодействия пользователей помогает рекламодателям понять, как они взаимодействуют со своими конечными пользователями.
Вторичные действия по конверсии предназначены только для наблюдения и отчетности и влияют на процесс торгов. Узнайте больше о первичных и вторичных действиях по конверсии.
Руководство по UX
Чтобы свести к минимуму риск ошибок, мы рекомендуем внедрять отслеживание конверсий программным способом без участия продавца, но при этом необходимо убедиться, что ваши продавцы знают о настройке отслеживания конверсий.
Когда продавцы привязывают существующий аккаунт Ads, мы рекомендуем показывать уведомление о том, что в их аккаунте, возможно, уже настроено отслеживание конверсий, поскольку могут возникнуть конфликты, которые необходимо разрешить. Пример показан ниже.
Технические рекомендации
Вот как работает отслеживание конверсий. В этом разделе более подробно описан каждый шаг:
В рекламном аккаунте вашего продавца вы создаете действие «ConversionAction» , чтобы отслеживать покупки (и, при необходимости, другие действия клиентов), совершенные на его веб-сайте.
Вы добавляете тег или фрагмент кода для этого действия конверсии на веб-сайт или в мобильное приложение. Подробнее см. раздел «Настройка отслеживания конверсий для вашего веб-сайта» .
Когда пользователь кликает на объявление, на его компьютере или мобильном устройстве размещается временный cookie-файл.
Когда клиент выполняет действие, определенное для рекламодателя, Google распознает cookie-файл (с помощью добавленного фрагмента кода) и регистрирует конверсию вместе с другими параметрами, такими как «значение», если это необходимо.
Предварительные требования
Прежде чем начать, убедитесь, что у вас есть идентификатор разработчика Google Tag. Если у вас его нет, заполните форму запроса идентификатора разработчика Google Tag . Ваш идентификатор разработчика отличается от других идентификаторов, таких как идентификатор измерения или идентификатор конверсии, которые конечные пользователи добавляют в код измерения на своих веб-сайтах.
Создание и настройка действий по конверсии
В следующих примерах показано, как создать действие конверсии и добавить его в рекламный аккаунт. Каждый пример автоматически выполняет все задачи фоновой аутентификации и пошагово объясняет процесс создания действия конверсии:
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.v23.enums.ConversionActionCategoryEnum.ConversionActionCategory; import com.google.ads.googleads.v23.enums.ConversionActionStatusEnum.ConversionActionStatus; import com.google.ads.googleads.v23.enums.ConversionActionTypeEnum.ConversionActionType; import com.google.ads.googleads.v23.errors.GoogleAdsError; import com.google.ads.googleads.v23.errors.GoogleAdsException; import com.google.ads.googleads.v23.resources.ConversionAction; import com.google.ads.googleads.v23.resources.ConversionAction.ValueSettings; import com.google.ads.googleads.v23.services.ConversionActionOperation; import com.google.ads.googleads.v23.services.ConversionActionServiceClient; import com.google.ads.googleads.v23.services.MutateConversionActionResult; import com.google.ads.googleads.v23.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.V23.Errors; using Google.Ads.GoogleAds.V23.Resources; using Google.Ads.GoogleAds.V23.Services; using System; using static Google.Ads.GoogleAds.V23.Enums.ConversionActionCategoryEnum.Types; using static Google.Ads.GoogleAds.V23.Enums.ConversionActionStatusEnum.Types; using static Google.Ads.GoogleAds.V23.Enums.ConversionActionTypeEnum.Types; namespace Google.Ads.GoogleAds.Examples.V23 { /// <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.V23.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\V23\GoogleAdsClient; use Google\Ads\GoogleAds\Lib\V23\GoogleAdsClientBuilder; use Google\Ads\GoogleAds\Lib\V23\GoogleAdsException; use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder; use Google\Ads\GoogleAds\V23\Enums\ConversionActionCategoryEnum\ConversionActionCategory; use Google\Ads\GoogleAds\V23\Enums\ConversionActionStatusEnum\ConversionActionStatus; use Google\Ads\GoogleAds\V23\Enums\ConversionActionTypeEnum\ConversionActionType; use Google\Ads\GoogleAds\V23\Errors\GoogleAdsError; use Google\Ads\GoogleAds\V23\Resources\ConversionAction; use Google\Ads\GoogleAds\V23\Resources\ConversionAction\ValueSettings; use Google\Ads\GoogleAds\V23\Services\ConversionActionOperation; use Google\Ads\GoogleAds\V23\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) ->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 from google.ads.googleads.v23.resources.types.conversion_action import ( ConversionAction, ) from google.ads.googleads.v23.services.services.conversion_action_service import ( ConversionActionServiceClient, ) from google.ads.googleads.v23.services.types.conversion_action_service import ( ConversionActionOperation, MutateConversionActionsResponse, ) def main(client: GoogleAdsClient, customer_id: str) -> None: conversion_action_service: ConversionActionServiceClient = ( client.get_service("ConversionActionService") ) # Create the operation. conversion_action_operation: ConversionActionOperation = client.get_type( "ConversionActionOperation" ) # Create conversion action. conversion_action: ConversionAction = 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: ConversionAction.ValueSettings = ( conversion_action.value_settings ) value_settings.default_value = 15.0 value_settings.always_use_default_value = True # Add the conversion action. conversion_action_response: MutateConversionActionsResponse = ( 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 = 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: argparse.Namespace = parser.parse_args() # GoogleAdsClient will read the google-ads.yaml configuration file in the # home directory if none is specified. googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage( version="v23" ) 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' require_relative '../shared/error_handler.rb' 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 GoogleAdsErrorHandler.handle_google_ads_error(e) raise # Re-raise the error to maintain original script behavior. 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::V23::Resources::ConversionAction; use Google::Ads::GoogleAds::V23::Resources::ValueSettings; use Google::Ads::GoogleAds::V23::Enums::ConversionActionCategoryEnum qw(DEFAULT); use Google::Ads::GoogleAds::V23::Enums::ConversionActionTypeEnum qw(WEBPAGE); use Google::Ads::GoogleAds::V23::Enums::ConversionActionStatusEnum qw(ENABLED); use Google::Ads::GoogleAds::V23::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::V23::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V23::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V23::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 в Performance Max. Каждое из ваших действий по конверсии должно быть настроено следующим образом:
Тип — установите ConversionActionType как WEBPAGE, поскольку эти события покупки происходят на веб-сайте.
Для оптимизации кампаний под основное действие конверсии (покупка) установите значение «iddable» на
true. Для второстепенных действий конверсии (например, добавление в корзину) установите значениеfalse.Категория — Для каждого из ваших действий конверсии (основного или дополнительного) установите категорию действия конверсии (ConversionActionCategory ). Ниже вы найдете соответствующую категорию действия конверсии для каждого из 7 действий конверсии, которые мы рекомендуем реализовать. Обратите внимание, что Google Ads автоматически назначает действия конверсии стандартной цели конверсии на основе их категории. Например, действия конверсии покупки назначаются стандартной цели конверсии под названием «Покупки». Позже вы можете настроить кампанию Performance Max для оптимизации под эту цель «Покупки».
Ниже вы найдете список рекомендуемых действий по конверсии. Мы рекомендуем реализовать как минимум первые четыре действия по конверсии, а также как можно больше остальных рекомендуемых действий.
Вы также можете рассмотреть возможность внедрения дополнительных событий, имеющих отношение к онлайн-продажам . Для еще более детального отслеживания вы можете создать дополнительные действия конверсии или настраиваемые действия конверсии (например, действие «добавить платежную информацию» каждый раз, когда пользователь использует функцию поиска на веб-сайте, или действие «поиск» каждый раз, когда пользователь использует функцию поиска на веб-сайте). Вторичные действия конверсии обеспечивают дополнительное отслеживание для ваших продавцов и используются Google Ads для анализа.
| Приоритет | Действие конверсии | Категория действий по конверсии | Название события Google Tag | Описание |
|---|---|---|---|---|
| Обязательный | Покупка | ПОКУПКА | покупка | Пользователь совершает покупку |
| Настоятельно рекомендуется всем, кто занимается созданием магазинов. | Добавить в корзину | ДОБАВИТЬ В КОРЗИНУ | добавить в корзину | Пользователь добавляет товар в корзину |
| Настоятельно рекомендуется всем, кто занимается созданием магазинов. | Начать оформление заказа | НАЧАЛО_ОФОРМЛЕНИЯ | начало_выбора | Пользователь начинает процесс оформления заказа. |
| Настоятельно рекомендуется всем, кто занимается созданием магазинов. | Просмотреть товар | PAGE_VIEW | page_view | Пользователь открывает страницу товара |
| Настоятельно рекомендуется, если это применимо (обычно не применимо к компаниям, занимающимся созданием интернет-магазинов). | Зарегистрироваться | ЗАРЕГИСТРИРОВАТЬСЯ | зарегистрироваться | Пользователь регистрирует учетную запись. |
| Настоятельно рекомендуется, если это применимо (обычно не применимо к компаниям, занимающимся созданием интернет-магазинов). | Генерация лидов | ОТПРАВИТЬ_ФОРМУ_ЛИДА | generate_lead | Пользователь генерирует лид через форму. |
| Настоятельно рекомендуется, если это применимо (обычно не применимо к компаниям, занимающимся созданием интернет-магазинов). | Подписаться | ПОДПИСАТЬСЯ_ОПЛАЧЕНО | неприменимо (по индивидуальному заказу) | Пользователь подписывается на платную услугу |
| Настоятельно рекомендуется, если это применимо (обычно не применимо к компаниям, занимающимся созданием интернет-магазинов). | Записаться на прием | ЗАПИСАТЬСЯ НА ПРИЕМ | неприменимо (по индивидуальному заказу) | Пользователь записывается на прием |
| Настоятельно рекомендуется, если это применимо (обычно не применимо к компаниям, занимающимся созданием интернет-магазинов). | Запросить ценовое предложение | ЗАПРОСИТЬ ЦИТАТУ | неприменимо (по индивидуальному заказу) | Пользователь отправляет форму с запросом на оценку стоимости. |
Продавцы, имеющие существующий рекламный аккаунт
Если вы разрешаете продавцам подключаться к рекламной платформе с помощью существующего аккаунта Ads , вы можете столкнуться с ситуацией, когда в аккаунте уже настроены действия конверсии. Мы не рекомендуем использовать уже существующие действия конверсии, поскольку нет гарантии, что они правильно настроены. Кроме того, для обработки этих потенциальных сценариев необходимо предпринять дополнительные шаги:
В аккаунте есть несколько целей (например, покупки + просмотры страниц + контакты), которые помечены как "цели по умолчанию". При создании новой кампании она по умолчанию оптимизируется по всем этим целям. Вам это не нужно для кампании Performance Max.
В аккаунте уже есть одно (или несколько) действий конверсии для отслеживания покупок, и они уже сгруппированы в рамках цели «Покупки». Это означает, что после запуска кампании покупка будет учтена дважды, поскольку срабатывают два тега конверсии.
Чтобы гарантировать, что кампания Performance Max будет использовать ваше пользовательское действие конверсии и только это действие:
Создайте объект CustomConversionGoal и добавьте действие конверсии «Покупка» в список
conversion_actions[]. Установите статус на ENABLED .В файле ConversionGoalCampaignConfig кампании Performance Max установите
custom_conversion_goalравным пользовательской цели, которую вы создали на шаге (1).В результате шага (2) Google Ads должен был автоматически обновить ConversionGoalCampaignConfig кампании таким образом, чтобы
goal_config_levelбыл установлен на CAMPAIGN (вместо CUSTOMER , что привело бы к использованию целей по умолчанию для аккаунта), но стоит перепроверить, действительно ли это произошло.
Получите тег для действия конверсии.
После создания действия конверсии необходимо вставить соответствующий фрагмент кода, называемый тегом, на страницу конверсии на веб-сайте рекламодателя. Чтобы гарантировать, что Google Ads сможет измерять все конверсии независимо от браузера клиента, используйте обновленный тег отслеживания конверсий Google Ads . Этот тег состоит из двух частей:
Параметр
global_site_tagнеобходимо установить на каждой странице веб-сайта рекламодателя.event_snippet) следует размещать на веб-страницах, указывающих на действие, приводящее к конверсии, например, на страницу подтверждения заказа или страницу отправки лида.
Эти две части можно получить с помощью ConversionActionService .
Этот тег устанавливает файлы cookie, которые хранят уникальный идентификатор клиента или клика по объявлению, который привёл клиента на сайт. Файлы cookie получают информацию о клике по объявлению из параметра Google Click Identifier ( GCLID ), включённого в тег отслеживания конверсий. Необходимо включить веб-сайт рекламодателя и систему отслеживания лидов для сбора и хранения GCLID, уникального идентификатора, который Google Ads предоставляет для каждого показа объявления Google.
Подробнее о глобальном теге и месте его установки.
Тег Google (gtag.js) — это фреймворк для тегирования и API, позволяющий отправлять данные о событиях как в Google Ads, так и в Google Analytics. Глобальный тег сайта работает в сочетании с фрагментом события или фрагментом текста для телефона, отслеживая ваши конверсии. Добавьте тег Google в раздел <head> каждой страницы сайта рекламодателя и настройте его для работы с Google Ads. Затем вы можете использовать команды gtag() для сбора событий и отправки данных в Google Ads. Чтобы понять, как это работает, см. раздел «Использование глобального тега сайта для отслеживания конверсий в Google Ads» .
Следующие команды используются с тегом Google:
config: Инициализируйте продукт Google (Google Ads, Analytics и т. д.), настройте параметры и подготовьтесь к отправке данных в аккаунт.
Событие: Зарегистрируйте конверсию, отправив событие, например, «покупка» (рекомендуется) или «добавление в корзину» ( вторичные действия конверсии ). Рекомендуем ознакомиться с руководством по событиям gtag.js.
set: Задайте параметры, общие для всех событий на странице, например, валюту.
В следующем примере представлен фрагмент кода JavaScript глобального тега сайта для отправки данных в Google Ads. Значение-заполнитель 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 Ads и вашей учетной записи разработчика Google Tag, а 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 согласия (также известный как режим согласия).
Встроенный API Google Tag Manager позволяет управлять согласием пользователей на использование файлов cookie. Он способен различать согласие пользователей на использование файлов cookie в рекламных целях и в аналитических целях.
Ожидаемый результат заключается в том, что клиенты получают как минимум интегрированный вызов gtag('consent', 'update' {...}) без каких-либо действий с их стороны. Это должно гарантировать, что теги Google (Google Ads, Floodlight, Google Analytics, Conversion Linker) смогут считывать последнее состояние согласия пользователя и включать это состояние в сетевые запросы к Google (через параметр &gcs).
Дополнительные шаги по реализации включают развертывание или оказание помощи рекламодателям в развертывании (например, через пользовательский интерфейс) состояния gtag('consent', default' {...}) и разблокировку тегов Google (например, без условного запуска на основе согласия), чтобы включить режим согласия, который запускает их с учетом согласия пользователя.
Подробную информацию о реализации см. в разделе «Управление настройками согласия (веб)» .
Советы
В аккаунте Google Ads Manager вы можете отслеживать конверсии во всех своих рекламодателях, используя единый тег кода конверсии. Подробнее об отслеживании конверсий между аккаунтами .
Лучший способ проверить работоспособность вашей системы отслеживания конверсий — это перейти на сайт одного из ваших продавцов (или на внутренний тестовый сайт) и совершить реальную покупку. Затем вы можете посмотреть результаты в инструменте Google Tag Assistant и воспользоваться этим руководством по устранению неполадок , чтобы убедиться, что Google Ads обнаружил ваш тег и успешно регистрирует конверсии. Для получения дополнительной информации по устранению неполадок посетите раздел «Устранение неполадок с отслеживанием конверсий на всем сайте» .
Вы можете дополнить предыдущий тег конверсии расширенными конверсиями, что повысит точность измерения конверсий и позволит использовать более эффективные стратегии назначения ставок. Узнайте больше о настройке расширенных конверсий . Перед внедрением расширенных конверсий убедитесь, что ваши продавцы соответствуют политике обработки данных клиентов в Google Ads.