AdGroupCriterion

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

JSON 표현 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
입력란
resourceName

string

변경할 수 없습니다. 광고그룹 기준의 리소스 이름입니다. 광고그룹 기준 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

출력 전용입니다. 기준의 표시 이름입니다.

이 필드는 변경 시 무시됩니다.
status

enum (AdGroupCriterionStatus)

기준의 상태입니다.

고객이 설정한 광고 그룹 기준 항목의 상태입니다. 참고: UI 보고서에는 기준 실행 가능 여부에 영향을 미치는 추가 정보가 포함될 수 있습니다. 일부 경우에는 API에서 삭제된 기준이 UI에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다.
qualityInfo

object (QualityInfo)

출력 전용입니다. 기준의 품질에 관한 정보입니다.
type

enum (CriterionType)

출력 전용입니다. 기준의 유형입니다.
systemServingStatus

enum (CriterionSystemServingStatus)

출력 전용입니다. 기준의 게재 상태입니다.
approvalStatus

enum (AdGroupCriterionApprovalStatus)

출력 전용입니다. 기준의 승인 상태입니다.
disapprovalReasons[]

string

출력 전용입니다. 기준의 비승인 사유 목록입니다.

기준을 거부하는 다양한 이유는 다음 페이지에서 확인할 수 있습니다. https://support.google.com/adspolicy/answer/6008942

이 필드는 읽기 전용입니다.
labels[]

string

출력 전용입니다. 이 광고 그룹 기준에 연결된 라벨의 리소스 이름입니다.
effectiveCpcBidSource

enum (BiddingSource)

출력 전용입니다. 유효 CPC 입찰가의 소스입니다.
effectiveCpmBidSource

enum (BiddingSource)

출력 전용입니다. 유효 CPM 입찰가의 소스입니다.
effectiveCpvBidSource

enum (BiddingSource)

출력 전용입니다. 유효 CPV 입찰가의 소스입니다.
effectivePercentCpcBidSource

enum (BiddingSource)

출력 전용입니다. 유효한 비율 CPC 입찰가의 소스입니다.
positionEstimates

object (PositionEstimates)

출력 전용입니다. 다양한 게재순위에서의 기준 입찰가 추정치
finalUrls[]

string

광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.
finalMobileUrls[]

string

모든 교차 도메인 리디렉션 후 사용 가능한 최종 모바일 URL의 목록입니다.
urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate, finalUrls 또는 mobile_final_urls에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다.
criterionId

string (int64 format)

출력 전용입니다. 기준의 ID입니다.

이 필드는 변경 시 무시됩니다.
adGroup

string

변경할 수 없습니다. 기준이 속한 광고그룹입니다.
negative

boolean

변경할 수 없습니다. 기준을 타겟팅 (false)할지 또는 제외 (true)할지 여부입니다.

이 필드는 변경할 수 없습니다. 기준을 포함에서 제외로 전환하려면 기준을 삭제한 후 다시 추가합니다.
bidModifier

number

기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다.
cpcBidMicros

string (int64 format)

CPC(클릭당비용) 입찰가입니다.
cpmBidMicros

string (int64 format)

CPM (조회 가능 1,000회 노출당비용) 입찰가입니다.
cpvBidMicros

string (int64 format)

CPV (조회당비용) 입찰가입니다.
percentCpcBidMicros

string (int64 format)

일부 상품 또는 서비스에 대해 광고된 가격의 비율로 표현되는 CPC 입찰가입니다. 분수의 유효한 범위는 [0,1)이며, 여기에 저장된 값은 1,000,000 * [fraction]입니다.
effectiveCpcBidMicros

string (int64 format)

출력 전용입니다. 유효 CPC(클릭당비용) 입찰가입니다.
effectiveCpmBidMicros

string (int64 format)

출력 전용입니다. 유효 CPM (1,000회 조회 가능 노출당 비용) 입찰가입니다.
effectiveCpvBidMicros

string (int64 format)

출력 전용입니다. 유효 CPV (조회당비용) 입찰가입니다.
effectivePercentCpcBidMicros

string (int64 format)

출력 전용입니다. 유효한 퍼센트 CPC 입찰가입니다.
finalUrlSuffix

string

최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다.
trackingUrlTemplate

string

추적 URL을 만들기 위한 URL 템플릿입니다.

통합 필드 criterion. 광고그룹 기준입니다.

정확히 1개를 설정해야 합니다. criterion는 다음 중 하나여야 합니다.
keyword

object (KeywordInfo)

변경할 수 없습니다. 키워드
placement

object (PlacementInfo)

변경할 수 없습니다. 게재위치.
mobileAppCategory

object (MobileAppCategoryInfo)

변경할 수 없습니다. 모바일 앱 카테고리입니다.
mobileApplication

object (MobileApplicationInfo)

변경할 수 없습니다. 모바일 애플리케이션
listingGroup

object (ListingGroupInfo)

변경할 수 없습니다. 등록정보 그룹입니다.
ageRange

object (AgeRangeInfo)

변경할 수 없습니다. 연령대
gender

object (GenderInfo)

변경할 수 없습니다. 성별.
incomeRange

object (IncomeRangeInfo)

변경할 수 없습니다. 소득 범위
parentalStatus

object (ParentalStatusInfo)

변경할 수 없습니다. 자녀 유무 상태.
userList

object (UserListInfo)

변경할 수 없습니다. 사용자 목록.
youtubeVideo

object (YouTubeVideoInfo)

변경할 수 없습니다. YouTube 동영상
youtubeChannel

object (YouTubeChannelInfo)

변경할 수 없습니다. YouTube 채널
topic

object (TopicInfo)

변경할 수 없습니다. 주제를 탭합니다.
userInterest

object (UserInterestInfo)

변경할 수 없습니다. 사용자 관심분야
webpage

object (WebpageInfo)

변경할 수 없습니다. 웹페이지
appPaymentModel

object (AppPaymentModelInfo)

변경할 수 없습니다. 앱 결제 모델
customAffinity

object (CustomAffinityInfo)

변경할 수 없습니다. 맞춤 관심분야
customIntent

object (CustomIntentInfo)

변경할 수 없습니다. 맞춤 의도
customAudience

object (CustomAudienceInfo)

변경할 수 없습니다. 맞춤 잠재고객
combinedAudience

object (CombinedAudienceInfo)

변경할 수 없습니다. 통합된 잠재고객
audience

object (AudienceInfo)

변경할 수 없습니다. 잠재고객:
location

object (LocationInfo)

변경할 수 없습니다. 위치를 탭합니다.
language

object (LanguageInfo)

변경할 수 없습니다. 언어

AdGroupCriterionStatus

AdGroupCriterion의 가능한 상태입니다.

열거형
UNSPECIFIED 값이 지정되지 않았습니다.
UNKNOWN

수신된 값을 이 버전에서 알 수 없습니다.

이 값은 응답 전용입니다.
ENABLED 광고그룹 기준이 사용 설정되었습니다.
PAUSED 광고그룹 기준이 일시중지되었습니다.
REMOVED 광고그룹 기준이 삭제됩니다.

QualityInfo

광고그룹 기준 품질 정보를 위한 컨테이너입니다.

JSON 표현 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
입력란
creativeQualityScore

enum (QualityScoreBucket)

출력 전용입니다. 다른 광고주와 비교한 광고 실적입니다.
postClickQualityScore

enum (QualityScoreBucket)

출력 전용입니다. 방문 페이지의 품질평가점수입니다.
searchPredictedCtr

enum (QualityScoreBucket)

출력 전용입니다. 다른 광고주와 비교한 클릭률입니다.
qualityScore

integer

출력 전용입니다. 품질평가점수입니다.

Google에서 값을 결정하기 위한 정보가 충분하지 않으면 이 필드가 채워지지 않을 수 있습니다.

CriterionSystemServingStatus

기준 시스템 게재 상태를 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
ELIGIBLE 운영 가능.
RARELY_SERVED 검색량이 적습니다.

AdGroupCriterionApprovalStatus

AdGroupCriterion 승인 상태를 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
APPROVED 승인됨.
DISAPPROVED 비승인됨.
PENDING_REVIEW 검토 대기 중
UNDER_REVIEW 검토중

PositionEstimates

다양한 게재순위에서의 기준 입찰가 추정치

JSON 표현 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
입력란
firstPageCpcMicros

string (int64 format)

출력 전용입니다. 검색결과 첫 페이지에 광고가 게재되는 데 필요한 예상 CPC 입찰가입니다.
firstPositionCpcMicros

string (int64 format)

출력 전용입니다. 검색결과 첫 페이지의 상단, 첫 번째 위치에 광고를 게재하는 데 필요한 예상 CPC 입찰가입니다.
topOfPageCpcMicros

string (int64 format)

출력 전용입니다. 검색결과 첫 페이지의 상단에 광고를 게재하는 데 필요한 예상 CPC 입찰가입니다.
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

출력 전용입니다. 키워드 입찰가를 firstPositionCpcMicros의 값으로 변경할 경우 예상되는 주당 클릭수를 추정합니다.
estimatedAddCostAtFirstPositionCpc

string (int64 format)

출력 전용입니다. 키워드 입찰가를 firstPositionCpcMicros의 값으로 변경할 경우 예상되는 주당 비용의 예상치입니다.

ListingGroupInfo

등록정보 그룹 기준입니다.

JSON 표현 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
입력란
type

enum (ListingGroupType)

목록 그룹의 유형입니다.
caseValue

object (ListingDimensionInfo)

이 등록정보 그룹에서 상위 항목을 수정하는 데 사용하는 측정기준 값입니다. 루트 그룹에 대해 정의되지 않았습니다.
parentAdGroupCriterion

string

상위 등록정보 그룹의 하위 그룹인 광고그룹 기준의 리소스 이름입니다. 루트 그룹의 경우 null입니다.
path

object (ListingDimensionPath)

이 등록정보 그룹을 정의하는 측정기준의 경로입니다.

ListingGroupType

등록정보 그룹의 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
SUBDIVISION 일부 등록정보 측정기준에 따른 제품의 하위 분류입니다. 이러한 노드는 나열 항목을 타겟팅하는 데 사용되지 않으며 순전히 트리 구조를 정의하는 데 사용됩니다.
UNIT 입찰가를 정의하는 등록정보 그룹 단위입니다.

ListingDimensionPath

등록정보 그룹을 정의하는 측정기준 경로입니다.

JSON 표현 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
입력란
dimensions[]

object (ListingDimensionInfo)

루트 (루트 자체 제외)에서 이 등록정보 그룹까지 등록정보 그룹 계층 구조를 거치는 측정기준의 전체 경로입니다.

AppPaymentModelInfo

앱 결제 모델 기준

JSON 표현 
{
  "type": enum (AppPaymentModelType)
}
입력란
type

enum (AppPaymentModelType)

앱 결제 모델의 유형입니다.

AppPaymentModelType

가능한 앱 결제 모델을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
PAID 유료 앱을 나타냅니다.

CustomIntentInfo

맞춤 인텐트 기준입니다. 이 유형의 기준은 타겟팅만 가능합니다.

JSON 표현 
{
  "customIntent": string
}
입력란
customIntent

string

CustomInterest 리소스 이름입니다.