ad_group_criterion

광고 그룹 기준입니다. ad_group_criterion 보고서는 광고 그룹에 명시적으로 추가된 기준만 반환합니다.

기여 리소스
ad_group
campaign
customer
user_list

위 리소스의 필드는 SELECT 및 WHERE 절에서 이 리소스와 함께 선택할 수 있습니다. 이러한 필드는 SELECT 절의 측정항목을 분할하지 않습니다.

ad_group_criterion.ad_group 필드 설명 기준이 속한 광고 그룹입니다. 카테고리 ATTRIBUTE 데이터 유형 RESOURCE_NAME URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 거짓 Repeated 거짓

ad_group_criterion.age_range.type 필드 설명 연령대의 유형입니다. 카테고리 ATTRIBUTE 데이터 유형 ENUM AGE_RANGE_18_24 AGE_RANGE_25_34 AGE_RANGE_35_44 AGE_RANGE_45_54 AGE_RANGE_55_64 AGE_RANGE_65_UP AGE_RANGE_UNDETERMINED UNKNOWN UNSPECIFIED URL 입력 google.ads.searchads360.v0.enums.AgeRangeTypeEnum.AgeRangeType 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.bid_modifier 필드 설명 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. 카테고리 ATTRIBUTE 데이터 유형 DOUBLE URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.cpc_bid_micros 필드 설명 CPC(클릭당비용) 입찰가입니다. 카테고리 ATTRIBUTE 데이터 유형 INT64 URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.creation_time 필드 설명 이 광고 그룹 기준이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다. 카테고리 ATTRIBUTE 데이터 유형 DATE URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.criterion_id 필드 설명 기준의 ID입니다. 카테고리 ATTRIBUTE 데이터 유형 INT64 URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.effective_cpc_bid_micros 필드 설명 유효 CPC(클릭당비용) 입찰가입니다. 카테고리 ATTRIBUTE 데이터 유형 INT64 URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.effective_labels 필드 설명 이 광고 그룹 기준에 연결된 유효 라벨의 리소스 이름입니다. 유효 라벨은 이 광고 그룹 기준에 상속되거나 직접 할당된 라벨입니다. 카테고리 ATTRIBUTE 데이터 유형 RESOURCE_NAME URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 거짓 Repeated 참

ad_group_criterion.engine_id 필드 설명 외부 엔진 계정의 광고그룹 기준 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "ad_group_criterion.criterion_id"를 사용하세요. 카테고리 ATTRIBUTE 데이터 유형 STRING URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.engine_status 필드 설명 광고 그룹 기준의 엔진 상태입니다. 카테고리 ATTRIBUTE 데이터 유형 ENUM AD_GROUP_CRITERION_ACCOUNT_PAUSED AD_GROUP_CRITERION_APPROVED AD_GROUP_CRITERION_DISAPPROVED AD_GROUP_CRITERION_ELIGIBLE AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH AD_GROUP_CRITERION_INVALID_PC_SEARCH AD_GROUP_CRITERION_INVALID_SEARCH AD_GROUP_CRITERION_LOW_SEARCH_VOLUME AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW AD_GROUP_CRITERION_NOT_REVIEWED AD_GROUP_CRITERION_ON_HOLD AD_GROUP_CRITERION_PARTIALLY_INVALID AD_GROUP_CRITERION_PAUSED AD_GROUP_CRITERION_PENDING_REVIEW AD_GROUP_CRITERION_REMOVED AD_GROUP_CRITERION_SERVING AD_GROUP_CRITERION_TO_BE_ACTIVATED AD_GROUP_CRITERION_UNDER_REVIEW UNKNOWN UNSPECIFIED URL 입력 google.ads.searchads360.v0.enums.AdGroupCriterionEngineStatusEnum.AdGroupCriterionEngineStatus 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.final_mobile_urls 필드 설명 모든 교차 도메인 리디렉션 이후에 가능한 최종 모바일 URL 목록입니다. 카테고리 ATTRIBUTE 데이터 유형 STRING URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 거짓 Repeated 참

ad_group_criterion.final_url_suffix 필드 설명 최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다. 카테고리 ATTRIBUTE 데이터 유형 STRING URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.final_urls 필드 설명 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. 카테고리 ATTRIBUTE 데이터 유형 STRING URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 거짓 Repeated 참

ad_group_criterion.gender.type 필드 설명 성별 유형입니다. 카테고리 ATTRIBUTE 데이터 유형 ENUM FEMALE MALE UNDETERMINED UNKNOWN UNSPECIFIED URL 입력 google.ads.searchads360.v0.enums.GenderTypeEnum.GenderType 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.keyword.match_type 필드 설명 키워드의 일치 유형입니다. 카테고리 ATTRIBUTE 데이터 유형 ENUM BROAD EXACT PHRASE UNKNOWN UNSPECIFIED URL 입력 google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.keyword.text 필드 설명 키워드의 텍스트입니다(최대 80자 및 10개 단어). 카테고리 ATTRIBUTE 데이터 유형 STRING URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.labels 필드 설명 이 광고 그룹 기준에 연결된 라벨의 리소스 이름입니다. 카테고리 ATTRIBUTE 데이터 유형 RESOURCE_NAME URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 거짓 Repeated 참

ad_group_criterion.last_modified_time 필드 설명 이 광고 그룹 기준이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다. 카테고리 ATTRIBUTE 데이터 유형 DATE URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.listing_group.type 필드 설명 목록 그룹의 유형입니다. 카테고리 ATTRIBUTE 데이터 유형 ENUM SUBDIVISION UNIT UNKNOWN UNSPECIFIED URL 입력 google.ads.searchads360.v0.enums.ListingGroupTypeEnum.ListingGroupType 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.location.geo_target_constant 필드 설명 지역 대상 상수 리소스 이름입니다. 카테고리 ATTRIBUTE 데이터 유형 RESOURCE_NAME URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 거짓 Repeated 거짓

ad_group_criterion.negative 필드 설명 기준을 타겟팅할지 (false) 제외할지 (true) 여부입니다. 이 필드는 변경할 수 없습니다. 기준을 긍정에서 부정으로 전환하려면 기준을 삭제한 후 다시 추가하세요. 카테고리 ATTRIBUTE 데이터 유형 BOOLEAN URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.position_estimates.top_of_page_cpc_micros 필드 설명 검색 결과 첫 페이지 상단에 광고가 게재되는 데 필요한 CPC 입찰가의 예상치입니다. 카테고리 ATTRIBUTE 데이터 유형 INT64 URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.quality_info.quality_score 필드 설명 품질평가점수입니다. Google에서 값을 결정하기 위한 정보가 충분하지 않으면 이 필드가 채워지지 않을 수 있습니다. 카테고리 ATTRIBUTE 데이터 유형 INT32 URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.resource_name 필드 설명 광고 그룹 기준의 리소스 이름입니다. 광고 그룹 기준 리소스 이름의 형식은 customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}입니다. 카테고리 ATTRIBUTE 데이터 유형 RESOURCE_NAME URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 거짓 Repeated 거짓

ad_group_criterion.status 필드 설명 기준의 상태입니다. 고객이 설정한 광고 그룹 기준 항목의 상태입니다. 참고: UI 보고서에는 기준 실행 가능 여부에 영향을 미치는 추가 정보가 포함될 수 있습니다. 일부 경우에는 API에서 삭제된 기준이 UI에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다. 카테고리 ATTRIBUTE 데이터 유형 ENUM ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED URL 입력 google.ads.searchads360.v0.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.tracking_url_template 필드 설명 추적 URL을 만들기 위한 URL 템플릿입니다. 카테고리 ATTRIBUTE 데이터 유형 STRING URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.type 필드 설명 기준의 유형입니다. 카테고리 ATTRIBUTE 데이터 유형 ENUM AD_SCHEDULE AGE_RANGE APP_PAYMENT_MODEL AUDIENCE BRAND BRAND_LIST CARRIER COMBINED_AUDIENCE CONTENT_LABEL CUSTOM_AFFINITY CUSTOM_AUDIENCE CUSTOM_INTENT DEVICE GENDER INCOME_RANGE IP_BLOCK KEYWORD KEYWORD_THEME LANGUAGE LIFE_EVENT LISTING_GROUP LISTING_SCOPE LOCAL_SERVICE_ID LOCATION LOCATION_GROUP MOBILE_APPLICATION MOBILE_APP_CATEGORY MOBILE_DEVICE OPERATING_SYSTEM_VERSION PARENTAL_STATUS PLACEMENT PROXIMITY TOPIC UNKNOWN UNSPECIFIED USER_INTEREST USER_LIST WEBPAGE YOUTUBE_CHANNEL YOUTUBE_VIDEO URL 입력 google.ads.searchads360.v0.enums.CriterionTypeEnum.CriterionType 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.url_custom_parameters 필드 설명 tracking_url_template, final_urls 또는 mobile_final_urls에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다. 카테고리 ATTRIBUTE 데이터 유형 MESSAGE URL 입력 google.ads.searchads360.v0.common.CustomParameter 필터링 가능 거짓 선택 가능 참 Sortable 거짓 Repeated 참

ad_group_criterion.user_list.user_list 필드 설명 사용자 목록 리소스 이름입니다. 카테고리 ATTRIBUTE 데이터 유형 RESOURCE_NAME URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 거짓 Repeated 거짓

ad_group_criterion.webpage.conditions 필드 설명 웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다. 카테고리 ATTRIBUTE 데이터 유형 MESSAGE URL 입력 google.ads.searchads360.v0.common.WebpageConditionInfo 필터링 가능 거짓 선택 가능 참 Sortable 거짓 Repeated 참

ad_group_criterion.webpage.coverage_percentage 필드 설명 웹사이트 기준 노출 범위 비율입니다. 광고 그룹 및 캠페인에서 웹사이트 대상, 제외 웹사이트 대상, 제외 키워드를 기반으로 계산된 웹사이트 노출 범위 비율입니다. 예를 들어 노출 범위가 1로 반환되었으면 노출 범위가 100%입니다. 이 필드는 읽기 전용입니다. 카테고리 ATTRIBUTE 데이터 유형 DOUBLE URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓

ad_group_criterion.webpage.criterion_name 필드 설명 이 매개변수로 정의된 기준의 이름입니다. 이름 값은 이러한 유형의 매개변수로 기준을 식별, 정렬, 필터링하는 데 사용됩니다. 이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다. 카테고리 ATTRIBUTE 데이터 유형 STRING URL 입력 N/A 필터링 가능 참 선택 가능 참 Sortable 참 Repeated 거짓