REST Resource: advertisers.lineItems.targetingTypes.assignedTargetingOptions

Ressource: AssignedTargetingOption

Eine einzelne zugewiesene Targeting-Option, die den Status einer Targeting-Option für ein Entitätsobjekt mit Targeting-Einstellungen definiert.

JSON-Darstellung 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname für diese zugewiesene Targeting-Option.
assignedTargetingOptionId

string

Nur Ausgabe. Die eindeutige ID der zugewiesenen Ausrichtungsoption. Die ID ist nur innerhalb einer bestimmten Ressource und eines bestimmten Targeting-Typs eindeutig. Es kann in anderen Kontexten wiederverwendet werden.
assignedTargetingOptionIdAlias

string

Nur Ausgabe. Ein Alias für die assignedTargetingOptionId. Dieser Wert kann anstelle von assignedTargetingOptionId verwendet werden, wenn vorhandenes Targeting abgerufen oder gelöscht wird.

Dieses Feld wird nur für alle zugewiesenen Targeting-Optionen der folgenden Targeting-Typen unterstützt:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

Dieses Feld wird auch für den folgenden Targeting-Typen unterstützt, der Werbebuchungen zugewiesen ist:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Nur Ausgabe. Gibt den Typ der zugewiesenen Ausrichtungsoption an.
inheritance

enum (Inheritance)

Nur Ausgabe. Der Übernahmestatus der zugewiesenen Targeting-Option.
Union-Feld details. Detaillierte Informationen zur zugewiesenen Targeting-Option. Es darf nur ein Feld für die Details ausgefüllt werden, das targeting_type entsprechen muss. Für details ist nur einer der folgenden Werte zulässig:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Kanaldetails. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_CHANNEL hat.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Details zur App-Kategorie Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_APP_CATEGORY hat.
appDetails

object (AppAssignedTargetingOptionDetails)

App-Details. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_APP hat.
urlDetails

object (UrlAssignedTargetingOptionDetails)

URL-Details Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_URL hat.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Tag und Uhrzeit Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_DAY_AND_TIME hat.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Details zur Altersgruppe. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_AGE_RANGE hat.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Details zur Liste der regionalen Standorte. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_REGIONAL_LOCATION_LIST hat.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Details zur Liste der Standorte in der Nähe. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_PROXIMITY_LOCATION_LIST hat.
genderDetails

object (GenderAssignedTargetingOptionDetails)

Angaben zum Geschlecht. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_GENDER hat.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Details zur Größe des Videoplayers. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_VIDEO_PLAYER_SIZE hat.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Details zu Inhalten mit Prämie. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_USER_REWARDED_CONTENT hat.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Details zum Elternstatus. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_PARENTAL_STATUS hat.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Details zur In-Stream-Position des Inhalts. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_CONTENT_INSTREAM_POSITION hat.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Details zur Position des Out-Stream-Videos. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION hat.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Details zum Gerätetyp Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_DEVICE_TYPE hat.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Details zum Targeting auf Zielgruppen Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_AUDIENCE_GROUP hat. Sie können jeweils nur eine Zielgruppenoption pro Ressource auswählen.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

Browser details. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_BROWSER hat.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Details zum Haushaltseinkommen. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_HOUSEHOLD_INCOME hat.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Details zur Bildschirmposition Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_ON_SCREEN_POSITION hat.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Details zum Mobilfunkanbieter und Internetanbieter Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_CARRIER_AND_ISP hat.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Keyword-Details. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_KEYWORD hat.

Einer Ressource können maximal 5.000 direkte auszuschließende Keywords zugewiesen werden. Es gibt keine Obergrenze für die Anzahl der positiven Keywords, die zugewiesen werden können.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Keyword-Details. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_NEGATIVE_KEYWORD_LIST hat.

Einer Ressource können maximal vier Listen mit auszuschließenden Keywords zugewiesen werden.
operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Details zum Betriebssystem. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_OPERATING_SYSTEM hat.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Angaben zu Hersteller und Modell des Geräts. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_DEVICE_MAKE_MODEL hat.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Umgebungsdetails Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_ENVIRONMENT hat.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Details zur Inventarquelle. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_INVENTORY_SOURCE hat.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Kategoriedetails. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_CATEGORY hat.

Wenn Sie ein Targeting auf eine Kategorie festlegen, wird dieses Targeting auch automatisch auf alle Unterkategorien angewendet, die der entsprechenden Kategorie untergeordnet sind. Wenn eine Kategorie vom Targeting ausgeschlossen und eine Unterkategorie eingeschlossen wird, hat der Ausschluss Vorrang.
viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Details zur Sichtbarkeit. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_VIEWABILITY hat.

Pro Ressource kann nur eine Sichtbarkeitsoption für das Targeting ausgewählt werden.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Details zum Status „Autorisierter Verkäufer“ Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_AUTHORIZED_SELLER_STATUS hat.

Sie können die Ausrichtung jeweils nur auf eine Option für den Status des autorisierten Verkäufers festlegen.

Wenn für eine Ressource die Option „Autorisierter Verkäufer“ nicht verfügbar ist, werden alle autorisierten Verkäufer, die in der ads.txt-Datei als DIREKT oder RESELLER angegeben sind, standardmäßig für das Targeting verwendet.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

Sprachdetails. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_LANGUAGE hat.
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Details zur geografischen Region. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_GEO_REGION hat.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Details zur Inventarquellgruppe. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_INVENTORY_SOURCE_GROUP hat.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Details zum Label für digitale Inhalte Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION hat.

Labels für digitale Inhalte sind Targeting-Ausschlüsse. Ausschlüsse für digitale Inhaltslabels auf Werbetreibendenebene werden, sofern festgelegt, immer bei der Auslieferung angewendet, auch wenn sie in den Ressourceneinstellungen nicht sichtbar sind. Ressourceneinstellungen können zusätzlich zu Werbetreibendenausschlüssen auch Inhaltslabels ausschließen, aber nicht überschreiben. Anzeigen einer Werbebuchung werden nicht ausgeliefert, wenn alle Labels für digitale Inhalte ausgeschlossen sind.
sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Details zur sensiblen Kategorie Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION hat.

Sensible Kategorien sind Ausrichtungsausschlüsse. Ausschlüsse sensibler Kategorien auf Werbetreibendenebene werden bei der Auslieferung immer angewendet, auch wenn sie in den Ressourceneinstellungen nicht sichtbar sind. In den Ressourceneinstellungen können neben den Ausschlüssen von Werbetreibenden auch sensible Kategorien ausgeschlossen werden. Sie können sie jedoch nicht überschreiben.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Details zur Börse Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_EXCHANGE hat.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Details zur untergeordneten Anzeigenplattform Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_SUB_EXCHANGE hat.
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Details zur Drittanbieterüberprüfung Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_THIRD_PARTY_VERIFIER hat.
poiDetails

object (PoiAssignedTargetingOptionDetails)

POI-Details. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_POI hat.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Details zur Handelskette Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_BUSINESS_CHAIN hat.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Details zur Contentdauer. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_CONTENT_DURATION hat.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Details zur Contentdauer. Dieses Feld wird ausgefüllt, wenn für den TargetingType TARGETING_TYPE_CONTENT_STREAM_TYPE festgelegt ist.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Details zur Position von Native Contentanzeigen. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_NATIVE_CONTENT_POSITION hat.
omidDetails

object (OmidAssignedTargetingOptionDetails)

Inventardetails für Open Measurement Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_OMID hat.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Details zum Audioinhaltstyp Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_AUDIO_CONTENT_TYPE hat.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Details zum Genre des Inhalts. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_CONTENT_GENRE hat.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Details zum YouTube-Video Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_YOUTUBE_VIDEO hat.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Details zum YouTube-Kanal Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_YOUTUBE_CHANNEL hat.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Details zur Sitzungsposition. Dieses Feld wird ausgefüllt, wenn targetingType den Wert TARGETING_TYPE_SESSION_POSITION hat.

Methoden

create

 Weist einer Werbebuchung eine Targeting-Option zu.

delete

 Löscht eine zugewiesene Targeting-Option aus einer Werbebuchung.

get

 Einer Werbebuchung wird eine einzelne Targeting-Option zugewiesen.

list

 Hier werden die Targeting-Optionen aufgelistet, die einer Werbebuchung zugewiesen sind.