通知

請注意,客戶支援團隊不會以您目前的顯示語言提供疑難排解服務。如要與支援團隊人員聯絡,請先切換為英文或其他支援的語言 (西班牙文、葡萄牙文或日文)。

自訂出價指令碼參考資料

您可以使用函式和信號建立自訂出價指令碼,用於改善目標主要成效指標 (KPI),協助您建構自訂出價模型。

本頁內容

語法規則

您可以使用第一方資料通知自訂出價指令碼,藉此提升曝光價值。Display & Video 360 支援下列來源的第一方資料:

建立自訂出價指令碼時,請使用下列語法規則:

  • 以方括號 [ ] 括住所有條件
  • 逗號 , 也代表「and」
範例
在以下指令碼範例中,只有在 criteria_acriteria_b 的值皆為 true 時,criteria1 才會傳回 true。criteria2 則只要 criteria_a 的值為 true,就會傳回 true:
return aggregate_function([
([criteria_a, criteria_b], <分數>), #criteria1
([criteria_a], <分數>) #criteria2
])

註解

您可以使用註解提供指令碼的相關資訊。例如,您可以新增註解說明指令碼的用途。

新增註解時,您可以使用下列語法:

  • 如要新增單行註解,請使用 #
  • 如要新增多行註解,請使用 """''' 括住註解。

範例

# 這是單行註解

"""

這是多行註解

"""

'''

這也是多行註解

'''

運算子

您可以在指令碼中使用下列運算子:

  • 算術運算子+-*/%**//
  • 指派運算子=+=-=*=/=%=**=//=
  • 比較運算子==!=<>>=<=
  • 邏輯運算子and、or、not
  • 隸屬運算子:in、not in

隸屬運算子

您可以在指令碼中使用隸屬運算子 (in 和 not in),檢查欄位是否含有特定元素。

  • in:如果欄位含有特定元素,系統會傳回 true。
  • not in:如果欄位不含特定元素,系統會傳回 true。
範例
if 123 in channel_id: #檢查頻道 ID 是否含有 123
return y

比較運算子

您可以使用比較運算子在模型中納入或排除元素。

範例 1
以下指令碼會從自訂出價模型中排除日期:

# 排除日期

if date == 20180711:

return None

訓練自訂出價模型時,您可以根據系統是否傳回 None,找出要排除的曝光。只要使用會傳回 None 的陳述式,即可在訓練自訂出價模型時找出要排除的曝光。

範例 2

以下指令碼會從自訂出價模型中排除廣告類型:

# 排除分類 (ad_type == 1 代表影片)

if ad_type != 1:

return None

可用的函式和信號

您可以在自訂出價指令碼中使用下列函式。表格包含以下資訊:

  • 欄位:您在指令碼中使用的函式或信號名稱。
  • 類型:輸出的資料類型。自訂出價支援以下資料類型:
    • 布林值:包含 truefalse 值。
    • 二進位值:包含二進位資料。
    • 倍精準度浮點值:包含浮點數值,例如 1.0
    • 整數清單:包含一組整數。
    • 整數:包含正整數或負整數,例如 1-1
    • 字串:包含長度為 0 以上的 UTF-8 字元。比方說,country_code 會輸出 “US” 字串。
  • 詳細資料:包含其他資訊和範例連結。

如需詳細資訊,請前往 Display & Video 360 API 或下載結構化資料檔案 (SDF)

函式

Display & Video 360 自訂出價支援以下函式:

  • 匯總:這類函式會計算指派給某個條件的匯總值。
  • 轉換:這類函式可將變數轉換為特定資料類型,以便執行運算作業。
  • 數學:這類函式會運用高級數學計算值。

這些函式會接受一或多個信號,在自訂出價指令碼中準確反映您的主要成效指標 (KPI)。

類別 函式 類型 詳細資料
匯總函式 first_match_aggregate 倍精準度浮點值 找出陣列中第一個傳回 true 的條件,然後傳回指派給該條件的權重值。
max_aggregate 倍精準度浮點值 找出傳回 true 的條件,然後傳回指派給該條件的最高權重值。
sum_aggregate 倍精準度浮點值 找出所有傳回 true 的條件,將指派給這些條件的所有值加總,然後傳回加總結果。
轉換函式 bool 布林值(x) 傳回布林值:truefalse
float 浮點值(x) 轉換數字或字串資料類型:傳回浮點值。

範例float(1) 會傳回 1.0

int 整數(x) 轉換數字或字串資料類型,然後傳回整數。

範例int(1.0) 會傳回 1

str str(<物件>) 轉換資料類型,然後傳回字串。

範例str(1) 會傳回 “1”

數學函式 log log(x[, <底數>]) 使用單一引數:傳回 x 的自然對數 (底數為 e)。

使用兩個引數:傳回 x 以指定數值為底數的對數,計算方式為 log(x)/log(<底數>)。

信號

Display & Video 360 自訂出價函式可接受以下信號類別的資料:

  • 維度變數:指令碼中用於根據變數計算分數的信號。
  • 轉換:指令碼中用於根據轉換結果計算分數的信號。
  • Google Analytics:指令碼中用於根據 Google Analytics 資料計算分數的信號。

維度變數

類別 信號 類型 詳細資料
一般 advertiser_id 整數 Display & Video 360 中的廣告主 ID。
insertion_order_id 整數 Display & Video 360 中的廣告訂單 ID。
line_item_id 整數 Display & Video 360 中的委刊項 ID。
日期/時間 日期 整數 曝光發生的日期。

格式:yyyymmdd

day_of_week 整數 表示曝光發生日期為當週星期幾的數字代碼。
  • 0 代表星期日
  • 1 代表星期一
  • 2 代表星期二
  • 3 代表星期三
  • 4 代表星期四
  • 5 代表星期五
  • 6 代表星期六
hour_of_day 整數 曝光發生的時間 (小時),採用瀏覽器當地時區 (24 小時制)。

有效值:0 - 23

utc_date 整數 曝光發生的日期,採用世界協調時間 (UTC)。

格式:yyyymmdd

utc_hour_of_day 整數 曝光發生的時間 (小時),採用世界協調時間 (UTC) 和 24 小時制。

有效值:0 - 23

地區 city_id 整數 城市 ID。

如要產生 city_id,請使用 Display & Video 360 API下載 SDF 中繼資料

country_code 字串 國家/地區代碼。

您可以下載國家/地區代碼對照表 PDF 檔案做為參考。

country_id 整數 國家/地區 ID。

您可以下載國家/區域 ID 對照表 PDF 檔案做為參考。

dma_id 整數 指定行銷區域 (DMA) ID。

如要取得這些 ID,請下載自訂出價 ID 工作表 (.xlsx 格式)
zip_postal_code 字串 郵遞區號。

如要查看可用的郵遞區號清單,請使用 Display & Video 360 API下載 SDF 中繼資料

廣告素材 (一般) ad_type 整數 代表廣告格式的數字代碼:
  • 0 代表多媒體
  • 1 代表影片
  • 2 代表音訊
creative_height 整數 廣告素材的高度 (以像素為單位)。

注意:僅適用於多媒體廣告素材。

creative_id 整數 Display & Video 360 中顯示的廣告素材 ID。
creative_width 整數 廣告素材的寬度 (以像素為單位)。

注意:僅適用於多媒體廣告素材。

電腦系統 browser_reportable_id 整數 瀏覽器 ID。

如要取得這些 ID,請下載自訂出價 ID 工作表 (.xlsx 格式)

使用公用 API ID。

您也可以在最新的 SDF 中繼檔案中找到這個 ID,或使用資料轉移檔案。

注意:為統一 Display & Video 360 的 ID 空間,我們已在 2025 年第三季將 browser_id 遷移至 browser_reportable_id。系統會支援在 2025 年第三季之前建立的指令碼一段時間,方便使用者進行遷移。

browser_timezone_offset_minutes 整數 瀏覽器所使用時區與 GMT-12 時區之間的時差 (分鐘)。

範例

1320 表示瀏覽器時區為 GMT+10

device_type 整數 代表裝置類型的數字代碼:
  • 0 代表電腦
  • 1 代表不明
  • 2 代表智慧型手機
  • 3 代表平板電腦
  • 4 代表智慧型電視
  • 5 代表連網電視
  • 6 代表機上盒
  • 7 代表連網裝置
環境 整數 代表廣告放送環境的數字代碼。
  • 10 代表已針對裝置進行最佳化的網頁
  • 11 代表未針對裝置進行最佳化的網頁
  • 12 代表應用程式
isp_reportable_isp 整數 網際網路服務供應商 (ISP) ID。

如要取得這些 ID,請下載自訂出價 ID 工作表 (.xlsx 格式)

使用公用 API ID。

您也可以在最新的 SDF 中繼檔案中找到這個 ID,或使用資料轉移檔案。

注意:為統一 Display & Video 360 的 ID 空間,我們已在 2025 年第三季將 isp_id 遷移至 isp_reportable_id。系統會支援在 2025 年第三季之前建立的指令碼一段時間,方便使用者進行遷移。

語言 字串 瀏覽器的語言設定。

如要取得這些 ID,請下載自訂出價 ID 工作表 (.xlsx 格式)
mobile_make_reportable_id 整數 行動裝置製造商 ID。

如要取得這些 ID,請下載自訂出價 ID 工作表 (.xlsx 格式)

使用公用 API ID。

您也可以在最新的 SDF 中繼檔案中找到這個 ID,或使用資料轉移檔案。

注意:為統一 Display & Video 360 的 ID 空間,我們已在 2025 年第三季將 mobile_make_id 遷移至 mobile_make_reportable_id。系統會支援在 2025 年第三季之前建立的指令碼一段時間,方便使用者進行遷移。

mobile_model_reportable_id 整數 行動裝置型號 ID。

如要取得這些 ID,請下載自訂出價 ID 工作表 (.xlsx 格式)

使用公用 API ID。

您也可以在最新的 SDF 中繼檔案中找到這個 ID,或使用資料轉移檔案。

注意:為統一 Display & Video 360 的 ID 空間,我們已在 2025 年第三季將 mobile_model_id 遷移至 mobile_model_reportable_id。系統會支援在 2025 年第三季之前建立的指令碼一段時間,方便使用者進行遷移。

net_speed 整數

系統在曝光發生時偵測到的網路速度 (以數字代碼表示):

  • 1 代表寬頻/4G (速度為 2mbps 以上)
  • 2 代表撥接網路 (速度為 56kbps 以下)
  • 3 代表連線速度不明
  • 4 代表 EDGE/2G (速度為 57kbps 以上)
  • 5 代表 UMTS/3G (速度為 384kbps 以上)
  • 6 代表基本 DSL (速度為 768kbps 以上)
  • 7 代表 HSDPA/3.5G (速度為 1.8mbps 以上)
operating_system_reportable_id 整數 作業系統 ID。

如要取得這些 ID,請下載自訂出價 ID 工作表 (.xlsx 格式)

使用公用 API ID。

您也可以在最新的 SDF 中繼檔案中找到這個 ID,或使用資料轉移檔案。

注意:為統一 Display & Video 360 的 ID 空間,我們已在 2025 年第三季將 operating_system_id 遷移至 operating_system_reportable_id。系統會支援在 2025 年第三季之前建立的指令碼一段時間,方便使用者進行遷移。

放送 (一般) ad_position 整數 代表廣告刊登位置的數字代碼:
  • 0 代表不明位置
  • 1 代表不需捲動位置
  • 2 代表需捲動位置
adx_page_categories 整數清單 網頁類別 ID。

如要查看完整的類別 ID 對照表,請前往 AdWords API 參考資料

管道 整數清單 Display & Video 360 中的頻道 ID。
網域 字串 注意:連網電視委刊項不支援 domain 信號。如果是連網電視委刊項,請使用 site_id

根網域名稱 (由網域名稱和頂層網域組成)。

這個信號會對應到報表維度應用程式/網址。

範例:如果網址為 http://www.domain.com,根網域是 domain.com。

exchange_id 整數 廣告交易平台 ID。

如要取得這些 ID,請下載自訂出價 ID 工作表 (.xlsx 格式)
site_id 整數 網站 ID。

這個信號會對應到報表維度應用程式/網址 ID。

Active View active_view_measurable 布林值 如果 Active View 可在廣告放送時評估曝光,系統會傳回 1 代表 true。

有些因素可能會導致系統無法計算曝光次數。如果無法評估曝光,系統會傳回 0 代表 false。

active_view_viewed 布林值 Active View 偵測到使用者觀看您的廣告時,會傳回 1 代表 true。如果沒有,則會傳回 0 代表 false。
事件 點擊 布林值 如果使用者點選廣告,系統會傳回 1 代表 true。如果沒有,則會傳回 0 代表 false。
time_on_screen_seconds 整數 廣告出現在畫面上的時間 (以秒為單位)。
影片 audible 布林值 注意:只有即時出價 (RTB) 影片支援這個信號。

如果使用者在觀看影片時開啟音效,這個信號會傳回 1 代表 true。如果沒有,則會傳回 0 代表 false。

completed_in_view_audible 布林值 注意:只有即時出價 (RTB) 影片支援這個信號。

如果使用者在觀看影片期間開啟音效,這個信號會傳回 1 代表 true。如果沒有,則會傳回 0 代表 false。

video_completed 布林值 注意:僅適用於影片廣告類型。系統不會標示非影片曝光次數。

如果使用者完整播放影片,這個信號會傳回 1 代表 true。如果沒有,則會傳回 0 代表 false。

video_player_height_start 整數 影片播放器在顯示第一個畫面時的高度 (以像素為單位)。
video_player_size 整數 代表指定影片廣告空間 (以影片播放器大小為指定依據) 的數字代碼。
  • 0 代表不明
  • 1 代表小
  • 2 代表大
  • 3 代表高畫質 (HD)

如要瞭解詳情,請參閱「指定影片」一文。

video_player_width_start 整數 影片播放器在顯示第一個畫面時的寬度 (以像素為單位)。
video_resized 二進位數 如果使用者在播放期間調整影片播放器大小,這個信號會傳回 1 代表 true。如果沒有,則會傳回 0 代表 false。
viewable_on_complete 布林值 注意:只有即時出價 (RTB) 影片支援這個信號。

如果使用者完整觀看影片,這個信號會傳回 1 代表 true。如果沒有,則會傳回 0 代表 false。

video_content_duration_bucket 整數 注意:僅適用於影片廣告類型。系統不會標示非影片曝光次數。

數字代碼代表影片的值區,用於根據長度將影片分類,且會排除上限範圍。

如果是長度為 1 分鐘的影片:

  • 這些影片會歸類到「1 到 5 分鐘」值區
  • 這些影片不會歸類到「0 到 1 分鐘」值區,因為這個值區會排除長度超過 1 分鐘的影片

範例

  • 0 代表不明
  • 1 代表 0 到 1 分鐘
  • 2 代表 1 到 5 分鐘
  • 3 代表 5 到 15 分鐘
  • 4 代表 15 到 30 分鐘
  • 5 代表 30 到 60 分鐘
  • 7 代表 60 分鐘以上

video_genre_ids 整數清單 注意:僅適用於影片廣告類型。系統不會標示非影片曝光次數。

代表影片類型 ID 清單,用於根據相關音訊和影片廣告空間群組指定廣告。

進一步瞭解指定類型

video_livestream 布林值 注意:僅適用於影片廣告類型。系統不會標示非影片曝光次數。

如果是直播影片,系統會傳回 true,如果沒有,系統會傳回 false

音訊 audio_completed 布林值 注意:僅適用於音訊廣告。

如果使用者完整觀看音訊廣告,系統會傳回 1 代表 true。如果沒有,則會傳回 0 代表 false。

注意:系統不再支援 browser_idisp_idmobile_make_idmobile_model_idoperating_system_id。請更新指令碼,改用 browser_reportable_idisp_reportable_idmobile_make_reportable_idmobile_model_reportable_idoperating_system_reportable_id。這項異動可讓用於自訂出價的空間與其他 Display & Video 360 (包括最新的 SDF 檔案、API 和資料移轉第 2 版) 保持一致。

轉換

類別 信號 類型 詳細資料
轉換信號 total_conversion_count(Floodlight Activity ID, Attribution Model ID) 倍精準度浮點值 ID 組合的轉換事件總數。您可以使用自己的模式。如果輸入 0,表示您要使用最終接觸歸因的模式 ID。
total_conversion_value(Floodlight Activity ID, Attribution Model ID) 倍精準度浮點值 Floodlight 銷售代碼追蹤的活動取得收益值。您可以使用自己的模式。如果輸入 0,表示您要使用最終接觸歸因的模式 ID。
total_conversion_quantity(FloodlightActivity ID, Attribution Model ID) 倍精準度浮點值 歸因於指定 ID 組合的轉換總數。您可以使用自己的模式。如果輸入 0,表示您要使用最終接觸歸因的模式 ID。
conversion_custom_variable(Floodlight Activity ID, Attribution Model ID, Custom Variable Index) 字串 曝光的最新歸因轉換自訂變數字串值。如果沒有任何轉換或未設定字串值,系統會傳回 None。您可以使用自己的模式。如果輸入 0,表示您要使用最終接觸歸因的模式 ID。
conversion_variable_num(FloodlightActivity ID, Attribution Model ID) 整數 在 count_micros 為正數的情況下取得功勞為正職的最新轉換,進而取得「num」Floodlight 變數 (如果有的話)。如果沒有,系統會傳回 None
conversion_variable_ord(Floodlight Activity ID, Attribution Model ID) 字串 count_micros 為正數的情況下取得功勞為正值的最新轉換,進而取得「ord」Floodlight 變數 (如果有的話)。如果沒有,系統會傳回 None

影片類型對照表

類型 ID 類型名稱
2 /成人
3 /藝術與娛樂
317 /藝術與娛樂/漫畫與動畫/動畫與漫畫
319 /藝術與娛樂/漫畫與動畫/卡通
1108 /藝術與娛樂/娛樂產業/影視產業/影視獎項
569 /藝術與娛樂/活動與節目表
1273 /藝術與娛樂/活動與節目表/運動賽事直播
895 /藝術與娛樂/幽默/現場喜劇
1097 /藝術與娛樂/電影/動作冒險片
1099 /藝術與娛樂/電影/動作冒險片/西部片
1095 /藝術與娛樂/電影/喜劇片
615 /藝術與娛樂/電影/恐怖片
1105 /藝術與娛樂/電影/音樂歌舞片
1310 /藝術與娛樂/電影/浪漫愛情片
616 /藝術與娛樂/電影/科幻與奇幻片
1096 /藝術與娛樂/電影/驚悚、犯罪與懸疑片
35 /藝術與娛樂/音樂與音訊
449 /藝術與娛樂/非主流/神秘學與超自然
23 /藝術與娛樂/表演藝術
894 /藝術與娛樂/表演藝術/表演與舞台劇
581 /藝術與娛樂/表演藝術/舞蹈
1185 /藝術與娛樂/表演藝術/歌劇
358 /藝術與娛樂/電視與影片/電視節目
1047 /藝術與娛樂/電視與影片/電視節目/電視喜劇
1411 /藝術與娛樂/電視與影片/電視節目/電視紀錄片與紀實
1193 /藝術與娛樂/電視與影片/電視節目/電視劇
1111 /藝術與娛樂/電視與影片/電視節目/電視劇/電視犯罪與法律節目
357 /藝術與娛樂/電視與影片/電視節目/電視劇/電視連續劇
1110 /藝術與娛樂/電視與影片/電視節目/適合闔家觀賞的節目
1050 /藝術與娛樂/電視與影片/電視節目/電視遊戲節目
1049 /藝術與娛樂/電視與影片/電視節目/電視實境節目
1112 /藝術與娛樂/電視與影片/電視節目/電視科幻與奇幻節目
1410 /藝術與娛樂/電視與影片/電視節目/電視選秀與綜藝節目
1048 /藝術與娛樂/電視與影片/電視節目/電視談話性節目
24 /藝術與娛樂/視覺藝術與設計
47 /汽車與交通工具
1191 /汽車與交通工具/自行車與配件
1405 /汽車與交通工具/自行車與配件/越野自行車
273 /汽車與交通工具/車輛交通工具 (按類型)/摩托車
148 /汽車與交通工具/車輛交通工具 (按類型)/越野車
185 /美容與健身/時尚與風格
94 /美容與健身/健身
241 /美容與健身/健身/健美
1418 /美容與健身/健身/健身指導與個人訓練課程
46 /工商業/農業與林業
5 /電腦與電子產品
122 /餐飲/烹飪與食譜
39 /遊戲/紙牌遊戲
924 /遊戲/紙牌遊戲/撲克牌與賭場遊戲
924 /遊戲/紙牌遊戲/撲克牌與賭場遊戲
41 /遊戲/電腦與電玩遊戲
698 /遊戲/賭博/運動投注/賽馬與賽狗
939 /遊戲/桌上球類運動/撞球
940 /遊戲/桌上球類運動/乒乓球
45 /保健
284 /興趣與休閒/手工藝
688 /興趣與休閒/戶外活動
462 /興趣與休閒/戶外活動/釣魚
461 /興趣與休閒/戶外活動/打獵與射擊
461 /興趣與休閒/戶外活動/打獵與射擊
461 /興趣與休閒/戶外活動/打獵與射擊
999 /興趣與休閒/休閒飛行活動
678 /興趣與休閒/特殊場合/假日與節慶活動
459 /興趣與休閒/水上活動/划船
11 /家居與園藝
158 /家居與園藝/居家修繕
966 /法律與政府/政府/州/省與地方政府
75 /法律與政府/法律
366 /法律與政府/軍事
16 /新聞
784 /新聞/商業新聞
396 /新聞/政治
1201 /新聞/政治/意見與評論
1077 /新聞/運動新聞
785 /新聞/科技新聞
63 /新聞/氣象
113 /人文與社會/種族與認同團體/女同性戀、男同性戀、雙性戀與跨性別
58 /人文與社會/家庭與人際關係/家庭/親子教養
59 /人文與社會/宗教與信仰
870 /人文與社會/自我成長與勵志
57 /人文與社會/社會議題與宣導/公益與慈善
82 /人文與社會/社會議題與宣導/環保生活與環境問題
886 /寵物與動物/寵物/狗
888 /寵物與動物/寵物/馬
119 /寵物與動物/野生動物
119 /寵物與動物/野生動物
690 /參考資料/一般參考資料/傳記與名言
694 /參考資料/一般參考資料/說明、DIY 與專業內容
433 /Reference/Humanities/History
1288 /參考資料/人文學科/歷史/軍事史
174 /科學
18 /購物
64 /購物/古董與收藏品
292 /購物/拍賣
69 /購物/消費者資源
1666 /運動/動物運動
568 /運動/動物運動/馬術
515 /運動/搏擊運動/拳擊
516 /運動/搏擊運動/武術
1674 /運動/搏擊運動/格鬥術/綜合格鬥
512 /運動/格鬥/摔角
1681 /運動/搏擊運動/摔角/職業摔角
554 /運動/極限運動
1206 /運動/極限運動/直線競速與街頭競速
1000 /運動/個人運動
1016 /運動/個人運動/保齡球
458 /運動/個人運動/自行車
261 /運動/個人運動/高爾夫
519 /運動/個人運動/體操
262 /運動/個人運動/球拍運動
1376 /運動/個人運動/球拍運動/網球
541 /運動/個人運動/跑步與健行
1126 /運動/個人運動/溜冰運動
518 /運動/個人運動/田徑
513 /運動/國際運動競賽/奧運
180 /運動/賽車
1595 /運動/賽車/汽車競速
1596 /運動/賽車/摩托車競速
1001 /運動/團體運動
258 /運動/團體運動/美式足球
259 /運動/團體運動/棒球
264 /運動/團體運動/籃球
534 /運動/團體運動/啦啦隊
296 /運動/團體運動/板球
1017 /運動/團體運動/手球
260 /運動/團體運動/曲棍球
517 /運動/團體運動/英式橄欖球
294 /運動/團體運動/足球
699 /運動/團體運動/排球
118 /運動/水上運動
1593 /運動/水上運動/衝浪
1594 /運動/水上運動/游泳
265 /運動/冬季運動
1149 /運動/冬季運動/溜冰
1148 /運動/冬季運動/滑雪與雪板滑雪
67 /旅遊與交通

Google Analytics

重要事項
如要使用 Google Analytics 轉換通知自訂出價模型,請共用轉換資料。請參閱這篇文章,瞭解如何將 Google Analytics 4 連結至 Display & Video 360。
類別 信號 類型 詳細資料
Google Analytics has_ga4_conversions(property_id, conversion_event_name)

布林值

在資源 ID 和轉換事件已歸因的情況下,假如指定曝光至少有一個轉換,系統就會傳回 true。如果沒有,系統會傳回 false
ga4_conversions_count(property_id, conversion_event_name) 整數 如果資源 ID 和轉換事件的功勞已歸給指定曝光,系統會傳回轉換次數。
ga4_conversions_max_value(property_id,conversion_event_name))* 倍精準度浮點值 如果資源 ID 和轉換事件的功勞已歸給指定曝光,系統會傳回指派給轉換的最高值。

如果最高轉換值為 0 或沒有已歸因的轉換,系統會傳回 0

ga4_conversions_max_value_usd(property_id, conversion_event_name) 倍精準度浮點值 注意:適用於使用美元的 Google Analytics 帳戶。

如果資源 ID 和轉換 ID 的功勞已歸給指定曝光,系統會傳回指派給轉換的最高值。

如果最高轉換值為 0 或沒有已歸因的轉換,系統會傳回 0

ga4_conversions_total_value(GA4 property ID, conversion_event_name) 倍精準度浮點值 如果資源 ID 和轉換事件的功勞已歸給指定曝光,系統會傳回指派給轉換的權重值總和。

如果最高轉換值為 0 或沒有已歸因的轉換,系統會傳回 0

ga4_conversions_total_value_usd(property_id, conversion_event_name) 倍精準度浮點值 注意:適用於使用美元的 Google Analytics 帳戶。

如果資源 ID 和轉換事件的功勞已歸給指定曝光,系統會傳回指派給轉換的權重值總和。

如果最高轉換值為 0 或沒有已歸因的轉換,系統會傳回 0

限制

自訂出價指令碼不支援以下操作/項目:

  • 傳送已命名的引數,例如:func(arg1 = “abc”, arg2 = “def”)
  • 下標和配量,例如:userlists[1:3]
  • 參照屬性,例如:domain.length
  • 變數和函式名稱可以來自預先定義的集合
  • 遞迴
  • 進階自訂變數指派:
    • 多重指派
    • 增量指派
    • 加註指派
範例

以下是自訂變數指派不支援的語法範例

_a, _b = 1, 2

_a, _b = _b, _a

_a = _b = 2

_idx += 1

  • 不支援的關鍵字
    • globalnonlocalexec 關鍵字
    • class 和類別定義
    • def 和函式定義
    • Import 和 import from 關鍵字
    • lambda 和 lambda 支援
    • break
    • continue
    • yield
    • raise
    • assert
    • try
    • finally
    • except
    • async
    • await
    • del
    • Pass
    • ellipsis
  • 不支援的迴圈
    • forwhile 迴圈
  • 不支援的運算子
    • *** (用於非算術陳述式時)
    • <<>> 等移位運算子
    • 位元運算子
    • @ 修飾符
    • isnot is 等身分運算子
這個頁面可能含有使用 AI 技術翻譯的內容,也許會有錯誤。

這對您有幫助嗎?

我們應如何改進呢?
搜尋
清除搜尋內容
關閉搜尋
主選單
1938154726583484171
true
搜尋說明中心
false
true
true
true
true
true
69621
false
false
false
false
false