คู่มือนี้จะแสดงรายการการกระทําที่ถือเป็น 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 หนึ่งๆ |
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 ในส่วนนี้ประกอบด้วยค่าว่างที่ได้รับการแจกแจงใหม่เป็นมูลค่า Conversion กลุ่มนี้แสดงผลรวมของมูลค่า Conversion ที่ละเอียดที่สังเกตได้ซึ่ง Apple แสดงผล และค่า Null โดยประมาณจาก Google |
segments.sk_ad_network_version |
เวอร์ชัน iOS Store Kit Ad Network API ที่ใช้ |
นอกจากนี้ คุณยังบันทึกการแมปมูลค่า 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="v18" ) 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 ที่มีการรายงาน
แม้ว่าคุณจะสร้างการกระทําที่ถือเป็น Conversion STORE_SALES
หรือ STORE_SALES_DIRECT_UPLOAD
โดยใช้ Google Ads API ไม่ได้ แต่ API รองรับการอัปโหลดธุรกรรมยอดขายในร้าน
STORE_SALES
STORE_SALES_DIRECT_UPLOAD
ประเภทการกระทําที่ถือเป็น Conversion แบบอ่านอย่างเดียว
การกระทําที่ถือเป็น 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
ขั้นตอนนี้เหมือนกับการสร้างการกระทําที่ถือเป็น 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.V18.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::V18::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V18::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V18::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