Package google.ads.datamanager.v1

Index

IngestionService

Dienst zum Senden von Zielgruppendaten an unterstützte Ziele.

IngestAudienceMembers

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

AdIdentifiers

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

Felder
session_attributes

string

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

gclid

string

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

gbraid

string

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

wbraid

string

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

landing_page_device_info

DeviceInfo

Optional. Informationen zum verwendeten Gerät (falls vorhanden), die zum Zeitpunkt des Aufrufs der Website des Werbetreibenden nach der Interaktion mit der Anzeige erhoben werden.

AddressInfo

Adressinformationen für den Nutzer.

Felder
given_name

string

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

family_name

string

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

region_code

string

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

postal_code

string

Erforderlich. Die Postleitzahl der Adresse des Nutzers.

AudienceMember

Die Person, die operiert werden soll.

Felder
destination_references[]

string

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

consent

Consent

Optional. Die Einwilligungseinstellung für den Nutzer.

Union-Feld data. Der Typ der zu verarbeitenden identifizierenden Daten. Für data ist nur einer der folgenden Werte zulässig:
user_data

UserData

Von Nutzern bereitgestellte Daten, die den Nutzer identifizieren.

pair_data

PairData

PAIR-IDs (Publisher Advertiser Identity Reconciliation).

mobile_data

MobileData

Daten zur Identifizierung der Mobilgeräte des Nutzers.

AwsWrappedKeyInfo

Ein Datenverschlüsselungsschlüssel, der mit einem AWS KMS-Schlüssel verschlüsselt wurde.

Felder
key_type

KeyType

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

role_arn

string

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

kek_uri

string

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

encrypted_dek

string

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

KeyType

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

Enums
KEY_TYPE_UNSPECIFIED Nicht angegebener Schlüsseltyp. Sollte nicht verwendet werden.
XCHACHA20_POLY1305 Algorithmus XChaCha20-Poly1305

CartData

Die mit dem Ereignis verknüpften Warenkorbdaten.

Felder
merchant_id

string

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

merchant_feed_label

string

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

merchant_feed_language_code

string

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

transaction_discount

double

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

items[]

Item

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

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.

CustomVariable

Benutzerdefinierte Variable für Anzeigen-Conversions.

Felder
variable

string

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

value

string

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

destination_references[]

string

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

CustomerType

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

Enums
CUSTOMER_TYPE_UNSPECIFIED Nicht angegebener CustomerType. Sollte nicht verwendet werden.
NEW Der Kunde ist neu für den Werbetreibenden.
RETURNING Der Kunde kehrt zum Werbetreibenden zurück.
REENGAGED Der Kunde hat sich wieder mit dem Werbetreibenden in Verbindung gesetzt.

CustomerValueBucket

Der vom Werbetreibenden geschätzte Wert des Kunden.

Enums
CUSTOMER_VALUE_BUCKET_UNSPECIFIED Nicht angegebener CustomerValueBucket. Sollte nicht verwendet werden.
LOW Der Kunde hat ein niedriges Umsatzpotenzial.
MEDIUM Der Kunde hat ein mittleres Umsatzpotenzial.
HIGH Der Kunde hat ein hohes Umsatzpotenzial.

Ziel

Das Google-Produkt, an das Sie Daten senden. Zum Beispiel ein Google Ads-Konto.

Felder
reference

string

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

login_account

ProductAccount

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

linked_account

ProductAccount

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

operating_account

ProductAccount

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

product_destination_id

string

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

DeviceInfo

Informationen zum Gerät, das 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.

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

Codierung

Der Codierungstyp der gehashten identifizierenden Informationen.

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

EncryptionInfo

Informationen zur Verschlüsselung der aufgenommenen Daten.

Felder
Union-Feld wrapped_key. Der verpackte Schlüssel, der zum Verschlüsseln der Daten verwendet wird. Für wrapped_key ist nur einer der folgenden Werte zulässig:
gcp_wrapped_key_info

GcpWrappedKeyInfo

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

aws_wrapped_key_info

AwsWrappedKeyInfo

Informationen zum verpackten Schlüssel von Amazon Web Services.

ErrorCount

Die Anzahl der Fehler für einen bestimmten Fehlergrund.

Felder
record_count

int64

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

reason

ProcessingErrorReason

Der Fehlergrund für die fehlgeschlagenen Datensätze.

Fehlerinformation

Anzahl der Fehler für jeden Fehlertyp.

Felder
error_counts[]

ErrorCount

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

ErrorReason

Fehlerursachen für die Data Manager API.

Enums
ERROR_REASON_UNSPECIFIED Diesen Standardwert nicht verwenden
INTERNAL_ERROR Ein interner Fehler ist aufgetreten.
DEADLINE_EXCEEDED Die Antwort auf die Anfrage hat zu lange gedauert.
RESOURCE_EXHAUSTED Zu viele Anfragen.
NOT_FOUND Ressource nicht gefunden.
PERMISSION_DENIED Der Nutzer hat keine Berechtigung oder die Ressource wurde nicht gefunden.
INVALID_ARGUMENT Bei der Anfrage ist ein Fehler aufgetreten.
REQUIRED_FIELD_MISSING Pflichtfeld fehlt
INVALID_FORMAT Das Format ist ungültig.
INVALID_HEX_ENCODING Der HEX-codierte Wert ist fehlerhaft.
INVALID_BASE64_ENCODING Der base64-codierte Wert ist fehlerhaft.
INVALID_SHA256_FORMAT Mit SHA-256 codierter Wert ist fehlerhaft.
INVALID_POSTAL_CODE Postleitzahl ist ungültig.
INVALID_COUNTRY_CODE Der Ländercode ist ungültig.
INVALID_ENUM_VALUE Der Enum-Wert kann nicht verwendet werden.
INVALID_USER_LIST_TYPE Der Typ der Nutzerliste ist für diese Anfrage nicht anwendbar.
INVALID_AUDIENCE_MEMBER Dieses Zielgruppenmitglied ist ungültig.
TOO_MANY_AUDIENCE_MEMBERS Pro Anfrage sind maximal 10.000 Zielgruppenmitglieder zulässig.
TOO_MANY_USER_IDENTIFIERS Pro Zielgruppenmitglied sind maximal 10 Nutzerkennungen zulässig.
TOO_MANY_DESTINATIONS Pro Anfrage sind maximal 10 Ziele zulässig.
INVALID_DESTINATION Dieses Ziel ist ungültig.
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED Der Datenpartner hat keinen Zugriff auf die Nutzerliste des Betriebskontos.
INVALID_MOBILE_ID_FORMAT Das Format der Mobilgeräte-ID ist ungültig.
INVALID_USER_LIST_ID Die Nutzerliste ist ungültig.
MULTIPLE_DATA_TYPES_NOT_ALLOWED Mehrere Datentypen dürfen nicht in einer einzelnen Anfrage aufgenommen werden.
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER Zielkonfigurationen mit einem DataPartner-Anmeldekonto müssen für alle Zielkonfigurationen dasselbe Anmeldekonto haben.
TERMS_AND_CONDITIONS_NOT_SIGNED Die erforderlichen Nutzungsbedingungen wurden nicht akzeptiert.
INVALID_NUMBER_FORMAT Ungültiges Zahlenformat.
INVALID_CONVERSION_ACTION_ID Die Conversion-Aktions-ID ist ungültig.
INVALID_CONVERSION_ACTION_TYPE Der Conversion-Aktionstyp ist ungültig.
INVALID_CURRENCY_CODE Der Währungscode wird nicht unterstützt.
INVALID_EVENT Diese Veranstaltung ist ungültig.
TOO_MANY_EVENTS Die maximale Anzahl von Ereignissen pro Anfrage beträgt 10.000.
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Das Zielkonto ist nicht für erweiterte Conversions für Leads aktiviert.
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Erweiterte Conversions können für das Zielkonto aufgrund der Richtlinien für Kundendaten von Google nicht verwendet werden. Wenden Sie sich an Ihren Google-Ansprechpartner.
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Im Zielkonto wurde den Nutzungsbedingungen für erweiterte Conversions nicht zugestimmt.
DUPLICATE_DESTINATION_REFERENCE Zwei oder mehr Ziele in der Anfrage haben denselben Verweis.
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER Nicht unterstütztes Betriebskonto für die Autorisierung von Datenpartnern.
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER Das verknüpfte Konto wird für die Autorisierung des Datenpartners nicht unterstützt.
NO_IDENTIFIERS_PROVIDED Ereignisdaten enthalten keine Nutzer- oder Werbe-IDs.
INVALID_PROPERTY_TYPE Der Property-Typ wird nicht unterstützt.
INVALID_STREAM_TYPE Der Stream-Typ wird nicht unterstützt.
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT Verknüpfte Konten werden nur unterstützt, wenn das Anmeldekonto ein DATA_PARTNER-Konto ist.
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH Das Anmeldekonto muss mit dem Betriebskonto für den jeweiligen Anwendungsfall übereinstimmen.
EVENT_TIME_INVALID Das Ereignis ist nicht innerhalb des zulässigen Zeitfensters eingetreten.
RESERVED_NAME_USED Der Parameter verwendet einen reservierten Namen.
INVALID_EVENT_NAME Der Ereignisname wird nicht unterstützt.
NOT_ALLOWLISTED Das Konto ist nicht auf der Zulassungsliste für die angegebene Funktion.
INVALID_REQUEST_ID Die Anfrage-ID, die zum Abrufen des Status einer Anfrage verwendet wird, ist ungültig. Der Status kann nur für 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.
TOO_MANY_ELEMENTS Zu viele Elemente in einer Liste in der Anfrage.

Ereignis

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

Felder
destination_references[]

string

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

transaction_id

string

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

event_timestamp

Timestamp

Erforderlich. Zeit, zu der das Ereignis aufgetreten ist.

last_updated_timestamp

Timestamp

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

user_data

UserData

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

consent

Consent

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

ad_identifiers

AdIdentifiers

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

currency

string

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

conversion_value

double

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

event_source

EventSource

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

event_device_info

DeviceInfo

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

cart_data

CartData

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

custom_variables[]

CustomVariable

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

experimental_fields[]

ExperimentalField

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

user_properties

UserProperties

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

event_name

string

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

client_id

string

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

user_id

string

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

additional_event_parameters[]

EventParameter

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

EventParameter

Ereignisparameter für GA4-Ereignisse.

Felder
parameter_name

string

Erforderlich. Der Name des zu verwendenden Parameters.

value

string

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

EventSource

Die Quelle des Ereignisses.

Enums
EVENT_SOURCE_UNSPECIFIED Nicht angegebene EventSource. Sollte nicht verwendet werden.
WEB Das Ereignis wurde über einen Webbrowser generiert.
APP Der Termin wurde aus einer App generiert.
IN_STORE Der Termin wurde aus einer Transaktion im Geschäft generiert.
PHONE Der Termin wurde aus einem Telefonanruf generiert.
OTHER Das Ereignis wurde aus anderen Quellen generiert.

ExperimentalField

Experimentelles Feld, das inoffizielle Felder darstellt.

Felder
field

string

Optional. Der Name des zu verwendenden Felds.

value

string

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

GcpWrappedKeyInfo

Informationen zum umschlossenen Schlüssel der Google Cloud Platform.

Felder
key_type

KeyType

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

wip_provider

string

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

kek_uri

string

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

encrypted_dek

string

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

KeyType

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

Enums
KEY_TYPE_UNSPECIFIED Nicht angegebener Schlüsseltyp. Sollte nicht verwendet werden.
XCHACHA20_POLY1305 Algorithmus XChaCha20-Poly1305

IngestAudienceMembersRequest

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

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

Destination

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

audience_members[]

AudienceMember

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

consent

Consent

Optional. Einwilligung auf Anfrageebene, die für alle Nutzer in der Anfrage gilt. Die Einwilligung auf Nutzerebene überschreibt die Einwilligung auf Anfrageebene und kann in jedem AudienceMember angegeben werden.

validate_only

bool

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

encoding

Encoding

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

encryption_info

EncryptionInfo

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

terms_of_service

TermsOfService

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

IngestAudienceMembersResponse

Antwort von IngestAudienceMembersRequest.

Felder
request_id

string

Die automatisch generierte ID der Anfrage.

IngestEventsRequest

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

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

Destination

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

events[]

Event

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

consent

Consent

Optional. Einwilligung auf Anfrageebene, die für alle Nutzer in der Anfrage gilt. Die Einwilligung auf Nutzerebene überschreibt die Einwilligung auf Anfrageebene und kann in jedem Event angegeben werden.

validate_only

bool

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

encoding

Encoding

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

encryption_info

EncryptionInfo

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

IngestEventsResponse

Antwort von IngestEventsRequest.

Felder
request_id

string

Die automatisch generierte ID der Anfrage.

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 Ereignisparametern, die sich auf ein Element beziehen und in das Ereignis aufgenommen werden sollen, die nicht bereits über andere strukturierte Felder angegeben wurden.

ItemParameter

Ein Bucket mit Ereignisparametern, die sich auf ein Element beziehen und in das Ereignis aufgenommen werden 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 String-Darstellung des Werts des festzulegenden Parameters.

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

MobileData

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

Felder
mobile_ids[]

string

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

PairData

PAIR-IDs für die Zielgruppe. Mindestens eine PAIR-ID ist erforderlich.

Felder
pair_ids[]

string

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

ProcessingErrorReason

Der Grund für den Verarbeitungsfehler.

Enums
PROCESSING_ERROR_REASON_UNSPECIFIED Der Grund für den Verarbeitungsfehler ist unbekannt.
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE Die benutzerdefinierte Variable ist ungültig.
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED Der Status der benutzerdefinierten Variable ist nicht „Aktiviert“.
PROCESSING_ERROR_REASON_EVENT_TOO_OLD Die Conversion ist älter als das erlaubte Höchstalter.
PROCESSING_ERROR_REASON_DUPLICATE_GCLID Es ist bereits eine Conversion mit derselben Kombination aus GCLID sowie Datum und Uhrzeit der Conversion im System vorhanden.
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID Eine Conversion mit derselben Kombination aus Bestell-ID und Conversion-Aktion wurde bereits hochgeladen.
PROCESSING_ERROR_REASON_INVALID_GBRAID Die GBRAID konnte nicht decodiert werden.
PROCESSING_ERROR_REASON_INVALID_GCLID Die Google Click ID konnte nicht decodiert werden.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID Die Händler-ID enthält Zeichen, die keine Ziffern sind.
PROCESSING_ERROR_REASON_INVALID_WBRAID Die WBRAID konnte nicht decodiert werden.
PROCESSING_ERROR_REASON_INTERNAL_ERROR Interner Fehler.
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Die Nutzungsbedingungen für erweiterte Conversions wurden im Zielkonto nicht unterzeichnet.
PROCESSING_ERROR_REASON_INVALID_EVENT Das Ereignis ist ungültig.
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS Die Anzahl der abgeglichenen Transaktionen liegt unter dem Mindestschwellenwert.
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS Die Transaktionen liegen unter dem Mindestbetrag.
PROCESSING_ERROR_REASON_INVALID_FORMAT Das Ereignis weist einen Formatierungsfehler auf.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR Beim Entschlüsseln des Ereignisses ist ein Fehler aufgetreten.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR Das DEK konnte nicht entschlüsselt werden.
PROCESSING_ERROR_REASON_INVALID_WIP Die WIP ist falsch formatiert oder nicht vorhanden.
PROCESSING_ERROR_REASON_INVALID_KEK Mit dem KEK können keine Daten entschlüsselt werden, weil es sich um den falschen KEK handelt oder er nicht vorhanden ist.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED Das WIP konnte nicht verwendet werden, da es aufgrund der Attestierungsbedingung abgelehnt wurde.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED Das System hatte nicht die erforderlichen Berechtigungen, um auf den KEK zuzugreifen.
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED Das System konnte sich nicht bei AWS authentifizieren.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Die UserIdentifier-Daten konnten mit dem DEK nicht entschlüsselt werden.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER Der Nutzer hat versucht, Ereignisse mit einer Werbe-ID zu erfassen, die nicht zu den Anzeigen des Betriebskontos gehört.

ProcessingWarningReason

Der Grund für die Verarbeitungswarnung.

Enums
PROCESSING_WARNING_REASON_UNSPECIFIED Der Grund für die Verarbeitungswarnung ist unbekannt.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED Das System hatte nicht die erforderlichen Berechtigungen, um auf den KEK zuzugreifen.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR Das DEK konnte nicht entschlüsselt werden.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR Beim Entschlüsseln des Ereignisses ist ein Fehler aufgetreten.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED Das WIP konnte nicht verwendet werden, da es aufgrund der Attestierungsbedingung abgelehnt wurde.
PROCESSING_WARNING_REASON_INVALID_WIP Die WIP ist falsch formatiert oder nicht vorhanden.
PROCESSING_WARNING_REASON_INVALID_KEK Mit dem KEK können keine Daten entschlüsselt werden, weil es sich um den falschen KEK handelt oder er nicht vorhanden ist.
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Die UserIdentifier-Daten konnten mit dem DEK nicht entschlüsselt werden.
PROCESSING_WARNING_REASON_INTERNAL_ERROR Interner Fehler.
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED Das System konnte sich nicht bei AWS authentifizieren.

Produkt

Verworfen. Verwenden Sie stattdessen AccountType. Stellt ein bestimmtes Google-Produkt dar.

Enums
PRODUCT_UNSPECIFIED Nicht angegebenes Produkt. Sollte nicht verwendet werden.
GOOGLE_ADS Google Ads
DISPLAY_VIDEO_PARTNER Display & Video 360-Partner.
DISPLAY_VIDEO_ADVERTISER Display & Video 360-Werbetreibender
DATA_PARTNER Datenpartner

ProductAccount

Stellt ein bestimmtes Konto dar.

Felder
product
(deprecated)

Product

Verworfen. Verwenden Sie stattdessen account_type.

account_id

string

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

account_type

AccountType

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

AccountType

Stellt Google-Kontotypen dar. Wird verwendet, um Konten und Ziele zu finden.

Enums
ACCOUNT_TYPE_UNSPECIFIED Nicht angegebenes Produkt. Sollte nicht verwendet werden.
GOOGLE_ADS Google Ads
DISPLAY_VIDEO_PARTNER Display & Video 360-Partner.
DISPLAY_VIDEO_ADVERTISER Display & Video 360-Werbetreibender
DATA_PARTNER Datenpartner
GOOGLE_ANALYTICS_PROPERTY Google Analytics.

RemoveAudienceMembersRequest

Anfrage zum Entfernen von Nutzern aus einer Zielgruppe in den angegebenen Zielen. Gibt RemoveAudienceMembersResponse zurück.

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

Destination

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

audience_members[]

AudienceMember

Erforderlich. Die Liste der zu entfernenden Nutzer.

validate_only

bool

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

encoding

Encoding

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

encryption_info

EncryptionInfo

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

RemoveAudienceMembersResponse

Antwort von RemoveAudienceMembersRequest.

Felder
request_id

string

Die automatisch generierte ID der Anfrage.

RequestStatusPerDestination

Ein Anfragestatus pro Ziel.

Felder
destination

Destination

Ein Ziel in einer DM API-Anfrage.

request_status

RequestStatus

Der Anfragestatus des Ziels.

error_info

ErrorInfo

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

warning_info

WarningInfo

Eine Warnung mit dem Grund für die Warnung und der Anzahl der Warnungen im Zusammenhang mit dem Upload.

Union-Feld status. Der Status des Ziels. Für status ist nur einer der folgenden Werte zulässig:
audience_members_ingestion_status

IngestAudienceMembersStatus

Der Status der Anfrage zum Erfassen von Zielgruppenmitgliedern.

events_ingestion_status

IngestEventsStatus

Der Status der Anfrage zum Erfassen von Ereignissen.

audience_members_removal_status

RemoveAudienceMembersStatus

Der Status des Antrags zum Entfernen von Zielgruppenmitgliedern.

IngestAudienceMembersStatus

Der Status der Anfrage zum Erfassen von Zielgruppenmitgliedern.

Felder
Union-Feld status. Der Status der Aufnahme der Zielgruppenmitglieder in das Ziel. Für status ist nur einer der folgenden Werte zulässig:
user_data_ingestion_status

IngestUserDataStatus

Der Status der Aufnahme von Nutzerdaten in das Ziel.

mobile_data_ingestion_status

IngestMobileDataStatus

Der Status der Aufnahme mobiler Daten am Zielort.

pair_data_ingestion_status

IngestPairDataStatus

Der Status der Aufnahme von Paardaten in das Ziel.

IngestEventsStatus

Der Status der Ereignisaufnahme am Zielort.

Felder
record_count

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.

IngestMobileDataStatus

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

Felder
record_count

int64

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

mobile_id_count

int64

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

IngestPairDataStatus

Der Status der Aufnahme von Paardaten in das Ziel, das Statistiken zur Aufnahme enthält.

Felder
record_count

int64

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

pair_id_count

int64

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

IngestUserDataStatus

Der Status der Aufnahme von Nutzerdaten in das Ziel mit Statistiken zur Aufnahme.

Felder
record_count

int64

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

user_identifier_count

int64

Die Gesamtzahl der Nutzer-IDs, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle 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.

RemoveAudienceMembersStatus

Der Status des Antrags zum Entfernen von Zielgruppenmitgliedern.

Felder
Union-Feld status. Der Status des Entfernens der Zielgruppenmitglieder aus dem Ziel. Für status ist nur einer der folgenden Werte zulässig:
user_data_removal_status

RemoveUserDataStatus

Der Status des Entfernens der Nutzerdaten aus dem Ziel.

mobile_data_removal_status

RemoveMobileDataStatus

Der Status des Entfernens der Mobilfunkdaten vom Ziel.

pair_data_removal_status

RemovePairDataStatus

Der Status des Entfernens der Paardaten aus dem Ziel.

RemoveMobileDataStatus

Der Status des Entfernens der Mobilfunkdaten vom Ziel.

Felder
record_count

int64

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

mobile_id_count

int64

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

RemovePairDataStatus

Der Status des Entfernens der Paardaten aus dem Ziel.

Felder
record_count

int64

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

pair_id_count

int64

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

RemoveUserDataStatus

Der Status des Entfernens der Nutzerdaten aus dem Ziel.

Felder
record_count

int64

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

user_identifier_count

int64

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

RequestStatus

Der Status der Anfrage.

Enums
REQUEST_STATUS_UNKNOWN Der Anfragestatus ist unbekannt.
SUCCESS Die Anfrage war erfolgreich.
PROCESSING Die Anfrage wird bearbeitet.
FAILED Die Anfrage ist fehlgeschlagen.
PARTIAL_SUCCESS Die Anfrage war teilweise erfolgreich.

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.

TermsOfService

Die Nutzungsbedingungen, die der Nutzer akzeptiert oder abgelehnt hat.

Felder
customer_match_terms_of_service_status

TermsOfServiceStatus

Optional. Die Nutzungsbedingungen für den Kundenabgleich: https://support.google.com/adspolicy/answer/6299717. Diese muss beim Erfassen von UserData oder MobileData akzeptiert werden. Dieses Feld ist für Partner Match-Nutzerlisten 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.

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.

UserIdentifier

Eine einzelne Kennung für den Nutzer.

Felder
Union-Feld identifier. Es muss genau einer angegeben werden. Für identifier ist nur einer der folgenden Werte zulässig:
email_address

string

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

phone_number

string

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

address

AddressInfo

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

UserProperties

Vom Werbetreibenden erhobene Informationen zum Nutzer zum Zeitpunkt des Ereignisses. Weitere Informationen finden Sie unter https://support.google.com/google-ads/answer/14007601.

Felder
customer_type

CustomerType

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

customer_value_bucket

CustomerValueBucket

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

additional_user_properties[]

UserProperty

Optional. Ein Bucket mit allen zusätzlichen Nutzereigenschaften für den Nutzer, der mit diesem Ereignis verknüpft ist.

UserProperty

Ein Bucket mit allen zusätzlichen Nutzereigenschaften für den Nutzer, der mit diesem Ereignis verknüpft ist.

Felder
property_name

string

Erforderlich. Der Name der zu verwendenden Nutzereigenschaft.

value

string

Erforderlich. Die Stringdarstellung des zu verwendenden Werts der Nutzereigenschaft.

WarningCount

Die Anzahl der Warnungen für einen bestimmten Warnungsgrund.

Felder
record_count

int64

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

reason

ProcessingWarningReason

Der Grund für die Warnung.

WarningInfo

Anzahl der Warnungen für jeden Warnungstyp.

Felder
warning_counts[]

WarningCount

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