Package google.ads.searchads360.v0.resources

string

액세스 가능한 입찰 전략의 리소스 이름입니다. AccessibleBiddingStrategy 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

int64

입찰 전략의 ID입니다.

string

입찰 전략의 이름입니다.

BiddingStrategyType

입찰 전략의 유형입니다.

int64

입찰 전략을 소유한 고객의 ID입니다.

string

입찰 전략을 소유한 고객의 설명자 이름.

MaximizeConversionValue

캠페인의 전환 가치를 최대한 높일 수 있는 방향으로 예산이 지출되는 자동 입찰 전략입니다.

MaximizeConversions

캠페인에서 가장 많은 전환이 발생하는 방향으로 예산이 지출되는 자동 입찰 전략입니다.

TargetCpa

설정된 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

TargetImpressionShare

선택한 노출수 비율에 맞춰 자동으로 최적화하는 입찰 전략입니다.

TargetRoas

특정 타겟 광고 투자수익 (ROAS)을 평균화하면서 수익을 극대화하는 입찰 전략입니다.

TargetSpend

예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

double

타겟 광고 투자수익 (ROAS) 옵션입니다. 이 옵션을 설정하면 입찰 전략이 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 극대화합니다. 타겟 광고 투자수익(ROAS)이 높으면 입찰 전략에서 예산 전체를 지출하지 못할 수 있습니다. 타겟 광고 투자수익(ROAS)을 설정하지 않으면 입찰 전략은 예산 내에서 가능한 가장 높은 ROAS를 달성하는 것을 목표로 합니다.

int64

타겟 전환당비용 (CPA) 옵션입니다. 전환당 지출하고자 하는 평균 금액입니다.

int64

타겟 전환당비용 (CPA) 옵션입니다. 전환당 지출하고자 하는 평균 금액입니다.

int64

평균 CPA 타겟입니다. 이 타겟은 계정의 통화를 기준으로 최소 청구 가능 단위보다 크거나 같아야 합니다.

TargetImpressionShareLocation

검색결과 페이지의 타겟 위치입니다.

int64

타겟 위치에 표시할 광고의 마이크로 단위 비율입니다. 예를 들어 1% 는 10,000과 같습니다.

int64

자동 입찰 시스템으로 지정할 수 있는 가장 높은 CPC 입찰가입니다. 광고주가 입력하는 필수 필드이고 상한을 설정하며 로컬 마이크로 단위로 지정됩니다.

double

지출 단위당 선택한 수익(전환 데이터 기준)입니다.

int64

클릭수를 최대화할 지출 목표입니다. TargetSpend 입찰자는 이 값 또는 자연 제한 지출 금액 중 더 작은 값을 지출하려고 시도합니다. 지정하지 않으면 예산이 지출 목표로 사용됩니다. 이 필드는 지원 중단되었으며 더 이상 사용하지 않아야 합니다. 자세한 내용은 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html을 참고하세요.

int64

입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다.

string

광고의 리소스 이름입니다. 광고 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/ads/{ad_id}

string

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

AdType

광고의 유형입니다.

int64

광고의 ID입니다.

string

일부 광고 형식의 광고 설명에 표시되는 URL입니다.

string

광고의 이름입니다. 이 이름은 광고를 식별하는 데만 사용됩니다. 이름은 고유하지 않아도 되며 게재되는 광고에 영향을 주지 않습니다. 이름 필드는 현재 DisplayUploadAd, ImageAd, ShoppingComparisonListingAd, VideoAd에 대해서만 지원됩니다.

SearchAds360TextAdInfo

텍스트 광고와 관련된 세부정보입니다.

SearchAds360ExpandedTextAdInfo

확장 텍스트 광고와 관련된 세부정보입니다.

SearchAds360ResponsiveSearchAdInfo

반응형 검색 광고와 관련된 세부정보입니다.

SearchAds360ProductAdInfo

제품 광고와 관련된 세부정보입니다.

SearchAds360ExpandedDynamicSearchAdInfo

확장 동적 검색 광고와 관련된 세부정보입니다.

string

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

customers/{customer_id}/adGroups/{ad_group_id}

AdGroupStatus

광고 그룹의 상태입니다.

AdGroupType

광고 그룹의 유형입니다.

AdGroupAdRotationMode

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

string

이 ad_group이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

TargetingSetting

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

string

이 광고 그룹에 연결된 라벨의 리소스 이름입니다.

string

외부 엔진 계정의 광고 그룹 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "ad_group.id"를 사용하세요.

string

이 광고 그룹에서 광고 게재를 시작하는 날짜입니다. 기본적으로 광고 그룹은 지금 또는 광고 그룹의 시작일 중에서 늦은 날짜에 시작합니다. 이 필드를 설정하면 고객의 시간대로 지정된 날짜가 시작될 때 광고 그룹이 시작됩니다. 이 필드는 Microsoft Advertising 및 Facebook 게이트웨이 계정에만 사용할 수 있습니다.

형식: YYYY-MM-DD(예: 2019-03-14)

string

광고 그룹의 광고 게재가 종료되는 날짜입니다. 기본적으로 광고 그룹은 광고 그룹의 종료일에 종료됩니다. 이 필드를 설정하면 고객의 시간대로 지정된 날짜가 끝날 때 광고 그룹이 종료됩니다. 이 필드는 Microsoft Advertising 및 Facebook 게이트웨이 계정에만 사용할 수 있습니다.

형식: YYYY-MM-DD(예: 2019-03-14)

string

광고 그룹에서 광고 및 키워드의 언어입니다. 이 필드는 Microsoft Advertising 계정에만 사용할 수 있습니다. 자세히 알아보기: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

string

이 광고 그룹이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

int64

광고 그룹의 ID입니다.

string

광고 그룹의 이름입니다.

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

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

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

int64

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

AdGroupEngineStatus

광고그룹의 엔진 상태입니다.

string

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

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

AdGroupAdStatus

광고의 상태입니다.

Ad

광고

string

이 ad_group_ad가 생성된 타임스탬프입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

string

이 광고 그룹 광고에 연결된 라벨의 리소스 이름입니다.

string

외부 엔진 계정의 광고 ID입니다. 이 입력란은 Search Ads 360 계정(예: Yahoo Japan, Microsoft, Baidu 등)에만 해당합니다. Search Ads 360 법인이 아닌 경우 'ad_group_ad.ad.id'를 사용하세요. 하세요.

AdGroupAdEngineStatus

외부 엔진 계정에 있는 광고의 추가 상태입니다. 외부 계정 유형에 따라 가능한 상태는 활성, 적격, 검토 대기중 등입니다.

string

이 광고 그룹 광고가 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

string

광고그룹 광고 라벨의 리소스 이름입니다. 광고그룹 광고 라벨 리소스 이름의 형식은 customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}입니다.

string

라벨이 첨부된 광고그룹 광고입니다.

string

광고그룹 광고에 지정된 라벨입니다.

string

광고 그룹 애셋의 리소스 이름입니다. AdGroupAsset 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

string

필수 항목입니다. 애셋이 연결된 광고 그룹입니다.

string

필수 항목입니다. 광고 그룹에 연결된 애셋입니다.

AssetLinkStatus

광고그룹 애셋의 상태입니다.

string

광고 그룹 애셋 세트의 리소스 이름입니다. 광고그룹 애셋 세트 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

string

이 애셋 세트가 연결된 광고그룹입니다.

string

광고 그룹에 연결된 애셋 세트입니다.

AssetSetLinkStatus

광고그룹 애셋 세트의 상태입니다. 읽기 전용입니다.

string

광고 그룹 잠재고객 뷰의 리소스 이름입니다. 광고그룹 잠재고객 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

string

광고그룹 입찰가 조정의 리소스 이름입니다. 광고그룹 입찰가 조정 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

double

기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 선호 콘텐츠의 경우 범위는 1.0~6.0입니다. 기기 유형을 선택 해제하려면 0을 사용합니다.

DeviceInfo

기기 기준입니다.

string

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

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

string

이 광고 그룹 기준이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

AdGroupCriterionStatus

기준의 상태입니다.

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

QualityInfo

기준의 품질에 관한 정보입니다.

CriterionType

기준의 유형입니다.

string

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

PositionEstimates

다양한 게재순위에서의 기준 입찰가 견적입니다.

string

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

string

외부 엔진 계정의 광고그룹 기준 ID입니다. 이 필드는 Google Ads 이외의 계정(예: Yahoo Japan, Microsoft, Baidu 등)에만 사용됩니다. Google Ads 법인의 경우 'ad_group_criterion.criterion_id'를 사용하세요. 하세요.

string

이 광고 그룹 기준이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

int64

기준의 ID입니다.

string

기준이 속한 광고그룹입니다.

bool

기준을 타겟팅 (false)할지 또는 제외할지 (true) 나타냅니다.

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

double

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

int64

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

int64

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

AdGroupCriterionEngineStatus

광고 그룹 기준의 엔진 상태입니다.

string

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

string

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

KeywordInfo

키워드.

ListingGroupInfo

등록정보 그룹

AgeRangeInfo

연령대입니다.

GenderInfo

성별입니다.

UserListInfo

사용자 목록.

WebpageInfo

웹페이지

LocationInfo

위치를 탭합니다.

int64

검색결과 첫 페이지의 상단에 광고가 게재되는 데 필요할 것으로 예상되는 CPC 입찰가입니다.

int32

품질평가점수입니다.

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

string

광고그룹 기준 라벨의 리소스 이름입니다. 광고그룹 기준 라벨 리소스 이름의 형식은 customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}입니다.

string

라벨이 연결된 광고그룹 기준입니다.

string

광고그룹 기준에 할당된 라벨입니다.

string

광고 그룹 라벨의 리소스 이름입니다. 광고그룹 라벨 리소스 이름의 형식은 customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}입니다.

string

라벨이 연결된 광고그룹입니다.

string

광고그룹에 지정된 라벨입니다.

string

연령대 뷰의 리소스 이름입니다. 연령대 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

string

애셋의 리소스 이름입니다. 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/assets/{asset_id}

AssetType

저작물의 유형입니다.

string

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

AssetStatus

애셋의 상태입니다.

string

이 애셋이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

string

이 애셋이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

int64

저작물의 ID입니다.

string

애셋의 이름입니다(선택사항).

string

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

AssetEngineStatus

저작물의 엔진 상태입니다.

YoutubeVideoAsset

YouTube 동영상 애셋

ImageAsset

이미지 확장 소재입니다.

TextAsset

텍스트 애셋입니다.

UnifiedCalloutAsset

통합 콜아웃 확장 소재

UnifiedSitelinkAsset

통합 사이트링크 확장 소재입니다.

UnifiedPageFeedAsset

통합 페이지 피드 애셋입니다.

MobileAppAsset

모바일 앱 확장 소재

UnifiedCallAsset

통합 전화번호 확장 소재

CallToActionAsset

클릭 유도 문구 애셋입니다.

UnifiedLocationAsset

통합 위치 확장 소재입니다.

string

애셋 그룹의 리소스 이름입니다. 애셋 그룹 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/assetGroups/{asset_group_id}

int64

애셋 그룹의 ID입니다.

string

애셋 그룹이 연결된 캠페인입니다. 애셋 그룹에 연결된 애셋입니다.

string

필수 항목입니다. 애셋 그룹의 이름입니다. 필수 항목입니다. 길이는 1~128자(영문 기준)여야 합니다. 이름은 캠페인 내에서 고유해야 합니다.

string

모든 교차 도메인 리디렉션 후의 최종 도착 URL 목록입니다. 실적 최대화 캠페인에서는 기본적으로 URL을 선택 해제하지 않는 한 확장할 수 있습니다.

string

모든 교차 도메인 리디렉션 후 최종 모바일 URL의 목록입니다. 실적 최대화 캠페인에서는 기본적으로 URL을 선택 해제하지 않는 한 확장할 수 있습니다.

AssetGroupStatus

애셋 그룹의 상태입니다.

string

광고에 표시되는 URL에 추가될 수 있는 텍스트의 첫 부분입니다.

string

광고에 표시된 URL에 추가될 수 있는 텍스트의 두 번째 부분입니다. 이 필드는 path1이 설정된 경우에만 설정할 수 있습니다.

AdStrength

이 애셋 그룹의 전반적인 광고 효력입니다.

string

애셋 그룹 애셋의 리소스 이름입니다. 애셋 그룹 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

string

이 애셋 그룹 애셋이 연결하는 애셋 그룹입니다.

string

애셋 그룹 애셋이 연결되는 애셋입니다.

AssetFieldType

애셋 그룹 내 애셋의 게재위치에 대한 설명입니다. 예: HEADLINE, YOUTUBE_VIDEO 등

AssetLinkStatus

애셋과 애셋 그룹 간 연결의 상태입니다.

AssetUsage

게재된 애셋입니다.

string

애셋 그룹 등록정보 그룹 필터의 리소스 이름입니다. 애셋 그룹 등록정보 그룹 필터 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

string

이 애셋 그룹 등록정보 그룹 필터가 속한 애셋 그룹입니다.

int64

ListingGroupFilter의 ID입니다.

ListingGroupFilterType

등록정보 그룹 필터 노드의 유형입니다.

ListingGroupFilterVertical

현재 노드 트리가 나타내는 세로입니다. 같은 트리에 있는 모든 노드는 같은 카테고리에 속해야 합니다.

ListingGroupFilterDimension

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

string

상위 등록정보 그룹 하위 그룹의 리소스 이름입니다. 루트 등록정보 그룹 필터 노드의 경우 null입니다.

ListingGroupFilterDimensionPath

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

string

애셋 그룹 신호의 리소스 이름입니다. 애셋 그룹 신호 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}

string

애셋 그룹 신호가 속한 애셋 그룹입니다.

AudienceInfo

실적 최대화 캠페인에서 사용할 잠재고객 신호입니다.

string

애셋 그룹 상단 조합 뷰의 리소스 이름입니다. AssetGroup 상단 조합 보기 리소스 이름의 형식은 "customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"입니다.}

AssetGroupAssetCombinationData

함께 게재된 애셋의 상위 조합입니다.

int64

저작물 집합의 ID입니다.

string

애셋 세트의 리소스 이름입니다. 애셋 세트 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/assetSets/{asset_set_id}

string

애셋 세트 애셋의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

string

이 애셋 집합이 연결된 애셋 집합입니다.

string

이 애셋 집합이 연결된 애셋입니다.

AssetSetAssetStatus

저작물 세트 저작물의 상태입니다. 읽기 전용입니다.

string

잠재고객의 리소스 이름입니다. 잠재고객 이름의 형식은 다음과 같습니다.

customers/{customer_id}/audiences/{audience_id}

int64

잠재고객의 ID입니다.

string

필수 항목입니다. 잠재고객의 이름입니다. 모든 잠재고객에 대해 고유한 이름이어야 합니다. 길이는 1~255자(영문 기준)여야 합니다.

string

잠재고객에 대한 설명입니다.

string

입찰 전략의 리소스 이름입니다. 입찰 전략 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

BiddingStrategyStatus

입찰 전략의 상태입니다.

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

BiddingStrategyType

입찰 전략의 유형입니다. 입찰 스키마를 설정하여 입찰 전략을 만듭니다.

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

string

입찰 전략에 사용되는 통화입니다 (ISO 4217 3자리 코드).

관리자 고객의 입찰 전략의 경우 이 통화는 생성 시 설정할 수 있으며 기본적으로 관리자 고객의 통화로 설정됩니다. 고객에게 서비스를 제공하는 경우 이 필드를 설정할 수 없습니다. 광고 게재 고객의 모든 전략은 광고 게재 고객의 통화를 암시적으로 사용합니다. 어떤 경우든effective_currency_code 필드는 전략에서 사용하는 통화를 반환합니다.

int64

입찰 전략의 ID입니다.

string

입찰 전략의 이름입니다. 한 계정 내의 모든 입찰 전략은 이름이 고유해야 합니다.

이 문자열의 길이는 UTF-8 바이트 단위(공백 삭제)로 1~255 사이(1 및 255 포함)여야 합니다.

string

입찰 전략에 사용되는 통화입니다 (ISO 4217 3자리 코드).

관리자 고객의 입찰 전략에서 광고주가 전략을 만들 때 설정하는 통화입니다. 고객에게 제품 또는 서비스를 제공하는 경우 고객의 통화_코드입니다.

입찰 전략 측정항목은 이 통화로 보고됩니다.

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

int64

이 입찰 전략에 연결된 캠페인의 수입니다.

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

int64

이 입찰 전략에 연결된 삭제되지 않은 캠페인 수입니다.

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

EnhancedCpc

전환으로 이어질 가능성이 큰 클릭은 입찰가를 높이고, 전환 가능성이 낮은 클릭은 입찰가를 낮추는 입찰 전략입니다.

MaximizeConversionValue

캠페인의 전환 가치를 최대한 높일 수 있는 방향으로 예산이 지출되는 자동 입찰 전략입니다.

MaximizeConversions

캠페인에서 가장 많은 전환이 발생하는 방향으로 예산이 지출되는 자동 입찰 전략입니다.

TargetCpa

설정된 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

TargetImpressionShare

선택한 노출수 비율에 맞춰 자동으로 최적화하는 입찰 전략입니다.

TargetOutrankShare

광고주가 특정 경쟁업체보다 높은 순위를 얻어야 하는 입찰 타겟 비율에 따라 입찰가를 설정하는 입찰 전략입니다. 이 필드는 더 이상 사용되지 않습니다. 이 필드로 새 입찰 전략을 만들거나 이 필드가 있는 입찰 전략을 캠페인에 연결할 수 없습니다. 이 스키마가 이미 채워진 전략을 변경할 수 있습니다.

TargetRoas

특정 타겟 광고 투자수익 (ROAS)을 평균화하면서 수익을 극대화하는 입찰 전략입니다.

TargetSpend

예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

string

캠페인의 리소스 이름입니다. 캠페인 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/campaigns/{campaign_id}

CampaignStatus

캠페인의 상태입니다.

새 캠페인이 추가되면 상태는 기본적으로 '사용'으로 설정됩니다.

CampaignServingStatus

캠페인의 광고 게재 상태입니다.

BiddingStrategySystemStatus

캠페인 입찰 전략의 시스템 상태입니다.

AdServingOptimizationStatus

캠페인의 광고 게재 최적화 상태입니다.

AdvertisingChannelType

캠페인 내 광고의 기본 게재 타겟입니다. 타겟팅 옵션은 network_settings로 세분화할 수 있습니다.

이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다.

캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다.

AdvertisingChannelSubType

advertising_channel_type 상세검색(선택사항) 상위 채널 유형의 유효한 하위 유형이어야 합니다.

캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다.

CustomParameter

tracking_url_template, final_urls 또는 mobile_final_urls의 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다.

RealTimeBiddingSetting

실시간 입찰 설정으로, Ad Exchange 네트워크를 타겟팅하는 캠페인에서만 사용할 수 있습니다.

NetworkSettings

캠페인의 네트워크 설정입니다.

DynamicSearchAdsSetting

동적 검색 광고 (DSA)를 제어하기 위한 설정입니다.

ShoppingSetting

쇼핑 캠페인을 관리하기 위한 설정입니다.

GeoTargetTypeSetting

광고 지역 타겟팅을 위한 설정입니다.

string

이 캠페인에 연결된 라벨의 리소스 이름입니다.

BiddingStrategyType

입찰 전략의 유형입니다.

입찰 전략을 설정하여 표준 입찰 전략을 만들거나 bidding_strategy 필드를 설정하여 포트폴리오 입찰 전략을 만들 수 있습니다.

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

string

AccessibleBiddingStrategy의 리소스 이름으로, 'bidding_strategy'로 식별된 연결된 포트폴리오 입찰 전략의 제한되지 않은 속성에 대한 읽기 전용 보기. 캠페인에서 포트폴리오 전략을 사용하지 않는 경우 비어 있습니다. 제한되지 않은 전략 속성은 전략이 공유되는 모든 고객이 사용할 수 있으며 AccessibleBiddingStrategy 리소스에서 읽습니다. 반면, 제한된 속성은 전략의 소유자 고객과 해당 관리자만 사용할 수 있습니다. 제한된 속성은 입찰전략 리소스에서만 읽을 수 있습니다.

FrequencyCapEntry

각 사용자에게 이 캠페인의 광고가 게재되는 빈도를 제한하는 목록입니다.

SelectiveOptimization

이 캠페인의 선택적 최적화 설정으로, 캠페인 최적화의 기준이 되는 전환 액션 집합이 포함됩니다. 이 기능은 MULTI_CHANNEL을 AdvertisingChannelType으로, APP_CAMPAIGN 또는 APP_CAMPAIGN_FOR_ENGAGEMENT를 AdvertisingChannelSubType으로 사용하는 앱 캠페인에만 적용됩니다.

OptimizationGoalSetting

최적화 목표 유형이 포함된 이 캠페인의 최적화 목표 설정입니다.

TrackingSetting

추적 정보에 대한 캠페인 수준 설정입니다.

string

외부 엔진 계정의 캠페인 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "campaign.id"를 사용하세요.

AssetFieldType

이 캠페인에서 제외해야 하는 애셋 필드 유형입니다. 이러한 필드 유형의 애셋 링크는 이 캠페인이 상위 수준에서 상속되지 않습니다.

string

이 캠페인이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대와 'yyyy-MM-dd HH:mm:ss' 형식입니다. 형식으로 입력합니다. create_time은 v1에서 지원 중단됩니다. 대신 create_time을 사용하세요.

string

이 캠페인이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

string

이 캠페인이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

int64

캠페인의 ID입니다.

string

캠페인의 이름입니다.

이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다.

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

string

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

string

캠페인의 예산입니다.

string

YYYY-MM-DD 형식의 게재 고객의 시간대로 캠페인이 시작된 날입니다.

string

YYYY-MM-DD 형식의 게재 고객의 시간대로 캠페인 마지막 날입니다. 생성 시 기본값은 2037-12-30입니다. 즉, 캠페인이 무기한 실행됩니다. 기존 캠페인이 무한정 운영되도록 설정하려면 이 필드를 2037-12-30으로 설정하세요.

string

병렬 추적으로 게재되는 방문 페이지에 쿼리 매개변수를 추가하는 데 사용되는 서픽스입니다.

bool

보다 타겟팅된 URL로의 URL 확장 선택 해제를 나타냅니다. 선택 해제 (true)하면 애셋 그룹의 최종 URL이나 광고주의 Google 판매자 센터 또는 비즈니스 데이터 피드에 지정된 URL만 타겟팅됩니다. 선택하는 경우 (거짓) 전체 도메인이 타겟팅됩니다. 이 필드는 기본값이 false인 실적 최대화 캠페인에만 설정할 수 있습니다.

string

캠페인에서 사용하는 포트폴리오 입찰 전략입니다.

ManualCpa

표준 수동 CPA 입찰 전략 광고주가 지정한 작업별로 입찰가를 설정할 수 있는 수동 입찰 전략입니다. 지역 서비스 캠페인에만 지원됩니다.

ManualCpc

표준 수동 CPC 입찰 전략 사용자가 클릭당 지불하는 수동 클릭 기반 입찰입니다.

ManualCpm

표준 수동 CPM 입찰 전략 사용자가 1,000회 노출당 비용을 지불하는 수동 노출 기반 입찰입니다.

MaximizeConversions

표준 전환수 최대화 입찰 전략으로 예산을 지출하면서 자동으로 전환수를 최대화합니다.

MaximizeConversionValue

표준 전환 가치 극대화 입찰 전략으로, 예산을 지출하면서 수익을 극대화할 수 있도록 입찰가를 자동으로 설정합니다.

TargetCpa

설정한 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 자동으로 설정하는 표준 타겟 CPA 입찰 전략입니다.

TargetImpressionShare

타겟 노출 점유율 입찰 전략 선택한 비율의 노출수를 달성하도록 입찰가를 설정하는 자동 입찰 전략입니다.

TargetRoas

특정 타겟 광고 투자수익 (ROAS)을 평균화하면서 자동으로 수익을 극대화하는 표준 타겟 ROAS 입찰 전략입니다.

TargetSpend

예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 자동으로 설정하는 표준 타겟 지출 입찰 전략입니다.

PercentCpc

일부 제품 또는 서비스에 대해 광고된 가격의 일정 비율을 입찰가로 사용하는 표준 비율 CPC 입찰 전략입니다.

TargetCpm

1,000회 노출당비용을 자동으로 최적화하는 입찰 전략입니다.

string

필수 항목입니다. 이 설정이 나타내는 인터넷 도메인 이름(예: 'google.com') 또는 'www.google.com'입니다.

string

필수 항목입니다. 도메인의 언어를 지정하는 언어 코드입니다(예: 'en').

bool

캠페인이 광고주 제공 URL만 사용하는지 여부입니다.

PositiveGeoTargetType

이 특정 캠페인에서 포함 지역 타겟팅에 사용되는 설정입니다.

NegativeGeoTargetType

이 특정 캠페인에서 제외 지역 타겟팅에 사용되는 설정입니다.

bool

광고를 google.com 검색 결과에 게재할지 여부입니다.

bool

Google 검색 네트워크의 파트너 사이트에 광고를 게재할지 여부입니다 (target_google_search도 true여야 함).

bool

광고가 Google 디스플레이 네트워크의 지정된 게재위치에 게재되는지 여부입니다. 게재위치는 게재위치 기준을 사용하여 지정됩니다.

bool

광고가 Google 파트너 네트워크에 게재되는지 여부입니다. 이 기능은 일부 Google 파트너 계정에서만 사용할 수 있습니다.

OptimizationGoalType

최적화 목표 유형의 목록입니다.

string

이 캠페인을 최적화하기 위해 선택한 전환 액션 집합입니다.

string

캠페인에 포함할 제품의 피드 라벨입니다. feed_label 또는 sales_country 중 하나만 설정할 수 있습니다. sales_country 대신 사용되는 경우 feed_label 필드에 동일한 형식의 국가 코드(예: 'XX')가 허용됩니다. 그 외의 경우에는 Google 판매자 센터에서 피드 라벨에 사용되는 문자열을 사용할 수 있습니다.

bool

차량 등록정보 인벤토리를 타겟팅할지 여부입니다.

int64

판매자 센터 계정의 ID입니다. 만들기 작업에 필요한 필드입니다. 쇼핑 캠페인의 경우 이 필드를 변경할 수 없습니다.

string

캠페인에 포함할 제품의 판매 국가입니다.

int32

캠페인의 우선순위입니다. 숫자가 높은 우선순위의 캠페인이 우선순위가 낮은 캠페인보다 우선합니다. 이 필드는 0 이상 2 이하의 값을 갖는 쇼핑 캠페인에 필수입니다. 이 필드는 스마트 쇼핑 캠페인의 경우 선택사항이지만, 설정된 경우에는 3이어야 합니다.

bool

오프라인 제품을 포함할지 여부입니다.

string

동적 추적에 사용되는 URL입니다.

string

캠페인 애셋의 리소스 이름입니다. CampaignAsset 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

AssetLinkStatus

캠페인 확장 소재의 상태입니다.

string

애셋이 연결된 캠페인입니다.

string

캠페인에 연결된 애셋입니다.

string

캠페인 애셋 세트의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

string

이 애셋 세트가 연결된 캠페인입니다.

string

캠페인에 연결된 애셋 세트입니다.

AssetSetLinkStatus

캠페인 애셋 세트 애셋의 상태입니다. 읽기 전용입니다.

string

캠페인 잠재고객 뷰의 리소스 이름입니다. 캠페인 잠재고객 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

string

캠페인 예산의 리소스 이름입니다. 캠페인 예산 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

BudgetDeliveryMethod

캠페인 예산의 소비율을 결정하는 게재 방법입니다.

만들기 작업에서 지정되지 않은 경우 기본적으로 STANDARD입니다.

BudgetPeriod

예산을 지출할 기간입니다. 지정하지 않으면 기본적으로 DAILY입니다.

int64

예산 금액(계정의 현지 통화)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. 월별 지출은 이 금액의 30.4배로 제한됩니다.

string

캠페인 기준의 리소스 이름입니다. 캠페인 기준 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

string

기준의 표시 이름입니다.

변형의 경우 이 필드는 무시됩니다.

CriterionType

기준의 유형입니다.

CampaignCriterionStatus

기준의 상태입니다.

string

이 캠페인 기준이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

int64

기준의 ID입니다.

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

float

기준이 일치할 때의 입찰가에 대한 수정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. 기기 유형을 선택 해제하려면 0을 사용합니다.

bool

기준을 타겟팅 (false)할지 또는 제외할지 (true) 나타냅니다.

KeywordInfo

키워드.

LocationInfo

위치를 탭합니다.

DeviceInfo

기기 등 데이터를 분류할 옵션을 선택합니다.

AgeRangeInfo

연령대입니다.

GenderInfo

성별입니다.

UserListInfo

사용자 목록.

LanguageInfo

언어

WebpageInfo

웹페이지.

LocationGroupInfo

위치 그룹

string

리소스의 이름입니다. 캠페인 라벨 리소스 이름의 형식은 customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}입니다.

string

라벨이 첨부된 캠페인입니다.

string

캠페인에 할당된 라벨입니다.

string

장바구니 데이터 판매 뷰의 리소스 이름입니다. 장바구니 데이터 판매 보기 리소스 이름의 형식은 customers/{customer_id}/cartDataSalesView입니다.

string

전환의 리소스 이름입니다. 전환 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

int64

전환의 ID입니다.

int64

Search Ads 360 기준 ID입니다. 값이 0이면 기준이 비구분 상태임을 나타냅니다.

int64

클릭된 제품이 포함된 Search Ads 360 인벤토리 계정 ID입니다. 사용자가 Search Ads 360에서 인벤토리 계정을 링크할 때 Search Ads 360이 이 ID를 생성합니다.

int64

광고 ID 값이 0이면 광고가 기여 비구분 상태임을 나타냅니다.

string

방문 페이지에 클릭 ID URL 매개변수로 전달되며, 전환의 기인 대상이 되는 방문에 대한 고유 문자열입니다.

int64

전환에 기여한 Search Ads 360 방문 ID입니다.

string

오프라인 전환의 경우 광고주가 제공하는 ID입니다. 광고주가 이러한 ID를 지정하지 않으면 Search Ads 360이 ID를 생성합니다. 온라인 전환의 경우 광고주의 플러드라이트 지침에 따라 ID 열 또는 floodlight_order_id 열과 동일합니다.

string

클릭된 제품의 ID입니다.

ProductChannel

클릭된 제품의 영업 채널: 온라인 또는 로컬.

string

제품에 대한 데이터가 포함된 판매자 센터 피드에 설정된 언어(ISO-639-1)입니다.

string

클릭된 오프라인 판매점 인벤토리 광고의 스토어입니다. 오프라인 제품 피드에 사용된 스토어 ID와 일치해야 합니다.

string

클릭한 제품이 포함된 인벤토리 피드에 등록된 국가(ISO-3166 형식)입니다.

AttributionType

전환 기인 대상: 방문 또는 키워드+광고.

string

전환 이벤트의 타임스탬프입니다.

string

전환이 마지막으로 수정된 시간의 타임스탬프입니다.

string

전환의 기인 대상이 되는 방문의 타임스탬프입니다.

int64

전환으로 기록된 항목 수입니다. 수량 URL 매개변수에 따라 결정됩니다. 광고주가 매개변수를 동적으로 채워야 하며(예: 전환에서 판매된 항목 수) 그렇지 않은 경우 기본값은 1입니다.

int64

전환 이벤트에 대해 백만 분의 1 단위로 조정된 수익입니다. 항상 광고 게재 계정의 통화로 표시됩니다.

int64

플러드라이트 통화 안내 수정 전 플러드라이트 이벤트와 연관된 원래의 변경되지 않은 수익입니다(현재 보고서의 통화).

string

광고주가 전환을 위해 제공한 플러드라이트 주문 ID입니다.

ConversionStatus

전환 상태(사용 설정됨 또는 삭제됨)입니다.

int64

전환 이벤트 중에 상호작용한 애셋의 ID입니다.

AssetFieldType

전환 이벤트의 애셋 필드 유형입니다.

string

전환 액션의 리소스 이름입니다. 전환 액션 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/conversionActions/{conversion_action_id}

string

ISO 8601 형식의 플러드라이트 활동 생성의 타임스탬프입니다.

ConversionActionStatus

전환 이벤트 발생에 대한 이 전환 액션의 상태입니다.

ConversionActionType

이 전환 액션의 유형입니다.

ConversionActionCategory

이 전환 액션에 대해 보고된 전환의 카테고리입니다.

ValueSettings

이 전환 액션과 연결된 전환 이벤트의 가치와 관련된 설정입니다.

AttributionModelSettings

이 전환 액션의 기여 분석 모델과 관련된 설정입니다.

FloodlightSettings

플러드라이트 전환 유형에 대한 플러드라이트 설정입니다.

int64

전환 액션의 ID입니다.

string

전환 액션의 이름입니다.

이 필드는 필수 항목이며 새 전환 액션을 만들 때 비워 두지 않아야 합니다.

bool

전환 액션의 primary_for_goal 비트가 false이면 고객 전환 목표나 캠페인 전환 목표에 관계없이 모든 캠페인에서 전환 액션을 입찰할 수 없습니다. 그러나 맞춤 전환 목표는 primary_for_goal을 따르지 않으므로 캠페인에 primary_for_goal = false 전환 액션으로 구성된 맞춤 전환 목표가 있는 경우 해당 전환 액션은 계속 입찰할 수 있습니다. 설정하지 않으면 primary_for_goal이 기본적으로 true입니다. V9에서는 primary_for_goal을 'update'를 통해 생성한 후에만 false로 설정할 수 있습니다. 선택사항으로 선언되지 않았기 때문입니다.

string

전환 액션 소유자 고객의 리소스 이름이거나, 시스템 정의 전환 액션인 경우 null입니다.

bool

이 전환 액션을 'client_account_conversions'에 포함해야 하는지 여부입니다. 측정항목입니다.

bool

이 전환 액션을 '전환'에 포함해야 하는지 여부 측정항목입니다.

int64

상호작용 (예: 클릭)과 전환 이벤트 사이에 경과할 수 있는 최대 일수입니다.

string

앱 전환 액션의 앱 ID입니다.

AttributionModel

이 전환 액션의 기여 분석 모델 유형입니다.

DataDrivenModelStatus

전환 액션에 대한 데이터 기반 기여 분석 모델의 상태입니다.

string

전환을 보고할 때 플러드라이트 활동 그룹을 식별하는 데 사용되는 문자열입니다.

string

전환을 보고할 때 플러드라이트 활동을 식별하는 데 사용되는 문자열입니다.

int64

DoubleClick Campaign Manager(DCM)의 플러드라이트 활동 ID입니다.

double

이 전환 액션의 전환 이벤트가 잘못되거나, 허용되지 않거나, 누락된 값과 함께 전송되거나, 전환 액션이 항상 기본값을 사용하도록 구성된 경우 사용할 값입니다.

string

이 전환 액션의 전환 이벤트가 잘못되거나 누락된 통화 코드와 함께 전송되었거나 전환 액션이 항상 기본값을 사용하도록 구성된 경우 사용할 통화 코드입니다.

bool

이 전환 액션에 대한 전환 이벤트에 지정된 가치 및 통화 코드 대신 기본값 및 기본 통화 코드를 사용할지 여부를 지정합니다.

string

전환 맞춤 변수의 리소스 이름입니다. 전환 맞춤 변수 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

int64

전환 맞춤 변수의 ID입니다.

string

필수 항목입니다. 전환 맞춤 변수의 이름입니다. 이름은 고유해야 합니다. 이름의 최대 길이는 100자(영문 기준)입니다. 앞뒤에 추가 공백이 있으면 안 됩니다.

string

필수 항목입니다. 전환 맞춤 변수의 태그입니다. 태그는 고유해야 하며 'u'로 구성되어야 합니다. 문자 바로 뒤에 100 이하의 숫자가 옵니다. 예: 'u4'

ConversionCustomVariableStatus

전환 이벤트 누적에 대한 전환 맞춤 변수의 상태입니다.

string

전환 맞춤 변수를 소유한 고객의 리소스 이름입니다.

ConversionCustomVariableFamily

전환 맞춤 변수의 모음입니다.

ConversionCustomVariableCardinality

전환 맞춤 변수의 카디널리티입니다.

FloodlightConversionCustomVariableInfo

Search Ads 360 플러드라이트 전환 맞춤 변수의 필드입니다.

int64

이 전환 맞춤 변수를 사용하는 맞춤 열의 ID입니다.

FloodlightVariableType

Search Ads 360에 정의된 플러드라이트 변수 유형입니다.

FloodlightVariableDataType

Search Ads 360에 정의된 플러드라이트 변수 데이터 유형입니다.

bool

고객이 고객 데이터 약관에 동의했는지 여부 교차 계정 전환 추적을 사용하는 경우 이 값은 관리자로부터 상속됩니다. 이 필드는 읽기 전용입니다. 자세한 내용은 https://support.google.com/adspolicy/answer/7475709를 참고하세요.

ConversionTrackingStatus

전환 추적 상태입니다. 고객이 전환 추적을 사용하는지 여부 및 고객의 전환 추적 소유자가 누구인지 나타냅니다. 이 고객이 교차 계정 전환 추적을 사용 중인 경우 반환되는 값은 요청의 login-customer-id에 따라 달라집니다.

bool

고객이 리드 확보용 향상된 전환을 선택했는지 여부 교차 계정 전환 추적을 사용하는 경우 이 값은 관리자로부터 상속됩니다. 이 필드는 읽기 전용입니다.

string

전환이 생성되고 관리되는 고객의 리소스 이름입니다. 이 필드는 읽기 전용입니다.

int64

이 계정에 사용된 전환 추적 ID입니다. 이 ID는 고객이 전환 추적을 사용하는지 여부를 나타내지 않습니다 (conversion_tracking_status 사용). 이 필드는 읽기 전용입니다.

int64

고객 관리자의 전환 추적 ID입니다. 고객이 전환 추적을 선택한 경우 설정되며 conversion_tracking_id보다 우선 적용됩니다. 이 필드는 Google Ads UI를 통해서만 관리할 수 있습니다. 이 필드는 읽기 전용입니다.

int64

고객 관리자의 전환 추적 ID입니다. 고객이 교차 계정 전환 추적을 선택한 경우 설정되며 conversion_tracking_id보다 우선 적용됩니다.

string

맞춤 열의 리소스 이름입니다. 맞춤 열 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/customColumns/{custom_column_id}

int64

맞춤 열의 ID입니다.

string

맞춤 열의 사용자 정의 이름입니다.

string

맞춤 열에 대한 사용자 정의 설명입니다.

CustomColumnValueType

맞춤 열의 결과 값 유형입니다.

bool

맞춤 열이 하나 이상의 속성을 참조하는 경우 true입니다.

bool

맞춤 열이 하나 이상의 측정항목을 참조하는 경우 true입니다.

bool

SearchAds360Service.Search 및 SearchAds360Service.SearchStream의 쿼리에서 맞춤 열을 사용할 수 있는 경우 true입니다.

string

이 맞춤 열에서 참조된 시스템 열의 목록입니다. 예를 들어 맞춤 열 '노출수와 클릭수의 합계'가 {"metrics.clicks", "metrics.impressions"} 시스템 열을 참조했습니다.

string

고객의 리소스 이름입니다. 고객 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}

ConversionTrackingSetting

고객의 전환 추적 설정입니다.

AccountType

엔진 계정 유형(예: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track 등)

DoubleClickCampaignManagerSetting

관리자 고객의 DoubleClick Campaign Manager (DCM) 설정

AccountStatus

계정 상태(예: 사용 설정됨, 일시중지됨, 삭제됨)

string

이 고객이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

string

외부 엔진 계정의 계정 ID입니다.

CustomerStatus

고객의 상태입니다.

string

이 고객이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

int64

고객의 ID입니다.

string

고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다.

string

계정에 사용되는 통화입니다. ISO 4217 표준의 통화 코드 중 일부가 지원됩니다.

string

고객의 현지 시간대 ID입니다.

string

매개변수로 추적 URL을 구성하기 위한 URL 템플릿

string

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

bool

고객에 대해 자동 태그 추가가 사용 설정되어 있는지 여부

bool

고객이 관리자인지 여부

string

고객 애셋의 리소스 이름입니다. CustomerAsset 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

string

필수 항목입니다. 고객에 연결된 애셋입니다.

AssetLinkStatus

고객 애셋의 상태입니다.

string

고객 애셋 세트의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/customerAssetSets/{asset_set_id}

string

고객에게 연결된 애셋 세트입니다.

string

이 애셋 세트가 연결된 고객입니다.

AssetSetLinkStatus

고객 애셋 세트 애셋의 상태입니다. 읽기 전용입니다.

string

고객 클라이언트의 리소스 이름입니다. CustomerClient 리소스 이름의 형식은 customers/{customer_id}/customerClients/{client_customer_id}입니다.

string

요청 고객이 소유하고 클라이언트 고객에게 적용되는 라벨의 리소스 이름입니다. 라벨 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/labels/{label_id}

CustomerStatus

클라이언트 고객의 상태입니다. 읽기 전용입니다.

string

특정 고객에 연결된 클라이언트-고객의 리소스 이름입니다. 읽기 전용입니다.

bool

숨겨진 계정인지 여부를 지정합니다.

읽기 전용입니다.

int64

지정된 고객과 고객 사이의 거리입니다. 자체 링크의 경우 수준 값은 0입니다. 읽기 전용입니다.

string

클라이언트의 시간대를 나타내는 CLDR(Common Locale Data Repository) 문자열 표현입니다(예: America/Los_Angeles). 읽기 전용입니다.

bool

클라이언트가 테스트 계정인지 식별합니다. 읽기 전용입니다.

bool

클라이언트가 관리자인지 식별합니다. 읽기 전용입니다.

string

클라이언트를 설명하는 이름입니다. 읽기 전용입니다.

string

클라이언트의 통화 코드 (예: 'USD', 'EUR')입니다. 읽기 전용입니다.

int64

클라이언트 고객의 ID입니다. 읽기 전용입니다.

string

리소스의 이름입니다. CustomerManagerLink 리소스 이름의 형식은 customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}입니다.

ManagerLinkStatus

고객과 관리자 간의 연결 상태입니다.

string

고객에게 연결된 관리자 고객입니다.

int64

고객-관리자 링크의 ID입니다. 이 필드는 읽기 전용입니다.

string

CustomerManagerLink가 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

int64

이 고객과 연결된 Campaign Manager 광고주의 ID입니다.

int64

이 고객과 연결된 Campaign Manager 네트워크의 ID입니다.

string

IANA 시간대 데이터베이스 형식의 이 고객과 연결된 Campaign Manager 네트워크의 시간대입니다(예: America/New_York).

string

동적 검색 광고 검색어 보기의 리소스 이름입니다. 동적 검색 광고 검색어 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

string

동적으로 선택된 노출의 방문 페이지 URL입니다.

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

string

성별 뷰의 리소스 이름입니다. 성별 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

string

지역 타겟팅 상수의 리소스 이름입니다. 지역 타겟팅 상수 리소스 이름의 형식은 다음과 같습니다.

geoTargetConstants/{geo_target_constant_id}

GeoTargetConstantStatus

지역 타겟팅 상수 상태입니다.

int64

지역 타겟팅 상수의 ID입니다.

string

지역 타겟팅 상수 영어 이름입니다.

string

타겟과 연결된 ISO-3166-1 alpha-2 국가 코드입니다.

string

지역 타겟팅 상수 타겟 유형입니다.

string

타겟의 이름과 상위 및 국가의 이름으로 구성된 정규화된 영어 이름입니다.

string

상위 지역 타겟 상수의 리소스 이름입니다. 지역 타겟팅 상수 리소스 이름의 형식은 다음과 같습니다.

geoTargetConstants/{parent_geo_target_constant_id}

string

키워드 뷰의 리소스 이름입니다. 키워드 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

string

리소스의 이름입니다. 라벨 리소스 이름의 형식은 customers/{customer_id}/labels/{label_id}입니다.

LabelStatus

라벨의 상태입니다. 읽기 전용입니다.

TextLabel

색이 있는 배경에 텍스트를 표시하는 라벨 유형입니다.

int64

라벨의 ID입니다. 읽기 전용입니다.

string

라벨의 이름입니다.

이 필드는 필수이며 새 라벨을 만들 때 비워 둘 수 없습니다.

이 문자열의 길이는 1에서 80 사이여야 합니다(1 및 80 포함).

string

언어 상수의 리소스 이름입니다. 언어 상수 리소스 이름의 형식은 다음과 같습니다.

languageConstants/{criterion_id}

int64

언어 상수의 ID입니다.

string

언어 코드(예: 'en_US', 'en_AU', 'es', 'fr' 등)입니다.

string

영어로 된 언어의 전체 이름(예: '영어(미국)', '스페인어' 등)입니다.

bool

언어의 타겟팅 가능 여부입니다.

ProductBiddingCategory

제품의 입찰 카테고리입니다.

ProductBrand

제품의 브랜드입니다.

ProductChannel

제품 제공 지역.

ProductCondition

제품의 상태입니다.

ProductCustomAttribute

제품의 맞춤 속성입니다.

ProductItemId

제품의 상품 ID입니다.

ProductType

제품 제공 유형입니다.

ListingGroupFilterBiddingCategoryLevel

분류에 있는 카테고리의 수준을 나타냅니다.

int64

제품 입찰 카테고리의 ID입니다.

이 ID는 다음 도움말에 설명된 google_product_category ID와 동일합니다. https://support.google.com/merchants/answer/6324436

string

제품 브랜드의 문자열 값입니다.

ListingGroupFilterProductChannel

지역의 값입니다.

ListingGroupFilterProductCondition

조건의 값입니다.

ListingGroupFilterCustomAttributeIndex

맞춤 속성의 색인을 나타냅니다.

string

제품 맞춤 속성의 문자열 값입니다.

string

ID의 값입니다.

ListingGroupFilterProductTypeLevel

유형의 수준입니다.

string

유형의 값입니다.

ListingGroupFilterDimension

등록정보 그룹 필터 계층 구조 (루트 노드 제외)를 통해 이 등록정보 그룹 필터로 연결되는 측정기준의 전체 경로입니다.

string

위치 뷰의 리소스 이름입니다. 위치 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

string

제품 입찰 카테고리의 리소스 이름입니다. 제품 입찰 카테고리 리소스 이름의 형식은 다음과 같습니다.

productBiddingCategoryConstants/{country_code}~{level}~{id}

ProductBiddingCategoryLevel

제품 입찰 카테고리의 수준입니다.

ProductBiddingCategoryStatus

제품 입찰 카테고리의 상태입니다.

int64

제품 입찰 카테고리의 ID입니다.

이 ID는 이 도움말(https://support.google.com/merchants/answer/6324436)에 설명된 google_product_category ID와 동일합니다.

string

제품 입찰 카테고리의 2자리 대문자 국가 코드입니다.

string

상위 제품 입찰 카테고리의 리소스 이름입니다.

string

제품 입찰 카테고리의 언어 코드입니다.

string

language_code에 따라 현지화된 제품 입찰 카테고리의 표시 값입니다.

string

제품 그룹 뷰의 리소스 이름입니다. 제품 그룹 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

string

아티팩트의 리소스 이름입니다. 아티팩트 리소스 이름의 형식은 다음과 같습니다.

SearchAds360Fields/{name}

SearchAds360FieldCategory

아티팩트의 카테고리입니다.

string

설명된 아티팩트로 선택할 수 있는 모든 리소스, 세그먼트, 측정항목의 이름입니다.

string

설명된 아티팩트로 선택 가능한 모든 리소스의 이름입니다. 이러한 리소스의 필드는 검색어에 포함될 때 측정항목을 분류하지 않습니다.

이 필드는 카테고리가 RESOURCE인 아티팩트에만 설정됩니다.

string

이 필드에는 FROM 절에서 사용될 때 설명된 아티팩트로 선택할 수 있는 모든 측정항목의 이름이 나열됩니다. 카테고리가 RESOURCE인 아티팩트에만 설정됩니다.

string

이 필드에는 세그먼트 측정항목이 검색어에 포함되었을 때와 설명된 아티팩트가 FROM 절에 사용된 경우 세그먼트나 다른 리소스에 관계없이 모든 아티팩트의 이름이 나열됩니다. 카테고리가 RESOURCE인 아티팩트에만 설정됩니다.

string

아티팩트가 ENUM 유형의 필드인 경우 가정할 수 있는 값입니다.

이 필드는 SEGMENT 또는 ATTRIBUTE 카테고리의 아티팩트에만 설정됩니다.

SearchAds360FieldDataType

이 필드는 WHERE 절에서 아티팩트와 함께 사용할 수 있는 연산자를 결정합니다.

string

아티팩트의 이름입니다.

bool

아티팩트를 검색어의 SELECT 절에서 사용할 수 있는지 여부입니다.

bool

아티팩트를 검색어의 WHERE 절에서 사용할 수 있는지 여부입니다.

bool

검색 쿼리의 ORDER BY 절에서 아티팩트를 사용할 수 있는지 여부입니다.

string

아티팩트의 데이터 유형을 설명하는 proto의 URL입니다.

bool

필드 아티팩트가 반복되는지 여부입니다.

string

쇼핑 실적 뷰의 리소스 이름입니다. 쇼핑 실적 뷰 리소스 이름의 형식은 customers/{customer_id}/shoppingPerformanceView입니다.

string

사용자 목록의 리소스 이름입니다. 사용자 목록 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/userLists/{user_list_id}

UserListType

이 목록의 유형입니다.

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

int64

사용자 목록의 ID입니다.

string

이 사용자 목록의 이름입니다. access_reason에 따라 사용자 목록 이름이 고유하지 않을 수 있습니다 (예: access_reason=SHARED인 경우).

string

방문의 리소스 이름입니다. 방문 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

int64

방문 ID입니다.

int64

Search Ads 360 키워드 ID입니다. 값이 0인 경우 키워드에 기여하지 않았음을 나타냅니다.

int64

클릭된 제품이 포함된 Search Ads 360 인벤토리 계정 ID입니다. 사용자가 Search Ads 360에서 인벤토리 계정을 링크할 때 Search Ads 360이 이 ID를 생성합니다.

int64

광고 ID 값이 0이면 광고가 기여 비구분 상태임을 나타냅니다.

string

방문 페이지에 클릭 ID URL 매개변수로 전달되는 각 방문에 대한 고유한 문자열입니다.

string

방문 이벤트의 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

string

클릭된 제품의 ID입니다.

ProductChannel

클릭된 제품의 영업 채널: 온라인 또는 로컬.

string

제품에 대한 데이터가 포함된 판매자 센터 피드에 설정된 언어(ISO-639-1)입니다.

string

클릭된 오프라인 판매점 인벤토리 광고의 스토어입니다. 오프라인 제품 피드에 사용된 스토어 ID와 일치해야 합니다.

string

클릭한 제품이 포함된 인벤토리 피드에 등록된 국가(ISO-3166 형식)입니다.

int64

방문 이벤트 중에 상호작용한 애셋의 ID입니다.

AssetFieldType

방문 이벤트의 애셋 필드 유형입니다.

string

웹페이지 뷰의 리소스 이름입니다. 웹페이지 조회 리소스 이름의 형식은 다음과 같습니다.

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}