คู่มือนี้จะแสดงรายการการกระทำที่ถือเป็น 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_installs |
จำนวนการติดตั้งที่รายงานโดย Apple เมตริกนี้สามารถแบ่งกลุ่มได้ด้วยชุดค่าผสมของ segments.sk_ad_network_conversion_value และกลุ่มที่เกี่ยวข้องกับวันที่เท่านั้น
|
metrics.sk_ad_network_total_conversions |
จำนวน Conversion ทั้งหมด ซึ่งรวมถึงการติดตั้งและ Conversion ประเภทอื่นๆ ที่ Apple รายงาน เมตริกนี้สามารถแบ่งกลุ่มได้ตามกลุ่มที่เกี่ยวข้องกับ SKAdNetwork และกลุ่มที่เกี่ยวข้องกับวันที่เท่านั้น |
segments.sk_ad_network_ad_event_type |
ประเภทของเหตุการณ์ที่เกิดขึ้นสำหรับ Conversion หนึ่งๆ |
segments.sk_ad_network_attribution_credit |
วิธีให้เครดิตการระบุแหล่งที่มาสำหรับ Conversion หนึ่งๆ |
segments.sk_ad_network_fine_conversion_value |
มูลค่าของ Conversion ที่รายงานโดย Apple กลุ่มนี้ใช้
กับเมตริกอื่นๆ ที่ไม่ใช่ ระบบจะแสดงผลค่าของ |
segments.sk_ad_network_coarse_conversion_value |
มูลค่าคร่าวๆ ของ Conversion แต่ละรายการ |
segments.sk_ad_network_postback_sequence_index |
ตำแหน่งของระบบรายงานผล Conversion ตามลำดับสำหรับ Conversion หนึ่งๆ |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id |
รหัสแอปที่กระตุ้นการติดตั้งเครือข่ายโฆษณาใน iOS Store Kit |
segments.sk_ad_network_source_domain |
เว็บไซต์ที่มีการแสดงโฆษณาที่ขับเคลื่อนการติดตั้งเครือข่ายโฆษณา iOS Store Kit ค่า Null หมายความว่ากลุ่มนี้ไม่เกี่ยวข้อง เช่น แคมเปญที่ไม่ใช่ iOS หรือไม่แสดงในระบบรายงานผล Conversion ที่ Apple ส่ง |
segments.sk_ad_network_source_type |
ประเภทแหล่งที่มาที่แสดงโฆษณาซึ่งทําให้เกิดการติดตั้งเครือข่ายโฆษณาใน iOS Store Kit ค่า Null หมายความว่ากลุ่มนี้ไม่เกี่ยวข้อง เช่น แคมเปญที่ไม่ใช่ iOS หรือไม่มีโดเมนแหล่งที่มาหรือแอปแหล่งที่มาในระบบรายงานผล Conversion ที่ส่งจาก Apple |
segments.sk_ad_network_user_type |
ประเภทผู้ใช้ที่ทำให้เกิด Conversion หนึ่งๆ |
segments.sk_ad_network_redistributed_fine_conversion_value |
มูลค่า Conversion ในกลุ่มนี้รวมค่า Null ที่แจกจ่ายให้กับมูลค่า Conversion กลุ่มนี้แสดงผลรวมของมูลค่า Conversion อย่างละเอียดที่พบซึ่งแสดงผลโดย Apple และค่า Null โดยประมาณจาก Google |
คุณยังบันทึกการแมปมูลค่า 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="v17" ) 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.V17.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::V17::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V17::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V17::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; }
ตัวอย่างนี้ยังอยู่ในโฟลเดอร์รีมาร์เก็ตติ้งของไลบรารีไคลเอ็นต์และในคอลเล็กชันตัวอย่างโค้ด: Add Conversion Action code example
การตรวจสอบความถูกต้อง
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