Hướng dẫn này cung cấp danh sách các loại hành động chuyển đổi mà bạn có thể tạo bằng API Google Ads, thông tin về cách các hành động này liên kết với giao diện web Google Ads và ví dụ về mã chi tiết minh hoạ cách tạo hành động chuyển đổi mới.
Để đo lường lượt chuyển đổi, hãy thiết lập
ConversionAction
cho
type
của
hành động chuyển đổi mà bạn muốn theo dõi. Ví dụ: lượt 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à dùng ví dụ về Thêm mã Hành động chuyển đổi bên dưới. Mẫu này sẽ xử lý mọi tác vụ xác thực nền cho bạn cũng như 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 một số bước để theo dõi chúng. 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 của mình. Để biết các yêu cầu khác về hành động chuyển đổi, hãy xem bài viết trên Trung tâm trợ giúp của chúng tôi.
Chuyển đổi trang web
Lượt chuyển đổi trên trang web cho phép bạn theo dõi các hành động trên trang web như lượt bán hàng trực tuyến, lượt nhấp vào đường liên kết, lượt xem trang và lượt đăng ký.
Để theo dõi lượt chuyển đổi trên trang web, bạn phải tạo một ConversionAction
với ConversionActionType
được đặt thành WEBPAGE
và thêm một đoạn mã có tên là thẻ vào trang chuyển đổi trên trang web của mình.
ConversionAction
bao gồm một số loại chuyển đổi trên trang web, được phân biệt trong API bằng trường type
trong mỗi TagSnippet
được liệt kê trong trường tag_snippets của ConversionAction
.
TagSnippet
cung cấp mã theo dõi phải có trong trang web của bạn để theo dõi hành động chuyển đổi.
Lượt chuyển đổi Trang web và Lượt nhấp vào số điện thoại yêu cầu
event_snippet
,
nên được đặt trên các trang web cho biết hành động chuyển đổi, chẳng hạn như
xác nhận thanh toán hoặc gửi biểu mẫu khách hàng tiềm năng và
global_site_tag
,
phải được cài đặt trên mọi trang của trang web. Bạn có thể truy xuất cả hai thuộc tính này bằng ConversionActionService
. Hãy truy cập vào Trung tâm trợ giúp của chúng tôi để biết thêm thông tin về cách gắn thẻ các trang.
Bảng sau đây trình bày các tham số API tương đương để sử dụng cho từng Nguồn trong giao diện web của Google Ads:
Loại mã theo dõi | Nguồn Google Ads |
---|---|
WEBPAGE |
Trang web (Google Analytics (GA4)) |
WEBPAGE_ONCLICK |
Trang web (Google Analytics (GA4)) |
CLICK_TO_CALL |
Nhấp chuột vào số điện thoại |
--- |
Trang web (Google Analytics (UA)) |
Lượt chuyển đổi đối với ứng dụng
Lượt chuyển đổi ứng dụng cho phép bạn theo dõi lượt cài đặt ứng dụng di động hoặc lượt mua hàng trong ứng dụng từ Cửa hàng Google Play.
Bảng sau đây trình bày các tham số API
ConversionActionType
tương đương để sử dụng cho từng Nguồn trong giao diện web của Google Ads:
Loại hành động chuyển đổi | Nguồn Google Ads |
---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > Lượt cài đặt |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > Giao dịch mua hàng trong ứng dụng |
Nếu bạn đang muốn theo dõi các hành động khác trong ứng dụng dành cho thiết bị di động bằng cách sử dụng thuộc tính Google Analytics 4 hoặc dữ liệu phân tích ứng dụng bên thứ ba. Xem Các loại hành động chuyển đổi khác.
Chuyển đổi cuộc gọi điện thoại
Tính năng theo dõi lượt chuyển đổi cuộc gọi điện thoại cho phép bạn theo dõi cuộc gọi từ quảng cáo, cuộc gọi đến một số điện thoại trên trang web và lượt nhấp vào số điện thoại trên trang web dành cho thiết bị di động.
Bảng sau đây trình bày các tham số API
ConversionActionType
tương đương để sử dụng cho từng Nguồn trong giao diện web của Google Ads:
Loại hành động chuyển đổi | Nguồn Google Ads |
---|---|
AD_CALL |
Cuộc gọi từ quảng cáo sử dụng phần mở rộng về cuộc gọi hoặc quảng cáo chỉ tạo cuộc gọi điện thoại |
WEBSITE_CALL |
Những cuộc gọi đến một số điện thoại trên trang web của bạn |
CLICK_TO_CALL |
Lần nhấp vào số điện thoại trên trang web dành cho thiết bị di động của bạn |
Loại CLICK_TO_CALL
khác với loại AD_CALL
ở chỗ loại này không theo dõi các cuộc gọi điện thoại thực tế. Thay vào đó, CLICK_TO_CALL
chỉ theo dõi các lượt nhấp vào một số điện thoại trên thiết bị di động. Điều này rất hữu ích khi bạn không thể sử dụng số chuyển tiếp của Google để theo dõi cuộc gọi điện thoại.
AD_CALL
Hành động chuyển đổi
AD_CALL
sẽ xuất hiện dưới dạng lượt chuyển đổi Cuộc gọi từ
quảng cáo trong giao diện web
của Google Ads. Sau khi bạn tạo hành động chuyển đổi AD_CALL
, hãy chỉ định tên tài nguyên trong trường call_conversion_action
khi tạo CallAsset
. Thành phần cuộc gọi cho phép bạn hiển thị số điện thoại ngay trong quảng cáo của mình.
Một cuộc gọi sẽ được báo cáo là lượt chuyển đổi nếu cuộc gọi đó kéo dài hơn thời lượng đã chỉ định. Mặc định là 60 giây.
WEBSITE_CALL
Hành động chuyển đổi
WEBSITE_CALL
sẽ xuất hiện dưới dạng lượt chuyển đổi Cuộc gọi từ
trang web trong
giao diện web của Google Ads.
Không giống như AD_CALL
, trình theo dõi này yêu cầu bạn thêm event_snippet
và global_site_tag
vào trang web của mình để truy xuất số chuyển tiếp động của Google để theo dõi cuộc gọi trên các số điện thoại hiển thị trên trang web của bạn. Ngoài ra, bạn phải thiết lập một thành phần cuộc gọi và liên kết thành phần đó ở cấp khách hàng, chiến dịch hoặc nhóm quảng cáo.
Nhập lượt chuyển đổi ngoại tuyến
Bảng sau đây trình bày các tham số API
ConversionActionType
tương đương cần sử dụng cho từng Nguồn trong giao diện web của Google Ads
và một đường liên kết đến tài liệu cho từng loại hành động chuyển đổi cụ thể:
Loại hành động chuyển đổi | Nguồn Google Ads | Hướng dẫn thiết lập API |
---|---|---|
UPLOAD_CLICKS |
Theo dõi lượt chuyển đổi từ lượt nhấp và lượt chuyển đổi nâng cao cho khách hàng tiềm năng | Hướng dẫn về lượt nhấp tải lên
Hướng dẫn về Lượt chuyển đổi nâng cao cho khách hàng tiềm năng |
UPLOAD_CALLS |
Theo dõi lượt chuyển đổi từ cuộc gọi | Hướng dẫn thiết lập API |
STORE_SALES |
Theo dõi lượt chuyển đổi dẫn đến lượt bán hàng tại cửa hàng thực tế | Hướng dẫn thiết lập API |
Lượt chuyển đổi nâng cao cho web
Tính năng lượt chuyển đổi nâng cao cho
web cho phép bạn gửi
dữ liệu lượt chuyển đổi của bên thứ nhất cho WEBPAGE
hành động chuyển đổi trong vòng 24 giờ kể từ
sự kiện chuyển đổi thay vì cùng một lúc. Nhờ đó, bạn có thể xác định vị trí của dữ liệu của bên thứ nhất từ nhiều nguồn, chẳng hạn như cơ sở dữ liệu khách hàng hoặc hệ thống CRM.
Các loại hành động chuyển đổi khác
API Google Ads cung cấp thêm các loại hành động chuyển đổi khác trong báo cáo, nhưng có thể giới hạn hoặc cấm việc tạo hoặc sửa đổi các hành động đó.
Lượt chuyển đổi SKAdNetwork
Nếu chạy Chiến dịch quảng cáo ứng dụng iOS và đã triển khai SKAdNetwork, bạn có thể truy cập vào dữ liệu SKAdNetwork được cung cấp cho Google ở cấp Customer
và Campaign
bằng cách sử dụng các tài nguyên sau:
Trường báo cáo | Nội dung mô tả |
---|---|
metrics.sk_ad_network_conversions |
Số lượt chuyển đổi do Apple báo cáo. Bạn chỉ có thể phân đoạn
chỉ số này theo bất kỳ tổ hợp nào giữa segments.sk_ad_network_conversion_value và
phân đoạn liên quan đến ngày.
|
segments.sk_ad_network_conversion_value |
Giá trị của một lượt chuyển đổi do Apple báo cáo. Bạn không thể áp dụng phân đoạn này
cho bất kỳ chỉ số nào khác ngoài Giá trị của |
Bạn cũng có thể lưu mối liên kết giá trị lượt chuyển đổi SKAdNetwork cho những khách hàng cụ thể được liên kết với ứng dụng iOS thông qua CustomerSkAdNetworkConversionValueSchema
.
Mã Python mẫu
#!/usr/bin/env python # 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 # # 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. import argparse import sys from google.ads.googleads.client import GoogleAdsClient from google.ads.googleads.errors import GoogleAdsException def main(client, customer_id): """Adds a keyword plan, campaign, ad group, etc. to the customer account. Also handles errors from the API and prints them. Args: client: An initialized instance of GoogleAdsClient customer_id: A str of the customer_id to use in requests. """ res = update_skan_cv_schema( client, customer_id, "my_app_id", "account_link_id" ) print(res) def update_skan_cv_schema(client, customer_id, app_id, account_link_id): skan_service = client.get_service( "CustomerSkAdNetworkConversionValueSchemaService" ) req = client.get_type( "MutateCustomerSkAdNetworkConversionValueSchemaRequest" ) operation = client.get_type( "CustomerSkAdNetworkConversionValueSchemaOperation" ) schema_instance = client.get_type( "CustomerSkAdNetworkConversionValueSchema" ) new_schema = operation.update new_schema.resource_name = ( skan_service.customer_sk_ad_network_conversion_value_schema_path( "customer_id", "account_link_id" ) ) new_schema.schema.app_id = app_id new_schema.schema.measurement_window_hours = 48 skan_cv_mapping = ( schema_instance.SkAdNetworkConversionValueSchema.FineGrainedConversionValueMappings() ) skan_cv_mapping.fine_grained_conversion_value = 0 # 0 - 63 skan_cv_mapping.conversion_value_mapping.min_time_post_install_hours = 0 skan_cv_mapping.conversion_value_mapping.max_time_post_install_hours = 48 skan_cv_event = schema_instance.SkAdNetworkConversionValueSchema.Event() skan_cv_event.mapped_event_name = "TEST" skan_cv_event.event_revenue_value = 10 skan_cv_mapping.conversion_value_mapping.mapped_events.append(skan_cv_event) new_schema.schema.fine_grained_conversion_value_mappings.append( skan_cv_mapping ) req.operation = operation req.customer_id = customer_id res = skan_service.mutate_customer_sk_ad_network_conversion_value_schema( req ) return res if __name__ == "__main__": # GoogleAdsClient will read the google-ads.yaml configuration file in the # home directory if none is specified. googleads_client = GoogleAdsClient.load_from_storage( version="v16" ) parser = argparse.ArgumentParser( description="Creates a keyword plan 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() 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)
Google Analytics
Lượt chuyển đổi từ một tài sản Google Analytics được liên kết có một trong các giá trị type
sau:
Lượt chuyển đổi tài sản GA4:
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
Bạn cũng có thể truy xuất mã tài sản GA4, tên tài sản và tên sự kiện từ trường
google_analytics_4_settings
.Lượt chuyển đổi tài sản Universal Analytics:
UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
Bạn có thể thực hiện các thay đổi sau đối với lượt chuyển đổi của tài sản GA4:
- Nhập lượt chuyển đổi từ tài sản GA4 vào tài khoản Google Ads bằng cách
sửa đổi trường
status
từHIDDEN
thànhENABLED
. - Sửa đổi các trường
primary_for_goal
vàcategory
để cho biết mức độ ảnh hưởng của thay đổi này đến việc đặt giá thầu và báo cáo của Google Ads. - Cập nhật
name
hoặcvalue_settings
. - Xoá lượt chuyển đổi khỏi tài khoản Google Ads bằng thao tác
remove
.
Mọi hành vi sửa đổi các thuộc tính khác của một lượt chuyển đổi GA4 đã nhập hoặc bất kỳ thuộc tính nào của một lượt chuyển đổi Universal Analytics đã nhập đều dẫn đến lỗi MUTATE_NOT_ALLOWED
. Bạn chỉ có thể thực hiện những thay đổi đó bằng giao diện người dùng Google Ads.
Firebase và dịch vụ phân tích ứng dụng bên thứ ba
Để nhập
dữ liệu phân tích ứng dụng bên thứ ba
hoặc lượt chuyển đổi Firebase,
hãy thay đổi status
của
ConversionAction
từ HIDDEN
thành ENABLED
bằng cách sử dụng phương thức mutate
của
ConversionActionService
. Hệ thống không hỗ trợ việc cập nhật app_id
cho những hành động chuyển đổi này.
FIREBASE_ANDROID_FIRST_OPEN
FIREBASE_ANDROID_IN_APP_PURCHASE
FIREBASE_ANDROID_CUSTOM
FIREBASE_IOS_FIRST_OPEN
FIREBASE_IOS_IN_APP_PURCHASE
FIREBASE_IOS_CUSTOM
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
Lượt bán hàng tại cửa hàng thực tế
Mặc dù bạn không thể tạo hành động chuyển đổi STORE_SALES
hoặc STORE_SALES_DIRECT_UPLOAD
bằng API Google Ads, nhưng API này có hỗ trợ tải các giao dịch bán hàng tại cửa hàng thực tế lên.
STORE_SALES
STORE_SALES_DIRECT_UPLOAD
Khác
Những loại hành động chuyển đổi sau đây chỉ có thể đọc trong API Google Ads và được cung cấp cho mục đích báo cáo.
ANDROID_APP_PRE_REGISTRATION
ANDROID_INSTALLS_ALL_OTHER_APPS
FLOODLIGHT_ACTION
FLOODLIGHT_TRANSACTION
GOOGLE_HOSTED
LEAD_FORM_SUBMIT
SALESFORCE
SEARCH_ADS_360
SMART_CAMPAIGN_AD_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS
SMART_CAMPAIGN_TRACKED_CALLS
STORE_VISITS
WEBPAGE_CODELESS
Không xác định
Nếu tài khoản Google Ads của bạn có cả các loại hành động chuyển đổi khác, bạn có thể thấy
rằng truy vấn và báo cáo sẽ trả về hành động chuyển đổi khi
ConversionAction.type
là UNKNOWN
.
API này không hỗ trợ quản lý các hành động chuyển đổi này, nhưng trả về chúng trong báo cáo để cung cấp kết quả đầy đủ cho các chỉ số chuyển đổi chính như metrics.conversions
và metrics.conversions_value
.
Ví dụ về mã
Ví dụ về mã sau đây hướng dẫn bạn thực hiện quy trình tạo một hành động chuyển đổi mới. Cụ thể, hành động này sẽ tạo một hành động chuyển đổi có type
được đặt thành UPLOAD_CLICKS
.
Đây cũng là quy trình trên giao diện người dùng Google Ads khi tạo hành động chuyển đổi mới bằng cách sử dụng Nhập > Nhập thủ công bằng API hoặc tải lên > Theo dõi lượt chuyển đổi từ lượt nhấp. Thao tác này cũng đặt category
thành DEFAULT
.
Các chế độ cài đặt mặc định sau đây được áp dụng:
API Google Ads 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 một hành động chuyển đổi tác động đến báo cáo và việc đặt giá thầu trong tài khoản của mình khi kết hợp với mục tiêu lượt chuyển đổi.API Google Ads tự động đặt
counting_type
thànhMANY_PER_CLICK
. Hãy xem bài viết Giới thiệu về các cách tính lượt chuyển đổi để biết thêm chi tiết.API Google Ads đặt mô hình phân bổ thành Theo hướng dữ liệu bằng cách đặt trường
attribution_model_settings
thành giá trịGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN
làAttributionModel
.
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.V16.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; } }
1.199
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, 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}".' )
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::V16::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V16::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V16::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; }
Bạn cũng có thể tìm thấy ví dụ này trong thư mục Tái tiếp thị của thư viện ứng dụng và trong tập hợp các ví dụ về mã: Ví dụ về cách thêm mã Hành động chuyển đổi.
Xác nhận kết quả
Google Ads và API Google Ads hỗ trợ nhiều hành động chuyển đổi. Vì vậy, một số
quy tắc xác thực sẽ thay đổi tuỳ theo type
hành động.
Cho đến nay, lỗi phổ biến nhất khi tạo hành động chuyển đổi là
DUPLICATE_NAME
.
Hãy đảm bảo bạn đang sử dụng tên riêng biệ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ố đặt trường enum bất kỳ thành
UNKNOWN
sẽ dẫn đến lỗiRequestError.INVALID_ENUM_VALUE
. app_id
- Thuộc tính
app_id
là không thể thay đổi và chỉ có thể được đặt khi tạo một lượt chuyển đổi ứng dụng mới. attribution_model_settings
- Việc đặt thuộc tính này thành một tuỳ 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_CLICK
vàGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN
. click_through_lookback_window_days
Việ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_LOW
hoặ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_CALL
hoặ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_metric
Không đặt được giá trị này trong thao tác
create
hoặcupdate
kèm theo lỗiFieldError.IMMUTABLE_FIELD
. Thay vào đó, hãy đặtprimary_for_goal
như mô tả trong Hướng dẫn về mục tiêu lượt chuyển đổi.phone_call_duration_seconds
Việc cố gắng đặt thuộc tính này cho một hành động chuyển đổi không phải là cuộc gọi sẽ dẫn đến lỗi
FieldError.VALUE_MUST_BE_UNSET
.type
Thuộc tính
type
là không thể thay đổi và chỉ có thể đặt khi tạo một lượt chuyển đổi mới.Việc cập nhật một hành động chuyển đổi có
type
bằngUNKNOWN
sẽ dẫn đến lỗiMutateError.MUTATE_NOT_ALLOWED
.value_settings
value_settings
cho hành động chuyển đổiWEBSITE_CALL
hoặcAD_CALL
phải cóalways_use_default_value
được đặt thànhtrue
. Việc chỉ định giá trịfalse
khi tạo hoặc cập nhật giá trị này sẽ dẫn đến lỗiINVALID_VALUE
.view_through_lookback_window_days
Việ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_LOW
hoặ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]
.Không thể đặt thuộc tính này cho hành động chuyển đổi
AD_CALL
hoặcWEBSITE_CALL
. Việc chỉ định một giá trị sẽ dẫn đến lỗiVALUE_MUST_BE_UNSET
.