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

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

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

出力のみ。お客様が Google Partners プログラムのバッジを獲得しているかどうか。お客様が 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

出力のみ。お客様が顧客データに関する規約に同意したかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC から継承されます。このフィールドは読み取り専用です。詳しくは、https://support.google.com/adspolicy/answer/7475709 をご覧ください。
conversionTrackingStatus

enum (ConversionTrackingStatus)

出力のみ。コンバージョン トラッキングのステータスです。ユーザーがコンバージョン トラッキングを使用しているかどうか、および誰がそのコンバージョン トラッキングの所有者かを示します。この顧客がクロスアカウント コンバージョン トラッキングを使用している場合、返される値はリクエストの login-customer-id によって異なります。
enhancedConversionsForLeadsEnabled

boolean

出力のみ。お客様がリードの拡張コンバージョンを有効にしているかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC から継承されます。このフィールドは読み取り専用です。
googleAdsConversionCustomer

string

出力のみ。コンバージョンが作成、管理される顧客のリソース名。このフィールドは読み取り専用です。
conversionTrackingId

string (int64 format)

出力のみ。このアカウントで使用されているコンバージョン トラッキング ID。この ID は、ユーザーがコンバージョン トラッキングを使用しているかどうかを示すものではありません（conversionTrackingStatus は使用します）。このフィールドは読み取り専用です。
crossAccountConversionTrackingId

string (int64 format)

出力のみ。顧客の管理者のコンバージョン トラッキング ID。顧客がクロスアカウント コンバージョン トラッキングをオプトインしている場合に設定され、conversionTrackingId をオーバーライドします。このフィールドは Google 広告の管理画面でのみ管理できます。このフィールドは読み取り専用です。

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 お客様の 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)

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