Search Ads 360 公式欄適用的函式清單
您可以運用下方表格所提供的函式，在 Search Ads 360 公式欄中建立公式，或者在商品目錄方案中建立範本。
部分函式只能用於內含引擎或轉換相關指標的公式欄，而其他函式則只能用於內含商品型錄資料的公式或公式欄中。當您建立公式時，DS 只會顯示適用於目前內容的函式。
| 類型 | 功能 | 說明 |
|---|---|---|
| 比較 | =、<>、<、>、<= 和 >= | 比較兩個資料項目，並根據它們的大小關係傳回 TRUE 或 FALSE。瞭解詳情 |
| 轉換 | to_money(x) | 依據廣告客戶所用幣別，將 Long、Double 或 String 資料 (或相等的運算式) 轉換成 Money 類型。 瞭解詳情 |
| 轉換 | to_number(x) | 將 Money 或 String 資料轉換成數值。瞭解詳情 |
| 轉換 | to_percent(x/y) | 將比例、數值或 String 資料轉換成百分比。 瞭解詳情 |
| 轉換 | to_string(number, [decimal-places]) | 將 decimal-places 所指定小數位數上的任何數值資料類型轉換成 String 類型。如果小數已刪除，函式不會無條件進位至整數。這個函式會遵循廣告客戶的地區語言和幣別使用規範。瞭解詳情 |
| 日期 | end_date - start_date (日期相減) | 計算兩個日期之間的天數。瞭解詳情 |
| 日期 | add_days(date, number-of-days) | 將 number-of-days (天數) 加到 date (日期) 中。設為負數就會往回算。瞭解詳情 |
| 日期 | calendar_months(numberOfMonths) | 傳回當月，或者往前/往後計算指定的月數。這個函式只能當作第二個 date 參數使用 (在 for_date_range(date, date) 中)。瞭解詳情。 |
| Date | calendar_weeks(numberOfWeeks, [startDay]) | 會傳回當週，並且可以往前/往後加計指定的週數。這個函式只能當作第二個 date 參數使用 (在 for_date_range(date, date) 中)。瞭解詳情。 |
| 日期 | date(year, month, date) | 以廣告客戶的時區傳回特定的日期。瞭解詳情 |
| 日期 | day(date) | 這個函式會傳回 1 或 2 位數字來表示指定日期是所屬月份的第幾日。瞭解詳情 |
| 日期 | days(-x) | 從最近一個午夜開始，往前計算參數所指定的完整天數。這個函式只能做為 for_date_range() 中的 duration 參數。瞭解詳情 |
| 日期 | for_date_range( | 指定要使用的天數。舉例來說，Clicks.for_date_range(Last_30_days()) 會傳回最近 30 天的點擊次數。瞭解詳情 |
| 日期 | from_date() | 傳回報表目前時間範圍的開始日期。瞭解詳情 |
| 日期 | last_30_days() | 從最近一個午夜開始，往前計算 30 天。這個函式只能做為 for_date_range() 中的 range 參數。瞭解詳情 |
| 日期 | last_7_days() | 從最近一個午夜開始，往前計算 7 天。這個函式只能做為 for_date_range() 中的 range 參數。瞭解詳情 |
| 日期 | last_month() | 傳回最近一個完整月份的範圍。這個函式只能當作 for_date_range() 中的 range 參數使用。瞭解詳情。 |
| 日期 | last_week([startDay]) | 傳回自週日或其他指定日起算，最近一週的範圍。這個函式只能當作 for_date_range() 中的 range 參數使用。瞭解詳情 |
| 日期 | month(date) | 傳回 1 或 2 位數字來表示指定日期的所屬月份。瞭解詳情 |
| 日期 | months(-x) | 往前計算參數所指定的月數。這個函式只能做為 for_date_range() 中的 duration 參數。瞭解詳情 |
| 日期 | num_days() | 傳回報表所涵蓋的天數。瞭解詳情 |
| 日期 | to_date() | 傳回報表目前時間範圍的結束日期。瞭解詳情 |
| 日期 | today() | 以廣告客戶的時區傳回今天的日期。瞭解詳情 |
| 日期 | weekday(date, [week_start_day]) | 這個函式會傳回 1 到 7 之間的數字來表示指定日期是星期幾。瞭解詳情 |
| 日期 | weeknum(date, [week_start_day]) | 這個函式會傳回 1 到 52、53 或 54 之間的數字來表示指定日期的所屬週次。瞭解詳情 |
| 日期 | year(date) | 傳回 4 位數字來表示指定日期的所屬年份。瞭解詳情 |
| 日期 | yesterday() | 以廣告客戶的時區傳回昨天的日期。瞭解詳情 |
| 錯誤處理 | if_not_finite_number(value, alternate) | value。如果 value 並非數字或有限數值，函式會改為評估 alternate；如果是，則函式會傳回 value。瞭解詳情 |
| 錯誤處理 | if_error(value, alternate) | 如果 value 有誤，這個函式在評估後將傳回 alternate；如果無誤，則會傳回 value。瞭解詳情 |
| 錯誤處理 | is_error(value) | 如果 value 有誤，這個函式在評估後將傳回 TRUE。 瞭解詳情 |
| 商品型錄 | any(ATTRIBUTE) | 針對範本選定的某項商品選擇商品型錄屬性的值。這個函式每次執行時都可能輸入不同的值。瞭解詳情 |
| 商品型錄 | any_with_max(RETURN-ATTRIBUTE, MAX-ATTRIBUTE) | 找出所有針對指定屬性同樣設定了最高值的項目，然後選取其中一個項目，並傳回另一項屬性的值。瞭解詳情 |
| 商品型錄 | any_with_min(RETURN-ATTRIBUTE, MIN-ATTRIBUTE) | 找出所有針對指定屬性同樣設定了最低值的項目，然後選取其中一個項目，並傳回另一項屬性的值。瞭解詳情 |
| 商品型錄 | clean_keyword(in-string, replacement-string) | 掃描 in-string 並將 Google Ads 不支援的關鍵字文字替換成 replacement-string。瞭解詳情 |
| 商品型錄 | count_with_max(ATTRIBUTE, MAX-ATTRIBUTE) | 找出所有針對指定屬性設定了最高值，同時針對另一個屬性也擁有相同值的項目，並傳回相符項目數量。瞭解詳情 |
| 商品型錄 | count_with_min(ATTRIBUTE, MIN-ATTRIBUTE) | 找出所有針對指定屬性設定了最低值，同時針對另一個屬性也擁有相同值的項目，並傳回相符項目數量。瞭解詳情 |
| 商品型錄 | max_with_max(RETURN-ATTRIBUTE, MAX-ATTRIBUTE) | 找出所有針對指定屬性同樣設定了最高值的項目，並傳回這些項目針對另一個屬性設定的最高值。瞭解詳情 |
| 商品型錄 | max_with_min(RETURN-ATTRIBUTE, MIN-ATTRIBUTE) | 找出所有針對指定屬性同樣設定了最低值的項目，並傳回這些項目針對另一個屬性設定的最高值。瞭解詳情 |
| 商品型錄 | min_with_max(RETURN-ATTRIBUTE, MAX-ATTRIBUTE) | 找出所有針對指定屬性同樣設定了最高值的項目，並傳回這些項目針對另一個屬性設定的最低值。瞭解詳情 |
| 商品型錄 | min_with_min(RETURN-ATTRIBUTE, MIN-ATTRIBUTE) | 找出所有針對指定屬性同樣設定了最低值的項目，並傳回這些項目針對另一個屬性設定的最低值。瞭解詳情 |
| 商品型錄 | min(ATTRIBUTE) 或max(ATTRIBUTE) | 傳回由商品型錄範本產生的所有項目中，特定數值型商品型錄屬性的最小值或最大值。瞭解詳情 |
| 商品型錄 | reduce_words(string, max_length, delimiter, [delimiter], ...) | 從 string (字串) 的開頭起算到 (但不包含) delimiter (分隔字元) 為止，盡可能傳回最多字元，但不超過 max_length (長度上限)。如果字串長度小於 max_length (長度上限)，則函式會傳回所接收的整個 string (字串)。瞭解詳情。 |
| 商品型錄 | regex_replace(string, regular_expression, new_text) | 在 string (字串) 中搜尋與 regular_expression (規則運算式) 相符的文字，然後將相符的文字替換成 new_text (新文字)。瞭解詳情 |
| 商品型錄 | substitute_all(ATTRIBUTE, "to text", "from text", "from text 2", "from text 3") | 將商品型錄屬性的多個值替換成單一值。瞭解詳情 |
| 商品型錄 | title_case(string) | 將 string (字串) 轉換成首字母大寫格式。您可以指定商品型錄屬性 (例如 BRAND) 或靜態字串。瞭解詳情 |
| 商品目錄 | count() | 傳回由商品目錄範本的調節係數和篩選器選出的不重複商品目錄項目數量。瞭解詳情 |
| 商品型錄 | lenb(string) | 傳回商品型錄屬性或字串中的位元組數。瞭解詳情 |
| 商品型錄 | regex_extract(string, regular_expression) | 搜尋 string (字串)，並傳回與 regular_expression (規則運算式) 相符的文字。瞭解詳情 |
| 商品型錄 | regex_match(string, regular_expression) | 如果 string (字串) 與 regular_expression (規則運算式) 完全或部分相符，評估結果為 TRUE。這個函式可當做 if 函式中的 condition (條件) 使用。瞭解詳情 |
| 商品型錄 | searchb(needle, haystack) | 傳回 haystack 中第 1 個 needle 出現的位置 (以「位元組」為單位)。如果 haystack 中沒有 needle，則傳回空值。瞭解詳情 |
| 標籤 | has_label("label") | 如果這個函式所在資料列設有指定標籤，將傳回 TRUE。瞭解詳情 |
| 邏輯 | and(x, y, ...) | 邏輯運算子 AND，可用於評估並在所有參數為 TRUE 時傳回 TRUE。瞭解詳情 |
| 邏輯 | if(condition, true, else) | 評估條件並在其為 TRUE 時傳回單一值，如果條件為 FALSE 則傳回其他值。瞭解詳情 |
| 邏輯 | not(x) | 邏輯運算子 NOT，可用於評估並在參數為 FALSE 時傳回 TRUE。瞭解詳情 |
| 邏輯 | or(x, y, ...) | 邏輯運算子 OR，可用於評估並在 OR 連接的任一參數為 TRUE 時傳回 TRUE。瞭解詳情 |
| 數學 | ceiling(x) | 傳回大於 x 的最小整數。瞭解詳情 |
| 數學 | floor(x) | 傳回小於 x 的最大整數。瞭解詳情 |
| 數學 | +、-、* 和 / | 標準算數運算子。瞭解詳情 |
| 數學 | round(x) | 捨入到最接近的整數。瞭解詳情 |
| 數學 | -variable | 將變數值設為負數。舉例來說，-Daily_budget 會傳回每日預算的負數值。 |
| 區隔 | for_device_type(type) | 指定一或多種裝置類型做為運算對象。瞭解詳情 |
| Segments | for_date_range( | Specifies days to operate on. For example, Clicks.for_date_range(Last_30_days()) returns the number of clicks in the last 30 days.Learn more. |
| 文字 | unescape("URL") | 將經過編碼的網址進行解碼。瞭解詳情 |
| 文字 | bmm(string) | 在 string (字串) 中每個字詞的開頭加上「+」字元。您可以在關鍵字範本中運用這個函式，為每個關鍵字字詞加上廣泛比對修飾符。瞭解詳情。一部分廣泛比對修飾符行為已移至詞組比對類型與 Google Ads、Microsoft Advertising 和 Yahoo! Japan 一樣，Search Ads 360 即將停止支援在手動廣告活動和商品目錄廣告活動的關鍵字範本中建立廣泛比對修飾符關鍵字。 如果關鍵字範本指定廣泛比對修飾符且 Search Ads 360 必須產生一組新的關鍵字，Search Ads 360 將會產生一組新的詞組比對關鍵字，而非廣泛比對關鍵字。瞭解詳情。 |
| 文字 | & | 連接兩個字串 (即兩段文字)。瞭解詳情 |
| 文字 | contains(needle, haystack) | 評估 needle 是否為 haystack 的子字串，或 needle 是否與 haystack 相等，並在符合以上任一情況時傳回 TRUE。瞭解詳情 |
| 文字 | ends_with(haystack, needle) | 評估 haystack 的結尾是否為 needle，如果是的話傳回 TRUE。瞭解詳情 |
| 文字 | is_empty(string) | 評估 string 的長度是否為 0 個字元，如果是的話傳回 TRUE。瞭解詳情 |
| 文字 | left(string, length) | 傳回 string 字串的前 length 個字元。瞭解詳情 |
| 文字 | len(string) | 傳回 string 的長度。瞭解詳情 |
| 文字 | lower(string) | 以小寫字母格式傳回 string。瞭解詳情 |
| 文字 | mid(string, start, length) | 傳回 string 中以 start 字元起算 length 個字元的子字串。瞭解詳情 |
| 文字 | replace(string, start, length, new_text) | 以 new_text 取代 string 中由第 start 個字元起算的連續 length 個字元。瞭解詳情 |
| 文字 | right(string, length) | 傳回 string 字串的最後 length 個字元。瞭解詳情 |
| 文字 | search(needle, haystack) | 傳回 haystack 中第一個 needle 出現時的起始字元位置。計算方向是以字串的開頭為起點。瞭解詳情 |
| 文字 | starts_with(haystack, needle) | 評估 haystack 的開頭是否為 needle，如果是的話傳回 TRUE。瞭解詳情 |
| 文字 | substitute(haystack, needle, replacement [, occurrence]) | 以 replacement 替換 haystack 中的所有 needle。如有需要，您可以設定 occurrence，指定要替換第幾個 needle。瞭解詳情 |
| 文字 | trim(string) | 移除整個 string 中的所有空格，以及 string 中字詞之間的雙重空格。瞭解詳情 |
| 文字 | upper(string) | 以大寫字母格式傳回 string。瞭解詳情 |
| 嘗試使用 Google 網頁搜尋來找尋關鍵字。 | ||