REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

リソース: AssignedTrackingOption

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。割り当てられているターゲティング オプションに関する詳細情報。詳細に入力できるフィールドは 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 の場合に入力されます。

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

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

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

1 つのリソースには、最大 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)

コンテンツの再生時間の詳細。このフィールドは、TargetType が 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 の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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

string (int64 format)

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

negative

boolean

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

AppCategoryAssignedTargetingOptionDetails

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

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

string

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

targetingOptionId

string

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

negative

boolean

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

AppAssignedTargetingOptionDetails

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

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

string

必須。アプリの ID。

Android の 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 プラットフォームである。

UrlAssignedTargetingOptionDetails

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

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(1 日の始まり)~ 23(1 日の終わりの 1 時間前)の値にする必要があります。

endHour

integer

必須。曜日と時間のターゲティングの終了時刻。1(1 日の開始時間の 1 時間後)~ 24(1 日の終わり)の値にする必要があります。

timeZoneResolution

enum (TimeZoneResolution)

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

DayOfWeek

曜日を表します。

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

TimeZoneResolution

タイムゾーンの解決方法。

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

AgeRangeAssignedTargetingOptionDetails

ターゲットに設定できる年齢層を表します。targetingTypeTARGETING_TYPE_AGE_RANGE の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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

enum (AgeRange)

必須。オーディエンスの年齢層。特定の年齢層のユーザーのみターゲティングできます。したがって、このフィールドで表される年齢層は、1)単独で、または 2)より大きな連続した年齢層の一部をターゲットにすることができます。継続的な年齢層ターゲティングでは、年齢不明のオーディエンスもターゲティングすることでリーチを拡大できます。

RegionalLocationListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

negative

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

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

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 の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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 の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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 の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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

enum (DeviceType)

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

youtubeAndPartnersBidMultiplier

number

出力のみ。入札単価調整比を使用すると、デバイスの種類に応じて広告の表示頻度を調整できます。元の入札単価に乗数が適用されます。このフィールドが 0 の場合は、元の入札価格に 0 を乗算する代わりに、このフィールドを適用できないことを示します。

たとえば、調整比なしの入札単価が 1, 000 円で、調整比が 1.5 の場合、タブレットの入札単価は 1, 500 円になります。

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

AudienceGroupAssignedTargetingOptionDetails

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

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

object (FirstAndThirdPartyAudienceGroup)

含まれているファースト パーティおよび第三者オーディエンス グループの自社オーディエンス ID とリピート間隔。ファースト パーティとサードパーティの各オーディエンス グループには、ファースト パーティとサードパーティのオーディエンス ID のみが含まれます。自社オーディエンス グループと第三者オーディエンス グループの関係は INTERSECTION で、その結果は他のオーディエンス グループと UNION で結合されます。同じ設定の繰り返しグループは無視されます。

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

includedCustomListGroup

object (CustomListGroup)

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

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

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

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

除外された自社および第三者のオーディエンス グループの自社および第三者のオーディエンス ID とリピート間隔。ターゲット除外に使用されます。このグループと他の除外されたオーディエンス グループの UNION を結合したものが、非除外オーディエンス ターゲティングの「INTERSECTION」として使用されます。すべての項目は、互いに論理的に「OR」の関係で結ばれます。

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

除外された Google オーディエンス グループの Google オーディエンス ID。ターゲット除外に使用されます。このグループと他の除外されたオーディエンス グループの UNION を結合したものが、非除外オーディエンス ターゲティングの「INTERSECTION」として使用されます。アフィニティ、購買意向の強いオーディエンス、インストール済みアプリタイプの 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 つ以下にする必要があります。5 つを超えるとエラーがスローされます。

CombinedAudienceTargetingSetting

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

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

string (int64 format)

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

BrowserAssignedTargetingOptionDetails

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

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

string

出力のみ。ブラウザの表示名。

targetingOptionId

string

必須。TARGETING_TYPE_BROWSER 型の TargetingOptiontargetingOptionId

negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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 の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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 の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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

string

必須。キーワード(例: car insurance)。

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

negative

boolean

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

NegativeKeywordListAssignedTargetingOptionDetails

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

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 の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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

enum (Environment)

必須。サービス環境。

InventorySourceAssignedTargetingOptionDetails

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

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 の場合に、AssignedTrackingOption の viewabilityDetails フィールドに入力されます。

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

enum (Viewability)

必須。予測される視認可能率です。

AuthorizedSellerStatusAssignedTargetingOptionDetails

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

リソースにターゲティング オプション 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 の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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

string

出力のみ。言語の表示名(「フランス語」)。

targetingOptionId

string

必須。TARGETING_TYPE_LANGUAGE 型の TargetingOptiontargetingOptionId

negative

boolean

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

GeoRegionAssignedTargetingOptionDetails

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

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

string

出力のみ。地理的地域の表示名(例:「オンタリオ州、カナダ」)を入力します。

targetingOptionId

string

必須。TARGETING_TYPE_GEO_REGION 型の TargetingOptiontargetingOptionId

geoRegionType

enum (GeoRegionType)

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

negative

boolean

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

InventorySourceGroupAssignedTargetingOptionDetails

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

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

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

必須。除外対象として分類されるディスプレイ&ビデオ 360 のデリケートなカテゴリのコンテンツを示す列挙型。

ExchangeAssignedTargetingOptionDetails

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

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

enum (Exchange)

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

SubExchangeAssignedTargetingOptionDetails

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

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

string

必須。TARGETING_TYPE_SUB_EXCHANGE 型の TargetingOptiontargetingOptionId

ThirdPartyVerifierAssignedTargetingOptionDetails

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

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)
  ]
}
フィールド
excludedAdlooxCategories[]

enum (AdlooxCategory)

Adloox のブランド保護設定。

AdlooxCategory

指定可能な Adloox オプション。

列挙型
ADLOOX_UNSPECIFIED この列挙型はプレースホルダであり、Adloox オプションは指定されていません。
ADULT_CONTENT_HARD アダルト コンテンツ(ハード)。
ADULT_CONTENT_SOFT アダルト コンテンツ(ソフト)。
ILLEGAL_CONTENT 不正なコンテンツ。
BORDERLINE_CONTENT ボーダーライン上のコンテンツ。
DISCRIMINATORY_CONTENT 差別的なコンテンツ。
VIOLENT_CONTENT_WEAPONS 暴力的なコンテンツと武器および兵器。
LOW_VIEWABILITY_DOMAINS 視認性が低いドメイン。
FRAUD 不正行為。

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 12 歳以上のお子様を対象とするアプリ。
APP_AGE_RATE_17_PLUS 成人向け(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 ウェブとアプリの広告枠をターゲットに設定して、視認可能な時間 100% が最大 5 秒以上になるようにします。
AVERAGE_VIEW_DURATION_10_SEC ウェブとアプリの広告枠をターゲットに設定して、視認可能な時間 100% が最大 10 秒以上になるようにします。
AVERAGE_VIEW_DURATION_15_SEC ウェブとアプリの広告枠をターゲットに設定して、視認可能な時間 100% が最大 15 秒以上になるようにします。

VideoViewability

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

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

enum (VideoIAB)

IAB 視認可能率を最大化するようにウェブ広告枠をターゲットに設定します。

videoViewableRate

enum (VideoViewableRate)

完全視認可能率を最大化するには、ウェブ広告枠をターゲットに設定します。

playerImpressionRate

enum (PlayerImpressionRate)

400×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

過去の不正行為と IVT の割合のオプション。

列挙型
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。

Adult

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 の候補。

列挙型
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 の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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 の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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 の場合、これは AssignedTrackingOption の詳細フィールドに入力されます。

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 動画再生ページに表示される 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 セッションの第一印象。

Methods

get

キャンペーンに割り当てられた 1 つのターゲティング オプションを取得します。

list

指定したターゲティング タイプのキャンペーンに割り当てられたターゲティング オプションの一覧を表示します。