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)

出力専用。顧客のコンバージョン トラッキング設定。
remarketingSetting

object (RemarketingSetting)

出力専用。顧客のリマーケティング設定
payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

出力専用。顧客が PaymentMode.CONVERSIONS を使用できない理由。リストが空の場合、お客様は対象です。このフィールドは読み取り専用です。
optimizationScoreWeight

number

出力専用。お客様の最適化スコアの重み付け。

最適化スコアの重み付けを使用すると、MCC アカウント以外の複数の顧客の最適化スコアを比較、集計できます。マネージャーの最適化スコアの集計は、Customer.optimization_score * Customer.optimization_score_weight の全顧客の合計として計算されます。このフィールドは、すべての MCC のお客様と、スコアリングされない非 MCC の顧客について 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)

出力専用。顧客の ID。
descriptiveName

string

（省略可）顧客の一意でないわかりやすい名前。
currencyCode

string

変更不可。アカウントが運用されている通貨。ISO 4217 標準の通貨コードのサブセットがサポートされています。
timeZone

string

変更不可。顧客のローカル タイムゾーン ID。
trackingUrlTemplate

string

パラメータからトラッキング URL を作成するための URL テンプレート。update オペレーションでのみ変更可能です。
finalUrlSuffix

string

パラメータを最終ページ URL に追加するための URL テンプレート。update オペレーションでのみ変更可能です。
autoTaggingEnabled

boolean

ユーザーに対して自動タグ設定が有効になっているかどうか。
hasPartnersBadge

boolean

出力専用。お客様が Google Partner プログラムのバッジをお持ちかどうか。お客様が Google Partners プログラムに関連付けられていない場合は誤りとなります。詳しくは、https://support.google.com/partners/answer/3125774 をご覧ください。
manager

boolean

出力専用。お客様がマネージャーであるかどうか。
testAccount

boolean

出力専用。お客様がテスト アカウントであるかどうか。
optimizationScore

number

出力専用。お客様の最適化スコア。

最適化スコアとは、お客様のキャンペーンがどの程度最適化されているかを示す推定値です。範囲は 0%（0.0）～ 100%（1.0）です。このフィールドは、MCC アカウントのすべての顧客と、スコアリングされない MCC 顧客以外の顧客の場合は 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 広告のコンバージョン トラッキングに関連する、ユーザー全体の設定をまとめたコレクションです。

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 広告の管理画面でのみ管理できます。このフィールドは読み取り専用です。

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 顧客の 1 日の平均費用が高すぎます。
ANALYSIS_NOT_COMPLETE 顧客の適格性が Google 広告のバックエンドでまだ計算されていません。しばらくしてからご確認ください。
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)

出力専用。地域と業種ごとのきめ細かな保険ステータス。