REST Resource: firstAndThirdPartyAudiences

{
  "name": string,
  "firstAndThirdPartyAudienceId": string,
  "displayName": string,
  "description": string,
  "firstAndThirdPartyAudienceType": enum (FirstAndThirdPartyAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string,

  // Union field members can be only one of the following:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field members.
}

string

Nur Ausgabe. Der Ressourcenname der Erstanbieter- und Drittanbieterzielgruppe.

string (int64 format)

Nur Ausgabe. Die eindeutige ID der Erstanbieter- und Drittanbieterzielgruppe. Vom System zugewiesen.

string

Der Anzeigename der eigenen und der Drittanbieter-Zielgruppe.

string

Die vom Nutzer angegebene Beschreibung der Zielgruppe.

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

enum (FirstAndThirdPartyAudienceType)

Gibt an, ob es sich bei der Zielgruppe um eine Erstanbieter- oder Drittanbieterzielgruppe handelt.

enum (AudienceType)

Die Art der Zielgruppe.

enum (AudienceSource)

Nur Ausgabe. Die Quelle der Zielgruppe.

string (int64 format)

Die Dauer in Tagen, die ein Eintrag nach dem entsprechenden Ereignis in der Zielgruppe verbleibt. Wenn die Zielgruppe keine Ablaufzeit hat, legen Sie den Wert in diesem Feld auf 10.000 fest. Andernfalls muss der festgelegte Wert größer als 0 und kleiner oder gleich 540 sein.

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

Dieses Feld ist erforderlich, wenn einer der folgenden audienceType verwendet wird:

• CUSTOMER_MATCH_CONTACT_INFO
• CUSTOMER_MATCH_DEVICE_ID

string (int64 format)

Nur Ausgabe. Die geschätzte Größe der Zielgruppe für das Displaynetzwerk.

Wenn die Größe kleiner als 1.000 ist, wird die Zahl ausgeblendet und 0 wird aus Datenschutzgründen zurückgegeben. Andernfalls wird die Zahl auf zwei signifikante Stellen gerundet.

Wird nur in einer GET-Anfrage zurückgegeben.

string (int64 format)

Nur Ausgabe. Die geschätzte Größe der Zielgruppe für das Displaynetzwerk im letzten Monat.

Wenn die Größe kleiner als 1.000 ist, wird die Zahl ausgeblendet und 0 wird aus Datenschutzgründen zurückgegeben. Andernfalls wird die Zahl auf zwei signifikante Stellen gerundet.

Wird nur in einer GET-Anfrage zurückgegeben.

string (int64 format)

Nur Ausgabe. Die geschätzte Größe der Zielgruppe für das YouTube-Werbenetzwerk.

Wenn die Größe kleiner als 1.000 ist, wird die Zahl ausgeblendet und 0 wird aus Datenschutzgründen zurückgegeben. Andernfalls wird die Zahl auf zwei signifikante Stellen gerundet.

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

Wird nur in einer GET-Anfrage zurückgegeben.

string (int64 format)

Nur Ausgabe. Die geschätzte Größe der Zielgruppe für das Gmail-Werbenetzwerk.

Wenn die Größe kleiner als 1.000 ist, wird die Zahl ausgeblendet und 0 wird aus Datenschutzgründen zurückgegeben. Andernfalls wird die Zahl auf zwei signifikante Stellen gerundet.

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

Wird nur in einer GET-Anfrage zurückgegeben.

string (int64 format)

Nur Ausgabe. Die geschätzte Größe der Zielgruppe für mobile Apps im Displaynetzwerk.

Wenn die Größe kleiner als 1.000 ist, wird die Zahl ausgeblendet und 0 wird aus Datenschutzgründen zurückgegeben. Andernfalls wird die Zahl auf zwei signifikante Stellen gerundet.

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

Wird nur in einer GET-Anfrage zurückgegeben.

string (int64 format)

Nur Ausgabe. Die geschätzte Größe der Zielgruppe für das mobile Web im Displaynetzwerk.

Wenn die Größe kleiner als 1.000 ist, wird die Zahl ausgeblendet und 0 wird aus Datenschutzgründen zurückgegeben. Andernfalls wird die Zahl auf zwei signifikante Stellen gerundet.

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

Wird nur in einer GET-Anfrage zurückgegeben.

string (int64 format)

Nur Ausgabe. Die geschätzte Größe der Zielgruppe für Computer im Displaynetzwerk.

Wenn die Größe kleiner als 1.000 ist, wird die Zahl ausgeblendet und 0 wird aus Datenschutzgründen zurückgegeben. Andernfalls wird die Zahl auf zwei signifikante Stellen gerundet.

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

Wird nur in einer GET-Anfrage zurückgegeben.

string

Die appId stimmt mit dem Typ der mobilenDeviceIds überein, die hochgeladen wird.

Gilt nur für audienceType CUSTOMER_MATCH_DEVICE_ID

object (ContactInfoList)

Nur Eingabe. Eine Liste mit Kontaktdaten zur Definition der anfänglichen Zielgruppenmitglieder.

Gilt nur für audienceType CUSTOMER_MATCH_CONTACT_INFO

object (MobileDeviceIdList)

Nur Eingabe. Eine Liste mit Mobilgeräte-IDs zur Definition der anfänglichen Zielgruppenmitglieder.

Gilt nur für audienceType CUSTOMER_MATCH_DEVICE_ID

{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ],
  "consent": {
    object (Consent)
  }
}

object (ContactInfo)

Eine Liste mit ContactInfo-Objekten, mit denen die Mitglieder der Zielgruppe zum Kundenabgleich definiert werden. Die Größe der Mitglieder nach dem Aufteilen der contactInfos darf 500.000 nicht überschreiten.

object (Consent)

Nur Eingabe. Die Einwilligungseinstellung für die Nutzer in contactInfos.

Wenn dieses Feld nicht konfiguriert ist, ist keine Einwilligung angegeben.

Wenn das Feld adUserData oder adPersonalization auf CONSENT_STATUS_DENIED gesetzt ist, gibt die Anfrage einen Fehler zurück.

{
  "hashedEmails": [
    string
  ],
  "hashedPhoneNumbers": [
    string
  ],
  "zipCodes": [
    string
  ],
  "hashedFirstName": string,
  "hashedLastName": string,
  "countryCode": string
}

string

Eine Liste der mit SHA256 gehashten E-Mail-Adressen des Mitglieds. Entfernen Sie vor dem Hashen alle Leerzeichen und stellen Sie sicher, dass der String ausschließlich aus Kleinbuchstaben besteht.

string

Eine Liste mit SHA256-Hash-Telefonnummern des Mitglieds. Vor dem Hashen müssen alle Telefonnummern im E.164-Format formatiert sein und die Landesvorwahl enthalten.

string

Eine Liste der Postleitzahlen des Mitglieds.

Muss auch mit den folgenden Feldern festgelegt werden:

• countryCode
• hashedFirstName
• hashedLastName

string

Mit SHA256 gehashter Vorname des Mitglieds. Entfernen Sie vor dem Hashen alle Leerzeichen und stellen Sie sicher, dass der String ausschließlich aus Kleinbuchstaben besteht.

Muss auch mit den folgenden Feldern festgelegt werden:

• countryCode
• hashedLastName
• zipCodes

string

SHA256-Hash-Nachname des Mitglieds. Entfernen Sie vor dem Hashen alle Leerzeichen und stellen Sie sicher, dass der String ausschließlich aus Kleinbuchstaben besteht.

Muss auch mit den folgenden Feldern festgelegt werden:

• countryCode
• hashedFirstName
• zipCodes

string

Die Landesvorwahl des Mitglieds.

Muss auch mit den folgenden Feldern festgelegt werden:

• hashedFirstName
• hashedLastName
• zipCodes

{
  "adUserData": enum (ConsentStatus),
  "adPersonalization": enum (ConsentStatus)
}

enum (ConsentStatus)

Einwilligung zur Verwendung von Nutzerdaten.

enum (ConsentStatus)

Einwilligung zur Personalisierung von Werbung.

{
  "mobileDeviceIds": [
    string
  ],
  "consent": {
    object (Consent)
  }
}

string

Eine Liste mit Mobilgeräte-IDs, mit denen die Mitglieder der Zielgruppe zum Kundenabgleich definiert werden. Die Größe von „mobileDeviceIds“ darf 500.000 nicht überschreiten.

object (Consent)

Nur Eingabe. Die Einwilligungseinstellung für die Nutzer in mobileDeviceIds.

Wenn dieses Feld nicht konfiguriert ist, ist keine Einwilligung angegeben.

Wenn das Feld adUserData oder adPersonalization auf CONSENT_STATUS_DENIED gesetzt ist, gibt die Anfrage einen Fehler zurück.