Customer

Eine Kundin.

JSON-Darstellung
{
  "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
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname des Kunden. Namen von Kundenressourcen haben das folgende Format:

customers/{customerId}

callReportingSetting

object (CallReportingSetting)

Einstellung für Anrufberichte für einen Kunden. Kann nur in einem update-Vorgang geändert werden.

conversionTrackingSetting

object (ConversionTrackingSetting)

Nur Ausgabe Conversion-Tracking-Einstellung für einen Kunden.

remarketingSetting

object (RemarketingSetting)

Nur Ausgabe Remarketing-Einstellung für einen Kunden.

payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

Nur Ausgabe Gründe, warum der Kunde PaymentMode.CONVERSIONS nicht verwenden kann. Wenn die Liste leer ist, kommt der Kunde infrage. Dieses Feld ist schreibgeschützt.

optimizationScoreWeight

number

Nur Ausgabe Optimierungsfaktor-Gewichtung des Kunden

Mit der Gewichtung des Optimierungsfaktors können Sie den Optimierungsfaktor für mehrere Kunden vergleichen/aggregieren, die kein Verwaltungskonto sind. Der Gesamtoptimierungsfaktor eines Managers ist die Summe aller seiner Kunden (Customer.optimization_score * Customer.optimization_score_weight). Dieses Feld ist für alle Kunden mit einem Verwaltungskonto und für nicht bewertete Kunden, die kein Verwaltungskonto sind, „0“.

Dieses Feld ist schreibgeschützt.

status

enum (CustomerStatus)

Nur Ausgabe Der Status des Kunden.

customerAgreementSetting

object (CustomerAgreementSetting)

Nur Ausgabe Kundenvereinbarungseinstellung für einen Kunden.

localServicesSettings

object (LocalServicesSettings)

Nur Ausgabe Einstellungen für Google Lokale Dienstleistungen-Kunden.

id

string (int64 format)

Nur Ausgabe Die ID des Kunden.

descriptiveName

string

Optionaler, nicht eindeutiger beschreibender Name des Kunden.

currencyCode

string

Nicht veränderbar. Die Währung, in der das Konto geführt wird. Ein Teil der Währungscodes aus dem ISO 4217-Standard wird unterstützt.

timeZone

string

Nicht veränderbar. Die lokale Zeitzonen-ID des Kunden.

trackingUrlTemplate

string

Die URL-Vorlage zum Erstellen einer Tracking-URL aus Parametern. Kann nur in einem update-Vorgang geändert werden.

finalUrlSuffix

string

Die URL-Vorlage zum Anhängen von Parametern an die finale URL Kann nur in einem update-Vorgang geändert werden.

autoTaggingEnabled

boolean

Gibt an, ob das automatische Tagging für den Kunden aktiviert ist.

hasPartnersBadge

boolean

Nur Ausgabe Ob der Kunde ein Logo für das Google Partners-Programm hat. Wenn der Kunde nicht mit dem Partner-Programm verknüpft ist, ist dies falsch. Weitere Informationen finden Sie unter https://support.google.com/partners/answer/3125774.

manager

boolean

Nur Ausgabe Gibt an, ob der Kunde ein Manager ist.

testAccount

boolean

Nur Ausgabe Gibt an, ob der Kunde ein Testkonto hat.

optimizationScore

number

Nur Ausgabe Optimierungsfaktor des Kunden

Der Optimierungsfaktor ist ein Schätzwert zur Leistung der Kampagnen eines Kunden. Er liegt zwischen 0% (0,0) und 100% (1,0). Der Wert in diesem Feld ist für alle Kunden mit Verwaltungskonto sowie für nicht bewertete Kunden, die kein Verwaltungskonto sind, null.

Weitere Informationen zum Optimierungsfaktor finden Sie unter https://support.google.com/google-ads/answer/9061546.

Dieses Feld ist schreibgeschützt.

locationAssetAutoMigrationDone

boolean

Nur Ausgabe „True“, wenn ein feedbasierter Standort zu einem assetbasierten Standort migriert wurde.

imageAssetAutoMigrationDone

boolean

Nur Ausgabe „True“, wenn ein feedbasiertes Bild zu einem assetbasierten Bild migriert wurde.

locationAssetAutoMigrationDoneDateTime

string

Nur Ausgabe Zeitstempel der Migration vom feedbasierten Standort zum Asset-Basisstandort im Format jjjj-MM-tt HH:mm:ss.

imageAssetAutoMigrationDoneDateTime

string

Nur Ausgabe Zeitstempel der Migration vom feedbasierten Bild zum Asset-Basisbild im Format jjjj-MM-tt HH:mm:ss.

CallReportingSetting

Einstellung für Anrufberichte für einen Kunden. Kann nur in einem update-Vorgang geändert werden.

JSON-Darstellung
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
Felder
callReportingEnabled

boolean

Sie können die Berichterstellung für Anrufereignisse aktivieren, indem Sie sie über das Google-System weiterleiten.

callConversionReportingEnabled

boolean

Gibt an, ob Berichte zu Anruf-Conversions aktiviert werden sollen.

callConversionAction

string

Anruf-Conversion-Aktion auf Kundenebene, der eine Anruf-Conversion zugeordnet werden soll. Wenn die Richtlinie nicht konfiguriert ist, wird eine standardmäßige Conversion-Aktion verwendet. Nur wirksam, wenn „callConversionReportingEnabled“ auf „true“ festgelegt ist.

ConversionTrackingSetting

Eine Sammlung kundenweiter Einstellungen für das Google Ads-Conversion-Tracking.

JSON-Darstellung
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Felder
acceptedCustomerDataTerms

boolean

Nur Ausgabe Gibt an, ob der Kunde die Nutzungsbedingungen für Kundendaten akzeptiert hat. Wenn Sie kontoübergreifendes Conversion-Tracking verwenden, wird dieser Wert vom Verwaltungskonto übernommen. Dieses Feld ist schreibgeschützt. Weitere Informationen finden Sie unter https://support.google.com/adspolicy/answer/7475709.

conversionTrackingStatus

enum (ConversionTrackingStatus)

Nur Ausgabe Conversion-Tracking-Status. Es gibt an, ob der Kunde Conversion-Tracking verwendet und wer der Conversion-Tracking-Inhaber dieses Kunden ist. Wenn dieser Kunde kontoübergreifendes Conversion-Tracking verwendet, unterscheidet sich der zurückgegebene Wert je nach login-customer-id der Anfrage.

enhancedConversionsForLeadsEnabled

boolean

Nur Ausgabe Gibt an, ob der Kunde erweiterte Conversions für Leads aktiviert hat. Wenn Sie kontoübergreifendes Conversion-Tracking verwenden, wird dieser Wert vom Verwaltungskonto übernommen. Dieses Feld ist schreibgeschützt.

googleAdsConversionCustomer

string

Nur Ausgabe Der Ressourcenname des Kunden, für den Conversions erstellt und verwaltet werden. Dieses Feld ist schreibgeschützt.

conversionTrackingId

string (int64 format)

Nur Ausgabe Die für dieses Konto verwendete Conversion-Tracking-ID. Diese ID gibt nicht an, ob der Kunde Conversion-Tracking verwendet (ConversionTrackingStatus schon). Dieses Feld ist schreibgeschützt.

crossAccountConversionTrackingId

string (int64 format)

Nur Ausgabe Die Conversion-Tracking-ID des Verwaltungskontos des Kunden. Sie wird festgelegt, wenn für den Kunden kontoübergreifendes Conversion-Tracking aktiviert ist, und überschreibt die Conversion-Tracking-ID. Dieses Feld kann nur über die Google Ads-Benutzeroberfläche verwaltet werden. Dieses Feld ist schreibgeschützt.

ConversionTrackingStatus

Conversion-Tracking-Status des Kunden

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
NOT_CONVERSION_TRACKED Der Kunde verwendet kein Conversion-Tracking.
CONVERSION_TRACKING_MANAGED_BY_SELF Die Conversion-Aktionen werden von diesem Kunden erstellt und verwaltet.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Die Conversion-Aktionen werden von dem Manager erstellt und verwaltet, der in der login-customer-id der Anfrage angegeben ist.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Die Conversion-Aktionen werden von einem anderen Verwaltungskonto erstellt und verwaltet als dem in der login-customer-id der Anfrage angegebenen Kunden oder Verwaltungskonto.

RemarketingSetting

Remarketing-Einstellung für einen Kunden.

JSON-Darstellung
{
  "googleGlobalSiteTag": string
}
Felder
googleGlobalSiteTag

string

Nur Ausgabe Das Google-Tag.

CustomerPayPerConversionEligibilityFailureReason

Aufzählung mit möglichen Gründen, aus denen ein Kunde PaymentMode.CONVERSIONS nicht verwenden kann.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
NOT_ENOUGH_CONVERSIONS Der Kunde hat nicht genügend Conversions.
CONVERSION_LAG_TOO_HIGH Die Conversion-Verzögerung des Kunden ist zu hoch.
HAS_CAMPAIGN_WITH_SHARED_BUDGET Der Kunde verwendet gemeinsame Budgets.
HAS_UPLOAD_CLICKS_CONVERSION Der Kunde hat Conversions mit ConversionActionType.UPLOAD_CLICKS.
AVERAGE_DAILY_SPEND_TOO_HIGH Die durchschnittlichen täglichen Ausgaben des Kunden sind zu hoch.
ANALYSIS_NOT_COMPLETE Die Kundenqualifikation wurde noch nicht vom Google Ads-Back-End berechnet. Versuchen Sie es bald noch einmal.
OTHER Der Kunde ist aus anderen Gründen nicht teilnahmeberechtigt.

CustomerAgreementSetting

Kundenvereinbarungseinstellung für einen Kunden.

JSON-Darstellung
{
  "acceptedLeadFormTerms": boolean
}
Felder
acceptedLeadFormTerms

boolean

Nur Ausgabe Gibt an, ob der Kunde die Nutzungsbedingungen für Lead-Formulare akzeptiert hat.

LocalServicesSettings

Einstellungen für Google Lokale Dienstleistungen-Kunden.

JSON-Darstellung
{
  "granularLicenseStatuses": [
    {
      object (GranularLicenseStatus)
    }
  ],
  "granularInsuranceStatuses": [
    {
      object (GranularInsuranceStatus)
    }
  ]
}
Felder
granularLicenseStatuses[]

object (GranularLicenseStatus)

Nur Ausgabe Eine schreibgeschützte Liste von Lizenzstatus auf geografischer Ebene der Branche.

granularInsuranceStatuses[]

object (GranularInsuranceStatus)

Nur Ausgabe Eine schreibgeschützte Liste von Versicherungsstatus auf geografischer Branche.

GranularLicenseStatus

Lizenzstatus auf geografischer und vertikaler Ebene.

JSON-Darstellung
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Felder
geoCriterionId

string (int64 format)

Nur Ausgabe Die mit dem Status verknüpfte Kriteriums-ID für die geografische Ausrichtung. Kann je nach Anforderungen und Standort auf Landes- oder Bundesstaat/Provinz-Geoebene erfolgen. Weitere Informationen finden Sie unter https://developers.google.com/google-ads/api/data/geotargets.

categoryId

string

Nur Ausgabe Die mit dem Status verknüpfte Dienstleistungskategorie. Beispiel: xcat:service_area_business_installateur. Weitere Informationen finden Sie unter https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.

verificationStatus

enum (LocalServicesVerificationStatus)

Nur Ausgabe Detaillierter Lizenzstatus nach Region und Branche.

LocalServicesVerificationStatus

Aufzählung, die den Status einer bestimmten Überprüfungskategorie für Google Lokale Dienstleistungen beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Unbekannter Bestätigungsstatus.
NEEDS_REVIEW Die Überprüfung hat begonnen, ist aber noch nicht abgeschlossen.
FAILED Die Bestätigung ist fehlgeschlagen.
PASSED Die Überprüfung war erfolgreich.
NOT_APPLICABLE Eine Bestätigung ist nicht erforderlich.
NO_SUBMISSION Bestätigung ist erforderlich, aber Einreichung noch ausstehend.
PARTIAL_SUBMISSION Nicht alle erforderlichen Bestätigungen wurden eingereicht.
PENDING_ESCALATION Die Überprüfung muss vom Ops-Spezialisten für Google Lokale Dienstleistungen überprüft werden.

GranularInsuranceStatus

Versicherungsstatus auf Geografie- und Branchenebene.

JSON-Darstellung
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Felder
geoCriterionId

string (int64 format)

Nur Ausgabe Die mit dem Status verknüpfte Kriteriums-ID für die geografische Ausrichtung. Kann je nach Anforderungen und Standort auf Landes- oder Bundesstaat/Provinz-Geoebene erfolgen. Weitere Informationen finden Sie unter https://developers.google.com/google-ads/api/data/geotargets.

categoryId

string

Nur Ausgabe Die mit dem Status verknüpfte Dienstleistungskategorie. Beispiel: xcat:service_area_business_installateur. Weitere Informationen finden Sie unter https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.

verificationStatus

enum (LocalServicesVerificationStatus)

Nur Ausgabe Detaillierter Versicherungsstatus nach Region und Branche