Customer

Klienta.

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)
  },
  "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
}
Pola
resourceName

string

Stałe. Nazwa zasobu klienta. Nazwy zasobów klienta mają postać:

customers/{customerId}
callReportingSetting

object (CallReportingSetting)

Ustawienie raportu połączeń telefonicznych dla klienta. Można zmieniać 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 może korzystać z PaymentMode.conversions. Jeśli lista jest pusta, klient kwalifikuje się. To pole jest tylko do odczytu.
optimizationScoreWeight

number

Tylko dane wyjściowe. Waga wyniku optymalizacji klienta.

Waga wyniku optymalizacji może służyć do porównywania lub zagregowania wyników optymalizacji w przypadku wielu klientów, którzy nie są kontami menedżera. Łączny wynik optymalizacji menedżera jest obliczany jako suma dla wszystkich klientów w grupie 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. Ustawienie umowy klienta.
localServicesSettings

object (LocalServicesSettings)

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

enum (BrandSafetySuitability)

Tylko dane wyjściowe. Ustawienie Bezpieczeństwo marki na poziomie konta. Umożliwia wybór typu zasobów reklamowych, dzięki czemu możesz wyświetlać reklamy w treściach dopasowanych do Twojej marki. Więcej informacji znajdziesz na stronie https://support.google.com/google-ads/answer/7515513.
id

string (int64 format)

Tylko dane wyjściowe. Identyfikator klienta.
descriptiveName

string

Opcjonalna, nieunikalna nazwa opisowa klienta.
currencyCode

string

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

string

Stałe. Identyfikator lokalnej strefy czasowej klienta.
trackingUrlTemplate

string

Szablon URL służący do tworzenia linku monitorującego na podstawie parametrów. Można zmieniać tylko w operacji update.
finalUrlSuffix

string

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

boolean

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

boolean

Tylko dane wyjściowe. 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 o wyniku optymalizacji znajdziesz 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. Wartość to „prawda”, jeśli obraz utworzony w pliku danych został przekształcony w obraz oparty na komponentach.
locationAssetAutoMigrationDoneDateTime

string

Tylko dane wyjściowe. Sygnatura czasowa migracji z lokalizacji na podstawie 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 do obrazu podstawowego zasobu w formacie rrrr-MM-dd GG:mm:ss.

CallReportingSetting

Ustawienie raportu połączeń telefonicznych dla klienta. Można zmieniać 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, które ma 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ść prawda.

ConversionTrackingSetting

Zbiór ustawień dla wszystkich klientów związanych ze śledzeniem 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. Informacja o tym, czy klient zaakceptował warunki dotyczące danych klienta. Jeśli stosujesz śledzenie konwersji dla wielu kont, wartość ta jest dziedziczona z konta menedżera. To pole jest tylko do odczytu. Więcej informacji znajdziesz na https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

Tylko dane wyjściowe. Stan śledzenia konwersji. Wskazuje, czy klient używa śledzenia konwersji i kto jest właścicielem śledzenia konwersji tego klienta. 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 w polu login-customer-id żądania.
enhancedConversionsForLeadsEnabled

boolean

Tylko dane wyjściowe. od tego, czy klient włączył konwersje rozszerzone dotyczące potencjalnych klientów. Jeśli stosujesz śledzenie 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, dla którego są tworzone i zarządzane konwersje. 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 (tak – conversionTrackingStatus). To pole jest tylko do odczytu.
crossAccountConversionTrackingId

string (int64 format)

Tylko dane wyjściowe. Identyfikator śledzenia konwersji należącego do menedżera klienta. Jest ona konfigurowana, gdy klient ma włączone śledzenie konwersji dla wielu kont, co zastępuje conversionTrackingId. Tym polem można zarządzać tylko przez interfejs Google Ads. To pole jest tylko do odczytu.

RemarketingSetting

Ustawienie remarketingu dla klienta.

Zapis JSON 
{
  "googleGlobalSiteTag": string
}
Pola
googleGlobalSiteTag

string

Tylko dane wyjściowe. Tag Google.

CustomerPayPerConversionEligibilityFailureReason

Wyliczenie opisujące 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 Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
NOT_ENOUGH_CONVERSIONS Klient ma za mało konwersji.
CONVERSION_LAG_TOO_HIGH Opóźnienie w realizacji konwersji klienta jest zbyt duże.
HAS_CAMPAIGN_WITH_SHARED_BUDGET Klient używa budżetów wspólnych.
HAS_UPLOAD_CLICKS_CONVERSION Klient uzyskał konwersje z ConversionActionType.UPLOAD_CLICKS.
AVERAGE_DAILY_SPEND_TOO_HIGH Średnie dzienne wydatki klienta są zbyt wysokie.
ANALYSIS_NOT_COMPLETE Backend Google Ads nie obliczył jeszcze, czy klient się kwalifikuje. Zajrzyj tu później.
OTHER Klient nie kwalifikuje się z innych powodów.

CustomerAgreementSetting

Ustawienie umowy klienta.

Zapis JSON 
{
  "acceptedLeadFormTerms": boolean
}
Pola
acceptedLeadFormTerms

boolean

Tylko dane wyjściowe. Wskazuje, 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 tylko do odczytu stanów licencji na branżę geograficzną.
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

Tylko dane wyjściowe. Lista tylko do odczytu statusów ubezpieczeń na poziomie branży geograficznej.

GranularLicenseStatus

Stan licencji na poziomie geograficznym i branżowym.

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. To ustawienie można podać na poziomie kraju lub stanu/prowincji 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ółowe informacje o stanie licencji według lokalizacji i branży.

LocalServicesVerificationStatus

Wyliczenie opisujące 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 jeszcze się nie zakończyła.
FAILED Nie udało się zweryfikować.
PASSED Weryfikacja zakończona.
NOT_APPLICABLE Weryfikacja nie jest możliwa.
NO_SUBMISSION Weryfikacja jest wymagana, ale oczekuje na przesłanie.
PARTIAL_SUBMISSION Nie wszystkie wymagane procesy weryfikacji zostały przesłane.
PENDING_ESCALATION Weryfikacja wymaga sprawdzenia 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. To ustawienie można podać na poziomie kraju lub stanu/prowincji 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ółowe informacje o stanie ubezpieczenia na podstawie danych geograficznych i branży.