Customer

ลูกค้า

การแสดง JSON 
{
  "resourceName": string,
  "callReportingSetting": {
    object (CallReportingSetting)
  },
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "remarketingSetting": {
    object (RemarketingSetting)
  },
  "payPerConversionEligibilityFailureReasons": [
    enum (CustomerPayPerConversionEligibilityFailureReason)
  ],
  "optimizationScoreWeight": number,
  "status": enum (CustomerStatus),
  "customerAgreementSetting": {
    object (CustomerAgreementSetting)
  },
  "localServicesSettings": {
    object (LocalServicesSettings)
  },
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "hasPartnersBadge": boolean,
  "manager": boolean,
  "testAccount": boolean,
  "optimizationScore": number,
  "locationAssetAutoMigrationDone": boolean,
  "imageAssetAutoMigrationDone": boolean,
  "locationAssetAutoMigrationDoneDateTime": string,
  "imageAssetAutoMigrationDoneDateTime": string
}
ช่อง
resourceName

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของลูกค้า ชื่อทรัพยากรของลูกค้าจะอยู่ในรูปแบบต่อไปนี้

customers/{customerId}
callReportingSetting

object (CallReportingSetting)

การตั้งค่าการรายงานจำนวนการโทรเข้าของลูกค้า เปลี่ยนแปลงได้ในการดำเนินการ update เท่านั้น
conversionTrackingSetting

object (ConversionTrackingSetting)

เอาต์พุตเท่านั้น การตั้งค่าเครื่องมือวัด Conversion สำหรับลูกค้า
remarketingSetting

object (RemarketingSetting)

เอาต์พุตเท่านั้น การตั้งค่ารีมาร์เก็ตติ้งสำหรับลูกค้า
payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

เอาต์พุตเท่านั้น เหตุผลที่ลูกค้าไม่มีสิทธิ์ใช้ PaymentMode.CONVERSIONS หากรายการว่างเปล่า แสดงว่าลูกค้ามีสิทธิ์ ช่องนี้เป็นแบบอ่านอย่างเดียว
optimizationScoreWeight

number

เอาต์พุตเท่านั้น น้ำหนักของคะแนนการเพิ่มประสิทธิภาพของลูกค้า

น้ำหนักของคะแนนการเพิ่มประสิทธิภาพสามารถใช้เพื่อเปรียบเทียบ/รวมคะแนนการเพิ่มประสิทธิภาพของลูกค้าที่ไม่ใช่บัญชีดูแลจัดการหลายรายได้ ระบบจะคำนวณคะแนนการเพิ่มประสิทธิภาพโดยรวมของผู้จัดการเป็นยอดรวมของลูกค้าทั้งหมดของบริษัท Customer.optimization_score * Customer.optimization_score_weight ช่องนี้เป็น 0 สำหรับลูกค้าที่เป็นผู้จัดการทั้งหมดและสำหรับลูกค้าที่ไม่ใช่บัญชีดูแลจัดการที่ไม่มีคะแนน

ช่องนี้เป็นแบบอ่านอย่างเดียว
status

enum (CustomerStatus)

เอาต์พุตเท่านั้น สถานะของลูกค้า
customerAgreementSetting

object (CustomerAgreementSetting)

เอาต์พุตเท่านั้น การตั้งค่าข้อตกลงของลูกค้าสำหรับลูกค้า
localServicesSettings

object (LocalServicesSettings)

เอาต์พุตเท่านั้น การตั้งค่าสำหรับลูกค้าบริการในพื้นที่
id

string (int64 format)

เอาต์พุตเท่านั้น รหัสของลูกค้า
descriptiveName

string

ชื่อที่สื่อความหมายซึ่งไม่ซ้ำกันของลูกค้า (ไม่บังคับ)
currencyCode

string

เปลี่ยนแปลงไม่ได้ สกุลเงินที่ใช้ในบัญชี ระบบรองรับรหัสสกุลเงินบางส่วนจากมาตรฐาน ISO 4217
timeZone

string

เปลี่ยนแปลงไม่ได้ รหัสเขตเวลาท้องถิ่นของลูกค้า
trackingUrlTemplate

string

เทมเพลต URL สำหรับการสร้าง URL ติดตามผลจากพารามิเตอร์ เปลี่ยนแปลงได้ในการดำเนินการ update เท่านั้น
finalUrlSuffix

string

เทมเพลต URL สำหรับเพิ่มพารามิเตอร์ต่อท้าย URL สุดท้าย เปลี่ยนแปลงได้ในการดำเนินการ update เท่านั้น
autoTaggingEnabled

boolean

เปิดใช้การติดแท็กอัตโนมัติให้กับลูกค้าหรือไม่
hasPartnersBadge

boolean

เอาต์พุตเท่านั้น ลูกค้ามีป้ายโปรแกรมพาร์ทเนอร์หรือไม่ หากลูกค้าไม่ได้เชื่อมโยงกับโปรแกรม Partners ค่านี้จะเป็นเท็จ ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/partners/answer/3125774
manager

boolean

เอาต์พุตเท่านั้น ลูกค้าเป็นผู้จัดการหรือไม่
testAccount

boolean

เอาต์พุตเท่านั้น ลูกค้าเป็นบัญชีทดสอบหรือไม่
optimizationScore

number

เอาต์พุตเท่านั้น คะแนนการเพิ่มประสิทธิภาพของลูกค้า

คะแนนการเพิ่มประสิทธิภาพคือค่าประมาณว่าแคมเปญของลูกค้ามีความพร้อมในการทำงานดีเพียงใด ซึ่งมีตั้งแต่ 0% (0.0) ถึง 100% (1.0) ช่องนี้เป็นค่าว่างสำหรับลูกค้าที่เป็นผู้จัดการทั้งหมดและสำหรับลูกค้าที่ไม่ใช่บัญชีดูแลจัดการที่ไม่มีคะแนน

ดู "เกี่ยวกับคะแนนการเพิ่มประสิทธิภาพ" ที่ https://support.google.com/google-ads/answer/9061546

ช่องนี้เป็นแบบอ่านอย่างเดียว
locationAssetAutoMigrationDone

boolean

เอาต์พุตเท่านั้น เป็นจริงหากมีการย้ายตำแหน่งตามฟีดไปยังตำแหน่งที่ตั้งตามชิ้นงาน
imageAssetAutoMigrationDone

boolean

เอาต์พุตเท่านั้น เป็นจริงหากมีการย้ายข้อมูลรูปภาพที่อิงตามฟีดไปยังรูปภาพที่อิงตามเนื้อหา
locationAssetAutoMigrationDoneDateTime

string

เอาต์พุตเท่านั้น การประทับเวลาของการย้ายข้อมูลจากตำแหน่งที่ใช้ฟีดไปยังตำแหน่งฐานของชิ้นงานในรูปแบบ yyyy-MM-dd HH:mm:ss
imageAssetAutoMigrationDoneDateTime

string

เอาต์พุตเท่านั้น การประทับเวลาที่ย้ายข้อมูลจากรูปภาพที่ใช้ฟีดไปยังรูปภาพฐานของชิ้นงานในรูปแบบ yyyy-MM-dd HH:mm:ss

CallReportingSetting

การตั้งค่าการรายงานจำนวนการโทรเข้าของลูกค้า เปลี่ยนแปลงได้ในการดำเนินการ update เท่านั้น

การแสดง JSON 
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
ช่อง
callReportingEnabled

boolean

เปิดใช้การรายงานกิจกรรมการโทรโดยการเปลี่ยนเส้นทางผ่านระบบ Google
callConversionReportingEnabled

boolean

จะเปิดใช้การรายงาน Conversion การโทรหรือไม่
callConversionAction

string

การกระทำที่ถือเป็น Conversion การโทรระดับลูกค้าเพื่อระบุแหล่งที่มาของ Conversion การโทร หากไม่ได้ตั้งค่า ระบบจะใช้การกระทำที่ถือเป็น Conversion เริ่มต้น จะมีผลเมื่อตั้งค่า callConversionReportingEnabled เป็น "จริง" เท่านั้น

ConversionTrackingSetting

ชุดการตั้งค่าสำหรับทั้งลูกค้าที่เกี่ยวข้องกับเครื่องมือวัด Conversion ของ Google Ads

การแสดง JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
ช่อง
acceptedCustomerDataTerms

boolean

เอาต์พุตเท่านั้น ลูกค้ายอมรับข้อกําหนดสำหรับข้อมูลลูกค้าหรือไม่ หากใช้เครื่องมือวัด Conversion ข้ามบัญชี ระบบจะรับค่านี้มาจากบัญชีดูแลจัดการ ช่องนี้เป็นแบบอ่านอย่างเดียว ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/adspolicy/answer/7475709
conversionTrackingStatus

enum (ConversionTrackingStatus)

เอาต์พุตเท่านั้น สถานะเครื่องมือวัด Conversion ซึ่งจะระบุว่าลูกค้าใช้เครื่องมือวัด Conversion หรือไม่ และใครเป็นเจ้าของเครื่องมือวัด Conversion ของลูกค้ารายนี้ หากลูกค้ารายนี้ใช้เครื่องมือวัด Conversion ข้ามบัญชี มูลค่าที่แสดงผลจะแตกต่างกันไปตาม login-customer-id ของคำขอ
enhancedConversionsForLeadsEnabled

boolean

เอาต์พุตเท่านั้น ดูว่าลูกค้าเลือกรับ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขายหรือไม่ หากใช้เครื่องมือวัด Conversion ข้ามบัญชี ระบบจะรับค่านี้มาจากบัญชีดูแลจัดการ ช่องนี้เป็นแบบอ่านอย่างเดียว
googleAdsConversionCustomer

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของลูกค้าที่มีการสร้างและจัดการ Conversion ช่องนี้เป็นแบบอ่านอย่างเดียว
conversionTrackingId

string (int64 format)

เอาต์พุตเท่านั้น รหัสเครื่องมือวัด Conversion ที่ใช้สำหรับบัญชีนี้ รหัสนี้ไม่ได้ระบุว่าลูกค้าใช้เครื่องมือวัด Conversion หรือไม่ (conversionTrackingStatus) ช่องนี้เป็นแบบอ่านอย่างเดียว
crossAccountConversionTrackingId

string (int64 format)

เอาต์พุตเท่านั้น รหัสเครื่องมือวัด Conversion ของผู้จัดการของลูกค้า ระบบจะตั้งค่านี้เมื่อลูกค้าเลือกใช้เครื่องมือวัด Conversion ข้ามบัญชี และจะลบล้าง conversionTrackingId ช่องนี้จะจัดการได้ผ่าน UI ของ Google Ads เท่านั้น ช่องนี้เป็นแบบอ่านอย่างเดียว

ConversionTrackingStatus

สถานะเครื่องมือวัด Conversion ของลูกค้า

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับผลลัพธ์เท่านั้น แสดงถึงค่าที่ไม่รู้จักในเวอร์ชันนี้
NOT_CONVERSION_TRACKED ลูกค้าไม่ได้ใช้เครื่องมือวัด Conversion ใดๆ
CONVERSION_TRACKING_MANAGED_BY_SELF การกระทำที่ถือเป็น Conversion สร้างและจัดการโดยลูกค้ารายนี้
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER การกระทำที่ถือเป็น Conversion สร้างขึ้นและจัดการโดยผู้จัดการที่ระบุไว้ใน login-customer-id ของคำขอ
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER การกระทำที่ถือเป็น Conversion สร้างและจัดการโดยผู้จัดการซึ่งต่างจากลูกค้าหรือผู้จัดการที่ระบุไว้ใน login-customer-id ของคำขอ

RemarketingSetting

การตั้งค่ารีมาร์เก็ตติ้งสำหรับลูกค้า

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

string

เอาต์พุตเท่านั้น แท็ก Google

CustomerPayPerConversionEligibilityFailureReason

อธิบายเหตุผลที่เป็นไปได้ที่ลูกค้าไม่มีสิทธิ์ใช้ PaymentMode.CONVERSIONS

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับผลลัพธ์เท่านั้น แสดงถึงค่าที่ไม่รู้จักในเวอร์ชันนี้
NOT_ENOUGH_CONVERSIONS ลูกค้ามี Conversion ไม่มากพอ
CONVERSION_LAG_TOO_HIGH เวลาหน่วงของ Conversion ของลูกค้าสูงเกินไป
HAS_CAMPAIGN_WITH_SHARED_BUDGET ลูกค้าใช้งบประมาณที่ใช้ร่วมกัน
HAS_UPLOAD_CLICKS_CONVERSION ลูกค้ามี Conversion ที่มี ConversionActionType.UPLOAD_CLICKS
AVERAGE_DAILY_SPEND_TOO_HIGH ค่าใช้จ่ายรายวันเฉลี่ยของลูกค้าสูงเกินไป
ANALYSIS_NOT_COMPLETE แบ็กเอนด์ของ Google Ads ยังไม่ได้คำนวณการมีสิทธิ์ของลูกค้า โปรดกลับมาใหม่ในภายหลัง
OTHER ลูกค้าไม่มีสิทธิ์เนื่องจากเหตุผลอื่น

CustomerAgreementSetting

การตั้งค่าข้อตกลงของลูกค้าสำหรับลูกค้า

การแสดง JSON 
{
  "acceptedLeadFormTerms": boolean
}
ช่อง
acceptedLeadFormTerms

boolean

เอาต์พุตเท่านั้น ลูกค้ายอมรับข้อกำหนดในการให้บริการของโฆษณาแบบกรอกฟอร์มแล้วหรือไม่

LocalServicesSettings

การตั้งค่าสำหรับลูกค้าบริการในพื้นที่

การแสดง JSON 
{
  "granularLicenseStatuses": [
    {
      object (GranularLicenseStatus)
    }
  ],
  "granularInsuranceStatuses": [
    {
      object (GranularInsuranceStatus)
    }
  ]
}
ช่อง
granularLicenseStatuses[]

object (GranularLicenseStatus)

เอาต์พุตเท่านั้น รายการแบบอ่านอย่างเดียวของสถานะใบอนุญาตระดับประเภทธุรกิจทางภูมิศาสตร์
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

เอาต์พุตเท่านั้น รายการสถานะการประกันระดับประเภทธุรกิจทางภูมิศาสตร์แบบอ่านอย่างเดียว

GranularLicenseStatus

สถานะใบอนุญาตที่ระดับภูมิศาสตร์และประเภทธุรกิจ

การแสดง JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
ช่อง
geoCriterionId

string (int64 format)

เอาต์พุตเท่านั้น รหัสเกณฑ์เป้าหมายทางภูมิศาสตร์ที่เชื่อมโยงกับสถานะ อาจเป็นได้ในระดับภูมิศาสตร์ของประเทศหรือรัฐ/จังหวัด ขึ้นอยู่กับข้อกำหนดและสถานที่ตั้ง ดูข้อมูลเพิ่มเติมได้ที่ https://developers.google.com/google-ads/api/data/geotargets
categoryId

string

เอาต์พุตเท่านั้น หมวดหมู่บริการที่เชื่อมโยงกับสถานะ เช่น xcat:service_area_business_ช่างประปา โปรดดูรายละเอียดเพิ่มเติมที่ https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus

enum (LocalServicesVerificationStatus)

เอาต์พุตเท่านั้น สถานะใบอนุญาตแบบละเอียดต่อภูมิศาสตร์และประเภทธุรกิจ

LocalServicesVerificationStatus

ข้อมูลที่อธิบายสถานะของหมวดหมู่การยืนยันโฆษณาบริการในพื้นที่ที่เจาะจง

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN สถานะการยืนยันที่ไม่รู้จัก
NEEDS_REVIEW เริ่มการยืนยันแล้วแต่ยังไม่เสร็จสิ้น
FAILED การยืนยันล้มเหลว
PASSED การยืนยันผ่านแล้ว
NOT_APPLICABLE ไม่สามารถยืนยันได้
NO_SUBMISSION ต้องมีการยืนยันแต่รอการส่ง
PARTIAL_SUBMISSION ระบบไม่ได้ส่งการยืนยันที่จําเป็นบางรายการ
PENDING_ESCALATION การยืนยันต้องได้รับการตรวจสอบโดยผู้เชี่ยวชาญปฏิบัติการด้านโฆษณาบริการในพื้นที่

GranularInsuranceStatus

สถานะการประกันในระดับภูมิศาสตร์และประเภทธุรกิจ

การแสดง JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
ช่อง
geoCriterionId

string (int64 format)

เอาต์พุตเท่านั้น รหัสเกณฑ์เป้าหมายทางภูมิศาสตร์ที่เชื่อมโยงกับสถานะ อาจเป็นได้ในระดับภูมิศาสตร์ของประเทศหรือรัฐ/จังหวัด ขึ้นอยู่กับข้อกำหนดและสถานที่ตั้ง ดูข้อมูลเพิ่มเติมได้ที่ https://developers.google.com/google-ads/api/data/geotargets
categoryId

string

เอาต์พุตเท่านั้น หมวดหมู่บริการที่เชื่อมโยงกับสถานะ เช่น xcat:service_area_business_ช่างประปา โปรดดูรายละเอียดเพิ่มเติมที่ https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus

enum (LocalServicesVerificationStatus)

เอาต์พุตเท่านั้น สถานะการประกันแบบละเอียดต่อภูมิศาสตร์และประเภทธุรกิจ