Package google.ads.datamanager.v1

Index

IngestionService

Dienst zum Senden von Zielgruppendaten an unterstützte Ziele.

IngestAudienceMembers

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

Lädt eine Liste von AudienceMember-Ressourcen in die bereitgestellte Destination hoch.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
IngestEvents

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

Lädt eine Liste von Event-Ressourcen aus dem bereitgestellten Destination hoch.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
RemoveAudienceMembers

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

Entfernt eine Liste von AudienceMember-Ressourcen aus dem bereitgestellten Destination.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
RetrieveRequestStatus

rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse)

Ruft den Status einer Anfrage anhand der Anfrage-ID ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager

MarketingDataInsightsService

Dienst zum Abrufen von Statistiken zu Marketingdaten.

Diese Funktion ist nur für Datenpartner verfügbar.

RetrieveInsights

rpc RetrieveInsights(RetrieveInsightsRequest) returns (RetrieveInsightsResponse)

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:

  • login-account: (Optional) Der Ressourcenname des Kontos, in dem das Google-Konto der Anmeldedaten ein Nutzer ist. Wenn nichts anderes festgelegt ist, wird standardmäßig das Konto der Anfrage verwendet. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Optional) Der Ressourcenname des Kontos mit einer eingerichteten Produktverknüpfung zur login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager

PartnerLinkService

Dienst zur Verwaltung von Partnerlinks.

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

rpc CreateUserListDirectLicense(CreateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Erstellt eine Direktlizenz für eine Nutzerliste.

Diese Funktion ist nur für Datenpartner verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
GetUserListDirectLicense

rpc GetUserListDirectLicense(GetUserListDirectLicenseRequest) returns (UserListDirectLicense)

Ruft eine Direktlizenz für eine Nutzerliste ab.

Diese Funktion ist nur für Datenpartner verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
ListUserListDirectLicenses

rpc ListUserListDirectLicenses(ListUserListDirectLicensesRequest) returns (ListUserListDirectLicensesResponse)

Listet alle Direktlizenzen für Nutzerlisten auf, die dem übergeordneten Konto gehören.

Diese Funktion ist nur für Datenpartner verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
UpdateUserListDirectLicense

rpc UpdateUserListDirectLicense(UpdateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Aktualisiert eine Direktlizenz für eine Nutzerliste.

Diese Funktion ist nur für Datenpartner verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager

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

rpc CreateUserListGlobalLicense(CreateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Erstellt eine globale Lizenz für eine Nutzerliste.

Diese Funktion ist nur für Datenpartner verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
GetUserListGlobalLicense

rpc GetUserListGlobalLicense(GetUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Ruft eine globale Lizenz für eine Nutzerliste ab.

Diese Funktion ist nur für Datenpartner verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
ListUserListGlobalLicenseCustomerInfos

rpc ListUserListGlobalLicenseCustomerInfos(ListUserListGlobalLicenseCustomerInfosRequest) returns (ListUserListGlobalLicenseCustomerInfosResponse)

Listet alle Kundeninformationen für eine globale Lizenz für Nutzerlisten auf.

Diese Funktion ist nur für Datenpartner verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
ListUserListGlobalLicenses

rpc ListUserListGlobalLicenses(ListUserListGlobalLicensesRequest) returns (ListUserListGlobalLicensesResponse)

Listet alle globalen Nutzerlistenlizenzen auf, die dem übergeordneten Konto gehören.

Diese Funktion ist nur für Datenpartner verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
UpdateUserListGlobalLicense

rpc UpdateUserListGlobalLicense(UpdateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Aktualisiert eine globale Lizenz für eine Nutzerliste.

Diese Funktion ist nur für Datenpartner verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager

UserListService

Dienst zur Verwaltung von UserList-Ressourcen.

CreateUserList

rpc CreateUserList(CreateUserListRequest) returns (UserList)

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:

  • login-account: (Optional) Der Ressourcenname des Kontos, in dem das Google-Konto der Anmeldedaten ein Nutzer ist. Wenn nichts anderes festgelegt ist, wird standardmäßig das Konto der Anfrage verwendet. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Optional) Der Ressourcenname des Kontos mit einer eingerichteten Produktverknüpfung zur login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
DeleteUserList

rpc DeleteUserList(DeleteUserListRequest) returns (Empty)

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:

  • login-account: (Optional) Der Ressourcenname des Kontos, in dem das Google-Konto der Anmeldedaten ein Nutzer ist. Wenn nichts anderes festgelegt ist, wird standardmäßig das Konto der Anfrage verwendet. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Optional) Der Ressourcenname des Kontos mit einer eingerichteten Produktverknüpfung zur login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
GetUserList

rpc GetUserList(GetUserListRequest) returns (UserList)

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:

  • login-account: (Optional) Der Ressourcenname des Kontos, in dem das Google-Konto der Anmeldedaten ein Nutzer ist. Wenn nichts anderes festgelegt ist, wird standardmäßig das Konto der Anfrage verwendet. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Optional) Der Ressourcenname des Kontos mit einer eingerichteten Produktverknüpfung zur login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
ListUserLists

rpc ListUserLists(ListUserListsRequest) returns (ListUserListsResponse)

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:

  • login-account: (Optional) Der Ressourcenname des Kontos, in dem das Google-Konto der Anmeldedaten ein Nutzer ist. Wenn nichts anderes festgelegt ist, wird standardmäßig das Konto der Anfrage verwendet. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Optional) Der Ressourcenname des Kontos mit einer eingerichteten Produktverknüpfung zur login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
UpdateUserList

rpc UpdateUserList(UpdateUserListRequest) returns (UserList)

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:

  • login-account: (Optional) Der Ressourcenname des Kontos, in dem das Google-Konto der Anmeldedaten ein Nutzer ist. Wenn nichts anderes festgelegt ist, wird standardmäßig das Konto der Anfrage verwendet. Format: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Optional) Der Ressourcenname des Kontos mit einer eingerichteten Produktverknüpfung zur login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager

AdIdentifiers

Kennungen und andere Informationen, die verwendet werden, um das Conversion-Ereignis mit anderen Onlineaktivitäten (z. B. Anzeigenklicks) abzugleichen.

Felder
session_attributes

string

Optional. Sitzungsattribute für die Ereignisattribution und -modellierung.

gclid

string

Optional. Die GCLID (Google Click ID), die diesem Ereignis zugeordnet ist.

gbraid

string

Optional. Die Klick-ID für Klicks, die App-Ereignissen zugeordnet sind und von iOS-Geräten mit mindestens iOS 14 stammen.

wbraid

string

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

DeviceInfo

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

string

Erforderlich. Vorname des Nutzers, nur Kleinbuchstaben, ohne Satzzeichen, ohne führende oder nachfolgende Leerzeichen und mit SHA-256 gehasht.

family_name

string

Erforderlich. Nachname des Nutzers, nur Kleinbuchstaben, ohne Satzzeichen, ohne führende oder nachfolgende Leerzeichen und mit SHA-256 gehasht.

region_code

string

Erforderlich. Der aus zwei Buchstaben bestehende Regionscode der Nutzeradresse nach ISO 3166-1 alpha-2.

postal_code

string

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[]

string

Optional. Gibt an, an welche Destination das Zielgruppenmitglied gesendet werden soll.

consent

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

UserData

Von Nutzern bereitgestellte Daten, die den Nutzer identifizieren.

pair_data

PairData

PAIR-IDs (Publisher Advertiser Identity Reconciliation).

Diese Funktion ist nur für Datenpartner verfügbar.

mobile_data

MobileData

Daten zur Identifizierung der Mobilgeräte des Nutzers.

user_id_data

UserIdData

Daten zu eindeutigen Kennungen für einen Nutzer, wie vom Werbetreibenden definiert.

ppid_data

PpidData

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

KeyType

Erforderlich. Der Typ des Algorithmus, der zum Verschlüsseln der Daten verwendet wird.

role_arn

string

Erforderlich. Der Amazon Resource Name der IAM-Rolle, die für den KMS-Entschlüsselungszugriff angenommen werden soll. Sollte das Format arn:{partition}:iam::{account_id}:role/{role_name} haben.

kek_uri

string

Erforderlich. Der URI des AWS KMS-Schlüssels, der zum Entschlüsseln des DEK verwendet wird. Muss das Format arn:{partition}:kms:{region}:{account_id}:key/{key_id} oder aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id} haben.

encrypted_dek

string

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

Location

Der Referenzstandort der Anfrage. Der Referenzstandort ist eine ODER-Liste der angeforderten Regionen.

location_auto_detection_enabled

bool

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[]

string

Liste der ISO 3166-1-Alpha-2-Codes der Regionen.

CartData

Die mit dem Ereignis verknüpften Warenkorbdaten.

Felder
merchant_id

string

Optional. Die Merchant Center-ID, die den Artikeln zugeordnet ist.

merchant_feed_label

string

Optional. Das Merchant Center-Feedlabel, das mit dem Feed der Artikel verknüpft ist.

merchant_feed_language_code

string

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

double

Optional. Die Summe aller Rabatte, die mit der Transaktion verbunden sind.

items[]

Item

Optional. Die Liste der Artikel, die mit dem Ereignis verknüpft sind.

Einstellungen für die Einwilligung gemäß dem Gesetz über digitale Märkte (Digital Markets Act, DMA) für den Nutzer.

Felder
ad_user_data

ConsentStatus

Optional. Gibt an, ob der Nutzer der Verwendung von Nutzerdaten für Werbung zustimmt.

ad_personalization

ConsentStatus

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

int32

Nur Ausgabe. Abgleichsrate für Nutzerlisten zum Kundenabgleich.

data_source_type

DataSourceType

Optional. Nicht veränderbar. Quelle der Upload-Daten

CreatePartnerLinkRequest

Anfrage zum Erstellen einer PartnerLink-Ressource. Gibt PartnerLink zurück.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
parent

string

Erforderlich. Das übergeordnete Element, das diese Sammlung von Partnerlinks besitzt. Format: accountTypes/{account_type}/accounts/{account}

CreateUserListDirectLicenseRequest

Anfrage zum Erstellen einer UserListDirectLicense-Ressource.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
parent

string

Erforderlich. Das Konto, in dem die Nutzerliste lizenziert wird. Muss im Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ vorliegen.

user_list_direct_license

UserListDirectLicense

Erforderlich. Die Liste der Nutzer, für die eine Direktlizenz erstellt werden soll.

CreateUserListGlobalLicenseRequest

Anfrage zum Erstellen einer UserListGlobalLicense-Ressource.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
parent

string

Erforderlich. Das Konto, in dem die Nutzerliste lizenziert wird. Muss im Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ vorliegen.

user_list_global_license

UserListGlobalLicense

Erforderlich. Die globale Lizenz für die Nutzerliste, die erstellt werden soll.

CreateUserListRequest

Anfragenachricht für CreateUserList

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
parent

string

Erforderlich. Das übergeordnete Konto, in dem diese Nutzerliste erstellt wird. Format: accountTypes/{account_type}/accounts/{account}

user_list

UserList

Erforderlich. Die zu erstellende Nutzerliste.

validate_only

bool

Optional. Wenn „true“, wird die Anfrage validiert, aber nicht ausgeführt.

CustomVariable

Benutzerdefinierte Variable für Anzeigen-Conversions.

Felder
variable

string

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

string

Optional. Der Wert, der für die benutzerdefinierte Variable gespeichert werden soll.

destination_references[]

string

Optional. Referenzstring, mit dem bestimmt wird, an welche der Event.destination_references die benutzerdefinierte Variable gesendet werden soll. Wenn leer, wird Event.destination_references verwendet.

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.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
name

string

Erforderlich. Der Ressourcenname des zu löschenden Partnerlinks. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

DeleteUserListRequest

Anfragenachricht für DeleteUserList

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
name

string

Erforderlich. Der Name der zu löschenden Nutzerliste. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

validate_only

bool

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

string

Optional. ID für diese Destination-Ressource, die innerhalb der Anfrage eindeutig ist. Wird verwendet, um in IngestEventsRequest und IngestAudienceMembersRequest auf diese Destination zu verweisen.

login_account

ProductAccount

Optional. Das Konto, das zum Ausführen dieses API-Aufrufs verwendet wurde. Wenn Sie Daten in die operating_account einfügen oder daraus entfernen möchten, muss diese login_account Schreibzugriff auf die operating_account haben. Das kann beispielsweise ein Verwaltungskonto von operating_account oder ein Konto mit einer bestehenden Verknüpfung zu operating_account sein.

linked_account

ProductAccount

Optional. Ein Konto, auf das das login_account des aufrufenden Nutzers über eine eingerichtete Kontoverknüpfung zugreifen kann. Beispiel: Der login_account eines Datenpartners hat möglicherweise Zugriff auf den linked_account eines Kunden. Der Partner kann dieses Feld verwenden, um Daten aus dem linked_account an ein anderes operating_account zu senden.

operating_account

ProductAccount

Erforderlich. Das Konto, an das die Daten gesendet oder aus dem die Daten entfernt werden sollen.

product_destination_id

string

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

string

Optional. Der User-Agent-String des Geräts für den angegebenen Kontext.

ip_address

string

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

GcpWrappedKeyInfo

Informationen zu umhüllten Schlüsseln für die Google Cloud Platform.

aws_wrapped_key_info

AwsWrappedKeyInfo

Informationen zum verpackten Schlüssel von Amazon Web Services.

ErrorCount

Die Anzahl der Fehler für einen bestimmten Fehlergrund.

Felder
record_count

int64

Anzahl der Datensätze, die aus einem bestimmten Grund nicht hochgeladen werden konnten.

reason

ProcessingErrorReason

Der Fehlergrund für die fehlgeschlagenen Datensätze.

Fehlerinformation

Fehleranzahl für jeden Fehlertyp.

Felder
error_counts[]

ErrorCount

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.

Ereignis

Ein Ereignis, das eine Nutzerinteraktion mit der Website oder App eines Werbetreibenden darstellt.

Felder
destination_references[]

string

Optional. Referenzstring zur Bestimmung des Ziels. Wenn leer, wird das Ereignis an alle destinations in der Anfrage gesendet.

transaction_id

string

Optional. Die eindeutige Kennung für dieses Ereignis. Erforderlich für Conversions aus mehreren Datenquellen.

event_timestamp

Timestamp

Erforderlich. Zeit, zu der das Ereignis aufgetreten ist.

last_updated_timestamp

Timestamp

Optional. Der Zeitpunkt, zu dem das Ereignis zuletzt aktualisiert wurde.

user_data

UserData

Optional. Von Nutzern bereitgestellte Daten, die den Nutzer darstellen, mit dem das Ereignis verknüpft ist.

consent

Consent

Optional. Informationen dazu, ob der zugehörige Nutzer verschiedene Arten von Einwilligungen erteilt hat.

ad_identifiers

AdIdentifiers

Optional. Kennungen und andere Informationen, die verwendet werden, um das Conversion-Ereignis mit anderen Onlineaktivitäten (z. B. Anzeigenklicks) abzugleichen.

currency

string

Optional. Der Währungscode, der allen Geldwerten in diesem Ereignis zugeordnet ist.

event_source

EventSource

Optional. Signal dafür, wo das Ereignis stattgefunden hat (Web, App, Geschäft usw.).

event_device_info

DeviceInfo

Optional. Informationen zum verwendeten Gerät (falls vorhanden), als das Ereignis eingetreten ist.

cart_data

CartData

Optional. Informationen zur Transaktion und zu den mit dem Ereignis verknüpften Artikeln.

custom_variables[]

CustomVariable

Optional. Zusätzliche Schlüssel/Wert-Paar-Informationen, die an die Conversion-Container (Conversion-Aktion oder Floodlight-Aktivität) gesendet werden sollen.

experimental_fields[]

ExperimentalField

Optional. Eine Liste von Schlüssel/Wert-Paaren für experimentelle Felder, die möglicherweise in die API aufgenommen werden.

user_properties

UserProperties

Optional. Vom Werbetreibenden erhobene Informationen zum Nutzer zum Zeitpunkt des Ereignisses.

event_name

string

Optional. Der Name des Ereignisses. Erforderlich für GA4-Ereignisse.

client_id

string

Optional. Eine eindeutige Kennung für die Nutzerinstanz eines Webclients für diesen GA4-Webstream.

user_id

string

Optional. Eine eindeutige Kennung für einen Nutzer, die vom Werbetreibenden definiert wird.

additional_event_parameters[]

EventParameter

Optional. Ein Bucket mit beliebigen Ereignisparametern, die im Ereignis enthalten sein sollen und nicht bereits über andere strukturierte Felder angegeben wurden.

conversion_value

double

Optional. Der mit dem Ereignis verknüpfte Conversion-Wert für wertbezogene Conversions.

EventParameter

Ereignisparameter für GA4-Ereignisse.

Felder
parameter_name

string

Erforderlich. Der Name des zu verwendenden Parameters.

value

string

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

string

Optional. Der Name des zu verwendenden Felds.

value

string

Optional. Der festzulegende Wert des Felds.

GcpWrappedKeyInfo

Informationen zum umschlossenen Schlüssel der Google Cloud Platform.

Felder
key_type

KeyType

Erforderlich. Der Typ des Algorithmus, der zum Verschlüsseln der Daten verwendet wird.

wip_provider

string

Erforderlich. Der Workload Identity-Poolanbieter, der für die Verwendung von KEK erforderlich ist.

kek_uri

string

Erforderlich. Ressourcen-ID des Google Cloud Platform Cloud Key Management Service. Muss das Format projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} oder gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} haben.

encrypted_dek

string

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.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
name

string

Erforderlich. Der Ressourcenname der Direktlizenz für die Nutzerliste.

GetUserListGlobalLicenseRequest

Anfrage zum Abrufen einer UserListGlobalLicense-Ressource.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
name

string

Erforderlich. Der Ressourcenname der globalen Lizenz für die Nutzerliste.

GetUserListRequest

Anfragenachricht für GetUserList

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
name

string

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.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
destinations[]

Destination

Erforderlich. Die Liste der Ziele, an die die Zielgruppenmitglieder gesendet werden sollen.

audience_members[]

AudienceMember

Erforderlich. Die Liste der Nutzer, an die die angegebenen Ziele gesendet werden sollen. In einer einzelnen Anfrage können maximal 10.000 AudienceMember-Ressourcen gesendet werden.

consent

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 AudienceMember angegeben werden.

validate_only

bool

Optional. Zu Testzwecken. Wenn true, wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse.

encoding

Encoding

Optional. Erforderlich für UserData-Uploads. Der Codierungstyp der Nutzer-IDs. Bei gehashten Nutzer-IDs ist dies der Codierungstyp des gehashten Strings. Bei verschlüsselten gehashten Nutzer-IDs ist dies der Codierungstyp des äußeren verschlüsselten Strings, aber nicht unbedingt des inneren gehashten Strings. Der innere gehashte String kann also anders codiert sein als der äußere verschlüsselte String. Bei Uploads, die nicht UserData sind, wird dieses Feld ignoriert.

encryption_info

EncryptionInfo

Optional. Informationen zur Verschlüsselung für UserData-Uploads. Wenn nicht festgelegt, wird davon ausgegangen, dass hochgeladene personenbezogene Daten gehasht, aber nicht verschlüsselt sind. Bei Uploads, die nicht UserData sind, wird dieses Feld ignoriert.

terms_of_service

TermsOfService

Optional. Die Nutzungsbedingungen, die der Nutzer akzeptiert oder abgelehnt hat.

IngestAudienceMembersResponse

Antwort von IngestAudienceMembersRequest.

Felder
request_id

string

Die automatisch generierte ID der Anfrage.

IngestEventsRequest

Anfrage zum Hochladen von Zielgruppenmitgliedern in die angegebenen Ziele. Gibt ein IngestEventsResponse zurück.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
destinations[]

Destination

Erforderlich. Die Liste der Ziele, an die die Ereignisse gesendet werden sollen.

events[]

Event

Erforderlich. Die Liste der Ereignisse, die an die angegebenen Ziele gesendet werden sollen. In einer einzelnen Anfrage können maximal 2.000 Event-Ressourcen gesendet werden.

consent

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 Event angegeben werden.

validate_only

bool

Optional. Zu Testzwecken. Wenn true, wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse.

encoding

Encoding

Optional. Erforderlich für UserData-Uploads. Der Codierungstyp der Nutzer-IDs. Bei gehashten Nutzer-IDs ist dies der Codierungstyp des gehashten Strings. Bei verschlüsselten gehashten Nutzer-IDs ist dies der Codierungstyp des äußeren verschlüsselten Strings, aber nicht unbedingt des inneren gehashten Strings. Der innere gehashte String kann also anders codiert sein als der äußere verschlüsselte String. Bei Uploads, die nicht UserData sind, wird dieses Feld ignoriert.

encryption_info

EncryptionInfo

Optional. Informationen zur Verschlüsselung für UserData-Uploads. Wenn nicht festgelegt, wird davon ausgegangen, dass hochgeladene personenbezogene Daten gehasht, aber nicht verschlüsselt sind. Bei Uploads, die nicht UserData sind, wird dieses Feld ignoriert.

IngestEventsResponse

Antwort von IngestEventsRequest.

Felder
request_id

string

Die automatisch generierte ID der Anfrage.

IngestedUserListInfo

Stellt eine Nutzerliste dar, die mit von Nutzern bereitgestellten Daten gefüllt wird.

Felder
upload_key_types[]

UploadKeyType

Erforderlich. Nicht veränderbar. Uploadschlüsseltypen dieser Nutzerliste.

contact_id_info

ContactIdInfo

Optional. Zusätzliche Informationen, wenn CONTACT_ID einer der upload_key_types ist.

mobile_id_info

MobileIdInfo

Optional. Zusätzliche Informationen, wenn MOBILE_ID einer der upload_key_types ist.

user_id_info

UserIdInfo

Optional. Zusätzliche Informationen, wenn USER_ID einer der upload_key_types ist.

pair_id_info

PairIdInfo

Optional. Zusätzliche Informationen, wenn PAIR_ID einer der upload_key_types ist.

Diese Funktion ist nur für Datenpartner verfügbar.

pseudonymous_id_info

PseudonymousIdInfo

Optional. Zusätzliche Informationen für PSEUDONYMOUS_ID sind eine der upload_key_types.

partner_audience_info

PartnerAudienceInfo

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

string

Optional. Die Produkt-ID im Merchant Center-Konto.

quantity

int64

Optional. Die Anzahl dieses Artikels, die mit dem Ereignis verknüpft ist.

unit_price

double

Optional. Der Artikelpreis ohne Steuern, Versand und etwaige Rabatte auf Transaktionsebene.

item_id

string

Optional. Eine eindeutige Kennung, mit der auf das Element verwiesen werden kann.

additional_item_parameters[]

ItemParameter

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

string

Erforderlich. Der Name des zu verwendenden Parameters.

value

string

Erforderlich. Die String-Darstellung des Werts des festzulegenden Parameters.

ListUserListDirectLicensesRequest

Fordert an, alle UserListDirectLicense-Ressourcen für ein bestimmtes Konto aufzulisten.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
parent

string

Erforderlich. Das Konto, dessen Lizenzen abgefragt werden. Muss im Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ vorliegen.

filter

string

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:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Nicht unterstützte Felder:

  • name (verwenden Sie stattdessen die Methode „get“)
  • historical_pricings und alle zugehörigen Unterfelder
  • pricing.start_time
  • pricing.end_time
page_size

int32

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

string

Optional. Ein Seitentoken, das von einem vorherigen ListUserListDirectLicense-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListUserListDirectLicense bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListUserListDirectLicensesResponse

Antwort von ListUserListDirectLicensesRequest.

Felder
user_list_direct_licenses[]

UserListDirectLicense

Die Lizenzen für die angegebene Nutzerliste in der Anfrage.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListUserListGlobalLicenseCustomerInfosRequest

Anfrage zum Auflisten aller UserListGlobalLicenseCustomerInfo-Ressourcen für eine bestimmte globale Nutzerlizenz.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
parent

string

Erforderlich. Die globale Lizenz, deren Kundeninformationen abgefragt werden. Er sollte folgendes Format haben: accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Wenn Sie alle globalen Lizenzkundeninformationen unter einem Konto auflisten möchten, ersetzen Sie die globale Lizenz-ID der Nutzerliste durch ein „-“ (z. B. accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).

filter

string

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:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Nicht unterstützte Felder:

  • name (verwenden Sie stattdessen die Methode „get“)
  • historical_pricings und alle zugehörigen Unterfelder
  • pricing.start_time
  • pricing.end_time
page_size

int32

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

string

Optional. Ein Seitentoken, das von einem vorherigen ListUserListDirectLicense-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListUserListDirectLicense bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListUserListGlobalLicenseCustomerInfosResponse

Antwort von [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].

Felder
user_list_global_license_customer_infos[]

UserListGlobalLicenseCustomerInfo

Die Kundeninformationen für die angegebene Lizenz in der Anfrage.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListUserListGlobalLicensesRequest

Fordert an, alle UserListGlobalLicense-Ressourcen für ein bestimmtes Konto aufzulisten.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
parent

string

Erforderlich. Das Konto, dessen Lizenzen abgefragt werden. Muss im Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ vorliegen.

filter

string

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:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Nicht unterstützte Felder:

  • name (verwenden Sie stattdessen die Methode „get“)
  • historical_pricings und alle zugehörigen Unterfelder
  • pricing.start_time
  • pricing.end_time
page_size

int32

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

string

Optional. Ein Seitentoken, das von einem vorherigen ListUserListGlobalLicense-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListUserListDirectLicense bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListUserListGlobalLicensesResponse

Antwort von ListUserListGlobalLicensesRequest.

Felder
user_list_global_licenses[]

UserListGlobalLicense

Die Lizenzen für die angegebene Nutzerliste in der Anfrage.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListUserListsRequest

Anfragenachricht für ListUserLists

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
parent

string

Erforderlich. Das übergeordnete Konto, zu dem diese Sammlung von Nutzerlisten gehört. Format: accountTypes/{account_type}/accounts/{account}

page_size

int32

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

string

Optional. Ein Seitentoken, das von einem vorherigen ListUserLists-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListUserLists bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Optional. Ein Filterstring. Alle Felder müssen sich auf der linken Seite jeder Bedingung befinden (z. B. display_name = "list 1").

Unterstützte Vorgänge:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=
  • : (hat)

Unterstützte Felder:

  • id
  • display_name
  • description
  • membership_status
  • integration_code
  • access_reason
  • ingested_user_list_info.upload_key_types

ListUserListsResponse

Antwortnachricht für ListUserLists

Felder
user_lists[]

UserList

Die Nutzerlisten aus dem angegebenen Konto.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

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 [91, 100]).

MobileData

Mobile IDs für die Zielgruppe. Es ist mindestens eine mobile ID erforderlich.

Felder
mobile_ids[]

string

Erforderlich. Die Liste der IDs für Mobilgeräte (Werbe-ID/IDFA). In einem einzelnen AudienceMember können maximal 10 mobileIds angegeben werden.

MobileIdInfo

Zusätzliche Informationen, wenn MOBILE_ID einer der upload_key_types ist.

Felder
data_source_type

DataSourceType

Optional. Nicht veränderbar. Quelle der Upload-Daten.

key_space

KeySpace

Erforderlich. Nicht veränderbar. Der Schlüsselbereich von mobilen IDs.

app_id

string

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[]

string

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 AudienceMember können maximal 10 pairIds angegeben werden.

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

int32

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

int64

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

int64

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

string

Optional. Der beschreibende Name des Publishers, der in der Benutzeroberfläche angezeigt werden soll, um das Targeting zu verbessern.

clean_room_identifier

string

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

PartnerAudienceSource

Erforderlich. Nicht veränderbar. Die Quelle der Partnerzielgruppe.

commerce_partner

string

Optional. Der Name des Commerce-Partners. Nur zulässig, wenn partner_audience_source COMMERCE_AUDIENCE ist.

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.

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[]

string

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_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. Stellt ein bestimmtes Google-Produkt dar.

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
(deprecated)

Product

Verworfen. Verwenden Sie stattdessen account_type.

account_id

string

Erforderlich. Die ID des Kontos. Beispiel: Ihre Google Ads-Konto-ID.

account_type

AccountType

Optional. Der Kontotyp. Beispiel: GOOGLE_ADS. Entweder account_type oder der eingestellte Parameter product ist erforderlich. Wenn beide festgelegt sind, müssen die Werte übereinstimmen.

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.

PseudonymousIdInfo

Zusätzliche Informationen, wenn PSEUDONYMOUS_ID einer der upload_key_types ist.

Felder
sync_status

SyncStatus

Nur Ausgabe. Synchronisierungsstatus der Nutzerliste.

billable_record_count

int64

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.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
destinations[]

Destination

Erforderlich. Die Liste der Ziele, aus denen die Nutzer entfernt werden sollen.

audience_members[]

AudienceMember

Erforderlich. Die Liste der zu entfernenden Nutzer.

validate_only

bool

Optional. Zu Testzwecken. Wenn true, wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse.

encoding

Encoding

Optional. Erforderlich für UserData-Uploads. Der Codierungstyp der Nutzer-IDs. Gilt nur für die äußere Codierung verschlüsselter Nutzer-IDs. Bei Uploads, die nicht UserData sind, wird dieses Feld ignoriert.

encryption_info

EncryptionInfo

Optional. Informationen zur Verschlüsselung für UserData-Uploads. Wenn nicht festgelegt, wird davon ausgegangen, dass hochgeladene personenbezogene Daten gehasht, aber nicht verschlüsselt sind. Bei Uploads, die nicht UserData sind, wird dieses Feld ignoriert.

RemoveAudienceMembersResponse

Antwort von RemoveAudienceMembersRequest.

Felder
request_id

string

Die automatisch generierte ID der Anfrage.

RequestStatusPerDestination

Ein Anfragestatus pro Ziel.

Felder
destination

Destination

Ein Ziel in einer DM API-Anfrage.

request_status

RequestStatus

Der Anfragestatus des Ziels.

error_info

ErrorInfo

Ein Fehlerinfo-Fehler mit dem Fehlergrund und den Fehleranzahlen im Zusammenhang mit dem Upload.

warning_info

WarningInfo

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

IngestAudienceMembersStatus

Der Status der Anfrage zum Erfassen von Zielgruppenmitgliedern.

events_ingestion_status

IngestEventsStatus

Der Status der Anfrage zum Erfassen von Ereignissen.

audience_members_removal_status

RemoveAudienceMembersStatus

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

IngestUserDataStatus

Der Status der Aufnahme von Nutzerdaten in das Ziel.

mobile_data_ingestion_status

IngestMobileDataStatus

Der Status der Aufnahme mobiler Daten am Zielort.

pair_data_ingestion_status

IngestPairDataStatus

Der Status der Aufnahme von Paardaten in das Ziel.

user_id_data_ingestion_status

IngestUserIdDataStatus

Der Status der Aufnahme von Nutzer-ID-Daten in das Ziel.

ppid_data_ingestion_status

IngestPpidDataStatus

Der Status der PPID-Datenerfassung am Ziel.

IngestEventsStatus

Der Status der Ereignisaufnahme am Zielort.

Felder
record_count

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

MatchRateRange

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

int64

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

int64

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

RemoveUserDataStatus

Der Status des Entfernens der Nutzerdaten aus dem Ziel.

mobile_data_removal_status

RemoveMobileDataStatus

Der Status des Entfernens von Mobilfunkdaten aus dem Ziel.

pair_data_removal_status

RemovePairDataStatus

Der Status des Entfernens der Paardaten aus dem Ziel.

user_id_data_removal_status

RemoveUserIdDataStatus

Der Status des Entfernens von Nutzer-ID-Daten aus dem Ziel.

ppid_data_removal_status

RemovePpidDataStatus

Der Status des Entfernens von PPID-Daten aus dem Ziel.

RemoveMobileDataStatus

Der Status des Entfernens von Mobilfunkdaten aus dem Ziel.

Felder
record_count

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
parent

string

Erforderlich. Das Elternkonto, zu dem die Nutzerliste gehört. Format: accountTypes/{account_type}/accounts/{account}

baseline

Baseline

Erforderlich. Baseline für die angeforderten Statistiken.

user_list_id

string

Erforderlich. Die ID der Nutzerliste, für die Statistiken angefordert werden.

RetrieveInsightsResponse

Antwortnachricht für DM API MarketingDataInsightsService.RetrieveInsights

Felder
marketing_data_insights[]

MarketingDataInsight

Enthält die Statistiken für die Marketingdaten.

MarketingDataInsight

Statistiken zu Marketingdaten.

Diese Funktion ist nur für Datenpartner verfügbar.

Felder
dimension

AudienceInsightsDimension

Die Dimension, zu der die Statistik gehört.

attributes[]

MarketingDataInsightsAttribute

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

int64

Die ID des Nutzerinteresses.

lift

float

Maß für die Steigerung, die die Zielgruppe im Vergleich zur Baseline für den Attributwert erzielt. Bereich [0–1].

age_range

AgeRange

Altersgruppe der Zielgruppe, für die die Steigerung angegeben wird.

gender

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.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
request_id

string

Erforderlich. Erforderlich. Die Anfrage-ID der Data Manager API-Anfrage.

RetrieveRequestStatusResponse

Antwort von RetrieveRequestStatusRequest.

Felder
request_status_per_destination[]

RequestStatusPerDestination

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.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
parent

string

Erforderlich. Konto, in dem nach Partnerlinks gesucht werden soll. Wenn kein filter angegeben ist, werden alle Partnerlinks zurückgegeben, in denen dieses Konto entweder owning_account oder partner_account ist.

Format: accountTypes/{account_type}/accounts/{account}

page_size

int32

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

string

Ein Seitentoken, das von einem vorherigen SearchPartnerLinks-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für SearchPartnerLinks bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Optional. Ein Filterstring. Alle Felder müssen sich auf der linken Seite jeder Bedingung befinden (z. B. partner_link_id = 123456789).

Unterstützte Vorgänge:

  • AND
  • =
  • !=

Unterstützte Felder:

  • partner_link_id
  • owning_account.account_type
  • owning_account.account_id
  • partner_account.account_type
  • partner_account.account_id

Beispiel: owning_account.account_type = "GOOGLE_ADS" OR partner_account.account_id = 987654321

SearchPartnerLinksResponse

Antwort von SearchPartnerLinksRequest.

Felder
next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

SizeInfo

Geschätzte Anzahl der Mitglieder in dieser Nutzerliste in verschiedenen Zielnetzwerken.

Felder
display_network_members_count

int64

Nur Ausgabe. Geschätzte Anzahl der Mitglieder in dieser Nutzerliste im Google-Displaynetzwerk.

search_network_members_count

int64

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

bool

Nur Ausgabe. Gibt an, ob diese Nutzerliste für das Google Displaynetzwerk infrage kommt.

TermsOfService

Die Nutzungsbedingungen, die der Nutzer akzeptiert oder abgelehnt hat.

Felder
customer_match_terms_of_service_status

TermsOfServiceStatus

Optional. Die Nutzungsbedingungen für den Kundenabgleich: https://support.google.com/adspolicy/answer/6299717. Diese muss beim Erfassen von UserData oder MobileData akzeptiert werden. Dieses Feld ist für die Nutzerliste zum Partnerabgleich nicht erforderlich.

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.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
user_list_direct_license

UserListDirectLicense

Erforderlich. Das Feld name der Lizenzen wird verwendet, um die zu aktualisierende Lizenz zu identifizieren.

update_mask

FieldMask

Optional. Die Liste der zu aktualisierenden Felder. Das Sonderzeichen * wird nicht unterstützt. Wenn es verwendet wird, wird ein INVALID_UPDATE_MASK-Fehler ausgegeben.

UpdateUserListGlobalLicenseRequest

Anfrage zum Aktualisieren einer UserListGlobalLicense-Ressource.

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
user_list_global_license

UserListGlobalLicense

Erforderlich. Das Feld name der Lizenzen wird verwendet, um die zu aktualisierende Lizenz zu identifizieren.

update_mask

FieldMask

Optional. Die Liste der zu aktualisierenden Felder. Das Sonderzeichen * wird nicht unterstützt. Wenn es verwendet wird, wird ein INVALID_UPDATE_MASK-Fehler ausgegeben.

UpdateUserListRequest

Anfragenachricht für UpdateUserList

Sie können diese Methode im REST APIs Explorer ausprobieren:
Felder
user_list

UserList

Erforderlich. Die zu aktualisierende Nutzerliste.

Das Feld name der Nutzerliste wird verwendet, um die zu aktualisierende Nutzerliste zu identifizieren. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

update_mask

FieldMask

Optional. Die Liste der zu aktualisierenden Felder.

validate_only

bool

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[]

UserIdentifier

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 AudienceMember oder Event können maximal 10 userIdentifiers angegeben werden.

UserIdData

User-ID-Daten mit der User-ID.

Felder
user_id

string

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

DataSourceType

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

string

Gehashte E-Mail-Adresse mit der SHA-256-Hash-Funktion nach der Normalisierung.

phone_number

string

Gehashte Telefonnummer mit der SHA-256-Hash-Funktion nach der Normalisierung (E.164-Standard).

address

AddressInfo

Die bekannten Komponenten der Adresse eines Nutzers. Enthält eine Gruppierung von Kennungen, die alle gleichzeitig abgeglichen werden.

UserList

Eine Nutzerlistenressource.

Felder
name

string

ID. Der Ressourcenname der Nutzerliste. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

id

int64

Nur Ausgabe. Die eindeutige ID der Nutzerliste.

read_only

bool

Nur Ausgabe. Eine Option, die angibt, ob ein Nutzer eine Liste bearbeiten darf.

membership_duration

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

AccessReason

Nur Ausgabe. Der Grund, warum diesem Konto Zugriff auf die Liste gewährt wurde.

size_info

SizeInfo

Nur Ausgabe. Geschätzte Anzahl der Mitglieder in dieser Nutzerliste in verschiedenen Zielnetzwerken.

target_network_info

TargetNetworkInfo

Optional. Informationen zu den Voraussetzungen für verschiedene Zielnetzwerke.

display_name

string

Erforderlich. Der Anzeigename der Nutzerliste.

description

string

Optional. Eine Beschreibung der Nutzerliste.

membership_status

MembershipStatus

Optional. Mitgliedschaftsstatus dieser Nutzerliste.

integration_code

string

Optional. Eine ID aus einem externen System. Sie wird von Verkäufern von Nutzerlisten verwendet, um IDs in ihren Systemen abzugleichen.

closing_reason

ClosingReason

Nur Ausgabe. Der Grund, warum der Mitgliedschaftsstatus dieser Nutzerliste geschlossen ist.

account_access_status

AccessStatus

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 ENABLED verwendet. Später kann der Inhaber der Nutzerliste die Freigabe widerrufen und die Liste auf DISABLED setzen.

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

IngestedUserListInfo

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

string

ID. Der Ressourcenname der Direktlizenz für die Nutzerliste.

user_list_display_name

string

Nur Ausgabe. Name der Nutzerliste, für die eine Lizenz erteilt wird.

Dieses Feld ist schreibgeschützt.

client_account_display_name

string

Nur Ausgabe. Name des Kunden des Kunden, an den die Nutzerliste lizenziert wird.

Dieses Feld ist schreibgeschützt.

pricing

UserListLicensePricing

Optional. Preise für UserListDirectLicense.

historical_pricings[]

UserListLicensePricing

Nur Ausgabe. Preisverlauf dieser Nutzerlistenlizenz.

Dieses Feld ist schreibgeschützt.

metrics

UserListLicenseMetrics

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

int64

Nicht veränderbar. ID der Nutzerliste, für die eine Lizenz erteilt wird.

client_account_type

UserListLicenseClientAccountType

Nicht veränderbar. Kontotyp des Kunden, für den die Nutzerliste lizenziert wird.

client_account_id

int64

Nicht veränderbar. ID des Kunden, an den die Nutzerliste lizenziert wird.

status

UserListLicenseStatus

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

string

ID. Der Ressourcenname der globalen Lizenz für die Nutzerliste.

user_list_display_name

string

Nur Ausgabe. Name der Nutzerliste, für die eine Lizenz erteilt wird.

Dieses Feld ist schreibgeschützt.

pricing

UserListLicensePricing

Optional. Preise für UserListGlobalLicense.

historical_pricings[]

UserListLicensePricing

Nur Ausgabe. Preisverlauf dieser Nutzerlistenlizenz.

Dieses Feld ist schreibgeschützt.

metrics

UserListLicenseMetrics

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

int64

Nicht veränderbar. ID der Nutzerliste, für die eine Lizenz erteilt wird.

license_type

UserListGlobalLicenseType

Nicht veränderbar. Produkttyp des Kunden, für den die Nutzerliste lizenziert wird.

status

UserListLicenseStatus

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

string

ID. Der Ressourcenname des globalen Lizenzkunden der Nutzerliste.

user_list_id

int64

Nur Ausgabe. ID der Nutzerliste, für die eine Lizenz erteilt wird.

user_list_display_name

string

Nur Ausgabe. Name der Nutzerliste, für die eine Lizenz erteilt wird.

license_type

UserListGlobalLicenseType

Nur Ausgabe. Produkttyp des Kunden, für den die Nutzerliste lizenziert wird.

status

UserListLicenseStatus

Nur Ausgabe. Status von UserListDirectLicense: ENABLED oder DISABLED.

pricing

UserListLicensePricing

Nur Ausgabe. Preise für UserListDirectLicense.

client_account_type

UserListLicenseClientAccountType

Nur Ausgabe. Produkttyp des Kunden, für den die Nutzerliste lizenziert wird.

client_account_id

int64

Nur Ausgabe. ID des Kunden, an den die Nutzerliste lizenziert wird.

client_account_display_name

string

Nur Ausgabe. Name des Kunden des Kunden, an den die Nutzerliste lizenziert wird.

historical_pricings[]

UserListLicensePricing

Nur Ausgabe. Preisverlauf dieser Nutzerlistenlizenz.

metrics

UserListLicenseMetrics

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

UserListLicenseMetrics

Messwerte für eine Nutzerlistenlizenz.

Felder
click_count

int64

Nur Ausgabe. Die Anzahl der Klicks für die Lizenz für die Nutzerliste.

impression_count

int64

Nur Ausgabe. Die Anzahl der Impressionen für die Nutzerlistenlizenz.

revenue_usd_micros

int64

Nur Ausgabe. Der Umsatz für die Nutzerlistenlizenz in μUSD.

start_date

int64

Nur Ausgabe. Das Startdatum (einschließlich) der Messwerte im Format JJJJMMTT. Beispiel: 20260102 steht für den 2. Januar 2026. Wenn end_date im Filter verwendet wird, ist auch start_date erforderlich. Wenn weder start_date noch end_date im Filter enthalten sind, werden die Felder „UserListLicenseMetrics“ in der Antwort nicht ausgefüllt.

end_date

int64

Nur Ausgabe. Das Enddatum (einschließlich) der Messwerte im Format JJJJMMTT. Beispiel: 20260102 steht für den 2. Januar 2026. Wenn start_date im Filter verwendet wird, ist auch end_date erforderlich. Wenn weder start_date noch end_date im Filter enthalten sind, werden die Felder „UserListLicenseMetrics“ in der Antwort nicht ausgefüllt.

UserListLicensePricing

Preise für Nutzerlistenlizenzen.

Felder
pricing_id

int64

Nur Ausgabe. Die ID dieser Preisgestaltung.

start_time

Timestamp

Nur Ausgabe. Beginn der Preisgestaltung.

end_time

Timestamp

Optional. Ende des Preiszeitraums.

pricing_active

bool

Nur Ausgabe. Gibt an, ob diese Preise aktiv sind.

buyer_approval_state

UserListPricingBuyerApprovalState

Nur Ausgabe. Der Status der Käufergenehmigung für diesen Preis.

Dieses Feld ist schreibgeschützt.

cost_micros

int64

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 USD ist.

currency_code

string

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

UserListPricingCostType

Nicht veränderbar. Der Kostentyp dieses Preises.

Kann nur im create-Vorgang festgelegt werden. Kann für eine vorhandene Lizenz nicht aktualisiert werden.

max_cost_micros

int64

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 currency_code USD ist.

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 auf0gesetzt ist, gibt es keine Obergrenze.

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

CustomerType

Optional. Typ des Kunden, der mit dem Ereignis verknüpft ist.

customer_value_bucket

CustomerValueBucket

Optional. Der vom Werbetreibenden geschätzte Wert des Kunden.

additional_user_properties[]

UserProperty

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

string

Erforderlich. Der Name der zu verwendenden Nutzereigenschaft.

value

string

Erforderlich. Die Stringdarstellung des zu verwendenden Werts der Nutzereigenschaft.

WarningCount

Die Anzahl der Warnungen für einen bestimmten Warnungsgrund.

Felder
record_count

int64

Die Anzahl der Datensätze, für die eine Warnung ausgegeben wurde.

reason

ProcessingWarningReason

Der Grund für die Warnung.

WarningInfo

Anzahl der Warnungen für jeden Warnungstyp.

Felder
warning_counts[]

WarningCount

Eine Liste der Warnungen und die Anzahl der Warnungen pro Grund.