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)
  ],
  "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만 지원됩니다.
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 또는 MaxConversions (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 * [분수]입니다.
finalUrlSuffix

string

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

string (int64 format)

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

number

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

AdGroupStatus

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

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

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

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

AdGroupType

가능한 광고그룹 유형을 나열하는 열거형입니다.

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

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

응답 전용 값입니다.
SEARCH_STANDARD 검색 캠페인의 기본 광고그룹 유형입니다.
DISPLAY_STANDARD 디스플레이 캠페인의 기본 광고그룹 유형입니다.
SHOPPING_PRODUCT_ADS 일반 제품 광고를 게재하는 쇼핑 캠페인의 광고그룹 유형입니다.
HOTEL_ADS 호텔 캠페인의 기본 광고그룹 유형입니다.
SHOPPING_SMART_ADS 스마트 쇼핑 캠페인의 광고 그룹 유형입니다.
VIDEO_BUMPER 건너뛸 수 없는 짧은 인스트림 광고
VIDEO_TRUE_VIEW_IN_STREAM 건너뛸 수 있는 TrueView 인스트림 광고
VIDEO_TRUE_VIEW_IN_DISPLAY TrueView 디스플레이 동영상 광고
VIDEO_NON_SKIPPABLE_IN_STREAM 건너뛸 수 없는 인스트림 광고
VIDEO_OUTSTREAM 아웃스트림 동영상 광고
SEARCH_DYNAMIC_ADS 동적 검색 광고 광고그룹의 광고그룹 유형입니다.
SHOPPING_COMPARISON_LISTING_ADS 쇼핑 비교 등록정보 캠페인의 광고 그룹 유형입니다.
PROMOTED_HOTEL_ADS 프로모션 호텔 광고그룹의 광고그룹 유형입니다.
VIDEO_RESPONSIVE 동영상 반응형 광고그룹
VIDEO_EFFICIENT_REACH 동영상 효율적 잠재고객 도달 광고그룹
SMART_CAMPAIGN_ADS 스마트 캠페인의 광고그룹 유형입니다.
TRAVEL_ADS 여행 캠페인의 광고그룹 유형입니다.

AdGroupAdRotationMode

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

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

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

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

AudienceSetting

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

JSON 표현 
{
  "useAudienceGrouped": boolean
}
필드
useAudienceGrouped

boolean

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