AdGroup

광고그룹입니다.

JSON 표현 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}
입력란
resourceName

string

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

customers/{customerId}/adGroups/{adGroupId}
status

enum (AdGroupStatus)

광고 그룹의 상태입니다.
type

enum (AdGroupType)

변경할 수 없습니다. 광고 그룹의 유형입니다.
adRotationMode

enum (AdGroupAdRotationMode)

광고그룹의 광고 로테이션 모드입니다.
urlCustomParameters[]

object (CustomParameter)

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

boolean

타겟팅 최적화가 사용 설정되어 있으면 true입니다. 타겟팅 최적화는 잠재고객 확장을 대체합니다.
displayCustomBidDimension

enum (TargetingDimension)

광고주가 절대 입찰가를 배치할 타겟팅 측정기준을 지정할 수 있습니다. 이는 검색 네트워크를 타겟팅하지 않고 디스플레이 네트워크만 타겟팅하는 캠페인에만 적용됩니다.
targetingSetting

object (TargetingSetting)

관련 기능을 타겟팅하기 위한 설정입니다.
audienceSetting

object (AudienceSetting)

변경할 수 없습니다. 잠재고객 관련 기능의 설정입니다.
effectiveTargetCpaSource

enum (BiddingSource)

출력 전용입니다. 효과적인 타겟 CPA의 소스입니다. 이 필드는 읽기 전용입니다.
effectiveTargetRoasSource

enum (BiddingSource)

출력 전용입니다. 효과적인 타겟 광고 투자수익(ROAS)의 소스입니다. 이 필드는 읽기 전용입니다.
labels[]

string

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

enum (AssetFieldType)

이 광고그룹에서 제외해야 하는 확장 소재 입력란 유형입니다. 이러한 입력란 유형의 애셋 링크는 상위 수준에서 이 광고그룹에 상속되지 않습니다.
excludedParentAssetSetTypes[]

enum (AssetSetType)

이 광고그룹에서 제외해야 하는 애셋 세트 유형입니다. 이러한 유형의 애셋 세트 링크는 상위 수준에서 이 광고그룹에 상속되지 않습니다. 위치 그룹 유형 (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, STATIC_LOCATION_GROUP)은 LOCATION_SYNC의 하위 유형입니다. 따라서 이 필드에 LOCATION_SYNC가 설정된 경우 모든 위치 그룹 애셋 세트를 이 광고그룹에 연결할 수 없으며, 모든 위치 광고 확장 (LE) 및 제휴사 위치 광고 확장 (ALE)이 이 광고그룹에 게재되지 않습니다. 현재 LOCATION_SYNC만 지원됩니다.
primaryStatus

enum (AdGroupPrimaryStatus)

출력 전용입니다. 광고그룹이 최적으로 게재되지 않거나 게재되지 않는 이유를 집계하여 보여줍니다.
primaryStatusReasons[]

enum (AdGroupPrimaryStatusReason)

출력 전용입니다. 광고그룹이 제대로 게재되지 않거나 게재되지 않는 이유를 제공합니다.
id

string (int64 format)

출력 전용입니다. 광고 그룹의 ID입니다.
name

string

광고 그룹의 이름입니다.

이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다.

255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다.

null(코드 포인트 0x0), NL 라인 피드(코드 포인트 0xA), 캐리지 리턴(코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
baseAdGroup

string

출력 전용입니다. 임시 또는 실험 광고그룹의 경우 이 필드는 이 광고그룹이 생성된 기본 광고그룹의 리소스 이름입니다. 임시 또는 실험 광고그룹에 기본 광고그룹이 없으면 이 필드는 null입니다.

기본 광고그룹의 경우 이 필드는 광고그룹 리소스 이름과 동일합니다.

이 필드는 읽기 전용입니다.
trackingUrlTemplate

string

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

string

변경할 수 없습니다. 광고그룹이 속한 캠페인입니다.
cpcBidMicros

string (int64 format)

최대 CPC(클릭당비용) 입찰가입니다.
effectiveCpcBidMicros

string (int64 format)

출력 전용입니다. 입찰 전략이 수동 CPC, 향상된 CPC 입찰기능, 첫 페이지 프로모션 또는 경쟁 광고보다 높은 순위를 얻기 위한 타겟 노출 점유율 중 하나인 경우 값은 CPC (클릭당비용) 입찰가 값과 동일합니다. 그렇지 않으면 값은 null입니다.
cpmBidMicros

string (int64 format)

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

string (int64 format)

타겟 CPA (전환당비용)입니다. 광고그룹의 캠페인 입찰 전략이 TargetCpa 또는 최대전환 (targetCpa 필드 집합)인 경우 이 필드는 캠페인의 입찰 전략에 지정된 타겟 CPA를 재정의합니다. 그렇지 않으면 이 값은 무시됩니다.
cpvBidMicros

string (int64 format)

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

string (int64 format)

광고가 1,000회 게재될 때마다 광고주가 지불하고자 하는 평균 금액입니다(단위: 마이크로 단위).
targetRoas

number

타겟 ROAS (광고 투자수익) 재정의 광고그룹의 캠페인 입찰 전략이 TargetRoas 또는 MaxConversionValue (targetRoas 필드 설정됨)인 경우, 이 필드는 캠페인의 입찰 전략에 지정된 타겟 ROAS를 재정의합니다. 그렇지 않으면 이 값은 무시됩니다.
percentCpcBidMicros

string (int64 format)

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

string

최종 URL에 매개변수를 추가하기 위한 URL 템플릿
effectiveTargetCpaMicros

string (int64 format)

출력 전용입니다. 효과적인 타겟 CPA (전환당비용)입니다. 이 필드는 읽기 전용입니다.
effectiveTargetRoas

number

출력 전용입니다. 유효 타겟 광고 투자수익 (ROAS)입니다. 이 필드는 읽기 전용입니다.

AdGroupStatus

광고그룹의 가능한 상태입니다.

열거형
UNSPECIFIED 상태가 지정되지 않았습니다.
UNKNOWN

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

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

AdGroupAdRotationMode

광고그룹에서 사용할 수 있는 광고 로테이션 모드입니다.

열거형
UNSPECIFIED 광고 로테이션 모드가 지정되지 않았습니다.
UNKNOWN

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

이 값은 응답 전용입니다.
OPTIMIZE 클릭수 또는 전환수를 기준으로 광고그룹 광고를 최적화합니다.
ROTATE_FOREVER 영구 로테이션

AudienceSetting

잠재고객 타겟팅 설정입니다.

JSON 표현 
{
  "useAudienceGrouped": boolean
}
입력란
useAudienceGrouped

boolean

변경할 수 없습니다. true인 경우 이 광고그룹은 잠재고객 타겟팅에 잠재고객 리소스를 사용합니다. false인 경우 이 광고그룹에서 잠재고객 세그먼트 기준을 대신 사용할 수 있습니다.

AdGroupPrimaryStatus

광고그룹의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ELIGIBLE 광고 그룹에서 광고를 게재할 수 있습니다.
PAUSED 광고그룹이 일시중지되었습니다.
REMOVED 광고그룹이 삭제됩니다.
PENDING 광고그룹은 향후에 게재될 수 있습니다.
NOT_ELIGIBLE 해당 광고그룹은 광고를 게재할 수 없습니다.
LIMITED 광고그룹의 게재 가능성이 제한적입니다.

AdGroupPrimaryStatusReason

광고그룹 상태가 발생할 수 있는 이유입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CAMPAIGN_REMOVED 사용자가 지정한 캠페인 상태가 삭제됩니다. AdGroupPrimaryStatus.NOT_ELIGIBLE에 기여합니다.
CAMPAIGN_PAUSED 사용자 지정 캠페인 상태가 일시중지되었습니다. AdGroupPrimaryStatus.NOT_ELIGIBLE에 기여합니다.
CAMPAIGN_PENDING 사용자가 캠페인을 시작하도록 지정한 시간이 미래입니다. AdGroupPrimaryStatus.NOT_ELIGIBLE에 기여합니다.
CAMPAIGN_ENDED 사용자가 지정한 캠페인 종료 시간이 지났습니다. AdGroupPrimaryStatus.NOT_ELIGIBLE에 기여합니다.
AD_GROUP_PAUSED 사용자 지정 광고그룹 상태가 일시중지되었습니다. AdGroupPrimaryStatus.PAUSED에 기여합니다.
AD_GROUP_REMOVED 사용자가 지정한 광고그룹 상태가 삭제됩니다. AdGroupPrimaryStatus.REMOVED에 기여합니다.
AD_GROUP_INCOMPLETE 이 광고그룹의 생성이 아직 완료되지 않았습니다. AdGroupPrimaryStatus.NOT_ELIGIBLE에 기여합니다.
KEYWORDS_PAUSED 이 광고그룹의 사용자 지정 키워드 상태가 모두 일시중지되었습니다. AdGroupPrimaryStatus.NOT_ELIGIBLE에 기여합니다.
NO_KEYWORDS 이 광고그룹에 운영 가능한 키워드가 없습니다. AdGroupPrimaryStatus.NOT_ELIGIBLE에 기여합니다.
AD_GROUP_ADS_PAUSED 이 광고그룹의 사용자 지정 광고그룹 광고 상태가 모두 일시중지되었습니다. AdGroupPrimaryStatus.NOT_ELIGIBLE에 기여합니다.
NO_AD_GROUP_ADS 이 광고그룹에 운영 가능한 광고그룹 광고가 없습니다. AdGroupPrimaryStatus.NOT_ELIGIBLE에 기여합니다.
HAS_ADS_DISAPPROVED 하나 이상의 광고가 비승인된 경우 정책 상태의 이유입니다. 여러 AdGroupPrimaryStatus에 영향을 미칩니다.
HAS_ADS_LIMITED_BY_POLICY 하나 이상의 광고가 정책에 의해 제한된 경우 정책 상태의 이유입니다. 여러 AdGroupPrimaryStatus에 영향을 미칩니다.
MOST_ADS_UNDER_REVIEW 대부분의 광고가 검토 대기 중인 경우 정책 상태의 이유입니다. AdGroupPrimaryStatus.PENDING에 기여합니다.
CAMPAIGN_DRAFT 광고그룹이 임시 캠페인에 속해 있습니다. AdGroupPrimaryStatus.NOT_ELIGIBLE에 기여합니다.
AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY 광고 게재가 장기간 저조하여 광고그룹이 일시중지되었습니다. AdGroupPrimaryStatus.PAUSED에 기여합니다.