REST Resource: advertisers.lineItems

リソース: SENDER

単一の広告申込情報。

JSON 表現 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  }
}
フィールド
name

string

出力のみ。広告申込情報のリソース名。
advertiserId

string (int64 format)

出力のみ。広告申込情報が属する広告主の一意の ID。
campaignId

string (int64 format)

出力のみ。広告申込情報が属するキャンペーンの一意の ID。
insertionOrderId

string (int64 format)

必須。変更不可。広告申込情報が属する広告掲載オーダーの一意の ID。
lineItemId

string (int64 format)

出力のみ。広告申込情報の一意の ID。システムによって割り当てられます。
displayName

string

必須。広告申込情報の表示名。

UTF-8 でエンコードする必要があります。最大サイズは 240 バイトです。
lineItemType

enum (LineItemType)

必須。変更不可。広告申込情報のタイプ。
entityStatus

enum (EntityStatus)

必須。広告申込情報で予算を消化して広告枠に入札できるようにするかどうかを指定します。

  • lineItems.create メソッドの場合、ENTITY_STATUS_DRAFT のみを使用できます。広告申込情報を有効にするには、lineItems.patch メソッドを使用して、作成後にステータスを ENTITY_STATUS_ACTIVE に更新します。
  • 広告申込情報を他のステータスから ENTITY_STATUS_DRAFT ステータスに戻すことはできません。
  • 広告申込情報の親広告掲載オーダーが有効でない場合、その広告申込情報のステータスは ENTITY_STATUS_ACTIVE であっても予算を使うことはできません。
updateTime

string (Timestamp format)

出力のみ。広告申込情報が最後に更新されたときのタイムスタンプ。システムによって割り当てられます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
partnerCosts[]

object (PartnerCost)

広告申込情報に関連付けられたパートナー費用。

lineItems.create メソッドで指定しないか空の場合、新しく作成された広告申込情報は親の広告掲載オーダーからパートナー費用を継承します。
flight

object (LineItemFlight)

必須。広告申込情報の掲載期間の開始時間と終了時間。
budget

object (LineItemBudget)

必須。広告申込情報の予算割り当て設定。
pacing

object (Pacing)

必須。広告申込情報の予算支出速度設定。
frequencyCap

object (FrequencyCap)

必須。広告申込情報のインプレッションのフリークエンシー キャップ設定。

制限付きの上限を割り当てる場合は、この設定オブジェクトの maxImpressions フィールドを使用する必要があります。
partnerRevenueModel

object (PartnerRevenueModel)

必須。広告申込情報のパートナー収益モデル設定。
conversionCounting

object (ConversionCountingConfig)

広告申込情報のコンバージョン トラッキング設定。
creativeIds[]

string (int64 format)

広告申込情報に関連付けられているクリエイティブの ID。
bidStrategy

object (BiddingStrategy)

必須。広告申込情報の入札戦略。
integrationDetails

object (IntegrationDetails)

項目の統合の詳細。
targetingExpansion

object (TargetingExpansionConfig)

広告申込情報の最適化されたターゲティングの設定。

この設定は、自動入札を使用し、対象となるオーディエンス リストを積極的にターゲットに設定しているディスプレイ、動画、オーディオの広告申込情報にのみ適用されます。
warningMessages[]

enum (LineItemWarningMessage)

出力のみ。広告申込情報によって生成された警告メッセージ。警告が表示されても広告申込情報の保存はブロックされませんが、警告によっては広告申込情報の配信がブロックされることがあります。
mobileApp

object (MobileApp)

広告申込情報でプロモーションされているモバイルアプリ。

これは、lineItemType が LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL または LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL の場合にのみ適用されます。
reservationType

enum (ReservationType)

出力のみ。広告申込情報の予約タイプ。
excludeNewExchanges

boolean

新しいエクスチェンジを広告申込情報の自動ターゲティングから除外するかどうかを指定します。このフィールドはデフォルトでは false です。
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

出力のみ。YouTube とパートナーの広告申込情報に固有の設定です。

LineItemType

広告申込情報に指定できるタイプ。

広告申込情報タイプによって、広告のフォーマットやターゲティング オプションなど、適用可能な設定やオプションが決まります。

列挙型
LINE_ITEM_TYPE_UNSPECIFIED

このバージョンではタイプ値が指定されていないか、不明です。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_DISPLAY_DEFAULT イメージ広告、HTML5 広告、ネイティブ広告、リッチメディアの広告。
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL アプリのインストールを促進するディスプレイ広告。
LINE_ITEM_TYPE_VIDEO_DEFAULT さまざまな環境向けに CPM ベースで販売される動画広告です。
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL アプリのインストールを促進する動画広告。
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

モバイルアプリ広告枠に配信されるディスプレイ広告

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

モバイルアプリ広告枠に配信される動画広告です。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_AUDIO_DEFAULT さまざまな環境向けに販売される RTB オーディオ広告。
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP OTT 広告掲載オーダーに含まれるオーバー ザ トップ広告。このタイプは、広告掲載オーダーが insertionOrderType OVER_THE_TOP の広告申込情報にのみ該当します。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

コンバージョンを促進する YouTube 動画広告。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

スキップできない YouTube 動画広告（最大 15 秒）。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

複数のフォーマットを組み合わせて、特定の順序でストーリーを披露する YouTube 動画広告。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

YouTube オーディオ広告。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

費用を抑えてより多くのユニーク ユーザーにリーチできるように最適化される YouTube 動画広告。バンパー広告、スキップ可能なインストリーム広告、またはこれらの種類の広告が含まれます。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

デフォルトの YouTube 動画広告。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

スキップできないコネクテッド テレビ YouTube 動画広告（最長 15 秒）。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

コネクテッド テレビの YouTube 動画広告は、費用を抑えてより多くのユニーク ユーザーにリーチできるように最適化されています。バンパー広告、スキップ可能なインストリーム広告、またはこれらの種類の広告が含まれます。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

コネクテッド テレビのデフォルトの YouTube 動画広告。インストリーム広告のみを含めます。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

この広告申込情報タイプの目標は、YouTube 広告のターゲットを一定期間内に同じユーザーに表示することです。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

さまざまな広告フォーマットで視聴回数の増加を目的とした YouTube 動画広告です。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

デジタル屋外広告枠に配信されるディスプレイ広告。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

デジタル屋外広告枠に配信される動画広告。

このタイプの広告申込情報とそのターゲティングは、API を使用して作成または更新することはできません。

LineItemFlight

広告申込情報の有効期間を制御する設定です。

JSON 表現 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
フィールド
flightDateType

enum (LineItemFlightDateType)

必須。広告申込情報の掲載期間のタイプ。
dateRange

object (DateRange)

広告申込情報の掲載期間の開始日と終了日。親広告主のタイムゾーンが基準になります。

  • flightDateType が LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM の場合は必須です。それ以外の場合は出力されます。
  • 新しいフライトを作成するときは、startDate と endDate の両方が将来の日付になっている必要があります。
  • 過去の startDate を持つ既存のフライトには、変更可能な endDate と不変の startDate があります。
  • endDate は startDate 以降（どちらも 2037 年より前の日付）にする必要があります。

LineItemFlightDateType

広告申込情報の掲載期間のタイプ。

列挙型
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED このバージョンではタイプ値が指定されていないか、不明です。
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED 広告申込情報の掲載期間は親広告掲載オーダーから継承されます。
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM 広告申込情報では独自のカスタムの掲載期間が使用されます。

LineItemBudget

予算の割り当て方法を制御する設定です。

JSON 表現 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
フィールド
budgetAllocationType

enum (LineItemBudgetAllocationType)

必須。予算割り当てのタイプ。

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC は、親広告掲載オーダーで予算の自動割り当てが有効になっている場合にのみ適用されます。
budgetUnit

enum (BudgetUnit)

出力のみ。予算単位では、予算が通貨ベースかインプレッション ベースかを指定します。この値は親広告掲載オーダーから継承されます。
maxAmount

string (int64 format)

広告申込情報で支出される最大予算額。0 より大きくなければなりません。

budgetAllocationType の条件は次のとおりです。

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC: このフィールドは不変で、システムによって設定されます。
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED（budgetUnit が次の場合）:
    • BUDGET_UNIT_CURRENCY: このフィールドは、使用する最大予算額を広告主の通貨のマイクロ秒単位で表します。たとえば、1500000 は 1.5 標準通貨を表します。
    • BUDGET_UNIT_IMPRESSIONS: このフィールドは、配信するインプレッションの最大数を表します。
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED: このフィールドは適用できないため、システムによって無視されます。

LineItemBudgetAllocationType

予算割り当ての種類。

列挙型
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED このバージョンではタイプ値が指定されていないか、不明です。
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC 広告申込情報で予算の自動割り当てが有効になっています。
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED 広告申込情報には、固定の最大予算額が割り当てられます。
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED この広告申込情報には予算の上限が適用されていません。

PartnerRevenueModel

パートナー収益の計算方法を管理する設定。

JSON 表現 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
フィールド
markupType

enum (PartnerRevenueModelMarkupType)

必須。パートナーの収益モデルのマークアップ タイプ。
markupAmount

string (int64 format)

必須。パートナーの収益モデルのマークアップ額。0 以上で指定します。

  • markupType が PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM に設定されている場合、このフィールドは CPM マークアップを広告主の通貨のマイクロ単位で表します。たとえば、1500000 は 1.5 標準通貨を表します。
  • markupType が PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP に設定されている場合、このフィールドはメディア費用の割合のマークアップをミリ秒単位で表します。たとえば、100 は 0.1%（10 進数の 0.001）を表します。
  • markupType が PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP に設定されている場合、このフィールドは合計メディア費用の割合の上昇幅（ミリ秒単位）を表します。たとえば、100 は 0.1%（10 進数の 0.001）を表します。

PartnerRevenueModelMarkupType

パートナーの収益モデルに指定できるマークアップ タイプ。

列挙型
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED このバージョンではタイプ値が指定されていないか、不明です。
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM 固定 CPM に基づいてパートナーの収益を計算します。
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

メディア費用の追加料金の割合に基づいてパートナーの収益を計算します。
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP パートナーの収益は、メディア費用の合計（すべてのパートナー費用とデータ費用を含む）に対する追加料金の割合に基づいて計算します。

ConversionCountingConfig

コンバージョンのカウント方法を制御する設定です。

ポストクリック コンバージョンがすべてカウントされます。ポストビュー コンバージョンのカウントにパーセンテージ値を設定できます。

JSON 表現 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
フィールド
postViewCountPercentageMillis

string (int64 format)

カウントするポストビュー コンバージョンの割合（ミリ秒単位、つまり 1, 000 分の 1）。0 ～ 100,000 の値にする必要があります。

たとえば、ポストクリック コンバージョンの 50% をトラッキングするには、値を 50,000 に設定します。
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

コンバージョンのトラッキングに使用される Floodlight アクティビティの設定です。

カウントされるコンバージョン数は、このフィールドで指定されたすべての Floodlight アクティビティ ID でカウントされたすべてのコンバージョンの合計です。

TrackingFloodlightActivityConfig

1 つの Floodlight アクティビティ設定の動作を管理する設定です。

JSON 表現 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
フィールド
floodlightActivityId

string (int64 format)

必須。Floodlight アクティビティの ID。
postClickLookbackWindowDays

integer

必須。広告がクリックされてから、コンバージョンがカウントされるまでの日数。0 ～ 90 の値にする必要があります。
postViewLookbackWindowDays

integer

必須。広告が表示されてから、コンバージョンをカウントするまでの日数。0 ～ 90 の値にする必要があります。

LineItemWarningMessage

広告申込情報によって生成された警告メッセージ。警告が表示された場合、広告申込情報の保存はブロックされませんが、広告申込情報の配信がブロックされることがあります。

列挙型
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED 指定されていないか、不明です。
INVALID_FLIGHT_DATES この広告申込情報には無効な掲載期間が設定されています。この広告申込情報は配信されません。
EXPIRED この広告申込情報の終了日が過去の日付になっています。
PENDING_FLIGHT この広告申込情報は今後配信を開始する予定です。
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED パートナー対応エクスチェンジはすべて除外ターゲットとなっています。この広告申込情報は配信されません。
INVALID_INVENTORY_SOURCE 有効な広告枠ソースがターゲットに設定されていません。この広告申込情報は配信されません。
APP_INVENTORY_INVALID_SITE_TARGETING この広告申込情報のアプリと URL のターゲティングには、モバイルアプリが含まれていません。この広告申込情報タイプでは、チャネル、サイトリスト、またはアプリのターゲティングにモバイルアプリを含める必要があります。この広告申込情報は配信されません。
APP_INVENTORY_INVALID_AUDIENCE_LISTS この広告申込情報はモバイル ユーザーをターゲットに設定していません。この広告申込情報タイプでは、モバイル ユーザーを含むユーザーリストをターゲットに設定する必要があります。この広告申込情報は配信されません。
NO_VALID_CREATIVE この広告申込情報には有効なクリエイティブが含まれていません。この広告申込情報は配信されません。
PARENT_INSERTION_ORDER_PAUSED この広告申込情報の広告掲載オーダーは一時停止しています。この広告申込情報は配信されません。
PARENT_INSERTION_ORDER_EXPIRED この広告申込情報の広告掲載オーダーの終了日が過去の日付に設定されています。この広告申込情報は配信されません。

MobileApp

モバイルアプリ インストール広告申込情報でプロモーションされるモバイルアプリ。

JSON 表現 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
フィールド
appId

string

必須。プラットフォーム ストアが提供するアプリの ID。

Android アプリは、Android の Play ストアで使用されるバンドル ID（com.google.android.gm など）によって識別されます。

iOS アプリは、Apple の App Store で使用されている 9 桁のアプリ ID で識別されます（例: 422689480）。
platform

enum (Platform)

出力のみ。アプリのプラットフォーム。
displayName

string

出力のみ。アプリ名。
publisher

string

出力のみ。アプリのパブリッシャー。

プラットフォーム

利用可能なモバイルアプリ プラットフォーム。

列挙型
PLATFORM_UNSPECIFIED プラットフォームが指定されていません。
IOS 使用できます。
ANDROID Android プラットフォーム

YoutubeAndPartnersSettings

YouTube とパートナーの広告申込情報の設定。

JSON 表現 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
フィールド
viewFrequencyCap

object (FrequencyCap)

広告申込情報の表示フリークエンシー キャップ設定。

制限付きの上限を割り当てる場合は、この設定オブジェクトの maxViews フィールドを使用する必要があります。
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

（省略可）広告申込情報の第三者測定設定。
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

広告申込情報でターゲットとする YouTube とパートナーの広告枠を制御する設定。
contentCategory

enum (YoutubeAndPartnersContentCategory)

YouTube とパートナーの広告が表示されるコンテンツの種類。
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

出力のみ。広告申込情報の配信時に有効になるコンテンツ カテゴリ。広告申込情報と広告主の両方でコンテンツ カテゴリが設定されている場合、広告申込情報の配信時には、厳しいほうが適用されます。
targetFrequency

object (TargetFrequency)

一定期間にこの広告申込情報の広告を同じユーザーに表示する平均回数。
linkedMerchantId

string (int64 format)

商品フィードの項目にリンクされている販売者の ID。
relatedVideoIds[]

string

動画の ID は、モバイル デバイスの YouTube アプリで広告が再生されているときに、メインの動画広告の下に表示されます。
leadFormId

string (int64 format)

見込み顧客を発掘するためのフォームの ID。
videoAdSequenceSettings

object (VideoAdSequenceSettings)

VideoAdSequence に関連する設定。

ThirdPartyMeasurementConfigs

特定の広告申込情報指標を測定する第三者ベンダーを管理する設定です。

JSON 表現 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
フィールド
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

（省略可）視認性を測定している第三者ベンダー

該当する第三者ベンダーは次のとおりです。

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

（省略可）ブランド保護を測定している第三者ベンダー

該当する第三者ベンダーは次のとおりです。

  • THIRD_PARTY_VENDOR_ZERF
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

（省略可）リーチを測定している第三者ベンダー。

該当する第三者ベンダーは次のとおりです。

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

（省略可）ブランド効果測定を測定する第三者ベンダー。

該当する第三者ベンダーは次のとおりです。

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

第三者測定ベンダーの設定を管理する設定です。

JSON 表現 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
フィールド
vendor

enum (ThirdPartyVendor)

第三者測定ベンダー。
placementId

string

第三者ベンダーのプラットフォームが広告申込情報を識別するために使用する ID。

ThirdPartyVendor

第三者による測定を行うベンダー。

列挙型
THIRD_PARTY_VENDOR_UNSPECIFIED 不明なサードパーティ ベンダーです。
THIRD_PARTY_VENDOR_MOAT 堀。
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify。
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science
THIRD_PARTY_VENDOR_COMSCORE Comscore。
THIRD_PARTY_VENDOR_TELEMETRY テレメトリー。
THIRD_PARTY_VENDOR_MEETRICS Meetrics。
THIRD_PARTY_VENDOR_ZEFR ZEFR。
THIRD_PARTY_VENDOR_NIELSEN Nielsen。
THIRD_PARTY_VENDOR_KANTAR Kantar、
THIRD_PARTY_VENDOR_DYNATA Dynata、

YoutubeAndPartnersInventorySourceConfig

YouTube とパートナーの広告申込情報でターゲティングする YouTube 関連の広告枠を制御する設定。

JSON 表現 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
フィールド
includeYoutube

boolean

（省略可）YouTube の広告枠をターゲットに設定するかどうか。これには、検索、チャンネル、動画の両方が含まれます。
includeGoogleTv

boolean

（省略可）Google TV で利用可能な動画アプリ内の広告枠をターゲットとするかどうかを指定します。
includeYoutubeVideoPartners

boolean

YouTube と同じブランド保護基準に準拠しているパートナーのサイトやアプリの広告枠をターゲットに設定するかどうか

YoutubeAndPartnersContentCategory

YouTube とパートナーのコンテンツのブランド保護カテゴリ。

列挙型
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED このバージョンでは、コンテンツ カテゴリが指定されていないか不明です。
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD ほとんどのブランドに適した幅広いコンテンツで構成されるカテゴリです。このコンテンツは、YouTube の広告掲載に適したコンテンツのガイドラインに基づいています。
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED 収益化の基準を満たしている、YouTube と動画パートナーのすべてのコンテンツが含まれるカテゴリ。
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED 特に不適切な表現や性的内容の示唆に関する厳しい要件を満たすコンテンツの範囲を限定したカテゴリ。

TargetFrequency

一定期間に同一のユーザーに対して同じ広告が表示される平均回数をコントロールする設定です。

JSON 表現 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
フィールド
targetCount

string (int64 format)

timeUnit と timeUnitCount で指定された期間内に同じユーザーに広告を表示する平均目標回数です。
timeUnit

enum (TimeUnit)

フリークエンシー目標設定が適用される時間の単位。

以下の時間単位が適用されます。

  • TIME_UNIT_WEEKS
timeUnitCount

integer

フリークエンシー目標が持続する timeUnit の数。

timeUnit の値に基づいて、次の制限が適用されます。

  • TIME_UNIT_WEEKS - 1 にする必要があります。

VideoAdSequenceSettings

VideoAdSequence に関連する設定。

JSON 表現 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
フィールド
minimumDuration

enum (VideoAdSequenceMinimumDuration)

同じユーザーにこのシーケンスが再び表示されるまでの最小時間間隔。
steps[]

object (VideoAdSequenceStep)

シーケンスが構成するステップ。

VideoAdSequenceMinimumDuration

同じユーザーに VideoAdSequence が再び表示されるまでの最短間隔の列挙型です。

列挙型
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED 未指定または不明。
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 日。
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 日間です。

VideoAdSequenceStep

VideoAdSequence の単一ステップの詳細。

JSON 表現 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
フィールド
stepId

string (int64 format)

ステップの ID。
adGroupId

string (int64 format)

ステップに対応する広告グループの ID。
previousStepId

string (int64 format)

前のステップの ID。最初のステップには前のステップがありません。
interactionType

enum (InteractionType)

前のステップで、視聴者をこのステップに誘導するインタラクション。最初のステップに interactionType がありません。

InteractionType

ステップでのインタラクションのタイプ。

列挙型
INTERACTION_TYPE_UNSPECIFIED 不明または不明
INTERACTION_TYPE_PAID_VIEW 有料視聴。
INTERACTION_TYPE_SKIP 視聴者がスキップしました。
INTERACTION_TYPE_IMPRESSION （視聴された）広告インプレッション。
INTERACTION_TYPE_ENGAGED_IMPRESSION 視聴者によってすぐにスキップされなかったものの、請求対象イベントにも達しなかった広告インプレッション。

Methods

bulkEditAssignedTargetingOptions

 複数の広告申込情報のターゲティング オプションを一括編集できます。

bulkListAssignedTargetingOptions

 複数のターゲティング タイプで、複数の広告申込情報に割り当てられているターゲティング オプションを一覧表示します。

bulkUpdate

 複数の広告申込情報を更新します。

create

 新しい広告申込情報を作成します。

delete

 広告申込情報を削除します。

duplicate

 広告申込情報を複製します。

generateDefault

 広告掲載オーダーから継承した設定（ターゲティングなど）と、ENTITY_STATUS_DRAFT entity_status を使って、新しい広告申込情報を作成します。

get

 広告申込情報を取得します。

list

 広告主の広告申込情報を一覧表示します。

patch

 既存の広告申込情報を更新します。