- JSON 표현
- AdGroupCriterionStatus
- QualityInfo
- CriterionSystemServingStatus
- AdGroupCriterionApprovalStatus
- PositionEstimates
- ListingGroupInfo
- ListingGroupType
- ListingDimensionPath
- AppPaymentModelInfo
- AppPaymentModelType
- CustomIntentInfo
광고그룹 기준입니다. adGroupCriterion 보고서는 광고그룹에 명시적으로 추가된 기준만 반환합니다.
JSON 표현 |
---|
{ "resourceName": string, "displayName": string, "status": enum ( |
입력란 | |
---|---|
resourceName |
변경할 수 없습니다. 광고그룹 기준의 리소스 이름입니다. 광고그룹 기준 리소스 이름의 형식은 다음과 같습니다.
|
displayName |
출력 전용입니다. 기준의 표시 이름입니다. 이 필드는 변경 시 무시됩니다. |
status |
기준의 상태입니다. 고객이 설정한 광고 그룹 기준 항목의 상태입니다. 참고: UI 보고서에는 기준 실행 가능 여부에 영향을 미치는 추가 정보가 포함될 수 있습니다. 일부 경우에는 API에서 삭제된 기준이 UI에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다. |
qualityInfo |
출력 전용입니다. 기준의 품질에 관한 정보입니다. |
type |
출력 전용입니다. 기준의 유형입니다. |
systemServingStatus |
출력 전용입니다. 기준의 게재 상태입니다. |
approvalStatus |
출력 전용입니다. 기준의 승인 상태입니다. |
disapprovalReasons[] |
출력 전용입니다. 기준의 비승인 사유 목록입니다. 기준을 거부하는 다양한 이유는 다음 페이지에서 확인할 수 있습니다. https://support.google.com/adspolicy/answer/6008942 이 필드는 읽기 전용입니다. |
labels[] |
출력 전용입니다. 이 광고 그룹 기준에 연결된 라벨의 리소스 이름입니다. |
effectiveCpcBidSource |
출력 전용입니다. 유효 CPC 입찰가의 소스입니다. |
effectiveCpmBidSource |
출력 전용입니다. 유효 CPM 입찰가의 소스입니다. |
effectiveCpvBidSource |
출력 전용입니다. 유효 CPV 입찰가의 소스입니다. |
effectivePercentCpcBidSource |
출력 전용입니다. 유효한 비율 CPC 입찰가의 소스입니다. |
positionEstimates |
출력 전용입니다. 다양한 게재순위에서의 기준 입찰가 추정치 |
finalUrls[] |
광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. |
finalMobileUrls[] |
모든 교차 도메인 리디렉션 후 사용 가능한 최종 모바일 URL의 목록입니다. |
urlCustomParameters[] |
|
criterionId |
출력 전용입니다. 기준의 ID입니다. 이 필드는 변경 시 무시됩니다. |
adGroup |
변경할 수 없습니다. 기준이 속한 광고그룹입니다. |
negative |
변경할 수 없습니다. 기준을 타겟팅 ( 이 필드는 변경할 수 없습니다. 기준을 포함에서 제외로 전환하려면 기준을 삭제한 후 다시 추가합니다. |
bidModifier |
기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. |
cpcBidMicros |
CPC(클릭당비용) 입찰가입니다. |
cpmBidMicros |
CPM (조회 가능 1,000회 노출당비용) 입찰가입니다. |
cpvBidMicros |
CPV (조회당비용) 입찰가입니다. |
percentCpcBidMicros |
일부 상품 또는 서비스에 대해 광고된 가격의 비율로 표현되는 CPC 입찰가입니다. 분수의 유효한 범위는 [0,1)이며, 여기에 저장된 값은 1,000,000 * [fraction]입니다. |
effectiveCpcBidMicros |
출력 전용입니다. 유효 CPC(클릭당비용) 입찰가입니다. |
effectiveCpmBidMicros |
출력 전용입니다. 유효 CPM (1,000회 조회 가능 노출당 비용) 입찰가입니다. |
effectiveCpvBidMicros |
출력 전용입니다. 유효 CPV (조회당비용) 입찰가입니다. |
effectivePercentCpcBidMicros |
출력 전용입니다. 유효한 퍼센트 CPC 입찰가입니다. |
finalUrlSuffix |
최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다. |
trackingUrlTemplate |
추적 URL을 만들기 위한 URL 템플릿입니다. |
통합 필드 정확히 1개를 설정해야 합니다. |
|
keyword |
변경할 수 없습니다. 키워드 |
placement |
변경할 수 없습니다. 게재위치. |
mobileAppCategory |
변경할 수 없습니다. 모바일 앱 카테고리입니다. |
mobileApplication |
변경할 수 없습니다. 모바일 애플리케이션 |
listingGroup |
변경할 수 없습니다. 등록정보 그룹입니다. |
ageRange |
변경할 수 없습니다. 연령대 |
gender |
변경할 수 없습니다. 성별. |
incomeRange |
변경할 수 없습니다. 소득 범위 |
parentalStatus |
변경할 수 없습니다. 자녀 유무 상태. |
userList |
변경할 수 없습니다. 사용자 목록. |
youtubeVideo |
변경할 수 없습니다. YouTube 동영상 |
youtubeChannel |
변경할 수 없습니다. YouTube 채널 |
topic |
변경할 수 없습니다. 주제를 탭합니다. |
userInterest |
변경할 수 없습니다. 사용자 관심분야 |
webpage |
변경할 수 없습니다. 웹페이지 |
appPaymentModel |
변경할 수 없습니다. 앱 결제 모델 |
customAffinity |
변경할 수 없습니다. 맞춤 관심분야 |
customIntent |
변경할 수 없습니다. 맞춤 의도 |
customAudience |
변경할 수 없습니다. 맞춤 잠재고객 |
combinedAudience |
변경할 수 없습니다. 통합된 잠재고객 |
audience |
변경할 수 없습니다. 잠재고객: |
location |
변경할 수 없습니다. 위치를 탭합니다. |
language |
변경할 수 없습니다. 언어 |
AdGroupCriterionStatus
AdGroupCriterion의 가능한 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
값이 지정되지 않았습니다. |
UNKNOWN |
수신된 값을 이 버전에서 알 수 없습니다. 이 값은 응답 전용입니다. |
ENABLED |
광고그룹 기준이 사용 설정되었습니다. |
PAUSED |
광고그룹 기준이 일시중지되었습니다. |
REMOVED |
광고그룹 기준이 삭제됩니다. |
QualityInfo
광고그룹 기준 품질 정보를 위한 컨테이너입니다.
JSON 표현 |
---|
{ "creativeQualityScore": enum ( |
입력란 | |
---|---|
creativeQualityScore |
출력 전용입니다. 다른 광고주와 비교한 광고 실적입니다. |
postClickQualityScore |
출력 전용입니다. 방문 페이지의 품질평가점수입니다. |
searchPredictedCtr |
출력 전용입니다. 다른 광고주와 비교한 클릭률입니다. |
qualityScore |
출력 전용입니다. 품질평가점수입니다. 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 |
출력 전용입니다. 검색결과 첫 페이지에 광고가 게재되는 데 필요한 예상 CPC 입찰가입니다. |
firstPositionCpcMicros |
출력 전용입니다. 검색결과 첫 페이지의 상단, 첫 번째 위치에 광고를 게재하는 데 필요한 예상 CPC 입찰가입니다. |
topOfPageCpcMicros |
출력 전용입니다. 검색결과 첫 페이지의 상단에 광고를 게재하는 데 필요한 예상 CPC 입찰가입니다. |
estimatedAddClicksAtFirstPositionCpc |
출력 전용입니다. 키워드 입찰가를 firstPositionCpcMicros의 값으로 변경할 경우 예상되는 주당 클릭수를 추정합니다. |
estimatedAddCostAtFirstPositionCpc |
출력 전용입니다. 키워드 입찰가를 firstPositionCpcMicros의 값으로 변경할 경우 예상되는 주당 비용의 예상치입니다. |
ListingGroupInfo
등록정보 그룹 기준입니다.
JSON 표현 |
---|
{ "type": enum ( |
입력란 | |
---|---|
type |
목록 그룹의 유형입니다. |
caseValue |
이 등록정보 그룹에서 상위 항목을 수정하는 데 사용하는 측정기준 값입니다. 루트 그룹에 대해 정의되지 않았습니다. |
parentAdGroupCriterion |
상위 등록정보 그룹의 하위 그룹인 광고그룹 기준의 리소스 이름입니다. 루트 그룹의 경우 null입니다. |
path |
이 등록정보 그룹을 정의하는 측정기준의 경로입니다. |
ListingGroupType
등록정보 그룹의 유형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
SUBDIVISION |
일부 등록정보 측정기준에 따른 제품의 하위 분류입니다. 이러한 노드는 나열 항목을 타겟팅하는 데 사용되지 않으며 순전히 트리 구조를 정의하는 데 사용됩니다. |
UNIT |
입찰가를 정의하는 등록정보 그룹 단위입니다. |
ListingDimensionPath
등록정보 그룹을 정의하는 측정기준 경로입니다.
JSON 표현 |
---|
{
"dimensions": [
{
object ( |
입력란 | |
---|---|
dimensions[] |
루트 (루트 자체 제외)에서 이 등록정보 그룹까지 등록정보 그룹 계층 구조를 거치는 측정기준의 전체 경로입니다. |
AppPaymentModelInfo
앱 결제 모델 기준
JSON 표현 |
---|
{
"type": enum ( |
입력란 | |
---|---|
type |
앱 결제 모델의 유형입니다. |
AppPaymentModelType
가능한 앱 결제 모델을 설명하는 열거형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
PAID |
유료 앱을 나타냅니다. |
CustomIntentInfo
맞춤 인텐트 기준입니다. 이 유형의 기준은 타겟팅만 가능합니다.
JSON 표현 |
---|
{ "customIntent": string } |
입력란 | |
---|---|
customIntent |
CustomInterest 리소스 이름입니다. |