AudienceMember

Die Person im Publikum, die operiert werden soll.

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

  // Union field data can be only one of the following:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  }
  // End of list of possible types for union field data.
}
Felder
destinationReferences[]

string

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

consent

object (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:
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, wie vom Werbetreibenden definiert.

ppidData

object (PpidData)

Daten im Zusammenhang mit vom Publisher bereitgestellten Kennungen.

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

compositeData

object (CompositeData)

Gruppe mit mehreren Kennungstypen.

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

MobileData

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

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

string

Erforderlich. Die Liste der Mobilgeräte-IDs (Werbe-ID/IDFA). In einem einzelnen AudienceMember können maximal 10 mobileIds 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 (Publisher Provided Identifiers, 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 IDs 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-Adressendaten, 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. IP-Adresse, die zum Zeitpunkt der Kundeninteraktion erfasst wurde. Akzeptiert Standardstringformate für IPv4 und IPv6.

observeStartTime

string (Timestamp format)

Optional. Die Zeit 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. Die zuletzt aufgezeichnete Interaktionszeit 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".