Package google.ads.datamanager.v1

Index

IngestionService

Dienst zum Senden von Zielgruppendaten an unterstützte Ziele.

IngestAdEvents

rpc IngestAdEvents(IngestAdEventsRequest) returns (IngestAdEventsResponse)

Lädt eine Liste von AdEvent-Ressourcen in Google Analytics hoch.

Diese Funktion ist nur für Konten auf einer Zulassungsliste verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager
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 mit Event-Ressourcen aus dem bereitgestellten Destination hoch.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc IngestUsers(IngestUsersRequest) returns (IngestUsersResponse)

Lädt eine Liste von Nutzern zu den angegebenen Zielen hoch. Im Gegensatz zu IngestAudienceMembers, mit dem Nutzer bestimmten Zielgruppenlisten von Werbetreibenden für die Ausrichtung hinzugefügt werden, werden mit IngestUsers Daten zur Identitätsverknüpfung auf Kontoebene (z. B. Nutzer-IDs, die mit Mobilgeräte-IDs verknüpft sind) unabhängig von bestimmten Zielgruppensegmenten erfasst.

Diese Funktion ist nur für Konten auf einer Zulassungsliste verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc RemoveAllAudienceMembers(RemoveAllAudienceMembersRequest) returns (RemoveAllAudienceMembersResponse)

Entfernt alle Zielgruppenmitglieder aus den angegebenen Zielen.

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
RemoveUsers

rpc RemoveUsers(RemoveUsersRequest) returns (RemoveUsersResponse)

Entfernt eine Liste von Nutzern aus den angegebenen Zielen.

Diese Funktion ist nur für Konten auf einer Zulassungsliste verfügbar.

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 zu 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 stattdessen 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 direkte 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
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 direkte 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

UserListGlobalLicenseService

Dienst zur Verwaltung globaler Lizenzen für Nutzerlisten. Das Löschen wird für UserListGlobalLicenses nicht unterstützt. Anrufer sollten den Lizenzstatus stattdessen 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 die 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 Lizenzen 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
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 zum Verwalten 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 zu 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 zu 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 zu 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 zu 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 zu login-account. Format: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

AdEvent

Ein Anzeigenereignis.

Felder
advertiser_id

string

Erforderlich. Die ID des Werbetreibenden für das Anzeigenereignis.

Sie muss mit der ID übereinstimmen, die im Verknüpfungsprozess gesendet wurde.

event_type

EventType

Erforderlich. Der Typ des Ereignisses.

timestamp

Timestamp

Erforderlich. Zeit, zu der das Ereignis aufgetreten ist.

event_id

string

Optional. Eine ID, die vom Anrufer erstellt und verwaltet wird und dieses Ereignis eindeutig identifiziert.

Erforderlich, wenn Sie Anzeigenereignisse deduplizieren möchten, die in mehreren Anfragen enthalten sind. Andernfalls ist dieses Feld optional.

user_data

UserData

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

Es ist möglich, mehrere Instanzen desselben Datentyps anzugeben, z.B. mehrere E-Mail-Adressen. Je mehr Daten angegeben werden, desto wahrscheinlicher ist es, dass eine Übereinstimmung gefunden wird.

device_info

DeviceInfo

Erforderlich. Informationen zum Gerät, das zum Zeitpunkt des Anzeigenereignisses verwendet wurde.

ip_address

string

Optional. Die für die Analyse verwendete IP-Adresse. Dieser Wert muss mit DeviceInfo.ip_address übereinstimmen. Lassen Sie das Feld leer, wenn Sie die IP-Adresse nicht für die Analyse freigeben möchten.

mobile_device_id

string

Optional. Die Geräte-ID des Geräts, auf dem die Anzeige ausgeliefert wurde.

campaign_id

string

Erforderlich. Die ID der zugehörigen Kampagne.

campaign_name

string

Erforderlich. Der Name der zugehörigen Kampagne.

ad_group_id

string

Optional. Die ID der zugehörigen Anzeigengruppe.

ad_id

string

Optional. Die ID der zugehörigen Anzeige in der Gruppe.

ad_height

int32

Optional. Die Höhe der Anzeige in Pixeln.

ad_width

int32

Optional. Die Breite der Anzeige in Pixeln.

region_code

string

Optional. Das Land und die Unterteilung gemäß ISO 3166-2.

source

string

Erforderlich. Die Plattformquelle der Anzeige, ähnlich der Google Analytics-Quelle.

medium

string

Erforderlich. Das Medium der Anzeige, ähnlich dem Google Analytics-Medium.

attribution_hint

AttributionHint

Optional. Der vom Partner angenommene Attributionsstatus für dieses Anzeigenereignis.

Dies dient nur als Signal dafür, wie die Attribution des Partners angenommen wurde, und erzwingt kein Endergebnis in endgültigen Berichten.

viewability_info

ViewabilityInfo

Erforderlich. Details zur Sichtbarkeit der ausgelieferten Anzeige.

Union-Feld event_subtype_oneof. Optional. Zusätzliche Klassifizierung des Anzeigenereignistyps.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enumerationen zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für event_subtype_oneof ist nur einer der folgenden Werte zulässig:

event_subtype

EventSubtype

Enum-Wert für den Ereignisuntertyp.

event_subtype_string

string

Stringwert für den Ereignisuntertyp.

Union-Feld ad_type_oneof. Optional. Der Typ der ausgelieferten Anzeige.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enumerationen zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für ad_type_oneof ist nur einer der folgenden Werte zulässig:

ad_type

AdType

Enum-Wert für den Anzeigentyp.

ad_type_string

string

String-Wert für den Anzeigentyp.

Union-Feld ad_format_oneof. Optional. Der Typ der ausgelieferten Anzeige.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enumerationen zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für ad_format_oneof ist nur einer der folgenden Werte zulässig:

ad_format

AdFormat

Enum-Wert für das Anzeigenformat.

ad_format_string

string

Stringwert für das Anzeigenformat.

Union-Feld ad_placement_oneof. Optional. Das Placement der ausgelieferten Anzeige.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enumerationen zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für ad_placement_oneof ist nur einer der folgenden Werte zulässig:

ad_placement

AdPlacement

Enum-Wert für die Anzeigenplatzierung.

ad_placement_string

string

String-Wert für die Anzeigenplatzierung.

Union-Feld targeting_type_oneof. Optional. Der Targeting-Typ, der für die Auslieferung der Anzeige verwendet wurde.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enumerationen zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für targeting_type_oneof ist nur einer der folgenden Werte zulässig:

targeting_type

TargetingType

Enum-Wert für den Targeting-Typ.

targeting_type_string

string

String-Wert für den Targeting-Typ.

Union-Feld platform_type_oneof. Optional. Der Typ der Plattform, auf der die Anzeige ausgeliefert wurde.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enumerationen zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für platform_type_oneof ist nur einer der folgenden Werte zulässig:

platform_type

PlatformType

Enum-Wert für den Plattformtyp.

platform_type_string

string

String-Wert für den Plattformtyp.

Union-Feld platform_oneof. Optional. Weitere Details zur Plattform, auf der die Anzeige ausgeliefert wurde.

Es wird ein Rohstring akzeptiert, um andere Werte als die reinen Enumerationen zu verarbeiten. Die Enumeration wird nach Möglichkeit bevorzugt. Für platform_oneof ist nur einer der folgenden Werte zulässig:

platform

Platform

Enum-Wert für die Plattform.

platform_string

string

Stringwert für die Plattform.

measurement_allowed

bool

Optional. Gibt an, ob die Zeile gemäß den anwendbaren Datenschutzgesetzen in der regionalen Gerichtsbarkeit für Analysezwecke verwendet werden darf.

EventSubtype

Zusätzliche Klassifizierung des Anzeigenereignistyps.

Enums
EVENT_SUBTYPE_UNSPECIFIED Nicht angegebener Ereignisuntertyp.
EVENT_SUBTYPE_IMPRESSION Impressionsereignis.
EVENT_SUBTYPE_ENGAGED_VIEW Ereignis nach aktiver Wiedergabe.
EVENT_SUBTYPE_ONSITE_CLICK Onsite-Click-Event.
EVENT_SUBTYPE_OUTBOUND_CLICK Ereignis für Klicks auf externe Links.

EventType

Der Typ des Ereignisses.

Enums
EVENT_TYPE_UNSPECIFIED Nicht angegebener Ereignistyp.
EVENT_TYPE_VIEW Termin ansehen
EVENT_TYPE_CLICK Click-Event.

AdFormat

Das Format der ausgelieferten Anzeige.

Enums
AD_FORMAT_UNSPECIFIED Anzeigenformat nicht angegeben.
AD_FORMAT_AR AR-Anzeige
AD_FORMAT_AUDIO Audioanzeige
AD_FORMAT_BANNER Banneranzeige.
AD_FORMAT_BUMPER Bumper-Anzeige
AD_FORMAT_COLLECTION Anzeige aus Sammlung
AD_FORMAT_IMAGE Bildanzeige
AD_FORMAT_INTERACTIVE Interaktive Anzeige.
AD_FORMAT_INTERSTITIAL Interstitial-Anzeige
AD_FORMAT_IN_FEED In-Feed-Anzeige
AD_FORMAT_IN_STREAM In-Stream-Anzeige
AD_FORMAT_IN_STREAM_SKIPPABLE Überspringbare In-Stream-Anzeige
AD_FORMAT_IN_STREAM_NON_SKIPPABLE Nicht überspringbare In-Stream-Anzeige
AD_FORMAT_NATIVE Native Anzeige
AD_FORMAT_SHORTS YouTube Shorts-Anzeige.
AD_FORMAT_STORY Story-Anzeige
AD_FORMAT_SPONSORED Gesponserte Anzeige
AD_FORMAT_VIDEO Videoanzeige

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-Ereignissen 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), die zum Zeitpunkt des Aufrufs der Website des Werbetreibenden nach der Interaktion mit der Anzeige erhoben werden.

mobile_device_id

string

Optional. Die ID für mobile Werbung für Werbetreibende. Das ist die IDFA unter iOS, die AdID unter Android oder die Kennungen für Werbetreibende anderer Plattformen.

dclid

string

Optional. Die mit diesem Ereignis verknüpfte Display-Klick-ID.

impression_id

string

Optional. Die mit diesem Ereignis verknüpfte Impressions-ID.

match_id

string

Optional. Das Feld „Match-ID“, das zum Verknüpfen dieses Ereignisses mit einem vorherigen Ereignis verwendet wird.

encrypted_user_ids[]

EncryptedUserId

Optional. Eine beliebige Anzahl verschlüsselter Nutzer-IDs.

ppid

string

Optional. Eine eindeutige Kennung für einen authentifizierten (angemeldeten) Nutzer, die vom Publisher definiert wird.

visitor_ppid

string

Optional. Eine eindeutige Kennung für einen nicht authentifizierten Nutzer (Nutzer, der nicht angemeldet ist), die vom Publisher definiert wird.

AdPlacement

Das Placement der ausgelieferten Anzeige.

Enums
AD_PLACEMENT_UNSPECIFIED Nicht angegebenes Anzeigen-Placement.
AD_PLACEMENT_DISCOVER Placement ermitteln
AD_PLACEMENT_FEED Feed-Placement.
AD_PLACEMENT_HEADER Platzierung des Headers.
AD_PLACEMENT_HOME Platzierung auf der Startseite.
AD_PLACEMENT_IN_CONTENT Placement im Content
AD_PLACEMENT_PROMOTED Gesponserte Platzierung.
AD_PLACEMENT_STORY Platzierung von Stories.

AdType

Der Typ der ausgelieferten Anzeige.

Enums
AD_TYPE_UNSPECIFIED Nicht angegebener Anzeigentyp
AD_TYPE_DISPLAY Displayanzeige
AD_TYPE_TEXT Textanzeige aus.
AD_TYPE_IMAGE Bildanzeige
AD_TYPE_RICH_MEDIA Rich Media-Anzeige
AD_TYPE_HTML HTML-Anzeige
AD_TYPE_AUDIO Audioanzeige
AD_TYPE_VIDEO Videoanzeige

AddressInfo

Adressinformationen für den Nutzer.

Felder
given_name

string

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

family_name

string

Erforderlich. Nachname des Nutzers, alles in Kleinbuchstaben, ohne Satzzeichen, ohne führende oder nachfolgende Leerzeichen und als SHA-256-Hash.

region_code

string

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

postal_code

string

Erforderlich. Die Postleitzahl der Adresse des Nutzers.

address_line

string

Optional. Straße und Hausnummer der Adresse des Nutzers. Wird nur für Google Analytics verwendet. Dieses Feld wird gehasht und möglicherweise verschlüsselt.

Normalisieren Sie den Wert vor dem Hashen:

  • Symbolzeichen entfernen
  • In Kleinbuchstaben umwandeln
  • Entfernen von voran- und nachgestellten Leerzeichen
city

string

Optional. Die Stadt der Adresse des Nutzers. Wird nur für Google Analytics verwendet.

Der Wert sollte so normalisiert werden:

  • Symbolzeichen entfernen
  • In Kleinbuchstaben umwandeln
  • Entfernen von voran- und nachgestellten Leerzeichen
administrative_area

string

Optional. Das Verwaltungsgebiet (Bundesstaat/Provinz) der Adresse des Nutzers. Wird nur für Google Analytics verwendet.

Der Wert sollte so normalisiert werden:

  • Symbolzeichen entfernen
  • In Kleinbuchstaben umwandeln
  • Entfernen von voran- und nachgestellten Leerzeichen

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.

AttributionHint

Der vom Partner angenommene Attributionsstatus für dieses Anzeigenereignis.

Enums
ATTRIBUTION_HINT_UNSPECIFIED Unbekannter Attributionsstatus.
ATTRIBUTION_HINT_CONVERTED Konvertierter Status.
ATTRIBUTION_HINT_NOT_CONVERTED Status „Nicht konvertiert“.

AudienceMember

Die Person in der Zielgruppe, die operiert werden soll.

Felder
destination_references[]

string

Optional. Definiert, an welche Destination das Zielgruppenmitglied gesendet wird.

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 (Identitätsabgleich zwischen Publishern und Werbetreibenden).

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, die vom Werbetreibenden definiert werden.

ppid_data

PpidData

Daten zu vom Publisher bereitgestellten Kennungen.

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

composite_data

CompositeData

Gruppe mit mehreren Kennungstypen.

google_user_id_data

GoogleUserIdData

Verschlüsselte Google-Nutzer-IDs.

partner_provided_id_data

PartnerProvidedIdData

Von Partnern bereitgestellte Kennungen.

AwsWrappedKeyInfo

Ein Datenverschlüsselungsschlüssel, der mit einem AWS KMS-Schlüssel verpackt ist.

Felder
key_type

KeyType

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

role_arn

string

Erforderlich. Der Amazon-Ressourcenname 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. Sollte 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 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

Referenzkriterien, mit denen die Statistiken verglichen werden.

Felder
Union-Feld baseline. Referenzstandort, mit dem die Statistiken verglichen werden. Für baseline ist nur einer der folgenden Werte zulässig:
baseline_location

Location

Der Referenzstandort der Anfrage. Der Baseline-Standort ist eine OR-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 Baseline-Standort 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 mit den Artikeln verknüpft 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 mit dem Ereignis verknüpften Elemente.

coupon_codes[]

string

Optional. Die Liste der Gutscheincodes, die auf den Einkaufswagen angewendet wurden. Gutscheincodes auf Warenkorb- und Artikelebene sind unabhängig voneinander.

Wenn das Ereignis für ein Google Analytics-Zielvorhaben bestimmt ist, geben Sie nur einen Gutscheincode an. Zusätzliche Gutscheincodes werden in Google Analytics ignoriert.

CompositeData

Zusammengesetzte Daten mit Kennungen und zugehörigen Daten für einen Nutzer. Es muss in jedem Fall entweder user_data oder ip_data angegeben werden.

Felder
user_data

UserData

Optional. Von Nutzern bereitgestellte Daten, die den Nutzer identifizieren.

ip_data[]

IpData

Optional. IP-Adressdaten, die die Kundeninteraktion darstellen und zum Erstellen der Zielgruppe verwendet wurden.

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 zu den upload_key_types gehört.

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

CoordinatorKeyInfo

Informationen zum Koordinatorschlüssel.

Felder
key_id

string

Erforderlich. Die ID des ausgewählten Koordinatorschlüssels.

CreatePartnerLinkRequest

Anfrage zum Erstellen einer PartnerLink-Ressource. Gibt ein 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, zu dem die lizenzierte Nutzerliste gehört. Muss das Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ haben

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, zu dem die lizenzierte Nutzerliste gehört. Muss das Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ haben

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 Variablen, 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

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

Enums
CUSTOMER_TYPE_UNSPECIFIED Nicht angegebener CustomerType. Sollte nicht verwendet werden.
NEW Der Kunde ist ein Neukunde des Werbetreibenden.
RETURNING Der Kunde kehrt zum Werbetreibenden zurück.
REENGAGED Der Kunde hat sich wieder an den Werbetreibenden gewandt.

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 einen geringen Wert.
MEDIUM Der Kunde hat einen mittleren Wert.
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 Daten von Drittanbieterpartnern.

DeletePartnerLinkRequest

Anfrage zum Löschen einer PartnerLink-Ressource. Gibt ein 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. Verwenden Sie diese Referenz, um in der 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 z. B. 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. So hat beispielsweise das login_account eines Datenpartners Zugriff auf das linked_account eines Kunden. Der Partner verwendet dieses Feld möglicherweise, um Daten von der linked_account an eine andere 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

Optional. 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.

Dieses Feld ist für die Ereignisaufnahme und die Nutzeraufnahme in Google Ad Manager optional. Für alle anderen Anwendungsfälle erforderlich.

DeviceInfo

Informationen zum Gerät, das bei Eintreten 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. Erforderlich, wenn sie in einem AdEvent für geografische Prüfungen verwendet wird.

category

string

Optional. Die Gerätekategorie. Beispiele: „Computer“, „Tablet“, „Mobilgerät“, „Smart-TV“.

language_code

string

Optional. Die Sprache, die auf dem Gerät verwendet wird, im ISO 639-1-Format.

screen_height

int32

Optional. Die Höhe des Bildschirms in Pixeln.

screen_width

int32

Optional. Die Breite des Bildschirms in Pixeln.

operating_system

string

Optional. Das Betriebssystem oder die Plattform des Geräts.

operating_system_version

string

Optional. Die Version des Betriebssystems oder der Plattform.

model

string

Optional. Das Modell des Geräts.

brand

string

Optional. Die Marke des Geräts.

browser

string

Optional. Die Marke oder der Typ des Browsers.

browser_version

string

Optional. Die Version des Browsers.

Codierung

Der Codierungstyp der gehashten personenidentifizierbaren Informationen.

Enums
ENCODING_UNSPECIFIED Nicht angegebener Codierungstyp. Sollte nicht verwendet werden.
HEX Hexadezimale Codierung.
BASE64 Base64-Codierung.

EncryptedUserId

Eine Nutzer-ID, die für die Attribution verwendet werden soll. Alle Felder sind erforderlich, wenn diese Option verwendet wird.

Felder
encrypted_id

string

Erforderlich. Die alphanumerische verschlüsselte ID.

entity_type

EncryptionEntityType

Erforderlich. Der Verschlüsselungsentitätstyp. Diese sollte mit der Verschlüsselungskonfiguration für die Anzeigenbereitstellung oder den Datenübertragungsdienst übereinstimmen.

entity_id

int64

Erforderlich. Die ID der Verschlüsselungseinheit. Diese sollte mit der Verschlüsselungskonfiguration für die Anzeigenbereitstellung oder den Datenübertragungsdienst übereinstimmen.

source

EncryptionSource

Erforderlich. Gibt an, ob das verschlüsselte Cookie von der Anzeigenbereitstellung (das Makro „%m“) oder vom Datenübertragungsdienst empfangen wurde.

EncryptionEntityType

Der Verschlüsselungsentitätstyp.

Enums
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED Nicht angegebener Verschlüsselungsentitätstyp.
CAMPAIGN_MANAGER_ACCOUNT Campaign Manager 360-Konto
CAMPAIGN_MANAGER_ADVERTISER Campaign Manager 360-Werbetreibender
DISPLAY_VIDEO_PARTNER Display & Video 360-Partner
DISPLAY_VIDEO_ADVERTISER Display & Video 360-Werbetreibender
GOOGLE_ADS_CUSTOMER Google Ads-Kunde
GOOGLE_AD_MANAGER_NETWORK_CODE Google Ad Manager-Netzwerkcode.

EncryptionSource

Die Verschlüsselungsquelle.

Enums
ENCRYPTION_SOURCE_UNSPECIFIED Nicht angegebene Verschlüsselungsquelle.
AD_SERVING Verschlüsselungsquelle für die Anzeigenauslieferung.
DATA_TRANSFER Quelle für die Verschlüsselung der Datenübertragung.

EncryptionInfo

Verschlüsselungsinformationen für die 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 in der Google Cloud Platform.

aws_wrapped_key_info

AwsWrappedKeyInfo

Informationen zum von Amazon Web Services verpackten Schlüssel.

coordinator_key_info

CoordinatorKeyInfo

Wichtige Informationen zum ausgewählten Koordinatorschlüssel.

Dies wird für die Methoden IngestEvents, IngestAudienceMembers und RemoveAudienceMembers nicht unterstützt.

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 Fehlergrund. Möglicherweise nicht in allen Fällen verfügbar.

ErrorReason

Fehlerursachen für die Data Manager API. HINWEIS: Diese Enumeration 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

Nicht mehr unterstützt: Der Enum-Wert wird in der Data Manager API nicht mehr verwendet.

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 Dieser Befragte 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 Dieses Ereignis ist ungültig.
TOO_MANY_EVENTS Pro Anfrage sind maximal 10.000 Ereignisse zulässig.
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 Das Zielkonto hat 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 Das Betriebskonto für die Autorisierung des Datenpartners wird nicht unterstützt.
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. Bei der Erfassung von Floodlight-Ereignissen weist dieser Fehler darauf hin, dass Anfragen keine Anzeigen-IDs enthalten.
INVALID_PROPERTY_TYPE Der Attributtyp wird nicht unterstützt.
INVALID_STREAM_TYPE Der Streamtyp 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 Anfragen abgerufen werden, die erfolgreich sind und 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.
FIELD_VALUE_TOO_SHORT Der Feldwert ist zu kurz.
TOO_MANY_ELEMENTS Die Anfrage enthält zu viele Elemente in einer Liste.
TOO_FEW_ELEMENTS Eine Liste in der Anfrage enthält zu wenige Elemente.
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 Client nicht lizenziert werden.
INSUFFICIENT_COST Die Kosten sind für diese Lizenz zu niedrig.
CANNOT_DISABLE_LICENSE Die Reseller-Lizenz kann nicht deaktiviert werden, da sie verwendet wird.
INVALID_CLIENT_ACCOUNT_ID Ungültige Kundenkonto-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 Medien.
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 cost“ ist nur für „cost_type“ MEDIA_SHARE zulässig.
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED Commerce-Zielgruppen 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 müssen Inhaber sein, 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 von externen Nutzern nicht 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 Zielgruppenquelle des Partners 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 zum Partnerabgleich 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 E-Commerce.
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES Die Uploadschlüsseltypen für Nutzerlisten werden nicht unterstützt.
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG Die aufgenommene Konfiguration für Nutzerlisteninformationen wird nicht unterstützt.
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE Die Kontotypen werden für den Nutzerlistentyp nicht unterstützt.
MEMBERSHIP_DURATION_TOO_LONG Die Gültigkeitsdauer der Nutzerliste ist zu lang.
INVALID_MERCHANT_ID Das Feld merchant_id ist ungültig.
EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED Der Kunde enthält nicht ausgenommene Kampagnen ohne Erklärung zu politischer Werbung in der EU.
ACCOUNT_INELIGIBLE_FOR_STORE_SALES Das Konto ist nicht für Ladenverkäufe geeignet.
INVALID_MERCHANT_FEED_LANGUAGE_CODE Der Sprachcode des Händlerfeeds ist ungültig.
INVALID_REGION_CODE Der Regionscode ist ungültig.
INVALID_SUBDIVISION_CODE Der Unterteilungs-Code ist ungültig.
INVALID_SUBCONTINENT_CODE Der Unterkontinentcode ist ungültig.
INVALID_CONTINENT_CODE Der Kontinentcode ist ungültig.
INVALID_DEVICE_CATEGORY Die Geräte-Kategorie ist ungültig.
BOTH_CLIENT_ID_AND_APP_INSTANCE_ID_NOT_ALLOWED Sowohl app_instance_id als auch client_id sind festgelegt.
GOOGLE_ANALYTICS_SUBPROPERTY_OR_ROLLUP_PROPERTY_NOT_ALLOWED Die Google Analytics-Property ist eine untergeordnete Property oder eine Sammel-Property.
THIRD_PARTY_USER_DATA_NOT_ALLOWED Nutzerdaten von Drittanbietern können nur von Datenpartnern festgelegt werden.
INVALID_COUPON_CODE Der Gutscheincode ist ungültig.
EVENT_SOURCE_AND_DESTINATION_MISMATCH Der Typ der Ereignisquelle stimmt nicht mit dem Zieltyp überein.
DESTINATION_ACCOUNT_TYPE_MISMATCH Der Zielkontotyp stimmt nicht mit der angegebenen Konto-ID überein.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII Der Wert der benutzerdefinierten Variable enthält personenidentifizierbare Informationen.
CUSTOM_VARIABLE_NOT_ENABLED Die benutzerdefinierte Variable ist nicht aktiviert.
INVALID_CUSTOM_VARIABLE_VALUE Der Wert der benutzerdefinierten Variable ist ungültig.
CUSTOM_VARIABLE_NOT_FOUND Das Ziel hat keine benutzerdefinierte Variable mit einem Namen, der mit dem angegebenen variable übereinstimmt.
TOO_MANY_USERS Pro Anfrage sind maximal 10.000 Nutzer zulässig.
BASELINE_LOCATION_AUTO_DETECTION_FAILED Das Feld location_auto_detection_enabled der Anfrage wurde auf true gesetzt, aber die automatische Erkennung des Referenzstandorts ist fehlgeschlagen.
INSIGHTS_MISSING_FOR_DIMENSION Für diese Dimension fehlen Statistiken.
INVALID_REMOVE_AS_OF_TIME Das Datum für das Entfernen muss in der Vergangenheit oder Gegenwart liegen. Zukünftige Zeitstempel sind beim Entfernen von Zielgruppenmitgliedern nicht zulässig.
REQUEST_TOO_OLD Der Anfragestatus ist nur etwa 50 Tage nach dem Eingang einer Anfrage über die API verfügbar.
CONVERSION_ACTION_TOO_RECENTLY_CREATED Die Conversion-Aktion wurde vor zu kurzer Zeit erstellt.
INVALID_AD_IDENTIFIER_FOR_ACCOUNT

Die Werbe-ID gehört nicht zum Konto.

Beispiel: Die gclid ist nicht mit der operating_account und product_destination_id des Ziels verknüpft.

Ereignis

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

Felder
destination_references[]

string

Optional. Referenzstring, mit dem das Ziel bestimmt wird. Wenn das Feld leer ist, wird das Ereignis an alle destinations in der Anfrage gesendet.

transaction_id

string

Optional. Die eindeutige Kennung für dieses Ereignis. Erforderlich für Ereignisse, die als zusätzliche Datenquelle für Tag-Conversions gesendet werden.

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 Gerät, das zum Zeitpunkt des Ereignisses verwendet wurde (falls vorhanden).

cart_data

CartData

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

custom_variables[]

CustomVariable

Optional. Zusätzliche Informationen in Form von Schlüssel/Wert-Paaren, 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.

third_party_user_data

UserData

Optional. Derselbe Datentyp wie in „user_data“, aber explizit als Daten gekennzeichnet, die von einem Drittanbieter bereitgestellt werden und nicht als selbst erhobene Daten des Werbetreibenden.

event_location

EventLocation

Optional. Informationen zum Standort des Nutzers, als dieses Ereignis aufgetreten ist.

app_instance_id

string

Optional. Eine eindeutige Kennung für die Nutzerinstanz eines App-Clients für diesen GA4-App-Stream.

conversion_value

double

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

conversion_count

double

Optional. Die mit dem Ereignis verknüpfte Conversion-Menge für Conversions, die auf Zählungen basieren.

EventLocation

Der Ort, an dem das Ereignis stattgefunden hat.

Felder
store_id

string

Optional. Für Ladenverkäufe erforderlich. Die Kennung für ein Geschäft, in dem das Ereignis stattgefunden hat.

city

string

Optional. Der Name der Stadt, in der das Ereignis stattgefunden hat.

subdivision_code

string

Optional. Der Code für die nationale Verwaltungseinheit gemäß ISO 3166-2, in der das Ereignis stattgefunden hat.

region_code

string

Optional. Der aus zwei Buchstaben bestehende CLDR-Regionscode der Adresse des Nutzers.

subcontinent_code

string

Optional. Der Subkontinentcode im UN M49-Format, in dem das Ereignis stattgefunden hat.

continent_code

string

Optional. Der Kontinentcode im UN M49-Format, in dem das Ereignis stattgefunden hat.

EventParameter

Ereignisparameter für GA4-Ereignisse.

Felder
parameter_name

string

Erforderlich. Der Name des zu verwendenden Parameters.

value

string

Erforderlich. Die Stringdarstellung des Werts des festzulegenden Parameters.

EventSource

Die Quelle des Ereignisses.

Enums
EVENT_SOURCE_UNSPECIFIED EventSource nicht angegeben. Sollte nicht verwendet werden.
WEB Das Ereignis wurde über einen Webbrowser generiert.
APP Der Termin wurde von einer App generiert.
IN_STORE Der Termin wurde aus einer Transaktion im Geschäft generiert.
PHONE Der Termin wurde anhand eines Telefonanrufs erstellt.
MESSAGE Der Termin wurde aus einer Nachricht 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 Wert, der für das Feld festgelegt werden soll.

FeatureSet

Die Menge der unterstützten Funktionen für einen Partnerlink.

Enums
FEATURE_SET_UNSPECIFIED Nicht angegebenes Feature-Set. Wenn nichts angegeben ist, wird standardmäßig FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT verwendet.
FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT Gibt einen Link an, der für die Zielgruppen- und Ereignisverwaltung verwendet wird.
FEATURE_SET_AD_EVENT_MANAGEMENT Gibt einen Link an, der für die Verwaltung von Anzeigenereignissen verwendet wird.

FieldWarning

Detaillierte Warnung auf Zeilenebene mit Feldpfaden.

Felder
reason

WarningReason

Der Grund für die Warnung.

description

string

Die ausführliche Warnmeldung, in der das Problem beschrieben wird.

field

string

Der Feldpfad, der die Warnung ausgelöst hat. Verwendet dasselbe Format wie google.rpc.BadRequest.FieldViolation.field.

GcpWrappedKeyInfo

Informationen zum umschlossenen Schlüssel der Google Cloud Platform

Felder
key_type

KeyType

Erforderlich. Der 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 Key Management Service. Sollte 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 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 Herren.
GENDER_FEMALE Damen.

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}

GoogleUserIdData

Google-Nutzer-ID-Daten mit verschlüsselten Google-Nutzer-IDs. Mindestens eine Google-Nutzer-ID ist erforderlich.

Felder
google_user_ids[]

string

Erforderlich. Die Liste der verschlüsselten Google-Nutzer-IDs.

IngestAdEventsRequest

Anfrage zum Hochladen von Anzeigenereignissen.

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

AdEvent

Erforderlich. Erforderlich (mindestens 1). Eine Liste von Werbeereignissen.

encryption_info

EncryptionInfo

Optional. Informationen zu Verschlüsselungsschlüsseln, die zum Verschlüsseln der Daten verwendet werden. Dieses Feld muss angegeben werden, wenn Anzeigenereignisse UserData enthalten.

validate_only
(deprecated)

bool

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

IngestAdEventsResponse

Dieser Typ hat keine Felder.

Antwort auf einen Vorgang zum Erfassen von Anzeigenereignissen.

IngestAudienceMembersRequest

Fordern Sie an, dass Zielgruppenmitglieder in die angegebenen Ziele hochgeladen werden. 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, aber keine Ergebnisse zurückgegeben.

encoding

Encoding

Optional. Muss für UserData-Uploads angegeben werden. 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. Verschlüsselungsinformationen für UserData-Uploads. Wenn nicht festgelegt, wird davon ausgegangen, dass hochgeladene personenidentifizierbare Informationen 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.

field_warnings[]

FieldWarning

Detaillierte Warnungen auf Zeilenebene mit Feldpfaden.

IngestEventsRequest

Fordern Sie an, dass Zielgruppenmitglieder in die angegebenen Ziele hochgeladen werden. 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, aber keine Ergebnisse zurückgegeben.

encoding

Encoding

Optional. Muss für UserData-Uploads angegeben werden. 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. Verschlüsselungsinformationen für UserData-Uploads. Wenn nicht festgelegt, wird davon ausgegangen, dass hochgeladene personenidentifizierbare Informationen 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.

field_warnings[]

FieldWarning

Detaillierte Warnungen auf Zeilenebene mit Feldpfaden.

IngestUsersRequest

Anfrage zum Hochladen von Nutzern an die angegebenen Ziele.

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

Destination

Erforderlich. Die Liste der möglichen Aufnahmeziele.

users[]

User

Erforderlich. Die Liste der Nutzer, die aufgenommen werden sollen.

encryption_info

EncryptionInfo

Optional. Verschlüsselungsinformationen zu Verschlüsselungsschlüsseln, die zum Verschlüsseln der Daten verwendet werden.

validate_only

bool

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

encoding

Encoding

Erforderlich. Der Codierungstyp der Nutzer-IDs. Bei verschlüsselten Nutzer-IDs gilt dies nur für die äußere Codierung.

IngestUsersResponse

Antwort von IngestUsersRequest.

Felder
request_id

string

Die generierte Anfrage-ID der Ingestion Request.

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 zu den upload_key_types gehört.

mobile_id_info

MobileIdInfo

Optional. Zusätzliche Informationen, wenn MOBILE_ID zu den upload_key_types gehört.

user_id_info

UserIdInfo

Optional. Zusätzliche Informationen, wenn USER_ID zu den upload_key_types gehört.

pair_id_info

PairIdInfo

Optional. Zusätzliche Informationen, wenn PAIR_ID zu den upload_key_types gehört.

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

IDs für Datenverwaltungsplattformen:

  • 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
  • Allgemeine Geräte-ID

IpData

IP-Adressinformationen für einen Nutzer. Wir empfehlen, „observe_start_time“ und „observe_end_time“ anzugeben, um die Abgleichsraten für den Kundenabgleich zu verbessern.

Felder
ip_address

string

Erforderlich. Die IP-Adresse, die zum Zeitpunkt der Kundeninteraktion erfasst wurde. Akzeptiert Standardstringformate für IPv4 und IPv6.

observe_start_time

Timestamp

Optional. Zeitpunkt der ersten aufgezeichneten Interaktion von dieser IP-Adresse in einer Sitzung.

observe_end_time

Timestamp

Optional. Zeitpunkt der letzten aufgezeichneten Interaktion von dieser IP-Adresse in einer Sitzung.

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 und im Ereignis enthalten sein sollen, die nicht bereits über andere strukturierte Felder angegeben wurden.

merchant_id

string

Optional. Die mit dem Artikel verknüpfte Merchant Center-ID. Bei Store Sales-Ereignissen wird der auf Einkaufswagenebene festgelegte Wert dadurch überschrieben. Dieses Feld wird bei anderen Ereignissen ignoriert.

merchant_feed_label

string

Optional. Das Feedlabel des Merchant Center-Feeds. Wenn Länder weiterhin verwendet werden, kann stattdessen der aus zwei Buchstaben bestehende Ländercode nach ISO 3166-1 alpha-2 verwendet werden. Bei Store Sales-Ereignissen wird der auf Einkaufswagenebene festgelegte Wert dadurch überschrieben. Dieses Feld wird bei anderen Ereignissen ignoriert.

merchant_feed_language_code

string

Optional. Der Sprachcode in ISO 639-1, der mit dem Merchant Center-Feed verknüpft ist, in den Ihre Artikel hochgeladen werden.

custom_variables[]

ItemCustomVariable

Optional. Zusätzliche Informationen in Form von Schlüssel/Wert-Paaren, die an die Conversion-Container (Conversion-Aktion oder Floodlight-Aktivität) gesendet werden, wenn Conversions auf Artikelebene erfasst werden.

conversion_value

double

Optional. Der Conversion-Wert, der diesem Artikel innerhalb des Ereignisses zugeordnet ist, wenn der Conversion-Wert für die einzelnen Artikel unterschiedlich ist.

ItemCustomVariable

Benutzerdefinierte Variable auf Artikelebene für Anzeigen-Conversions.

Felder
variable

string

Optional. Der Name der benutzerdefinierten Variablen, 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.

ItemParameter

Ein Bucket mit allen Ereignisparametern, die sich auf ein Element beziehen und im Ereignis enthalten sein sollen, die nicht bereits über andere strukturierte Felder angegeben wurden.

Felder
parameter_name

string

Erforderlich. Der Name des zu verwendenden Parameters.

value

string

Erforderlich. Die Stringdarstellung des Werts des festzulegenden Parameters.

ListUserListDirectLicensesRequest

Fordern Sie 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 das Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ haben

filter

string

Optional. Ein Filterstring, der auf die Listenanfrage angewendet werden soll. Alle Felder müssen sich auf der linken Seite jeder Bedingung befinden (z. B. user_list_id = 123). Felder müssen entweder alle im CamelCase oder alle im SnakeCase angegeben werden. Verwenden Sie keine Kombination aus Camel Case und Snake Case.

Unterstützte Vorgänge:

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

Unterstützte Funktionen:IN(field, value1, value2, ...): Gibt „true“ zurück, wenn das Feld mit einem der Werte übereinstimmt. Beispiel: IN(user_list_id, 123, 456)

Nicht unterstützte Felder:

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

int32

Optional. Die maximale Anzahl der 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

Fordern Sie an, alle UserListGlobalLicenseCustomerInfo-Ressourcen für eine bestimmte globale Lizenz für Nutzer aufzulisten.

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. Ein Filterstring, der auf die Listenanfrage angewendet werden soll. Alle Felder müssen sich auf der linken Seite jeder Bedingung befinden (z. B. user_list_id = 123). Felder müssen entweder alle im CamelCase oder alle im SnakeCase angegeben werden. Verwenden Sie keine Kombination aus Camel Case und Snake Case.

Unterstützte Vorgänge:

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

Unterstützte Funktionen:IN(field, value1, value2, ...): Gibt „true“ zurück, wenn das Feld mit einem der Werte übereinstimmt. Beispiel: IN(user_list_id, 123, 456)

Nicht unterstützte Felder:

  • name (verwenden Sie stattdessen die GET-Methode)
  • 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 Kundendaten 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

Fordern Sie 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 das Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ haben

filter

string

Optional. Ein Filterstring, der auf die Listenanfrage angewendet werden soll. Alle Felder müssen sich auf der linken Seite jeder Bedingung befinden (z. B. user_list_id = 123). Felder müssen entweder alle im CamelCase oder alle im SnakeCase angegeben werden. Verwenden Sie keine Kombination aus Camel Case und Snake Case.

Unterstützte Vorgänge:

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

Unterstützte Funktionen:IN(field, value1, value2, ...): Gibt „true“ zurück, wenn das Feld mit einem der Werte übereinstimmt. Beispiel: IN(user_list_id, 123, 456)

Nicht unterstützte Felder:

  • name (verwenden Sie stattdessen die GET-Methode)
  • 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"). Felder müssen entweder alle im CamelCase oder alle im SnakeCase angegeben werden. Verwenden Sie keine Kombination aus Camel Case und Snake Case.

Unterstützte Vorgänge:

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

Unterstützte Funktionen:IN(field, value1, value2, ...): Gibt „true“ zurück, wenn das Feld mit einem der Werte übereinstimmt. Beispiel: IN(display_name, "name1", "name2")

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 Der Bereich der 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]).

MediaQuartile

Die Menge der Medien, die als diskrete Quartile wiedergegeben wurden.

Enums
MEDIA_QUARTILE_UNSPECIFIED Nicht angegebenes Media-Quartil.
MEDIA_QUARTILE_START Start.
MEDIA_QUARTILE_FIRST_QUARTILE Erstes Quartil.
MEDIA_QUARTILE_MIDPOINT Mittelpunkt
MEDIA_QUARTILE_THIRD_QUARTILE Drittes Quartil.
MEDIA_QUARTILE_COMPLETE Abgeschlossen

MobileData

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

Felder
mobile_ids[]

string

Erforderlich. Die Liste der Mobilgeräte-IDs (Android-Werbe-ID, iOS-IDFA für Nutzerlisten zum Kundenabgleich und Android-Werbe-ID, iOS-IDFA, Xbox- oder Microsoft-ID, Amazon Fire TV-ID, Roku-ID, generische Geräte-ID für einfache Nutzerlisten). In einem einzelnen AudienceMember können maximal 10 mobileIds angegeben werden.

MobileIdInfo

Zusätzliche Informationen, wenn MOBILE_ID zu den upload_key_types gehört.

Felder
data_source_type

DataSourceType

Optional. Nicht veränderbar. Quelle der hochgeladenen 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 die 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. PII-Daten aus dem Data-Clean-Room, 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 zu den upload_key_types gehört.

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

Felder
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 für mehrere Cleanrooms verwendet werden.

publisher_name

string

Erforderlich. Ein beschreibender Name des Publishers, der in der Benutzeroberfläche angezeigt wird, um die Ausrichtung zu verbessern.

match_rate_percentage

int32

Erforderlich. Dieses Feld gibt den Prozentsatz der Mitgliedschaftsübereinstimmung dieser Nutzerliste mit den entsprechenden selbst erhobenen Daten des Publishers an. Muss zwischen 0 und 100 (einschließlich) liegen.

advertiser_identifier_count

int64

Optional. Die Anzahl der selbst erhobenen Datensätze des Werbetreibenden, die bei einem Data-Clean-Room-Anbieter hochgeladen wurden. Das ist nicht die Größe einer PAIR-Nutzerliste.

clean_room_identifier

string

Erforderlich. Nicht veränderbar. Gibt eine eindeutige Beziehung zwischen Werbetreibenden und Publishern mit einem oder mehreren Data-Clean-Room-Anbietern an.

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 Partner-Zielgruppenquelle ist die Zielgruppe für lineares Fernsehen.
AGENCY_PROVIDER_AUDIENCE Die Partnerzielgruppenquelle ist eine von einer Agentur/einem Dienstleister zusammengestellte Zielgruppe.

PartnerCustomerAccount

Stellt ein Kundenkonto im System des Partners dar.

Felder
account_id

string

Erforderlich. Die Kennung des Kundenkontos im ID-Bereich des Partners.

account_name

string

Optional. Der Name des Kontos.

account_type

string

Optional. Der Kontotyp. Kann verwendet werden, um beispielsweise zwischen Werbetreibendenkonten und Konten auf Unternehmensebene zu unterscheiden.

PartnerLinkMetadata

Stellt Metadaten dar, die mit einem Partnerlink verknüpft sind.

Felder
implicit_accounts[]

PartnerCustomerAccount

Optional. Die Liste der impliziten Konten.

PartnerProvidedIdData

Von Partnern bereitgestellte Daten mit den von Partnern bereitgestellten Kennungen. Mindestens eine vom Partner bereitgestellte Kennung ist erforderlich.

Felder
partner_provided_ids[]

string

Erforderlich. Die Liste der von Partnern bereitgestellten IDs.

Plattform

Weitere Details zur Plattform, auf der die Anzeige ausgeliefert wurde.

Enums
PLATFORM_UNSPECIFIED Nicht angegebene Plattform.
PLATFORM_IOS iOS-Plattform
PLATFORM_ANDROID Android-Plattform
PLATFORM_WEB Webplattform

PlatformType

Der Typ der Plattform, auf der die Anzeige ausgeliefert wurde.

Enums
PLATFORM_TYPE_UNSPECIFIED Nicht angegebener Plattformtyp
PLATFORM_TYPE_MOBILE Mobile Plattform
PLATFORM_TYPE_DESKTOP Desktop-Plattform
PLATFORM_TYPE_CTV CTV-Plattform
PLATFORM_TYPE_PHONE Smartphone-Plattform
PLATFORM_TYPE_TABLET Tablet-Plattform

PpidData

Daten zu vom Publisher bereitgestellten Kennungen (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 Kennungen für einen Nutzer.

ProcessingErrorReason

Der Grund für den Verarbeitungsfehler. In Zukunft werden möglicherweise neue Gründe hinzugefügt.

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 Eine Conversion mit derselben Kombination aus GCLID sowie Datum und Uhrzeit der Conversion ist bereits 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-Klick-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 Mindestschwellenwert.
PROCESSING_ERROR_REASON_INVALID_FORMAT Der Termin enthält einen Formatierungsfehler.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR Beim Termin ist ein Entschlüsselungsfehler aufgetreten.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR Der DEK konnte nicht entschlüsselt werden.
PROCESSING_ERROR_REASON_INVALID_WIP Der WIP ist falsch formatiert oder nicht vorhanden.
PROCESSING_ERROR_REASON_INVALID_KEK Mit dem KEK können keine Daten entschlüsselt werden, weil er falsch ist oder 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 für den Zugriff auf den KEK.
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.
PROCESSING_ERROR_REASON_ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID Conversion-Aktionen, für die die Zählmethode „1-pro-Klick“ verwendet wird, können nicht mit BRAIDs verwendet werden.
PROCESSING_ERROR_REASON_MATCH_ID_NOT_FOUND Die Spiel-ID wurde nicht gefunden.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_MATCH_ID Die Nutzer-ID kann für die Spiel-ID nicht gefunden werden.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_GCLID Die Nutzer-ID konnte für die GCLID nicht gefunden werden.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_DCLID Die Nutzer-ID wurde für die DCLID nicht gefunden.
PROCESSING_ERROR_REASON_INVALID_AD_IDENTIFIERS Es sind ungültige Werbe‑IDs vorhanden.
PROCESSING_ERROR_REASON_INVALID_MOBILE_ID_FORMAT Das Format der Mobilgeräte-ID ist ungültig.
PROCESSING_ERROR_REASON_ORIGINAL_CONVERSIONS_NOT_FOUND Die ursprünglichen Conversions wurden nicht gefunden.
PROCESSING_ERROR_REASON_EVENT_ID_DECODE_ERROR Die Ereignis-ID (dclid oder Impressions-ID) kann nicht decodiert werden.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_IMPRESSION_ID Die Nutzer-ID konnte für die angegebene Impression-ID nicht gefunden werden.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND Die Nutzer-ID wurde nicht gefunden.
PROCESSING_ERROR_REASON_CONVERSION_PRECEDES_CLICK Der Zeitstempel des Ereignisses lag vor dem zugehörigen Klick.
PROCESSING_ERROR_REASON_TOO_RECENT_CLICK Der Klick ist zu neu.
PROCESSING_ERROR_REASON_INVALID_CLICK Das Ereignis kann keinem Klick (GCLID) zugeordnet werden. Eventuell stammt der Klick nicht aus einer Google Ads-Kampagne.
PROCESSING_ERROR_REASON_INVALID_OPERATING_ACCOUNT_FOR_CLICK Der Klick aus dem Ereignis ist nicht mit dem operating_account des Ziels verknüpft.
PROCESSING_ERROR_REASON_CLICK_NOT_FOUND Es wurde kein entsprechender Klick gefunden, der den angegebenen Attributen entspricht.
PROCESSING_ERROR_REASON_EXTERNAL_ATTRIBUTION_DATA_MISSING Externe Attributionsdaten fehlen. Das Senden von Ereignissen an ein Ziel für eine Conversion-Aktion mit externer Attribution wird nicht unterstützt.

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 für den Zugriff auf den KEK.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR Der DEK konnte nicht entschlüsselt werden.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR Beim Termin ist ein Entschlüsselungsfehler 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 Der WIP ist falsch formatiert oder nicht vorhanden.
PROCESSING_WARNING_REASON_INVALID_KEK Mit dem KEK können keine Daten entschlüsselt werden, da 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-Kontonummer.

account_type

AccountType

Erforderlich. Der Kontotyp. Beispiel: GOOGLE_ADS. Entweder account_type oder das eingestellte 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.
FLOODLIGHT_CONFIG Floodlight-Konfiguration.
GOOGLE_AD_MANAGER Google Ad Manager

PseudonymousIdInfo

Zusätzliche Informationen, wenn PSEUDONYMOUS_ID zu den upload_key_types gehört.

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 korrekt synchronisiert.
FAILED Beim Synchronisieren von Nutzerlisteninhalten und/oder ‑metadaten ist ein Fehler aufgetreten. Die Nutzerliste kann nicht verwendet werden.

RemoveAllAudienceMembersRequest

Antrag zum Entfernen aller Nutzer aus einer Zielgruppe in den angegebenen Zielen. Gibt RemoveAllAudienceMembersResponse 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.

remove_as_of_time

Timestamp

Optional. Die Uhrzeit, zu der die Entfernung erfolgt. Wenn diese Option festgelegt ist, werden nur Zielgruppenmitglieder entfernt, die zuletzt vor diesem Zeitpunkt hinzugefügt wurden. Wenn nichts anderes festgelegt ist, wird standardmäßig die aktuelle Zeit verwendet. Die Uhrzeit für das Entfernen darf nicht in der Zukunft liegen.

validate_only

bool

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

RemoveAllAudienceMembersResponse

Antwort von RemoveAllAudienceMembersRequest.

Felder
request_id

string

Die automatisch generierte ID der Anfrage.

RemoveAudienceMembersRequest

Antrag auf Entfernung von Nutzern aus einer Zielgruppe an 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, aber keine Ergebnisse zurückgegeben.

encoding

Encoding

Optional. Muss für UserData-Uploads angegeben werden. 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. Verschlüsselungsinformationen für UserData-Uploads. Wenn nicht festgelegt, wird davon ausgegangen, dass hochgeladene personenidentifizierbare Informationen 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.

RemoveUsersRequest

Antrag auf Entfernung von Nutzern aus den angegebenen Zielen.

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

Destination

Erforderlich. Die Liste der möglichen Aufnahmeziele.

user_data[]

UserData

Erforderlich. Die einzelnen UserData-Bits, die als Schlüssel für die zu entfernenden Nutzer dienen.

encryption_info

EncryptionInfo

Optional. Verschlüsselungsinformationen zu Verschlüsselungsschlüsseln, die zum Verschlüsseln der Daten verwendet werden.

validate_only

bool

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

encoding

Encoding

Erforderlich. Der Codierungstyp der Nutzer-IDs. Bei verschlüsselten Nutzer-IDs gilt dies nur für die äußere Codierung.

RemoveUsersResponse

Antwort von RemoveUsersRequest.

Felder
request_id

string

Die generierte Anfrage-ID der Ingestion Request.

RequestStatusPerDestination

Einen 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 der Anzahl der Fehler im Zusammenhang mit dem Upload. Wird nur ausgefüllt, wenn request_status FAILED oder PARTIAL_SUCCESS ist. Dieses Feld wird nicht ausgefüllt, wenn die Anfrage request_status von PROCESSING hat.

warning_info

WarningInfo

Eine Warnung mit dem Grund für die Warnung und der Anzahl der Warnungen im Zusammenhang mit dem Upload. Dieses Feld wird nicht ausgefüllt, wenn die Anfrage request_status von PROCESSING hat.

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 Aufnehmen von Zielgruppenmitgliedern.

events_ingestion_status

IngestEventsStatus

Der Status der Anfrage für die Aufnahme von Ereignissen.

audience_members_removal_status

RemoveAudienceMembersStatus

Der Status des Antrags zum Entfernen von Zielgruppenmitgliedern.

remove_all_audience_members_status

RemoveAllAudienceMembersStatus

Der Status der Anfrage zum Entfernen aller Zielgruppenmitglieder.

DataType

Der Datentyp.

Enums
DATA_TYPE_UNSPECIFIED Der Datentyp ist nicht angegeben.
EMAIL Die Daten sind eine E‑Mail-Adresse.
PHONE_NUMBER Die Daten sind eine Telefonnummer.
ADDRESS Die Daten sind eine physische Adresse.
IP_ADDRESS Die Daten sind eine IP-Adresse.

DataTypeCount

Die Anzahl für einen bestimmten Datentyp.

Felder
type

DataType

Der Datentyp.

count

int64

Die Anzahl für diesen Datentyp.

IngestAudienceMembersStatus

Der Status der Anfrage zum Aufnehmen 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 Datenaufnahme von Nutzerdaten in das Ziel.

mobile_data_ingestion_status

IngestMobileDataStatus

Der Status der Datenaufnahme mobiler Daten am Zielort.

pair_data_ingestion_status

IngestPairDataStatus

Der Status der Datenaufnahme des Paares am Zielort.

user_id_data_ingestion_status

IngestUserIdDataStatus

Der Status der Datenaufnahme der Nutzer-ID am Ziel.

ppid_data_ingestion_status

IngestPpidDataStatus

Der Status der Aufnahme von PPID-Daten in das Ziel.

composite_data_ingestion_status

IngestCompositeDataStatus

Der Status der Datenaufnahme zusammengesetzter Daten am Ziel.

google_user_id_data_ingestion_status

IngestGoogleUserIdDataStatus

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

partner_provided_id_data_ingestion_status

IngestPartnerProvidedIdDataStatus

Der Status der Aufnahme von ID-Daten, die vom Partner bereitgestellt wurden, in das Ziel.

IngestCompositeDataStatus

Der Status der Datenaufnahme von zusammengesetzten 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.

data_type_counts[]

DataTypeCount

Die Gesamtzahl der Datentypen, die in der Uploadanfrage für das Ziel gesendet wurden, aufgeschlüsselt nach Datentyp. Enthält alle Datentypen in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht.

upload_match_rate_range

MatchRateRange

Der Bereich der Abgleichsrate des Uploads.

IngestEventsStatus

Der Status der Ereignisaufnahme am Ziel.

Felder
record_count

int64

Die Gesamtzahl der Ereignisse, die in der Uploadanfrage gesendet wurden. Enthält alle Ereignisse in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht.

IngestGoogleUserIdDataStatus

Der Status der Datenaufnahme von Google-Nutzer-ID-Daten in das Ziel mit Statistiken zur Datenaufnahme.

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.

google_user_id_count

int64

Die Gesamtzahl der Google-Nutzer-IDs, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Google-Nutzer-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht.

IngestMobileDataStatus

Der Status der Datenaufnahme mobiler Daten für das Ziel, einschließlich Statistiken zur Datenaufnahme.

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 mobilen IDs, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle mobilen IDs in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht.

IngestPairDataStatus

Der Status der Datenaufnahme des Paares 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.

pair_id_count

int64

Die Gesamtzahl der Paar-IDs, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Paar-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht.

IngestPartnerProvidedIdDataStatus

Der Status der Datenaufnahme von Partner-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.

partner_provided_id_count

int64

Die Gesamtzahl der vom Partner bereitgestellten IDs, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle vom Partner bereitgestellten IDs in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht.

IngestPpidDataStatus

Der Status der PPID-Datenaufnahme in der Ziel-Property mit Statistiken zur Datenaufnahme.

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 Datenaufnahme von Nutzerdaten in das Ziel, einschließlich Statistiken zur Datenaufnahme.

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 Nutzerkennungen, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Nutzerkennungen 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 Datenaufnahme von Nutzer-IDs in das Ziel, einschließlich 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.

RemoveAllAudienceMembersStatus

Dieser Typ hat keine Felder.

Der Status der Anfrage zum Entfernen aller Zielgruppenmitglieder.

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 vom Ziel.

mobile_data_removal_status

RemoveMobileDataStatus

Der Status des Entfernens der Mobilfunkdaten vom 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.

composite_data_removal_status

RemoveCompositeDataStatus

Der Status des Entfernens der zusammengesetzten Daten aus dem Ziel.

google_user_id_data_removal_status

RemoveGoogleUserIdDataStatus

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

partner_provided_id_data_removal_status

RemovePartnerProvidedIdDataStatus

Der Status des Entfernens von Partner-IDs aus dem Ziel.

RemoveCompositeDataStatus

Der Status des Entfernens der zusammengesetzten Daten aus dem Ziel.

Felder
record_count

int64

Die Gesamtzahl der Zielgruppenmitglieder, die in der Löschanfrage gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

data_type_counts[]

DataTypeCount

Die Gesamtzahl der in der Anfrage auf Entfernung gesendeten Datentypen, aufgeschlüsselt nach Datentyp. Enthält alle Datentypen in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

RemoveGoogleUserIdDataStatus

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

Felder
record_count

int64

Die Gesamtzahl der Zielgruppenmitglieder, die in der Löschanfrage gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

google_user_id_count

int64

Die Gesamtzahl der in der Entfernungssanfrage gesendeten Google-Nutzer-IDs. Enthält alle Google-Nutzer-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

RemoveMobileDataStatus

Der Status des Entfernens der Mobilfunkdaten vom Ziel.

Felder
record_count

int64

Die Gesamtzahl der Zielgruppenmitglieder, die in der Löschanfrage 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 Entfernungssanfrage 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 Löschanfrage 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 Löschanfrage gesendeten PAIR‑IDs. Enthält alle Paar-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

RemovePartnerProvidedIdDataStatus

Der Status des Entfernens von Partner-IDs aus dem Ziel.

Felder
record_count

int64

Die Gesamtzahl der Zielgruppenmitglieder, die in der Löschanfrage gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

partner_provided_id_count

int64

Die Gesamtzahl der vom Partner bereitgestellten IDs, die in der Löschanfrage gesendet wurden. Enthält alle vom Partner bereitgestellten 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 Löschanfrage 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 vom Ziel.

Felder
record_count

int64

Die Gesamtzahl der Zielgruppenmitglieder, die in der Löschanfrage 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 im Antrag auf Entfernung 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 Löschanfrage 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 Verarbeitung aller Datensätze wurde ohne Fehler abgeschlossen. Im Feld warning_info können jedoch Warnungen enthalten sein.
PROCESSING Die Anfrage wird bearbeitet.
FAILED Die Verarbeitung ist für alle Datensätze fehlgeschlagen. Sehen Sie im Feld error_info nach Fehlerdetails und im Feld warning_info nach Warnungsdetails.
PARTIAL_SUCCESS Die Verarbeitung wurde für einige Datensätze ohne Fehler abgeschlossen, für andere jedoch mit Fehlern. Sehen Sie im Feld error_info nach Fehlerdetails und im Feld warning_info nach Warnungsdetails.

RetrieveInsightsRequest

Anfrage 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. Die Baseline für die angeforderten Statistiken.

user_list_id

string

Erforderlich. Die Nutzerlisten-ID, 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 für 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 UserInterest-Objekt vom Typ „Affinity“.
IN_MARKET_USER_INTEREST UserInterest für kaufbereite Nutzer.
AGE_RANGE Eine Altersgruppe.
GENDER Ein Geschlecht.

MarketingDataInsightsAttribute

Statistiken für eine Sammlung ähnlicher 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 ein 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 der 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 50 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). Felder müssen entweder alle im CamelCase oder alle im SnakeCase angegeben werden. Verwenden Sie keine Kombination aus Camel Case und Snake Case.

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
  • feature_set

Für Partnerlinks mit dem Feature-Set FEATURE_SET_AD_EVENT_MANAGEMENT werden auch die folgenden Felder unterstützt:

  • partner_customer_account.account_id
  • partner_link_metadata.implicit_accounts.account_id

Beispiel: owning_account.account_type = "GOOGLE_ADS" AND 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 Segmente sind für das Targeting in Suchkampagnen verfügbar.

youtube_members_count

int64

Nur Ausgabe. Geschätzte Anzahl der Mitglieder in dieser Nutzerliste auf YouTube.

gmail_members_count

int64

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

TargetNetworkInfo

Informationen zu den Voraussetzungen für verschiedene Zielnetzwerke.

Felder
eligible_for_display

bool

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

TargetingType

Der Targeting-Typ, der für die Auslieferung der Anzeige verwendet wurde.

Enums
TARGETING_TYPE_UNSPECIFIED Nicht angegebener Ausrichtungstyp
TARGETING_TYPE_AUDIENCE Zielgruppen-Targeting
TARGETING_TYPE_CONTEXTUAL Kontext-Targeting
TARGETING_TYPE_DEMOGRAPHIC Demografisches Targeting.
TARGETING_TYPE_DEVICE Geräte-Targeting:
TARGETING_TYPE_GEO Geografisches Targeting
TARGETING_TYPE_INTEREST Ausrichtung auf Interessengebiete.
TARGETING_TYPE_PURCHASE_INTENT Targeting auf Kaufabsicht
TARGETING_TYPE_REMARKETING Remarketing-Targeting

TermsOfService

Die Nutzungsbedingungen, die der Nutzer akzeptiert oder abgelehnt hat.

Felder
customer_match_terms_of_service_status

TermsOfServiceStatus

Optional. 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.

Nutzer

Stellt einen einzelnen Nutzer dar und enthält Kennungen wie personenidentifizierbare Informationen und Mobilgeräte-IDs, die sich alle auf denselben Nutzer beziehen.

Felder
user_data

UserData

Erforderlich. Mehrere von Nutzern bereitgestellte Daten, die zur Identifizierung des Nutzers verwendet werden.

mobile_data

MobileData

Erforderlich. Mehrere Mobilgeräte-ID-Strings, die einen einzelnen Nutzer repräsentieren.

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 zu den upload_key_types gehört.

Felder
data_source_type

DataSourceType

Optional. Nicht veränderbar. Quelle der hochgeladenen Daten.

UserIdentifier

Eine einzelne Kennung für den Nutzer.

Felder
Union-Feld identifier. Es muss genau eines 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, für 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 dieser Mitgliedschaftsstatus der Nutzerliste geschlossen ist.

account_access_status

AccessStatus

Optional. Gibt an, ob diese Freigabe noch aktiviert ist. Wenn eine Nutzerliste für das Konto freigegeben ist, ist dieses Feld auf ENABLED festgelegt. 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 bereitgestellten Daten gefüllt wird.

AccessReason

Enum, das 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 Kunde noch 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 gefü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 Kundenkontos, für das die Nutzerliste lizenziert wird.

status

UserListLicenseStatus

Optional. Status von UserListDirectLicense: ENABLED oder DISABLED.

UserListGlobalLicense

Eine globale Lizenz für Nutzerlisten.

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 globale Lizenzen für Nutzerlisten.

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 gefü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 Kundenkontos, für das 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 UNSPECIFIED.
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 Nutzerlisten.

impression_count

int64

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

revenue_usd_micros

int64

Nur Ausgabe. Der Umsatz für die Lizenz für die Nutzerliste 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. Wenn currency_code beispielsweise USD ist, bedeutet 2.000.000 $, also 2 $.

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 Vorgang create 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. Wenn currency_code beispielsweise USD ist, bedeutet 2.000.000 $, also 2 $.

Dies 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 kein Limit.

UserListPricingBuyerApprovalState

Status der Käufergenehmigung für die Preisgestaltung von Nutzerlisten.

Enums
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED UNSPECIFIED.
PENDING Der Client der Nutzerliste 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 weiterhin 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. Art 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.

ViewType

Der Typ des Ereignisses.

Enums
VIEW_TYPE_UNSPECIFIED Nicht angegebener Ansichtstyp.
VIEW_TYPE_MRC_VIEWED Gemäß MRC angesehen.
VIEW_TYPE_MRC_RENDERED MRC-gerendert.

ViewabilityInfo

Details zur Sichtbarkeit der ausgelieferten Anzeige.

Felder
view_type

ViewType

Erforderlich. Der Typ des Ereignisses.

viewable_percent

int32

Optional. Der numerische Prozentsatz (0–100) der sichtbaren Pixel.

viewable_duration

Duration

Optional. Die Zeit, in der die Anzeige sichtbar war.

media_skippable

bool

Optional. Gibt an, ob die Anzeigenmedien überspringbar waren.

media_quartile

MediaQuartile

Optional. Die Menge der Medien, die als diskrete Quartile wiedergegeben wurden.

media_duration

Duration

Optional. Die Länge der Anzeigenmedien.

media_volume_percent

int32

Optional. Der numerische Prozentsatz (0–100) der Lautstärke der Medienwiedergabe.

playback_duration

Duration

Optional. Die Dauer der Wiedergabe der Anzeigenmedien, unabhängig davon, ob sie sichtbar waren.

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 Warnungsgrund.

WarningReason

Gründe für nicht blockierende Warnungen, die während der Aufnahme zurückgegeben werden.

Enums
WARNING_REASON_UNSPECIFIED Der Grund für die Warnung wurde nicht angegeben.
WARNING_REASON_CUSTOM_VARIABLE_NOT_ENABLED Eine benutzerdefinierte Variable in custom_variables ist im Konto nicht aktiviert.
WARNING_REASON_CUSTOM_VARIABLE_NOT_PREDEFINED Ein Wert für eine benutzerdefinierte Variable in custom_variables gehört nicht zu den vordefinierten zulässigen Werten, die für die benutzerdefinierte Variable im Zielkonto konfiguriert sind.
WARNING_REASON_CART_DATA_NOT_SUPPORTED_WITH_GBRAID_OR_WBRAID cart_data wird mit gbraid oder wbraid nicht unterstützt.
WARNING_REASON_CART_DATA_ITEM_MERCHANT_PRODUCT_ID_MISSING Im Warenkorbartikel fehlt die merchant_product_id.
WARNING_REASON_CART_DATA_ITEM_UNIT_PRICE_MISSING Im Warenkorbartikel fehlt die unit_price.
WARNING_REASON_GENERIC Allgemeiner Warnungsgrund für Probleme, die nicht in andere spezifische Kategorien fallen.
WARNING_REASON_INVALID_CLIENT_ID Die client_id ist ungültig.
WARNING_REASON_INVALID_SUBDIVISION_CODE Die subdivision_code ist ungültig.
WARNING_REASON_INVALID_REGION_CODE Die region_code ist ungültig.
WARNING_REASON_INVALID_SUBCONTINENT_CODE Die subcontinent_code ist ungültig.
WARNING_REASON_INVALID_CONTINENT_CODE Die continent_code ist ungültig.
WARNING_REASON_INVALID_DEVICE_CATEGORY Das Gerät category ist ungültig.
WARNING_REASON_INVALID_DEVICE_SCREEN_RESOLUTION Das Gerät screen_height oder screen_width ist ungültig.
WARNING_REASON_INVALID_MERCHANT_ID Die merchant_id ist ungültig.