REST Resource: advertisers.lineItems

資源：LineItem

單一委刊項。

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)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
欄位
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)

僅供輸出。委刊項上次更新的時間戳記。由系統指派。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
partnerCosts[]

object (PartnerCost)

與委刊項相關聯的夥伴費用。

如果 lineItems.create 方法中缺少或空白，新建立的委刊項會沿用上層廣告訂單的夥伴費用。
flight

object (LineItemFlight)

必填。委刊項檔期的開始和結束時間。
budget

object (LineItemBudget)

必填。委刊項的預算分配設定。
pacing

object (Pacing)

必填。委刊項的預算支出速度設定。
frequencyCap

object (FrequencyCap)

(選用步驟) 如果委刊項類型不是 LINE_ITEM_TYPE_DEMAND_GEN，則為必要。委刊項的曝光展示頻率上限設定。

如要指定上限，請務必使用這個設定物件中的 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 與合作夥伴委刊項專屬設定。
demandGenSettings

object (DemandGenSettings)

(選用步驟) 需求開發委刊項專屬設定。

僅適用於需求開發委刊項。
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

這個委刊項是否會放送歐盟政治廣告。

如果上層廣告主已將 containsEuPoliticalAds 設為 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING，除非另有指定，否則這個欄位會指派 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING。之後，您可以使用使用者介面、API 或結構化資料檔案更新這個欄位。

建立新委刊項時，必須指派這個欄位。否則，advertisers.lineItems.create 要求會失敗。
optimizeFixedBidding

boolean

(選用步驟) 是否要為固定出價委刊項啟用 DV360 的出價最佳化功能。

根據預設，DV360 會自動降低成效不佳曝光的出價，藉此最佳化固定出價。這項最佳化功能預設為啟用 (值為 true)。

如果這個欄位設為 false，系統會停用這項最佳化功能，且不會因任何原因降低出價。

這項設定僅適用於 biddingStrategy 類型為 FIXED_BID 的委刊項。

LineItemType

委刊項的可能類型。

委刊項類型會決定適用的設定和選項，例如廣告格式或指定目標選項。

列舉
LINE_ITEM_TYPE_UNSPECIFIED

未指定類型值，或這個版本不支援該值。

您無法使用 API 建立或更新這類委刊項及其指定目標。
LINE_ITEM_TYPE_DISPLAY_DEFAULT 圖片、HTML5、原生或互動式多媒體廣告。
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL 放送多媒體廣告，吸引使用者安裝應用程式。
LINE_ITEM_TYPE_VIDEO_DEFAULT 以千次曝光出價銷售的影片廣告，適用於多種環境。
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 廣告訂單中的 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 建立或更新這類委刊項及其指定目標。
LINE_ITEM_TYPE_DEMAND_GEN 需求開發廣告。

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。

需求開發委刊項的這個欄位必須設為 LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED。
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)

必填。夥伴收益模式的加成類型。

需求開發委刊項的這個欄位必須設為 PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP。
markupAmount

string (int64 format)

必填。夥伴收益模式的加成金額。必須大於或等於 0。

  • 如果 markupType 設為 PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM，這個欄位代表千次曝光出價加價，以廣告主貨幣的百萬分之一為單位。舉例來說，1500000 代表 1.5 個標準貨幣單位。
  • 如果 markupType 設為 PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP，這個欄位會以千分之一為單位，代表媒體費用加成百分比。舉例來說，100 代表 0.1% (小數 0.001)。
  • 如果 markupType 設為 PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP，這個欄位會以千分之一為單位，表示媒體費用總額加成百分比。舉例來說，100 代表 0.1% (小數 0.001)。

PartnerRevenueModelMarkupType

夥伴收益模式可能的加成類型。

列舉
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED 未指定類型值，或這個版本不支援該值。
PARTNER_REVENUE_MODEL_MARKUP_TYPE_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)
    }
  ],
  "primaryAttributionModelId": string
}
欄位
postViewCountPercentageMillis

string (int64 format)

要計入的瀏覽後轉換百分比，以千分之一 (1/1000) 為單位。必須介於 0 至 100000 之間 (含 0 和 100000)。

舉例來說，如要追蹤 50% 的點擊後轉換，請將值設為 50000。
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

用於追蹤轉換的 Floodlight 活動設定。

轉換次數是這個欄位中指定的所有 Floodlight 活動 ID 計算出的轉換總和。

如果委刊項已指派自訂出價演算法，就無法更新這個欄位。如果您在同一要求中設定這個欄位並指派自訂出價演算法，Floodlight 活動必須與自訂出價演算法使用的活動相符。
primaryAttributionModelId

string (int64 format)

(選用步驟) 用於評估轉換的歸因模式。這項歸因模式會決定轉換次數的計算方式。您可以為 Floodlight 設定或群組設定主要模式。詳情請參閱這篇文章。

僅適用於需求開發委刊項。

TrackingFloodlightActivityConfig

控制單一 Floodlight 活動設定行為的設定。

JSON 表示法 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
欄位
floodlightActivityId

string (int64 format)

必填。Floodlight 活動的 ID。
postClickLookbackWindowDays

integer

必填。廣告獲得點擊後，系統可能計入轉換的天數。必須介於 0 至 90 之間 (含 0 和 90)。
postViewLookbackWindowDays

integer

必填。廣告觀看後，可計入轉換的天數。必須介於 0 至 90 之間 (含 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 這個委刊項的「應用程式和網址」指定目標不含任何行動應用程式。這個委刊項類型要求您在管道、網站清單或應用程式指定目標中加入行動應用程式。委刊項不會放送。
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 應用程式商店 使用的九位數應用程式 ID 識別，例如 422689480。
platform

enum (Platform)

僅供輸出。應用程式平台。
displayName

string

僅供輸出。應用程式名稱。
publisher

string

僅供輸出。應用程式發布商。

平台

可能的行動應用程式平台。

列舉
PLATFORM_UNSPECIFIED 未指定平台。
IOS 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)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
欄位
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)

(選用步驟) 提供產品動態饋給的 Merchant Center 帳戶 ID。

這個 Merchant Center 帳戶必須已連結至廣告主。
relatedVideoIds[]

string

(選用步驟) 主要影片廣告在行動裝置上透過 YouTube 應用程式播放時，相關影片的 ID 會顯示在影片廣告下方。
leadFormId

string (int64 format)

(選用步驟) 用於產生待開發客戶的表單 ID。
videoAdSequenceSettings

object (VideoAdSequenceSettings)

(選用步驟) VideoAdSequence 相關設定。
videoAdInventoryControl

object (VideoAdInventoryControl)

(選用步驟) 控管這個委刊項允許哪些廣告空間的設定。

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_ZEFR
  • 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
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

(選用步驟) 評估品牌提升的第三方供應商。

適用的第三方供應商如下：

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

控制第三方評估供應商設定方式的設定。

JSON 表示法 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
欄位
vendor

enum (ThirdPartyVendor)

第三方評估供應商。
placementId

string

第三方供應商平台用來識別委刊項的 ID。

ThirdPartyVendor

執行第三方評估的供應商。

列舉
THIRD_PARTY_VENDOR_UNSPECIFIED 不明的第三方供應商。
THIRD_PARTY_VENDOR_MOAT 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。
THIRD_PARTY_VENDOR_TRANSUNION TransUnion。
THIRD_PARTY_VENDOR_ORIGIN 同源內容。
THIRD_PARTY_VENDOR_GEMIUS Gemius。
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope。
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project。
THIRD_PARTY_VENDOR_VIDEO_AMP VideoAmp。
THIRD_PARTY_VENDOR_ISPOT_TV iSpot.tv。
THIRD_PARTY_VENDOR_INTAGE Intage。
THIRD_PARTY_VENDOR_MACROMILL Macromill。
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research。
THIRD_PARTY_VENDOR_AQUILA Aquila。

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 觀眾未立即略過廣告曝光，但廣告曝光也未達到計費事件。

VideoAdInventoryControl

特定 YouTube 委刊項類型使用的影片廣告空間控管選項。

JSON 表示法 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
欄位
allowInStream

boolean

(選用步驟) 廣告是否能以串流內格式放送。
allowInFeed

boolean

(選用步驟) 廣告是否能以動態內格式放送。
allowShorts

boolean

(選用步驟) 廣告是否能以 Shorts 格式放送。
allowNonSkippableInStream

boolean

(選用步驟) 指出廣告是否能以不可略過的串流內格式放送。

DemandGenSettings

需求開發委刊項的設定。

JSON 表示法 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
欄位
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

(選用步驟) 需求開發委刊項的第三方評估設定。
linkedMerchantId

string (int64 format)

(選用步驟) 提供產品動態饋給的 Merchant Center 帳戶 ID。

這個 Merchant Center 帳戶必須已連結至廣告主。
geoLanguageTargetingEnabled

boolean

(選用步驟) 不可變動。是否可在委刊項層級設定指定地區和指定語言。否則，必須直接將相關指定類型指派給廣告群組。

方法

bulkEditAssignedTargetingOptions

 大量編輯多個委刊項的指定目標選項。

bulkListAssignedTargetingOptions

 列出多個委刊項在各種指定類型中指派的指定目標選項。

bulkUpdate

 更新多個委刊項。

create

 建立新委刊項。

delete

 刪除委刊項。

duplicate

 複製委刊項。

get

 取得委刊項。

list

 列出廣告主的委刊項。

patch

 更新現有委刊項。