REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

string (int64 format)

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

boolean

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

string

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

string

必須。targetingType が TARGETING_TYPE_APP_CATEGORY の場合の targetingOptionId フィールド。

boolean

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

string

必須。アプリの ID。

Android の Google Play ストア アプリはバンドル ID（com.google.android.gm など）を使用します。Apple の App Store のアプリ ID では 9 桁の文字列（例: 422689480）が使用されます。

string

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

boolean

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

enum (AppPlatform)

ターゲット アプリのプラットフォームを示します。このフィールドが指定されていない場合、アプリのプラットフォームはモバイル（Android や iOS など）として識別され、アプリ ID から適切なモバイル プラットフォームが導出されます。

string

必須。URL（example.com など）。

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

boolean

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

enum (DayOfWeek)

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

integer

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

integer

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

enum (TimeZoneResolution)

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

enum (AgeRange)

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

string (int64 format)

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

boolean

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

string (int64 format)

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

number

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

enum (ProximityRadiusUnit)

必須。半径距離の単位。

enum (Gender)

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

enum (VideoPlayerSize)

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

string

必須。targetingType が TARGETING_TYPE_USER_REWARDED_CONTENT の場合の targetingOptionId フィールド。

enum (UserRewardedContent)

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

enum (ParentalStatus)

必須。オーディエンスの子供の有無。

enum (ContentInstreamPosition)

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

enum (AdType)

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

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

enum (ContentOutstreamPosition)

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

enum (AdType)

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

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

enum (DeviceType)

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

number

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

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

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

object (FirstAndThirdPartyAudienceGroup)

含まれる自社オーディエンスと第三者オーディエンス グループの自社オーディエンス ID と第三者オーディエンス ID と期限。各ファースト パーティ オーディエンス グループとサードパーティ オーディエンス グループには、ファースト パーティ オーディエンス ID とサードパーティ オーディエンス ID のみが含まれます。各ファーストパーティ オーディエンス グループとサードパーティ オーディエンス グループの関係は「交差」で、その結果は他のオーディエンス グループと「結合」されます。同じ設定のグループが重複する場合、重複したグループは無視されます。

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

除外された自社オーディエンスと第三者オーディエンス グループの自社オーディエンス ID と第三者オーディエンス ID と期限。ターゲット除外に使用されます。このグループと他の除外されたオーディエンス グループの UNION 「COMPLEMENT」が、すべての非除外オーディエンス ターゲティングへの結合として使用されます。すべてのアイテムは、互いに論理的に「OR」となります。

object (GoogleAudienceGroup)

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

object (FirstAndThirdPartyAudienceTargetingSetting)

必須。自社と第三者のオーディエンス グループの、自社と第三者のすべてのオーディエンス ターゲティング設定。同じ ID の設定を繰り返すことはできません。

string (int64 format)

必須。ファースト パーティ オーディエンスとサードパーティ オーディエンスのターゲティング設定のファースト パーティ オーディエンスとサードパーティ オーディエンスの ID。この ID は firstAndThirdPartyAudienceId です。

enum (Recency)

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

object (GoogleAudienceTargetingSetting)

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

string (int64 format)

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

object (CustomListTargetingSetting)

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

string (int64 format)

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

object (CombinedAudienceTargetingSetting)

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

string (int64 format)

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

string

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

string

必須。TARGETING_TYPE_BROWSER 型の TargetingOption の targetingOptionId。

boolean

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

enum (HouseholdIncome)

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

string

必須。targetingType が TARGETING_TYPE_ON_SCREEN_POSITION の場合の targetingOptionId フィールド。

enum (OnScreenPosition)

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

enum (AdType)

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

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

string

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

string

必須。TARGETING_TYPE_CARRIER_AND_ISP 型の TargetingOption の targetingOptionId。

boolean

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

string

必須。キーワード（例: car insurance）。

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

boolean

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

string (int64 format)

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

string

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

string

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

boolean

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

string

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

string

必須。targetingType が TARGETING_TYPE_DEVICE_MAKE_MODEL の場合の targetingOptionId フィールド。

boolean

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

enum (Environment)

必須。サービング環境。

string (int64 format)

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

string

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

string

必須。targetingType が TARGETING_TYPE_CATEGORY の場合の targetingOptionId フィールド。

boolean

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

enum (Viewability)

必須。視認性の予測値（%）。

enum (AuthorizedSellerStatus)

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

string

必須。TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 型の TargetingOption の targetingOptionId。

string

出力専用。言語の表示名（「フランス語」）を入力します。

string

必須。TARGETING_TYPE_LANGUAGE 型の TargetingOption の targetingOptionId。

boolean

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

string

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

string

必須。TARGETING_TYPE_GEO_REGION 型の TargetingOption の targetingOptionId。

enum (GeoRegionType)

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

boolean

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

string (int64 format)

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

enum (ContentRatingTier)

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

enum (SensitiveCategory)

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

enum (Exchange)

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

string

必須。TARGETING_TYPE_SUB_EXCHANGE 型の TargetingOption の targetingOptionId。

object (Adloox)

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

object (DoubleVerify)

第三者ブランド確認機能 -- DoubleVerify。

object (IntegralAdScience)

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

enum (AdlooxCategory)

Adloox のブランド保護設定。

object (BrandSafetyCategories)

DV ブランド保護設定

enum (AgeRating)

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

object (AppStarRating)

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

object (DisplayViewability)

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

object (VideoViewability)

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

object (FraudInvalidTraffic)

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

string (int64 format)

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

• brandSafetyCategories
• avoidedAgeRatings
• appStarRating
• fraudInvalidTraffic

boolean

不明または評価不能。

enum (HighSeverityCategory)

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

enum (MediumSeverityCategory)

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

enum (StarRating)

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

boolean

スター評価が十分でないアプリには入札しないでください。

enum (IAB)

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

enum (ViewableDuring)

100% 視認可能な状態が最大になるように、ウェブとアプリの広告枠をターゲットに設定します。

enum (VideoIAB)

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

enum (VideoViewableRate)

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

enum (PlayerImpressionRate)

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

enum (FraudOption)

過去に不正行為や無効なトラフィック。

boolean

不正行為や無効なトラフィックの発生率に関する統計データが不明。

enum (TRAQScore)

真の広告品質（ディスプレイ広告申込情報のみに適用）。

boolean

ブランド保護 - 評価不可。

enum (Adult)

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

enum (Alcohol)

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

enum (IllegalDownloads)

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

enum (Drugs)

ブランド保護 - 薬物。

enum (HateSpeech)

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

enum (OffensiveLanguage)

ブランド保護 - 攻撃的な表現。

enum (Violence)

ブランド保護 - 暴力。

enum (Gambling)

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

enum (AdFraudPrevention)

広告の不正行為の設定。

enum (DisplayViewability)

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

enum (VideoViewability)

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

string (int64 format)

Integral Ad Science が提供するカスタム セグメント ID。ID は 1000001～1999999 の値にする必要があります。

string

出力専用。スポットの表示名（例:「タイムズ スクエア」、「スペース ニードル」、詳細な住所（ある場合）

string

必須。TARGETING_TYPE_POI 型の TargetingOption の targetingOptionId。

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

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

number

出力専用。スポットの緯度（小数点以下 6 桁）。

number

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

number

必須。ターゲットに設定するスポットを中心とした地域の半径です。半径の単位は proximityRadiusUnit で指定します。単位が DISTANCE_UNIT_KILOMETERS の場合は 1～800、単位が DISTANCE_UNIT_MILES の場合は 1～500 にする必要があります。

enum (DistanceUnit)

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

string

出力専用。ビジネス チェーンの表示名（例: 「KFC」、「Chase Bank」）。

string

必須。TARGETING_TYPE_BUSINESS_CHAIN 型の TargetingOption の targetingOptionId。

承認済みのビジネス チェーン ターゲティング オプション ID は、SearchTargetingOptions を使って取得できます。

number

必須。ターゲットに設定するビジネス チェーンを中心とした地域の半径です。半径の単位は proximityRadiusUnit で指定します。単位が DISTANCE_UNIT_KILOMETERS の場合は 1～800、単位が DISTANCE_UNIT_MILES の場合は 1～500 にする必要があります。どちらの場合も、最小増分は 0.1 です。入力値が細かすぎる場合は、最も近い許容値に丸められます（15.57 は 15.6 になります）。

enum (DistanceUnit)

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

string

必須。targetingType が TARGETING_TYPE_CONTENT_DURATION の場合の targetingOptionId フィールド。

enum (ContentDuration)

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

string

必須。targetingType が TARGETING_TYPE_CONTENT_STREAM_TYPE の場合の targetingOptionId フィールド。

enum (ContentStreamType)

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

enum (NativeContentPosition)

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

enum (Omid)

必須。Open Measurement が有効になっている広告枠のタイプ。

enum (AudioContentType)

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

string

必須。targetingType が TARGETING_TYPE_CONTENT_GENRE の場合の targetingOptionId フィールド。

string

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

boolean

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

string

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

boolean

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

string

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

boolean

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

enum (SessionPosition)

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