Customer

Kunde

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

string

Nicht veränderbar. Der Ressourcenname des Kunden. Ressourcennamen von Kunden 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 aggregierte Optimierungsfaktor eines Kontoverwalters ist die Summe aller Kunden von Customer.optimization_score * Customer.optimization_score_weight. Dieses Feld ist für alle Kunden mit Verwaltungskonto sowie für Kunden ohne Verwaltungskonto auf 0 gesetzt.

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.

videoBrandSafetySuitability

enum (BrandSafetySuitability)

Nur Ausgabe. Einstellung für die Markensicherheit auf Kontoebene. Hier können Sie einen Inventartyp auswählen, damit Ihre Anzeigen in Inhalten ausgeliefert werden, die zu Ihrer Marke passen. Weitere Informationen finden Sie unter https://support.google.com/google-ads/answer/7515513.

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 Partnerprogramm 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. Der Wert reicht von 0% (0,0) bis 100% (1,0). Dieses Feld ist für alle Kunden mit Verwaltungskonto sowie für Kunden, die keine Verwaltungskonten 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. Dieser Wert ist „True“, wenn ein feedbasierter Standort zu einem assetbasierten Standort migriert wurde.

imageAssetAutoMigrationDone

boolean

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

locationAssetAutoMigrationDoneDateTime

string

Nur Ausgabe. Zeitstempel der Migration vom feedbasierten Speicherort zum Asset-Basisspeicherort 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. Ist die Richtlinie nicht konfiguriert, wird eine Standard-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 Kontoverwalter ü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. Er gibt an, ob der Kunde Conversion-Tracking verwendet und wer der Inhaber des Conversion-Trackings 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 Kontoverwalter übernommen. Dieses Feld ist schreibgeschützt.

googleAdsConversionCustomer

string

Nur Ausgabe. Der Ressourcenname des Kunden, in dem Conversions erstellt und verwaltet werden. Dieses Feld ist schreibgeschützt.

conversionTrackingId

string (int64 format)

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

crossAccountConversionTrackingId

string (int64 format)

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

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, warum ein Kunde PaymentMode.CONVERSIONS nicht verwenden kann.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version 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 Kunde verwendet gemeinsame Budgets.
HAS_UPLOAD_CLICKS_CONVERSION Der Kunde hat Conversions mit dem Typ „ConversionActionType.UPLOAD_KLICKS“.
AVERAGE_DAILY_SPEND_TOO_HIGH Die durchschnittlichen Tagesausgaben des Kunden sind zu hoch.
ANALYSIS_NOT_COMPLETE Die Berechtigung des Kunden wurde noch nicht vom Google Ads-Backend 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 der geografischen vertikalen Lizenzstatus.

granularInsuranceStatuses[]

object (GranularInsuranceStatus)

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

GranularLicenseStatus

Lizenzstatus auf geografischer 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 der geografischen Ebene eines Landes oder eines Bundeslandes/Bundesstaats/Provinz vorliegen. Weitere Informationen finden Sie unter https://developers.google.com/google-ads/api/data/geotargets.

categoryId

string

Nur Ausgabe. Die dem Status zugeordnete Dienstkategorie. Beispiel: xcat:service_area_business_klempner. 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 zum Status einer bestimmten Überprüfungskategorie für Google Lokale Dienstleistungen

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 ist bestanden.
NOT_APPLICABLE Eine Bestätigung ist nicht erforderlich.
NO_SUBMISSION Eine Bestätigung ist erforderlich, die Einreichung steht aber noch aus.
PARTIAL_SUBMISSION Es wurden nicht alle erforderlichen Bestätigungen gesendet.
PENDING_ESCALATION Die Überprüfung muss von einem Operations Specialist für Google Lokale Dienstleistungen überprüft werden.

GranularInsuranceStatus

Versicherungsstatus auf geografischer 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 der geografischen Ebene eines Landes oder eines Bundeslandes/Bundesstaats/Provinz vorliegen. Weitere Informationen finden Sie unter https://developers.google.com/google-ads/api/data/geotargets.

categoryId

string

Nur Ausgabe. Die dem Status zugeordnete Dienstkategorie. Beispiel: xcat:service_area_business_klempner. 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