คู่มือนี้แสดงรายการการกระทำที่ถือเป็น Conversion ประเภทต่างๆ ที่คุณสร้างได้โดยใช้ Google Ads API และข้อมูลเกี่ยวกับวิธีแมปการกระทำเหล่านี้กับอินเทอร์เฟซเว็บของ Google Ads
เลือกประเภทการกระทำที่ถือเป็น Conversion ที่เหมาะสม
หากต้องการเลือกประเภทการกระทำที่ถือเป็น Conversion และคู่มือการตั้งค่าที่ถูกต้องสําหรับการผสานรวม ให้ใช้เส้นทางการตัดสินใจต่อไปนี้
เหตุการณ์ Conversion เกิดขึ้นที่ใด
- ในโลกออฟไลน์ (เช่น ที่สำนักงาน สถานที่ตั้งธุรกิจ หรือทางโทรศัพท์): ไปที่ขั้นตอนที่ 2
- ในเว็บไซต์โดยตรง (เช่น การซื้อ การลงชื่อสมัครใช้ หรือการส่งแบบฟอร์มในเว็บไซต์): ไปที่ขั้นตอนที่ 3
- ภายในแอปบนอุปกรณ์เคลื่อนที่: ไปที่ขั้นตอนที่ 4
- ผ่านการโทรที่โทรโดยตรงจากโฆษณา: ใช้การโทรจากโฆษณา (
AD_CALL) (โดยใช้CallAsset)
Conversion ออฟไลน์:
เป็นการโทรศัพท์ใช่ไหม
ใช่: ใช้
การนำเข้า Conversion การโทร (
UPLOAD_CALLS) เพื่อติดตามผลลัพธ์ของการโทร
เป็นการขายที่หน้าร้านจริงใช่ไหม
เป็นยอดขายออฟไลน์หรือความคืบหน้าของผู้มีโอกาสเป็นลูกค้าที่เกิดจากการเข้าชมเว็บไซต์หรือไม่
- ใช่: ใช้ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขายโดยใช้ Data Manager API (แนะนํา) หรือดูวิธีจัดการ Conversion จากการคลิกออฟไลน์สําหรับการผสานรวม Google Ads API ที่มีอยู่ (หมายเหตุ: ตั้งแต่วันที่ 15 มิถุนายน 2026 เป็นต้นไป การอัปโหลด Conversion การคลิกโดยใช้
UploadClickConversionsจะจำกัดไว้สำหรับโทเค็นของนักพัฒนาซอฟต์แวร์ที่เคยอัปโหลด Conversion การคลิกออฟไลน์มาก่อน)
- ใช่: ใช้ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขายโดยใช้ Data Manager API (แนะนํา) หรือดูวิธีจัดการ Conversion จากการคลิกออฟไลน์สําหรับการผสานรวม Google Ads API ที่มีอยู่ (หมายเหตุ: ตั้งแต่วันที่ 15 มิถุนายน 2026 เป็นต้นไป การอัปโหลด Conversion การคลิกโดยใช้
Conversion ออนไลน์ (เว็บไซต์):
- คุณต้องการติดตามการโหลดหน้าเว็บ (การซื้อ ใบเสร็จ) หรือการคลิกของผู้ใช้
- ใช่: ใช้ Conversion ในเว็บไซต์โดยตั้งค่าข้อมูลโค้ดแท็กเป็น
WEBPAGEหรือWEBPAGE_ONCLICK
- ใช่: ใช้ Conversion ในเว็บไซต์โดยตั้งค่าข้อมูลโค้ดแท็กเป็น
คุณต้องการติดตามการโทรที่เกิดจากหมายเลขโทรศัพท์ที่แสดงใน เว็บไซต์ไหม
ติดตามระยะเวลาการโทรจริง
ใช่: ใช้
การโทรจากเว็บไซต์ (
WEBSITE_CALL) ที่มีหมายเลขโอนสายของ Google แบบไดนามิกและข้อมูลโค้ดเหตุการณ์แท็กไม่ (ติดตามเฉพาะการคลิกปุ่ม/ลิงก์ในเว็บไซต์เวอร์ชันอุปกรณ์เคลื่อนที่) ใช้
- คุณต้องการติดตามการโหลดหน้าเว็บ (การซื้อ ใบเสร็จ) หรือการคลิกของผู้ใช้
Conversion ของแอปบนอุปกรณ์เคลื่อนที่:
- การติดตามการติดตั้งหรือการซื้อจาก Google Play Store เพียงพอหรือไม่
- ใช่: ใช้ Conversion ของแอป (
GOOGLE_PLAY_DOWNLOADหรือGOOGLE_PLAY_IN_APP_PURCHASE)
- ใช่: ใช้ Conversion ของแอป (
คุณติดตามการกระทำในแอปโดยใช้ Google Analytics (GA4) หรือ การวิเคราะห์แอปของบุคคลที่สามหรือไม่
ใช่: ใช้
Firebase และการวิเคราะห์แอปของบุคคลที่สาม (โดยการเปิดใช้การกระทำที่ถือเป็น Conversion
FIREBASE_*หรือTHIRD_PARTY_*)
- การติดตามการติดตั้งหรือการซื้อจาก Google Play Store เพียงพอหรือไม่
Conversion ออฟไลน์
Conversion ออฟไลน์ช่วยให้คุณติดตามเหตุการณ์ Conversion ที่เกิดขึ้นในโลกออฟไลน์ เช่น ที่สำนักงาน สถานที่ตั้งธุรกิจ หรือทางโทรศัพท์
ตารางต่อไปนี้แสดงพารามิเตอร์ API ConversionActionType ที่เทียบเท่าซึ่งใช้กับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads และลิงก์ไปยังเอกสารประกอบสำหรับการกระทำที่ถือเป็น Conversion ที่เฉพาะเจาะจงแต่ละประเภท
| ประเภทการกระทำที่ถือเป็น Conversion | แหล่งที่มา Google Ads | คู่มือการตั้งค่า API |
|---|---|---|
UPLOAD_CLICKS |
ติดตาม Conversion จากการคลิกและ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย | ใช้ Data Manager API (แนะนํา) หรือดูจัดการ Conversion จากการคลิกออฟไลน์สําหรับการผสานรวม Google Ads API ที่มีอยู่ |
UPLOAD_CALLS |
ติดตาม Conversion จากการโทร | คู่มือการนำเข้า Conversion การโทร |
STORE_SALES |
ติดตาม 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 |
การคลิกหมายเลขโทรศัพท์ |
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 |
การคลิกหมายเลขในเว็บไซต์เวอร์ชันมือถือ |
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 แบบไดนามิกสำหรับการติดตามการโทรไปยังหมายเลขที่แสดงในเว็บไซต์ นอกจากนี้ คุณต้องตั้งค่าชิ้นงานการโทรและ
ลิงก์ที่ระดับลูกค้า แคมเปญ หรือกลุ่มโฆษณา
CLICK_TO_CALL
การกระทำที่ถือเป็น Conversion CLICK_TO_CALL จะปรากฏเป็น Conversion การคลิกหมายเลขโทรศัพท์ในเว็บไซต์เวอร์ชันมือถือในอินเทอร์เฟซเว็บของ Google Ads
ประเภท CLICK_TO_CALL แตกต่างจากประเภท AD_CALL ตรงที่จะไม่ติดตามการโทรจริง แต่ CLICK_TO_CALL จะติดตามเฉพาะการคลิกหมายเลขโทรศัพท์จากอุปกรณ์เคลื่อนที่เท่านั้น ซึ่งจะมีประโยชน์เมื่อคุณไม่สามารถใช้หมายเลขโอนสายของ Google เพื่อติดตามการโทรได้
Conversion ที่ปรับปรุงแล้ว
Conversion ที่ปรับปรุงแล้วช่วยปรับปรุงความแม่นยำของการวัด Conversion โดยการเสริมแท็ก Conversion ที่มีอยู่ด้วยข้อมูล Conversion จากบุคคลที่หนึ่ง เช่น อีเมล ชื่อ ที่อยู่บ้าน และหมายเลขโทรศัพท์
ตารางต่อไปนี้แสดงพารามิเตอร์ API ที่เทียบเท่าซึ่งใช้กับประเภท Conversion ที่ปรับปรุงแล้วแต่ละประเภท
| ประเภทการกระทำที่ถือเป็น Conversion | ประเภท Conversion ที่ปรับปรุงแล้ว | คู่มือการตั้งค่า API |
|---|---|---|
UPLOAD_CLICKS |
Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย
ปรับปรุงการวัดธุรกรรมออฟไลน์ที่มาจากโอกาสในการขายบนเว็บไซต์หรือผู้เข้าชมเว็บไซต์ |
ใช้ Data Manager API (แนะนํา) หรือดูจัดการ Conversion การคลิกออฟไลน์สําหรับการผสานรวม Google Ads API ที่มีอยู่ |
WEBPAGE |
Conversion ที่ปรับปรุงแล้วสำหรับเว็บ
ปรับปรุงการวัด Conversion ออนไลน์ |
คู่มือการตั้งค่า API |
ประเภทการกระทำที่ถือเป็น Conversion เพิ่มเติม
Google Ads API มีการกระทำที่ถือเป็น Conversion ประเภทอื่นๆ ให้ใช้งานในรายงาน แต่ก็อาจจำกัดหรือห้ามไม่ให้สร้างหรือแก้ไขการกระทำเหล่านั้น คุณสามารถค้นหาการกระทำที่ถือเป็น Conversion และประเภทของการกระทำดังกล่าวได้โดยใช้ GoogleAdsService ดังนี้
SELECT
conversion_action.id,
conversion_action.name,
conversion_action.type,
conversion_action.status
FROM conversion_action
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 |
วิธีให้เครดิต Attribution สำหรับ 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 |
ตำแหน่งของ Postback ตามลำดับสำหรับ 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 หรือโดเมนแหล่งที่มาหรือแอปแหล่งที่มาไม่ปรากฏใน Postback ที่ 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 |
เวอร์ชัน API ของเครือข่ายโฆษณา StoreKit ของ iOS ที่ใช้ |
Google Analytics
Conversion จากพร็อพเพอร์ตี้ Google Analytics ที่ลิงก์จะมีค่า type ค่าใดค่าหนึ่งต่อไปนี้
Conversion ของพร็อพเพอร์ตี้ GA4:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_ANALYTICS_4_PURCHASE
นอกจากนี้ คุณยังดึงข้อมูลรหัสพร็อพเพอร์ตี้ GA4, ชื่อพร็อพเพอร์ตี้ และชื่อเหตุการณ์จากช่อง
google_analytics_4_settingsได้ด้วย
คุณสามารถทําการเปลี่ยนแปลงต่อไปนี้กับ 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_APP_AD_IMPRESSIONFIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_APP_AD_IMPRESSIONFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
ยอดขายในร้าน: นำเข้าไปยังการกระทำที่ถือเป็น Conversion พร้อมการรายงาน
แม้ว่าคุณจะสร้างการกระทำที่ถือเป็น Conversion STORE_SALES หรือ STORE_SALES_DIRECT_UPLOAD โดยใช้ Google Ads API ไม่ได้ แต่ API รองรับการนำเข้าธุรกรรมยอดขายในร้าน
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
ประเภทการกระทำที่ถือเป็น Conversion แบบอ่านอย่างเดียว
การกระทำที่ถือเป็น Conversion ประเภทต่อไปนี้เป็นแบบอ่านอย่างเดียวใน Google Ads API และมีไว้เพื่อวัตถุประสงค์ในการรายงาน
ANDROID_APP_PRE_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_CODELESS
ไม่ทราบ
หากบัญชี Google Ads มีการกระทำที่ถือเป็น Conversion ประเภทอื่นๆ คุณอาจพบว่าการค้นหาและรายงานแสดงการกระทำที่ถือเป็น Conversion ซึ่ง ConversionAction.type เป็น UNKNOWN API ไม่รองรับการจัดการการกระทำที่ถือเป็น Conversion เหล่านี้ แต่จะแสดงผลในรายงานเพื่อให้ผลลัพธ์ที่สมบูรณ์สำหรับเมตริก Conversion ที่สำคัญ เช่น metrics.conversions และ metrics.conversions_value