ConversionAction

การกระทำที่ถือเป็น Conversion

การแสดง JSON 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
ช่อง
resourceName

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของการกระทำที่ถือเป็น Conversion ชื่อทรัพยากรการกระทำที่ถือเป็น Conversion มีรูปแบบดังนี้

customers/{customerId}/conversionActions/{conversion_action_id}
status

enum (ConversionActionStatus)

สถานะของการกระทําที่ถือเป็น Conversion นี้สําหรับการได้รับเหตุการณ์ Conversion
type

enum (ConversionActionType)

เปลี่ยนแปลงไม่ได้ ประเภทของการกระทำที่ถือเป็น Conversion นี้
origin

enum (ConversionOrigin)

เอาต์พุตเท่านั้น ต้นทาง Conversion ของการกระทำที่ถือเป็น Conversion นี้
category

enum (ConversionActionCategory)

หมวดหมู่ของ Conversion ที่รายงานสําหรับการกระทําที่ถือเป็น Conversion นี้
valueSettings

object (ValueSettings)

การตั้งค่าที่เกี่ยวข้องกับมูลค่าของเหตุการณ์ Conversion ที่เชื่อมโยงกับการกระทำที่ถือเป็น Conversion นี้
countingType

enum (ConversionActionCountingType)

วิธีนับเหตุการณ์ Conversion สําหรับการกระทําที่ถือเป็น Conversion
attributionModelSettings

object (AttributionModelSettings)

การตั้งค่าที่เกี่ยวข้องกับรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้
tagSnippets[]

object (TagSnippet)

เอาต์พุตเท่านั้น ข้อมูลโค้ดที่ใช้สำหรับติดตาม Conversion
mobileAppVendor

enum (MobileAppVendor)

เอาต์พุตเท่านั้น ผู้ให้บริการแอปบนอุปกรณ์เคลื่อนที่สำหรับการกระทำที่ถือเป็น Conversion ของแอป
firebaseSettings

object (FirebaseSettings)

เอาต์พุตเท่านั้น การตั้งค่า Firebase สำหรับประเภท Conversion ของ Firebase
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

เอาต์พุตเท่านั้น การตั้งค่าการวิเคราะห์แอปของบุคคลที่สามสำหรับประเภท Conversion ของบุคคลที่สาม
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

เอาต์พุตเท่านั้น การตั้งค่า Google Analytics 4 สําหรับประเภท Conversion ของ Google Analytics 4
id

string (int64 format)

เอาต์พุตเท่านั้น รหัสของการกระทำที่ถือเป็น Conversion
name

string

ชื่อของการกระทำที่ถือเป็น Conversion

ต้องระบุข้อมูลในช่องนี้เมื่อสร้างการกระทำที่ถือเป็น Conversion รายการใหม่
primaryForGoal

boolean

หากบิต PrimaryForGoal ของการกระทําที่ถือเป็น Conversion เป็นเท็จ การกระทําที่ถือเป็น Conversion ดังกล่าวจะเสนอราคาไม่ได้สําหรับแคมเปญทั้งหมด ไม่ว่าเป้าหมาย Conversion ของลูกค้าหรือเป้าหมาย Conversion ของแคมเปญจะเป็นอะไรก็ตาม อย่างไรก็ตาม เป้าหมาย Conversion ที่กำหนดเองจะไม่ดำเนินการตามโดเมนหลักเพื่อเป้าหมาย ดังนั้นหากแคมเปญมีเป้าหมาย Conversion ที่กำหนดเองซึ่งกำหนดค่าด้วย primaryForGoal = การกระทำที่ถือเป็น Conversion ที่เป็นเท็จ การกระทำที่ถือเป็น Conversion นั้นก็ยังคงเสนอราคาได้ ตามค่าเริ่มต้น primaryForGoal จะเป็น "จริง" หากไม่ได้ตั้งค่าไว้ ใน V9 คุณสามารถตั้งค่า primaryForGoal เป็น "เท็จ" ได้หลังจากที่สร้างผ่านการดำเนินการ "อัปเดต" เท่านั้น เนื่องจากไม่มีการประกาศว่าไม่บังคับ
ownerCustomer

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของลูกค้าที่เป็นเจ้าของการกระทำที่ถือเป็น Conversion หรือค่า Null หากเป็นการกระทำที่ถือเป็น Conversion ที่ระบบกำหนด
includeInConversionsMetric

boolean

ควรรวมการกระทำที่ถือเป็น Conversion นี้ไว้ในเมตริก "Conversion" หรือไม่
clickThroughLookbackWindowDays

string (int64 format)

จํานวนวันสูงสุดที่อาจผ่านไประหว่างการโต้ตอบ (เช่น การคลิก) กับเหตุการณ์ Conversion
viewThroughLookbackWindowDays

string (int64 format)

จำนวนวันสูงสุดที่อาจผ่านไประหว่างการแสดงผลและ Conversion โดยไม่มีการโต้ตอบ
phoneCallDurationSeconds

string (int64 format)

ระยะเวลาการโทรเป็นวินาทีหลังจากที่มีการรายงาน Conversion สำหรับการกระทำที่ถือเป็น Conversion นี้

ค่าโดยรวมต้องอยู่ระหว่าง 0 ถึง 10, 000
appId

string

รหัสแอปสำหรับการกระทำที่ถือเป็น Conversion ของแอป

ConversionActionStatus

สถานะที่เป็นไปได้ของการกระทําที่ถือเป็น Conversion

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ENABLED ระบบจะบันทึก Conversion
REMOVED ระบบจะไม่บันทึก Conversion
HIDDEN ระบบจะไม่บันทึก Conversion และการกระทําที่ถือเป็น Conversion จะไม่ปรากฏใน UI

ConversionActionType

ประเภทการกระทำที่ถือเป็น Conversion ที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AD_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้คลิกส่วนขยายการโทรของโฆษณา
CLICK_TO_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้บนอุปกรณ์เคลื่อนที่คลิกหมายเลขโทรศัพท์
GOOGLE_PLAY_DOWNLOAD Conversion ที่เกิดขึ้นเมื่อผู้ใช้ดาวน์โหลดแอปบนอุปกรณ์เคลื่อนที่จาก Google Play Store
GOOGLE_PLAY_IN_APP_PURCHASE Conversion ที่เกิดขึ้นเมื่อผู้ใช้ทำการซื้อในแอปผ่านการเรียกเก็บเงินของ Android
UPLOAD_CALLS Conversion การโทรที่ได้รับการติดตามโดยผู้ลงโฆษณาและอัปโหลด
UPLOAD_CLICKS Conversion ที่ผู้ลงโฆษณาติดตามและอัปโหลดด้วยการคลิกที่มีการระบุแหล่งที่มา
WEBPAGE Conversion ที่เกิดขึ้นในหน้าเว็บ
WEBSITE_CALL Conversion ที่เกิดขึ้นเมื่อผู้ใช้โทรไปยังหมายเลขโทรศัพท์ที่สร้างขึ้นแบบไดนามิกจากเว็บไซต์ของผู้ลงโฆษณา
STORE_SALES_DIRECT_UPLOAD Conversion ยอดขายในร้านตามการอัปโหลดข้อมูลผู้ขายของบุคคลที่หนึ่งหรือบุคคลที่สาม เฉพาะลูกค้าที่อยู่ในรายการที่อนุญาตเท่านั้นที่จะใช้ประเภทการอัปโหลดยอดขายในร้านโดยตรงได้
STORE_SALES Conversion ยอดขายในร้านตามการอัปโหลดข้อมูลผู้ขายของบุคคลที่หนึ่งหรือบุคคลที่สามและ/หรือจากการซื้อในร้านค้าโดยใช้บัตรจากเครือข่ายการชำระเงิน เฉพาะลูกค้าในรายการที่อนุญาตเท่านั้นที่จะใช้ประเภทยอดขายในร้านได้ อ่านอย่างเดียว
FIREBASE_ANDROID_FIRST_OPEN แอป Android ที่เปิด Conversion ที่ติดตามผ่าน Firebase เป็นครั้งแรก
FIREBASE_ANDROID_IN_APP_PURCHASE Conversion การซื้อในแอป Android ที่ติดตามผ่าน Firebase
FIREBASE_ANDROID_CUSTOM Conversion ที่กำหนดเองของแอป Android ที่ติดตามผ่าน Firebase
FIREBASE_IOS_FIRST_OPEN Conversion การเปิดในแอป iOS ครั้งแรกซึ่งติดตามผ่าน Firebase
FIREBASE_IOS_IN_APP_PURCHASE Conversion การซื้อในแอป iOS ที่ติดตามผ่าน Firebase
FIREBASE_IOS_CUSTOM Conversion ที่กำหนดเองของแอป iOS ที่ติดตามผ่าน Firebase
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversion การเปิดแอป Android ครั้งแรกที่มีการติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversion การซื้อในแอป Android ที่มีการติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversion ที่กำหนดเองของแอป Android ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversion การเปิดในแอป iOS ครั้งแรกที่มีการติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversion การซื้อในแอป iOS ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Conversion ที่กำหนดเองของแอป iOS ที่ติดตามผ่านการวิเคราะห์แอปของบุคคลที่สาม
ANDROID_APP_PRE_REGISTRATION Conversion ที่เกิดขึ้นเมื่อผู้ใช้ลงทะเบียนล่วงหน้าสำหรับแอปบนอุปกรณ์เคลื่อนที่จาก Google Play Store อ่านอย่างเดียว
ANDROID_INSTALLS_ALL_OTHER_APPS Conversion ที่ติดตามการดาวน์โหลดทั้งหมดใน Google Play ซึ่งไม่ได้ติดตามโดยประเภทแอปเฉพาะ อ่านอย่างเดียว
FLOODLIGHT_ACTION กิจกรรม Floodlight ซึ่งนับจำนวนครั้งที่ผู้ใช้เข้าชมหน้าเว็บใดหน้าเว็บหนึ่งหลังจากเห็นหรือคลิกโฆษณาของผู้ลงโฆษณา อ่านอย่างเดียว
FLOODLIGHT_TRANSACTION กิจกรรม Floodlight ที่ติดตามจำนวนการขายที่เกิดขึ้นหรือจำนวนสินค้าที่ซื้อ รวมถึงดูมูลค่ารวมของการขายแต่ละครั้งได้ด้วย อ่านอย่างเดียว
GOOGLE_HOSTED Conversion ที่ติดตามการกระทำเกี่ยวกับสถานที่จากผลิตภัณฑ์และบริการของ Google หลังจากโต้ตอบกับโฆษณา อ่านอย่างเดียว
LEAD_FORM_SUBMIT Conversion ที่รายงานเมื่อผู้ใช้ส่งโฆษณาแบบกรอกฟอร์ม อ่านอย่างเดียว
SALESFORCE Conversion ที่มาจาก Salesforce อ่านอย่างเดียว
SEARCH_ADS_360 Conversion ที่นำเข้าจากข้อมูล Floodlight ของ Search Ads 360 อ่านอย่างเดียว
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Conversion การโทรที่เกิดขึ้นใน Smart Campaign Ads โดยไม่ต้องตั้งค่าการติดตามการโทร โดยใช้เกณฑ์ที่กำหนดเองของ Smart Campaign อ่านอย่างเดียว
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL ผู้ใช้คลิกที่องค์ประกอบการโทรภายใน Google Maps Smart Campaign เท่านั้น อ่านอย่างเดียว
SMART_CAMPAIGN_MAP_DIRECTIONS ผู้ใช้ขอเส้นทางไปยังที่ตั้งธุรกิจภายใน Google Maps Smart Campaign เท่านั้น อ่านอย่างเดียว
SMART_CAMPAIGN_TRACKED_CALLS Conversion การโทรที่เกิดขึ้นใน Smart Campaign Ads ที่มีการตั้งค่าการติดตามการโทร โดยใช้เกณฑ์ที่กำหนดเองของ Smart Campaign อ่านอย่างเดียว
STORE_VISITS Conversion ที่เกิดขึ้นเมื่อผู้ใช้เข้าชมร้านค้าปลีกของผู้ลงโฆษณา อ่านอย่างเดียว
WEBPAGE_CODELESS Conversion ที่สร้างขึ้นจากเหตุการณ์ในเว็บไซต์ (เช่น การส่งแบบฟอร์มหรือการโหลดหน้าเว็บ) ที่ไม่ได้ใช้ข้อมูลโค้ดเหตุการณ์ที่เขียนโค้ดแต่ละรายการ อ่านอย่างเดียว
UNIVERSAL_ANALYTICS_GOAL Conversion ที่มาจากเป้าหมาย Universal Analytics ที่ลิงก์
UNIVERSAL_ANALYTICS_TRANSACTION Conversion ที่มาจากธุรกรรม Universal Analytics ที่ลิงก์
GOOGLE_ANALYTICS_4_CUSTOM Conversion ที่มาจาก Conversion เหตุการณ์ที่กําหนดเองของ Google Analytics 4 ที่ลิงก์ไว้
GOOGLE_ANALYTICS_4_PURCHASE Conversion ที่มาจาก Conversion การซื้อของ Google Analytics 4 ที่ลิงก์ไว้

ValueSettings

การตั้งค่าที่เกี่ยวข้องกับมูลค่าของเหตุการณ์ Conversion ที่เชื่อมโยงกับการกระทำที่ถือเป็น Conversion นี้

การแสดง JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
ช่อง
defaultValue

number

ค่าที่จะใช้เมื่อมีการส่งเหตุการณ์ Conversion สําหรับการกระทําที่ถือเป็น Conversion นี้พร้อมด้วยค่าที่ไม่ถูกต้อง ไม่ได้รับอนุญาต หรือขาดหายไป หรือเมื่อการกระทําที่ถือเป็น Conversion นี้ได้รับการกําหนดค่าให้ใช้ค่าเริ่มต้นเสมอ
defaultCurrencyCode

string

รหัสสกุลเงินที่จะใช้เมื่อมีการส่งเหตุการณ์ Conversion สําหรับการกระทําที่ถือเป็น Conversion นี้พร้อมกับรหัสสกุลเงินที่ไม่ถูกต้องหรือขาดหายไป หรือเมื่อการกระทําที่ถือเป็น Conversion นี้ได้รับการกําหนดค่าให้ใช้ค่าเริ่มต้นเสมอ
alwaysUseDefaultValue

boolean

ควบคุมว่าจะใช้มูลค่าเริ่มต้นและรหัสสกุลเงินเริ่มต้นแทนค่าและรหัสสกุลเงินที่ระบุในเหตุการณ์ Conversion สําหรับการกระทําที่ถือเป็น Conversion นี้หรือไม่

ConversionActionCountingType

ระบุวิธีที่จะนับ Conversion สำหรับการกระทำนี้ ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/google-ads/answer/3438531

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
ONE_PER_CLICK นับเพียง 1 Conversion ต่อคลิก
MANY_PER_CLICK นับ Conversion ทั้งหมดต่อคลิก

AttributionModelSettings

การตั้งค่าที่เกี่ยวข้องกับรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้

การแสดง JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
ช่อง
attributionModel

enum (AttributionModel)

ประเภทรูปแบบการระบุแหล่งที่มาของการกระทำที่ถือเป็น Conversion นี้
dataDrivenModelStatus

enum (DataDrivenModelStatus)

เอาต์พุตเท่านั้น สถานะของรูปแบบการระบุแหล่งที่มาโดยอิงตามข้อมูลสำหรับการกระทำที่ถือเป็น Conversion

AttributionModel

รูปแบบการระบุแหล่งที่มาที่อธิบายวิธีกระจายเครดิตสำหรับ Conversion หนึ่งๆ ไปยังการโต้ตอบที่เป็นไปได้หลายรายการ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
EXTERNAL ใช้การระบุแหล่งที่มาภายนอก
GOOGLE_ADS_LAST_CLICK ให้เครดิตทั้งหมดสำหรับ Conversion หนึ่งๆ เป็นคลิกสุดท้าย
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK ระบุแหล่งที่มาของเครดิตทั้งหมดสำหรับ Conversion หนึ่งๆ เป็นคลิกแรกโดยใช้การระบุแหล่งที่มาของ Google Search
GOOGLE_SEARCH_ATTRIBUTION_LINEAR ให้เครดิตสำหรับ Conversion แก่คลิกทั้งหมดอย่างเท่าเทียมกันโดยใช้การระบุแหล่งที่มาของ Google Search
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY ให้เครดิตแก่ Conversion หนึ่งๆ แก่คลิกล่าสุดเพิ่มขึ้นแบบทวีคูณโดยใช้การระบุแหล่งที่มาของ Google Search (ครึ่งชีวิตคือ 1 สัปดาห์)
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED ให้เครดิต 40% ของ Conversion แก่คลิกแรกและคลิกสุดท้าย 20% ที่เหลืออีก 20% จะกระจายให้กับคลิกอื่นๆ ทั้งหมดเท่าๆ กัน การดําเนินการนี้ใช้การระบุแหล่งที่มาของ Google Search
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN รูปแบบที่ยืดหยุ่นที่ใช้แมชชีนเลิร์นนิงเพื่อกำหนดการกระจายเครดิตที่เหมาะสมให้กับการคลิกโดยใช้การระบุแหล่งที่มาของ Google Search

DataDrivenModelStatus

แจกแจงสถานะของรูปแบบที่อิงตามข้อมูล

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
AVAILABLE รูปแบบการระบุแหล่งที่มาโดยอิงตามข้อมูลพร้อมใช้งาน
STALE รูปแบบการระบุแหล่งที่มาจากข้อมูลไม่มีอัปเดต แต่ไม่ได้อัปเดตมาเป็นเวลาอย่างน้อย 7 วันแล้ว เนื่องจากยังคงมีการใช้อยู่ แต่จะหมดอายุหากไม่อัปเดตเป็นเวลา 30 วัน
EXPIRED รูปแบบที่มาจากข้อมูลหมดอายุแล้ว โดยไม่ได้อัปเดตเป็นเวลาอย่างน้อย 30 วันและไม่สามารถใช้ได้ สาเหตุที่พบบ่อยที่สุดคือเพราะในช่วง 30 วันที่ผ่านมาไม่มีจํานวนเหตุการณ์ที่จําเป็น
NEVER_GENERATED ไม่เคยมีการสร้างรูปแบบที่อิงตามข้อมูล ที่พบบ่อยที่สุดเนื่องจากในช่วง 30 วันไม่เคยมีจํานวนกิจกรรมตามที่กำหนดเลย

FirebaseSettings

การตั้งค่าที่เกี่ยวข้องกับการกระทำที่ถือเป็น Conversion ของ Firebase

การแสดง JSON 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
ช่อง
propertyId

string (int64 format)

เอาต์พุตเท่านั้น รหัสพร็อพเพอร์ตี้ GA ของ Conversion
propertyName

string

เอาต์พุตเท่านั้น ชื่อพร็อพเพอร์ตี้ GA ของ Conversion
eventName

string

เอาต์พุตเท่านั้น ชื่อเหตุการณ์ของ Conversion ของ Firebase
projectId

string

เอาต์พุตเท่านั้น รหัสโปรเจ็กต์ Firebase ของ Conversion

ThirdPartyAppAnalyticsSettings

การตั้งค่าที่เกี่ยวข้องกับการกระทำที่ถือเป็น Conversion ของการวิเคราะห์แอปจากบุคคลที่สาม

การแสดง JSON 
{
  "providerName": string,
  "eventName": string
}
ช่อง
providerName

string

เอาต์พุตเท่านั้น ชื่อของผู้ให้บริการวิเคราะห์แอปบุคคลที่สาม
eventName

string

เอาต์พุตเท่านั้น ชื่อเหตุการณ์ของ Conversion ของการวิเคราะห์แอปจากบุคคลที่สาม

GoogleAnalytics4Settings

การตั้งค่าที่เกี่ยวข้องกับการกระทําที่ถือเป็น Conversion ของ Google Analytics 4

การแสดง JSON 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
ช่อง
eventName

string

เอาต์พุตเท่านั้น ชื่อเหตุการณ์ GA 4
propertyName

string

เอาต์พุตเท่านั้น ชื่อพร็อพเพอร์ตี้ GA 4
propertyId

string (int64 format)

เอาต์พุตเท่านั้น รหัสของพร็อพเพอร์ตี้ GA 4