คู่มือนี้จะแสดงรายการการกระทำที่ถือเป็น 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
,
ซึ่งจะต้องติดตั้งในทุกหน้าของเว็บไซต์ คุณสามารถดึงข้อมูล
เหล่านี้ด้วยแอตทริบิวต์
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
ตารางต่อไปนี้แสดงค่าที่เทียบเท่า
ConversionActionType
พารามิเตอร์ของ API ที่จะใช้สำหรับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads
ประเภทการกระทําที่ถือเป็น Conversion | แหล่งที่มาของ Google Ads |
---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > การติดตั้ง |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > การซื้อในแอป |
หากต้องการติดตามการกระทําอื่นๆ ในแอปบนอุปกรณ์เคลื่อนที่โดยใช้พร็อพเพอร์ตี้ Google Analytics 4 หรือการวิเคราะห์แอปของบุคคลที่สาม ดูประเภทการกระทำที่ถือเป็น Conversion เพิ่มเติม
Conversion การโทร
การติดตาม Conversion การโทรช่วยให้คุณติดตามการโทรจากโฆษณา การโทรไปยังหมายเลขในเว็บไซต์ และการคลิกหมายเลขในเว็บไซต์บนอุปกรณ์เคลื่อนที่ได้
ตารางต่อไปนี้แสดงค่าที่เทียบเท่า
ConversionActionType
พารามิเตอร์ของ API ที่จะใช้สำหรับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads
ประเภทการกระทำที่ถือเป็น Conversion | แหล่งที่มาของ Google Ads |
---|---|
AD_CALL |
การโทรจากโฆษณาโดยใช้ส่วนขยายการโทรหรือโฆษณาแบบโทรออกเท่านั้น |
WEBSITE_CALL |
การโทรไปยังหมายเลขโทรศัพท์ในเว็บไซต์ |
CLICK_TO_CALL |
คลิกหมายเลขในเว็บไซต์บนอุปกรณ์เคลื่อนที่ของคุณ |
ประเภท CLICK_TO_CALL
แตกต่างจากประเภท AD_CALL
ไม่ติดตามการโทรจริง แต่ CLICK_TO_CALL
จะติดตามเฉพาะการคลิกบน
หมายเลขโทรศัพท์จากอุปกรณ์เคลื่อนที่ ซึ่งจะเป็นประโยชน์เมื่อคุณไม่สามารถใช้
หมายเลขโอนสายของ Google สําหรับการติดตามการโทร
AD_CALL
CANNOT TRANSLATE
AD_CALL
การกระทำที่ถือเป็น Conversion ปรากฏเป็นการโทรจาก
ads Conversion ใน Google Ads
อินเทอร์เฟซเว็บ หลังจากสร้างการกระทําที่ถือเป็น Conversion AD_CALL
แล้ว ให้ระบุชื่อแหล่งข้อมูลในช่อง call_conversion_action
เมื่อสร้าง CallAsset
โทร
เนื้อหาจะช่วยให้คุณแสดง
หมายเลขโทรศัพท์ในโฆษณาของคุณโดยตรง
ระบบจะรายงานการโทรเป็น Conversion หากมีระยะเวลานานกว่าระยะเวลาที่ระบุ ค่าเริ่มต้นคือ 60 วินาที
WEBSITE_CALL
ต
WEBSITE_CALL
การกระทำที่ถือเป็น Conversion แสดงเป็นการโทรจาก
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 ประเภทอื่นๆ 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 |
segments.sk_ad_network_version |
เวอร์ชัน API เครือข่ายโฆษณาของ iOS Store Kit ที่ใช้ |
คุณยังบันทึกการแมปมูลค่า 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 และการวิเคราะห์แอปจากบุคคลที่สาม
วิธีนำเข้า
การวิเคราะห์แอปจากบุคคลที่สาม
หรือ Firebase
เปลี่ยน status
ของ
ConversionAction
จาก HIDDEN
ถึง ENABLED
โดยใช้เมธอด mutate
ของ
ConversionActionService
การกระทําที่ถือเป็น Conversion เหล่านี้ไม่รองรับการอัปเดต app_id
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
นี่คือขั้นตอน 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; }
ตัวอย่างนี้ยังอยู่ในโฟลเดอร์รีมาร์เก็ตติ้งของไลบรารีไคลเอ็นต์ด้วย และในคอลเล็กชันตัวอย่างโค้ด: เพิ่มโค้ดการกระทําที่ถือเป็น 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]
สำหรับAD_CALL
หรือ การกระทำที่ถือเป็น ConversionWEBSITE_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