Bạn phải bật tính năng theo dõi lượt chuyển đổi trong tài khoản chuyển đổi Google Ads để ghi lại lượt chuyển đổi. Hướng dẫn này cung cấp thông tin chi tiết về cách xác nhận xem tính năng theo dõi lượt chuyển đổi đã được bật hay chưa, bật tính năng này nếu chưa được bật và truy xuất thông tin về các hành động chuyển đổi hiện có.
Hầu hết các hành động chuyển đổi cũng yêu cầu bạn thực hiện thêm các bước để theo dõi. Để biết thêm thông tin về các loại hành động chuyển đổi và yêu cầu của từng loại, hãy xem hướng dẫn Tạo hành động chuyển đổi.
Chuẩn bị cung cấp sự đồng ý
Điều quan trọng là bạn phải xác nhận rằng bạn có quyền chia sẻ dữ liệu lượt chuyển đổi với Google. Bạn có thể thực hiện việc này bằng một trong hai cách:
- Định cấu hình chế độ cài đặt sự đồng ý mặc định ở cấp tài khoản. Trong giao diện người dùng Google Ads, hãy nhấp vào Công cụ -> Trình quản lý dữ liệu -> Chế độ cài đặt sự đồng ý -> Chế độ cài đặt sự đồng ý mặc định.
- Đặt trường ClickConversion.consent trên mỗi lượt chuyển đổi đã nhập.
Thiết lập trang web để theo dõi lượt chuyển đổi
Nếu bạn đang bắt đầu tích hợp tính năng nhập lượt chuyển đổi ngoại tuyến, thì bước đầu tiên là làm theo các bước trong hướng dẫn Định cấu hình thẻ Google cho tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng để định cấu hình trang web nhằm theo dõi lượt chuyển đổi nâng cao cho khách hàng tiềm năng. Bạn cũng có thể sử dụng Trình quản lý thẻ của Google để định cấu hình trang web bằng cách làm theo các bước trong hướng dẫn Định cấu hình Trình quản lý thẻ của Google cho tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng.
Bật tính năng theo dõi lượt chuyển đổi trong tài khoản chuyển đổi Google Ads
Truy xuất thông tin về chế độ theo dõi lượt chuyển đổi
Bạn có thể kiểm tra chế độ theo dõi lượt chuyển đổi của tài khoản và xác nhận rằng tính năng theo dõi lượt chuyển đổi đã được bật bằng cách truy vấn tài nguyên Customer cho ConversionTrackingSetting.
Đưa ra truy vấn sau bằng
GoogleAdsService.SearchStream:
SELECT
customer.conversion_tracking_setting.google_ads_conversion_customer,
customer.conversion_tracking_setting.conversion_tracking_status,
customer.conversion_tracking_setting.conversion_tracking_id,
customer.conversion_tracking_setting.cross_account_conversion_tracking_id
FROM customer
Trường google_ads_conversion_customer cho biết tài khoản Google Ads tạo và quản lý lượt chuyển đổi cho khách hàng này. Đối với những khách hàng sử dụng
tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản,
đây là mã của tài khoản người quản lý. Bạn nên cung cấp mã khách hàng chuyển đổi Google Ads dưới dạng customer_id trong các yêu cầu của Google Ads API để tạo và quản lý lượt chuyển đổi.
Xin lưu ý rằng trường này được điền sẵn ngay cả khi tính năng theo dõi lượt chuyển đổi chưa được bật.
Trường
conversion_tracking_status
cho biết liệu tính năng theo dõi lượt chuyển đổi đã được bật hay chưa và liệu tài khoản
có đang sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản hay không.
Tạo hành động chuyển đổi trong tài khoản chuyển đổi Google Ads
Nếu giá trị conversion_tracking_status là NOT_CONVERSION_TRACKED, thì tính năng theo dõi lượt chuyển đổi chưa được bật cho tài khoản. Bật tính năng theo dõi lượt chuyển đổi
bằng cách tạo ít nhất một ConversionAction trong
tài khoản chuyển đổi Google Ads, như trong ví dụ sau. Ngoài ra, bạn
có thể tạo hành động chuyển đổi trong giao diện người dùng bằng cách làm theo hướng dẫn trong
Trung tâm trợ giúp cho
loại lượt chuyển đổi mà bạn muốn bật.
Xin lưu ý rằng tính năng lượt chuyển đổi nâng cao sẽ tự động được bật khi được gửi thông qua Google Ads API, nhưng bạn có thể tắt tính năng này thông qua giao diện người dùng Google Ads.
Ví dụ về mã
Java
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#
public void Run(GoogleAdsClient client, long customerId) { // Get the ConversionActionService. ConversionActionServiceClient conversionActionService = client.GetService(Services.V24.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
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 ); } }
Python
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}".' )
Ruby
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
Perl
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::V24::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V24::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V24::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; }
curl
Đảm bảo bạn đặt conversion_action_type thành giá trị
ConversionActionType chính xác.
Để biết thêm hướng dẫn về cách tạo hành động chuyển đổi trong Google Ads API, hãy xem bài viết Tạo hành động chuyển đổi.
Truy xuất hành động chuyển đổi hiện có
Bạn có thể truy xuất thông tin chi tiết cho một hành động chuyển đổi hiện có bằng cách đưa ra truy vấn sau. Đảm bảo bạn đặt mã khách hàng trong yêu cầu thành khách hàng chuyển đổi Google Ads
mà bạn đã xác định ở trên và đặt loại hành động chuyển đổi thành
giá trị
ConversionActionType
chính xác.
SELECT
conversion_action.resource_name,
conversion_action.name,
conversion_action.status
FROM conversion_action
WHERE conversion_action.type = 'INSERT_CONVERSION_ACTION_TYPE'
Theo dõi lượt chuyển đổi trên nhiều tài khoản
Nếu bạn đang sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì
ConversionActionService sẽ trả về các hành động chuyển đổi sau:
- Tất cả hành động chuyển đổi do tài khoản người quản lý xác định mà tài khoản sử dụng để theo dõi lượt chuyển đổi trên nhiều tài khoản
- Tất cả hành động chuyển đổi mà khách hàng đã tích luỹ số liệu thống kê, bao gồm cả các hành động do hệ thống xác định và các hành động do người quản lý sở hữu, ngay cả khi người quản lý đó huỷ liên kết sau đó
- Tất cả hành động mà khách hàng đã xác định trong tài khoản của riêng họ
- Lượt chuyển đổi Analytics được tạo trong các thuộc tính Google Analytics được liên kết.
Điều này bao gồm cả các hành động cho lượt chuyển đổi Analytics không được nhập vào Google Ads,
có trạng thái là
HIDDEN.
Bạn có thể sử dụng Google Ads API để chọn theo dõi lượt chuyển đổi trên nhiều tài khoản khi tạo tài khoản khách hàng.
Khi tạo Customer mới, hãy đặt
conversion_tracking_setting.google_ads_conversion_customer
thành
tên tài nguyên của tài khoản người quản lý sẽ quản lý các hành động chuyển đổi thay mặt cho tài khoản khách hàng.
Tài khoản người quản lý này cũng phải là tài khoản đưa ra yêu cầu create cho tài khoản khách hàng mới.
Kể từ v20, bạn có thể sử dụng
Google Ads API để chọn theo dõi lượt chuyển đổi trên nhiều tài khoản khi tạo và cập nhật
tài khoản khách hàng.
Khi cập nhật tài khoản khách hàng hiện có, bạn có thể chọn theo dõi lượt chuyển đổi trên nhiều tài khoản
bằng cách đặt trường
conversion_tracking_setting.google_ads_conversion_customer. Bạn nên đặt trường này thành
tên tài nguyên của tài khoản người quản lý
sẽ quản lý các hành động chuyển đổi thay mặt cho tài khoản khách hàng.
Tài khoản người quản lý này cũng phải là tài khoản đưa ra yêu cầu update cho tài khoản khách hàng.
LƯU Ý: Việc sử dụng Google Ads API để sửa đổi chế độ cài đặt theo dõi lượt chuyển đổi trên nhiều tài khoản của tài khoản khách hàng là một tính năng chỉ dành cho danh sách cho phép. Để sử dụng tính năng này, hãy liên hệ với người quản lý tài khoản của bạn.
Khi bạn chọn theo dõi lượt chuyển đổi trên nhiều tài khoản hoặc chuyển đổi trình quản lý theo dõi lượt chuyển đổi cho một tài khoản khách hàng hiện có, thì các lưu ý tương tự sẽ áp dụng như khi bạn thực hiện thay đổi này trong giao diện người dùng. Cụ thể:
- Tài khoản khách hàng sẽ áp dụng các quy tắc mặc định về giá trị lượt chuyển đổi và mục tiêu vòng đời của khách hàng mặc định của trình quản lý theo dõi lượt chuyển đổi mới.
- Những chiến dịch nhắm đến một hành động chuyển đổi cụ thể sẽ chuyển sang sử dụng mục tiêu lượt chuyển đổi mặc định của tài khoản trình quản lý lượt chuyển đổi. Nếu bạn tiếp tục nhắm đến một hành động chuyển đổi cụ thể, thì điều đó có thể dẫn đến hành vi không nhất quán, vì tài khoản người quản lý có thể không có cùng mục tiêu với tài khoản khách hàng. Đảm bảo rằng các chiến dịch của bạn được tối ưu hoá cho đúng mục tiêu.
- Nếu một tài khoản thuộc về nhiều tài khoản người quản lý thì tài khoản đó chỉ có thể sử dụng hành động chuyển đổi từ một tài khoản người quản lý. Nếu không có tài khoản theo dõi lượt chuyển đổi nào được chỉ định, thì tài khoản đó sẽ tự sử dụng làm tài khoản theo dõi lượt chuyển đổi theo mặc định.
Tạo hành động chuyển đổi
Để đo lường lượt chuyển đổi, hãy thiết lập a
ConversionAction cho the
type of
hành động chuyển đổi mà bạn muốn theo dõi. Ví dụ: giao dịch mua hàng trực tuyến và cuộc gọi điện thoại yêu cầu các hành động chuyển đổi khác nhau.
Cách tốt nhất để thiết lập hành động chuyển đổi mới trong API là sử dụng ví dụ về mã
Thêm hành động chuyển đổi bên dưới. Mẫu này xử lý
tất cả các tác vụ xác thực nền cho bạn và hướng dẫn bạn cách tạo
một ConversionAction.
Hầu hết các hành động chuyển đổi cũng yêu cầu bạn thực hiện thêm các bước để theo dõi. Ví dụ: để theo dõi lượt chuyển đổi trên trang web, bạn phải thêm một đoạn mã có tên là thẻ vào trang chuyển đổi trên trang web. Để biết các yêu cầu chi tiết của các loại hành động chuyển đổi khác, hãy xem bài viết trên Trung tâm trợ giúp của chúng tôi.
Ví dụ về mã
Ví dụ về mã sau đây hướng dẫn bạn quy trình tạo hành động chuyển đổi mới. Cụ thể, mã này tạo một hành động chuyển đổi với
type được đặt thành
UPLOAD_CLICKS.
Mã này cũng đặt category
thành DEFAULT.
Các chế độ cài đặt mặc định sau đây sẽ áp dụng:
Google Ads API tự động đặt trường
primary_for_goal, nhưng bạn có thể đặt trường này một cách rõ ràng để kiểm soát cách hành động chuyển đổi tác động đến việc báo cáo và đặt giá thầu trong tài khoản khi kết hợp với mục tiêu lượt chuyển đổi.Google Ads API tự động đặt
counting_typethànhMANY_PER_CLICKHãy xem Giới thiệu về các tuỳ chọn tính lượt chuyển đổi để biết thêm thông tin chi tiết.Google Ads API đặt mô hình phân bổ thành Dựa trên dữ liệu bằng cách đặt trường
attribution_model_settingsthành giá trịGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVENcủaAttributionModel. Hãy xem bài viết này trên Trung tâm trợ giúp để tìm hiểu thêm về các mô hình phân bổ.
Java
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#
public void Run(GoogleAdsClient client, long customerId) { // Get the ConversionActionService. ConversionActionServiceClient conversionActionService = client.GetService(Services.V24.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
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 ); } }
Python
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}".' )
Ruby
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
Perl
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::V24::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V24::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V24::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; }
curl
Bạn có thể xem ví dụ này trong thư mục Tiếp thị lại của thư viện ứng dụng và trong bộ sưu tập ví dụ về mã: Ví dụ về mã Thêm hành động chuyển đổi example.
Xác nhận kết quả
Google Ads và Google Ads API hỗ trợ nhiều hành động chuyển đổi, vì vậy, một số
quy tắc xác thực sẽ khác nhau dựa trên type
của hành động.
Lỗi phổ biến nhất khi tạo hành động chuyển đổi là
DUPLICATE_NAME.
Đảm bảo bạn đang sử dụng một tên duy nhất cho mỗi hành động chuyển đổi.
Dưới đây là một số mẹo về cách đặt các trường ConversionAction:
- Tất cả các trường enum
- Việc cố gắng đặt bất kỳ trường enum nào thành
UNKNOWNsẽ dẫn đến lỗiRequestError.INVALID_ENUM_VALUE. app_id- Thuộc tính
app_idlà bất biến và chỉ có thể được đặt khi tạo lượt chuyển đổi đối với ứng dụng mới. attribution_model_settings- Việc đặt thuộc tính này thành một lựa chọn không dùng nữa
sẽ dẫn đến lỗi
CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Google Ads chỉ hỗ trợGOOGLE_ADS_LAST_CLICKvàGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. click_through_lookback_window_daysViệc đặt thuộc tính này thành một giá trị nằm ngoài phạm vi cho phép sẽ dẫn đến lỗi
RangeError.TOO_LOWhoặcRangeError.TOO_HIGH.Thuộc tính này phải nằm trong phạm vi
[1,60]đối với hành động chuyển đổiAD_CALLhoặcWEBSITE_CALL. Đối với hầu hết các hành động chuyển đổi khác, phạm vi cho phép là[1,30].include_in_conversions_metricViệc đặt giá trị này trong thao tác
createhoặcupdatesẽ không thành công và gây ra lỗiFieldError.IMMUTABLE_FIELD. Thay vào đó, hãy đặtprimary_for_goalnhư mô tả trong hướng dẫn Mục tiêu lượt chuyển đổi.phone_call_duration_secondsViệc cố gắng đặt thuộc tính này trên một hành động chuyển đổi không dành cho cuộc gọi sẽ dẫn đến lỗi
FieldError.VALUE_MUST_BE_UNSET.typeThuộc tính
typelà bất biến và chỉ có thể được đặt khi tạo lượt chuyển đổi mới.Việc cập nhật hành động chuyển đổi có
typebằngUNKNOWNsẽ dẫn đến lỗiMutateError.MUTATE_NOT_ALLOWEDvalue_settingsvalue_settingscho hành động chuyển đổiWEBSITE_CALLhoặcAD_CALLphải đặtalways_use_default_valuethànhtrue. Việc chỉ định giá trịfalsekhi tạo hoặc cập nhật giá trị này sẽ dẫn đến lỗiINVALID_VALUE.view_through_lookback_window_daysViệc đặt thuộc tính này thành một giá trị nằm ngoài phạm vi cho phép sẽ dẫn đến lỗi
RangeError.TOO_LOWhoặcRangeError.TOO_HIGH. Đối với hầu hết các hành động chuyển đổi, phạm vi cho phép là[1,30].Bạn không thể đặt thuộc tính này trên các hành động chuyển đổi
AD_CALLhoặcWEBSITE_CALL. Việc chỉ định một giá trị sẽ dẫn đến lỗiVALUE_MUST_BE_UNSET.