คู่มือนี้แสดงรายการการกระทำที่ถือเป็น Conversion ประเภทต่างๆ ที่คุณสร้างได้โดยใช้ Google Ads API, ข้อมูลเกี่ยวกับวิธีแมปเหล่านี้กับอินเทอร์เฟซเว็บ Google Ads และตัวอย่างโค้ดโดยละเอียดที่สาธิตวิธีสร้างการกระทำที่ถือเป็น Conversion ใหม่
หากต้องการวัด Conversion ให้ตั้งค่า ConversionAction
สำหรับ type
ของการกระทำที่ถือเป็น Conversion ที่คุณต้องการติดตาม ตัวอย่างเช่น การซื้อออนไลน์และการโทร
ต้องใช้การกระทำที่ถือเป็น Conversion ที่ต่างกัน
วิธีที่ดีที่สุดในการตั้งค่าการกระทำที่ถือเป็น Conversion ใหม่ใน API คือการใช้ตัวอย่างโค้ดการกระทำที่ถือเป็น Conversion ด้านล่าง ตัวอย่างนี้จะจัดการงานการตรวจสอบสิทธิ์ในเบื้องหลังทั้งหมดให้คุณ และอธิบายวิธีสร้างConversionAction
การกระทำที่ถือเป็น Conversion ส่วนใหญ่ต้องมีขั้นตอนเพิ่มเติมเพื่อติดตามด้วย เช่น หากต้องการติดตาม Conversion ในเว็บไซต์ คุณต้องเพิ่มข้อมูลโค้ดที่เรียกว่าแท็กลงในหน้า Conversion ของเว็บไซต์ ดูข้อกำหนดอื่นๆ ของการกระทำที่ถือเป็น Conversion ได้ที่บทความในศูนย์ช่วยเหลือ
Conversion ของเว็บไซต์
Conversion ในเว็บไซต์ช่วยให้คุณติดตามการกระทำในเว็บไซต์ได้ เช่น การขายออนไลน์ การคลิกลิงก์ การดูหน้าเว็บ และการลงชื่อสมัครใช้
หากต้องการติดตาม Conversion ในเว็บไซต์ คุณต้องสร้าง ConversionAction
ที่มี ConversionActionType
ที่ตั้งค่าเป็น WEBPAGE
และเพิ่มข้อมูลโค้ดที่เรียกว่าแท็กลงในหน้า Conversion บนเว็บไซต์
ConversionAction
ประกอบด้วย Conversion ในเว็บไซต์หลายประเภท ซึ่งจำแนกภายใน API ตามช่อง type
ในแต่ละ TagSnippet
ที่ระบุไว้ในช่อง tag_snippets ของ ConversionAction
TagSnippet
ให้โค้ดติดตามที่ต้องรวมอยู่ในเว็บไซต์เพื่อติดตามการกระทำที่ถือเป็น Conversion
Conversion ในเว็บไซต์และการคลิกหมายเลขโทรศัพท์ต้องใช้ event_snippet
ซึ่งควรวางไว้ในหน้าเว็บที่ระบุการกระทําที่ถือเป็น Conversion เช่น หน้ายืนยันการชําระเงินหรือหน้าส่งแบบฟอร์มโอกาสในการขาย และ global_site_tag
ซึ่งต้องติดตั้งในทุกหน้าของเว็บไซต์ คุณเรียกข้อมูลแอตทริบิวต์ทั้ง 2 รายการนี้ได้ด้วย ConversionActionService
ดู
ศูนย์ช่วยเหลือสำหรับ
ข้อมูลเพิ่มเติมเกี่ยวกับวิธีติดแท็กหน้าเว็บ
ตารางต่อไปนี้แสดงพารามิเตอร์ของ API ที่เทียบเท่ากันเพื่อใช้กับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads
ประเภทโค้ดติดตาม | แหล่งที่มาของ Google Ads |
---|---|
WEBPAGE |
เว็บไซต์ เว็บไซต์ (Google Analytics (GA4)) |
WEBPAGE_ONCLICK |
เว็บไซต์ เว็บไซต์ (Google Analytics (GA4)) |
CLICK_TO_CALL |
การคลิกหมายเลขโทรศัพท์ |
--- |
เว็บไซต์ (Google Analytics (UA)) |
Conversion ในแอป
Conversion ของแอปช่วยให้คุณติดตามการติดตั้งแอปบนอุปกรณ์เคลื่อนที่หรือการซื้อในแอปจาก Google Play Store ได้
ตารางต่อไปนี้แสดงพารามิเตอร์ API ConversionActionType
ที่เทียบเท่ากันเพื่อใช้กับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads
ประเภทการกระทำที่ถือเป็น Conversion | แหล่งที่มาของ Google Ads |
---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > การติดตั้ง |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > การซื้อในแอป |
หากต้องการติดตามการกระทำอื่นๆ ในแอปบนอุปกรณ์เคลื่อนที่โดยใช้พร็อพเพอร์ตี้ Google Analytics 4 หรือการวิเคราะห์แอปจากบุคคลที่สาม ดูประเภทการกระทำที่ถือเป็น Conversion เพิ่มเติม
Conversion การโทร
การวัด Conversion การโทร ช่วยให้คุณติดตามการโทรจากโฆษณา การโทรไปยังหมายเลขในเว็บไซต์ และ การคลิกหมายเลขในเว็บไซต์ในอุปกรณ์เคลื่อนที่ได้
ตารางต่อไปนี้แสดงพารามิเตอร์ API ConversionActionType
ที่เทียบเท่ากันเพื่อใช้กับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads
ประเภทการกระทำที่ถือเป็น Conversion | แหล่งที่มาของ Google Ads |
---|---|
AD_CALL |
การโทรจากโฆษณาโดยใช้ส่วนขยายการโทรหรือโฆษณาแบบโทรออกเท่านั้น |
WEBSITE_CALL |
การโทรไปยังหมายเลขโทรศัพท์ในเว็บไซต์ |
CLICK_TO_CALL |
การคลิกหมายเลขในเว็บไซต์บนอุปกรณ์เคลื่อนที่ |
ประเภท CLICK_TO_CALL
แตกต่างจากประเภท AD_CALL
ตรงที่ไม่ติดตามการโทรจริง แต่ CLICK_TO_CALL
จะติดตามเฉพาะการคลิกหมายเลขโทรศัพท์จากอุปกรณ์เคลื่อนที่เท่านั้น วิธีนี้มีประโยชน์เมื่อคุณไม่สามารถใช้หมายเลขโอนสายของ Google
ในการติดตามการโทรได้
AD_CALL
การกระทำที่ถือเป็น Conversion AD_CALL
จะปรากฏเป็น Conversion ของการโทรจากโฆษณาในอินเทอร์เฟซเว็บของ Google Ads หลังจากสร้างการกระทำที่ถือเป็น Conversion AD_CALL
แล้ว ให้ระบุชื่อทรัพยากรในช่อง call_conversion_action
เมื่อสร้าง CallAsset
ชิ้นงานการโทรช่วยให้คุณแสดงหมายเลขโทรศัพท์ในโฆษณาได้โดยตรง
ระบบจะรายงานการโทรเป็น Conversion หากมีระยะเวลานานกว่าระยะเวลาที่ระบุ ค่าเริ่มต้นคือ 60 วินาที
WEBSITE_CALL
การกระทำที่ถือเป็น Conversion WEBSITE_CALL
จะปรากฏเป็น Conversion การโทรจากเว็บไซต์ในอินเทอร์เฟซเว็บของ Google Ads
ซึ่งต่างจาก
AD_CALL
ตรงที่
เครื่องมือติดตามนี้กําหนดให้ต้องเพิ่ม event_snippet
และ global_site_tag
ลงในเว็บไซต์
เพื่อดึงหมายเลขโอนสายของ Google แบบไดนามิกสำหรับการติดตามการโทร
จากหมายเลขที่แสดงบนเว็บไซต์ นอกจากนี้ คุณต้องสร้างชิ้นงานการโทรและลิงก์เนื้อหาที่ระดับลูกค้า แคมเปญ หรือกลุ่มโฆษณา
นำเข้า Conversion ออฟไลน์
ตารางต่อไปนี้แสดงพารามิเตอร์ API ConversionActionType
ที่เทียบเท่ากันที่จะใช้กับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads และลิงก์ไปยังเอกสารประกอบสําหรับการกระทําที่ถือเป็น Conversion แต่ละประเภท
ประเภทการกระทำที่ถือเป็น Conversion | แหล่งที่มาของ Google Ads | คู่มือการตั้งค่า API |
---|---|---|
UPLOAD_CLICKS |
ติดตาม Conversion จากการคลิกและ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย | คู่มือการคลิกอัปโหลด
คู่มือ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย |
UPLOAD_CALLS |
ติดตาม Conversion จากการโทร | คู่มือการตั้งค่า API |
STORE_SALES |
ติดตาม Conversion ยอดขายในร้าน | คู่มือการตั้งค่า API |
Conversion ที่ปรับปรุงแล้วสําหรับเว็บ
Conversion ที่ปรับปรุงแล้วสำหรับเว็บช่วยให้คุณส่งข้อมูล Conversion จากบุคคลที่หนึ่งสำหรับการกระทำที่ถือเป็น Conversion WEBPAGE
รายการได้ภายใน 24 ชั่วโมงหลังจากเกิดเหตุการณ์ Conversion แทนการส่งพร้อมกัน วิธีนี้ช่วยให้คุณค้นหาข้อมูลจากบุคคลที่หนึ่งจากแหล่งที่มาต่างๆ ได้ เช่น ฐานข้อมูลลูกค้าหรือระบบ CRM
ประเภทการกระทำที่ถือเป็น Conversion เพิ่มเติม
Google Ads API ช่วยให้มีการกระทำที่ถือเป็น Conversion หลายประเภทมากขึ้นในรายงาน แต่อาจจำกัดหรือห้ามการสร้างหรือแก้ไขการกระทำเหล่านั้น
Conversion ของ SKAdNetwork
หากคุณใช้ App Campaign สำหรับ iOS และใช้ SKAdNetwork อยู่ คุณจะเข้าถึงข้อมูล SKAdNetwork ที่ให้ไว้กับ Google ที่ระดับ Customer
และ Campaign
ได้โดยใช้แหล่งข้อมูลต่อไปนี้
ช่องรายงาน | คำอธิบาย |
---|---|
metrics.sk_ad_network_conversions |
จำนวน Conversion ที่รายงานโดย Apple เมตริกนี้สามารถแบ่งกลุ่มตามชุดค่าผสมใดๆ ของ segments.sk_ad_network_conversion_value และกลุ่มที่เกี่ยวข้องกับวันที่เท่านั้น
|
segments.sk_ad_network_conversion_value |
มูลค่าของ Conversion ที่รายงานโดย Apple กลุ่มนี้ไม่สามารถใช้
กับเมตริกใดๆ ที่ไม่ใช่ ระบบจะแสดงผลค่า |
นอกจากนี้คุณยังบันทึกการแมปมูลค่า Conversion ของ SKAdNetwork สําหรับลูกค้าที่ลิงก์อยู่กับแอป iOS ได้ผ่าน CustomerSkAdNetworkConversionValueSchema
ตัวอย่างโค้ด Python
#!/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
Conversion จากพร็อพเพอร์ตี้ Google Analytics ที่ลิงก์มีค่าใดค่าหนึ่งต่อไปนี้ type
Conversion ของพร็อพเพอร์ตี้ GA4:
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
คุณยังดึงข้อมูลรหัสพร็อพเพอร์ตี้ GA4, ชื่อพร็อพเพอร์ตี้ และชื่อเหตุการณ์จากช่อง
google_analytics_4_settings
ได้ด้วยConversion พร็อพเพอร์ตี้ Universal Analytics:
UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
คุณจะทําการเปลี่ยนแปลงต่อไปนี้กับ Conversion ของพร็อพเพอร์ตี้ GA4 ได้
- นําเข้า Conversion จากพร็อพเพอร์ตี้ GA4 มายังบัญชี Google Ads โดยการแก้ไขช่อง
status
จากHIDDEN
เป็นENABLED
- แก้ไขช่อง
primary_for_goal
และcategory
เพื่อระบุว่าควรส่งผลต่อการเสนอราคาและรายงานของ Google Ads อย่างไร - โปรดอัปเดต
name
หรือvalue_settings
- นํา Conversion ออกจากบัญชี Google Ads โดยใช้การดําเนินการ
remove
การพยายามแก้ไขแอตทริบิวต์อื่นๆ ของ Conversion ของ GA4 ที่นําเข้าหรือแอตทริบิวต์ใดก็ตามของ Conversion ของ Universal Analytics ที่นําเข้าจะทำให้เกิดข้อผิดพลาด MUTATE_NOT_ALLOWED
คุณทําการเปลี่ยนแปลงได้โดยใช้ UI ของ Google Ads เท่านั้น
Firebase และการวิเคราะห์แอปของบุคคลที่สาม
หากต้องการนำเข้า
การวิเคราะห์แอปจากบุคคลที่สาม
หรือ Conversion ของ Firebase
ให้เปลี่ยน status
ของ
ConversionAction
จาก HIDDEN
เป็น ENABLED
โดยใช้เมธอด mutate
ของ
ConversionActionService
ไม่รองรับการอัปเดต app_id
สำหรับการกระทำที่ถือเป็น Conversion เหล่านี้
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
ยอดขายในร้าน
แม้ว่าคุณจะสร้างการกระทำที่ถือเป็น Conversion STORE_SALES
หรือ STORE_SALES_DIRECT_UPLOAD
โดยใช้ Google Ads API ไม่ได้ แต่ API จะรองรับการอัปโหลดธุรกรรมยอดขายในร้าน
STORE_SALES
STORE_SALES_DIRECT_UPLOAD
เบ็ดเตล็ด
การกระทําที่ถือเป็น Conversion ประเภทต่อไปนี้เป็นแบบอ่านอย่างเดียวใน Google Ads API และมีไว้เพื่อวัตถุประสงค์ในการรายงาน
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
ไม่ทราบ
หากบัญชี Google Ads มีการกระทําที่ถือเป็น Conversion ประเภทอื่นๆ คุณอาจพบว่าการค้นหาและรายงานดังกล่าวแสดงผลการกระทําที่ถือเป็น Conversion โดยที่ ConversionAction.type
คือ UNKNOWN
API ไม่รองรับการจัดการการกระทำที่ถือเป็น Conversion เหล่านี้ แต่แสดงผลในรายงานเพื่อให้ผลลัพธ์ที่สมบูรณ์สำหรับเมตริก Conversion ที่สำคัญ เช่น metrics.conversions
และ metrics.conversions_value
ตัวอย่างโค้ด
ตัวอย่างโค้ดต่อไปนี้จะอธิบายขั้นตอนการสร้างการกระทำที่ถือเป็น Conversion ใหม่ กล่าวอย่างเจาะจงคือ จะมีการสร้างการกระทำที่ถือเป็น Conversion โดยมี type
ที่ตั้งค่าเป็น UPLOAD_CLICKS
ขั้นตอนนี้จะเป็นขั้นตอนเดียวกับ UI ของ Google Ads กับการสร้างการกระทำที่ถือเป็น Conversion ใหม่โดยใช้
นำเข้า > นำเข้าด้วยตนเองโดยใช้ API หรือการอัปโหลด > ติดตาม Conversion จากการคลิก และยังตั้งค่า category
เป็น DEFAULT
อีกด้วย
ระบบจะใช้การตั้งค่าเริ่มต้นต่อไปนี้
Google Ads API จะตั้งค่าช่อง
primary_for_goal
โดยอัตโนมัติ แต่คุณตั้งค่าช่องนี้อย่างชัดแจ้งเพื่อควบคุมผลกระทบที่การกระทำที่ถือเป็น Conversion มีต่อการรายงานและการเสนอราคาในบัญชีได้เมื่อรวมกับเป้าหมาย ConversionGoogle Ads API จะตั้งค่า
counting_type
เป็นMANY_PER_CLICK
โดยอัตโนมัติ ดูเกี่ยวกับตัวเลือกการนับ Conversion สำหรับรายละเอียดเพิ่มเติมGoogle 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.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; } }
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::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; }
ตัวอย่างนี้ยังพบได้ในโฟลเดอร์รีมาร์เก็ตติ้งของไลบรารีไคลเอ็นต์และในคอลเล็กชันตัวอย่างโค้ด: ตัวอย่างโค้ดการกระทำที่ถือเป็น 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
ตามที่อธิบายไว้ในคู่มือเป้าหมาย Conversion แทนphone_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