AudienceMember

Die Person in der Zielgruppe, die operiert werden soll.

JSON-Darstellung
{
  "destinationReferences": [
    string
  ],
  "consent": {
    object (Consent)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  },
  "googleUserIdData": {
    object (GoogleUserIdData)
  },
  "partnerProvidedIdData": {
    object (PartnerProvidedIdData)
  }
  // End of mutually exclusive fields.
}
Felder
destinationReferences[]

string

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

consent

object (Consent)

Optional. Die Einwilligungseinstellung für den Nutzer.

Der Typ der zu verarbeitenden identifizierenden Daten. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
userData

object (UserData)

Von Nutzern bereitgestellte Daten, die den Nutzer identifizieren.

pairData

object (PairData)

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

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

mobileData

object (MobileData)

Daten zur Identifizierung der Mobilgeräte des Nutzers.

userIdData

object (UserIdData)

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

ppidData

object (PpidData)

Daten zu vom Publisher bereitgestellten Kennungen.

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

compositeData

object (CompositeData)

Gruppe mit mehreren Kennungstypen.

googleUserIdData

object (GoogleUserIdData)

Verschlüsselte Google-Nutzer-IDs.

partnerProvidedIdData

object (PartnerProvidedIdData)

Von Partnern bereitgestellte Kennungen.

Ende der sich gegenseitig ausschließenden Felder.

PairData

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

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

JSON-Darstellung
{
  "pairIds": [
    string
  ]
}
Felder
pairIds[]

string

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

UserIdData

User-ID-Daten mit der User-ID.

JSON-Darstellung
{
  "userId": string
}
Felder
userId

string

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

PpidData

Daten zu vom Publisher bereitgestellten Kennungen (PPIDs). Mindestens eine PPID ist erforderlich.

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

JSON-Darstellung
{
  "ppids": [
    string
  ]
}
Felder
ppids[]

string

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

CompositeData

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

JSON-Darstellung
{
  "userData": {
    object (UserData)
  },
  "ipData": [
    {
      object (IpData)
    }
  ]
}
Felder
userData

object (UserData)

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

ipData[]

object (IpData)

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

IpData

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

JSON-Darstellung
{
  "ipAddress": string,
  "observeStartTime": string,
  "observeEndTime": string
}
Felder
ipAddress

string

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

observeStartTime

string (Timestamp format)

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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

observeEndTime

string (Timestamp format)

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

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

GoogleUserIdData

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

JSON-Darstellung
{
  "googleUserIds": [
    string
  ]
}
Felder
googleUserIds[]

string

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

PartnerProvidedIdData

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

JSON-Darstellung
{
  "partnerProvidedIds": [
    string
  ]
}
Felder
partnerProvidedIds[]

string

Erforderlich. Die Liste der vom Partner bereitgestellten Kennungen.