คุณต้องเปิดใช้เครื่องมือวัด Conversion ในบัญชี Conversion ของ Google Ads เพื่อบันทึก Conversion คู่มือนี้จะให้รายละเอียดเกี่ยวกับวิธีตรวจสอบว่าเครื่องมือวัด Conversion เปิดใช้งานอยู่หรือไม่ เปิดใช้งานหากยังไม่ได้เปิดใช้งาน และดึงข้อมูลเกี่ยวกับการกระทําที่ถือเป็น Conversion ที่มีอยู่
นอกจากนี้ การกระทําที่ถือเป็น Conversion ส่วนใหญ่ยังจําเป็นต้องดําเนินการเพิ่มเติมเพื่อติดตามอีกด้วย ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทการกระทําที่ถือเป็น Conversion ต่างๆ และข้อกําหนดได้ที่คู่มือสร้างการกระทําที่ถือเป็น Conversion
ตั้งค่าเว็บไซต์เพื่อติดตาม Conversion
หากเริ่มการผสานรวมการนําเข้า Conversion ออฟไลน์ ขั้นตอนแรกคือการทําตามขั้นตอนในคู่มือกําหนดค่าแท็ก Google สําหรับ Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขายเพื่อกําหนดค่าเว็บไซต์ให้ติดตาม Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขาย คุณยังใช้ Google Tag Manager เพื่อกําหนดค่าเว็บไซต์ได้โดยทําตามขั้นตอนในคู่มือกําหนดค่า Google Tag Manager สําหรับ Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขาย
เปิดใช้เครื่องมือวัด Conversion ในบัญชี Conversion ของ Google Ads
เรียกข้อมูลเกี่ยวกับการตั้งค่าเครื่องมือวัด Conversion
คุณสามารถตรวจสอบการตั้งค่าเครื่องมือวัด Conversion ของบัญชีและยืนยันว่าเปิดใช้เครื่องมือวัด Conversion อยู่โดยค้นหาแหล่งข้อมูล Customer
สำหรับ ConversionTrackingSetting
ออกคําค้นหาต่อไปนี้ด้วย 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
ช่อง google_ads_conversion_customer
ระบุบัญชี Google Ads ที่สร้างและจัดการ Conversion ของลูกค้ารายนี้ สําหรับลูกค้าที่ใช้เครื่องมือวัด Conversion ข้ามบัญชี รหัสนี้คือรหัสของบัญชีดูแลจัดการ รหัสลูกค้าของ Conversion ของ Google Ads ควรระบุเป็น customer_id
ในคําขอ Google Ads API เพื่อสร้างและจัดการ Conversion
โปรดทราบว่าระบบจะป้อนข้อมูลในช่องนี้แม้ว่าจะไม่ได้เปิดใช้เครื่องมือวัด Conversion ก็ตาม
ช่อง conversion_tracking_status
จะระบุว่าเปิดใช้เครื่องมือวัด Conversion อยู่หรือไม่ และบัญชีใช้เครื่องมือวัด Conversion ข้ามบัญชีหรือไม่
สร้างการกระทําที่ถือเป็น Conversion ภายใต้ลูกค้า Conversion ของ Google Ads
หากค่า conversion_tracking_status
คือ NOT_CONVERSION_TRACKED
แสดงว่าบัญชีไม่ได้เปิดใช้เครื่องมือวัด Conversion เปิดใช้เครื่องมือวัด Conversion โดยสร้าง ConversionAction
อย่างน้อย 1 รายการในบัญชี Conversion ของ Google Ads ดังตัวอย่างต่อไปนี้ หรือจะสร้างการกระทําที่ถือเป็น Conversion ใน UI ก็ได้โดยทําตามวิธีการในศูนย์ช่วยเหลือสําหรับประเภท Conversion ที่ต้องการเปิดใช้
โปรดทราบว่าระบบจะเปิดใช้ Conversion ที่ปรับปรุงแล้วโดยอัตโนมัติเมื่อส่งผ่าน Google Ads API แต่สามารถปิดใช้ได้ผ่าน UI ของ Google Ads
ตัวอย่างโค้ด
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.V19.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, 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::V19::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V19::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V19::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; }
ตรวจสอบว่าได้ตั้งค่า conversion_action_type
เป็นค่า ConversionActionType
ที่ถูกต้อง
ดูคําแนะนําเพิ่มเติมเกี่ยวกับการสร้างการกระทําที่ถือเป็น Conversion ใน Google Ads API ได้ที่สร้างการกระทําที่ถือเป็น Conversion
เรียกดูการกระทําที่ถือเป็น Conversion ที่มีอยู่
คุณสามารถเรียกดูรายละเอียดสําหรับการกระทําที่ถือเป็น Conversion ที่มีอยู่ได้โดยส่งการค้นหาต่อไปนี้ ตรวจสอบว่ารหัสลูกค้าในคําขอเป็นรหัสลูกค้า Google Ads ที่ถือเป็น Conversion ที่คุณระบุไว้ข้างต้น และตั้งค่าประเภทการกระทําที่ถือเป็น Conversion เป็นค่า ConversionActionType
ที่ถูกต้อง
SELECT
conversion_action.resource_name,
conversion_action.name,
conversion_action.status
FROM conversion_action
WHERE conversion_action.type = 'INSERT_CONVERSION_ACTION_TYPE'
เครื่องมือวัด Conversion ข้ามบัญชี
หากคุณใช้เครื่องมือวัด Conversion ข้ามบัญชี ConversionActionService
จะแสดงการกระทําที่ถือเป็น Conversion ต่อไปนี้
- การกระทําที่ถือเป็น Conversion ทั้งหมดที่กําหนดโดยบัญชีดูแลจัดการซึ่งบัญชีใช้สําหรับเครื่องมือวัด Conversion ข้ามบัญชี
- การกระทําที่ถือเป็น Conversion ทั้งหมดที่ลูกค้าได้สะสมสถิติไว้ รวมถึงการกระทําที่ระบบกําหนด และการกระทําที่ผู้จัดการเป็นเจ้าของ แม้ว่าผู้จัดการรายนั้นจะยกเลิกการลิงก์ในภายหลังก็ตาม
- การดำเนินการทั้งหมดที่ลูกค้ากำหนดไว้ในบัญชีของตนเอง
- Conversion ของ Analytics ที่สร้างขึ้นในพร็อพเพอร์ตี้ Google Analytics ที่ลิงก์
ซึ่งรวมถึงการกระทําสําหรับ Conversion ของ Analytics ที่ไม่ได้นําเข้าไปยัง Google Ads ซึ่งมีสถานะเป็น
HIDDEN
ตั้งแต่เดือน v19.1
เป็นต้นไป คุณสามารถใช้ Google Ads API เพื่อเลือกใช้เครื่องมือวัด Conversion ข้ามบัญชีเมื่อสร้างบัญชีลูกค้า
เมื่อสร้าง Customer
ใหม่ ให้ตั้งค่า conversion_tracking_setting.google_ads_conversion_customer
เป็นชื่อทรัพยากรของบัญชีดูแลจัดการที่ควรจัดการการกระทําที่ถือเป็น Conversion ในนามของบัญชีลูกค้า นอกจากนี้ บัญชีดูแลจัดการนี้ยังต้องเป็นบัญชีที่ส่งคำขอ create
สำหรับบัญชีลูกค้าใหม่ด้วย
หากต้องการเลือกใช้เครื่องมือวัด Conversion ข้ามบัญชีสําหรับบัญชีลูกค้าที่มีอยู่ คุณต้องใช้ UI ของ Google Ads โดยทําตามวิธีการเหล่านี้
สร้างการกระทําที่ถือเป็น Conversion
หากต้องการวัด Conversion ให้ตั้งค่า ConversionAction
สําหรับ type
ของการกระทําที่ถือเป็น Conversion ที่ต้องการติดตาม เช่น การซื้อออนไลน์และการโทรต้องใช้การกระทําที่ถือเป็น Conversion ที่ต่างกัน
วิธีที่ดีที่สุดในการตั้งค่าการกระทําที่ถือเป็น Conversion ใหม่ใน API คือการใช้เพิ่มตัวอย่างโค้ดการกระทําที่ถือเป็น Conversion ด้านล่าง ตัวอย่างนี้จะจัดการงานการตรวจสอบสิทธิ์ในเบื้องหลังทั้งหมดให้คุณ และแนะนำการสร้าง ConversionAction
นอกจากนี้ การกระทําที่ถือเป็น Conversion ส่วนใหญ่ยังจําเป็นต้องดําเนินการเพิ่มเติมเพื่อติดตามอีกด้วย เช่น หากต้องการติดตาม Conversion ในเว็บไซต์ คุณต้องเพิ่มข้อมูลโค้ดที่เรียกว่าแท็กลงในหน้า Conversion บนเว็บไซต์ ดูข้อกําหนดโดยละเอียดของประเภทการกระทําที่ถือเป็น Conversion อื่นๆ ได้ที่บทความในศูนย์ช่วยเหลือ
ตัวอย่างโค้ด
ตัวอย่างโค้ดต่อไปนี้จะอธิบายขั้นตอนการสร้างการกระทําที่ถือเป็น Conversion ใหม่ กล่าวโดยละเอียดคือ ฟีเจอร์นี้จะสร้างการกระทําที่ถือเป็น Conversion โดยตั้งค่า type
เป็น UPLOAD_CLICKS
ขั้นตอนนี้เหมือนกับการสร้างการกระทําที่ถือเป็น Conversion ใหม่โดยใช้นําเข้า > นําเข้าด้วยตนเองโดยใช้ API หรือการอัปโหลด > ติดตาม Conversion จากคลิกใน UI ของ Google Ads รวมถึงตั้งค่า category
เป็น DEFAULT
ด้วย
การตั้งค่าเริ่มต้นต่อไปนี้จะมีผล
Google Ads API จะตั้งค่าช่อง
primary_for_goal
โดยอัตโนมัติ แต่คุณตั้งค่าช่องนี้ได้อย่างชัดเจนเพื่อควบคุมวิธีที่การกระทําที่ถือเป็น Conversion ส่งผลต่อการรายงานและการเสนอราคาในบัญชีเมื่อรวมเข้ากับเป้าหมาย ConversionGoogle Ads API จะตั้งค่า
counting_type
โดยอัตโนมัติเป็นMANY_PER_CLICK
ดูรายละเอียดเพิ่มเติมได้ที่เกี่ยวกับตัวเลือกการนับ ConversionGoogle Ads API จะตั้งค่ารูปแบบการระบุแหล่งที่มาเป็นจากข้อมูลโดยการตั้งค่าช่อง
attribution_model_settings
เป็นค่าGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN
ของ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.V19.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, 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::V19::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V19::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V19::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; }
ตัวอย่างนี้ยังอยู่ในโฟลเดอร์รีมาร์เก็ตติ้งของไลบรารีไคลเอ็นต์ และอยู่ในคอลเล็กชันตัวอย่างโค้ด: เพิ่มตัวอย่างโค้ดการกระทําที่ถือเป็น Conversion
การตรวจสอบความถูกต้อง
Google Ads และ Google Ads API รองรับการกระทําที่ถือเป็น Conversion ที่หลากหลาย ดังนั้นกฎการตรวจสอบบางอย่างจึงแตกต่างกันไปตามtype
การกระทํา
ข้อผิดพลาดที่พบบ่อยที่สุดเมื่อสร้างการกระทําที่ถือเป็น Conversion คือ DUPLICATE_NAME
ตรวจสอบว่าคุณใช้ชื่อที่ไม่ซ้ำกันสําหรับการกระทําที่ถือเป็น Conversion แต่ละรายการ
เคล็ดลับในการตั้งค่าช่อง ConversionAction
มีดังนี้
- ช่อง Enum ทั้งหมด
- การพยายามตั้งค่าช่อง Enum เป็น
UNKNOWN
จะทำให้เกิดข้อผิดพลาดRequestError.INVALID_ENUM_VALUE
app_id
- แอตทริบิวต์
app_id
ไม่สามารถเปลี่ยนแปลงได้และตั้งค่าได้เมื่อสร้าง Conversion ใหม่จากแอปเท่านั้น attribution_model_settings
- การตั้งค่านี้เป็นตัวเลือกที่เลิกใช้งานจะทำให้เกิดข้อผิดพลาด
CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
Google Ads รองรับเฉพาะGOOGLE_ADS_LAST_CLICK
และGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN
click_through_lookback_window_days
การตั้งค่าแอตทริบิวต์นี้เป็นค่าที่อยู่นอกช่วงที่อนุญาตจะทำให้เกิดข้อผิดพลาด
RangeError.TOO_LOW
หรือRangeError.TOO_HIGH
แอตทริบิวต์นี้ต้องอยู่ในช่วง
[1,60]
สําหรับการกระทําที่ถือเป็น ConversionAD_CALL
หรือWEBSITE_CALL
สําหรับการกระทําที่ถือเป็น Conversion อื่นๆ ส่วนใหญ่ ช่วงที่ได้รับอนุญาตคือ[1,30]
include_in_conversions_metric
การตั้งค่านี้ในการดำเนินการ
create
หรือupdate
ไม่สําเร็จเนื่องจากมีข้อผิดพลาดFieldError.IMMUTABLE_FIELD
แต่ให้ตั้งค่าprimary_for_goal
ตามที่อธิบายไว้ในคู่มือเป้าหมาย Conversionphone_call_duration_seconds
การพยายามตั้งค่าแอตทริบิวต์นี้ในการกระทำที่ถือเป็น Conversion ที่ไม่ใช่สําหรับการโทรจะทําให้เกิดข้อผิดพลาด
FieldError.VALUE_MUST_BE_UNSET
type
แอตทริบิวต์
type
ไม่สามารถเปลี่ยนแปลงได้และตั้งค่าได้เมื่อสร้าง Conversion ใหม่เท่านั้นการอัปเดตการกระทําที่ถือเป็น Conversion ที่มี
type
เท่ากับUNKNOWN
ทําให้มีข้อผิดพลาดMutateError.MUTATE_NOT_ALLOWED
value_settings
value_settings
ของการกระทำที่ถือเป็น ConversionWEBSITE_CALL
หรือAD_CALL
ต้องตั้งค่าalways_use_default_value
เป็นtrue
การระบุค่าfalse
เมื่อสร้างหรืออัปเดตค่านี้ส่งผลให้เกิดข้อผิดพลาดINVALID_VALUE
view_through_lookback_window_days
การตั้งค่าแอตทริบิวต์นี้เป็นค่าที่อยู่นอกช่วงที่อนุญาตจะทำให้เกิดข้อผิดพลาด
RangeError.TOO_LOW
หรือRangeError.TOO_HIGH
สําหรับการกระทําที่ถือเป็น Conversion ส่วนใหญ่ ช่วงที่ได้รับอนุญาตคือ[1,30]
ตั้งค่าแอตทริบิวต์นี้ในการกระทำที่ถือเป็น Conversion
AD_CALL
หรือWEBSITE_CALL
ไม่ได้ การระบุค่าจะทำให้เกิดข้อผิดพลาดVALUE_MUST_BE_UNSET