맞춤 열에서 사용할 수 있는 함수 목록과 일반적인 소개는 맞춤 열의 함수를 참고하세요.
템플릿 관련 맞춤 열 수식을 구성할 때 함수 메뉴에 상황에 맞는 하위 메뉴 옵션이 마련되어 있습니다. 옵션 위로 입력 장치를 가져가면 추가 정보가 표시됩니다. 수식 텍스트 내에서 마우스 오른쪽 버튼으로 클릭하여 현재 상황에 유효한 함수 메뉴를 확인합니다.
템플릿의 표준 맞춤 열 함수
이러한 옵션에는 다음이 포함될 수 있습니다.
- 로직:
if,and,not,or,if_error,is_error,is_not_finite같은 표준 로직 함수의 옵션입니다. - 텍스트:
concat,is_empty,trim,starts_with,ends_with,search,substitute,right,left,contains,upper,lower,length,clean_keyword,string_len_byte,regex_extract,regex_match,regex_replace,search_byte,bmm,reduce_word,title_case,unescape,substitute_all같은 텍스트 함수의 옵션입니다. - 산술:
round,ceiling,floor같은 산술 함수의 옵션입니다. - 변환:
to_text,to_number,extract_percentage같은 변환 함수의 옵션입니다. - 날짜:
date,day,month,quarter,year,weekday,weeknum,daynum,days_between,offset_days,offset_months,offset_years,today,yesterday,week_start_sunday,week_start_monday,month_start,year_start같은 날짜 함수의 옵션은 맞춤 열의 함수에 설명되어 있습니다. - 집계:
min,max,any같은 집계 함수의 옵션입니다.
템플릿 맞춤 열 함수
구체적으로 템플릿의 컨텍스트에서 사용할 수 있는 다양한 맞춤 열 함수가 있습니다. 이러한 함수는 다음 표에 설명되어 있습니다.
참고
- 이러한 함수는 템플릿 기능에서 사용할 수 있습니다.
- '값'이라는 단어가 따옴표로 묶인 경우 텍스트 값이 필수입니다.
- 다음 표의 일부 함수에서는 needle, needles, haystack이라는 용어가 사용됩니다. 'needle' 또는 'needles'는 일련의 값 내에서 찾을 수 있는 특정 값인 'haystack'을 나타냅니다.
| 하위 메뉴 | 반환 유형 | 자동화 함수 표현식 | 설명 |
|---|---|---|---|
| 로직 | 불리언 또는 숫자 | is_not_finite(값, 대체) |
값을 평가합니다. 값이 숫자 또는 유한수가 아닌 경우 함수는 대체를 평가합니다. 이외의 경우 함수는 값을 반환합니다. |
| 불리언, 숫자 또는 텍스트 | if_error(값, 오류_값) |
값을 평가합니다. 값이 오류를 반환하면 함수는 오류_값에 정의된 대체 값을 평가합니다. 오류를 반환하지 않으면 함수는 값을 반환합니다. |
|
| 불리언, 숫자 또는 텍스트 | is_error(값) |
값이 오류인 경우 true로 평가됩니다. |
|
| 텍스트 | 텍스트 | clean_keyword(“텍스트”, “대체”) |
문자열을 스캔하고 광고 플랫폼에서 키워드 텍스트에 지원하지 않는 문자를 대체 텍스트 값으로 대체합니다. |
| 숫자 | string_len_byte(“값”) |
피드 속성 또는 텍스트 값의 바이트 수를 반환합니다. | |
| 텍스트 | regex_extract(“값”, “정규_표현식”) |
값을 검색하고 정규_표현식과 일치하는 텍스트를 반환합니다. |
|
| 불리언 | regex_match(“값”, “정규_표현식”) |
값이 정규_표현식의 전체 또는 일부와 일치하는 경우 true로 평가됩니다. 이 함수를 if 함수에서 조건으로 사용합니다. |
|
| 텍스트 | regex_replace(“값”, “정규_표현식”, “대체”) |
값에서 정규_표현식과 일치하는 텍스트를 검색한 다음 일치하는 텍스트를 대체로 대체합니다. |
|
| 숫자 또는 null | search_byte(“needle”, “haystack”) |
haystack에 있는 needle의 첫 번째 인스턴스 시작 위치를 바이트 단위로 반환합니다. haystack에 needle이 없는 경우 null을 반환합니다. 0이 아닌 1부터 세기 시작합니다. 읽는 방향은 항상 광고주의 언어를 따릅니다. 주로 일본어, 중국어 등 라틴 문자 집합을 사용하지 않는 언어에 해당합니다. |
|
| 텍스트 | reduce_word(“값”, 길이, “구분자”) |
최대_길이 내에서 최대한 많은 문자를 반환하며, 문자열의 시작부터 구분자까지 세지만 구분자는 포함하지 않습니다. 값이 이미 최대_길이 내에 있는 경우, 함수는 전달된 그대로 값을 반환합니다. |
|
| 텍스트 | title_case(“값”) |
값의 각 단어가 대문자로 시작하도록 변환합니다. 피드 속성 또는 정적 텍스트 값을 지정할 수 있습니다. |
|
| 텍스트 | unescape(“값”) |
URL 인코딩된 URL을 디코딩합니다. | |
| 텍스트 | substitute_all(“haystack”, 대체, “needles”) |
속성의 여러 값을 단일 값으로 바꿉니다. | |
| 변환 | 숫자 | extract_percent(“x%”) |
비율, 숫자 또는 텍스트 값을 백분율로 변환합니다. |
| 집계 | 불리언, 숫자 또는 텍스트 | max(값) |
템플릿에서 선택한 항목 중 숫자 피드 속성의 최대 값을 반환합니다. |
| 불리언, 숫자 또는 텍스트 | min(값) |
템플릿에서 선택한 항목 중 숫자 피드 속성의 최소 값을 반환합니다. |
|
| 불리언, 숫자 또는 텍스트 | any(값) |
템플릿에서 선택한 항목 중 하나에서 속성의 값을 선택합니다. 이 함수는 실행될 때마다 다른 값을 출력할 수 있습니다. |
피드 및 템플릿 맞춤 열에서 함수 사용하기
피드 및 템플릿 맞춤 열에서 함수를 사용하려면 다음 단계를 따르세요.
메뉴에서 함수를 선택합니다. 입력 장치를 메뉴의 함수 위로 가져가면 함수에 관한 세부정보가 표시됩니다.
- 수식에 포함할 함수를 선택합니다. 함수의 서식이 지정된 텍스트는 검은색 자리표시자 요소와 함께 표시됩니다.
- 자리표시자 요소를 사용 사례와 관련된 정보로 바꿉니다. 예시는 로직 함수인 경우 및 텍스트 연결 함수를 참고하세요.
녹색의 텍스트는 수정하지 마세요. 함수의 필수 부분입니다.
템플릿을 만들 때 새 Search Ads 360에는 현재 컨텍스트에 유효한 함수만 표시됩니다.
로직 함수인 경우
if(조건, true인_경우_값, false인_경우_값)
이는 정의된 조건을 true 또는 false로 평가한 다음 조건이 true인지 false인지에 따라 true인_경우_값 및 false인_경우_값에 지정된 값을 출력하는 로직 함수입니다.
조건을 수정하여 평가할 기준을 정의합니다.true인_경우_값을 수정하여 조건이 true일 때 발생하는 결과를 정의합니다.false인_경우_값을 수정하여 조건이 false일 때 발생하는 결과를 정의합니다.
텍스트 연결 함수
concat("텍스트1", “텍스트2”)
값 두 개 이상의 콘텐츠를 병합하는 텍스트 함수입니다. 값을 추가하려면 쉼표와 추가 값을 차례로 삽입합니다. 값은 텍스트여야 하지만 다른 함수에서 파생될 수 있습니다. text_to 함수는 열 값을 텍스트로 변환합니다.
concat(“출발지 “, f:"출발지"),” 목적지 ”, f:"목적지_국가", f:"목적지_이름”,” - ”, text_to(f:"가격"))
함수 값 오류 해결하기
함수가 비어 있거나 잘못된 값을 반환하는 경우 새 Search Ads 360은 캠페인, 광고 및 기타 항목을 생성하지 않습니다. 오류를 해결하려면 다음 옵션을 사용하여 문제를 해결해 보세요.
if_error(매개변수,대체)
의 함수 래핑: 매개변수는 함수, 피드 열, 텍스트 또는 이들의 조합 중 하나일 수 있습니다. 함수가 오류를 반환하거나 비어 있으면대체가 대신 반환됩니다.
예:if_error(f:"브랜드", "브랜드 없음")
결과: 값이 있는 경우f:"브랜드", 없는 경우"브랜드 없음"을 반환합니다.
일반적으로 매개변수가 유효하지 않으면 함수 전체가 무효입니다.
예:if(f:"제품_유형" = "신발", 1, 2)
피드 항목에제품_유형이 없으면 if 표현식 전체가 무효가 됩니다.if함수 주변의 if_error함수를 래핑합니다.
예:if_error(if(f:'제품_유형" = "신발", 1, 2), 3)
결과: 피드 항목에제품_유형이 정의되어 있지 않으면 함수가 '3'을 반환합니다.
is_error에서 함수를 래핑합니다.
if(is_error(매개변수), 대체, 값)를 사용합니다.
매개변수는 피드 열 참조를 포함할 수 있습니다.f:”열_이름”은 피드 열을 참조합니다.
예를 들어 오류가 반환되는 경우 피드 열이 비어 있으면대체가 사용됩니다. 그렇지 않으면값이 사용됩니다.
- 집계를 사용합니다.
광고그룹마다 속성에 하나의 값만 포함되어 있지 않은 한min(값),max(값)또는any(값)를 사용합니다. 광고그룹에 다양한 가격의 제품이 포함될 수 있는 경우max(f:”가격”)를 지정합니다.
로직 오류 해결하기
로직 오류를 해결하려면 if(조건, true, false) 함수를 사용하여 원치 않는 결과를 필터링하거나 변경합니다. 예를 들어 if 함수를 사용하여 너무 긴 텍스트를 줄일 수 있습니다.