Package google.ads.datamanager.v1

string

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

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

EventType

Erforderlich. Der Typ des Ereignisses.

Timestamp

Erforderlich. Zeit, zu der das Ereignis aufgetreten ist.

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.

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.

DeviceInfo

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

string

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

string

Erforderlich. Die ID der zugehörigen Kampagne.

string

Erforderlich. Der Name der zugehörigen Kampagne.

string

Optional. Die ID der zugehörigen Anzeigengruppe.

string

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

int32

Optional. Die Höhe der Anzeige in Pixeln.

int32

Optional. Die Breite der Anzeige in Pixeln.

string

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

string

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

string

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

AttributionHint

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

Dies dient nur als Signal dafür, wie die Attribution aus Sicht des Partners abgelaufen ist, und erzwingt kein Endergebnis in endgültigen Berichten.

ViewabilityInfo

Erforderlich. Details zur Sichtbarkeit der ausgelieferten Anzeige.

EventSubtype

Enum-Wert für den Untertyp des Ereignisses.

string

Stringwert für den Ereignisuntertyp.

AdType

Enum-Wert für den Anzeigentyp.

string

Stringwert für den Anzeigentyp.

AdFormat

Enum-Wert für das Anzeigenformat.

string

Stringwert für das Anzeigenformat.

AdPlacement

Enum-Wert für das Anzeigen-Placement.

string

Stringwert für das Anzeigen-Placement.

TargetingType

Enum-Wert für den Targeting-Typ.

string

Stringwert für den Targeting-Typ.

PlatformType

Enum-Wert für den Plattformtyp.

string

Stringwert für den Plattformtyp.

Platform

Enum-Wert für die Plattform.

string

Stringwert für die Plattform.

bool

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

string

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

string

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

string

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

string

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

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.

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.

string

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

string

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

string

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

EncryptedUserId

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

string

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

string

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

string

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

string

Erforderlich. Die Postleitzahl der Adresse des Nutzers.

string

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

Consent

Optional. Die Einwilligungseinstellung für den Nutzer.

UserData

Von Nutzern bereitgestellte Daten, die den Nutzer identifizieren.

PairData

PAIR-IDs (Identitätsabgleich zwischen Publishern und Werbetreibenden).

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

MobileData

Daten zur Identifizierung der Mobilgeräte des Nutzers.

UserIdData

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

PpidData

Daten im Zusammenhang mit vom Publisher bereitgestellten Kennungen.

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

CompositeData

Gruppe mit mehreren Kennungstypen.

KeyType

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

string

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

string

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

string

Erforderlich. Der base64-codierte verschlüsselte Datenverschlüsselungsschlüssel.

Location

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

bool

Wenn der Wert auf „true“ gesetzt ist, versucht der Dienst, den Baseline-Standort für Statistiken automatisch zu erkennen.

string

Liste der Alpha‑2-Codes von ISO 3166-1 für Regionen.

string

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

string

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

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.

double

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

Item

Optional. Die Liste der mit dem Ereignis verknüpften Elemente.

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.

UserData

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

IpData

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

ConsentStatus

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

ConsentStatus

Optional. Gibt an, ob der Nutzer der personalisierten Werbung zustimmt.

int32

Nur Ausgabe. Abgleichsrate für Nutzerlisten zum Kundenabgleich.

DataSourceType

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

string

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

string

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

PartnerLink

Erforderlich. Die zu erstellende Partnerverknüpfung.

string

Erforderlich. Das Konto, dem die lizenzierte Nutzerliste gehört. Sollte das Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ haben.

UserListDirectLicense

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

string

Erforderlich. Das Konto, dem die lizenzierte Nutzerliste gehört. Sollte das Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ haben.

UserListGlobalLicense

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

string

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

UserList

Erforderlich. Die zu erstellende Nutzerliste.

bool

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

string

Optional. Der Name der benutzerdefinierten Variable, die festgelegt werden soll. Wenn die Variable für das angegebene Ziel nicht gefunden wird, wird sie ignoriert.

string

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

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.

string

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

string

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

bool

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

string

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

ProductAccount

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

ProductAccount

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

ProductAccount

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

string

Erforderlich. Das Objekt im Produktkonto, in das die Daten aufgenommen werden sollen. Das kann beispielsweise eine Google Ads-Zielgruppen-ID, eine Display & Video 360-Zielgruppen-ID oder eine Google Ads-Conversion-Aktions-ID sein.

string

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

string

Optional. Die IP-Adresse des Geräts für den angegebenen Kontext.

Hinweis:Google Ads unterstützt keinen IP-Adressen-Abgleich für Endnutzer im Europäischen Wirtschaftsraum (EWR), im Vereinigten Königreich und in der Schweiz. Fügen Sie eine Logik hinzu, um die Weitergabe von IP-Adressen von Nutzern aus diesen Regionen auszuschließen. Informieren Sie die Nutzer außerdem verständlich und umfassend über die Daten, die Sie auf Ihren Websites, in Ihren Apps und in anderen Properties erheben, und holen Sie die Einwilligung der Nutzer ein, sofern dies gesetzlich oder gemäß den anwendbaren Google-Richtlinien erforderlich ist. Weitere Informationen zu Offline-Conversion-Importen

string

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

string

Optional. Die auf dem Gerät verwendete Sprache im ISO 639-1-Format.

int32

Optional. Die Höhe des Bildschirms in Pixeln.

int32

Optional. Die Breite des Bildschirms in Pixeln.

string

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

string

Optional. Die Version des Betriebssystems oder der Plattform.

string

Optional. Das Modell des Geräts.

string

Optional. Die Marke des Geräts.

string

Optional. Die Marke oder der Typ des Browsers.

string

Optional. Die Version des Browsers.

string

Erforderlich. Die alphanumerische verschlüsselte ID.

EncryptionEntityType

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

int64

Erforderlich. Die Entitäts-ID der Verschlüsselung. Diese sollte mit der Verschlüsselungskonfiguration für die Anzeigenbereitstellung oder den Datenübertragungsdienst übereinstimmen.

EncryptionSource

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

GcpWrappedKeyInfo

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

AwsWrappedKeyInfo

Informationen zum verpackten Schlüssel von Amazon Web Services.

CoordinatorKeyInfo

Wichtige Informationen zum ausgewählten Koordinatorschlüssel.

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

int64

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

ProcessingErrorReason

Der Fehlergrund für die fehlgeschlagenen Datensätze.

ErrorCount

Eine Liste von Fehlern und die Anzahl der einzelnen Fehlerursachen. Möglicherweise nicht in allen Fällen verfügbar.

string

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

string

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

Timestamp

Erforderlich. Zeit, zu der das Ereignis aufgetreten ist.

Timestamp

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

UserData

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

Consent

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

AdIdentifiers

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

string

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

EventSource

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

DeviceInfo

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

CartData

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

CustomVariable

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

ExperimentalField

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

UserProperties

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

string

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

string

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

string

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

EventParameter

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

UserData

Optional. Dieselbe Art von Daten wie in „user_data“, aber explizit als Daten gekennzeichnet, die von einem Drittanbieter bereitgestellt werden und nicht als Daten des Werbetreibenden.

EventLocation

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

string

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

double

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

double

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

string

Optional. Erforderlich für Store Sales. Die Kennung für ein Ladengeschäft, in dem das Ereignis stattgefunden hat.

string

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

string

Optional. Der ISO 3166-2-Unterteilungscode für den Ort, an dem das Ereignis stattgefunden hat.

string

Optional. Der aus zwei Buchstaben bestehende CLDR-Regionscode der Nutzeradresse.

string

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

string

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

string

Erforderlich. Der Name des zu verwendenden Parameters.

string

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

string

Optional. Der Name des zu verwendenden Felds.

string

Optional. Der Wert, der für das Feld festgelegt werden soll.

KeyType

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

string

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

string

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

string

Erforderlich. Der base64-codierte verschlüsselte Datenverschlüsselungsschlüssel.

string

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

string

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

string

Erforderlich. Der Ressourcenname der abzurufenden UserList. Format: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

AdEvent

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

EncryptionInfo

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

bool

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

Destination

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

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

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.

bool

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

Encoding

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

EncryptionInfo

Optional. Informationen zur Verschlüsselung 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.

TermsOfService

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

string

Die automatisch generierte ID der Anfrage.

Destination

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

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

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.

bool

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

Encoding

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

EncryptionInfo

Optional. Informationen zur Verschlüsselung 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.

string

Die automatisch generierte ID der Anfrage.

UploadKeyType

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

ContactIdInfo

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

MobileIdInfo

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

UserIdInfo

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

PairIdInfo

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

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

PseudonymousIdInfo

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

PartnerAudienceInfo

Optional. Zusätzliche Informationen zu Partnerzielgruppen

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

string

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

Timestamp

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

Timestamp

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

string

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

int64

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

double

Optional. Der Stückpreis ohne Steuern, Versandkosten und etwaige Rabatte auf Transaktionsebene.

string

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

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.

string

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

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 Warenkorbebene festgelegte Wert dadurch überschrieben. Bei anderen Ereignissen wird dieses Feld ignoriert.

string

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

ItemCustomVariable

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

double

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

string

Optional. Der Name der benutzerdefinierten Variable, die festgelegt werden soll. Wenn die Variable für das angegebene Ziel nicht gefunden wird, wird sie ignoriert.

string

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

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.

string

Erforderlich. Der Name des zu verwendenden Parameters.

string

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

string

Erforderlich. Das Konto, dessen Lizenzen abgefragt werden. Sollte das Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ haben.

string

Optional. Ein Filterstring, der auf die Listenanfrage angewendet werden soll. Alle Felder müssen sich auf der linken Seite der jeweiligen 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 Methode „get“)
• historical_pricings und alle zugehörigen Unterfelder
• pricing.start_time
• pricing.end_time

int32

Optional. Die maximale Anzahl von Lizenzen, die pro Seite zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Lizenzen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

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.

UserListDirectLicense

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

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.

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/-).

string

Optional. Ein Filterstring, der auf die Listenanfrage angewendet werden soll. Alle Felder müssen sich auf der linken Seite der jeweiligen 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 Methode „get“)
• historical_pricings und alle zugehörigen Unterfelder
• pricing.start_time
• pricing.end_time

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.

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.

UserListGlobalLicenseCustomerInfo

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

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.

string

Erforderlich. Das Konto, dessen Lizenzen abgefragt werden. Sollte das Format „accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}“ haben.

string

Optional. Ein Filterstring, der auf die Listenanfrage angewendet werden soll. Alle Felder müssen sich auf der linken Seite der jeweiligen 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 Methode „get“)
• historical_pricings und alle zugehörigen Unterfelder
• pricing.start_time
• pricing.end_time

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.

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.

UserListGlobalLicense

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

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.

string

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

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.

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.

string

Optional. Ein Filterstring. Alle Felder müssen sich auf der linken Seite der jeweiligen 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

UserList

Die Nutzerlisten aus dem angegebenen Konto.

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.

string

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

DataSourceType

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

KeySpace

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

string

Erforderlich. Nicht veränderbar. Ein String, der eine mobile App, aus der die Daten erhoben wurden, eindeutig identifiziert.

string

Erforderlich. Von Cleanroom bereitgestellte personenbezogene Daten, die mit SHA256 gehasht und mit einer kommutativen EC-Verschlüsselung mit dem Publisher-Schlüssel für die PAIR-Nutzerliste verschlüsselt wurden. In einem einzelnen AudienceMember können maximal 10 pairIds angegeben werden.

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.

string

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

int32

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

int64

Optional. Die Anzahl der Datensätze mit selbst erhobenen Daten des Werbetreibenden, die in einen Data-Clean-Room-Anbieter hochgeladen wurden. Das gibt nicht die Größe einer PAIR-Nutzerliste an.

string

Erforderlich. Nicht veränderbar. Kennzeichnet eine eindeutige Beziehung zwischen Werbetreibendem und Publisher mit einem oder mehreren Clean-Room-Anbietern.

PartnerAudienceSource

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

string

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

string

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

string

Optional. Der Name des Kontos.

string

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

string

ID. Der Name des Partnerlinks. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

string

Nur Ausgabe. Die ID der Partnerverknüpfung.

ProductAccount

Erforderlich. Das Konto, das Zugriff auf das Partnerkonto gewährt.

ProductAccount

Erforderlich. Das Partnerkonto, dem vom Inhaberkonto Zugriff gewährt wurde.

FeatureSet

Optional. Nicht veränderbar. Die für den Partnerlink unterstützten Funktionen. Wenn nichts angegeben ist, wird standardmäßig FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT verwendet.

PartnerCustomerAccount

Optional. Das Kundenkonto im Partnersystem. Dies ist für Partnerlinks mit dem Feature-Set FEATURE_SET_AD_EVENT_MANAGEMENT erforderlich.

PartnerLinkMetadata

Optional. Metadaten, die mit dem Partnerlink verknüpft sind. Dies ist optional und wird nur für Partnerlinks mit dem FEATURE_SET_AD_EVENT_MANAGEMENT akzeptiert.

PartnerCustomerAccount

Optional. Die Liste der impliziten Konten.

string

Erforderlich. Die Liste der vom Publisher bereitgestellten IDs für einen Nutzer.

Product

Verworfen. Verwenden Sie stattdessen account_type.

string

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

AccountType

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

SyncStatus

Nur Ausgabe. Synchronisierungsstatus der Nutzerliste.

int64

Optional. Nicht veränderbar. Die Anzahl der abrechenbaren Datensätze (z.B. hochgeladen oder abgeglichen).

Destination

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

AudienceMember

Erforderlich. Die Liste der zu entfernenden Nutzer.

bool

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

Encoding

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

EncryptionInfo

Optional. Informationen zur Verschlüsselung 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.

string

Die automatisch generierte ID der Anfrage.

Destination

Ein Ziel in einer DM API-Anfrage.

RequestStatus

Der Anfragestatus des Ziels.

ErrorInfo

Ein Fehlerinfo-Fehler mit dem Fehlergrund und den Fehleranzahlen 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.

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.

IngestAudienceMembersStatus

Der Status der Anfrage zum Erfassen von Zielgruppenmitgliedern.

IngestEventsStatus

Der Status der Anfrage zum Erfassen von Ereignissen.

RemoveAudienceMembersStatus

Der Status des Antrags zum Entfernen von Zielgruppenmitgliedern.

DataType

Der Datentyp.

int64

Die Anzahl für diesen Datentyp.

IngestUserDataStatus

Status der Datenaufnahme der Nutzerdaten in das Ziel.

IngestMobileDataStatus

Der Status der Datenaufnahme mobiler Daten am Zielort.

IngestPairDataStatus

Der Status der Datenaufnahme von Paardaten am Ziel.

IngestUserIdDataStatus

Der Status der Datenaufnahme der Nutzer-ID in das Ziel.

IngestPpidDataStatus

Der Status der PPID-Datenaufnahme am Ziel.

IngestCompositeDataStatus

Der Status der Datenaufnahme zusammengesetzter Daten in das Ziel.

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.

DataTypeCount

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

MatchRateRange

Der Bereich der Abgleichsrate des Uploads.

int64

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

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.

int64

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

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.

int64

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

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.

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.

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.

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.

MatchRateRange

Der Bereich der Abgleichsrate des Uploads.

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.

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.

RemoveUserDataStatus

Der Status des Entfernens der Nutzerdaten aus dem Ziel.

RemoveMobileDataStatus

Der Status des Entfernens der mobilen Daten vom Ziel.

RemovePairDataStatus

Der Status des Entfernens der Paardaten aus dem Ziel.

RemoveUserIdDataStatus

Der Status der Entfernung der Nutzer-ID-Daten aus dem Ziel.

RemovePpidDataStatus

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

RemoveCompositeDataStatus

Der Status des Entfernens der zusammengesetzten Daten aus dem Ziel.

int64

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

DataTypeCount

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

int64

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

int64

Die Gesamtzahl der in der Anfrage zum Entfernen gesendeten Mobilgeräte-IDs. Enthält alle Mobilgeräte-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

int64

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

int64

Die Gesamtzahl der in der Anfrage zum Entfernen gesendeten Paar-IDs. Enthält alle Geräte-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

int64

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

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.

int64

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

int64

Die Gesamtzahl der Nutzerkennungen, die im Entfernungsersuchen gesendet wurden. Enthält alle Nutzerkennungen in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

int64

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

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.

string

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

Baseline

Erforderlich. Baseline für die angeforderten Statistiken.

string

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

MarketingDataInsight

Enthält die Statistiken für die Marketingdaten.

AudienceInsightsDimension

Die Dimension, zu der die Statistik gehört.

MarketingDataInsightsAttribute

Statistiken für Werte einer bestimmten Dimension.

int64

Die ID des Nutzerinteresses.

float

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

AgeRange

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

Gender

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

string

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

RequestStatusPerDestination

Eine Liste der Anfragestatus pro Ziel. Die Reihenfolge der Status entspricht der Reihenfolge der Ziele in der ursprünglichen Anfrage.

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 der partner_account ist.

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

int32

Die maximale Anzahl der zurückzugebenden Partnerlinks. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 10 Partnerlinks zurückgegeben. Der Höchstwert beträgt 100. Werte über 100 werden implizit auf 100 umgewandelt.

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.

string

Optional. Ein Filterstring. Alle Felder müssen sich auf der linken Seite der jeweiligen 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

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

PartnerLink

Die Partnerlinks für das angegebene Konto.

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.

int64

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

int64

Nur Ausgabe. Geschätzte Anzahl der Mitglieder in dieser Nutzerliste in der Domain „google.com“. Diese Mitglieder sind für das Targeting in Suchkampagnen verfügbar.

int64

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

int64

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

bool

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

bool

Optional. Gibt an, ob diese Nutzerliste für das Google Suchnetzwerk infrage kommt.

TermsOfServiceStatus

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

UserListDirectLicense

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

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.

UserListGlobalLicense

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

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.

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}

FieldMask

Optional. Die Liste der zu aktualisierenden Felder.

bool

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

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.

string

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

DataSourceType

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

string

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

string

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

AddressInfo

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

string

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

int64

Nur Ausgabe. Die eindeutige ID der Nutzerliste.

bool

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

Duration

Optional. Die Dauer, die ein Nutzer in der Nutzerliste verbleibt. Gültige Zeiträume sind genaue Vielfache von 24 Stunden (86.400 Sekunden). Wenn Sie einen Wert angeben, der kein genaues Vielfaches von 24 Stunden ist, wird der Fehler INVALID_ARGUMENT zurückgegeben.

AccessReason

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

SizeInfo

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

TargetNetworkInfo

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

string

Erforderlich. Der Anzeigename der Nutzerliste.

string

Optional. Eine Beschreibung der Nutzerliste.

MembershipStatus

Optional. Mitgliedschaftsstatus dieser Nutzerliste.

string

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

ClosingReason

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

AccessStatus

Optional. Gibt an, ob diese Freigabe noch aktiviert ist. Wenn eine Nutzerliste für das Konto freigegeben wird, für das dieses Feld festgelegt ist, wird ENABLED verwendet. Später kann der Inhaber der Nutzerliste die Freigabe widerrufen und die Liste auf DISABLED setzen.

IngestedUserListInfo

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

string

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

string

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

Dieses Feld ist schreibgeschützt.

string

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

Dieses Feld ist schreibgeschützt.

UserListLicensePricing

Optional. Preise für UserListDirectLicense.

UserListLicensePricing

Nur Ausgabe. Preisverlauf dieser Nutzerlistenlizenz.

Dieses Feld ist schreibgeschützt.

UserListLicenseMetrics

Nur Ausgabe. Messwerte zu dieser Lizenz

Dieses Feld ist schreibgeschützt und wird nur ausgefüllt, wenn das Start- und Enddatum im Aufruf „ListUserListDirectLicenses“ festgelegt sind.

int64

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

UserListLicenseClientAccountType

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

int64

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

UserListLicenseStatus

Optional. Status von UserListDirectLicense: ENABLED oder DISABLED.