Customer

Klientem.

Zapis 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
}
Pola
resourceName

string

Niezmienne. Nazwa zasobu klienta. Nazwy zasobów klienta mają postać:

customers/{customerId}
callReportingSetting

object (CallReportingSetting)

Ustawienie raportu połączeń telefonicznych klienta. Zmienny tylko w operacji update.
conversionTrackingSetting

object (ConversionTrackingSetting)

Tylko dane wyjściowe. Ustawienie śledzenia konwersji dla klienta.
remarketingSetting

object (RemarketingSetting)

Tylko dane wyjściowe. Ustawienie remarketingu dla klienta.
payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

Tylko dane wyjściowe. Powody, dla których klient nie kwalifikuje się do korzystania z PaymentMode.conversions. Jeśli lista jest pusta, kwalifikuje się klient. To pole jest tylko do odczytu.
optimizationScoreWeight

number

Tylko dane wyjściowe. Waga wyniku optymalizacji klienta.

Wagę wyniku optymalizacji można używać do porównywania/zbiorczych wyników optymalizacji wielu klientów, którzy nie są menedżerami. Łączny wynik optymalizacji menedżera jest obliczany jako suma dla wszystkich klientów firmy Customer.optimization_score * Customer.optimization_score_weight. To pole ma wartość 0 w przypadku wszystkich klientów menedżera i klientów bez oceny.

To pole jest tylko do odczytu.
status

enum (CustomerStatus)

Tylko dane wyjściowe. Stan klienta.
customerAgreementSetting

object (CustomerAgreementSetting)

Tylko dane wyjściowe. Ustawienia umowy klienta dla klienta.
localServicesSettings

object (LocalServicesSettings)

Tylko dane wyjściowe. Ustawienia klienta Usług Lokalnych.
id

string (int64 format)

Tylko dane wyjściowe. Identyfikator klienta.
descriptiveName

string

Opcjonalna, nieunikalna nazwa opisowa klienta.
currencyCode

string

Niezmienne. Waluta, w której działa konto. Obsługiwany jest podzbiór kodów waluty ze standardu ISO 4217.
timeZone

string

Niezmienne. Identyfikator lokalnej strefy czasowej klienta.
trackingUrlTemplate

string

Szablon adresu URL służący do tworzenia linku monitorującego z parametrów. Zmienny tylko w operacji update.
finalUrlSuffix

string

Szablon adresu URL służący do dołączania parametrów do końcowego adresu URL. Zmienny tylko w operacji update.
autoTaggingEnabled

boolean

Określa, czy na koncie klienta jest włączone automatyczne tagowanie.
hasPartnersBadge

boolean

Tylko dane wyjściowe. Informacja, czy Klient ma logo programu Google Partners. Jeśli Klient nie jest powiązany z programem Google Partners, to pole ma wartość false (fałsz). Więcej informacji znajdziesz na stronie https://support.google.com/partners/answer/3125774.
manager

boolean

Tylko dane wyjściowe. od tego, czy klient jest menedżerem.
testAccount

boolean

Tylko dane wyjściowe. Określa, czy klient jest kontem testowym.
optimizationScore

number

Tylko dane wyjściowe. Wynik optymalizacji klienta.

Wynik optymalizacji to prognoza skuteczności kampanii klienta. Mieści się w zakresie od 0% (0,0) do 100% (1,0). To pole ma wartość null w przypadku wszystkich klientów menedżera i klientów bez oceny.

Więcej informacji znajdziesz w artykule „Wynik optymalizacji” na stronie https://support.google.com/google-ads/answer/9061546.

To pole jest tylko do odczytu.
locationAssetAutoMigrationDone

boolean

Tylko dane wyjściowe. Prawda, jeśli lokalizacja oparta na pliku danych została przeniesiona do lokalizacji opartej na komponentach.
imageAssetAutoMigrationDone

boolean

Tylko dane wyjściowe. Prawda, jeśli obraz oparty na pliku danych został przekształcony w obraz oparty na komponentach.
locationAssetAutoMigrationDoneDateTime

string

Tylko dane wyjściowe. Sygnatura czasowa migracji z lokalizacji opartej na pliku danych do lokalizacji podstawowej zasobu w formacie rrrr-MM-dd GG:mm:ss.
imageAssetAutoMigrationDoneDateTime

string

Tylko dane wyjściowe. Sygnatura czasowa migracji z obrazu opartego na pliku danych na obraz podstawowy zasobu w formacie rrrr-MM-dd GG:mm:ss.

CallReportingSetting

Ustawienie raportu połączeń telefonicznych klienta. Zmienny tylko w operacji update.

Zapis JSON 
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
Pola
callReportingEnabled

boolean

Włącz raportowanie zdarzeń połączeń telefonicznych, przekierowując je przez system Google.
callConversionReportingEnabled

boolean

Określa, czy włączyć raportowanie konwersji telefonicznych.
callConversionAction

string

Działanie powodujące konwersję telefoniczną na poziomie klienta, aby przypisać konwersję telefoniczną. Jeśli zasada jest nieskonfigurowana, używane jest domyślne działanie powodujące konwersję. Obowiązuje tylko wtedy, gdy funkcja callConversionReportingEnabled ma wartość true.

ConversionTrackingSetting

Zbiór ustawień klienta dotyczących śledzenia konwersji w Google Ads.

Zapis JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Pola
acceptedCustomerDataTerms

boolean

Tylko dane wyjściowe. Czy klient zaakceptował warunki dotyczące danych klienta. Jeśli używasz śledzenia konwersji dla wielu kont, wartość ta jest dziedziczona z konta menedżera. To pole jest tylko do odczytu. Więcej informacji znajdziesz na stronie https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

Tylko dane wyjściowe. Stan śledzenia konwersji. Wskazuje ona, czy klient korzysta ze śledzenia konwersji i kto jest właścicielem śledzenia konwersji. Jeśli ten klient korzysta ze śledzenia konwersji dla wielu kont, zwrócona wartość będzie się różnić w zależności od wartości login-customer-id w żądaniu.
enhancedConversionsForLeadsEnabled

boolean

Tylko dane wyjściowe. Czy klient włączył konwersje rozszerzone dotyczące potencjalnych klientów. Jeśli używasz śledzenia konwersji dla wielu kont, wartość ta jest dziedziczona z konta menedżera. To pole jest tylko do odczytu.
googleAdsConversionCustomer

string

Tylko dane wyjściowe. Nazwa zasobu klienta, w przypadku którego konwersje są tworzone i zarządzane. To pole jest tylko do odczytu.
conversionTrackingId

string (int64 format)

Tylko dane wyjściowe. Identyfikator śledzenia konwersji używany na tym koncie. Ten identyfikator nie wskazuje, czy klient korzysta ze śledzenia konwersji (conversionTrackingStatus). To pole jest tylko do odczytu.
crossAccountConversionTrackingId

string (int64 format)

Tylko dane wyjściowe. Identyfikator śledzenia konwersji menedżera klienta. Jest ona konfigurowana, gdy klient włączy śledzenie konwersji dla wielu kont, i zastępuje identyfikator śledzenia konwersji. Tym polem można zarządzać tylko w interfejsie Google Ads. To pole jest tylko do odczytu.

ConversionTrackingStatus

Stan śledzenia konwersji klienta.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
NOT_CONVERSION_TRACKED Klient nie korzysta ze śledzenia konwersji.
CONVERSION_TRACKING_MANAGED_BY_SELF Działania powodujące konwersję są tworzone i zarządzane przez tego klienta.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Działania powodujące konwersję są tworzone i zarządzane przez menedżera wskazanego w login-customer-id żądania.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Działania powodujące konwersję są tworzone i zarządzane przez menedżera innego niż klient lub menedżer określony w login-customer-id prośby.

RemarketingSetting

Ustawienie remarketingu dla klienta.

Zapis JSON 
{
  "googleGlobalSiteTag": string
}
Pola
googleGlobalSiteTag

string

Tylko dane wyjściowe. Tag Google.

CustomerPayPerConversionEligibilityFailureReason

Wartość opisująca możliwe powody, dla których klient nie kwalifikuje się do korzystania z PaymentMode.conversions.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
NOT_ENOUGH_CONVERSIONS Klient nie uzyskał wystarczającej liczby konwersji.
CONVERSION_LAG_TOO_HIGH Opóźnienie w realizacji konwersji jest zbyt wysokie.
HAS_CAMPAIGN_WITH_SHARED_BUDGET Klient korzysta z budżetów wspólnych.
HAS_UPLOAD_CLICKS_CONVERSION Klient ma konwersje z konwersją ConversionActionType.UPLOAD_CAMPAIGNS.
AVERAGE_DAILY_SPEND_TOO_HIGH Średnie dzienne wydatki klienta są zbyt wysokie.
ANALYSIS_NOT_COMPLETE System Google Ads nie obliczył jeszcze, czy klient spełnia wymagania. Zajrzyj tu później.
OTHER Klient nie kwalifikuje się z innych powodów.

CustomerAgreementSetting

Ustawienia umowy klienta dla klienta.

Zapis JSON 
{
  "acceptedLeadFormTerms": boolean
}
Pola
acceptedLeadFormTerms

boolean

Tylko dane wyjściowe. Informacja o tym, czy klient zaakceptował warunki korzystania z formularza kontaktowego.

LocalServicesSettings

Ustawienia klienta Usług Lokalnych.

Zapis JSON 
{
  "granularLicenseStatuses": [
    {
      object (GranularLicenseStatus)
    }
  ],
  "granularInsuranceStatuses": [
    {
      object (GranularInsuranceStatus)
    }
  ]
}
Pola
granularLicenseStatuses[]

object (GranularLicenseStatus)

Tylko dane wyjściowe. Lista stanów licencji na poziomie branży geograficznej – tylko do odczytu.
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

Tylko dane wyjściowe. Lista tylko do odczytu stanów ubezpieczenia w branży geograficznej.

GranularLicenseStatus

Stan licencji na poziomie lokalizacji geograficznej i branży.

Zapis JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Pola
geoCriterionId

string (int64 format)

Tylko dane wyjściowe. Identyfikator kryterium kierowania geograficznego powiązany ze stanem. Może to być poziom geograficzny kraju lub stanu/województwa w zależności od wymagań i lokalizacji. Więcej informacji znajdziesz na stronie https://developers.google.com/google-ads/api/data/geotargets.
categoryId

string

Tylko dane wyjściowe. Kategoria usługi powiązana ze stanem. Na przykład: xcat:service_area_business_hydraulik. Więcej informacji: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus

enum (LocalServicesVerificationStatus)

Tylko dane wyjściowe. Szczegółowy stan licencji według lokalizacji i branży.

LocalServicesVerificationStatus

Wartość opisująca stan określonej kategorii weryfikacji na potrzeby Reklam Usług Lokalnych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Nieznany stan weryfikacji.
NEEDS_REVIEW Weryfikacja rozpoczęła się, ale nie została zakończona.
FAILED Weryfikacja się nie powiodła.
PASSED Weryfikacja zakończyła się powodzeniem.
NOT_APPLICABLE Weryfikacja nie dotyczy.
NO_SUBMISSION Weryfikacja jest wymagana, ale oczekuje na przesłanie.
PARTIAL_SUBMISSION Nie wszystkie wymagane procesy weryfikacji zostały wysłane.
PENDING_ESCALATION Weryfikacja wymaga weryfikacji przez specjalistę ds. operacji Reklam Usług Lokalnych.

GranularInsuranceStatus

Stan ubezpieczenia na poziomie geograficznym i branży.

Zapis JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Pola
geoCriterionId

string (int64 format)

Tylko dane wyjściowe. Identyfikator kryterium kierowania geograficznego powiązany ze stanem. Może to być poziom geograficzny kraju lub stanu/województwa w zależności od wymagań i lokalizacji. Więcej informacji znajdziesz na stronie https://developers.google.com/google-ads/api/data/geotargets.
categoryId

string

Tylko dane wyjściowe. Kategoria usługi powiązana ze stanem. Na przykład: xcat:service_area_business_hydraulik. Więcej informacji: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus

enum (LocalServicesVerificationStatus)

Tylko dane wyjściowe. Szczegółowy stan ubezpieczenia według lokalizacji i branży.