REST Resource: firstPartyAndPartnerAudiences

Ressource: FirstPartyAndPartnerAudience

Beschreibt eine eigene oder Partner-Zielgruppenliste, die für das Targeting verwendet wird. Zielgruppen mit selbst erhobenen Daten werden mithilfe von Kundendaten erstellt. Partnerzielgruppen werden von Drittanbietern bereitgestellt und können nur an Kunden lizenziert werden.

JSON-Darstellung 
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname der Zielgruppe mit selbst erhobenen Daten und der Partner-Zielgruppe.
firstPartyAndPartnerAudienceId

string (int64 format)

ID. Die eindeutige ID der Zielgruppe mit selbst erhobenen Daten und der Partner-Zielgruppe. Wird vom System zugewiesen.
displayName

string

Optional. Der Anzeigename der Zielgruppe mit selbst erhobenen Daten und der Partner-Zielgruppe.
description

string

Optional. Die vom Nutzer angegebene Beschreibung der Zielgruppe.

Gilt nur für Zielgruppen mit selbst erhobenen Daten.
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

Nur Ausgabe. Ob es sich um eine Zielgruppe mit selbst erhobenen Daten oder eine Partner-Zielgruppe handelt.
audienceType

enum (AudienceType)

Nicht veränderbar. Der Typ der Zielgruppe.
audienceSource

enum (AudienceSource)

Nur Ausgabe. Die Quelle der Zielgruppe.
membershipDurationDays

string (int64 format)

Optional. Die Dauer in Tagen, die ein Eintrag nach dem qualifizierenden Ereignis in der Zielgruppe verbleibt. Der festgelegte Wert muss größer als 0 und kleiner oder gleich 540 sein.

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

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

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

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

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

Wird nur in GET-Anfragen zurückgegeben.
activeDisplayAudienceSize

string (int64 format)

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

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

Wird nur in GET-Anfragen zurückgegeben.
youtubeAudienceSize

string (int64 format)

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

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

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

Wird nur in GET-Anfragen zurückgegeben.
gmailAudienceSize

string (int64 format)

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

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

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

Wird nur in GET-Anfragen zurückgegeben.
displayMobileAppAudienceSize

string (int64 format)

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

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

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

Wird nur in GET-Anfragen zurückgegeben.
displayMobileWebAudienceSize

string (int64 format)

Nur Ausgabe. Die geschätzte Größe der Zielgruppe im mobilen Web im Displaynetzwerk.

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

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

Wird nur in GET-Anfragen zurückgegeben.
displayDesktopAudienceSize

string (int64 format)

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

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

Gilt nur für Zielgruppen mit selbst erhobenen Daten.

Wird nur in GET-Anfragen zurückgegeben.
appId

string

Optional. Die „appId“ stimmt mit dem Typ der hochgeladenen „mobileDeviceIds“ überein.

Gilt nur für audienceType CUSTOMER_MATCH_DEVICE_ID

FirstPartyAndPartnerAudienceType

Mögliche Typen einer Zielgruppenressource mit selbst erhobenen Daten und Partner-Zielgruppenressource.

Enums
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED Standardwert, wenn der Typ nicht angegeben oder unbekannt ist.
TYPE_FIRST_PARTY Zielgruppe, die mithilfe von Kundendaten erstellt wird.
TYPE_PARTNER Zielgruppe, die von Drittanbietern bereitgestellt wird.

AudienceType

Mögliche Zielgruppentypen.

Enums
AUDIENCE_TYPE_UNSPECIFIED Standardwert, wenn der Typ nicht angegeben oder unbekannt ist.
CUSTOMER_MATCH_CONTACT_INFO Die Zielgruppe wurde durch den Abgleich von Kunden mit bekannten Kontaktdaten generiert.
CUSTOMER_MATCH_DEVICE_ID Die Zielgruppe wurde durch den Abgleich von Kunden mit bekannten Mobilgeräte-IDs generiert.
CUSTOMER_MATCH_USER_ID Die Zielgruppe wurde durch den Abgleich von Kunden mit bekannten Nutzer-IDs generiert.
ACTIVITY_BASED

Eingestellt: Die Zielgruppe wurde basierend auf der Kampagnenaktivität erstellt.
FREQUENCY_CAP

Eingestellt: Die Zielgruppe wurde erstellt, indem die Anzahl der Impressionen, die für sie ausgeliefert wurden, ausgeschlossen wurde.
TAG_BASED Die Zielgruppe wurde anhand von benutzerdefinierten Variablen erstellt, die dem Pixel zugeordnet sind.
YOUTUBE_USERS Die Zielgruppe wurde basierend auf früheren Interaktionen mit Videos, YouTube-Anzeigen oder dem YouTube-Kanal erstellt.
THIRD_PARTY Die Zielgruppe wurde von einem Drittanbieter lizenziert.
COMMERCE Zielgruppe, die von Handelspartnern gegen eine Gebühr bereitgestellt wird.
LINEAR Zielgruppe für Inhalte im linearen Fernsehen.
AGENCY Von einer Agentur bereitgestellte Zielgruppe.

AudienceSource

Mögliche Zielgruppenquellen.

Enums
AUDIENCE_SOURCE_UNSPECIFIED Standardwert, wenn die Zielgruppenquelle nicht angegeben oder unbekannt ist.
DISPLAY_VIDEO_360 Stammt aus Display & Video 360.
CAMPAIGN_MANAGER Stammt aus Campaign Manager 360.
AD_MANAGER Stammt aus Google Ad Manager.
SEARCH_ADS_360 Aus Search Ads 360
YOUTUBE Stammt von YouTube.
ADS_DATA_HUB Aus Ads Data Hub

Methoden

get

 Ruft eine Zielgruppe mit selbst erhobenen Daten oder eine Partner-Zielgruppe ab.

list

 Hier werden Zielgruppen mit selbst erhobenen Daten und Partner-Zielgruppen aufgeführt.