REST Resource: curators.curatedPackages

資源:CuratedPackage

代表由收錄者建立及管理的精選廣告空間套裝方案。

JSON 表示法
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
欄位
name

string

ID。精選套件的專屬資源名稱。格式:curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

必填。收錄者為收錄套裝方案指派的顯示名稱。可用於篩選 curatedPackages.list 方法的回應。

description

string

(選用步驟) 收錄套裝方案的說明,由收錄者提供。

createTime

string (Timestamp format)

僅供輸出。建立精選套裝方案的時間戳記。可用於篩選 curatedPackages.list 方法的回應。

使用 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"。

updateTime

string (Timestamp format)

僅供輸出。上次更新精選套件的時間戳記。可用於篩選 curatedPackages.list 方法的回應。

使用 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"。

floorPriceCpm

object (Money)

(選用步驟) 買方必須出價的最低千次曝光出價,才能參與這個精選套裝方案的廣告空間競價。可用於篩選 curatedPackages.list 方法的回應。

state

enum (State)

僅供輸出。精選套件的狀態。可用於篩選 curatedPackages.list 方法的回應。

accessSettings

object (AccessControlSettings)

必填。控管精選套件存取權的設定。

只有列入許可清單的媒體企劃人員和創作者,才能存取這個精選套裝方案。買方和出價方無法加入許可清單,也無法直接存取這項資源。

targeting

object (PackageTargeting)

(選用步驟) 精選套裝方案的指定條件。

curationFeeVisibility

enum (CurationFeeVisibility)

(選用步驟) 不可變動。收錄套裝方案和資料區隔的合併費用 (總收錄費用) 的顯示設定。

支付給這個套裝方案收錄者的費用。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位:
feeCpm

object (Money)

(選用步驟) 收錄者向使用這個精選套裝方案的買家收取的千次曝光出價費用。可用於篩選 curatedPackages.list 方法的回應。

millipercentOfMediaFee

string (int64 format)

(選用步驟) 這筆費用會以曝光費用的百分比收取,並以千分之一百分比表示。例如,1% 會表示為 1000。

互斥欄位結束。

州

精選套件的狀態。

列舉
STATE_UNSPECIFIED 預設值。
ACTIVE 精選套件已啟用。
INACTIVE 精選套件已停用。

AccessControlSettings

控管精選套件存取權的設定。

JSON 表示法
{
  "allowlistedMediaPlanners": [
    string
  ]
}
欄位
allowlistedMediaPlanners[]

string

必填。不可變動。明確獲授予精選套裝方案存取權的媒體企劃人員清單。您可以使用 mediaPlanners.list 方法,找出符合資格的媒體企劃書。目前只能將一位媒體企劃人員加入許可清單。

格式:mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

精選和競價套裝方案的指定條件。

JSON 表示法
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
欄位
includedDeviceTypes[]

enum (DeviceType)

(選用步驟) 要指定的裝置類型清單。如果留空,系統會指定所有裝置類型。

includedEnvironment

enum (Environment)

(選用步驟) 要指定的環境。如未指定,則會指定所有環境。

includedCreativeFormat

enum (CreativeFormat)

(選用步驟) 要指定的廣告素材格式。如未設定,則會指定所有廣告素材標記類型。

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

(選用步驟) 指定的 Accelerated Mobile Pages 類型。如未設定,系統會指定廣告空間,無論 AMP 狀態為何。

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

(選用步驟) 指定授權賣家狀態的納入清單。如果留空,無論賣家狀態為何,系統都會指定廣告空間。

includedNativeInventoryTypes[]

enum (NativeInventoryType)

(選用步驟) 指定的原生廣告空間類型。如果留空,系統會指定廣告空間,不論原生廣告空間類型為何。

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

(選用步驟) 指定 Open Measurement 類型清單。如果留空,無論是否支援 Open Measurement,系統都會指定廣告空間。

includedRestrictedCategories[]

enum (RestrictedCategory)

(選用步驟) 指定受限制類別的清單。如果留空,無論是否為受限制的類別,系統都會指定廣告空間。

includedRewardedType

enum (RewardedType)

(選用步驟) 指定的獎勵類型。如未設定,系統會指定廣告空間,不論獎勵類型為何。

videoTargeting

object (PackageVideoTargeting)

(選用步驟) 影片專屬指定條件。

minimumPredictedViewabilityPercentage

string (int64 format)

(選用步驟) 指定的最低預測可視度百分比。

這個值必須是 10 的倍數,且介於 10 至 90 (含) 之間。舉例來說,10 是有效值,但 0、15 和 100 則無效。如果值為 10,表示設定只會比對預測可視度至少為 10% 的廣告版位。

如果未設定值,則無論預測可視度為何,系統都會指定廣告空間。

languageTargeting

object (StringTargetingDimension)

(選用步驟) 要指定的語言。如未設定,系統會指定廣告空間,不限語言。如要查看支援的語言代碼清單,請前往 https://developers.google.com/google-ads/api/data/codes-formats#languages。

includedAdSizes[]

object (AdSize)

(選用步驟) 要指定的廣告大小清單。如未設定,系統會指定廣告空間,不論廣告大小。

精選套裝方案支援 PIXEL 和 INTERSTITIAL 廣告大小。

publisherTargeting

object (StringTargetingDimension)

(選用步驟) 指定的發布商。如未設定,系統會指定廣告空間,不限發布商。系統會根據 ads.txt/app-ads.txt 中的發布商 ID 識別發布商。詳情請參閱 https://iabtechlab.com/ads-txt/ 和 https://iabtechlab.com/app-ads-txt/。

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

(選用步驟) 預測點閱率的目標最低值,範圍為 [10, 10000] (0.01% - 10%)。如果值為 50,表示設定只會比對預測點閱率至少為 0.05% 的廣告版位。

如果未設定值,則無論預測點閱率為何,系統都會指定廣告空間。

verticalTargeting

object (CriteriaTargeting)

(選用步驟) 納入或排除的產業,定義請見 https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals。如未設定,系統會指定廣告空間,不限產業。

geoTargeting

object (CriteriaTargeting)

(選用步驟) 要納入或排除的地理條件 ID,如 https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv 所定義。如未設定,系統會指定廣告空間,不限地理區域。

includedDataSegments[]

string

(選用步驟) 要指定的有效資料區隔。如未設定,系統會指定廣告空間,不考慮資料區隔。格式:curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

(選用步驟) 指定刊登位置資訊,例如網址、行動應用程式。

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

(選用步驟) 發布商提供的信號。如未設定,系統會指定廣告空間,無論發布商是否提供信號。

DeviceType

要指定的裝置一般類型。

列舉
DEVICE_TYPE_UNSPECIFIED 預設值。不應用於指定目標規格。
DEVICE_TYPE_PERSONAL_COMPUTER 指定桌上型電腦或筆記型電腦。
DEVICE_TYPE_CONNECTED_TV 指定連網電視:可串流播放電視內容的裝置,包括智慧型電視、遊戲主機和機上盒/電視棒。
DEVICE_TYPE_PHONE 指定高階行動裝置。
DEVICE_TYPE_TABLET 指定平板電腦。

環境

要指定的環境。

列舉
ENVIRONMENT_UNSPECIFIED 預設值。不應用於指定目標規格。
ENVIRONMENT_SITE 指定在廣告贊助網站中顯示的廣告空間。
ENVIRONMENT_APP 指定行動應用程式中的廣告空間。

CreativeFormat

可指定的廣告素材格式。

列舉
CREATIVE_FORMAT_UNSPECIFIED 預設值。不應用於指定目標規格。
CREATIVE_FORMAT_DISPLAY 指定用於 HTML 多媒體廣告素材的廣告版位。
CREATIVE_FORMAT_VIDEO 指定用於影片廣告素材的廣告版位。
CREATIVE_FORMAT_AUDIO 指定用於音訊廣告素材的廣告版位。

AcceleratedMobilePageType

要指定的 Accelerated Mobile Pages (AMP) 導入類型。

列舉
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED 預設值。不應用於指定目標規格。
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP 指定未使用任何 AMP 架構的標準網頁廣告空間。
ACCELERATED_MOBILE_PAGE_TYPE_AMP 指定使用核心 AMP HTML 架構建構的網頁廣告空間。
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY 指定採用 AMP 故事 (STAMP) 格式的網頁廣告空間,這種格式經過最佳化,適合用影像述說故事 (例如可輕觸的全螢幕體驗)。

AuthorizedSellerStatus

代表發布商和賣方之間的關係,如 ads.txt 或 app-ads.txt 檔案中所宣告。

列舉
AUTHORIZED_SELLER_STATUS_UNSPECIFIED 預設值。不應用於指定目標規格。
AUTHORIZED_SELLER_STATUS_DIRECT 指定賣家宣告為「DIRECT」的廣告空間。這表示發布商 (內容擁有者) 直接控制賣家帳戶,並與廣告系統簽訂了這個帳戶的直接商業合約。
AUTHORIZED_SELLER_STATUS_RESELLER 指定賣家宣告為「RESELLER」的廣告空間。這表示發布商已授權其他實體經營所列的賣家帳戶,並轉售其廣告空間。

NativeInventoryType

代表廣告版位支援的廣告素材算繪類型,特別是與原生廣告相關。

列舉
NATIVE_INVENTORY_TYPE_UNSPECIFIED 預設值。不應用於指定目標規格。
NATIVE_INVENTORY_TYPE_NATIVE_ONLY 指定僅接受及顯示原生廣告的廣告版位。
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER 指定可接受並顯示原生廣告或橫幅廣告的廣告版位。

OpenMeasurementType

要指定的 Open Measurement Interface Definition (OMID) 類型。

列舉
OPEN_MEASUREMENT_TYPE_UNSPECIFIED 預設值。不應用於指定目標規格。
OPEN_MEASUREMENT_TYPE_OMID_V1 指定支援第 1 版 Open Measurement 介面定義 (OMID) 的廣告空間。

RestrictedCategory

代表政策限制指定目標的特定廣告類別。

列舉
RESTRICTED_CATEGORY_UNSPECIFIED 預設值。不應用於指定目標規格。
RESTRICTED_CATEGORY_ALCOHOL 指定發布商允許放送酒精飲料廣告的廣告空間。
RESTRICTED_CATEGORY_GAMBLING 指定發布商允許放送賭博廣告的廣告空間。

RewardedType

根據廣告空間是否向觀看廣告的使用者提供獎勵,定義指定條件。

列舉
REWARDED_TYPE_UNSPECIFIED 預設值。不應用於指定目標規格。
REWARDED_TYPE_NON_REWARDED 指定不會明確獎勵使用者觀看廣告或與廣告互動的廣告空間。
REWARDED_TYPE_REWARDED 指定向使用者提供獎勵,換取他們觀看廣告或與廣告互動的廣告空間。

PackageVideoTargeting

影片專屬指定條件。

JSON 表示法
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
欄位
includedMimeTypes[]

enum (VideoMimeType)

(選用步驟) 指定影片 MIME 類型清單,使用 IANA 發布的 MIME 類型字串 (https://www.iana.org/assignments/media-types/media-types.xhtml))。如果留空,系統會指定廣告空間,不論影片 MIME 類型為何。

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

(選用步驟) 影片廣告長度上限目標。如未設定,系統會指定廣告空間,不考慮影片廣告長度上限。

includedPositionTypes[]

enum (PositionType)

(選用步驟) 指定的影片廣告排序類型。如果留空,系統會指定廣告空間,不考慮影片廣告位置類型。

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

(選用步驟) 指定的影片放送方式。如未設定,系統會指定廣告空間,無論影片放送方式為何。

plcmtTargeting

object (VideoPlcmtTargeting)

(選用步驟) 指定的影片 plcmt 類型。如未設定,系統會指定廣告空間,不論影片 plcmt 類型為何。

includedPlaybackMethods[]

enum (PlaybackMethod)

(選用步驟) 指定影片播放方式清單。如果留空,系統會指定廣告空間,無論影片播放方法為何。

minimumPredictedCompletionRatePercentage

string (int64 format)

(選用步驟) 指定的最低預測播放完成率百分比。

這個值必須是 10 的倍數,且介於 10 至 90 (含) 之間。舉例來說,10 是有效值,但 0、15 和 100 則無效。如果值為 10,表示設定只會比對預測播放完成率至少 10% 的廣告版位。

如果未設定值,則表示無論預測播放完成率為何,都會指定廣告空間。

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

(選用步驟) 指定的影片播放器大小。如未設定,系統會指定廣告空間,不論影片播放器大小為何。

VideoMimeType

要指定的影片 MIME 類型。

列舉
VIDEO_MIME_TYPE_UNSPECIFIED 預設值。不應用於指定目標規格。
VIDEO_MIME_TYPE_THREEGPP 3G 手機使用的 3GPP 容器格式。
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 MPEG-4 容器,通常搭配 H.264 轉碼器。
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH DASH。
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT JavaScript (用於 VPAID 廣告)。
VIDEO_MIME_TYPE_WEBM 假設使用 VP9 轉碼器的 WebM 容器。

MaximumVideoAdDuration

指定影片廣告素材的時間長度上限。列舉值會定義區間,選取值代表廣告素材的時間長度必須小於或等於指定時間。

列舉
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED 預設值。不應用於指定目標規格。
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS 適用於長度不超過 15 秒的影片廣告 (0 < 長度 <= 15 秒)。
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS 適用於長度不超過 20 秒的影片廣告 (0 < 長度 <= 20 秒)。
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS 適用於長度不超過 30 秒的影片廣告 (0 < 長度 <= 30 秒)。
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS 適用於長度不超過 60 秒的影片廣告 (0 < 長度 <= 60 秒)。
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS 適用於長度不超過 90 秒的影片廣告 (0 < 長度 <= 90 秒)。
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS 適用於長度不超過 120 秒的影片廣告 (0 < 長度 <= 120 秒)。

PositionType

廣告在影片中的可指定位置。

列舉
POSITION_TYPE_UNSPECIFIED 預設值。不應用於指定目標規格。
POSITION_TYPE_MIDROLL 廣告會在影片內容播放期間放送。
POSITION_TYPE_POSTROLL 在影片內容結束後播放。
POSITION_TYPE_PREROLL 廣告會在影片內容播放前放送。

ContentDeliveryMethod

根據影片內容的放送方式設定指定條件。

列舉
CONTENT_DELIVERY_METHOD_UNSPECIFIED 預設值。不應用於指定目標規格。
CONTENT_DELIVERY_METHOD_STREAMING 指定直播中的影片內容。
CONTENT_DELIVERY_METHOD_PROGRESSIVE 指定根據用戶端播放需求,逐步傳輸的影片內容。

VideoPlcmtTargeting

根據影片刊登位置類型定義指定條件,通常對應至 IAB OpenRTB 的「plcmt」欄位。

JSON 表示法
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
欄位
selectionType

enum (SelectionType)

必填。影片刊登位置清單的選取類型。

videoPlcmtTypes[]

enum (VideoPlcmtType)

必填。指定影片刊登位置類型清單。如果留空,則無論影片 plcmt 類型為何,都會指定廣告空間。

SelectionType

指定目標維度所用可能選取類型的列舉。

列舉
SELECTION_TYPE_UNSPECIFIED 未指定選取類型。不應使用。
SELECTION_TYPE_INCLUDE 指定目標維度中的值會納入。
SELECTION_TYPE_EXCLUDE 指定維度中的值會遭到排除。

VideoPlcmtType

代表影片刊登位置類型,符合 OpenRTB 標準。

列舉
VIDEO_PLCMT_TYPE_UNSPECIFIED 預設值。不應用於指定目標規格。
INSTREAM 片頭、片中和片尾廣告,會在消費者要求的串流影片內容之前、期間或之後播放。串流內影片必須在播放器啟動時預設為「開啟音效」,或使用者明確表示有意觀看影片內容。雖然播放器周圍可能會有其他內容,但影片內容必須是使用者造訪的重點。影片播放器應維持網頁主要內容的地位,且是畫面上唯一能播放音訊的影片播放器。如果播放器轉換為浮動/固定,後續的廣告呼叫應準確傳達更新後的播放器大小。
ACCOMPANYING_CONTENT 片頭、片中和片尾廣告,會在串流影片內容開始前、期間或結束後播放。影片播放器會在文字或圖片內容的段落之前、之間或之後載入並播放,且只有在進入可視區域時才會開始播放。隨播內容應在進入可視區域後才開始播放。當播放器捲動到網頁外時,可能會轉換為浮動/固定式播放器。
INTERSTITIAL 在沒有影片內容的情況下播放的影片廣告。播放時,廣告必須是網頁的主要焦點,占據大部分可視區域,且無法捲動至畫面外。例如應用程式內影片或投影片。
NO_CONTENT 在沒有串流影片內容的情況下播放的影片廣告。這類廣告可顯示在投影片、原生動態饋給、內容內嵌或固定/浮動等刊登位置。

PlaybackMethod

要指定的播放方法。

列舉
PLAYBACK_METHOD_UNSPECIFIED 未指定影片播放方法。不應使用。
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON 網頁/內容載入時,系統會自動開始播放。
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF 網頁/內容載入時,影片會自動開始播放,但不會播放聲音。
PLAYBACK_METHOD_CLICK_TO_PLAY 播放是由使用者動作 (例如點選播放按鈕) 啟動。

VideoPlayerSizeTargeting

代表可指定的影片播放器大小。寬度和高度都必須設為非零值。

JSON 表示法
{
  "minimumWidth": string,
  "minimumHeight": string
}
欄位
minimumWidth

string (int64 format)

必填。影片播放器的寬度下限 (以像素為單位)。

minimumHeight

string (int64 format)

必填。影片播放器的高度下限 (以像素為單位)。

StringTargetingDimension

使用字串值的一般指定目標。

JSON 表示法
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
欄位
selectionType

enum (SelectionType)

必填。這份清單中項目的指定方式。

values[]

string

必填。指定的值。

AdSize

代表單一廣告版位或廣告素材的大小。

JSON 表示法
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
欄位
width

string (int64 format)

廣告版位的寬度 (以像素為單位)。只有在大小類型為 PIXEL 時,才會顯示這個欄位。

height

string (int64 format)

廣告版位的高度 (以像素為單位)。只有在大小類型為 PIXEL 時,才會顯示這個欄位。

type

enum (Type)

廣告版位大小類型。

類型

代表不同類型的廣告版位/廣告素材大小。

列舉
TYPE_UNSPECIFIED 未定義大小類型的預留位置。
PIXEL 廣告版位,大小以高度和寬度 (像素) 指定。
INTERSTITIAL 用來描述插頁式廣告版位的特殊大小。
NATIVE 由發布商顯示的原生 (行動) 廣告。
FLUID 流動大小 (回應式大小) 可隨著外部環境的變化自動調整大小。

CriteriaTargeting

一般指定目標用於指定維度,其中包含納入和排除的數字 ID 清單。無法使用清單篩選器語法篩選。

JSON 表示法
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
欄位
targetedCriteriaIds[]

string (int64 format)

要納入的數字 ID 清單。

excludedCriteriaIds[]

string (int64 format)

要排除的數字 ID 清單。

PackagePlacementTargeting

代表廣告可顯示位置的指定目標,例如特定網站或行動應用程式。不同類型的指定刊登位置會以邏輯「OR」運算子連結。

JSON 表示法
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
欄位
uriTargeting

object (StringTargetingDimension)

(選用步驟) 指定或排除的網址清單。網域應去除 http/https (例如 google.com),且每個網址最多可包含 5 個路徑。

mobileAppTargeting

object (StringTargetingDimension)

(選用步驟) 發布商擁有的指定或排除行動應用程式 ID 清單。目前僅支援 Android 和 Apple 應用程式。

Android 應用程式 ID (例如 com.google.android.apps.maps) 可以在 Google Play 商店網址中找到。iOS 應用程式 ID (數字) 則位於 iTunes Store 網址結尾。第一方行動應用程式已納入或排除。

includedMobileAppCategoryTargeting[]

string (int64 format)

(選用步驟) 指定行動應用程式類別清單。

PackagePublisherProvidedSignalsTargeting

代表發布商提供的信號指定目標。不同類型的發布商提供的信號會以邏輯 OR 運算子連結。

JSON 表示法
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
欄位
audienceTargeting

object (TaxonomyTargeting)

(選用步驟) 指定或排除的目標對象 ID 清單。根據 IAB 目標對象分類 1.1 版 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)

contentTargeting

object (TaxonomyTargeting)

(選用步驟) 指定或排除的 Content ID 清單。根據 IAB 內容分類 2.2 版 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

(選用步驟) 指定和排除的影片和音訊信號 ID 清單。這些是發布商提供的信號支援的其他信號。

TaxonomyTargeting

定義指定條件,用於處理 IAB 目標對象和內容分類 ID 空間。

JSON 表示法
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
欄位
targetedTaxonomyIds[]

string

(選用步驟) 指定內容分類 ID 清單。

excludedTaxonomyIds[]

string

(選用步驟) 已排除的內容分類 ID 清單。

CurationFeeVisibility

收錄套裝方案和資料區隔的合併費用 (總收錄費用) 顯示設定。套件建立者一律可以查看費用。

列舉
CURATION_FEE_VISIBILITY_UNSPECIFIED 未指定總收錄費用的顯示設定。
DISCLOSED 所有買家都能看到總收錄費用。如未設定,則預設值為 1。
NON_DISCLOSED 並非所有買家都能看到精選總費用。

方法

activate

啟用現有的精選套裝方案。

create

建立新的精選套裝方案。

deactivate

停用現有的精選套裝方案。

get

根據資源名稱取得精選套件。

list

列出指定管理員擁有的精選套件。

patch

更新現有的精選套件。