REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

リソース: AssignedTargetingOption

1 つの割り当てられたターゲティング オプション。ターゲティング設定のあるエンティティのターゲティング オプションの状態を定義します。

JSON 表現
{
  "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.
}
フィールド
name

string

出力専用。この割り当てられたターゲティング オプションのリソース名。

assignedTargetingOptionId

string

出力専用。割り当てられたターゲティング オプションの一意の ID。この ID は一意なのは、特定のリソースとターゲティング タイプ内のみです。他のコンテキストで再利用される可能性があります。

assignedTargetingOptionIdAlias

string

出力専用。assignedTargetingOptionId のエイリアス。この値は、既存のターゲティングを取得または削除するときに assignedTargetingOptionId の代わりに使用できます。

このフィールドは、次のターゲティング タイプの割り当て済みのターゲティング オプションにのみ対応しています。

  • 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

このフィールドは、広告申込情報で次のターゲティング タイプのターゲティング オプションが割り当てられている場合にもサポートされます。

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

出力専用。この割り当てられたターゲティング オプションのタイプを識別します。

inheritance

enum (Inheritance)

出力専用。割り当てられたターゲティング オプションの継承ステータス。

共用体フィールド details。割り当てられているターゲティング オプションに関する詳細情報。details のフィールドは 1 つだけ入力できます。このフィールドは targeting_type に対応している必要があります。details は次のいずれか 1 つにする必要があります。
channelDetails

object (ChannelAssignedTargetingOptionDetails)

チャンネルの詳細。このフィールドは、targetingTypeTARGETING_TYPE_CHANNEL の場合に入力されます。

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

アプリのカテゴリの詳細。このフィールドは、targetingTypeTARGETING_TYPE_APP_CATEGORY の場合に入力されます。

appDetails

object (AppAssignedTargetingOptionDetails)

アプリの詳細。このフィールドは、targetingTypeTARGETING_TYPE_APP の場合に入力されます。

urlDetails

object (UrlAssignedTargetingOptionDetails)

URL の詳細。このフィールドは、targetingTypeTARGETING_TYPE_URL の場合に入力されます。

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

曜日と時間の詳細。このフィールドは、targetingTypeTARGETING_TYPE_DAY_AND_TIME の場合に入力されます。

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

年齢層の詳細。このフィールドは、targetingTypeTARGETING_TYPE_AGE_RANGE の場合に入力されます。

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

リージョン地域リストの詳細。このフィールドは、targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST の場合に入力されます。

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

近隣地域リストの詳細。このフィールドは、targetingTypeTARGETING_TYPE_PROXIMITY_LOCATION_LIST の場合に入力されます。

genderDetails

object (GenderAssignedTargetingOptionDetails)

性別の詳細。このフィールドは、targetingTypeTARGETING_TYPE_GENDER の場合に入力されます。

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

動画プレーヤーのサイズの詳細。このフィールドは、targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE の場合に入力されます。

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

ユーザー リワードありのコンテンツの詳細。このフィールドは、targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT の場合に入力されます。

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

子供の有無に関する詳細。このフィールドは、targetingTypeTARGETING_TYPE_PARENTAL_STATUS の場合に入力されます。

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

コンテンツの動画内プレースメントの詳細。このフィールドは、targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION の場合に入力されます。

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

コンテンツのアウトストリーム プレースメントの詳細。このフィールドは、targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION の場合に入力されます。

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

デバイスタイプの詳細。このフィールドは、targetingTypeTARGETING_TYPE_DEVICE_TYPE の場合に入力されます。

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

オーディエンス ターゲティングの詳細。このフィールドは、targetingTypeTARGETING_TYPE_AUDIENCE_GROUP の場合に入力されます。リソースごとにターゲットにできるオーディエンス グループ オプションは 1 つのみです。

browserDetails

object (BrowserAssignedTargetingOptionDetails)

ブラウザの詳細。このフィールドは、targetingTypeTARGETING_TYPE_BROWSER の場合に入力されます。

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

世帯収入の詳細。このフィールドは、targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME の場合に入力されます。

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

画面上の位置の詳細。このフィールドは、targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION の場合に入力されます。

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

携帯通信会社と ISP の詳細。このフィールドは、targetingTypeTARGETING_TYPE_CARRIER_AND_ISP の場合に入力されます。

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

キーワードの詳細。このフィールドは、targetingTypeTARGETING_TYPE_KEYWORD の場合に入力されます。

リソースに割り当てることができる直接除外キーワードは最大 5,000 個です。割り当て可能なキーワード(非除外キーワード)の数に制限はありません。

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

キーワードの詳細。このフィールドは、targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST の場合に入力されます。

リソースに割り当てることができる除外キーワード リストは最大 4 個です。

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

オペレーティング システムの詳細。このフィールドは、targetingTypeTARGETING_TYPE_OPERATING_SYSTEM の場合に入力されます。

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

デバイスのメーカーとモデルの詳細。このフィールドは、targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL の場合に入力されます。

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

環境の詳細。このフィールドは、targetingTypeTARGETING_TYPE_ENVIRONMENT の場合に入力されます。

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

広告枠ソースの詳細。このフィールドは、targetingTypeTARGETING_TYPE_INVENTORY_SOURCE の場合に入力されます。

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

カテゴリの詳細。このフィールドは、targetingTypeTARGETING_TYPE_CATEGORY の場合に入力されます。

カテゴリをターゲットに設定すると、そのサブカテゴリもターゲットに設定されます。カテゴリがターゲティングから除外され、サブカテゴリがターゲットに含まれている場合は、除外が優先されます。

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

視認性の詳細。このフィールドは、targetingTypeTARGETING_TYPE_VIEWABILITY の場合に入力されます。

ターゲットに設定できる視認性オプションは、リソースごとに 1 つのみです。

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

認定販売者のステータスの詳細。このフィールドは、targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS の場合に入力されます。

ターゲットに設定できる認定販売者のステータス オプションは、リソースごとに 1 つのみです。

リソースに認定販売者ステータス オプションがない場合は、ads.txt ファイルで「DIRECT」または「RESELLER」と指定されているすべての認定販売者がデフォルトでターゲットに設定されます。

languageDetails

object (LanguageAssignedTargetingOptionDetails)

言語の詳細。このフィールドは、targetingTypeTARGETING_TYPE_LANGUAGE の場合に入力されます。

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

地理的地域の詳細。このフィールドは、targetingTypeTARGETING_TYPE_GEO_REGION の場合に入力されます。

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

広告枠ソースグループの詳細。このフィールドは、targetingTypeTARGETING_TYPE_INVENTORY_SOURCE_GROUP の場合に入力されます。

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

デジタル コンテンツ ラベルの詳細。このフィールドは、targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION の場合に入力されます。

デジタル コンテンツ ラベルはターゲティングの除外です。広告主レベルのデジタル コンテンツ ラベルの除外を設定すると、(リソース設定に表示されない場合でも)配信で常に適用されます。リソース設定では、広告主の除外に加えて、コンテンツ ラベルを除外することはできますが、オーバーライドすることはできません。デジタル コンテンツ ラベルをすべて除外すると、広告申込情報は配信されません。

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

デリケートなカテゴリの詳細。このフィールドは、targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION の場合に入力されます。

デリケートなカテゴリはターゲティングの除外です。広告主レベルのデリケートなカテゴリの除外は、設定されている場合、配信時に常に適用されます(リソース設定には表示されません)。リソース設定では、広告主の除外に加えて、デリケートなカテゴリを除外することはできますが、オーバーライドすることはできません。

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

交換の詳細。このフィールドは、targetingTypeTARGETING_TYPE_EXCHANGE の場合に入力されます。

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

サブエクスチェンジの詳細。このフィールドは、targetingTypeTARGETING_TYPE_SUB_EXCHANGE の場合に入力されます。

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

サードパーティによる検証の詳細。このフィールドは、targetingTypeTARGETING_TYPE_THIRD_PARTY_VERIFIER の場合に入力されます。

poiDetails

object (PoiAssignedTargetingOptionDetails)

スポットの詳細。このフィールドは、targetingTypeTARGETING_TYPE_POI の場合に入力されます。

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

ビジネス チェーンの詳細。このフィールドは、targetingTypeTARGETING_TYPE_BUSINESS_CHAIN の場合に入力されます。

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

コンテンツの長さの詳細。このフィールドは、targetingTypeTARGETING_TYPE_CONTENT_DURATION の場合に入力されます。

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

コンテンツの長さの詳細。このフィールドは、TargetingType が TARGETING_TYPE_CONTENT_STREAM_TYPE の場合に入力されます。

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

ネイティブ コンテンツの位置の詳細。このフィールドは、targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION の場合に入力されます。

omidDetails

object (OmidAssignedTargetingOptionDetails)

Open Measurement が有効な広告枠の詳細。このフィールドは、targetingTypeTARGETING_TYPE_OMID の場合に入力されます。

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

オーディオ コンテンツ タイプの詳細。このフィールドは、targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE の場合に入力されます。

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

コンテンツ ジャンルの詳細。このフィールドは、targetingTypeTARGETING_TYPE_CONTENT_GENRE の場合に入力されます。

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

YouTube 動画の詳細。このフィールドは、targetingTypeTARGETING_TYPE_YOUTUBE_VIDEO の場合に入力されます。

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

YouTube チャンネルの詳細。このフィールドは、targetingTypeTARGETING_TYPE_YOUTUBE_CHANNEL の場合に入力されます。

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

セッションの位置の詳細。このフィールドは、targetingTypeTARGETING_TYPE_SESSION_POSITION の場合に入力されます。

継承

割り当てられたターゲティング オプションが上位レベルのエンティティ(パートナーや広告主など)から継承されているかどうかを示します。継承された割り当て済みターゲティング オプションが優先され、現在のレベルで割り当てられたターゲティングよりも常に配信で適用されます。また、現在のエンティティ サービスでは変更できません。これらの値は、継承元のエンティティ サービスを使用して変更する必要があります。親レベルで設定されている場合、継承は、ターゲットから除外されたチャンネル、デリケートなカテゴリの除外、デジタル コンテンツ ラベルの除外にのみ適用されます。

列挙型
INHERITANCE_UNSPECIFIED 継承が指定されていないか、不明です。
NOT_INHERITED 割り当てられたターゲティング オプションは上位エンティティから継承されません。
INHERITED_FROM_PARTNER 割り当てられたターゲティング オプションは、パートナーのターゲティング設定から継承されます。
INHERITED_FROM_ADVERTISER 割り当てられたターゲティング オプションは、広告主のターゲティング設定から継承されます。

ChannelAssignedTargetingOptionDetails

割り当てられたチャンネル ターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_CHANNEL の場合、AssignedTargetingOption の詳細フィールドに入力されます。

JSON 表現
{
  "channelId": string,
  "negative": boolean
}
フィールド
channelId

string (int64 format)

必須。チャンネルの ID。パートナー所有のチャンネルまたは広告主所有のチャンネルのリソースのチャンネル ID フィールドを参照する必要があります。

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。広告主レベルで割り当てられたターゲティング オプションの場合、このフィールドは true にする必要があります。

AppCategoryAssignedTargetingOptionDetails

割り当てられたアプリカテゴリ ターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_APP_CATEGORY の場合に、AssignedTargetingOption の appCategoryDetails フィールドに入力されます。

JSON 表現
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
フィールド
displayName

string

出力専用。アプリカテゴリの表示名。

targetingOptionId

string

必須。targetingTypeTARGETING_TYPE_APP_CATEGORY の場合の targetingOptionId フィールド。

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。

AppAssignedTargetingOptionDetails

割り当てられたアプリ ターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_APP の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
フィールド
appId

string

必須。アプリの ID。

Android の Google Play ストア アプリはバンドル ID(com.google.android.gm など)を使用します。Apple の App Store アプリ ID は 9 桁の文字列(422689480 など)を使用します。

displayName

string

出力専用。アプリの表示名。

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。

appPlatform

enum (AppPlatform)

ターゲット アプリのプラットフォームを示します。このフィールドが指定されていない場合、アプリのプラットフォームはモバイル(Android または iOS)を指定してください。適切なモバイル プラットフォームはアプリ ID から導出されます。

AppPlatform

アプリ プラットフォームのターゲティング オプション。

列挙型
APP_PLATFORM_UNSPECIFIED このバージョンでアプリのプラットフォームが指定されていない場合のデフォルト値です。この列挙型はデフォルト値のプレースホルダであり、実際のプラットフォーム オプションを表すものではありません。
APP_PLATFORM_IOS アプリのプラットフォームは iOS です。
APP_PLATFORM_ANDROID アプリのプラットフォームは Android です。
APP_PLATFORM_ROKU アプリ プラットフォームは Roku です。
APP_PLATFORM_AMAZON_FIRETV アプリ プラットフォームが Amazon FireTV である。
APP_PLATFORM_PLAYSTATION アプリのプラットフォームは PlayStation です。
APP_PLATFORM_APPLE_TV アプリのプラットフォームが Apple TV である。
APP_PLATFORM_XBOX アプリのプラットフォームは Xbox です。
APP_PLATFORM_SAMSUNG_TV アプリのプラットフォームが Samsung TV である。
APP_PLATFORM_ANDROID_TV アプリのプラットフォームが Android TV である。
APP_PLATFORM_GENERIC_CTV このプラットフォームは、他の場所で明示的に記載されていない CTV プラットフォームです。
APP_PLATFORM_LG_TV アプリのプラットフォームが LG TV である。
APP_PLATFORM_VIZIO_TV アプリのプラットフォームが VIZIO TV である。

UrlAssignedTargetingOptionDetails

割り当てられた URL ターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_URL の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "url": string,
  "negative": boolean
}
フィールド
url

string

必須。URL(example.com など)。

ディスプレイ&ビデオ 360 では、2 レベルのサブディレクトリ(例: www.example.com/one-subdirectory-level/second-level)と 5 レベルのサブドメイン(例: five.four.three.two.one.example.com)のターゲティングがサポートされています。

negative

boolean

このオプションがターゲットから除外されているかどうかを示します。

DayAndTimeAssignedTargetingOptionDetails

特定の曜日で定義された時間セグメントを表し、開始時刻と終了時刻があります。startHour で表される時刻は、endHour で表される時刻より前である必要があります。

JSON 表現
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
フィールド
dayOfWeek

enum (DayOfWeek)

必須。この曜日と時間のターゲティング設定の曜日。

startHour

integer

必須。曜日と時間によるターゲティングの開始時間。0(午前 0 時)~ 23(午後 11 時)の範囲で指定してください。

endHour

integer

必須。曜日と時間によるターゲティングの終了時刻。1(午前 1 時)~24(午後 0 時)の範囲で指定する必要があります。

timeZoneResolution

enum (TimeZoneResolution)

必須。この日時のターゲティング設定で使用するタイムゾーンを決定するために使用されるメカニズムです。

DayOfWeek

曜日を表します。

列挙型
DAY_OF_WEEK_UNSPECIFIED 曜日は指定されていません。
MONDAY 月曜日
TUESDAY 火曜日
WEDNESDAY Wednesday
THURSDAY 木曜日
FRIDAY 金曜日
SATURDAY 土曜日
SUNDAY 日曜日

TimeZoneResolution

タイムゾーンを解決するための考えられるアプローチ。

列挙型
TIME_ZONE_RESOLUTION_UNSPECIFIED タイムゾーンの解決が不明確または不明です。
TIME_ZONE_RESOLUTION_END_USER 時刻は、広告を見たユーザーのタイムゾーンで解決されます。
TIME_ZONE_RESOLUTION_ADVERTISER 時間は、広告を配信した広告主のタイムゾーンで解決されます。

AgeRangeAssignedTargetingOptionDetails

ターゲティング可能な年齢層を表します。これは、targetingTypeTARGETING_TYPE_AGE_RANGE の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "ageRange": enum (AgeRange)
}
フィールド
ageRange

enum (AgeRange)

必須。オーディエンスの年齢層。一定の年齢層のオーディエンスのみをターゲットに設定できます。したがって、このフィールドに示される年齢層は、1)単独で対象とするか、2)より大きな連続する年齢層の一部である可能性があります。年齢層の連続ターゲティングのリーチは、年齢が不明のオーディエンスをターゲットに設定することで拡大できます。

RegionalLocationListAssignedTargetingOptionDetails

リージョン地域リストのターゲティングの詳細。これは、targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "regionalLocationListId": string,
  "negative": boolean
}
フィールド
regionalLocationListId

string (int64 format)

必須。リージョン地域リストの ID。タイプが TARGETING_LOCATION_TYPE_REGIONALLocationList リソースの locationListId フィールドを参照する必要があります。

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。

ProximityLocationListAssignedTargetingOptionDetails

近隣地域リストのターゲティングの詳細。これは、targetingTypeTARGETING_TYPE_PROXIMITY_LOCATION_LIST の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
フィールド
proximityLocationListId

string (int64 format)

必須。近接ロケーション リストの ID。タイプが TARGETING_LOCATION_TYPE_PROXIMITYLocationList リソースの locationListId フィールドを参照する必要があります。

proximityRadius

number

必須。proximityRadiusUnit で設定された距離の単位で表される半径。選択した場所の周囲でターゲットとするエリアのサイズを表します。半径は 1 ~ 500 マイル(800 km)の範囲で指定してください。

proximityRadiusUnit

enum (ProximityRadiusUnit)

必須。半径距離の単位。

ProximityRadiusUnit

ProximityRadius の距離単位の列挙型。

列挙型
PROXIMITY_RADIUS_UNIT_UNSPECIFIED このバージョンで距離単位が指定されていない場合のデフォルト値。この列挙型はデフォルト値のプレースホルダであり、実際の距離単位を表すものではありません。
PROXIMITY_RADIUS_UNIT_MILES 半径距離の単位(マイル)。
PROXIMITY_RADIUS_UNIT_KILOMETERS 半径距離の単位(キロメートル)

GenderAssignedTargetingOptionDetails

割り当てられた性別ターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_GENDER の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "gender": enum (Gender)
}
フィールド
gender

enum (Gender)

必須。オーディエンスの性別。

VideoPlayerSizeAssignedTargetingOptionDetails

動画プレーヤーのサイズのターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE の場合、この値は videoPlayerSizeDetails フィールドに入力されます。すべてのオプションを明示的にターゲティングすることはできません。この効果を実現するには、動画プレーヤー サイズのターゲティング オプションをすべて削除してください。

JSON 表現
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
フィールド
videoPlayerSize

enum (VideoPlayerSize)

必須。動画プレーヤーのサイズ。

UserRewardedContentAssignedTargetingOptionDetails

ユーザー リワードありのコンテンツ ターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT の場合、この値は userRewardedContentDetails フィールドに入力されます。

JSON 表現
{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}
フィールド
targetingOptionId

string

必須。targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT の場合の targetingOptionId フィールド。

userRewardedContent

enum (UserRewardedContent)

出力専用。動画広告のユーザー リワードありのコンテンツのステータス。

ParentalStatusAssignedTargetingOptionDetails

割り当てられた子供の有無のターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_PARENTAL_STATUS の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "parentalStatus": enum (ParentalStatus)
}
フィールド
parentalStatus

enum (ParentalStatus)

必須。オーディエンスの子供の有無に関する設定。

ContentInstreamPositionAssignedTargetingOptionDetails

割り当てられたコンテンツ インストリーム ポジション ターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION の場合、これは contentInstreamPositionDetails フィールドに入力されます。

JSON 表現
{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
フィールド
contentInstreamPosition

enum (ContentInstreamPosition)

必須。動画広告または音声広告のコンテンツ内インストリームの位置。

adType

enum (AdType)

出力専用。ターゲットとする広告の種類。広告掲載オーダーのターゲティングにのみ適用され、指定された広告タイプをサポートする新しい広告申込情報には、デフォルトでこのターゲティング オプションが継承されます。次の値があります。

  • AD_TYPE_VIDEO: lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT の場合、この設定は新しい広告申込情報に継承されます。
  • AD_TYPE_AUDIO: lineItemTypeLINE_ITEM_TYPE_AUDIO_DEFAULT の場合、この設定は新しい広告申込情報に継承されます。

AdType

広告に関連付けられているクリエイティブ タイプを表します。

列挙型
AD_TYPE_UNSPECIFIED このバージョンでは、広告タイプが指定されていないか不明です。
AD_TYPE_DISPLAY ディスプレイ クリエイティブ(画像、HTML5 など)。
AD_TYPE_VIDEO 動画クリエイティブ(例: 動画プレーヤーでコンテンツのストリーミング中に再生される動画広告)。
AD_TYPE_AUDIO オーディオ クリエイティブ(オーディオ コンテンツ内で再生されるオーディオ広告など)。

ContentOutstreamPositionAssignedTargetingOptionDetails

割り当てられたコンテンツのアウトストリーム位置ターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION の場合、この値は contentOutstreamPositionDetails フィールドに入力されます。

JSON 表現
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
フィールド
contentOutstreamPosition

enum (ContentOutstreamPosition)

必須。コンテンツのアウトストリーム ポジション。

adType

enum (AdType)

出力専用。ターゲットとする広告の種類。広告掲載オーダーのターゲティングにのみ適用され、指定された広告タイプをサポートする新しい広告申込情報には、デフォルトでこのターゲティング オプションが継承されます。次の値があります。

  • AD_TYPE_DISPLAY: lineItemTypeLINE_ITEM_TYPE_DISPLAY_DEFAULT の場合、この設定は新しい広告申込情報に継承されます。
  • AD_TYPE_VIDEO: lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT の場合、この設定は新しい広告申込情報に継承されます。

DeviceTypeAssignedTargetingOptionDetails

デバイスタイプのターゲティングの詳細。これは、targetingTypeTARGETING_TYPE_DEVICE_TYPE の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
フィールド
deviceType

enum (DeviceType)

必須。デバイスタイプの表示名。

youtubeAndPartnersBidMultiplier

number

出力専用。入札単価調整比を使用すると、デバイスの種類に応じて広告の表示回数を調整できます。元の入札単価に倍率が適用されます。このフィールドが 0 の場合、元の入札単価に 0 を掛けるのではなく、このフィールドが適用されないことを示します。

たとえば、単価調整比なしの入札単価が $10.0 で、タブレットの単価調整比が 1.5 の場合、タブレットの入札単価は $15.0 になります。

YouTube とパートナーの広告申込情報にのみ適用されます。

AudienceGroupAssignedTargetingOptionDetails

割り当てられたオーディエンス グループ ターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_AUDIENCE_GROUP の場合に、AssignedTargetingOption の details フィールドに入力されます。各グループの関係は UNION です。ただし、excludedFirstAndThirdPartyAudienceGroup と excludedGoogleAudienceGroup は例外で、他のグループとの INTERSECTION として COMPLEMENT が使用されます。

JSON 表現
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
フィールド
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

ファースト パーティ オーディエンスとサードパーティ オーディエンスの ID、および含まれるファースト パーティ オーディエンス グループとサードパーティ オーディエンス グループの更新日時。各ファースト パーティ / サードパーティ オーディエンス グループには、ファースト パーティ / サードパーティ オーディエンス ID のみが含まれます。各ファーストパーティ オーディエンス グループとサードパーティ オーディエンス グループの関係は「交差」で、その結果は他のオーディエンス グループと「結合」されます。同じ設定のグループが重複する場合、重複したグループは無視されます。

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

含まれている Google オーディエンス グループの Google オーディエンス ID。Google オーディエンス ID のみが含まれます。

includedCustomListGroup

object (CustomListGroup)

含まれるカスタムリスト グループのカスタムリスト ID。カスタム リスト ID のみが含まれます。

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

含まれる組み合わせオーディエンス グループの組み合わせオーディエンス ID。組み合わせオーディエンス ID のみが含まれます。

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

除外されたファースト パーティ オーディエンス グループとサードパーティ オーディエンス グループのファースト パーティ オーディエンス ID とサードパーティ オーディエンス ID、更新日時。ターゲット除外に使われます。このグループと他の除外されたオーディエンス グループの UNION 「COMPLEMENT」が、すべての非除外オーディエンス ターゲティングへの結合として使用されます。すべての項目は論理的に「OR」の関係にあります。

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

除外された Google オーディエンス グループの Google オーディエンス ID。ターゲット除外に使われます。このグループと他の除外されたオーディエンス グループの UNION 「COMPLEMENT」が、すべての非除外オーディエンス ターゲティングへの結合として使用されます。アフィニティ、購買意向の強い、インストール済みアプリのタイプの Google オーディエンスのみを含めます。すべてのアイテムは、互いに論理的に「OR」となります。

FirstAndThirdPartyAudienceGroup

ファースト パーティとサードパーティのオーディエンス グループの詳細。自社オーディエンスと第三者オーディエンスのターゲティング設定はすべて、論理演算子「OR」で結合されます。

JSON 表現
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
フィールド
settings[]

object (FirstAndThirdPartyAudienceTargetingSetting)

必須。ファースト パーティ / サードパーティ オーディエンス グループ内のファースト パーティ / サードパーティ オーディエンス ターゲティングの設定すべて。同じ ID の設定を繰り返すことはできません。

FirstAndThirdPartyAudienceTargetingSetting

ファースト パーティとサードパーティのオーディエンスのターゲティング設定の詳細。

JSON 表現
{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}
フィールド
firstAndThirdPartyAudienceId

string (int64 format)

必須。自社と第三者のオーディエンス ターゲティング設定の自社オーディエンスと第三者オーディエンス ID。この ID は firstAndThirdPartyAudienceId です。

recency

enum (Recency)

ファースト パーティ オーディエンスとサードパーティ オーディエンスのターゲティング設定の更新日時。ファーストパーティ オーディエンスにのみ適用されます。それ以外の場合は無視されます。詳しくは、https://support.google.com/displayvideo/answer/2949947#recency をご覧ください。指定しない場合、最近の動画の上限は適用されません。

新しい順

サポートされているファーストパーティ オーディエンスとサードパーティ オーディエンスのリクエンシー値。

列挙型
RECENCY_NO_LIMIT 直近の投稿に制限はありません。
RECENCY_1_MINUTE 直近は 1 分です。
RECENCY_5_MINUTES 直近は 5 分です。
RECENCY_10_MINUTES 直近は 10 分です。
RECENCY_15_MINUTES リピート間隔は 15 分です。
RECENCY_30_MINUTES 直近の検索は 30 分以内です。
RECENCY_1_HOUR 直近は 1 時間です。
RECENCY_2_HOURS 直近は 2 時間です。
RECENCY_3_HOURS 直近の検索は 3 時間以内です。
RECENCY_6_HOURS 直近の検索は 6 時間以内です。
RECENCY_12_HOURS リピート間隔は 12 時間です。
RECENCY_1_DAY 期間は 1 日です。
RECENCY_2_DAYS 期間は 2 日です。
RECENCY_3_DAYS 直近の検索は 3 日前です。
RECENCY_5_DAYS 直近の検索は 5 日前です。
RECENCY_7_DAYS 期間は 7 日間です。
RECENCY_10_DAYS 期間は 10 日です。
RECENCY_14_DAYS リピート間隔は 14 日間です。
RECENCY_15_DAYS 期間は 15 日間です。
RECENCY_21_DAYS リピート間隔は 21 日間です。
RECENCY_28_DAYS リピート間隔は 28 日間です。
RECENCY_30_DAYS リピート間隔は 30 日間です。
RECENCY_40_DAYS リピート間隔は 40 日です。
RECENCY_45_DAYS 直近の報告は 45 日前です。
RECENCY_60_DAYS 直近の更新日が 60 日以内。
RECENCY_90_DAYS 直近の更新日が 90 日以内。
RECENCY_120_DAYS 期間は 120 日です。
RECENCY_180_DAYS 期間は 180 日間です。
RECENCY_270_DAYS 直近の検索は 270 日前です。
RECENCY_365_DAYS 直近の期間は 365 日です。

GoogleAudienceGroup

Google 対象グループの詳細。Google のオーディエンス ターゲティングの設定はすべて、論理的には「OR」の関係にあります。

JSON 表現
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
フィールド
settings[]

object (GoogleAudienceTargetingSetting)

必須。Google オーディエンス グループ内のすべての Google オーディエンスのターゲティング設定。同じ ID の設定が繰り返された場合は無視されます。

GoogleAudienceTargetingSetting

Google オーディエンス ターゲティングの設定の詳細。

JSON 表現
{
  "googleAudienceId": string
}
フィールド
googleAudienceId

string (int64 format)

必須。Google オーディエンス ターゲティング設定の Google オーディエンス ID。この ID は googleAudienceId です。

CustomListGroup

カスタムリスト グループの詳細。カスタムリストのターゲティング設定はすべて、論理的には「OR」の関係にあります。

JSON 表現
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
フィールド
settings[]

object (CustomListTargetingSetting)

必須。カスタムリスト グループ内のすべてのカスタムリスト ターゲティング設定。同じ ID で繰り返し設定は無視されます。

CustomListTargetingSetting

カスタムリスト ターゲティングの設定の詳細。

JSON 表現
{
  "customListId": string
}
フィールド
customListId

string (int64 format)

必須。カスタムリスト ターゲティング設定のカスタム ID。この ID は customListId です。

CombinedAudienceGroup

組み合わせオーディエンス グループの詳細。組み合わせたオーディエンス ターゲティングの設定はすべて、論理的に「OR」の関係になります。

JSON 表現
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
フィールド
settings[]

object (CombinedAudienceTargetingSetting)

必須。組み合わせオーディエンス グループ内のすべての組み合わせオーディエンスのターゲティング設定。同じ ID の設定が繰り返された場合は無視されます。組み合わせオーディエンスの設定は 5 つまでです。それを超えるとエラーが発生します。

CombinedAudienceTargetingSetting

組み合わせオーディエンス ターゲティングの設定に関する詳細。

JSON 表現
{
  "combinedAudienceId": string
}
フィールド
combinedAudienceId

string (int64 format)

必須。統合オーディエンス ターゲティング設定の統合オーディエンス ID。この ID は combinedAudienceId です。

BrowserAssignedTargetingOptionDetails

割り当てられたブラウザ ターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_BROWSER の場合、AssignedTargetingOption の詳細フィールドに入力されます。

JSON 表現
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
フィールド
displayName

string

出力専用。ブラウザの表示名。

targetingOptionId

string

必須。TARGETING_TYPE_BROWSER 型の TargetingOptiontargetingOptionId

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。同じリソースに割り当てられたブラウザ ターゲティング オプションはすべて、このフィールドの値が同じである必要があります。

HouseholdIncomeAssignedTargetingOptionDetails

割り当てられた世帯所得ターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME の場合、AssignedTargetingOption の詳細フィールドに入力されます。

JSON 表現
{
  "householdIncome": enum (HouseholdIncome)
}
フィールド
householdIncome

enum (HouseholdIncome)

必須。オーディエンスの世帯収入。

OnScreenPositionAssignedTargetingOptionDetails

画面上の位置ターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION の場合、この値は onScreenPositionDetails フィールドに入力されます。

JSON 表現
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
フィールド
targetingOptionId

string

必須。targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION の場合の targetingOptionId フィールド。

onScreenPosition

enum (OnScreenPosition)

出力専用。画面上の位置。

adType

enum (AdType)

出力専用。ターゲットとする広告の種類。広告掲載オーダーのターゲティングにのみ適用され、指定された広告タイプをサポートする新しい広告申込情報には、デフォルトでこのターゲティング オプションが継承されます。次の値があります。

  • AD_TYPE_DISPLAY: lineItemTypeLINE_ITEM_TYPE_DISPLAY_DEFAULT の場合、この設定は新しい広告申込情報に継承されます。
  • AD_TYPE_VIDEO: lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT の場合、設定は新しい広告申込情報に継承されます。

CarrierAndIspAssignedTargetingOptionDetails

割り当てられた携帯通信会社と ISP のターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_CARRIER_AND_ISP の場合、AssignedTargetingOption の詳細フィールドに入力されます。

JSON 表現
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
フィールド
displayName

string

出力専用。携帯通信会社または ISP の表示名。

targetingOptionId

string

必須。TARGETING_TYPE_CARRIER_AND_ISP 型の TargetingOptiontargetingOptionId

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。同じリソースに割り当てられた携帯通信会社と ISP のターゲティング オプションはすべて、このフィールドに同じ値を指定する必要があります。

KeywordAssignedTargetingOptionDetails

割り当てられたキーワード ターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_KEYWORD の場合、AssignedTargetingOption の詳細フィールドに入力されます。

JSON 表現
{
  "keyword": string,
  "negative": boolean
}
フィールド
keyword

string

必須。キーワード(car insurance など)。

非除外キーワードに不適切な語句を含めることはできません。UTF-8 でエンコードし、最大サイズは 255 バイトにする必要があります。最大文字数は 80 文字です。単語数の上限は 10 です。

negative

boolean

このオプションがターゲットから除外されているかどうかを示します。

NegativeKeywordListAssignedTargetingOptionDetails

除外キーワード リストのターゲティングの詳細。targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST の場合、AssignedTargetingOption の詳細フィールドに入力されます。

JSON 表現
{
  "negativeKeywordListId": string
}
フィールド
negativeKeywordListId

string (int64 format)

必須。除外キーワード リストの ID。NegativeKeywordList リソースの negativeKeywordListId フィールドを参照する必要があります。

OperatingSystemAssignedTargetingOptionDetails

割り当てられたオペレーティング システム ターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_OPERATING_SYSTEM の場合、この値は operatingSystemDetails フィールドに入力されます。

JSON 表現
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
フィールド
displayName

string

出力専用。オペレーティング システムの表示名。

targetingOptionId

string

必須。targetingTypeTARGETING_TYPE_OPERATING_SYSTEM の場合に targetingOptionId フィールドに入力されるターゲティング オプション ID。

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。

DeviceMakeModelAssignedTargetingOptionDetails

割り当てられたデバイスのメーカーとモデルのターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL の場合、この値は deviceMakeModelDetails フィールドに入力されます。

JSON 表現
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
フィールド
displayName

string

出力専用。デバイスのメーカーとモデルの表示名。

targetingOptionId

string

必須。targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL の場合の targetingOptionId フィールド。

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。

EnvironmentAssignedTargetingOptionDetails

割り当てられた環境ターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_ENVIRONMENT の場合、AssignedTargetingOption の詳細フィールドに入力されます。

JSON 表現
{
  "environment": enum (Environment)
}
フィールド
environment

enum (Environment)

必須。サービング環境。

InventorySourceAssignedTargetingOptionDetails

広告枠ソースのターゲティングの詳細です。これは、targetingTypeTARGETING_TYPE_INVENTORY_SOURCE の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "inventorySourceId": string
}
フィールド
inventorySourceId

string (int64 format)

必須。広告枠ソースの ID。InventorySource リソースの inventorySourceId フィールドを参照する必要があります。

CategoryAssignedTargetingOptionDetails

割り当てられたカテゴリ ターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_CATEGORY の場合、この値は categoryDetails フィールドに入力されます。

JSON 表現
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
フィールド
displayName

string

出力専用。カテゴリの表示名。

targetingOptionId

string

必須。targetingTypeTARGETING_TYPE_CATEGORY の場合の targetingOptionId フィールド。

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。

ViewabilityAssignedTargetingOptionDetails

割り当てられた視認性ターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_VIEWABILITY の場合に、AssignedTargetingOption の viewabilityDetails フィールドに入力されます。

JSON 表現
{
  "viewability": enum (Viewability)
}
フィールド
viewability

enum (Viewability)

必須。予測される視認性の割合。

AuthorizedSellerStatusAssignedTargetingOptionDetails

割り当てられた認定販売者のステータスを表します。targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS の場合、AssignedTargetingOption の詳細フィールドに入力されます。

リソースに TARGETING_TYPE_AUTHORIZED_SELLER_STATUS が割り当てられたターゲティング オプションがない場合は、「認定直接販売者と認定販売パートナー」オプションが使用されています。

JSON 表現
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}
フィールド
authorizedSellerStatus

enum (AuthorizedSellerStatus)

出力専用。ターゲットとする認定販売者のステータス。

targetingOptionId

string

必須。TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 型の TargetingOptiontargetingOptionId

LanguageAssignedTargetingOptionDetails

割り当てられたターゲット言語オプションの詳細。これは、targetingTypeTARGETING_TYPE_LANGUAGE の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
フィールド
displayName

string

出力専用。言語の表示名(フランス語)を入力します。

targetingOptionId

string

必須。TARGETING_TYPE_LANGUAGE 型の TargetingOptiontargetingOptionId

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。同じリソースに割り当てられた言語ターゲティング オプションはすべて、このフィールドの値が同じである必要があります。

GeoRegionAssignedTargetingOptionDetails

割り当てられた地域ターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_GEO_REGION の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}
フィールド
displayName

string

出力専用。地理的地域の表示名(例:「Ontario, Canada」)を入力します。

targetingOptionId

string

必須。TARGETING_TYPE_GEO_REGION 型の TargetingOptiontargetingOptionId

geoRegionType

enum (GeoRegionType)

出力専用。地域ターゲティングのタイプ。

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。

InventorySourceGroupAssignedTargetingOptionDetails

広告枠ソース グループのターゲティングの詳細。これは、targetingTypeTARGETING_TYPE_INVENTORY_SOURCE_GROUP の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "inventorySourceGroupId": string
}
フィールド
inventorySourceGroupId

string (int64 format)

必須。広告枠ソース グループの ID。InventorySourceGroup リソースの inventorySourceGroupId フィールドを参照する必要があります。

DigitalContentLabelAssignedTargetingOptionDetails

デジタル コンテンツ ラベルのターゲティングの詳細。これは、targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
フィールド
excludedContentRatingTier

enum (ContentRatingTier)

必須。除外するデジタル コンテンツ ラベルの評価階層の表示名。

SensitiveCategoryAssignedTargetingOptionDetails

デリケートなカテゴリのターゲティングの詳細。これは、targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
フィールド
excludedSensitiveCategory

enum (SensitiveCategory)

必須。除外と分類された DV360 デリケートなカテゴリ コンテンツの列挙型。

ExchangeAssignedTargetingOptionDetails

割り当てられたエクスチェンジ ターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_EXCHANGE の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "exchange": enum (Exchange)
}
フィールド
exchange

enum (Exchange)

必須。エクスチェンジの列挙型値。

SubExchangeAssignedTargetingOptionDetails

割り当てられたサブエクスチェンジのターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_SUB_EXCHANGE の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "targetingOptionId": string
}
フィールド
targetingOptionId

string

必須。TARGETING_TYPE_SUB_EXCHANGE 型の TargetingOptiontargetingOptionId

ThirdPartyVerifierAssignedTargetingOptionDetails

割り当てられた第三者確認機関のターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_THIRD_PARTY_VERIFIER の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
フィールド
共用体フィールド verifier。第三者ベリフィケーションのいずれかをターゲットに設定して、インプレッションのブランド保護のしきい値を適用できます。verifier は次のいずれかになります。
adloox

object (Adloox)

第三者ブランド検証機関 - Adloox。

doubleVerify

object (DoubleVerify)

第三者ブランド検証機関 - DoubleVerify。

integralAdScience

object (IntegralAdScience)

第三者のブランド検証ツール -- Integral Ad Science

Adloox

Adloox のブランド保護設定の詳細。

JSON 表現
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ],
  "excludedFraudIvtMfaCategories": [
    enum (FraudIvtMfaCategory)
  ],
  "adultExplicitSexualContent": enum (GarmRiskExclusion),
  "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": enum (GarmRiskExclusion),
  "armsAmmunitionContent": enum (GarmRiskExclusion),
  "deathInjuryMilitaryConflictContent": enum (GarmRiskExclusion),
  "debatedSensitiveSocialIssueContent": enum (GarmRiskExclusion),
  "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": enum (GarmRiskExclusion),
  "onlinePiracyContent": enum (GarmRiskExclusion),
  "hateSpeechActsAggressionContent": enum (GarmRiskExclusion),
  "obscenityProfanityContent": enum (GarmRiskExclusion),
  "spamHarmfulContent": enum (GarmRiskExclusion),
  "terrorismContent": enum (GarmRiskExclusion),
  "misinformationContent": enum (GarmRiskExclusion),
  "displayIabViewability": enum (DisplayIabViewability),
  "videoIabViewability": enum (VideoIabViewability)
}
フィールド
excludedAdlooxCategories[]

enum (AdlooxCategory)

除外する Adloox カテゴリ。

excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

省略可。Adloox の不正な IVT MFA カテゴリを除外する。

adultExplicitSexualContent

enum (GarmRiskExclusion)

省略可。除外するアダルト コンテンツと露骨な性的コンテンツの GARM リスク範囲。

crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum (GarmRiskExclusion)

省略可。犯罪や有害な行為に関するコンテンツの GARM リスクの範囲。

armsAmmunitionContent

enum (GarmRiskExclusion)

省略可。除外する武器、弾薬に関するコンテンツの GARM リスク範囲。

deathInjuryMilitaryConflictContent

enum (GarmRiskExclusion)

省略可。除外する死亡、負傷、軍事紛争に関するコンテンツの GARM リスク範囲。

debatedSensitiveSocialIssueContent

enum (GarmRiskExclusion)

省略可。除外する議論が交わされているデリケートな社会問題に関するコンテンツの GARM リスク範囲。

illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum (GarmRiskExclusion)

省略可。除外する違法薬物 / アルコールに関するコンテンツの GARM リスク範囲。

onlinePiracyContent

enum (GarmRiskExclusion)

省略可。除外するインターネット上の著作権侵害のコンテンツの GARM リスク範囲。

hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

省略可。除外するヘイトスピーチ、攻撃行為に関するコンテンツの GARM リスク範囲。

obscenityProfanityContent

enum (GarmRiskExclusion)

省略可。除外すべきわいせつおよび冒とく的なコンテンツの GARM リスク範囲。

spamHarmfulContent

enum (GarmRiskExclusion)

省略可。除外するスパムまたは有害なコンテンツの GARM リスク範囲。

terrorismContent

enum (GarmRiskExclusion)

省略可。除外するテロリスト コンテンツの GARM リスク範囲。

misinformationContent

enum (GarmRiskExclusion)

省略可。除外する誤った情報コンテンツの GARM リスク範囲。

displayIabViewability

enum (DisplayIabViewability)

省略可。ディスプレイ広告の IAB 視認性基準。

videoIabViewability

enum (VideoIabViewability)

省略可。動画広告の IAB 視認可能率のしきい値。

AdlooxCategory

使用可能な Adloox カテゴリ。

列挙型
ADLOOX_UNSPECIFIED Adloox カテゴリが指定されていない場合、またはこのバージョンで不明な場合のデフォルト値。
ADULT_CONTENT_HARD アダルト コンテンツ(ハード)。
ADULT_CONTENT_SOFT アダルト コンテンツ(ソフト)。
ILLEGAL_CONTENT 不正なコンテンツ。
BORDERLINE_CONTENT ガイドラインのボーダーライン上のコンテンツ。
DISCRIMINATORY_CONTENT 差別的なコンテンツ。
VIOLENT_CONTENT_WEAPONS 暴力的なコンテンツと武器。
LOW_VIEWABILITY_DOMAINS 視認性が低いドメイン。
FRAUD 不正行為。

FraudIvtMfaCategory

Adloox の不正行為、無効なトラフィック、マルチ ファクタ認証で使用できるカテゴリ。

列挙型
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED Adloox の不正行為、IVT、MFA の各カテゴリが指定されていない場合、またはこのバージョンで不明な場合のデフォルト値。
FRAUD_IVT_MFA FRAUD、IVT、MFA。

GarmRiskExclusion

利用可能な GARM リスクレベルの除外オプション。

列挙型
GARM_RISK_EXCLUSION_UNSPECIFIED この列挙型は単なるプレースホルダであり、GARM リスク除外オプションは指定していません。
GARM_RISK_EXCLUSION_FLOOR フロア リスクを除外します。
GARM_RISK_EXCLUSION_HIGH 高リスクとフロア リスクを除外します。
GARM_RISK_EXCLUSION_MEDIUM 中程度、高レベル、フロアのリスクを除外します。
GARM_RISK_EXCLUSION_LOW すべてのレベルのリスク(低、中、高、フロア)を除外します。

DisplayIabViewability

Adloox の IAB ディスプレイ視認性で使用できるしきい値。

列挙型
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED 指定されていない場合、またはこのバージョンで不明な場合のデフォルト値。
DISPLAY_IAB_VIEWABILITY_10 10% 以上視認可能(IAB ディスプレイ視認性基準)。
DISPLAY_IAB_VIEWABILITY_20 20% 以上が視認可能(IAB ディスプレイ視認性基準)。
DISPLAY_IAB_VIEWABILITY_35 35% 以上が視認可能(IAB ディスプレイ視認性基準)。
DISPLAY_IAB_VIEWABILITY_50 50%以上が視界内(IAB ディスプレイ視認性基準)。
DISPLAY_IAB_VIEWABILITY_75 75% 以上が視認可能(IAB ディスプレイ視認性基準)。

VideoIabViewability

Adloox で使用可能な IAB 動画視認可能率のしきい値。

列挙型
VIDEO_IAB_VIEWABILITY_UNSPECIFIED 指定されていないか、このバージョンで不明な場合のデフォルト値。
VIDEO_IAB_VIEWABILITY_10 10% 以上視認可能(IAB 動画視認可能率の標準)。
VIDEO_IAB_VIEWABILITY_20 20%以上視認可能(IAB 動画視認性標準)。
VIDEO_IAB_VIEWABILITY_35 35% 以上が視認可能(IAB 動画視認性基準)。
VIDEO_IAB_VIEWABILITY_50 50% 以上が視界内(IAB 動画視認性基準)。
VIDEO_IAB_VIEWABILITY_75 75% 以上が視認可能(IAB 動画視認可能率基準)。

DoubleVerify

DoubleVerify 設定の詳細。

JSON 表現
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
フィールド
brandSafetyCategories

object (BrandSafetyCategories)

DV ブランド保護設定。

avoidedAgeRatings[]

enum (AgeRating)

対象年齢が設定されているアプリへの入札を回避します。

appStarRating

object (AppStarRating)

スター評価のあるアプリへの入札を回避する。

displayViewability

object (DisplayViewability)

ディスプレイの視認性設定(ディスプレイ広告申込情報のみに適用)。

videoViewability

object (VideoViewability)

動画の視認性の設定(動画広告申込情報にのみ適用)。

fraudInvalidTraffic

object (FraudInvalidTraffic)

不正行為や無効なトラフィックの発生率に関する過去のデータがあるサイトやアプリは避ける。

customSegmentId

string (int64 format)

DoubleVerify から提供されたカスタム セグメント ID。ID は「51」で始まり、8 桁の数字になっている必要があります。カスタム セグメント ID は、次のフィールドと同時に指定することはできません。

BrandSafetyCategories

ブランド保護設定。

JSON 表現
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
フィールド
avoidUnknownBrandSafetyCategory

boolean

不明または評価不可。

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

ブランド保護の重大度の高い回避カテゴリ。

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

ブランド保護の中程度の重大度の回避カテゴリ。

HighSeverityCategory

重大度の高いカテゴリに使用できるオプション。

列挙型
HIGHER_SEVERITY_UNSPECIFIED この列挙型はプレースホルダにすぎず、重大度の高いカテゴリは指定されていません。
ADULT_CONTENT_PORNOGRAPHY アダルト コンテンツ: ポルノ、成人向けトピック、ヌード。
COPYRIGHT_INFRINGEMENT 著作権の侵害。
SUBSTANCE_ABUSE 薬物 / アルコール / 規制薬物: 薬物乱用。
GRAPHIC_VIOLENCE_WEAPONS 過激なグラフィック、露骨な暴力、武器。
HATE_PROFANITY ヘイト/冒とく的な表現。
CRIMINAL_SKILLS 違法行為: 犯罪スキル。
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER 報酬の提供、不正なソフトウェア、クラッター。

MediumSeverityCategory

中程度の重大度のカテゴリで使用できるオプション。

列挙型
MEDIUM_SEVERITY_UNSPECIFIED この列挙型はプレースホルダにすぎず、中程度の重大度のカテゴリは指定されていません。
AD_SERVERS 広告サーバー。
ADULT_CONTENT_SWIMSUIT アダルト コンテンツ: 水着。
ALTERNATIVE_LIFESTYLES 物議を醸すテーマ: 代替ライフスタイル。
CELEBRITY_GOSSIP 物議を醸すテーマ: 有名人のゴシップ。
GAMBLING 物議を醸すテーマ: ギャンブル。
OCCULT 物議を醸すテーマ: オカルト。
SEX_EDUCATION 物議を醸すテーマ: 性教育。
DISASTER_AVIATION 災害: 航空機。
DISASTER_MAN_MADE 災害: 人為的。
DISASTER_NATURAL 災害: 自然災害。
DISASTER_TERRORIST_EVENTS 災害: テロ事件。
DISASTER_VEHICLE 災害: 車両。
ALCOHOL 薬物/アルコール/規制薬物: アルコール。
SMOKING 薬物 / アルコール / 規制薬物: 喫煙。
NEGATIVE_NEWS_FINANCIAL 悪いニュース: 金融。
NON_ENGLISH 標準以外のコンテンツ: 英語以外。
PARKING_PAGE 非標準コンテンツ: 駐車場ページ。
UNMODERATED_UGC 管理者なしのユーザー作成コンテンツ: フォーラム、画像、動画。
INFLAMMATORY_POLITICS_AND_NEWS 意見が分かれるテーマ: 扇動的な政治やニュース。
NEGATIVE_NEWS_PHARMACEUTICAL 否定的なニュース: 医薬品。

AgeRating

年齢制限のオプション。

列挙型
AGE_RATING_UNSPECIFIED この列挙型はプレースホルダにすぎず、年齢制限オプションは指定しません。
APP_AGE_RATE_UNKNOWN 対象年齢が不明なアプリ。
APP_AGE_RATE_4_PLUS 全年齢対象(4 歳以上)のアプリ。
APP_AGE_RATE_9_PLUS 9 歳以上を対象とするアプリ。
APP_AGE_RATE_12_PLUS 13 歳以上向けとレーティングされたアプリ。
APP_AGE_RATE_17_PLUS レーティングが M(17 歳以上対象)のアプリ。
APP_AGE_RATE_18_PLUS 成人向け(18 歳以上)のレーティングが付けられているアプリ。

AppStarRating

DoubleVerify 星評価設定の詳細。

JSON 表現
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
フィールド
avoidedStarRating

enum (StarRating)

星評価を使用しているアプリには入札しないようにします。

avoidInsufficientStarRating

boolean

星評価が低いアプリには入札しないようにします。

StarRating

星評価のオプション。

列挙型
APP_STAR_RATE_UNSPECIFIED この列挙型はプレースホルダにすぎず、アプリの星評価オプションは指定しません。
APP_STAR_RATE_1_POINT_5_LESS 公式アプリの星 1.5 個未満。
APP_STAR_RATE_2_LESS 評価が星 2 つ未満の公式アプリ。
APP_STAR_RATE_2_POINT_5_LESS 評価が 2.5 つ星未満の公式アプリ。
APP_STAR_RATE_3_LESS 評価が 3 つ星未満の公式アプリ。
APP_STAR_RATE_3_POINT_5_LESS 評価が 3.5 つ星未満の公式アプリ。
APP_STAR_RATE_4_LESS 星 4 個未満の公式アプリ。
APP_STAR_RATE_4_POINT_5_LESS 評価が 4.5 未満の公式アプリ。

DisplayViewability

DoubleVerify ディスプレイの視認性設定の詳細。

JSON 表現
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
フィールド
iab

enum (IAB)

IAB 視認可能率を最大化するには、ウェブとアプリの広告枠をターゲットに設定します。

viewableDuring

enum (ViewableDuring)

100% 視認可能な時間が最大になるようにウェブとアプリの広告枠をターゲティングする。

IAB

IAB の視認可能率のオプション。

列挙型
IAB_VIEWED_RATE_UNSPECIFIED この列挙型は単なるプレースホルダであり、IAB 視聴率のオプションは指定しません。
IAB_VIEWED_RATE_80_PERCENT_HIGHER IAB 視認可能率が 80% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWED_RATE_75_PERCENT_HIGHER IAB 視認可能率が 75% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWED_RATE_70_PERCENT_HIGHER IAB 視認可能率が 70% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWED_RATE_65_PERCENT_HIGHER IAB 視認可能率が 65% 以上になるように、ウェブとアプリの広告枠をターゲットに設定します。
IAB_VIEWED_RATE_60_PERCENT_HIGHER IAB 視認可能率が 60% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWED_RATE_55_PERCENT_HIGHER IAB 視認可能率が 55% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWED_RATE_50_PERCENT_HIGHER IAB 視認可能率が 50% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWED_RATE_40_PERCENT_HIGHER IAB 視認可能率が 40% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWED_RATE_30_PERCENT_HIGHER IAB 視認可能率が 30% 以上になるように、ウェブとアプリの広告枠をターゲティングします。

ViewableDuring

視聴可能な時間のオプション。

列挙型
AVERAGE_VIEW_DURATION_UNSPECIFIED この列挙型はプレースホルダにすぎず、平均再生時間のオプションは指定しません。
AVERAGE_VIEW_DURATION_5_SEC 5 秒以上の視認可能時間 100% が最大になるように、ウェブとアプリの広告枠をターゲットに設定します。
AVERAGE_VIEW_DURATION_10_SEC 10 秒以上の 100% 視認可能な時間が最大になるように、ウェブとアプリの広告枠をターゲティングします。
AVERAGE_VIEW_DURATION_15_SEC 15 秒以上の 100% 視認可能な時間が最大になるように、ウェブとアプリの広告枠をターゲティングします。

VideoViewability

DoubleVerify の動画視認性の設定の詳細。

JSON 表現
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
フィールド
videoIab

enum (VideoIAB)

IAB 視認可能率を最大化するようにウェブ広告枠をターゲティングします。

videoViewableRate

enum (VideoViewableRate)

ウェブ広告枠をターゲットに設定して、100% 視認可能な広告の割合を最大化します。

playerImpressionRate

enum (PlayerImpressionRate)

プレーヤーのサイズが 400 x 300 以上の広告枠をターゲットに設定して、インプレッションを最大化します。

VideoIAB

IAB の視認可能率のオプション。

列挙型
VIDEO_IAB_UNSPECIFIED この列挙型はプレースホルダにすぎず、動画の IAB 視認可能率オプションは指定しません。
IAB_VIEWABILITY_80_PERCENT_HIGHER IAB 視認可能率が 80% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWABILITY_75_PERCENT_HIGHER IAB 視認可能率が 75% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWABILITY_70_PERCENT_HIGHER IAB 視認可能率が 70% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWABILITY_65_PERCENT_HIHGER IAB 視認可能率が 65% 以上になるように、ウェブとアプリの広告枠をターゲットに設定します。
IAB_VIEWABILITY_60_PERCENT_HIGHER IAB 視認可能率が 60% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWABILITY_55_PERCENT_HIHGER IAB 視認可能率が 55% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWABILITY_50_PERCENT_HIGHER IAB 視認可能率が 50% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWABILITY_40_PERCENT_HIHGER IAB 視認可能率が 40% 以上になるように、ウェブとアプリの広告枠をターゲティングします。
IAB_VIEWABILITY_30_PERCENT_HIHGER IAB 視認可能率が 30% 以上になるように、ウェブとアプリの広告枠をターゲティングします。

VideoViewableRate

完全視認率のオプション。

列挙型
VIDEO_VIEWABLE_RATE_UNSPECIFIED この列挙型はプレースホルダにすぎず、動画の視聴可能率のオプションは指定されません。
VIEWED_PERFORMANCE_40_PERCENT_HIGHER ウェブ広告枠をターゲットに設定して、視認可能率 40% 以上を最大化します。
VIEWED_PERFORMANCE_35_PERCENT_HIGHER ウェブ広告枠をターゲットに設定し、35% 以上の完全視認率を最大化します。
VIEWED_PERFORMANCE_30_PERCENT_HIGHER ウェブ広告枠をターゲティングして、完全に視認可能な率を 30% 以上に最大化します。
VIEWED_PERFORMANCE_25_PERCENT_HIGHER ウェブ広告枠をターゲティングして、完全視認率 25% 以上を最大化します。
VIEWED_PERFORMANCE_20_PERCENT_HIGHER 完全視認可能率が 20% 以上最大になるようにウェブ広告枠をターゲットに設定します。
VIEWED_PERFORMANCE_10_PERCENT_HIGHER ウェブ広告枠をターゲティングして、10% 以上の完全視認率を最大化します。

PlayerImpressionRate

インプレッションのオプション。

列挙型
PLAYER_SIZE_400X300_UNSPECIFIED この列挙型はプレースホルダにすぎず、インプレッション オプションは指定しません。
PLAYER_SIZE_400X300_95 インプレッションの 95% 以上が取得されたサイト。
PLAYER_SIZE_400X300_70 インプレッションの 70%以上を占めるサイト。
PLAYER_SIZE_400X300_25 インプレッションの 25%以上を占めるサイト。
PLAYER_SIZE_400X300_5 インプレッションの 5%以上を占めるサイト。

FraudInvalidTraffic

DoubleVerify の不正行為と無効なトラフィックの設定。

JSON 表現
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
フィールド
avoidedFraudOption

enum (FraudOption)

不正行為や無効なトラフィックの発生率に関する過去のデータがあるサイトやアプリは回避します。

avoidInsufficientOption

boolean

不正行為と無効なトラフィックに関する過去の統計情報が不十分。

FraudOption

過去の不正行為と無効なトラフィックの発生率のオプション。

列挙型
FRAUD_UNSPECIFIED この列挙型はプレースホルダにすぎず、不正行為や無効なトラフィックのオプションは指定されていません。
AD_IMPRESSION_FRAUD_100 不正行為や無効なトラフィックの発生率が 100% です。
AD_IMPRESSION_FRAUD_50 不正行為や無効なトラフィックの発生率が 50% 以上。
AD_IMPRESSION_FRAUD_25 不正行為や無効なトラフィックの発生率が 25% 以上。
AD_IMPRESSION_FRAUD_10 不正行為や無効なトラフィックの発生率が 10% 以上。
AD_IMPRESSION_FRAUD_8 不正行為や無効なトラフィックの発生率が 8% 以上。
AD_IMPRESSION_FRAUD_6 不正行為や無効なトラフィックの発生率が 6% 以上。
AD_IMPRESSION_FRAUD_4 不正行為や無効なトラフィックの発生率が 4% 以上。
AD_IMPRESSION_FRAUD_2 不正行為や無効なトラフィックの発生率が 2% 以上。

IntegralAdScience

Integral Ad Science の設定の詳細。

JSON 表現
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
フィールド
traqScoreOption

enum (TRAQScore)

実際の広告品質(ディスプレイ広告申込情報にのみ適用)。

excludeUnrateable

boolean

ブランド保護 - 評価不可

excludedAdultRisk

enum (Adult)

ブランド保護 - アダルト コンテンツ

excludedAlcoholRisk

enum (Alcohol)

ブランド保護 - アルコール

excludedIllegalDownloadsRisk

enum (IllegalDownloads)

ブランド保護 - 違法なダウンロード

excludedDrugsRisk

enum (Drugs)

ブランド保護 - 薬物

excludedHateSpeechRisk

enum (HateSpeech)

ブランド保護 - ヘイトスピーチ

excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

ブランド保護 - 不適切な表現

excludedViolenceRisk

enum (Violence)

ブランド保護 - 暴力

excludedGamblingRisk

enum (Gambling)

ブランド保護 - ギャンブル

excludedAdFraudRisk

enum (AdFraudPrevention)

広告の不正行為の設定。

displayViewability

enum (DisplayViewability)

ディスプレイの視認性セクション(ディスプレイ広告申込情報にのみ適用)。

videoViewability

enum (VideoViewability)

動画の視認性セクション(動画広告申込情報のみに適用)。

customSegmentId[]

string (int64 format)

Integral Ad Science から提供されたカスタム セグメント ID。ID は 10000011999999 の範囲で指定してください。

TRAQScore

Integral Ad Science の TRAQ(実際の広告品質)スコアの範囲。

列挙型
TRAQ_UNSPECIFIED この列挙型はプレースホルダにすぎず、実際の広告品質スコアは指定しません。
TRAQ_250 TRAQ スコア 250~1,000。
TRAQ_500 TRAQ スコアは 500 ~ 1,000 です。
TRAQ_600 TRAQ スコアは 600 ~ 1,000 です。
TRAQ_700 TRAQ スコア 700~1,000。
TRAQ_750 TRAQ スコアは 750 ~ 1,000 です。
TRAQ_875 TRAQ スコア 875~1,000。
TRAQ_1000 TRAQ スコア 1,000。

アダルト

Integral Ad Science のアダルト向けオプション。

列挙型
ADULT_UNSPECIFIED この列挙型は単なるプレースホルダであり、アダルト オプションを指定しません。
ADULT_HR アダルト - 高いリスクを除外。
ADULT_HMR アダルト - 高リスクと中程度のリスクを除外します。

アルコール

Integral Ad Science のアルコールに関するオプション。

列挙型
ALCOHOL_UNSPECIFIED この列挙型はプレースホルダにすぎず、アルコールのオプションは指定しません。
ALCOHOL_HR アルコール - 高いリスクを除外します。
ALCOHOL_HMR アルコール - 高リスクと中程度のリスクを除外します。

IllegalDownloads

Integral Ad Science の不正ダウンロードの可能性に関するオプション。

列挙型
ILLEGAL_DOWNLOADS_UNSPECIFIED この列挙型はプレースホルダにすぎず、違法なダウンロード オプションは指定しません。
ILLEGAL_DOWNLOADS_HR 違法ダウンロード - 高リスクを除外します。
ILLEGAL_DOWNLOADS_HMR 違法なダウンロード - 高いリスクと中程度のリスクを除外します。

薬物

Integral Ad Science の薬物関連オプション。

列挙型
DRUGS_UNSPECIFIED この列挙型はプレースホルダにすぎず、薬物オプションは指定しません。
DRUGS_HR 薬物 - 高リスクを除外します。
DRUGS_HMR 薬物 - 高リスクと中程度のリスクを除外します。

HateSpeech

Integral Ad Science ヘイトスピーチのオプション

列挙型
HATE_SPEECH_UNSPECIFIED この列挙型はプレースホルダにすぎず、ヘイトスピーチのオプションは指定しません。
HATE_SPEECH_HR ヘイトスピーチ - 高いリスクを除外する。
HATE_SPEECH_HMR ヘイトスピーチ - 高リスクと中程度のリスクを除外します。

OffensiveLanguage

Integral Ad Science の不適切な表現のオプション。

列挙型
OFFENSIVE_LANGUAGE_UNSPECIFIED この列挙型は単なるプレースホルダであり、言語オプションは指定しません。
OFFENSIVE_LANGUAGE_HR 攻撃的な表現 - 高いリスクを除外します。
OFFENSIVE_LANGUAGE_HMR 不適切な表現 - 高リスクと中程度のリスクを除外します。

暴力

Integral Ad Science の暴力に関する可能性のあるオプション。

列挙型
VIOLENCE_UNSPECIFIED この列挙型はプレースホルダにすぎず、暴力的なオプションは指定しません。
VIOLENCE_HR 暴力 - 高リスクを除外します。
VIOLENCE_HMR 暴力 - 高リスクと中リスクを除外する。

ギャンブル

Integral Ad Science のギャンブル関連のオプション。

列挙型
GAMBLING_UNSPECIFIED この列挙型はプレースホルダにすぎず、ギャンブル オプションは指定しません。
GAMBLING_HR ギャンブル - 高リスクを除外します。
GAMBLING_HMR ギャンブル - 高リスクと中リスクを除外する。

AdFraudPrevention

Integral Ad Science の広告不正防止オプション。

列挙型
SUSPICIOUS_ACTIVITY_UNSPECIFIED この列挙型はプレースホルダにすぎず、広告不正防止オプションは指定しません。
SUSPICIOUS_ACTIVITY_HR 広告の不正行為 - 高リスクを除外。
SUSPICIOUS_ACTIVITY_HMR 広告の不正行為 - 高リスクと中リスクを除外します。

DisplayViewability

Integral Ad Science ディスプレイの視認性オプション。

列挙型
PERFORMANCE_VIEWABILITY_UNSPECIFIED この列挙型はプレースホルダにすぎず、表示視認性のオプションは指定しません。
PERFORMANCE_VIEWABILITY_40 視認可能率 40% 以上をターゲットに設定します。
PERFORMANCE_VIEWABILITY_50 視認可能率 50% 以上をターゲットとする。
PERFORMANCE_VIEWABILITY_60 視認可能率 60% 以上をターゲットに設定します。
PERFORMANCE_VIEWABILITY_70 視認性が 70% 以上になるように設定します。

VideoViewability

Integral Ad Science の動画視認性のオプション。

列挙型
VIDEO_VIEWABILITY_UNSPECIFIED この列挙型は単なるプレースホルダであり、動画の視認性に関するオプションは指定しません。
VIDEO_VIEWABILITY_40 視認率 40% 以上(IAB 動画視認可能率の標準)。
VIDEO_VIEWABILITY_50 50% 以上が視界内(IAB 動画視認性基準)。
VIDEO_VIEWABILITY_60 60% 以上が視認可能(IAB 動画視認可能率の標準)。
VIDEO_VIEWABILITY_70 70%以上(IAB 動画視認性標準)。

PoiAssignedTargetingOptionDetails

割り当てられたスポット ターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_POI の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
フィールド
displayName

string

出力専用。スポットの表示名(例: 「タイムズ スクエア」、「スペースニードル」)と、完全な住所(利用可能な場合)

targetingOptionId

string

必須。TARGETING_TYPE_POI 型の TargetingOptiontargetingOptionId

使用できるスポット ターゲティング オプション ID は、targetingTypes.targetingOptions.search を使用して取得できます。

住所やスポット名から削除された特定の緯度と経度の座標をターゲットとする場合は、目的の座標値を小数点以下 6 桁に丸めて小数点を削除し、文字列値をセミコロンで区切って連結することで、必要なターゲティング オプション ID を生成できます。たとえば、ターゲティング オプション ID「40741469;-74003387」を使用すると、緯度 / 経度のペア「40.7414691, -74.003387」をターゲットに設定できます。作成時に、このフィールドの値は更新され、緯度と経度の座標のみが指定されている場合はセミコロンと英数字のハッシュ値が追加されます。

latitude

number

出力専用。スポットの緯度は、小数点第 6 位に四捨五入されます。

longitude

number

出力専用。スポットの経度(小数点第 6 位まで四捨五入)。

proximityRadiusAmount

number

必須。ターゲットとなるスポット周辺の半径。半径の単位は proximityRadiusUnit で指定します。単位が DISTANCE_UNIT_KILOMETERS の場合は 1 ~ 800、単位が DISTANCE_UNIT_MILES の場合は 1 ~ 500 にする必要があります。

proximityRadiusUnit

enum (DistanceUnit)

必須。半径の単位です。

DistanceUnit

可能な距離の単位オプション。

列挙型
DISTANCE_UNIT_UNSPECIFIED このバージョンでタイプ値が指定されていないか、不明です。
DISTANCE_UNIT_MILES マイル。
DISTANCE_UNIT_KILOMETERS km] を選択します。

BusinessChainAssignedTargetingOptionDetails

割り当てられたビジネス チェーンのターゲティング オプションの詳細。これは、targetingTypeTARGETING_TYPE_BUSINESS_CHAIN の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
フィールド
displayName

string

出力専用。ビジネス チェーンの表示名(「KFC」、「Chase Bank」など)。

targetingOptionId

string

必須。TARGETING_TYPE_BUSINESS_CHAIN 型の TargetingOptiontargetingOptionId

使用可能なビジネス チェーン ターゲティング オプション ID は、SearchTargetingOptions を使用して取得できます。

proximityRadiusAmount

number

必須。ターゲットとするビジネス チェーン周辺のエリアの半径。半径の単位は proximityRadiusUnit で指定します。単位が DISTANCE_UNIT_KILOMETERS の場合は 1~800、単位が DISTANCE_UNIT_MILES の場合は 1~500 にする必要があります。どちらの場合も、最小増分は 0.1 です。入力値が細かすぎる場合は、最も近い許容値に丸められます(15.57 は 15.6 になります)。

proximityRadiusUnit

enum (DistanceUnit)

必須。ターゲティング半径を測定する距離の単位。

ContentDurationAssignedTargetingOptionDetails

コンテンツの長さに割り当てられたターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_CONTENT_DURATION の場合、この値は contentDurationDetails フィールドに入力されます。すべてのオプションを明示的にターゲティングすることはできません。この効果を実現するには、コンテンツの長さのターゲティング オプションをすべて削除します。

JSON 表現
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
フィールド
targetingOptionId

string

必須。targetingTypeTARGETING_TYPE_CONTENT_DURATION の場合の targetingOptionId フィールド。

contentDuration

enum (ContentDuration)

出力専用。コンテンツの再生時間。

ContentStreamTypeAssignedTargetingOptionDetails

コンテンツ ストリーミングのタイプに割り当てられたターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE の場合、この値は contentStreamTypeDetails フィールドに入力されます。すべてのオプションを明示的にターゲティングすることはできません。この効果を実現するには、コンテンツ ストリーム タイプのターゲティング オプションをすべて削除します。

JSON 表現
{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}
フィールド
targetingOptionId

string

必須。targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE の場合の targetingOptionId フィールド。

contentStreamType

enum (ContentStreamType)

出力専用。コンテンツ ストリームのタイプ。

NativeContentPositionAssignedTargetingOptionDetails

ネイティブ コンテンツの位置に割り当てられているターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION の場合、この値は nativeContentPositionDetails フィールドに入力されます。すべてのオプションを明示的にターゲティングすることはできません。この効果を実現するには、ネイティブ コンテンツの位置ターゲティング オプションをすべて削除します。

JSON 表現
{
  "contentPosition": enum (NativeContentPosition)
}
フィールド
contentPosition

enum (NativeContentPosition)

必須。コンテンツの位置。

OmidAssignedTargetingOptionDetails

ターゲット設定可能な Open Measurement が有効になっている広告枠タイプを表します。これは、targetingTypeTARGETING_TYPE_OMID の場合に、AssignedTargetingOption の details フィールドに入力されます。

JSON 表現
{
  "omid": enum (Omid)
}
フィールド
omid

enum (Omid)

必須。Open Measurement が有効な広告枠のタイプ。

AudioContentTypeAssignedTargetingOptionDetails

オーディオ コンテンツ タイプに割り当てられたターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE の場合、この値は audioContentTypeDetails フィールドに入力されます。すべてのオプションを明示的にターゲティングすることはできません。この効果を実現するには、オーディオ コンテンツ タイプのターゲティング オプションをすべて削除します。

JSON 表現
{
  "audioContentType": enum (AudioContentType)
}
フィールド
audioContentType

enum (AudioContentType)

必須。オーディオ コンテンツ タイプ。

ContentGenreAssignedTargetingOptionDetails

コンテンツ ジャンルに割り当てられたターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_CONTENT_GENRE の場合、この値は contentGenreDetails フィールドに入力されます。すべてのオプションを明示的にターゲティングすることはできません。この効果を実現するには、コンテンツ ジャンルのターゲティング オプションをすべて削除します。

JSON 表現
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
フィールド
targetingOptionId

string

必須。targetingTypeTARGETING_TYPE_CONTENT_GENRE の場合の targetingOptionId フィールド。

displayName

string

出力専用。コンテンツ ジャンルの表示名。

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。

YoutubeVideoAssignedTargetingOptionDetails

YouTube 動画に割り当てられたターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_YOUTUBE_VIDEO の場合、これは youtubeVideoDetails フィールドに入力されます。

JSON 表現
{
  "videoId": string,
  "negative": boolean
}
フィールド
videoId

string

YouTube 動画 ID(YouTube の動画再生ページに表示される ID)。

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。

YoutubeChannelAssignedTargetingOptionDetails

YouTube チャンネルに割り当てられているターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_YOUTUBE_CHANNEL の場合、この値は youtubeChannelDetails フィールドに入力されます。

JSON 表現
{
  "channelId": string,
  "negative": boolean
}
フィールド
channelId

string

YouTube アップロードしたユーザーのチャンネル ID または YouTube チャンネルのチャンネル コード。

negative

boolean

このオプションが除外ターゲティングされているかどうかを示します。

SessionPositionAssignedTargetingOptionDetails

セッションの位置情報に基づくターゲティング オプションの詳細。targetingTypeTARGETING_TYPE_SESSION_POSITION の場合、この値は sessionPositionDetails フィールドに入力されます。

JSON 表現
{
  "sessionPosition": enum (SessionPosition)
}
フィールド
sessionPosition

enum (SessionPosition)

セッションで広告が表示される位置。

SessionPosition

セッション内の指定可能な位置。

列挙型
SESSION_POSITION_UNSPECIFIED これはプレースホルダであり、位置を示すものではありません。
SESSION_POSITION_FIRST_IMPRESSION セッションの第一印象。

メソッド

get

広告グループに割り当てられているターゲティング オプションを 1 つ取得します。

list

広告グループに割り当てられているターゲティング オプションを一覧表示します。