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)

출력 전용. 고객에 대한 전환 추적 설정
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)

출력 전용. 고객의 ID입니다.
descriptiveName

string

고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다.
currencyCode

string

변경할 수 없습니다. 계정에 사용되는 통화입니다. ISO 4217 표준의 통화 코드 중 일부가 지원됩니다.
timeZone

string

변경할 수 없습니다. 고객의 현지 시간대 ID입니다.
trackingUrlTemplate

string

매개변수로 추적 URL을 작성하기 위한 URL 템플릿입니다. update 작업에서만 변경 가능합니다.
finalUrlSuffix

string

최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다. update 작업에서만 변경 가능합니다.
autoTaggingEnabled

boolean

고객에 대해 자동 태그 추가의 사용 설정 여부입니다.
hasPartnersBadge

boolean

출력 전용. '고객'의 파트너 프로그램 배지 보유 여부 '고객'이 파트너 프로그램과 연결되어 있지 않은 경우 이는 거짓입니다. 자세한 내용은 https://support.google.com/partners/answer/3125774를 참고하세요.
manager

boolean

출력 전용. 고객이 관리자인지 여부입니다.
testAccount

boolean

출력 전용. 고객이 테스트 계정인지 여부
optimizationScore

number

출력 전용. 고객의 최적화 점수입니다.

최적화 점수는 고객의 캠페인이 얼마나 좋은 실적을 낼 수 있을지를 추정한 수치입니다. 범위는 0% (0.0)~100% (1.0)입니다. 모든 관리자 고객과 점수가 없는 비 관리자 고객의 경우 이 필드는 null입니다.

https://support.google.com/google-ads/answer/9061546에서 '최적화 점수 정보'를 참조하세요.

이 필드는 읽기 전용입니다.
locationAssetAutoMigrationDone

boolean

출력 전용. 피드 기반 위치가 확장 소재 기반 위치로 이전된 경우 true입니다.
imageAssetAutoMigrationDone

boolean

출력 전용. 피드 기반 이미지가 확장 소재 기반 이미지로 이전된 경우 true입니다.
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

통화 전환 보고의 사용 설정 여부입니다.
callConversionAction

string

통화 전환에 대한 기여도를 부여할 고객 수준 통화 전환 액션입니다. 설정하지 않으면 기본 전환 액션이 사용됩니다. callConversionReportingEnabled가 true로 설정된 경우에만 적용됩니다.

ConversionTrackingSetting

Google Ads 전환 추적과 관련된 고객 전체 설정의 모음입니다.

JSON 표현 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
필드
acceptedCustomerDataTerms

boolean

출력 전용. 고객이 고객 데이터 약관에 동의했는지 여부입니다. 교차 계정 전환 추적을 사용하는 경우 관리자로부터 이 값이 상속됩니다. 이 필드는 읽기 전용입니다. 자세한 내용은 다음 페이지를 참고하세요.https://support.google.com/adspolicy/answer/7475709
conversionTrackingStatus

enum (ConversionTrackingStatus)

출력 전용. 전환 추적 상태 고객이 전환 추적을 사용하고 있는지, 그리고 이 고객의 전환 추적 소유자가 누구인지를 나타냅니다. 이 고객이 교차 계정 전환 추적을 사용 중인 경우 반환되는 값은 요청의 login-customer-id에 따라 달라집니다.
enhancedConversionsForLeadsEnabled

boolean

출력 전용. 고객이 리드 확보용 향상된 전환을 선택했는지 여부 교차 계정 전환 추적을 사용하는 경우 관리자로부터 이 값이 상속됩니다. 이 필드는 읽기 전용입니다.
googleAdsConversionCustomer

string

출력 전용. 전환이 생성되고 관리되는 고객의 리소스 이름입니다. 이 필드는 읽기 전용입니다.
conversionTrackingId

string (int64 format)

출력 전용. 이 계정에 사용된 전환 추적 ID입니다. 이 ID는 고객이 전환 추적을 사용하는지 여부를 나타내지 않습니다 (conversionTrackingStatus). 이 필드는 읽기 전용입니다.
crossAccountConversionTrackingId

string (int64 format)

출력 전용. 고객 관리자의 전환 추적 ID입니다. 고객이 교차 계정 전환 추적을 선택한 경우 설정되며 conversionTrackingId보다 우선 적용됩니다. 이 필드는 Google Ads UI를 통해서만 관리할 수 있습니다. 이 필드는 읽기 전용입니다.

ConversionTrackingStatus

고객의 전환 추적 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
NOT_CONVERSION_TRACKED 고객이 전환 추적을 사용하지 않습니다.
CONVERSION_TRACKING_MANAGED_BY_SELF 전환 액션은 이 고객이 만들고 관리합니다.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER 전환 액션은 요청의 login-customer-id에 지정된 관리자가 만들고 관리합니다.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER 전환 액션은 요청의 login-customer-id에 지정된 고객 또는 관리자가 아닌 관리자가 만들고 관리합니다.

RemarketingSetting

고객의 리마케팅 설정입니다.

JSON 표현 
{
  "googleGlobalSiteTag": string
}
필드
googleGlobalSiteTag

string

출력 전용. Google 태그

CustomerPayPerConversionEligibilityFailureReason

고객이 PaymentMode.CONVERSIONS를 사용할 수 없는 가능한 이유를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
NOT_ENOUGH_CONVERSIONS 고객의 전환수가 충분하지 않습니다.
CONVERSION_LAG_TOO_HIGH 고객의 전환 지연시간이 너무 높습니다.
HAS_CAMPAIGN_WITH_SHARED_BUDGET 고객이 공유 예산을 사용합니다.
HAS_UPLOAD_CLICKS_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)

출력 전용. 상태와 연결된 지역 타겟팅 기준 ID입니다. 요구사항 및 위치에 따라 국가 또는 주/도의 지역 수준일 수 있습니다. 자세한 내용은 https://developers.google.com/google-ads/api/data/geotargets를 참조하세요.
categoryId

string

출력 전용. 상태와 연결된 서비스 카테고리입니다. 예를 들면 xcat:service_area_business_plumber입니다. 자세한 내용은 https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids를 참고하세요.
verificationStatus

enum (LocalServicesVerificationStatus)

출력 전용. 지역 및 카테고리별 세분화된 라이선스 상태

LocalServicesVerificationStatus

특정 지역 서비스 광고 인증 카테고리의 상태를 설명하는 열거형입니다.

열거형
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)

출력 전용. 상태와 연결된 지역 타겟팅 기준 ID입니다. 요구사항 및 위치에 따라 국가 또는 주/도의 지역 수준일 수 있습니다. 자세한 내용은 https://developers.google.com/google-ads/api/data/geotargets를 참조하세요.
categoryId

string

출력 전용. 상태와 연결된 서비스 카테고리입니다. 예를 들면 xcat:service_area_business_plumber입니다. 자세한 내용은 https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids를 참고하세요.
verificationStatus

enum (LocalServicesVerificationStatus)

출력 전용. 지역 및 카테고리별 상세한 보험 상태