Index
IngestionService(Schnittstelle)MarketingDataInsightsService(Schnittstelle)PartnerLinkService(Schnittstelle)UserListDirectLicenseService(Schnittstelle)UserListGlobalLicenseService(Schnittstelle)UserListService(Schnittstelle)AdIdentifiers(Meldung)AddressInfo(Meldung)AgeRange(Aufzählung)AudienceMember(Meldung)AwsWrappedKeyInfo(Meldung)AwsWrappedKeyInfo.KeyType(Aufzählung)Baseline(Meldung)Baseline.Location(Meldung)CartData(Meldung)Consent(Meldung)ConsentStatus(Aufzählung)ContactIdInfo(Meldung)CreatePartnerLinkRequest(Meldung)CreateUserListDirectLicenseRequest(Meldung)CreateUserListGlobalLicenseRequest(Meldung)CreateUserListRequest(Meldung)CustomVariable(Meldung)CustomerType(Option)CustomerValueBucket(Option)DataSourceType(Option)DeletePartnerLinkRequest(Meldung)DeleteUserListRequest(Meldung)Destination(Meldung)DeviceInfo(Meldung)Encoding(Aufzählung)EncryptionInfo(Meldung)ErrorCount(Meldung)ErrorInfo(Meldung)ErrorReason(Aufzählung)Event(Meldung)EventParameter(Meldung)EventSource(Aufzählung)ExperimentalField(Meldung)GcpWrappedKeyInfo(Meldung)GcpWrappedKeyInfo.KeyType(Option)Gender(Option)GetUserListDirectLicenseRequest(Meldung)GetUserListGlobalLicenseRequest(Meldung)GetUserListRequest(Meldung)IngestAudienceMembersRequest(Meldung)IngestAudienceMembersResponse(Meldung)IngestEventsRequest(Meldung)IngestEventsResponse(Meldung)IngestedUserListInfo(Meldung)IngestedUserListInfo.UploadKeyType(Aufzählung)Item(Meldung)ItemParameter(Meldung)ListUserListDirectLicensesRequest(Meldung)ListUserListDirectLicensesResponse(Meldung)ListUserListGlobalLicenseCustomerInfosRequest(Meldung)ListUserListGlobalLicenseCustomerInfosResponse(Meldung)ListUserListGlobalLicensesRequest(Meldung)ListUserListGlobalLicensesResponse(Meldung)ListUserListsRequest(Meldung)ListUserListsResponse(Meldung)MatchRateRange(Aufzählung)MobileData(Meldung)MobileIdInfo(Meldung)MobileIdInfo.KeySpace(Aufzählung)PairData(Meldung)PairIdInfo(Meldung)PartnerAudienceInfo(Meldung)PartnerAudienceInfo.PartnerAudienceSource(Aufzählung)PartnerLink(Meldung)PpidData(Meldung)ProcessingErrorReason(Option)ProcessingWarningReason(Aufzählung)Product(Aufzählung) (verworfen)ProductAccount(Meldung)ProductAccount.AccountType(Aufzählung)PseudonymousIdInfo(Meldung)PseudonymousIdInfo.SyncStatus(Aufzählung)RemoveAudienceMembersRequest(Meldung)RemoveAudienceMembersResponse(Meldung)RequestStatusPerDestination(Meldung)RequestStatusPerDestination.IngestAudienceMembersStatus(Meldung)RequestStatusPerDestination.IngestEventsStatus(Meldung)RequestStatusPerDestination.IngestMobileDataStatus(Meldung)RequestStatusPerDestination.IngestPairDataStatus(Meldung)RequestStatusPerDestination.IngestPpidDataStatus(Meldung)RequestStatusPerDestination.IngestUserDataStatus(Meldung)RequestStatusPerDestination.IngestUserIdDataStatus(Meldung)RequestStatusPerDestination.RemoveAudienceMembersStatus(Meldung)RequestStatusPerDestination.RemoveMobileDataStatus(Meldung)RequestStatusPerDestination.RemovePairDataStatus(Meldung)RequestStatusPerDestination.RemovePpidDataStatus(Meldung)RequestStatusPerDestination.RemoveUserDataStatus(Meldung)RequestStatusPerDestination.RemoveUserIdDataStatus(Meldung)RequestStatusPerDestination.RequestStatus(Aufzählung)RetrieveInsightsRequest(Meldung)RetrieveInsightsResponse(Meldung)RetrieveInsightsResponse.MarketingDataInsight(Meldung)RetrieveInsightsResponse.MarketingDataInsight.AudienceInsightsDimension(Aufzählung)RetrieveInsightsResponse.MarketingDataInsight.MarketingDataInsightsAttribute(Meldung)RetrieveRequestStatusRequest(Meldung)RetrieveRequestStatusResponse(Meldung)SearchPartnerLinksRequest(Meldung)SearchPartnerLinksResponse(Meldung)SizeInfo(Meldung)TargetNetworkInfo(Meldung)TermsOfService(Meldung)TermsOfServiceStatus(Aufzählung)UpdateUserListDirectLicenseRequest(Meldung)UpdateUserListGlobalLicenseRequest(Meldung)UpdateUserListRequest(Meldung)UserData(Meldung)UserIdData(Meldung)UserIdInfo(Meldung)UserIdentifier(Meldung)UserList(Meldung)UserList.AccessReason(Option)UserList.AccessStatus(Option)UserList.ClosingReason(Option)UserList.MembershipStatus(Option)UserListDirectLicense(Meldung)UserListGlobalLicense(Meldung)UserListGlobalLicenseCustomerInfo(Meldung)UserListGlobalLicenseType(Option)UserListLicenseClientAccountType(Option)UserListLicenseMetrics(Meldung)UserListLicensePricing(Meldung)UserListLicensePricing.UserListPricingBuyerApprovalState(Option)UserListLicensePricing.UserListPricingCostType(Option)UserListLicenseStatus(Option)UserProperties(Meldung)UserProperty(Meldung)WarningCount(Meldung)WarningInfo(Meldung)
IngestionService
Dienst zum Senden von Zielgruppendaten an unterstützte Ziele.
| IngestAudienceMembers |
|---|
|
Lädt eine Liste von
|
| IngestEvents |
|---|
|
Lädt eine Liste von
|
| RemoveAudienceMembers |
|---|
|
Entfernt eine Liste von
|
| RetrieveRequestStatus |
|---|
|
Ruft den Status einer Anfrage anhand der Anfrage-ID ab.
|
MarketingDataInsightsService
Dienst zum Abrufen von Statistiken zu Marketingdaten.
Diese Funktion ist nur für Datenpartner verfügbar.
| RetrieveInsights |
|---|
|
Ruft Marketingdaten-Insights für eine bestimmte Nutzerliste ab. Diese Funktion ist nur für Datenpartner verfügbar. Autorisierungsheader: Diese Methode unterstützt die folgenden optionalen Headern, um zu definieren, wie die API den Zugriff für die Anfrage autorisiert:
|
PartnerLinkService
Dienst zur Verwaltung von Partnerlinks.
| CreatePartnerLink |
|---|
|
Erstellt eine Partnerverknüpfung für das angegebene Konto. Autorisierungsheader: Diese Methode unterstützt die folgenden optionalen Headern, um zu definieren, wie die API den Zugriff für die Anfrage autorisiert:
|
| DeletePartnerLink |
|---|
|
Löscht einen Partnerlink für das angegebene Konto. Autorisierungsheader: Diese Methode unterstützt die folgenden optionalen Headern, um zu definieren, wie die API den Zugriff für die Anfrage autorisiert:
|
| SearchPartnerLinks |
|---|
|
Sucht nach allen Partnerlinks zu und von einem bestimmten Konto. Autorisierungsheader: Diese Methode unterstützt die folgenden optionalen Headern, um zu definieren, wie die API den Zugriff für die Anfrage autorisiert:
|
UserListDirectLicenseService
Dienst zur Verwaltung von Direktlizenzen für Nutzerlisten. Das Löschen wird für UserListDirectLicenses nicht unterstützt. Anrufer sollten den Lizenzstatus auf DISABLED aktualisieren, um eine Lizenz zu deaktivieren.
Diese Funktion ist nur für Datenpartner verfügbar.
| CreateUserListDirectLicense |
|---|
|
Erstellt eine Direktlizenz für eine Nutzerliste. Diese Funktion ist nur für Datenpartner verfügbar.
|
| GetUserListDirectLicense |
|---|
|
Ruft eine Direktlizenz für eine Nutzerliste ab. Diese Funktion ist nur für Datenpartner verfügbar.
|
| ListUserListDirectLicenses |
|---|
|
Listet alle Direktlizenzen für Nutzerlisten auf, die dem übergeordneten Konto gehören. Diese Funktion ist nur für Datenpartner verfügbar.
|
| UpdateUserListDirectLicense |
|---|
|
Aktualisiert eine Direktlizenz für eine Nutzerliste. Diese Funktion ist nur für Datenpartner verfügbar.
|
UserListGlobalLicenseService
Dienst zur Verwaltung globaler Lizenzen für Nutzerlisten. Das Löschen ist kein unterstützter Vorgang für UserListGlobalLicenses. Anrufer sollten den Lizenzstatus auf DISABLED aktualisieren, um eine Lizenz zu deaktivieren.
Diese Funktion ist nur für Datenpartner verfügbar.
| CreateUserListGlobalLicense |
|---|
|
Erstellt eine globale Lizenz für eine Nutzerliste. Diese Funktion ist nur für Datenpartner verfügbar.
|
| GetUserListGlobalLicense |
|---|
|
Ruft eine globale Lizenz für eine Nutzerliste ab. Diese Funktion ist nur für Datenpartner verfügbar.
|
| ListUserListGlobalLicenseCustomerInfos |
|---|
|
Listet alle Kundeninformationen für eine globale Lizenz für Nutzerlisten auf. Diese Funktion ist nur für Datenpartner verfügbar.
|
| ListUserListGlobalLicenses |
|---|
|
Listet alle globalen Nutzerlistenlizenzen auf, die dem übergeordneten Konto gehören. Diese Funktion ist nur für Datenpartner verfügbar.
|
| UpdateUserListGlobalLicense |
|---|
|
Aktualisiert eine globale Lizenz für eine Nutzerliste. Diese Funktion ist nur für Datenpartner verfügbar.
|
UserListService
Dienst zur Verwaltung von UserList-Ressourcen.
| CreateUserList |
|---|
|
Erstellt eine UserList. Autorisierungsheader: Diese Methode unterstützt die folgenden optionalen Headern, um zu definieren, wie die API den Zugriff für die Anfrage autorisiert:
|
| DeleteUserList |
|---|
|
Löscht eine UserList. Autorisierungsheader: Diese Methode unterstützt die folgenden optionalen Headern, um zu definieren, wie die API den Zugriff für die Anfrage autorisiert:
|
| GetUserList |
|---|
|
Ruft eine UserList ab. Autorisierungsheader: Diese Methode unterstützt die folgenden optionalen Headern, um zu definieren, wie die API den Zugriff für die Anfrage autorisiert:
|
| ListUserLists |
|---|
|
Listet UserLists auf. Autorisierungsheader: Diese Methode unterstützt die folgenden optionalen Headern, um zu definieren, wie die API den Zugriff für die Anfrage autorisiert:
|
| UpdateUserList |
|---|
|
Aktualisiert eine UserList. Autorisierungsheader: Diese Methode unterstützt die folgenden optionalen Headern, um zu definieren, wie die API den Zugriff für die Anfrage autorisiert:
|
AdIdentifiers
Kennungen und andere Informationen, die verwendet werden, um das Conversion-Ereignis mit anderen Onlineaktivitäten (z. B. Anzeigenklicks) abzugleichen.
| Felder | |
|---|---|
session_attributes |
Optional. Sitzungsattribute für die Ereignisattribution und -modellierung. |
gclid |
Optional. Die GCLID (Google Click ID), die diesem Ereignis zugeordnet ist. |
gbraid |
Optional. Die Klick-ID für Klicks, die App-Ereignissen zugeordnet sind und von iOS-Geräten mit mindestens iOS 14 stammen. |
wbraid |
Optional. Die Klick-ID für Klicks, die Web-Events zugeordnet sind und von iOS-Geräten mit mindestens iOS 14 stammen. |
landing_page_device_info |
Optional. Informationen zum verwendeten Gerät (falls vorhanden), wenn der Nutzer nach der Interaktion mit der Anzeige auf der Website des Werbetreibenden landet. |
AddressInfo
Adressinformationen für den Nutzer.
| Felder | |
|---|---|
given_name |
Erforderlich. Vorname des Nutzers, nur Kleinbuchstaben, ohne Satzzeichen, ohne führende oder nachfolgende Leerzeichen und mit SHA-256 gehasht. |
family_name |
Erforderlich. Nachname des Nutzers, nur Kleinbuchstaben, ohne Satzzeichen, ohne führende oder nachfolgende Leerzeichen und mit SHA-256 gehasht. |
region_code |
Erforderlich. Der aus zwei Buchstaben bestehende Regionscode der Nutzeradresse nach ISO 3166-1 alpha-2. |
postal_code |
Erforderlich. Die Postleitzahl der Adresse des Nutzers. |
Altersgruppe
Demografische Altersgruppen
| Enums | |
|---|---|
AGE_RANGE_UNSPECIFIED |
Nicht angegeben. |
AGE_RANGE_UNKNOWN |
Unbekannt |
AGE_RANGE_18_24 |
Zwischen 18 und 24 Jahre alt |
AGE_RANGE_25_34 |
Zwischen 25 und 34 Jahre alt |
AGE_RANGE_35_44 |
Zwischen 35 und 44 Jahre alt. |
AGE_RANGE_45_54 |
Zwischen 45 und 54 Jahre alt. |
AGE_RANGE_55_64 |
Zwischen 55 und 64 Jahre alt. |
AGE_RANGE_65_UP |
65 Jahre und älter |
AudienceMember
Die Person, die operiert werden soll.
| Felder | |
|---|---|
destination_references[] |
Optional. Gibt an, an welche |
consent |
Optional. Die Einwilligungseinstellung für den Nutzer. |
Union-Feld data. Der Typ der zu verarbeitenden identifizierenden Daten. Für data ist nur einer der folgenden Werte zulässig: |
|
user_data |
Von Nutzern bereitgestellte Daten, die den Nutzer identifizieren. |
pair_data |
PAIR-IDs (Publisher Advertiser Identity Reconciliation). Diese Funktion ist nur für Datenpartner verfügbar. |
mobile_data |
Daten zur Identifizierung der Mobilgeräte des Nutzers. |
user_id_data |
Daten zu eindeutigen Kennungen für einen Nutzer, wie vom Werbetreibenden definiert. |
ppid_data |
Daten im Zusammenhang mit vom Publisher bereitgestellten Kennungen. Diese Funktion ist nur für Datenpartner verfügbar. |
AwsWrappedKeyInfo
Ein Datenverschlüsselungsschlüssel, der mit einem AWS KMS-Schlüssel verschlüsselt wurde.
| Felder | |
|---|---|
key_type |
Erforderlich. Der Typ des Algorithmus, der zum Verschlüsseln der Daten verwendet wird. |
role_arn |
Erforderlich. Der Amazon Resource Name der IAM-Rolle, die für den KMS-Entschlüsselungszugriff angenommen werden soll. Sollte das Format |
kek_uri |
Erforderlich. Der URI des AWS KMS-Schlüssels, der zum Entschlüsseln des DEK verwendet wird. Muss das Format |
encrypted_dek |
Erforderlich. Der base64-codierte verschlüsselte Datenverschlüsselungsschlüssel. |
KeyType
Der Typ des Algorithmus, der zum Verschlüsseln der Daten verwendet wird.
| Enums | |
|---|---|
KEY_TYPE_UNSPECIFIED |
Nicht angegebener Schlüsseltyp. Sollte nicht verwendet werden. |
XCHACHA20_POLY1305 |
Algorithmus XChaCha20-Poly1305 |
Referenz
Baseline-Kriterien, mit denen die Statistiken verglichen werden.
| Felder | |
|---|---|
Union-Feld baseline. Referenzstandort, mit dem Statistiken verglichen werden. Für baseline ist nur einer der folgenden Werte zulässig: |
|
baseline_location |
Der Referenzstandort der Anfrage. Der Referenzstandort ist eine ODER-Liste der angeforderten Regionen. |
location_auto_detection_enabled |
Wenn der Wert auf „true“ gesetzt ist, versucht der Dienst, den Baseline-Standort für Statistiken automatisch zu erkennen. |
Standort
Der Referenzstandort der Anfrage. Der Ausgangsort befindet sich in der OR-Liste der ISO 3166-1-Alpha-2-Regionscodes der angeforderten Regionen.
| Felder | |
|---|---|
region_codes[] |
Liste der ISO 3166-1-Alpha-2-Codes der Regionen. |
CartData
Die mit dem Ereignis verknüpften Warenkorbdaten.
| Felder | |
|---|---|
merchant_id |
Optional. Die Merchant Center-ID, die den Artikeln zugeordnet ist. |
merchant_feed_label |
Optional. Das Merchant Center-Feedlabel, das mit dem Feed der Artikel verknüpft ist. |
merchant_feed_language_code |
Optional. Der Sprachcode in ISO 639-1, der mit dem Merchant Center-Feed der Artikel verknüpft ist, in den Ihre Artikel hochgeladen werden. |
transaction_discount |
Optional. Die Summe aller Rabatte, die mit der Transaktion verbunden sind. |
items[] |
Optional. Die Liste der Artikel, die mit dem Ereignis verknüpft sind. |
Einwilligung
Einstellungen für die Einwilligung gemäß dem Gesetz über digitale Märkte (Digital Markets Act, DMA) für den Nutzer.
| Felder | |
|---|---|
ad_user_data |
Optional. Gibt an, ob der Nutzer der Verwendung von Nutzerdaten für Werbung zustimmt. |
ad_personalization |
Optional. Gibt an, ob der Nutzer der personalisierten Werbung zustimmt. |
ConsentStatus
Gibt an, ob der Nutzer die Einwilligung erteilt oder verweigert hat oder ob er keine Einwilligung angegeben hat.
| Enums | |
|---|---|
CONSENT_STATUS_UNSPECIFIED |
Nicht angegeben. |
CONSENT_GRANTED |
Gewährt. |
CONSENT_DENIED |
Abgelehnt. |
ContactIdInfo
Zusätzliche Informationen, wenn CONTACT_ID einer der upload_key_types ist.
| Felder | |
|---|---|
match_rate_percentage |
Nur Ausgabe. Abgleichsrate für Nutzerlisten zum Kundenabgleich. |
data_source_type |
Optional. Nicht veränderbar. Quelle der Upload-Daten |
CreatePartnerLinkRequest
Anfrage zum Erstellen einer PartnerLink-Ressource. Gibt PartnerLink zurück.
| Felder | |
|---|---|
parent |
Erforderlich. Das übergeordnete Element, das diese Sammlung von Partnerlinks besitzt. Format: accountTypes/{account_type}/accounts/{account} |
partner_link |
Erforderlich. Die zu erstellende Partnerverknüpfung. |
CreateUserListDirectLicenseRequest
Anfrage zum Erstellen einer UserListDirectLicense-Ressource.
| Felder | |
|---|---|
parent |
Erforderlich. Das Konto, in dem die Nutzerliste lizenziert wird. Muss im Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ vorliegen. |
user_list_direct_license |
Erforderlich. Die Liste der Nutzer, für die eine Direktlizenz erstellt werden soll. |
CreateUserListGlobalLicenseRequest
Anfrage zum Erstellen einer UserListGlobalLicense-Ressource.
| Felder | |
|---|---|
parent |
Erforderlich. Das Konto, in dem die Nutzerliste lizenziert wird. Muss im Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ vorliegen. |
user_list_global_license |
Erforderlich. Die globale Lizenz für die Nutzerliste, die erstellt werden soll. |
CreateUserListRequest
Anfragenachricht für CreateUserList
| Felder | |
|---|---|
parent |
Erforderlich. Das übergeordnete Konto, in dem diese Nutzerliste erstellt wird. Format: accountTypes/{account_type}/accounts/{account} |
user_list |
Erforderlich. Die zu erstellende Nutzerliste. |
validate_only |
Optional. Wenn „true“, wird die Anfrage validiert, aber nicht ausgeführt. |
CustomVariable
Benutzerdefinierte Variable für Anzeigen-Conversions.
| Felder | |
|---|---|
variable |
Optional. Der Name der benutzerdefinierten Variable, die festgelegt werden soll. Wenn die Variable für das angegebene Ziel nicht gefunden wird, wird sie ignoriert. |
value |
Optional. Der Wert, der für die benutzerdefinierte Variable gespeichert werden soll. |
destination_references[] |
Optional. Referenzstring, mit dem bestimmt wird, an welche der |
CustomerType
Typ des Kunden, der mit dem Ereignis verknüpft ist.
| Enums | |
|---|---|
CUSTOMER_TYPE_UNSPECIFIED |
Nicht angegebener CustomerType. Sollte nicht verwendet werden. |
NEW |
Der Kunde ist neu für den Werbetreibenden. |
RETURNING |
Der Kunde kehrt zum Werbetreibenden zurück. |
REENGAGED |
Der Kunde hat sich wieder mit dem Werbetreibenden in Verbindung gesetzt. |
CustomerValueBucket
Der vom Werbetreibenden geschätzte Wert des Kunden.
| Enums | |
|---|---|
CUSTOMER_VALUE_BUCKET_UNSPECIFIED |
Nicht angegebener CustomerValueBucket. Sollte nicht verwendet werden. |
LOW |
Der Kunde hat ein niedriges Umsatzpotenzial. |
MEDIUM |
Der Kunde hat ein mittleres Umsatzpotenzial. |
HIGH |
Der Kunde hat ein hohes Umsatzpotenzial. |
DataSourceType
Gibt die Quelle der Upload-Daten an.
| Enums | |
|---|---|
DATA_SOURCE_TYPE_UNSPECIFIED |
Nicht angegeben. |
DATA_SOURCE_TYPE_FIRST_PARTY |
Die hochgeladenen Daten sind selbst erhobene Daten. |
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU |
Die hochgeladenen Daten stammen von einem Drittanbieter-Kreditbüro. |
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE |
Die hochgeladenen Daten stammen aus einer Wählerdatei eines Drittanbieters. |
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA |
Die hochgeladenen Daten sind Partnerdaten von Drittanbietern. |
DeletePartnerLinkRequest
Anfrage zum Löschen einer PartnerLink-Ressource. Gibt google.protobuf.Empty zurück.
| Felder | |
|---|---|
name |
Erforderlich. Der Ressourcenname des zu löschenden Partnerlinks. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} |
DeleteUserListRequest
Anfragenachricht für DeleteUserList
| Felder | |
|---|---|
name |
Erforderlich. Der Name der zu löschenden Nutzerliste. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
validate_only |
Optional. Wenn „true“, wird die Anfrage validiert, aber nicht ausgeführt. |
Ziel
Das Google-Produkt, an das Sie Daten senden. Zum Beispiel ein Google Ads-Konto.
| Felder | |
|---|---|
reference |
Optional. ID für diese |
login_account |
Optional. Das Konto, das zum Ausführen dieses API-Aufrufs verwendet wurde. Wenn Sie Daten in die |
linked_account |
Optional. Ein Konto, auf das das |
operating_account |
Erforderlich. Das Konto, an das die Daten gesendet oder aus dem die Daten entfernt werden sollen. |
product_destination_id |
Erforderlich. Das Objekt im Produktkonto, in das die Daten aufgenommen werden sollen. Das kann beispielsweise eine Google Ads-Zielgruppen-ID, eine Display & Video 360-Zielgruppen-ID oder eine Google Ads-Conversion-Aktions-ID sein. |
DeviceInfo
Informationen zum Gerät, das zum Zeitpunkt des Ereignisses verwendet wurde (falls zutreffend).
| Felder | |
|---|---|
user_agent |
Optional. Der User-Agent-String des Geräts für den angegebenen Kontext. |
ip_address |
Optional. Die IP-Adresse des Geräts für den angegebenen Kontext. Hinweis:Google Ads unterstützt keinen IP-Adressen-Abgleich für Endnutzer im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz. Fügen Sie eine Logik hinzu, um die Weitergabe von IP-Adressen von Nutzern aus diesen Regionen auszuschließen. Informieren Sie die Nutzer außerdem verständlich und umfassend über die Daten, die Sie auf Ihren Websites, in Ihren Apps und in anderen Properties erheben, und holen Sie die Einwilligung der Nutzer ein, sofern dies gesetzlich oder gemäß den anwendbaren Google-Richtlinien erforderlich ist. Weitere Informationen zu Offline-Conversion-Importen |
Codierung
Der Codierungstyp der gehashten identifizierenden Informationen.
| Enums | |
|---|---|
ENCODING_UNSPECIFIED |
Nicht angegebener Codierungstyp. Sollte nicht verwendet werden. |
HEX |
Hexadezimale Codierung. |
BASE64 |
Base64-Codierung. |
EncryptionInfo
Informationen zur Verschlüsselung der aufgenommenen Daten.
| Felder | |
|---|---|
Union-Feld wrapped_key. Der verpackte Schlüssel, der zum Verschlüsseln der Daten verwendet wird. Für wrapped_key ist nur einer der folgenden Werte zulässig: |
|
gcp_wrapped_key_info |
Informationen zu umhüllten Schlüsseln für die Google Cloud Platform. |
aws_wrapped_key_info |
Informationen zum verpackten Schlüssel von Amazon Web Services. |
ErrorCount
Die Anzahl der Fehler für einen bestimmten Fehlergrund.
| Felder | |
|---|---|
record_count |
Anzahl der Datensätze, die aus einem bestimmten Grund nicht hochgeladen werden konnten. |
reason |
Der Fehlergrund für die fehlgeschlagenen Datensätze. |
Fehlerinformation
Fehleranzahl für jeden Fehlertyp.
| Felder | |
|---|---|
error_counts[] |
Eine Liste von Fehlern und die Anzahl der Fehler pro Fehlerursache. Möglicherweise nicht in allen Fällen verfügbar. |
ErrorReason
Fehlerursachen für die Data Manager API. HINWEIS: Dieses Enum ist nicht eingefroren und es können in Zukunft neue Werte hinzugefügt werden.
| Enums | |
|---|---|
ERROR_REASON_UNSPECIFIED |
Diesen Standardwert nicht verwenden. |
INTERNAL_ERROR |
Ein interner Fehler ist aufgetreten. |
DEADLINE_EXCEEDED |
Die Antwort auf die Anfrage hat zu lange gedauert. |
RESOURCE_EXHAUSTED |
Zu viele Anfragen. |
NOT_FOUND |
Ressource nicht gefunden. |
PERMISSION_DENIED |
Der Nutzer hat keine Berechtigung oder die Ressource wurde nicht gefunden. |
INVALID_ARGUMENT |
Bei der Anfrage ist ein Fehler aufgetreten. |
REQUIRED_FIELD_MISSING |
Pflichtfeld fehlt |
INVALID_FORMAT |
Das Format ist ungültig. |
INVALID_HEX_ENCODING |
Der HEX-codierte Wert ist fehlerhaft. |
INVALID_BASE64_ENCODING |
Der base64-codierte Wert ist fehlerhaft. |
INVALID_SHA256_FORMAT |
Mit SHA-256 codierter Wert ist fehlerhaft. |
INVALID_POSTAL_CODE |
Postleitzahl ist ungültig. |
INVALID_COUNTRY_CODE |
Der Ländercode ist ungültig. |
INVALID_ENUM_VALUE |
Der Enum-Wert kann nicht verwendet werden. |
INVALID_USER_LIST_TYPE |
Der Typ der Nutzerliste ist für diese Anfrage nicht anwendbar. |
INVALID_AUDIENCE_MEMBER |
Dieses Zielgruppenmitglied ist ungültig. |
TOO_MANY_AUDIENCE_MEMBERS |
Pro Anfrage sind maximal 10.000 Zielgruppenmitglieder zulässig. |
TOO_MANY_USER_IDENTIFIERS |
Pro Zielgruppenmitglied sind maximal 10 Nutzerkennungen zulässig. |
TOO_MANY_DESTINATIONS |
Pro Anfrage sind maximal 10 Ziele zulässig. |
INVALID_DESTINATION |
Dieses Ziel ist ungültig. |
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED |
Der Datenpartner hat keinen Zugriff auf die Nutzerliste des Betriebskontos. |
INVALID_MOBILE_ID_FORMAT |
Das Format der Mobilgeräte-ID ist ungültig. |
INVALID_USER_LIST_ID |
Die Nutzerliste ist ungültig. |
MULTIPLE_DATA_TYPES_NOT_ALLOWED |
Mehrere Datentypen dürfen nicht in einer einzelnen Anfrage aufgenommen werden. |
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER |
Zielkonfigurationen mit einem DataPartner-Anmeldekonto müssen für alle Zielkonfigurationen dasselbe Anmeldekonto haben. |
TERMS_AND_CONDITIONS_NOT_SIGNED |
Die erforderlichen Nutzungsbedingungen wurden nicht akzeptiert. |
INVALID_NUMBER_FORMAT |
Ungültiges Zahlenformat. |
INVALID_CONVERSION_ACTION_ID |
Die Conversion-Aktions-ID ist ungültig. |
INVALID_CONVERSION_ACTION_TYPE |
Der Conversion-Aktionstyp ist ungültig. |
INVALID_CURRENCY_CODE |
Der Währungscode wird nicht unterstützt. |
INVALID_EVENT |
Diese Veranstaltung ist ungültig. |
TOO_MANY_EVENTS |
Die maximale Anzahl von Ereignissen pro Anfrage beträgt 10.000. |
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS |
Das Zielkonto ist nicht für erweiterte Conversions für Leads aktiviert. |
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS |
Erweiterte Conversions können für das Zielkonto aufgrund der Richtlinien für Kundendaten von Google nicht verwendet werden. Wenden Sie sich an Ihren Google-Ansprechpartner. |
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
Im Zielkonto wurde den Nutzungsbedingungen für erweiterte Conversions nicht zugestimmt. |
DUPLICATE_DESTINATION_REFERENCE |
Zwei oder mehr Ziele in der Anfrage haben denselben Verweis. |
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER |
Nicht unterstütztes Betriebskonto für die Autorisierung von Datenpartnern. |
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER |
Das verknüpfte Konto wird für die Autorisierung des Datenpartners nicht unterstützt. |
NO_IDENTIFIERS_PROVIDED |
Ereignisdaten enthalten keine Nutzer- oder Werbe-IDs. |
INVALID_PROPERTY_TYPE |
Der Property-Typ wird nicht unterstützt. |
INVALID_STREAM_TYPE |
Der Stream-Typ wird nicht unterstützt. |
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT |
Verknüpfte Konten werden nur unterstützt, wenn das Anmeldekonto ein DATA_PARTNER-Konto ist. |
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH |
Das Anmeldekonto muss mit dem Betriebskonto für den jeweiligen Anwendungsfall übereinstimmen. |
EVENT_TIME_INVALID |
Das Ereignis ist nicht innerhalb des zulässigen Zeitfensters eingetreten. |
RESERVED_NAME_USED |
Der Parameter verwendet einen reservierten Namen. |
INVALID_EVENT_NAME |
Der Ereignisname wird nicht unterstützt. |
NOT_ALLOWLISTED |
Das Konto ist nicht auf der Zulassungsliste für die angegebene Funktion. |
INVALID_REQUEST_ID |
Die Anfrage-ID, die zum Abrufen des Status einer Anfrage verwendet wird, ist ungültig. Der Status kann nur für erfolgreiche Anfragen abgerufen werden, die nicht validate_only=true enthalten. |
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT |
Ein Ereignis hatte mindestens zwei Google Analytics-Ziele. |
FIELD_VALUE_TOO_LONG |
Der Feldwert ist zu lang. |
TOO_MANY_ELEMENTS |
Zu viele Elemente in einer Liste in der Anfrage. |
ALREADY_EXISTS |
Die Ressource ist bereits vorhanden. |
IMMUTABLE_FIELD_FOR_UPDATE |
Es wurde versucht, ein unveränderliches Feld für eine Aktualisierungsanfrage festzulegen. |
INVALID_RESOURCE_NAME |
Der Ressourcenname ist ungültig. |
INVALID_FILTER |
Der Abfragefilter ist ungültig. |
INVALID_UPDATE_MASK |
Die Aktualisierungsmaske ist ungültig. |
INVALID_PAGE_TOKEN |
Das Seitentoken ist ungültig. |
CANNOT_UPDATE_DISABLED_LICENSE |
Eine deaktivierte Lizenz kann nicht aktualisiert werden. |
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST |
Sensible Nutzerlisten können für diesen Kunden nicht lizenziert werden. |
INSUFFICIENT_COST |
Die Kosten für diese Lizenz sind zu niedrig. |
CANNOT_DISABLE_LICENSE |
Die Reseller-Lizenz kann nicht deaktiviert werden, da sie verwendet wird. |
INVALID_CLIENT_ACCOUNT_ID |
Ungültige Clientkonto-ID. |
PRICING_ONLY_ZERO_COST_ALLOWED |
Für dieses Kundenkonto sind keine Kosten ungleich null zulässig. |
PRICE_TOO_HIGH |
Die Kosten für diese Lizenz sind zu hoch. |
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE |
Der Kunde ist nicht berechtigt, eine Lizenz zu erstellen. |
INVALID_PRICING_END_DATE |
Das Enddatum für die Preisgestaltung ist für diese Lizenz ungültig. |
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT |
Eine logische Nutzerliste mit einem freigegebenen oder lizenzierten Segment kann nicht lizenziert werden. |
MISMATCHED_ACCOUNT_TYPE |
Der Kontotyp des Kunden im Antrag stimmt nicht mit dem tatsächlichen Kontotyp des Kunden überein. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE |
Der Lizenztyp unterstützt keine Kosten für das Teilen von Media. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER |
Der Kundentyp des Kunden unterstützt keine Kosten für Media-Anteile. |
INVALID_MEDIA_SHARE_COST |
Ungültige Kosten für Media-Anteil. |
INVALID_COST_TYPE |
Ungültiger Kostentyp. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST |
Der Typ „UserList“ unterstützt keine Kosten für Media-Shares. |
MAX_COST_NOT_ALLOWED |
„Max. Kosten“ ist nur für „cost_type“ MEDIA_SHARE zulässig. |
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED |
Zielgruppen für den Handel können nur direkt lizenziert werden. |
INVALID_DESCRIPTION |
Die Beschreibung ist ungültig. |
INVALID_DISPLAY_NAME |
Der Anzeigename ist ungültig. |
DISPLAY_NAME_ALREADY_USED |
Der Anzeigename wird bereits für eine andere Nutzerliste für das Konto verwendet. |
OWNERSHIP_REQUIRED_FOR_UPDATE |
Sie benötigen die Inhaberschaft, um die Nutzerliste zu ändern. |
USER_LIST_MUTATION_NOT_SUPPORTED |
Der Nutzerlistentyp ist schreibgeschützt und unterstützt keine Mutation. |
SENSITIVE_USER_LIST_IMMUTABLE |
Eine Nutzerliste, die datenschutzrechtlich bedenklich ist oder aus rechtlichen Gründen abgelehnt wurde, kann nicht von externen Nutzern geändert werden. |
BILLABLE_RECORD_COUNT_IMMUTABLE |
Das abrechenbare Datensatzfeld der Remarketing-Nutzerliste kann nach der Einrichtung nicht mehr geändert werden. |
USER_LIST_NAME_RESERVED |
Der Name der Nutzerliste ist für Systemlisten reserviert. |
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA |
Der Werbetreibende muss auf der Zulassungsliste stehen, um Remarketing-Listen verwenden zu können, die aus von ihm hochgeladenen Daten erstellt wurden. |
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE |
Die Partnerzielgruppenquelle wird für den Nutzerlistentyp nicht unterstützt. |
COMMERCE_PARTNER_NOT_ALLOWED |
Das Feld commerce_partner kann nur festgelegt werden, wenn partner_audience_source COMMERCE_AUDIENCE ist. |
UNSUPPORTED_PARTNER_AUDIENCE_INFO |
Das Feld partner_audience_info wird für den Nutzerlistentyp nicht unterstützt. |
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED |
Nutzerlisten für Partner Match können nicht über Verwaltungskonten erstellt werden. |
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
Der Datenpartner steht nicht auf der Zulassungsliste für THIRD_PARTY_PARTNER_DATA. |
ADVERTISER_TOS_NOT_ACCEPTED |
Der Werbetreibende hat die Nutzungsbedingungen des Partners nicht akzeptiert. |
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
Der Werbetreibende ist nicht auf der Zulassungsliste für THIRD_PARTY_PARTNER_DATA. |
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT |
Dieser Nutzerlistentyp wird für dieses Konto nicht unterstützt. |
INVALID_COMMERCE_PARTNER |
Das Feld commerce_partner ist ungültig. |
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE |
Der Datenanbieter steht nicht auf der Zulassungsliste für die Erstellung von Zielgruppen für den Handel. |
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES |
Die Uploadschlüsseltypen für Nutzerlisten werden nicht unterstützt. |
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG |
Die Konfiguration der aufgenommenen Nutzerlisteninformationen wird nicht unterstützt. |
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE |
Die Kontotypen werden für den Nutzerlistentyp nicht unterstützt. |
UNSUPPORTED_ACCOUNT_TYPE_FOR_PARTNER_LINK |
Die Kontotypen werden für die Partnerverknüpfung nicht unterstützt. |
Ereignis
Ein Ereignis, das eine Nutzerinteraktion mit der Website oder App eines Werbetreibenden darstellt.
| Felder | |
|---|---|
destination_references[] |
Optional. Referenzstring zur Bestimmung des Ziels. Wenn leer, wird das Ereignis an alle |
transaction_id |
Optional. Die eindeutige Kennung für dieses Ereignis. Erforderlich für Conversions aus mehreren Datenquellen. |
event_timestamp |
Erforderlich. Zeit, zu der das Ereignis aufgetreten ist. |
last_updated_timestamp |
Optional. Der Zeitpunkt, zu dem das Ereignis zuletzt aktualisiert wurde. |
user_data |
Optional. Von Nutzern bereitgestellte Daten, die den Nutzer darstellen, mit dem das Ereignis verknüpft ist. |
consent |
Optional. Informationen dazu, ob der zugehörige Nutzer verschiedene Arten von Einwilligungen erteilt hat. |
ad_identifiers |
Optional. Kennungen und andere Informationen, die verwendet werden, um das Conversion-Ereignis mit anderen Onlineaktivitäten (z. B. Anzeigenklicks) abzugleichen. |
currency |
Optional. Der Währungscode, der allen Geldwerten in diesem Ereignis zugeordnet ist. |
event_source |
Optional. Signal dafür, wo das Ereignis stattgefunden hat (Web, App, Geschäft usw.). |
event_device_info |
Optional. Informationen zum verwendeten Gerät (falls vorhanden), als das Ereignis eingetreten ist. |
cart_data |
Optional. Informationen zur Transaktion und zu den mit dem Ereignis verknüpften Artikeln. |
custom_variables[] |
Optional. Zusätzliche Schlüssel/Wert-Paar-Informationen, die an die Conversion-Container (Conversion-Aktion oder Floodlight-Aktivität) gesendet werden sollen. |
experimental_fields[] |
Optional. Eine Liste von Schlüssel/Wert-Paaren für experimentelle Felder, die möglicherweise in die API aufgenommen werden. |
user_properties |
Optional. Vom Werbetreibenden erhobene Informationen zum Nutzer zum Zeitpunkt des Ereignisses. |
event_name |
Optional. Der Name des Ereignisses. Erforderlich für GA4-Ereignisse. |
client_id |
Optional. Eine eindeutige Kennung für die Nutzerinstanz eines Webclients für diesen GA4-Webstream. |
user_id |
Optional. Eine eindeutige Kennung für einen Nutzer, die vom Werbetreibenden definiert wird. |
additional_event_parameters[] |
Optional. Ein Bucket mit beliebigen Ereignisparametern, die im Ereignis enthalten sein sollen und nicht bereits über andere strukturierte Felder angegeben wurden. |
conversion_value |
Optional. Der mit dem Ereignis verknüpfte Conversion-Wert für wertbezogene Conversions. |
EventParameter
Ereignisparameter für GA4-Ereignisse.
| Felder | |
|---|---|
parameter_name |
Erforderlich. Der Name des zu verwendenden Parameters. |
value |
Erforderlich. Die String-Darstellung des Werts des festzulegenden Parameters. |
EventSource
Die Quelle des Ereignisses.
| Enums | |
|---|---|
EVENT_SOURCE_UNSPECIFIED |
Nicht angegebene EventSource. Sollte nicht verwendet werden. |
WEB |
Das Ereignis wurde von einem Webbrowser generiert. |
APP |
Der Termin wurde aus einer App generiert. |
IN_STORE |
Das Ereignis wurde aus einer Transaktion im Geschäft generiert. |
PHONE |
Das Ereignis wurde aus einem Telefonanruf generiert. |
OTHER |
Das Ereignis wurde aus anderen Quellen generiert. |
ExperimentalField
Experimentelles Feld, das inoffizielle Felder darstellt.
| Felder | |
|---|---|
field |
Optional. Der Name des zu verwendenden Felds. |
value |
Optional. Der festzulegende Wert des Felds. |
GcpWrappedKeyInfo
Informationen zum umschlossenen Schlüssel der Google Cloud Platform.
| Felder | |
|---|---|
key_type |
Erforderlich. Der Typ des Algorithmus, der zum Verschlüsseln der Daten verwendet wird. |
wip_provider |
Erforderlich. Der Workload Identity-Poolanbieter, der für die Verwendung von KEK erforderlich ist. |
kek_uri |
Erforderlich. Ressourcen-ID des Google Cloud Platform Cloud Key Management Service. Muss das Format |
encrypted_dek |
Erforderlich. Der base64-codierte verschlüsselte Datenverschlüsselungsschlüssel. |
KeyType
Der Typ des Algorithmus, der zum Verschlüsseln der Daten verwendet wird.
| Enums | |
|---|---|
KEY_TYPE_UNSPECIFIED |
Nicht angegebener Schlüsseltyp. Sollte nicht verwendet werden. |
XCHACHA20_POLY1305 |
Algorithmus XChaCha20-Poly1305 |
Geschlecht
Die Art der demografischen Geschlechter (z. B. weiblich).
| Enums | |
|---|---|
GENDER_UNSPECIFIED |
Nicht angegeben. |
GENDER_UNKNOWN |
Unbekannt |
GENDER_MALE |
Männlich |
GENDER_FEMALE |
Weiblich. |
GetUserListDirectLicenseRequest
Anfrage zum Abrufen einer UserListDirectLicense-Ressource.
| Felder | |
|---|---|
name |
Erforderlich. Der Ressourcenname der Direktlizenz für die Nutzerliste. |
GetUserListGlobalLicenseRequest
Anfrage zum Abrufen einer UserListGlobalLicense-Ressource.
| Felder | |
|---|---|
name |
Erforderlich. Der Ressourcenname der globalen Lizenz für die Nutzerliste. |
GetUserListRequest
Anfragenachricht für GetUserList
| Felder | |
|---|---|
name |
Erforderlich. Der Ressourcenname der abzurufenden UserList. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
IngestAudienceMembersRequest
Anfrage zum Hochladen von Zielgruppenmitgliedern in die angegebenen Ziele. Gibt ein IngestAudienceMembersResponse zurück.
| Felder | |
|---|---|
destinations[] |
Erforderlich. Die Liste der Ziele, an die die Zielgruppenmitglieder gesendet werden sollen. |
audience_members[] |
Erforderlich. Die Liste der Nutzer, an die die angegebenen Ziele gesendet werden sollen. In einer einzelnen Anfrage können maximal 10.000 |
consent |
Optional. Einwilligung auf Anfrageebene, die für alle Nutzer in der Anfrage gilt. Die Einwilligung auf Nutzerebene überschreibt die Einwilligung auf Anfrageebene und kann in jedem |
validate_only |
Optional. Zu Testzwecken. Wenn |
encoding |
Optional. Erforderlich für |
encryption_info |
Optional. Informationen zur Verschlüsselung für |
terms_of_service |
Optional. Die Nutzungsbedingungen, die der Nutzer akzeptiert oder abgelehnt hat. |
IngestAudienceMembersResponse
Antwort von IngestAudienceMembersRequest.
| Felder | |
|---|---|
request_id |
Die automatisch generierte ID der Anfrage. |
IngestEventsRequest
Anfrage zum Hochladen von Zielgruppenmitgliedern in die angegebenen Ziele. Gibt ein IngestEventsResponse zurück.
| Felder | |
|---|---|
destinations[] |
Erforderlich. Die Liste der Ziele, an die die Ereignisse gesendet werden sollen. |
events[] |
Erforderlich. Die Liste der Ereignisse, die an die angegebenen Ziele gesendet werden sollen. In einer einzelnen Anfrage können maximal 2.000 |
consent |
Optional. Einwilligung auf Anfrageebene, die für alle Nutzer in der Anfrage gilt. Die Einwilligung auf Nutzerebene überschreibt die Einwilligung auf Anfrageebene und kann in jedem |
validate_only |
Optional. Zu Testzwecken. Wenn |
encoding |
Optional. Erforderlich für |
encryption_info |
Optional. Informationen zur Verschlüsselung für |
IngestEventsResponse
Antwort von IngestEventsRequest.
| Felder | |
|---|---|
request_id |
Die automatisch generierte ID der Anfrage. |
IngestedUserListInfo
Stellt eine Nutzerliste dar, die mit von Nutzern bereitgestellten Daten gefüllt wird.
| Felder | |
|---|---|
upload_key_types[] |
Erforderlich. Nicht veränderbar. Uploadschlüsseltypen dieser Nutzerliste. |
contact_id_info |
Optional. Zusätzliche Informationen, wenn |
mobile_id_info |
Optional. Zusätzliche Informationen, wenn |
user_id_info |
Optional. Zusätzliche Informationen, wenn |
pair_id_info |
Optional. Zusätzliche Informationen, wenn Diese Funktion ist nur für Datenpartner verfügbar. |
pseudonymous_id_info |
Optional. Zusätzliche Informationen für |
partner_audience_info |
Optional. Zusätzliche Informationen zu Partnerzielgruppen Diese Funktion ist nur für Datenpartner verfügbar. |
UploadKeyType
Enum mit den möglichen Uploadschlüsseltypen einer Nutzerliste.
| Enums | |
|---|---|
UPLOAD_KEY_TYPE_UNSPECIFIED |
Nicht angegeben. |
CONTACT_ID |
Kundeninformationen wie E-Mail-Adresse, Telefonnummer oder Postanschrift. |
MOBILE_ID |
IDs für mobile Werbung. |
USER_ID |
Nutzer-IDs von Drittanbietern. |
PAIR_ID |
IDs für den Identitätsabgleich zwischen Publishern und Werbetreibenden. |
PSEUDONYMOUS_ID |
Datenverwaltungsplattform-IDs: – Google-Nutzer-ID – Vom Partner bereitgestellte ID – Vom Publisher bereitgestellte ID – iOS-IDFA – Android-Werbe-ID – Roku-ID – Amazon Fire TV-ID – Xbox- oder Microsoft-ID |
Element
Stellt einen Artikel im Einkaufswagen dar, der mit dem Ereignis verknüpft ist.
| Felder | |
|---|---|
merchant_product_id |
Optional. Die Produkt-ID im Merchant Center-Konto. |
quantity |
Optional. Die Anzahl dieses Artikels, die mit dem Ereignis verknüpft ist. |
unit_price |
Optional. Der Artikelpreis ohne Steuern, Versand und etwaige Rabatte auf Transaktionsebene. |
item_id |
Optional. Eine eindeutige Kennung, mit der auf das Element verwiesen werden kann. |
additional_item_parameters[] |
Optional. Ein Bucket mit allen Ereignisparametern, die sich auf ein Element beziehen, die in das Ereignis aufgenommen werden sollen und noch nicht über andere strukturierte Felder angegeben wurden. |
ItemParameter
Ein Bucket mit allen Ereignisparametern, die sich auf ein Element beziehen, die in das Ereignis aufgenommen werden sollen und noch nicht über andere strukturierte Felder angegeben wurden.
| Felder | |
|---|---|
parameter_name |
Erforderlich. Der Name des zu verwendenden Parameters. |
value |
Erforderlich. Die String-Darstellung des Werts des festzulegenden Parameters. |
ListUserListDirectLicensesRequest
Fordert an, alle UserListDirectLicense-Ressourcen für ein bestimmtes Konto aufzulisten.
| Felder | |
|---|---|
parent |
Erforderlich. Das Konto, dessen Lizenzen abgefragt werden. Muss im Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ vorliegen. |
filter |
Optional. Filter, die auf die Listenanfrage angewendet werden sollen. Alle Felder müssen sich auf der linken Seite jeder Bedingung befinden (z. B. user_list_id = 123). Unterstützte Vorgänge:
Nicht unterstützte Felder:
|
page_size |
Optional. Die maximale Anzahl von Lizenzen, die pro Seite zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Lizenzen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt. |
page_token |
Optional. Ein Seitentoken, das von einem vorherigen Beim Paginieren müssen alle anderen für |
ListUserListDirectLicensesResponse
Antwort von ListUserListDirectLicensesRequest.
| Felder | |
|---|---|
user_list_direct_licenses[] |
Die Lizenzen für die angegebene Nutzerliste in der Anfrage. |
next_page_token |
Ein Token, das als |
ListUserListGlobalLicenseCustomerInfosRequest
Anfrage zum Auflisten aller UserListGlobalLicenseCustomerInfo-Ressourcen für eine bestimmte globale Nutzerlizenz.
| Felder | |
|---|---|
parent |
Erforderlich. Die globale Lizenz, deren Kundeninformationen abgefragt werden. Er sollte folgendes Format haben: |
filter |
Optional. Filter, die auf die Listenanfrage angewendet werden sollen. Alle Felder müssen sich auf der linken Seite jeder Bedingung befinden (z. B. user_list_id = 123). Unterstützte Vorgänge:
Nicht unterstützte Felder:
|
page_size |
Optional. Die maximale Anzahl der zurückzugebenden Lizenzen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Lizenzen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt. |
page_token |
Optional. Ein Seitentoken, das von einem vorherigen Beim Paginieren müssen alle anderen für |
ListUserListGlobalLicenseCustomerInfosResponse
Antwort von [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].
| Felder | |
|---|---|
user_list_global_license_customer_infos[] |
Die Kundeninformationen für die angegebene Lizenz in der Anfrage. |
next_page_token |
Ein Token, das als |
ListUserListGlobalLicensesRequest
Fordert an, alle UserListGlobalLicense-Ressourcen für ein bestimmtes Konto aufzulisten.
| Felder | |
|---|---|
parent |
Erforderlich. Das Konto, dessen Lizenzen abgefragt werden. Muss im Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ vorliegen. |
filter |
Optional. Filter, die auf die Listenanfrage angewendet werden sollen. Alle Felder müssen sich auf der linken Seite jeder Bedingung befinden (z. B. user_list_id = 123). Unterstützte Vorgänge:
Nicht unterstützte Felder:
|
page_size |
Optional. Die maximale Anzahl der zurückzugebenden Lizenzen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Lizenzen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt. |
page_token |
Optional. Ein Seitentoken, das von einem vorherigen Beim Paginieren müssen alle anderen für |
ListUserListGlobalLicensesResponse
Antwort von ListUserListGlobalLicensesRequest.
| Felder | |
|---|---|
user_list_global_licenses[] |
Die Lizenzen für die angegebene Nutzerliste in der Anfrage. |
next_page_token |
Ein Token, das als |
ListUserListsRequest
Anfragenachricht für ListUserLists
| Felder | |
|---|---|
parent |
Erforderlich. Das übergeordnete Konto, zu dem diese Sammlung von Nutzerlisten gehört. Format: accountTypes/{account_type}/accounts/{account} |
page_size |
Optional. Die maximale Anzahl der zurückzugebenden Nutzerlisten. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Nutzerlisten zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt. |
page_token |
Optional. Ein Seitentoken, das von einem vorherigen Beim Paginieren müssen alle anderen für |
filter |
Optional. Ein Filterstring. Alle Felder müssen sich auf der linken Seite jeder Bedingung befinden (z. B. Unterstützte Vorgänge:
Unterstützte Felder:
|
ListUserListsResponse
Antwortnachricht für ListUserLists
| Felder | |
|---|---|
user_lists[] |
Die Nutzerlisten aus dem angegebenen Konto. |
next_page_token |
Ein Token, das als |
MatchRateRange
Der Bereich der Abgleichsrate des Uploads oder der Nutzerliste.
| Enums | |
|---|---|
MATCH_RATE_RANGE_UNKNOWN |
Der Bereich der Übereinstimmungsrate ist unbekannt. |
MATCH_RATE_RANGE_NOT_ELIGIBLE |
Der Bereich der Übereinstimmungsrate ist nicht zulässig. |
MATCH_RATE_RANGE_LESS_THAN_20 |
Die Abgleichsrate liegt unter 20% (im Intervall [0, 20)). |
MATCH_RATE_RANGE_20_TO_30 |
Die Abgleichsrate liegt zwischen 20% und 30% (im Intervall [20, 31)). |
MATCH_RATE_RANGE_31_TO_40 |
Die Abgleichsrate liegt zwischen 31% und 40% (im Intervall [31, 41)). |
MATCH_RATE_RANGE_41_TO_50 |
Die Abgleichsrate liegt zwischen 41% und 50% (im Intervall [41, 51)). |
MATCH_RATE_RANGE_51_TO_60 |
Die Abgleichsrate liegt zwischen 51% und 60% (im Intervall [51, 61)). |
MATCH_RATE_RANGE_61_TO_70 |
Die Abgleichsrate liegt zwischen 61% und 70% (im Intervall [61, 71)). |
MATCH_RATE_RANGE_71_TO_80 |
Die Abgleichsrate liegt zwischen 71% und 80% (im Intervall [71, 81)). |
MATCH_RATE_RANGE_81_TO_90 |
Die Abgleichsrate liegt zwischen 81% und 90% (im Intervall [81, 91)). |
MATCH_RATE_RANGE_91_TO_100 |
Die Abgleichsrate liegt zwischen 91% und 100% (im Intervall |
MobileData
Mobile IDs für die Zielgruppe. Es ist mindestens eine mobile ID erforderlich.
| Felder | |
|---|---|
mobile_ids[] |
Erforderlich. Die Liste der IDs für Mobilgeräte (Werbe-ID/IDFA). In einem einzelnen |
MobileIdInfo
Zusätzliche Informationen, wenn MOBILE_ID einer der upload_key_types ist.
| Felder | |
|---|---|
data_source_type |
Optional. Nicht veränderbar. Quelle der Upload-Daten. |
key_space |
Erforderlich. Nicht veränderbar. Der Schlüsselbereich von mobilen IDs. |
app_id |
Erforderlich. Nicht veränderbar. Ein String, der eine mobile App, aus der die Daten erhoben wurden, eindeutig identifiziert. |
KeySpace
Schlüsselbereich für mobile ID.
| Enums | |
|---|---|
KEY_SPACE_UNSPECIFIED |
Nicht angegeben. |
IOS |
Der iOS-Schlüsselbereich. |
ANDROID |
Der Android-Schlüsselbereich. |
PairData
PAIR-IDs für die Zielgruppe. Mindestens eine PAIR-ID ist erforderlich.
Diese Funktion ist nur für Datenpartner verfügbar.
| Felder | |
|---|---|
pair_ids[] |
Erforderlich. Von Cleanroom bereitgestellte personenbezogene Daten, die mit SHA256 gehasht und mit einer kommutativen EC-Verschlüsselung mit dem Publisher-Schlüssel für die PAIR-Nutzerliste verschlüsselt wurden. In einem einzelnen |
PairIdInfo
Zusätzliche Informationen, wenn PAIR_ID einer der upload_key_types ist.
Diese Funktion ist nur für Datenpartner verfügbar.
| Felder | |
|---|---|
match_rate_percentage |
Nur Ausgabe. In diesem Feld wird der Prozentsatz der Mitgliedschaftsübereinstimmung dieser Nutzerliste mit den entsprechenden selbst erhobenen Daten des Publishers angegeben. Muss zwischen 0 und 100 (einschließlich) liegen. |
advertiser_identifier_count |
Nur Ausgabe. Die Anzahl der Datensätze mit selbst erhobenen Daten des Werbetreibenden, die in einen Data-Clean-Room-Anbieter hochgeladen wurden. Das gibt nicht die Größe einer PAIR-Nutzerliste an. |
publisher_id |
Erforderlich. Nicht veränderbar. Gibt den Publisher an, mit dem die Nutzerliste für den Identitätsabgleich zwischen Publishern und Werbetreibenden abgeglichen wird. Dieses Feld wird vom Cleanroom-Anbieter bereitgestellt und ist nur im Rahmen dieses Cleanrooms eindeutig. Sie kann nicht als globale Kennung in mehreren Cleanrooms verwendet werden. |
publisher_name |
Optional. Der beschreibende Name des Publishers, der in der Benutzeroberfläche angezeigt werden soll, um das Targeting zu verbessern. |
clean_room_identifier |
Erforderlich. Nicht veränderbar. Kennzeichnet eine eindeutige Beziehung zwischen Werbetreibendem und Publisher mit einem oder mehreren Data-Clean-Room-Anbietern. |
PartnerAudienceInfo
Zusätzliche Informationen zu Partnerzielgruppen
Diese Funktion ist nur für Datenpartner verfügbar.
| Felder | |
|---|---|
partner_audience_source |
Erforderlich. Nicht veränderbar. Die Quelle der Partnerzielgruppe. |
commerce_partner |
Optional. Der Name des Commerce-Partners. Nur zulässig, wenn |
PartnerAudienceSource
Partnerzielgruppenquelle.
| Enums | |
|---|---|
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED |
Nicht angegeben. |
COMMERCE_AUDIENCE |
Die Zielgruppenquelle des Partners ist eine Commerce-Zielgruppe. |
LINEAR_TV_AUDIENCE |
Die Zielgruppenquelle des Partners ist die Zielgruppe für lineares Fernsehen. |
AGENCY_PROVIDER_AUDIENCE |
Die Zielgruppenquelle des Partners ist eine von einer Agentur/einem Dienstleister zusammengestellte Zielgruppe. |
PartnerLink
Eine Partnerverknüpfung zwischen einem Inhaberkonto und einem Partnerkonto.
| Felder | |
|---|---|
name |
ID. Der Name des Partnerlinks. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} |
partner_link_id |
Nur Ausgabe. Die ID der Partnerverknüpfung. |
owning_account |
Erforderlich. Das Konto, das Zugriff auf das Partnerkonto gewährt. |
partner_account |
Erforderlich. Das Partnerkonto, dem vom Inhaberkonto Zugriff gewährt wurde. |
PpidData
Daten zu vom Publisher bereitgestellten Kennungen (Publisher Provided Identifiers, PPIDs) Mindestens eine PPID ist erforderlich.
Diese Funktion ist nur für Datenpartner verfügbar.
| Felder | |
|---|---|
ppids[] |
Erforderlich. Die Liste der vom Publisher bereitgestellten IDs für einen Nutzer. |
ProcessingErrorReason
Der Grund für den Verarbeitungsfehler.
| Enums | |
|---|---|
PROCESSING_ERROR_REASON_UNSPECIFIED |
Der Grund für den Verarbeitungsfehler ist unbekannt. |
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE |
Die benutzerdefinierte Variable ist ungültig. |
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED |
Der Status der benutzerdefinierten Variable ist nicht „Aktiviert“. |
PROCESSING_ERROR_REASON_EVENT_TOO_OLD |
Die Conversion ist älter als das erlaubte Höchstalter. |
PROCESSING_ERROR_REASON_DENIED_CONSENT |
Die Nutzerdaten für Anzeigen werden entweder vom Nutzer oder in den Standardeinstellungen des Werbetreibenden abgelehnt. |
PROCESSING_ERROR_REASON_NO_CONSENT |
Der Werbetreibende hat keine Einwilligung von Drittanbietern für die Hauptplattformdienste von Google Ads erteilt. |
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT |
Die allgemeine Einwilligung (die aus der Einwilligung auf Zeilenebene, der Einwilligung auf Anfrageebene und den Kontoeinstellungen ermittelt wird) konnte für diesen Nutzer nicht ermittelt werden. |
PROCESSING_ERROR_REASON_DUPLICATE_GCLID |
Es ist bereits eine Conversion mit derselben Kombination aus GCLID sowie Datum und Uhrzeit der Conversion im System vorhanden. |
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID |
Eine Conversion mit derselben Kombination aus Bestell-ID und Conversion-Aktion wurde bereits hochgeladen. |
PROCESSING_ERROR_REASON_INVALID_GBRAID |
Die GBRAID konnte nicht decodiert werden. |
PROCESSING_ERROR_REASON_INVALID_GCLID |
Die Google Click ID konnte nicht decodiert werden. |
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID |
Die Händler-ID enthält Zeichen, die keine Ziffern sind. |
PROCESSING_ERROR_REASON_INVALID_WBRAID |
Die WBRAID konnte nicht decodiert werden. |
PROCESSING_ERROR_REASON_INTERNAL_ERROR |
Interner Fehler. |
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
Die Nutzungsbedingungen für erweiterte Conversions wurden im Zielkonto nicht unterzeichnet. |
PROCESSING_ERROR_REASON_INVALID_EVENT |
Das Ereignis ist ungültig. |
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS |
Die Anzahl der abgeglichenen Transaktionen liegt unter dem Mindestschwellenwert. |
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS |
Die Transaktionen liegen unter dem Mindestbetrag. |
PROCESSING_ERROR_REASON_INVALID_FORMAT |
Das Ereignis weist einen Formatierungsfehler auf. |
PROCESSING_ERROR_REASON_DECRYPTION_ERROR |
Beim Entschlüsseln des Ereignisses ist ein Fehler aufgetreten. |
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR |
Das DEK konnte nicht entschlüsselt werden. |
PROCESSING_ERROR_REASON_INVALID_WIP |
Die WIP ist falsch formatiert oder nicht vorhanden. |
PROCESSING_ERROR_REASON_INVALID_KEK |
Mit dem KEK können keine Daten entschlüsselt werden, weil es sich um den falschen KEK handelt oder er nicht vorhanden ist. |
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED |
Das WIP konnte nicht verwendet werden, da es aufgrund der Attestierungsbedingung abgelehnt wurde. |
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED |
Das System hatte nicht die erforderlichen Berechtigungen, um auf den KEK zuzugreifen. |
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED |
Das System konnte sich nicht bei AWS authentifizieren. |
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Die UserIdentifier-Daten konnten mit dem DEK nicht entschlüsselt werden. |
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER |
Der Nutzer hat versucht, Ereignisse mit einer Werbe-ID zu erfassen, die nicht zu den Anzeigen des Betriebskontos gehört. |
ProcessingWarningReason
Der Grund für die Verarbeitungswarnung.
| Enums | |
|---|---|
PROCESSING_WARNING_REASON_UNSPECIFIED |
Der Grund für die Verarbeitungswarnung ist unbekannt. |
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED |
Das System hatte nicht die erforderlichen Berechtigungen, um auf den KEK zuzugreifen. |
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR |
Das DEK konnte nicht entschlüsselt werden. |
PROCESSING_WARNING_REASON_DECRYPTION_ERROR |
Beim Entschlüsseln des Ereignisses ist ein Fehler aufgetreten. |
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED |
Das WIP konnte nicht verwendet werden, da es aufgrund der Attestierungsbedingung abgelehnt wurde. |
PROCESSING_WARNING_REASON_INVALID_WIP |
Die WIP ist falsch formatiert oder nicht vorhanden. |
PROCESSING_WARNING_REASON_INVALID_KEK |
Mit dem KEK können keine Daten entschlüsselt werden, weil es sich um den falschen KEK handelt oder er nicht vorhanden ist. |
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Die UserIdentifier-Daten konnten mit dem DEK nicht entschlüsselt werden. |
PROCESSING_WARNING_REASON_INTERNAL_ERROR |
Interner Fehler. |
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED |
Das System konnte sich nicht bei AWS authentifizieren. |
Produkt
Verworfen. Verwenden Sie stattdessen AccountType
| Enums | |
|---|---|
PRODUCT_UNSPECIFIED |
Nicht angegebenes Produkt. Sollte nicht verwendet werden. |
GOOGLE_ADS |
Google Ads |
DISPLAY_VIDEO_PARTNER |
Display & Video 360-Partner. |
DISPLAY_VIDEO_ADVERTISER |
Display & Video 360-Werbetreibender |
DATA_PARTNER |
Datenpartner. |
ProductAccount
Stellt ein bestimmtes Konto dar.
| Felder | |
|---|---|
product |
Verworfen. Verwenden Sie stattdessen |
account_id |
Erforderlich. Die ID des Kontos. Beispiel: Ihre Google Ads-Konto-ID. |
account_type |
Optional. Der Kontotyp. Beispiel: |
AccountType
Stellt Google-Kontotypen dar. Wird verwendet, um Konten und Ziele zu finden.
| Enums | |
|---|---|
ACCOUNT_TYPE_UNSPECIFIED |
Nicht angegebenes Produkt. Sollte nicht verwendet werden. |
GOOGLE_ADS |
Google Ads |
DISPLAY_VIDEO_PARTNER |
Display & Video 360-Partner. |
DISPLAY_VIDEO_ADVERTISER |
Display & Video 360-Werbetreibender |
DATA_PARTNER |
Datenpartner. |
GOOGLE_ANALYTICS_PROPERTY |
Google Analytics. |
GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Google Ad Manager-Zielgruppenverknüpfung. |
PseudonymousIdInfo
Zusätzliche Informationen, wenn PSEUDONYMOUS_ID einer der upload_key_types ist.
| Felder | |
|---|---|
sync_status |
Nur Ausgabe. Synchronisierungsstatus der Nutzerliste. |
billable_record_count |
Optional. Nicht veränderbar. Die Anzahl der abrechenbaren Datensätze (z.B. hochgeladen oder abgeglichen). |
SyncStatus
Synchronisierungsstatus der Nutzerliste.
| Enums | |
|---|---|
SYNC_STATUS_UNSPECIFIED |
Nicht angegeben. |
CREATED |
Die Nutzerliste wurde als Platzhalter erstellt. Listeninhalte und/oder Metadaten werden noch synchronisiert. Die Nutzerliste ist noch nicht einsatzbereit. |
READY_FOR_USE |
Die Nutzerliste ist einsatzbereit. Inhalte und Cookies wurden richtig synchronisiert. |
FAILED |
Beim Synchronisieren von Inhalten und/oder Metadaten der Nutzerliste ist ein Fehler aufgetreten. Die Nutzerliste kann nicht verwendet werden. |
RemoveAudienceMembersRequest
Anfrage zum Entfernen von Nutzern aus einer Zielgruppe in den angegebenen Zielen. Gibt RemoveAudienceMembersResponse zurück.
| Felder | |
|---|---|
destinations[] |
Erforderlich. Die Liste der Ziele, aus denen die Nutzer entfernt werden sollen. |
audience_members[] |
Erforderlich. Die Liste der zu entfernenden Nutzer. |
validate_only |
Optional. Zu Testzwecken. Wenn |
encoding |
Optional. Erforderlich für |
encryption_info |
Optional. Informationen zur Verschlüsselung für |
RemoveAudienceMembersResponse
Antwort von RemoveAudienceMembersRequest.
| Felder | |
|---|---|
request_id |
Die automatisch generierte ID der Anfrage. |
RequestStatusPerDestination
Ein Anfragestatus pro Ziel.
| Felder | |
|---|---|
destination |
Ein Ziel in einer DM API-Anfrage. |
request_status |
Der Anfragestatus des Ziels. |
error_info |
Ein Fehlerinfo-Fehler mit dem Fehlergrund und den Fehleranzahlen im Zusammenhang mit dem Upload. |
warning_info |
Eine Warnung mit dem Grund für die Warnung und der Anzahl der Warnungen im Zusammenhang mit dem Upload. |
Union-Feld status. Der Status des Ziels. Für status ist nur einer der folgenden Werte zulässig: |
|
audience_members_ingestion_status |
Der Status der Anfrage zum Erfassen von Zielgruppenmitgliedern. |
events_ingestion_status |
Der Status der Anfrage zum Erfassen von Ereignissen. |
audience_members_removal_status |
Der Status des Antrags zum Entfernen von Zielgruppenmitgliedern. |
IngestAudienceMembersStatus
Der Status der Anfrage zum Erfassen von Zielgruppenmitgliedern.
| Felder | |
|---|---|
Union-Feld status. Der Status der Aufnahme der Zielgruppenmitglieder in das Ziel. Für status ist nur einer der folgenden Werte zulässig: |
|
user_data_ingestion_status |
Der Status der Aufnahme von Nutzerdaten in das Ziel. |
mobile_data_ingestion_status |
Der Status der Aufnahme mobiler Daten am Zielort. |
pair_data_ingestion_status |
Der Status der Aufnahme von Paardaten in das Ziel. |
user_id_data_ingestion_status |
Der Status der Aufnahme von Nutzer-ID-Daten in das Ziel. |
ppid_data_ingestion_status |
Der Status der PPID-Datenerfassung am Ziel. |
IngestEventsStatus
Der Status der Ereignisaufnahme am Zielort.
| Felder | |
|---|---|
record_count |
Die Gesamtzahl der in der Uploadanfrage gesendeten Ereignisse. Umfasst alle Ereignisse in der Anfrage, unabhängig davon, ob sie erfolgreich erfasst wurden oder nicht. |
IngestMobileDataStatus
Der Status der Erfassung mobiler Daten für das Ziel, einschließlich Statistiken zur Erfassung.
| Felder | |
|---|---|
record_count |
Die Gesamtzahl der Zielgruppenmitglieder, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht. |
mobile_id_count |
Die Gesamtzahl der Mobilgeräte-IDs, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Mobilgeräte-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich erfasst wurden oder nicht. |
IngestPairDataStatus
Der Status der Aufnahme von Paardaten in das Ziel, das Statistiken zur Aufnahme enthält.
| Felder | |
|---|---|
record_count |
Die Gesamtzahl der Zielgruppenmitglieder, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht. |
pair_id_count |
Die Gesamtzahl der in der Uploadanfrage für das Ziel gesendeten Paar-IDs. Enthält alle Paar-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht. |
IngestPpidDataStatus
Der Status der Aufnahme von PPID-Daten in das Ziel mit Statistiken zur Aufnahme.
| Felder | |
|---|---|
record_count |
Die Gesamtzahl der Zielgruppenmitglieder, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht. |
ppid_count |
Die Gesamtzahl der in der Uploadanfrage für das Ziel gesendeten PPIDs. Enthält alle PPIDs in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht. |
IngestUserDataStatus
Der Status der Aufnahme von Nutzerdaten in das Ziel mit Statistiken zur Aufnahme.
| Felder | |
|---|---|
record_count |
Die Gesamtzahl der Zielgruppenmitglieder, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht. |
user_identifier_count |
Die Gesamtzahl der Nutzer-IDs, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Nutzer-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht. |
upload_match_rate_range |
Der Bereich der Abgleichsrate des Uploads. |
IngestUserIdDataStatus
Der Status der Aufnahme von User-ID-Daten in das Ziel mit Statistiken zur Aufnahme.
| Felder | |
|---|---|
record_count |
Die Gesamtzahl der Zielgruppenmitglieder, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht. |
user_id_count |
Die Gesamtzahl der Nutzer-IDs, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Nutzer-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht. |
RemoveAudienceMembersStatus
Der Status des Antrags zum Entfernen von Zielgruppenmitgliedern.
| Felder | |
|---|---|
Union-Feld status. Der Status des Entfernens der Zielgruppenmitglieder aus dem Ziel. Für status ist nur einer der folgenden Werte zulässig: |
|
user_data_removal_status |
Der Status des Entfernens der Nutzerdaten aus dem Ziel. |
mobile_data_removal_status |
Der Status des Entfernens von Mobilfunkdaten aus dem Ziel. |
pair_data_removal_status |
Der Status des Entfernens der Paardaten aus dem Ziel. |
user_id_data_removal_status |
Der Status des Entfernens von Nutzer-ID-Daten aus dem Ziel. |
ppid_data_removal_status |
Der Status des Entfernens von PPID-Daten aus dem Ziel. |
RemoveMobileDataStatus
Der Status des Entfernens von Mobilfunkdaten aus dem Ziel.
| Felder | |
|---|---|
record_count |
Die Gesamtzahl der Zielgruppenmitglieder, die in der Entfernungssanfrage gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht. |
mobile_id_count |
Die Gesamtzahl der in der Anfrage zum Entfernen gesendeten Mobilgeräte-IDs. Enthält alle Mobilgeräte-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht. |
RemovePairDataStatus
Der Status des Entfernens der Paardaten aus dem Ziel.
| Felder | |
|---|---|
record_count |
Die Gesamtzahl der Zielgruppenmitglieder, die in der Entfernungssanfrage gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht. |
pair_id_count |
Die Gesamtzahl der in der Anfrage zum Entfernen gesendeten Paar-IDs. Enthält alle Geräte-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht. |
RemovePpidDataStatus
Der Status des Entfernens von PPID-Daten aus dem Ziel.
| Felder | |
|---|---|
record_count |
Die Gesamtzahl der Zielgruppenmitglieder, die in der Entfernungssanfrage gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht. |
ppid_count |
Die Gesamtzahl der in der Entfernungssanfrage gesendeten PPIDs. Enthält alle PPIDs in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht. |
RemoveUserDataStatus
Der Status des Entfernens der Nutzerdaten aus dem Ziel.
| Felder | |
|---|---|
record_count |
Die Gesamtzahl der Zielgruppenmitglieder, die in der Entfernungssanfrage gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht. |
user_identifier_count |
Die Gesamtzahl der Nutzerkennungen, die in der Entfernungsanfrage gesendet wurden. Enthält alle Nutzerkennungen in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht. |
RemoveUserIdDataStatus
Der Status des Entfernens von Nutzer-ID-Daten aus dem Ziel.
| Felder | |
|---|---|
record_count |
Die Gesamtzahl der Zielgruppenmitglieder, die in der Entfernungssanfrage gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht. |
user_id_count |
Die Gesamtzahl der Nutzer-IDs, die im Antrag auf Entfernung gesendet wurden. Enthält alle Nutzer-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht. |
RequestStatus
Der Status der Anfrage.
| Enums | |
|---|---|
REQUEST_STATUS_UNKNOWN |
Der Anfragestatus ist unbekannt. |
SUCCESS |
Die Anfrage war erfolgreich. |
PROCESSING |
Die Anfrage wird bearbeitet. |
FAILED |
Die Anfrage ist fehlgeschlagen. |
PARTIAL_SUCCESS |
Die Anfrage war teilweise erfolgreich. |
RetrieveInsightsRequest
Anfragenachricht für DM API MarketingDataInsightsService.RetrieveInsights
| Felder | |
|---|---|
parent |
Erforderlich. Das Elternkonto, zu dem die Nutzerliste gehört. Format: |
baseline |
Erforderlich. Baseline für die angeforderten Statistiken. |
user_list_id |
Erforderlich. Die ID der Nutzerliste, für die Statistiken angefordert werden. |
RetrieveInsightsResponse
Antwortnachricht für DM API MarketingDataInsightsService.RetrieveInsights
| Felder | |
|---|---|
marketing_data_insights[] |
Enthält die Statistiken für die Marketingdaten. |
MarketingDataInsight
Statistiken zu Marketingdaten.
Diese Funktion ist nur für Datenpartner verfügbar.
| Felder | |
|---|---|
dimension |
Die Dimension, zu der die Statistik gehört. |
attributes[] |
Statistiken für Werte einer bestimmten Dimension. |
AudienceInsightsDimension
Mögliche Dimensionen für die Generierung von Statistiken.
| Enums | |
|---|---|
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED |
Nicht angegeben. |
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN |
Der Wert ist in dieser Version unbekannt. |
AFFINITY_USER_INTEREST |
Ein Affinity-UserInterest. |
IN_MARKET_USER_INTEREST |
UserInterest für kaufbereite Nutzer. |
AGE_RANGE |
Eine Altersgruppe. |
GENDER |
Ein Geschlecht. |
MarketingDataInsightsAttribute
Statistiken für eine Sammlung verwandter Attribute derselben Dimension.
| Felder | |
|---|---|
user_interest_id |
Die ID des Nutzerinteresses. |
lift |
Maß für die Steigerung, die die Zielgruppe im Vergleich zur Baseline für den Attributwert erzielt. Bereich [0–1]. |
age_range |
Altersgruppe der Zielgruppe, für die die Steigerung angegeben wird. |
gender |
Geschlecht der Zielgruppe, für die die Steigerung angegeben wird. |
RetrieveRequestStatusRequest
Anfrage zum Abrufen des Status einer Anfrage, die mit einer bestimmten Anfrage-ID an die DM API gesendet wurde. Gibt RetrieveRequestStatusResponse zurück.
| Felder | |
|---|---|
request_id |
Erforderlich. Erforderlich. Die Anfrage-ID der Data Manager API-Anfrage. |
RetrieveRequestStatusResponse
Antwort von RetrieveRequestStatusRequest.
| Felder | |
|---|---|
request_status_per_destination[] |
Eine Liste der Anfragestatus pro Ziel. Die Reihenfolge der Status entspricht der Reihenfolge der Ziele in der ursprünglichen Anfrage. |
SearchPartnerLinksRequest
Anfrage zum Suchen nach PartnerLink-Ressourcen. Gibt SearchPartnerLinksResponse zurück.
| Felder | |
|---|---|
parent |
Erforderlich. Konto, in dem nach Partnerlinks gesucht werden soll. Wenn kein Format: |
page_size |
Die maximale Anzahl der zurückzugebenden Partnerlinks. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 10 Partnerlinks zurückgegeben. Der Höchstwert beträgt 100. Werte über 100 werden implizit auf 100 umgewandelt. |
page_token |
Ein Seitentoken, das von einem vorherigen Beim Paginieren müssen alle anderen für |
filter |
Optional. Ein Filterstring. Alle Felder müssen sich auf der linken Seite jeder Bedingung befinden (z. B. Unterstützte Vorgänge:
Unterstützte Felder:
Beispiel: |
SearchPartnerLinksResponse
Antwort von SearchPartnerLinksRequest.
| Felder | |
|---|---|
partner_links[] |
Die Partnerlinks für das angegebene Konto. |
next_page_token |
Ein Token, das als |
SizeInfo
Geschätzte Anzahl der Mitglieder in dieser Nutzerliste in verschiedenen Zielnetzwerken.
| Felder | |
|---|---|
display_network_members_count |
Nur Ausgabe. Geschätzte Anzahl der Mitglieder in dieser Nutzerliste im Google-Displaynetzwerk. |
search_network_members_count |
Nur Ausgabe. Geschätzte Anzahl der Mitglieder in dieser Nutzerliste in der Domain „google.com“. Diese Mitglieder können für das Targeting in Suchkampagnen verwendet werden. |
TargetNetworkInfo
Informationen zu den Voraussetzungen für verschiedene Zielnetzwerke.
| Felder | |
|---|---|
eligible_for_display |
Nur Ausgabe. Gibt an, ob diese Nutzerliste für das Google Displaynetzwerk infrage kommt. |
eligible_for_search |
Optional. Gibt an, ob diese Nutzerliste für das Google Suchnetzwerk infrage kommt. |
TermsOfService
Die Nutzungsbedingungen, die der Nutzer akzeptiert oder abgelehnt hat.
| Felder | |
|---|---|
customer_match_terms_of_service_status |
Optional. Die Nutzungsbedingungen für den Kundenabgleich: https://support.google.com/adspolicy/answer/6299717. Diese muss beim Erfassen von |
TermsOfServiceStatus
Gibt an, ob der Anrufer die Nutzungsbedingungen akzeptiert oder abgelehnt hat.
| Enums | |
|---|---|
TERMS_OF_SERVICE_STATUS_UNSPECIFIED |
Nicht angegeben. |
ACCEPTED |
Status, der angibt, dass der Anrufer die Nutzungsbedingungen akzeptiert hat. |
REJECTED |
Status, der angibt, dass der Anrufer die Nutzungsbedingungen abgelehnt hat. |
UpdateUserListDirectLicenseRequest
Anfrage zum Aktualisieren einer UserListDirectLicense-Ressource.
| Felder | |
|---|---|
user_list_direct_license |
Erforderlich. Das Feld |
update_mask |
Optional. Die Liste der zu aktualisierenden Felder. Das Sonderzeichen |
UpdateUserListGlobalLicenseRequest
Anfrage zum Aktualisieren einer UserListGlobalLicense-Ressource.
| Felder | |
|---|---|
user_list_global_license |
Erforderlich. Das Feld |
update_mask |
Optional. Die Liste der zu aktualisierenden Felder. Das Sonderzeichen |
UpdateUserListRequest
Anfragenachricht für UpdateUserList
| Felder | |
|---|---|
user_list |
Erforderlich. Die zu aktualisierende Nutzerliste. Das Feld |
update_mask |
Optional. Die Liste der zu aktualisierenden Felder. |
validate_only |
Optional. Wenn „true“, wird die Anfrage validiert, aber nicht ausgeführt. |
UserData
Daten, die den Nutzer identifizieren. Mindestens eine Kennung ist erforderlich.
| Felder | |
|---|---|
user_identifiers[] |
Erforderlich. Die Kennungen für den Nutzer. Es ist möglich, mehrere Instanzen desselben Datentyps anzugeben, z. B. mehrere E-Mail-Adressen. Geben Sie so viele Kennungen wie möglich an, um die Wahrscheinlichkeit einer Übereinstimmung zu erhöhen. In einem einzelnen |
UserIdData
User-ID-Daten mit der User-ID.
| Felder | |
|---|---|
user_id |
Erforderlich. Eine eindeutige Kennung für einen Nutzer, die vom Werbetreibenden definiert wird. |
UserIdInfo
Zusätzliche Informationen, wenn USER_ID einer der upload_key_types ist.
| Felder | |
|---|---|
data_source_type |
Optional. Nicht veränderbar. Quelle der Upload-Daten. |
UserIdentifier
Eine einzelne Kennung für den Nutzer.
| Felder | |
|---|---|
Union-Feld identifier. Es muss genau einer angegeben werden. Für identifier ist nur einer der folgenden Werte zulässig: |
|
email_address |
Gehashte E-Mail-Adresse mit der SHA-256-Hash-Funktion nach der Normalisierung. |
phone_number |
Gehashte Telefonnummer mit der SHA-256-Hash-Funktion nach der Normalisierung (E.164-Standard). |
address |
Die bekannten Komponenten der Adresse eines Nutzers. Enthält eine Gruppierung von Kennungen, die alle gleichzeitig abgeglichen werden. |
UserList
Eine Nutzerlistenressource.
| Felder | |
|---|---|
name |
ID. Der Ressourcenname der Nutzerliste. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
id |
Nur Ausgabe. Die eindeutige ID der Nutzerliste. |
read_only |
Nur Ausgabe. Eine Option, die angibt, ob ein Nutzer eine Liste bearbeiten darf. |
membership_duration |
Optional. Die Dauer, die ein Nutzer in der Nutzerliste verbleibt. Gültige Zeiträume sind genaue Vielfache von 24 Stunden (86.400 Sekunden). Wenn Sie einen Wert angeben, der kein genaues Vielfaches von 24 Stunden ist, wird der Fehler INVALID_ARGUMENT zurückgegeben. |
access_reason |
Nur Ausgabe. Der Grund, warum diesem Konto Zugriff auf die Liste gewährt wurde. |
size_info |
Nur Ausgabe. Geschätzte Anzahl der Mitglieder in dieser Nutzerliste in verschiedenen Zielnetzwerken. |
target_network_info |
Optional. Informationen zu den Voraussetzungen für verschiedene Zielnetzwerke. |
display_name |
Erforderlich. Der Anzeigename der Nutzerliste. |
description |
Optional. Eine Beschreibung der Nutzerliste. |
membership_status |
Optional. Mitgliedschaftsstatus dieser Nutzerliste. |
integration_code |
Optional. Eine ID aus einem externen System. Sie wird von Verkäufern von Nutzerlisten verwendet, um IDs in ihren Systemen abzugleichen. |
closing_reason |
Nur Ausgabe. Der Grund, warum der Mitgliedschaftsstatus dieser Nutzerliste geschlossen ist. |
account_access_status |
Optional. Gibt an, ob diese Freigabe noch aktiviert ist. Wenn eine Nutzerliste für das Konto freigegeben wird, für das dieses Feld festgelegt ist, wird |
Union-Feld user_list_info. Zusätzliche Informationen zur Nutzerliste. Für user_list_info ist nur einer der folgenden Werte zulässig: |
|
ingested_user_list_info |
Optional. Stellt eine Nutzerliste dar, die mit von Nutzern erfassten Daten gefüllt wird. |
AccessReason
Aufzählung, die mögliche Zugriffsgründe beschreibt.
| Enums | |
|---|---|
ACCESS_REASON_UNSPECIFIED |
Nicht angegeben. |
OWNED |
Die Ressource gehört dem Nutzer. |
SHARED |
Die Ressource wird für den Nutzer freigegeben. |
LICENSED |
Die Ressource ist für den Nutzer lizenziert. |
SUBSCRIBED |
Der Nutzer hat die Ressource abonniert. |
AFFILIATED |
Der Nutzer kann auf die Ressource zugreifen. |
AccessStatus
Gibt an, ob dieser Client weiterhin Zugriff auf die Liste hat.
| Enums | |
|---|---|
ACCESS_STATUS_UNSPECIFIED |
Nicht angegeben. |
ENABLED |
Der Zugriff ist aktiviert. |
DISABLED |
Der Zugriff ist deaktiviert. |
ClosingReason
Gibt den Grund an, warum die Nutzerliste geschlossen wurde. Diese Enumeration wird nur verwendet, wenn eine Liste automatisch vom System geschlossen wird.
| Enums | |
|---|---|
CLOSING_REASON_UNSPECIFIED |
Nicht angegeben. |
UNUSED |
Die Nutzerliste wurde geschlossen, weil sie in letzter Zeit nicht für das Targeting verwendet wurde. Weitere Informationen finden Sie unter https://support.google.com/google-ads/answer/2472738. |
MembershipStatus
Status der Nutzerliste.
| Enums | |
|---|---|
MEMBERSHIP_STATUS_UNSPECIFIED |
Nicht angegeben. |
OPEN |
Offen: Der Nutzerliste werden Mitglieder hinzugefügt und sie kann für das Targeting verwendet werden. |
CLOSED |
Status „Geschlossen“: Es werden keine neuen Mitglieder hinzugefügt. |
UserListDirectLicense
Eine Direktlizenz für eine Nutzerliste.
Diese Funktion ist nur für Datenpartner verfügbar.
| Felder | |
|---|---|
name |
ID. Der Ressourcenname der Direktlizenz für die Nutzerliste. |
user_list_display_name |
Nur Ausgabe. Name der Nutzerliste, für die eine Lizenz erteilt wird. Dieses Feld ist schreibgeschützt. |
client_account_display_name |
Nur Ausgabe. Name des Kunden des Kunden, an den die Nutzerliste lizenziert wird. Dieses Feld ist schreibgeschützt. |
pricing |
Optional. Preise für UserListDirectLicense. |
historical_pricings[] |
Nur Ausgabe. Preisverlauf dieser Nutzerlistenlizenz. Dieses Feld ist schreibgeschützt. |
metrics |
Nur Ausgabe. Messwerte zu dieser Lizenz Dieses Feld ist schreibgeschützt und wird nur ausgefüllt, wenn das Start- und Enddatum im Aufruf „ListUserListDirectLicenses“ festgelegt sind. |
user_list_id |
Nicht veränderbar. ID der Nutzerliste, für die eine Lizenz erteilt wird. |
client_account_type |
Nicht veränderbar. Kontotyp des Kunden, für den die Nutzerliste lizenziert wird. |
client_account_id |
Nicht veränderbar. ID des Kunden, an den die Nutzerliste lizenziert wird. |
status |
Optional. Status von UserListDirectLicense: ENABLED oder DISABLED. |
UserListGlobalLicense
Eine globale Lizenz für die Nutzerliste.
Diese Funktion ist nur für Datenpartner verfügbar.
| Felder | |
|---|---|
name |
ID. Der Ressourcenname der globalen Lizenz für die Nutzerliste. |
user_list_display_name |
Nur Ausgabe. Name der Nutzerliste, für die eine Lizenz erteilt wird. Dieses Feld ist schreibgeschützt. |
pricing |
Optional. Preise für UserListGlobalLicense. |
historical_pricings[] |
Nur Ausgabe. Preisverlauf dieser Nutzerlistenlizenz. Dieses Feld ist schreibgeschützt. |
metrics |
Nur Ausgabe. Messwerte zu dieser Lizenz Dieses Feld ist schreibgeschützt und wird nur ausgefüllt, wenn das Start- und Enddatum im Aufruf „ListUserListGlobalLicenses“ festgelegt sind. |
user_list_id |
Nicht veränderbar. ID der Nutzerliste, für die eine Lizenz erteilt wird. |
license_type |
Nicht veränderbar. Produkttyp des Kunden, für den die Nutzerliste lizenziert wird. |
status |
Optional. Status von „UserListGlobalLicense“: ENABLED oder DISABLED. |
UserListGlobalLicenseCustomerInfo
Informationen zu einem Kunden einer globalen Lizenz für Nutzerlisten. Sie wird automatisch vom System erstellt, wenn ein Kunde eine globale Lizenz erwirbt.
| Felder | |
|---|---|
name |
ID. Der Ressourcenname des globalen Lizenzkunden der Nutzerliste. |
user_list_id |
Nur Ausgabe. ID der Nutzerliste, für die eine Lizenz erteilt wird. |
user_list_display_name |
Nur Ausgabe. Name der Nutzerliste, für die eine Lizenz erteilt wird. |
license_type |
Nur Ausgabe. Produkttyp des Kunden, für den die Nutzerliste lizenziert wird. |
status |
Nur Ausgabe. Status von UserListDirectLicense: ENABLED oder DISABLED. |
pricing |
Nur Ausgabe. Preise für UserListDirectLicense. |
client_account_type |
Nur Ausgabe. Produkttyp des Kunden, für den die Nutzerliste lizenziert wird. |
client_account_id |
Nur Ausgabe. ID des Kunden, an den die Nutzerliste lizenziert wird. |
client_account_display_name |
Nur Ausgabe. Name des Kunden des Kunden, an den die Nutzerliste lizenziert wird. |
historical_pricings[] |
Nur Ausgabe. Preisverlauf dieser Nutzerlistenlizenz. |
metrics |
Nur Ausgabe. Messwerte zu dieser Lizenz Dieses Feld wird nur ausgefüllt, wenn das Start- und Enddatum im Aufruf „ListUserListGlobalLicenseCustomerInfos“ festgelegt sind. |
UserListGlobalLicenseType
Globale Lizenztypen für Nutzerlisten.
| Enums | |
|---|---|
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED |
KEINE ANGABE |
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER |
Reseller-Lizenz |
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE |
DataMart Sell Side-Lizenz. |
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE |
DataMart Buy Side-Lizenz. |
UserListLicenseClientAccountType
Mögliches Produkt eines Kundenkontos für eine Nutzerlistenlizenz.
| Enums | |
|---|---|
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN |
Unbekannt |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS |
Google Ads-Kunde |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER |
Display & Video 360-Partner. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER |
Display & Video 360-Werbetreibender |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Google Ad Manager-Zielgruppenverknüpfung. |
UserListLicenseMetrics
Messwerte für eine Nutzerlistenlizenz.
| Felder | |
|---|---|
click_count |
Nur Ausgabe. Die Anzahl der Klicks für die Lizenz für die Nutzerliste. |
impression_count |
Nur Ausgabe. Die Anzahl der Impressionen für die Nutzerlistenlizenz. |
revenue_usd_micros |
Nur Ausgabe. Der Umsatz für die Nutzerlistenlizenz in μUSD. |
start_date |
Nur Ausgabe. Das Startdatum (einschließlich) der Messwerte im Format JJJJMMTT. Beispiel: 20260102 steht für den 2. Januar 2026. Wenn |
end_date |
Nur Ausgabe. Das Enddatum (einschließlich) der Messwerte im Format JJJJMMTT. Beispiel: 20260102 steht für den 2. Januar 2026. Wenn |
UserListLicensePricing
Preise für Nutzerlistenlizenzen.
| Felder | |
|---|---|
pricing_id |
Nur Ausgabe. Die ID dieser Preisgestaltung. |
start_time |
Nur Ausgabe. Beginn der Preisgestaltung. |
end_time |
Optional. Ende des Preiszeitraums. |
pricing_active |
Nur Ausgabe. Gibt an, ob diese Preise aktiv sind. |
buyer_approval_state |
Nur Ausgabe. Der Status der Käufergenehmigung für diesen Preis. Dieses Feld ist schreibgeschützt. |
cost_micros |
Optional. Die mit dem Modell verbundenen Kosten in Mikroeinheiten (10^-6) in der Währung, die im Feld „currency_code“ angegeben ist. Beispiel: 2000000 bedeutet 2 $, wenn |
currency_code |
Optional. Die Währung, in der „cost“ und „max_cost“ angegeben werden. Muss ein aus drei Buchstaben bestehender Währungscode gemäß ISO 4217 sein. |
cost_type |
Nicht veränderbar. Der Kostentyp dieses Preises. Kann nur im |
max_cost_micros |
Optional. Der maximale CPM, der für eine Commerce-Zielgruppe berechnet werden kann, wenn der Kostentyp MEDIA_SHARE verwendet wird. Der Wert wird in Mikroeinheiten (10^-6) und in der Währung angegeben, die im Feld „currency_code“ angegeben ist. Beispiel: 2000000 bedeutet 2 $, wenn Das ist nur relevant, wenn „cost_type“ MEDIA_SHARE ist. Wenn „cost_type“ nicht MEDIA_SHARE ist und dieses Feld festgelegt ist, wird der Fehler MAX_COST_NOT_ALLOWED zurückgegeben. Wenn der Wert nicht festgelegt oder auf |
UserListPricingBuyerApprovalState
Status der Käufergenehmigung für die Preisgestaltung von Nutzerlisten.
| Enums | |
|---|---|
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED |
KEINE ANGABE |
PENDING |
Der Nutzerlisten-Client hat die vom Inhaber der Nutzerliste festgelegten Preisbedingungen noch nicht akzeptiert. |
APPROVED |
Der Nutzerlisten-Client hat die vom Inhaber der Nutzerliste festgelegten Preisbedingungen akzeptiert. |
REJECTED |
Der Nutzerlisten-Client hat die vom Inhaber der Nutzerliste festgelegten Preisbedingungen abgelehnt. |
UserListPricingCostType
Kostentyp für die Preisgestaltung von Nutzerlisten.
| Enums | |
|---|---|
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED |
Nicht angegeben |
CPC |
Cost-per-Click. |
CPM |
Cost-per-1000-Impressions |
MEDIA_SHARE |
Medienfreigabe |
UserListLicenseStatus
Lizenzstatus der Nutzerliste.
| Enums | |
|---|---|
USER_LIST_LICENSE_STATUS_UNSPECIFIED |
Unbekannt |
USER_LIST_LICENSE_STATUS_ENABLED |
Aktiv: Die Nutzerliste wird noch lizenziert. |
USER_LIST_LICENSE_STATUS_DISABLED |
Inaktiver Status: Die Nutzerliste wird nicht mehr lizenziert. |
UserProperties
Vom Werbetreibenden erhobene Informationen zum Nutzer zum Zeitpunkt des Ereignisses. Weitere Informationen finden Sie unter https://support.google.com/google-ads/answer/14007601.
| Felder | |
|---|---|
customer_type |
Optional. Typ des Kunden, der mit dem Ereignis verknüpft ist. |
customer_value_bucket |
Optional. Der vom Werbetreibenden geschätzte Wert des Kunden. |
additional_user_properties[] |
Optional. Ein Bucket mit allen zusätzlichen Nutzereigenschaften für den Nutzer, der mit diesem Ereignis verknüpft ist. |
UserProperty
Ein Bucket mit allen zusätzlichen Nutzereigenschaften für den Nutzer, der mit diesem Ereignis verknüpft ist.
| Felder | |
|---|---|
property_name |
Erforderlich. Der Name der zu verwendenden Nutzereigenschaft. |
value |
Erforderlich. Die Stringdarstellung des zu verwendenden Werts der Nutzereigenschaft. |
WarningCount
Die Anzahl der Warnungen für einen bestimmten Warnungsgrund.
| Felder | |
|---|---|
record_count |
Die Anzahl der Datensätze, für die eine Warnung ausgegeben wurde. |
reason |
Der Grund für die Warnung. |
WarningInfo
Anzahl der Warnungen für jeden Warnungstyp.
| Felder | |
|---|---|
warning_counts[] |
Eine Liste der Warnungen und die Anzahl der Warnungen pro Grund. |