REST Resource: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

Ressource: AssignedTargetingOption

Eine einzelne zugewiesene Targeting-Option, die den Status einer Targeting-Option für eine Einheit 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)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "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 Targeting-Optionen unterstützt, die Werbebuchungen der folgenden Targeting-Typen zugewiesen sind:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

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

enum (Inheritance)

Nur Ausgabe. Der Übernahmestatus der zugewiesenen Ausrichtungsoption.
Union-Feld details. Detaillierte Informationen zur zugewiesenen Ausrichtungsoption. Es darf nur ein Feld in „details“ ausgefüllt werden und es muss targeting_type entsprechen. details kann nur einer der folgenden Werte sein:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Kanaldetails. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_CHANNEL ist.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

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

object (AppAssignedTargetingOptionDetails)

App-Details. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_APP ist.
urlDetails

object (UrlAssignedTargetingOptionDetails)

URL-Details. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_URL ist.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Details zu Tag und Uhrzeit. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_DAY_AND_TIME ist.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Details zur Altersgruppe. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_AGE_RANGE ist.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Details zu Listen mit regionalen Standorten. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_REGIONAL_LOCATION_LIST ist.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

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

object (GenderAssignedTargetingOptionDetails)

Geschlechtsangaben. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_GENDER ist.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

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

object (UserRewardedContentAssignedTargetingOptionDetails)

Details zu Content mit Prämie für den Nutzer. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_USER_REWARDED_CONTENT ist.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Details zum Elternstatus. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_PARENTAL_STATUS ist.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Details zur In-Stream-Position von Inhalten. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_CONTENT_INSTREAM_POSITION ist.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Details zur Outstream-Position von Inhalten. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ist.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

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

object (AudienceGroupAssignedTargetingOptionDetails)

Details zum Zielgruppen-Targeting. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_AUDIENCE_GROUP ist. Sie können pro Ressource nur eine Option für die Zielgruppe auswählen.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

Browserdetails Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_BROWSER ist.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Details zum Haushaltseinkommen. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_HOUSEHOLD_INCOME ist.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Details zur Position auf dem Bildschirm. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_ON_SCREEN_POSITION ist.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Details zum Mobilfunk- und Internetanbieter. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_CARRIER_AND_ISP ist.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Keyword-Details. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_KEYWORD ist.

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

object (NegativeKeywordListAssignedTargetingOptionDetails)

Keyword-Details. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_NEGATIVE_KEYWORD_LIST ist.

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 TARGETING_TYPE_OPERATING_SYSTEM ist.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Details zu Marke und Modell des Geräts. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_DEVICE_MAKE_MODEL ist.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Umgebungsdetails. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_ENVIRONMENT ist.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Details zur Inventarquelle Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_INVENTORY_SOURCE ist.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Kategoriedetails. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_CATEGORY ist.

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

object (ViewabilityAssignedTargetingOptionDetails)

Details zur Sichtbarkeit. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_VIEWABILITY ist.

Sie können pro Ressource nur eine Option für die Sichtbarkeit festlegen.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

Sie können pro Ressource nur eine Option für den Status als autorisierter Verkäufer auswählen.

Wenn für eine Ressource keine Option für den Status „Autorisierter Verkäufer“ vorhanden ist, werden standardmäßig alle autorisierten Verkäufer, die in der ads.txt-Datei als „DIRECT“ oder „RESELLER“ angegeben sind, als Zielgruppe verwendet.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

Sprachdetails. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_LANGUAGE ist.
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

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

object (InventorySourceGroupAssignedTargetingOptionDetails)

Details zur Gruppe aus Inventarquellen. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_INVENTORY_SOURCE_GROUP ist.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Details zu Labels für digitalen Content. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ist.

Labels für digitalen Content sind Targeting-Ausschlüsse. Ausschlüsse von Labels für digitale Inhalte auf Werbetreibendenebene werden bei der Auslieferung immer angewendet, sofern sie festgelegt sind, auch wenn sie nicht in den Ressourceneinstellungen sichtbar sind. Mit Ressourceneinstellungen können zusätzlich zu den Ausschlüssen von Werbetreibenden Inhaltslabels ausgeschlossen werden. Sie können die Ausschlüsse von Werbetreibenden jedoch nicht überschreiben. Eine Werbebuchung wird 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 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION ist.

Sensible Kategorien sind Targeting-Ausschlüsse. Ausschlüsse für sensible Kategorien auf Werbetreibendenebene werden bei der Auslieferung immer angewendet, sofern sie festgelegt sind, auch wenn sie nicht in den Ressourceneinstellungen sichtbar sind. Mit Ressourceneinstellungen können sensible Kategorien zusätzlich zu den Ausschlüssen von Werbetreibenden ausgeschlossen werden. Sie können diese jedoch nicht überschreiben.
contentThemeExclusionDetails

object (ContentThemeAssignedTargetingOptionDetails)

Details zum Inhaltsthema. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_CONTENT_THEME_EXCLUSION ist.

Inhaltsthemen sind Targeting-Ausschlüsse. Ausschlüsse von Inhaltsthemen auf Werbetreibendenebene werden bei der Auslieferung immer angewendet, auch wenn sie nicht in den Ressourceneinstellungen sichtbar sind. Mit Ressourceneinstellungen können zusätzlich zu Werbetreibendenausschlüssen auch Inhaltsthemen ausgeschlossen werden.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Details zum Tausch. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_EXCHANGE ist.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Details zur Überprüfung durch Drittanbieter Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_THIRD_PARTY_VERIFIER ist.
poiDetails

object (PoiAssignedTargetingOptionDetails)

POI-Details. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_POI ist.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Details zur Handelskette. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_BUSINESS_CHAIN ist.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Details zur Contentdauer. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_CONTENT_DURATION ist.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Details zur Contentdauer. Dieses Feld wird ausgefüllt, wenn „TargetingType“ TARGETING_TYPE_CONTENT_STREAM_TYPE ist.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

object (OmidAssignedTargetingOptionDetails)

Details zum Inventar, für das Open Measurement aktiviert ist. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_OMID ist.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Details zum Audioinhaltstyp. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_AUDIO_CONTENT_TYPE ist.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Details zum Inhaltsgenre. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_CONTENT_GENRE ist.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

YouTube-Videodetails. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_YOUTUBE_VIDEO ist.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

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

object (SessionPositionAssignedTargetingOptionDetails)

Details zur Sitzungsposition. Dieses Feld wird ausgefüllt, wenn targetingType TARGETING_TYPE_SESSION_POSITION ist.

Methoden

create

 Weist einem Anzeigenauftrag eine Targeting-Option zu.

delete

 Löscht eine zugewiesene Targeting-Option aus einem Anzeigenauftrag.

get

 Ruft eine einzelne Targeting-Option ab, die einem Anzeigenauftrag zugewiesen ist.

list

 Listet die Targeting-Optionen auf, die einem Anzeigenauftrag zugewiesen sind.