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 ที่กำหนดเองจะไม่ดำเนินการตาม primaryForGoal ดังนั้นหากแคมเปญมีเป้าหมาย Conversion ที่กำหนดเองซึ่งกำหนดค่าด้วย primaryForGoal = การกระทำที่ถือเป็น Conversion เท็จ การกระทำที่ถือเป็น Conversion นั้นก็จะยังเสนอราคาได้ โดยค่าเริ่มต้น primaryForGoal จะเป็นจริงหากไม่ได้ตั้งค่าไว้ ใน V9 คุณสามารถตั้งค่า primaryForGoal เป็น false หลังจากสร้างผ่านการดำเนินการ 'update' เท่านั้น เพราะไม่ได้ประกาศว่าไม่บังคับ
ownerCustomer

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของลูกค้าที่เป็นเจ้าของการกระทำที่ถือเป็น Conversion หรือค่าว่างหากเป็นการกระทำที่ถือเป็น 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 Conversion การเปิดแอป Android ครั้งแรกที่มีการติดตามผ่าน Firebase
FIREBASE_ANDROID_IN_APP_PURCHASE Conversion การซื้อในแอปสำหรับแอป Android ที่ติดตามผ่าน Firebase
FIREBASE_ANDROID_CUSTOM Conversion ที่กำหนดเองของแอป Android ที่ติดตามผ่าน Firebase
FIREBASE_IOS_FIRST_OPEN Conversion การเปิดแอปครั้งแรกซึ่งติดตามผ่าน 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 ที่นำเข้าจากข้อมูล Search Ads 360 Floodlight อ่านอย่างเดียว
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Conversion การโทรที่เกิดขึ้นในโฆษณาของ Smart Campaign โดยไม่ต้องตั้งค่าการติดตามการโทร โดยใช้เกณฑ์ที่กำหนดเองของ 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 ที่มีการตั้งค่าการติดตามการโทรโดยใช้เกณฑ์ที่กำหนดเองของ 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% จะกระจายให้กับคลิกอื่นๆ ทั้งหมดเท่าๆ กัน การดำเนินการนี้จะใช้การระบุแหล่งที่มาของ Google Search
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN รูปแบบที่ยืดหยุ่นซึ่งใช้แมชชีนเลิร์นนิงเพื่อกำหนดการกระจายเครดิตที่เหมาะสมให้กับการคลิกโดยใช้การระบุแหล่งที่มาของ Google Search

DataDrivenModelStatus

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

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