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)
  },
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "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.CONVERSION หากรายการว่างเปล่า แสดงว่าลูกค้ามีสิทธิ์ ช่องนี้เป็นแบบอ่านอย่างเดียว
optimizationScoreWeight

number

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

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

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

enum (CustomerStatus)

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

object (CustomerAgreementSetting)

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

object (LocalServicesSettings)

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

enum (BrandSafetySuitability)

เอาต์พุตเท่านั้น การตั้งค่าความปลอดภัยของแบรนด์ที่ระดับบัญชี ให้คุณเลือกประเภทพื้นที่โฆษณาเพื่อแสดงโฆษณาในเนื้อหาที่เหมาะกับแบรนด์ ดู https://support.google.com/google-ads/answer/7515513
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 เท่านั้น ช่องนี้เป็นแบบอ่านอย่างเดียว

RemarketingSetting

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

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

string

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

CustomerPayPerConversionEligibilityFailureReason

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

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)

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