- Ressource: FirstAndthirdPartyAudience
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList (Kontaktliste)
- ContactInfo
- Einwilligung
- ConsentStatus
- MobileDeviceIdList:
- Methoden
Ressource: FirstAndThirdPartyAudience
Beschreibt eine Zielgruppenliste mit selbst erhobenen Daten oder Drittanbieter-Zielgruppenlisten für das Targeting. Zielgruppen mit selbst erhobenen Daten werden anhand von Kundendaten erstellt. Drittanbieter-Zielgruppen werden von Datendrittanbietern zur Verfügung gestellt und können nur an Kunden lizenziert werden.
JSON-Darstellung |
---|
{ "name": string, "firstAndThirdPartyAudienceId": string, "displayName": string, "description": string, "firstAndThirdPartyAudienceType": enum ( |
Felder | |
---|---|
name |
Nur Ausgabe Der Ressourcenname der Erst- und Drittanbieter-Zielgruppe. |
firstAndThirdPartyAudienceId |
Nur Ausgabe Eindeutige ID der Erst- und Drittanbieter-Zielgruppe. Vom System zugewiesen. |
displayName |
Der Anzeigename der Erst- und Drittanbieter-Zielgruppe. |
description |
Die vom Nutzer angegebene Beschreibung der Zielgruppe. Gilt nur für Zielgruppen mit selbst erhobenen Daten. |
firstAndThirdPartyAudienceType |
Gibt an, ob es sich bei der Zielgruppe um eine eigene oder Drittanbieter-Zielgruppe handelt. |
audienceType |
Die Art der Zielgruppe. |
audienceSource |
Nur Ausgabe Die Quelle der Zielgruppe. |
membershipDurationDays |
Die Dauer in Tagen, über die ein Beitrag nach der entsprechenden Veranstaltung in der Zielgruppe verbleibt. Wenn die Zielgruppe kein Ablaufdatum 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 eine der folgenden
|
displayAudienceSize |
Nur Ausgabe Die geschätzte Größe der Zielgruppe für das Displaynetzwerk. Wenn die Zahl kleiner als 1.000 ist, wird die Zahl aus Datenschutzgründen ausgeblendet und 0 zurückgegeben. Andernfalls wird die Zahl auf zwei signifikante Stellen gerundet. Wird nur in einer GET-Anfrage zurückgegeben. |
activeDisplayAudienceSize |
Nur Ausgabe Die geschätzte Größe der Zielgruppe für das Displaynetzwerk im letzten Monat Wenn die Zahl kleiner als 1.000 ist, wird die Zahl aus Datenschutzgründen ausgeblendet und 0 zurückgegeben. Andernfalls wird die Zahl auf zwei signifikante Stellen gerundet. Wird nur in einer GET-Anfrage zurückgegeben. |
youtubeAudienceSize |
Nur Ausgabe Die geschätzte Größe der Zielgruppe für das YouTube-Werbenetzwerk. Wenn die Zahl kleiner als 1.000 ist, 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 einer GET-Anfrage zurückgegeben. |
gmailAudienceSize |
Nur Ausgabe Die geschätzte Größe der Zielgruppe für das Gmail-Werbenetzwerk. Wenn die Zahl kleiner als 1.000 ist, 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 einer GET-Anfrage zurückgegeben. |
displayMobileAppAudienceSize |
Nur Ausgabe Die geschätzte Größe der Zielgruppe für mobile Apps im Displaynetzwerk Wenn die Zahl kleiner als 1.000 ist, 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 einer GET-Anfrage zurückgegeben. |
displayMobileWebAudienceSize |
Nur Ausgabe Die geschätzte Größe der Zielgruppe im mobilen Web im Displaynetzwerk. Wenn die Zahl kleiner als 1.000 ist, 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 einer GET-Anfrage zurückgegeben. |
displayDesktopAudienceSize |
Nur Ausgabe Die geschätzte Größe der Zielgruppe auf Computern im Displaynetzwerk. Wenn die Zahl kleiner als 1.000 ist, 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 einer GET-Anfrage zurückgegeben. |
appId |
Die appId stimmt mit dem Typ der mobileDeviceIds überein, die hochgeladen werden. Gilt nur für |
Union-Feld members . Die ersten Mitglieder der Zielgruppe zum Kundenabgleich. Für members ist nur einer der folgenden Werte zulässig: |
|
contactInfoList |
Nur Eingabe. Eine Liste mit Kontaktdaten zur Definition der ersten Zielgruppenmitglieder. Gilt nur für |
mobileDeviceIdList |
Nur Eingabe. Eine Liste mit Mobilgeräte-IDs, mit denen die ersten Mitglieder der Zielgruppe definiert werden. Gilt nur für |
FirstAndThirdPartyAudienceType
Mögliche Typen von Erst- und Drittanbieter-Zielgruppenressourcen.
Enums | |
---|---|
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED |
Standardwert, wenn der Typ nicht angegeben oder unbekannt ist. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY |
Zielgruppe, die anhand von Kundendaten erstellt wird. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY |
Die Zielgruppe, die von Datendrittanbietern 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 generiert, indem Kunden bekannten Kontaktdaten zugeordnet wurden. |
CUSTOMER_MATCH_DEVICE_ID |
Die Zielgruppe wurde generiert, indem Kunden bekannten Mobilgeräte-IDs zugeordnet wurden. |
CUSTOMER_MATCH_USER_ID |
Die Zielgruppe wurde generiert, indem Kunden bekannten User-IDs zugeordnet wurden. |
ACTIVITY_BASED |
Die Zielgruppe wurde basierend auf den Kampagnenaktivitäten erstellt. |
FREQUENCY_CAP |
Die Zielgruppe wurde auf Basis der Anzahl der erzielten Impressionen erstellt. |
TAG_BASED |
Die Zielgruppe wurde anhand von benutzerdefinierten Variablen erstellt, die an das Pixel angehängt sind. |
YOUTUBE_USERS |
Die Zielgruppe wurde basierend auf früheren Interaktionen mit Videos, YouTube-Anzeigen oder YouTube-Kanälen erstellt. |
LICENSED |
Untertyp der Drittanbieter-Zielgruppe. |
AudienceSource
Mögliche Zielgruppenquellen.
Enums | |
---|---|
AUDIENCE_SOURCE_UNSPECIFIED |
Standardwert, wenn die Zielgruppenquelle nicht angegeben oder unbekannt ist. |
DISPLAY_VIDEO_360 |
Aus Display & Video 360. |
CAMPAIGN_MANAGER |
Sie stammt aus Campaign Manager 360. |
AD_MANAGER |
Sie stammt aus Google Ad Manager. |
SEARCH_ADS_360 |
Aus Search Ads 360. |
YOUTUBE |
Stammt von YouTube. |
ADS_DATA_HUB |
Aus Ads Data Hub. |
ContactInfoList
Wrapper-Nachricht für eine Liste von Kontaktdaten, mit denen Zielgruppenmitglieder zum Kundenabgleich definiert werden
JSON-Darstellung |
---|
{ "contactInfos": [ { object ( |
Felder | |
---|---|
contactInfos[] |
Eine Liste von ContactInfo-Objekten, die Zielgruppenmitglieder zum Kundenabgleich definieren. Die Mitgliedergröße nach der Aufteilung der Kontaktdaten darf 500.000 nicht überschreiten. |
consent |
Nur Eingabe. Die Einwilligungseinstellung für die Nutzer in Wenn dieses Feld nicht konfiguriert ist, bedeutet dies, dass keine Einwilligung angegeben ist. Wenn das Feld |
ContactInfo
Kontaktdaten, mit denen ein Zielgruppenmitglied zum Kundenabgleich definiert wird
JSON-Darstellung |
---|
{ "hashedEmails": [ string ], "hashedPhoneNumbers": [ string ], "zipCodes": [ string ], "hashedFirstName": string, "hashedLastName": string, "countryCode": string } |
Felder | |
---|---|
hashedEmails[] |
Eine Liste mit SHA256-Hash-E-Mail-Adressen des Mitglieds. Entfernen Sie vor dem Hashen alle Leerzeichen und achten Sie darauf, dass der String nur aus Kleinbuchstaben besteht. |
hashedPhoneNumbers[] |
Eine Liste mit SHA256-gehashten Telefonnummern des Mitglieds. Vor dem Hashen müssen alle Telefonnummern im E.164-Format formatiert werden und die Landesvorwahl enthalten. |
zipCodes[] |
Eine Liste mit Postleitzahlen des Mitglieds. Muss auch mit den folgenden Feldern festgelegt werden: |
hashedFirstName |
Mit SHA-256 gehashter Vorname des Mitglieds. Entfernen Sie vor dem Hashen alle Leerzeichen und achten Sie darauf, dass der String nur aus Kleinbuchstaben besteht. Muss auch mit den folgenden Feldern festgelegt werden: |
hashedLastName |
Mit SHA-256 gehashter Nachname des Mitglieds. Entfernen Sie vor dem Hashen alle Leerzeichen und achten Sie darauf, dass der String nur aus Kleinbuchstaben besteht. Muss auch mit den folgenden Feldern festgelegt werden: |
countryCode |
Ländercode des Mitglieds Muss auch mit den folgenden Feldern festgelegt werden: |
Einwilligung
Status der Nutzereinwilligung.
JSON-Darstellung |
---|
{ "adUserData": enum ( |
Felder | |
---|---|
adUserData |
Stellt die Einwilligung zur Verwendung von Daten von Anzeigennutzern dar. |
adPersonalization |
Stellt eine Einwilligung zur Personalisierung von Anzeigen dar. |
ConsentStatus
Status der Einwilligung.
Enums | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
Typwert ist nicht angegeben oder in dieser Version unbekannt. |
CONSENT_STATUS_GRANTED |
Die Einwilligung wurde erteilt. |
CONSENT_STATUS_DENIED |
Das Einverständnis wurde verweigert. |
MobileDeviceIdList
Wrapper-Nachricht für eine Liste von Mobilgeräte-IDs, mit denen Zielgruppenmitglieder zum Kundenabgleich definiert werden.
JSON-Darstellung |
---|
{
"mobileDeviceIds": [
string
],
"consent": {
object ( |
Felder | |
---|---|
mobileDeviceIds[] |
Eine Liste mit Mobilgeräte-IDs, anhand derer die Zielgruppen zum Kundenabgleich definiert werden. Die „mobileDeviceIds“ darf nicht größer als 500.000 sein. |
consent |
Nur Eingabe. Die Einwilligungseinstellung für die Nutzer in Wenn dieses Feld nicht konfiguriert ist, bedeutet dies, dass keine Einwilligung angegeben ist. Wenn das Feld |
Methoden |
|
---|---|
|
Erstellt eine FirstAndDrittanbieter-Zielgruppe. |
|
Aktualisiert die Mitgliederliste einer Zielgruppe zum Kundenabgleich |
|
Ruft eine Erst- und Drittanbieter-Zielgruppe ab. |
|
Listen Sie Zielgruppen mit selbst erhobenen Daten und Drittanbieter-Zielgruppen auf. |
|
Aktualisiert eine vorhandene FirstAndDrittanbieter-Zielgruppe. |