Package google.ads.searchads360.v0.resources

색인

• AccessibleBiddingStrategy(메시지)
• AccessibleBiddingStrategy.MaximizeConversionValue(메시지)
• AccessibleBiddingStrategy.MaximizeConversions(메시지)
• AccessibleBiddingStrategy.TargetCpa(메시지)
• AccessibleBiddingStrategy.TargetImpressionShare(메시지)
• AccessibleBiddingStrategy.TargetRoas(메시지)
• AccessibleBiddingStrategy.TargetSpend(메시지)
• Ad(메시지)
• AdGroup(메시지)
• AdGroupAd(메시지)
• AdGroupAdLabel(메시지)
• AdGroupAsset(메시지)
• AdGroupAssetSet(메시지)
• AdGroupAudienceView(메시지)
• AdGroupBidModifier(메시지)
• AdGroupCriterion(메시지)
• AdGroupCriterion.PositionEstimates(메시지)
• AdGroupCriterion.QualityInfo(메시지)
• AdGroupCriterionLabel(메시지)
• AdGroupLabel(메시지)
• AgeRangeView(메시지)
• Asset(메시지)
• AssetGroup(메시지)
• AssetGroupAsset(메시지)
• AssetGroupAssetCombinationData(메시지)
• AssetGroupListingGroupFilter(메시지)
• AssetGroupSignal(메시지)
• AssetGroupTopCombinationView(메시지)
• AssetSet(메시지)
• AssetSetAsset(메시지)
• Audience(메시지)
• BiddingStrategy(메시지)
• Campaign(메시지)
• Campaign.DynamicSearchAdsSetting(메시지)
• Campaign.GeoTargetTypeSetting(메시지)
• Campaign.NetworkSettings(메시지)
• Campaign.OptimizationGoalSetting(메시지)
• Campaign.SelectiveOptimization(메시지)
• Campaign.ShoppingSetting(메시지)
• Campaign.TrackingSetting(메시지)
• CampaignAsset(메시지)
• CampaignAssetSet(메시지)
• CampaignAudienceView(메시지)
• CampaignBudget(메시지)
• CampaignCriterion(메시지)
• CampaignLabel(메시지)
• CartDataSalesView(메시지)
• Conversion(메시지)
• ConversionAction(메시지)
• ConversionAction.AttributionModelSettings(메시지)
• ConversionAction.FloodlightSettings(메시지)
• ConversionAction.ValueSettings(메시지)
• ConversionCustomVariable(메시지)
• ConversionCustomVariable.FloodlightConversionCustomVariableInfo(메시지)
• ConversionTrackingSetting(메시지)
• CustomColumn(메시지)
• Customer(메시지)
• CustomerAsset(메시지)
• CustomerAssetSet(메시지)
• CustomerClient(메시지)
• CustomerManagerLink(메시지)
• DoubleClickCampaignManagerSetting(메시지)
• DynamicSearchAdsSearchTermView(메시지)
• GenderView(메시지)
• GeoTargetConstant(메시지)
• KeywordView(메시지)
• Label(메시지)
• LanguageConstant(메시지)
• ListingGroupFilterDimension(메시지)
• ListingGroupFilterDimension.ProductBiddingCategory(메시지)
• ListingGroupFilterDimension.ProductBrand(메시지)
• ListingGroupFilterDimension.ProductChannel(메시지)
• ListingGroupFilterDimension.ProductCondition(메시지)
• ListingGroupFilterDimension.ProductCustomAttribute(메시지)
• ListingGroupFilterDimension.ProductItemId(메시지)
• ListingGroupFilterDimension.ProductType(메시지)
• ListingGroupFilterDimensionPath(메시지)
• LocationView(메시지)
• ProductBiddingCategoryConstant(메시지)
• ProductGroupView(메시지)
• SearchAds360Field(메시지)
• ShoppingPerformanceView(메시지)
• UserList(메시지)
• Visit(메시지)
• WebpageView(메시지)

AccessibleBiddingStrategy

고객이 소유하고 공유하는 입찰 전략 뷰를 나타냅니다.

입찰 전략과 달리 이 리소스에는 이 고객이 소유한 전략 외에도 고객의 관리자가 소유하고 이 고객과 공유된 전략이 포함됩니다. 이 리소스는 측정항목을 제공하지 않으며 입찰전략 속성의 제한된 하위 집합만 노출합니다.

입력란
resource_name	string 액세스할 수 있는 입찰 전략의 리소스 이름입니다. AccessibleBiddingStrategy 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
id	int64 입찰 전략의 ID입니다.
name	string 입찰 전략의 이름입니다.
type	BiddingStrategyType 입찰 전략의 유형입니다.
owner_customer_id	int64 입찰 전략을 소유한 고객의 ID입니다.
owner_descriptive_name	string 입찰 전략을 소유한 고객의 설명자_이름입니다.
통합 필드 scheme. 입찰 스키마입니다. 하나만 설정할 수 있습니다. scheme는 다음 중 하나여야 합니다.
maximize_conversion_value	MaximizeConversionValue 캠페인의 전환 가치를 최대한 높일 수 있는 방향으로 예산이 지출되도록 도와주는 자동 입찰 전략입니다.
maximize_conversions	MaximizeConversions 캠페인에서 가장 많은 전환이 발생하는 방향으로 예산이 지출되도록 도와주는 자동 입찰 전략입니다.
target_cpa	TargetCpa 설정된 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 입찰 전략입니다.
target_impression_share	TargetImpressionShare 선택한 노출수 비율에 맞춰 자동으로 최적화되는 입찰 전략입니다.
target_roas	TargetRoas 특정 타겟 광고 투자수익 (ROAS)을 평균화하면서 수익을 극대화할 수 있는 입찰 전략입니다.
target_spend	TargetSpend 예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

MaximizeConversionValue

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

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

MaximizeConversions

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

입력란
target_cpa	int64 타겟 전환당비용 (CPA) 옵션입니다. 전환 1회당 지출하고자 하는 평균 금액입니다.
target_cpa_micros	int64 타겟 전환당비용 (CPA) 옵션입니다. 전환 1회당 지출하고자 하는 평균 금액입니다.

TargetCpa

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

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

TargetImpressionShare

검색 광고의 일정 비율이 첫 페이지 (또는 다른 타겟 위치) 상단에 표시되도록 입찰가를 설정하는 자동 입찰 전략입니다.

입력란
location	TargetImpressionShareLocation 검색결과 페이지의 타겟 위치입니다.
location_fraction_micros	int64 타겟 지역에 게재할 광고의 선택된 부분(단위: 마이크로초)입니다. 예를 들어 1% 는 10,000입니다.
cpc_bid_ceiling_micros	int64 자동 입찰 시스템으로 지정할 수 있는 가장 높은 CPC 입찰가입니다. 광고주가 입력하는 필수 필드이고 상한을 설정하며 로컬 마이크로 단위로 지정됩니다.

TargetRoas

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

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

TargetSpend

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

입력란
target_spend_micros (deprecated)	int64 이 항목은 지원 중단되었습니다. 클릭수를 최대화할 지출 목표입니다. TargetSpend 입찰자는 이 값 또는 자연 제한 지출 금액 중 더 작은 값을 지출하려고 시도합니다. 지정하지 않으면 예산이 지출 목표로 사용됩니다. 이 필드는 지원 중단되었으며 더 이상 사용하지 않아야 합니다. 자세한 내용은 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html을 참고하세요.
cpc_bid_ceiling_micros	int64 입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다.

광고

광고

입력란
resource_name	string 광고의 리소스 이름입니다. 광고 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/ads/{ad_id}
final_urls[]	string 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.
type	AdType 광고의 유형입니다.
id	int64 광고의 ID입니다.
display_url	string 일부 광고 형식의 광고 설명에 표시되는 URL입니다.
name	string 광고의 이름입니다. 이 이름은 광고를 식별하는 데만 사용됩니다. 이름은 고유하지 않아도 되며 게재되는 광고에 영향을 주지 않습니다. 이름 필드는 현재 DisplayUploadAd, ImageAd, ShoppingComparisonListingAd, VideoAd에 대해서만 지원됩니다.
통합 필드 ad_data. 광고 유형과 관련된 세부정보입니다. 정확히 하나의 값을 설정해야 합니다. ad_data은 다음 중 하나여야 합니다.
text_ad	SearchAds360TextAdInfo 텍스트 광고와 관련된 세부정보입니다.
expanded_text_ad	SearchAds360ExpandedTextAdInfo 확장 텍스트 광고와 관련된 세부정보입니다.
responsive_search_ad	SearchAds360ResponsiveSearchAdInfo 반응형 검색 광고와 관련된 세부정보입니다.
product_ad	SearchAds360ProductAdInfo 제품 광고와 관련된 세부정보입니다.
expanded_dynamic_search_ad	SearchAds360ExpandedDynamicSearchAdInfo 확장 동적 검색 광고와 관련된 세부정보입니다.

AdGroup

광고그룹입니다.

입력란
resource_name	string 광고그룹의 리소스 이름입니다. 광고그룹 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/adGroups/{ad_group_id}
status	AdGroupStatus 광고 그룹의 상태입니다.
type	AdGroupType 광고 그룹의 유형입니다.
ad_rotation_mode	AdGroupAdRotationMode 광고그룹의 광고 로테이션 모드입니다.
creation_time	string 이 광고그룹이 생성된 시점의 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.
targeting_setting	TargetingSetting 관련 기능을 타겟팅하기 위한 설정입니다.
labels[]	string 이 광고 그룹에 연결된 라벨의 리소스 이름입니다.
engine_id	string 외부 엔진 계정의 광고 그룹 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "ad_group.id"를 사용하세요.
start_date	string 이 광고 그룹에서 광고 게재를 시작하는 날짜입니다. 기본적으로 광고 그룹은 지금 또는 광고 그룹의 시작일 중에서 늦은 날짜에 시작합니다. 이 필드를 설정하면 고객의 시간대로 지정된 날짜가 시작될 때 광고 그룹이 시작됩니다. 이 필드는 Microsoft Advertising 및 Facebook 게이트웨이 계정에만 사용할 수 있습니다. 형식: YYYY-MM-DD(예: 2019-03-14)
end_date	string 광고 그룹의 광고 게재가 종료되는 날짜입니다. 기본적으로 광고 그룹은 광고 그룹의 종료일에 종료됩니다. 이 필드를 설정하면 고객의 시간대로 지정된 날짜가 끝날 때 광고 그룹이 종료됩니다. 이 필드는 Microsoft Advertising 및 Facebook 게이트웨이 계정에만 사용할 수 있습니다. 형식: YYYY-MM-DD(예: 2019-03-14)
language_code	string 광고 그룹에서 광고 및 키워드의 언어입니다. 이 필드는 Microsoft Advertising 계정에만 사용할 수 있습니다. 자세히 알아보기: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
last_modified_time	string 이 광고 그룹이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.
id	int64 광고 그룹의 ID입니다.
name	string 광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null(코드 포인트 0x0), NL 라인 피드(코드 포인트 0xA), 캐리지 리턴(코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
cpc_bid_micros	int64 최대 CPC(클릭당비용) 입찰가입니다.
engine_status	AdGroupEngineStatus 광고그룹의 엔진 상태입니다.

AdGroupAd

광고그룹 광고입니다.

입력란
resource_name	string 광고의 리소스 이름입니다. 광고그룹 광고 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
status	AdGroupAdStatus 광고의 상태입니다.
ad	Ad 광고
creation_time	string 이 ad_group_ad가 생성된 시점의 타임스탬프입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.
labels[]	string 이 광고 그룹 광고에 연결된 라벨의 리소스 이름입니다.
engine_id	string 외부 엔진 계정의 광고 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 SearchAds 360 계정에만 사용됩니다. SearchAds 360 이외의 항목의 경우 대신 "ad_group_ad.ad.id"를 사용하세요.
engine_status	AdGroupAdEngineStatus 외부 엔진 계정에 있는 광고의 추가 상태입니다. 외부 계정 유형에 따라 가능한 상태는 활성, 적격, 검토 대기중 등입니다.
last_modified_time	string 이 광고 그룹 광고가 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

AdGroupAdLabel

광고그룹 광고와 라벨의 관계입니다.

입력란
resource_name	string 광고그룹 광고 라벨의 리소스 이름입니다. 광고그룹 광고 라벨 리소스 이름의 형식은 customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}입니다.
ad_group_ad	string 라벨이 추가된 광고그룹 광고입니다.
label	string 광고그룹 광고에 할당된 라벨입니다.

AdGroupAsset

광고그룹과 확장 소재 간의 연결입니다.

입력란
resource_name	string 광고 그룹 애셋의 리소스 이름입니다. AdGroupAsset 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group	string 필수 항목입니다. 애셋이 연결된 광고 그룹입니다.
asset	string 필수 항목입니다. 광고 그룹에 연결된 애셋입니다.
status	AssetLinkStatus 광고그룹 애셋의 상태입니다.

AdGroupAssetSet

AdGroupAssetSet는 광고그룹과 애셋 집합 간의 연결입니다. AdGroupAssetSet를 만들면 애셋 세트가 광고그룹과 연결됩니다.

입력란
resource_name	string 광고그룹 애셋 세트의 리소스 이름입니다. 광고그룹 애셋 세트 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
ad_group	string 이 애셋 세트가 연결된 광고 그룹입니다.
asset_set	string 광고 그룹에 연결된 애셋 세트입니다.
status	AssetSetLinkStatus 광고그룹 애셋 세트의 상태입니다. 읽기 전용입니다.

AdGroupAudienceView

광고그룹 잠재고객 보기 잠재고객 수준에서 집계된 관심분야 및 디스플레이 네트워크 및 YouTube 네트워크 광고용 리마케팅 목록, 검색 광고용 리마케팅 목록 (RLSA)의 실적 데이터가 포함됩니다.

입력란
resource_name	string 광고그룹 잠재고객 뷰의 리소스 이름입니다. 광고그룹 잠재고객 보기 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

광고그룹 입찰가 조정을 나타냅니다.

입력란
resource_name	string 광고그룹 입찰가 조정의 리소스 이름입니다. 광고그룹 입찰가 조정 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}
bid_modifier	double 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 선호 콘텐츠의 경우 범위는 1.0~6.0입니다. 기기 유형을 선택 해제하려면 0을 사용합니다.
통합 필드 criterion. 이 광고그룹 입찰가 조정의 기준입니다. V5부터는 create 작업에 필요합니다. criterion는 다음 중 하나여야 합니다.
device	DeviceInfo 기기 기준입니다.

AdGroupCriterion

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

입력란
resource_name	string 광고그룹 기준의 리소스 이름입니다. 광고그룹 기준 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
creation_time	string 이 광고 그룹 기준이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.
status	AdGroupCriterionStatus 기준의 상태입니다. 고객이 설정한 광고 그룹 기준 항목의 상태입니다. 참고: UI 보고서에는 기준 실행 가능 여부에 영향을 미치는 추가 정보가 포함될 수 있습니다. 일부 경우에는 API에서 삭제된 기준이 UI에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다.
quality_info	QualityInfo 기준의 품질에 관한 정보입니다.
type	CriterionType 기준의 유형입니다.
labels[]	string 이 광고 그룹 기준에 연결된 라벨의 리소스 이름입니다.
position_estimates	PositionEstimates 다양한 게재순위에서의 기준 입찰가 추정치
final_urls[]	string 광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.
engine_id	string 외부 엔진 계정의 광고그룹 기준 ID입니다. 이 입력란은 Google Ads 이외의 계정(예: Yahoo Japan, Microsoft, Baidu 등)에만 사용됩니다. Google Ads 항목의 경우 'ad_group_criterion.criterion_id'를 대신 사용하세요.
last_modified_time	string 이 광고 그룹 기준이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.
criterion_id	int64 기준의 ID입니다.
ad_group	string 기준이 속한 광고그룹입니다.
negative	bool 기준을 타겟팅 (false)할지 또는 제외 (true)할지 여부입니다. 이 필드는 변경할 수 없습니다. 기준을 포함에서 제외로 전환하려면 기준을 삭제한 후 다시 추가합니다.
bid_modifier	double 기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다.
cpc_bid_micros	int64 CPC(클릭당비용) 입찰가입니다.
effective_cpc_bid_micros	int64 유효 CPC(클릭당비용) 입찰가입니다.
engine_status	AdGroupCriterionEngineStatus 광고 그룹 기준의 엔진 상태입니다.
final_url_suffix	string 최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다.
tracking_url_template	string 추적 URL을 만들기 위한 URL 템플릿입니다.
통합 필드 criterion. 광고그룹 기준입니다. 정확히 1개를 설정해야 합니다. criterion는 다음 중 하나여야 합니다.
keyword	KeywordInfo 키워드
listing_group	ListingGroupInfo 등록정보 그룹입니다.
age_range	AgeRangeInfo 연령대
gender	GenderInfo 성별.
user_list	UserListInfo 사용자 목록.
webpage	WebpageInfo 웹페이지
location	LocationInfo 위치를 탭합니다.

PositionEstimates

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

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

QualityInfo

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

입력란
quality_score	int32 품질평가점수입니다. Google에서 값을 결정하기 위한 정보가 충분하지 않으면 이 필드가 채워지지 않을 수 있습니다.

AdGroupCriterionLabel

광고그룹 기준 및 라벨 간의 관계입니다.

입력란
resource_name	string 광고그룹 기준 라벨의 리소스 이름입니다. 광고그룹 기준 라벨 리소스 이름의 형식은 customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}입니다.
ad_group_criterion	string 라벨이 연결된 광고그룹 기준입니다.
label	string 광고그룹 기준에 할당된 라벨입니다.

AdGroupLabel

광고그룹과 라벨의 관계입니다.

입력란
resource_name	string 광고그룹 라벨의 리소스 이름입니다. 광고그룹 라벨 리소스 이름의 형식은 customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}입니다.
ad_group	string 라벨이 연결된 광고그룹입니다.
label	string 광고 그룹에 할당된 라벨입니다.

AgeRangeView

연령대 보기

입력란
resource_name	string 연령대 뷰의 리소스 이름입니다. 연령대 보기 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

애셋

확장 소재는 여러 광고에서 공유할 수 있는 광고의 일부입니다. 이미지 (ImageAsset), 동영상 (YoutubeVideoAsset) 등일 수 있습니다. 애셋은 변경할 수 없으며 삭제할 수 없습니다. 확장 소재의 게재를 중지하려면 확장 소재를 사용 중인 항목에서 확장 소재를 삭제하세요.

입력란
resource_name	string 애셋의 리소스 이름입니다. 애셋 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/assets/{asset_id}
type	AssetType 저작물의 유형입니다.
final_urls[]	string 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.
status	AssetStatus 애셋의 상태입니다.
creation_time	string 이 애셋이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.
last_modified_time	string 이 애셋이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.
id	int64 애셋의 ID입니다.
name	string 애셋의 이름입니다(선택사항).
tracking_url_template	string 추적 URL을 만들기 위한 URL 템플릿입니다.
engine_status	AssetEngineStatus 애셋의 엔진 상태입니다.
통합 필드 asset_data. 저작물의 구체적인 유형입니다. asset_data은 다음 중 하나여야 합니다.
youtube_video_asset	YoutubeVideoAsset YouTube 동영상 저작물입니다.
image_asset	ImageAsset 이미지 애셋입니다.
text_asset	TextAsset 텍스트 애셋입니다.
callout_asset	UnifiedCalloutAsset 통합 콜아웃 확장 소재입니다.
sitelink_asset	UnifiedSitelinkAsset 통합 사이트링크 확장 소재입니다.
page_feed_asset	UnifiedPageFeedAsset 통합 페이지 피드 애셋입니다.
mobile_app_asset	MobileAppAsset 모바일 앱 확장 소재
call_asset	UnifiedCallAsset 통합된 전화번호 확장 소재입니다.
call_to_action_asset	CallToActionAsset 클릭 유도 문구 애셋입니다.
location_asset	UnifiedLocationAsset 통합된 위치 확장 소재입니다.

AssetGroup

애셋 그룹. AssetGroupAsset은 애셋을 애셋 그룹에 연결하는 데 사용됩니다. AssetGroupSignal은 신호를 애셋 그룹에 연결하는 데 사용됩니다.

입력란
resource_name	string 애셋 그룹의 리소스 이름입니다. 애셋 그룹 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/assetGroups/{asset_group_id}
id	int64 애셋 그룹의 ID입니다.
campaign	string 이 애셋 그룹이 연결된 캠페인입니다. 애셋 그룹에 연결된 애셋입니다.
name	string 필수 항목입니다. 애셋 그룹의 이름입니다. 필수 항목입니다. 길이는 1~128자여야 합니다. 캠페인 내에서 고유해야 합니다.
final_urls[]	string 모든 교차 도메인 리디렉션 후의 최종 도착 URL 목록입니다. 실적 최대화 캠페인에서는 선택 해제하지 않는 한 기본적으로 URL을 확장할 수 있습니다.
final_mobile_urls[]	string 모든 교차 도메인 리디렉션 후의 최종 모바일 URL 목록입니다. 실적 최대화 캠페인에서는 선택 해제하지 않는 한 기본적으로 URL을 확장할 수 있습니다.
status	AssetGroupStatus 애셋 그룹의 상태입니다.
path1	string 광고에 표시되는 URL에 추가되는 텍스트의 첫 부분입니다.
path2	string 광고에 표시되는 URL에 추가되는 텍스트의 두 번째 부분입니다. 이 필드는 path1이 설정된 경우에만 설정할 수 있습니다.
ad_strength	AdStrength 이 애셋 그룹의 전반적인 광고 효력입니다.

AssetGroupAsset

AssetGroupAsset은 애셋과 애셋 그룹 간의 연결입니다. AssetGroupAsset을 추가하면 애셋이 애셋 그룹과 연결됩니다.

입력란
resource_name	string 애셋 그룹 애셋의 리소스 이름입니다. 애셋 그룹 애셋 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group	string 이 애셋 그룹 애셋에서 연결하는 애셋 그룹입니다.
asset	string 이 애셋 그룹 애셋에서 연결하는 애셋입니다.
field_type	AssetFieldType 애셋 그룹 내 애셋의 게재위치에 대한 설명입니다. 예: HEADLINE, YOUTUBE_VIDEO 등
status	AssetLinkStatus 애셋과 애셋 그룹 간의 연결 상태입니다.

AssetGroupAssetCombinationData

애셋 그룹 애셋 조합 데이터

입력란
asset_combination_served_assets[]	AssetUsage 게재된 애셋.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter는 애셋 그룹의 등록정보 그룹 필터 트리 노드를 나타냅니다.

입력란
resource_name	string 애셋 그룹 등록정보 그룹 필터의 리소스 이름입니다. 애셋 그룹 등록정보 그룹 필터 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
asset_group	string 이 애셋 그룹 등록정보 그룹 필터가 속한 애셋 그룹입니다.
id	int64 ListingGroupFilter의 ID입니다.
type	ListingGroupFilterType 등록정보 그룹 필터 노드의 유형입니다.
vertical	ListingGroupFilterVertical 현재 노드 트리가 나타내는 카테고리입니다. 동일한 트리의 모든 노드는 동일한 카테고리에 속해야 합니다.
case_value	ListingGroupFilterDimension 이 등록정보 그룹에서 상위 항목을 수정하는 데 사용하는 측정기준 값입니다. 루트 그룹에 대해 정의되지 않았습니다.
parent_listing_group_filter	string 상위 등록정보 그룹 하위 그룹의 리소스 이름입니다. 루트 등록정보 그룹 필터 노드의 경우 null입니다.
path	ListingGroupFilterDimensionPath 이 등록정보 그룹 필터를 정의하는 측정기준의 경로입니다.

AssetGroupSignal

AssetGroupSignal은 애셋 그룹의 신호를 나타냅니다. 신호가 있으면 전환 가능성이 가장 큰 실적 최대화 캠페인을 알 수 있습니다. 실적 최대화 캠페인은 이 신호를 사용하여 검색, 디스플레이, 동영상 등에서 전환 기회를 찾기 위해 유사하거나 더 강한 의도를 가진 신규 사용자를 찾습니다.

입력란
resource_name	string 애셋 그룹 신호의 리소스 이름입니다. 애셋 그룹 신호 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group	string 이 애셋 그룹 신호가 속한 애셋 그룹입니다.
통합 필드 signal. 애셋 그룹의 신호입니다. signal은 다음 중 하나여야 합니다.
audience	AudienceInfo 실적 최대화 캠페인에서 사용할 잠재고객 신호입니다.

AssetGroupTopCombinationView

광고그룹 광고 확장 소재 조합 사용에 대한 보기입니다.

입력란
resource_name	string 애셋 그룹 상단 조합 보기의 리소스 이름입니다. AssetGroup 상위 조합 보기 리소스 이름의 형식은 다음과 같습니다. "customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
asset_group_top_combinations[]	AssetGroupAssetCombinationData 함께 게재된 애셋의 상위 조합입니다.

AssetSet

애셋 모음을 나타내는 애셋 세트입니다. AssetSetAsset을 사용하여 애셋을 애셋 세트에 연결합니다.

입력란
id	int64 애셋 세트의 ID입니다.
resource_name	string 애셋 세트의 리소스 이름입니다. 애셋 세트 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset은 애셋과 애셋 세트 간의 연결입니다. AssetSetAsset을 추가하면 애셋이 애셋 세트와 연결됩니다.

입력란
resource_name	string 애셋 세트 애셋의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
asset_set	string 이 애셋 집합이 연결된 애셋 집합입니다.
asset	string 이 애셋 집합이 연결된 애셋입니다.
status	AssetSetAssetStatus 애셋 세트 애셋의 상태입니다. 읽기 전용입니다.

대상

잠재고객은 상세한 인구통계, 관심분야 등 다양한 세그먼트 속성을 교차하여 타겟 세그먼트의 섹션을 나타내는 잠재고객을 만들 수 있는 효과적인 타겟팅 옵션입니다.

입력란
resource_name	string 잠재고객의 리소스 이름입니다. 잠재고객 이름의 형식은 다음과 같습니다. customers/{customer_id}/audiences/{audience_id}
id	int64 잠재고객의 ID입니다.
name	string 필수 항목입니다. 잠재고객의 이름입니다. 모든 잠재고객에 고유해야 합니다. 길이는 1~255자여야 합니다.
description	string 잠재고객에 대한 설명입니다.

BiddingStrategy

입찰 전략

입력란
resource_name	string 입찰 전략의 리소스 이름입니다. 입찰 전략 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
status	BiddingStrategyStatus 입찰 전략의 상태입니다. 이 필드는 읽기 전용입니다.
type	BiddingStrategyType 입찰 전략의 유형입니다. 입찰 체계를 설정하여 입찰 전략을 만듭니다. 이 필드는 읽기 전용입니다.
currency_code	string 입찰 전략에 사용되는 통화입니다 (ISO 4217 3자리 코드). 관리자 고객의 입찰 전략의 경우 이 통화는 생성 시 설정할 수 있으며 기본적으로 관리자 고객의 통화로 설정됩니다. 고객에게 서비스를 제공하는 경우 이 필드를 설정할 수 없습니다. 게재 고객의 모든 전략은 게재 고객의 통화를 암시적으로 사용합니다. 모든 경우effective_currency_code 필드는 전략에 사용되는 통화를 반환합니다.
id	int64 입찰 전략의 ID입니다.
name	string 입찰 전략의 이름입니다. 한 계정 내의 모든 입찰 전략은 이름이 고유해야 합니다. 이 문자열의 길이는 UTF-8 바이트 단위(공백 삭제)로 1~255 사이(1 및 255 포함)여야 합니다.
effective_currency_code	string 입찰 전략에 사용되는 통화입니다 (ISO 4217 3자리 코드). 관리자 고객의 입찰 전략의 경우 광고주가 전략을 만들 때 설정하는 통화입니다. 고객에게 서비스를 제공하는 경우 고객의 currency_code입니다. 입찰 전략 측정항목은 이 통화로 보고됩니다. 이 필드는 읽기 전용입니다.
campaign_count	int64 이 입찰 전략에 연결된 캠페인의 수입니다. 이 필드는 읽기 전용입니다.
non_removed_campaign_count	int64 이 입찰 전략에 연결된 삭제되지 않은 캠페인의 수입니다. 이 필드는 읽기 전용입니다.
통합 필드 scheme. 입찰 스키마입니다. 하나만 설정할 수 있습니다. scheme는 다음 중 하나여야 합니다.
enhanced_cpc	EnhancedCpc 전환으로 이어질 가능성이 높은 클릭의 입찰가를 높이고 가능성이 낮은 클릭의 경우 입찰가를 낮추는 입찰 전략입니다.
maximize_conversion_value	MaximizeConversionValue 캠페인의 전환 가치를 최대한 높일 수 있는 방향으로 예산이 지출되도록 도와주는 자동 입찰 전략입니다.
maximize_conversions	MaximizeConversions 캠페인에서 가장 많은 전환이 발생하는 방향으로 예산이 지출되도록 도와주는 자동 입찰 전략입니다.
target_cpa	TargetCpa 설정된 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 입찰 전략입니다.
target_impression_share	TargetImpressionShare 선택한 노출수 비율에 맞춰 자동으로 최적화되는 입찰 전략입니다.
target_outrank_share	TargetOutrankShare 광고주가 특정 경쟁업체보다 높은 순위를 얻어야 하는 입찰의 타겟 비율을 기반으로 입찰가를 설정하는 입찰 전략입니다. 이 필드는 더 이상 사용되지 않습니다. 이 필드로 새 입찰 전략을 만들거나 이 필드가 포함된 입찰 전략을 캠페인에 연결할 수 없습니다. 이 스키마가 이미 채워진 전략으로 변경하는 것은 허용됩니다.
target_roas	TargetRoas 특정 타겟 광고 투자수익 (ROAS)을 평균화하면서 수익을 극대화할 수 있는 입찰 전략입니다.
target_spend	TargetSpend 예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

실행

캠페인

입력란
resource_name	string 캠페인의 리소스 이름입니다. 캠페인 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/campaigns/{campaign_id}
status	CampaignStatus 캠페인의 상태입니다. 새 캠페인이 추가되면 기본 상태는 '사용'으로 설정됩니다.
serving_status	CampaignServingStatus 캠페인의 광고 게재 상태입니다.
bidding_strategy_system_status	BiddingStrategySystemStatus 캠페인 입찰 전략의 시스템 상태입니다.
ad_serving_optimization_status	AdServingOptimizationStatus 캠페인의 광고 게재 최적화 상태입니다.
advertising_channel_type	AdvertisingChannelType 캠페인 내 광고의 기본 게재 타겟입니다. network_settings에서 타겟팅 옵션을 세분화할 수 있습니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. 캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다.
advertising_channel_sub_type	AdvertisingChannelSubType advertising_channel_type에 대한 선택적 상세검색입니다. 상위 채널 유형의 유효한 하위 유형이어야 합니다. 캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다.
url_custom_parameters[]	CustomParameter tracking_url_template, final_urls 또는 mobile_final_urls에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다.
real_time_bidding_setting	RealTimeBiddingSetting 실시간 입찰 설정(Ad Exchange 네트워크를 타겟팅하는 캠페인에서만 사용할 수 있는 기능)
network_settings	NetworkSettings 캠페인의 네트워크 설정입니다.
dynamic_search_ads_setting	DynamicSearchAdsSetting 동적 검색 광고 (DSA)를 관리하기 위한 설정입니다.
shopping_setting	ShoppingSetting 쇼핑 캠페인을 관리하기 위한 설정입니다.
geo_target_type_setting	GeoTargetTypeSetting 광고의 지역 타겟팅 설정입니다.
labels[]	string 이 캠페인에 연결된 라벨의 리소스 이름입니다.
bidding_strategy_type	BiddingStrategyType 입찰 전략의 유형입니다. 입찰 전략을 만들어 표준 입찰 전략을 만들거나 bidding_strategy 필드를 설정하여 포트폴리오 입찰 전략을 만들 수 있습니다. 이 필드는 읽기 전용입니다.
accessible_bidding_strategy	string AccessibleBiddingStrategy의 리소스 이름으로, 연결된 포트폴리오 입찰 전략의 제한되지 않은 속성에 대한 읽기 전용 뷰이며 'bidding_strategy'로 식별됩니다. 비어 있음: 캠페인에서 포트폴리오 전략을 사용하지 않는 경우 제한되지 않은 전략 속성은 전략이 공유되고 AccessibleBiddingStrategy 리소스에서 해당 전략을 읽을 수 있는 모든 고객이 사용할 수 있습니다. 반대로 제한된 속성은 전략의 소유자 고객 및 해당 관리자만 사용할 수 있습니다. 제한된 속성은 BidStrategy 리소스에서만 읽을 수 있습니다.
frequency_caps[]	FrequencyCapEntry 각 사용자에게 이 캠페인의 광고가 게재되는 빈도를 제한하는 목록입니다.
selective_optimization	SelectiveOptimization 이 캠페인에 대한 선택적 최적화 설정이며 이 캠페인을 최적화할 수 있는 전환 액션의 집합이 포함됩니다. 이 기능은 AdvertisingChannelType으로 MULTI_CHANNEL을, AdvertisingChannelSubType으로 APP_CAMPAIGN 또는 APP_CAMPAIGN_FOR_ENGAGEMENT를 사용하는 앱 캠페인에만 적용됩니다.
optimization_goal_setting	OptimizationGoalSetting 최적화 목표 유형의 집합이 포함된 이 캠페인의 최적화 목표 설정입니다.
tracking_setting	TrackingSetting 추적 정보에 대한 캠페인 수준 설정입니다.
engine_id	string 외부 엔진 계정의 캠페인 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "campaign.id"를 사용하세요.
excluded_parent_asset_field_types[]	AssetFieldType 이 캠페인에서 제외해야 하는 확장 소재 입력란 유형입니다. 이러한 입력란 유형의 애셋 링크는 상위 수준에서 이 캠페인에 상속되지 않습니다.
create_time	string 이 캠페인이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대이며 'yyyy-MM-dd HH:mm:ss' 형식입니다. create_time은 v1에서 지원 중단됩니다. 대신 create_time을 사용하세요.
creation_time	string 이 캠페인이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.
last_modified_time	string 이 캠페인이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.
id	int64 캠페인의 ID입니다.
name	string 캠페인의 이름입니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. null(코드 포인트 0x0), NL 라인 피드(코드 포인트 0xA), 캐리지 리턴(코드 포인트 0xD) 문자는 포함하지 않아야 합니다.
tracking_url_template	string 추적 URL을 만들기 위한 URL 템플릿입니다.
campaign_budget	string 캠페인의 예산입니다.
start_date	string YYYY-MM-DD 형식의 게재 고객의 시간대로 캠페인이 시작된 날입니다.
end_date	string YYYY-MM-DD 형식의 게재 고객의 시간대로 캠페인 마지막 날입니다. 생성 시 기본값은 2037-12-30입니다. 즉, 캠페인이 무기한 실행됩니다. 기존 캠페인이 무한정 운영되도록 설정하려면 이 필드를 2037-12-30으로 설정하세요.
final_url_suffix	string 병렬 추적으로 게재되는 방문 페이지에 쿼리 매개변수를 추가하는 데 사용되는 접미사입니다.
url_expansion_opt_out	bool 더욱 타겟팅된 URL로의 URL 확장 선택 해제를 나타냅니다. 선택 해제 (true)인 경우 애셋 그룹의 최종 URL 또는 광고주의 Google 판매자 센터 또는 비즈니스 데이터 피드에 지정된 URL만 타겟팅됩니다. 선택 (false)인 경우 전체 도메인이 타겟팅됩니다. 이 필드는 기본값이 false인 실적 최대화 캠페인에만 설정할 수 있습니다.
통합 필드 campaign_bidding_strategy. 캠페인의 입찰 전략입니다. 캠페인에 삽입된 포트폴리오 (BiddingStrategy 서비스를 통해 생성됨) 또는 표준이어야 합니다. campaign_bidding_strategy는 다음 중 하나여야 합니다.
bidding_strategy	string 캠페인에서 사용된 포트폴리오 입찰 전략입니다.
manual_cpa	ManualCpa 표준 수동 CPA 입찰 전략 광고주가 지정한 액션별로 입찰가를 설정할 수 있는 수동 입찰 전략입니다. 지역 서비스 캠페인에서만 지원됩니다.
manual_cpc	ManualCpc 표준 수동 CPC 입찰 전략 사용자가 클릭당 지불하는 수동 클릭 기반 입찰입니다.
manual_cpm	ManualCpm 표준 수동 CPM 입찰 전략 사용자가 1,000회 노출당 비용을 지불하는 수동 노출 기반 입찰입니다.
maximize_conversions	MaximizeConversions 예산을 지출하면서 자동으로 전환수를 최대화하는 표준 전환수 최대화 입찰 전략입니다.
maximize_conversion_value	MaximizeConversionValue 수익을 최대화하는 방향으로 예산이 지출되도록 입찰가를 자동으로 설정하는 표준 전환 가치 극대화 입찰 전략입니다.
target_cpa	TargetCpa 설정한 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 자동으로 설정하는 표준 타겟 CPA 입찰 전략입니다.
target_impression_share	TargetImpressionShare 타겟 노출 점유율 입찰 전략입니다. 선택한 비율의 노출수를 달성하도록 입찰가를 설정하는 자동 입찰 전략입니다.
target_roas	TargetRoas 특정 타겟 광고 투자수익(ROAS)을 평균화하면서 자동으로 수익을 극대화하는 표준 타겟 광고 투자수익(ROAS) 입찰 전략입니다.
target_spend	TargetSpend 예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 자동으로 설정하는 표준 목표 지출액 입찰 전략입니다.
percent_cpc	PercentCpc 입찰가가 일부 상품 또는 서비스에 대한 광고 가격의 일부인 표준 비율 CPC 입찰 전략입니다.
target_cpm	TargetCpm 1,000회 노출당비용을 자동으로 최적화하는 입찰 전략입니다.

DynamicSearchAdsSetting

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

입력란
domain_name	string 필수 항목입니다. 이 설정이 나타내는 인터넷 도메인 이름입니다(예: 'google.com' 또는 'www.google.com').
language_code	string 필수 항목입니다. 도메인의 언어를 지정하는 언어 코드입니다(예: 'en').
use_supplied_urls_only	bool 캠페인에서 광고주 제공 URL만 사용하는지 여부입니다.

GeoTargetTypeSetting

광고 지역 타겟팅과 관련된 설정 모음을 나타냅니다.

입력란
positive_geo_target_type	PositiveGeoTargetType 이 특정 캠페인의 포함 지역 타겟팅에 사용되는 설정입니다.
negative_geo_target_type	NegativeGeoTargetType 이 특정 캠페인의 제외 지역 타겟팅에 사용되는 설정입니다.

NetworkSettings

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

입력란
target_google_search	bool 광고를 google.com 검색 결과에 게재할지 여부입니다.
target_search_network	bool Google 검색 네트워크의 파트너 사이트에 광고를 게재할지 여부입니다. target_google_search도 true이어야 합니다.
target_content_network	bool 광고가 Google 디스플레이 네트워크의 지정된 게재위치에 게재되는지 여부입니다. 게재위치는 게재위치 기준을 사용하여 지정됩니다.
target_partner_search_network	bool 광고가 Google 파트너 네트워크에 게재되는지 여부입니다. 이 기능은 일부 Google 파트너 계정에서만 사용할 수 있습니다.

OptimizationGoalSetting

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

입력란
optimization_goal_types[]	OptimizationGoalType 최적화 목표 유형의 목록입니다.

SelectiveOptimization

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

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

ShoppingSetting

쇼핑 캠페인의 설정입니다. 캠페인에서 광고할 수 있는 다양한 제품과 이 캠페인이 다른 쇼핑 캠페인과 상호작용하는 방식을 정의합니다.

입력란
feed_label	string 캠페인에 포함할 제품의 피드 라벨입니다. feed_label 또는 sales_country 중 하나만 설정할 수 있습니다. sales_country 대신 사용할 경우 feed_label 필드에 동일한 형식의 국가 코드(예: 'XX')가 허용됩니다. 그 외의 경우에는 Google 판매자 센터의 피드 라벨에 사용되는 어떤 문자열이든 가능합니다.
use_vehicle_inventory	bool 차량 등록정보 인벤토리를 타겟팅할지 여부입니다.
merchant_id	int64 판매자 센터 계정의 ID입니다. 이 필드는 작업을 만드는 데 필요합니다. 쇼핑 캠페인에서는 이 입력란을 변경할 수 없습니다.
sales_country	string 캠페인에 포함할 제품의 판매 국가입니다.
campaign_priority	int32 캠페인의 우선순위입니다. 숫자가 우선순위가 높은 캠페인이 우선순위가 낮은 캠페인보다 우선합니다. 이 필드는 0 이상 2 이하의 값을 가진 쇼핑 캠페인에 필요합니다. 스마트 쇼핑 캠페인의 경우 이 필드는 선택사항이지만 설정된 경우 3과 같아야 합니다.
enable_local	bool 오프라인 제품을 포함할지 여부입니다.

TrackingSetting

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

입력란
tracking_url	string 동적 추적에 사용되는 URL입니다.

CampaignAsset

캠페인과 저작물 간의 연결입니다.

입력란
resource_name	string 캠페인 애셋의 리소스 이름입니다. CampaignAsset 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
status	AssetLinkStatus 캠페인 확장 소재의 상태입니다.
campaign	string 애셋이 연결된 캠페인입니다.
asset	string 캠페인에 연결된 애셋입니다.

CampaignAssetSet

CampaignAssetSet은 캠페인과 애셋 세트 간의 연결입니다. CampaignAssetSet을 추가하면 애셋 세트가 캠페인과 연결됩니다.

입력란
resource_name	string 캠페인 애셋 세트의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign	string 이 애셋 세트가 연결된 캠페인입니다.
asset_set	string 캠페인에 연결된 애셋 세트입니다.
status	AssetSetLinkStatus 캠페인 애셋 세트 애셋의 상태입니다. 읽기 전용입니다.

CampaignAudienceView

캠페인 잠재고객 뷰 캠페인 및 잠재고객 기준별로 집계된 관심분야 및 디스플레이 네트워크 및 YouTube 네트워크 광고용 리마케팅 목록과 검색 광고용 리마케팅 목록 (RLSA)의 실적 데이터가 포함됩니다. 이 보기에는 캠페인 수준에서 연결된 잠재고객만 포함됩니다.

입력란
resource_name	string 캠페인 잠재고객 뷰의 리소스 이름입니다. 캠페인 잠재고객 보기 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

캠페인 예산입니다.

입력란
resource_name	string 캠페인 예산의 리소스 이름입니다. 캠페인 예산 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/campaignBudgets/{campaign_budget_id}
delivery_method	BudgetDeliveryMethod 캠페인 예산의 소비율을 결정하는 게재 방법입니다. 만들기 작업에서 지정되지 않은 경우 기본적으로 STANDARD입니다.
period	BudgetPeriod 예산을 지출할 기간입니다. 지정하지 않으면 기본적으로 DAILY입니다.
amount_micros	int64 예산 금액(계정의 현지 통화)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. 월별 지출은 이 금액의 30.4배로 제한됩니다.

CampaignCriterion

캠페인 기준입니다.

입력란
resource_name	string 캠페인 기준의 리소스 이름입니다. 캠페인 기준 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
display_name	string 기준의 표시 이름입니다. 이 필드는 변경 시 무시됩니다.
type	CriterionType 기준의 유형입니다.
status	CampaignCriterionStatus 기준의 상태입니다.
last_modified_time	string 이 캠페인 기준이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.
criterion_id	int64 기준의 ID입니다. 이 필드는 변경 중에 무시됩니다.
bid_modifier	float 기준이 일치할 때 입찰가에 적용되는 조정입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. 기기 유형을 선택 해제하려면 0을 사용합니다.
negative	bool 기준을 타겟팅 (false)할지 또는 제외 (true)할지 여부입니다.
통합 필드 criterion. 캠페인 기준입니다. 정확히 1개를 설정해야 합니다. criterion는 다음 중 하나여야 합니다.
keyword	KeywordInfo 키워드
location	LocationInfo 위치를 탭합니다.
device	DeviceInfo 기기 등 데이터를 분류할 옵션을 선택합니다.
age_range	AgeRangeInfo 연령대
gender	GenderInfo 성별.
user_list	UserListInfo 사용자 목록.
language	LanguageInfo 언어
webpage	WebpageInfo 웹페이지
location_group	LocationGroupInfo 위치 그룹

CampaignLabel

캠페인과 라벨 간의 관계를 나타냅니다.

입력란
resource_name	string 리소스의 이름입니다. 캠페인 라벨 리소스 이름의 형식은 customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}입니다.
campaign	string 라벨이 연결된 캠페인입니다.
label	string 캠페인에 할당된 라벨입니다.

CartDataSalesView

장바구니 데이터 판매 보기

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

전환

전환

입력란
resource_name	string 전환의 리소스 이름입니다. 전환 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}
id	int64 전환의 ID입니다.
criterion_id	int64 Search Ads 360 기준 ID입니다. 값이 0이면 기준의 출처가 지정되지 않음을 나타냅니다.
merchant_id	int64 클릭된 제품이 포함된 SearchAds360 인벤토리 계정 ID입니다. SearchAds360에서 인벤토리 계정을 연결할 때 SearchAds360에서 이 ID가 생성됩니다.
ad_id	int64 광고 ID 값이 0이면 광고가 표시되지 않음을 나타냅니다.
click_id	string 전환이 발생한 방문의 고유한 문자열로, 클릭 ID URL 매개변수로 방문 페이지에 전달됩니다.
visit_id	int64 전환이 발생한 SearchAds360 방문 ID입니다.
advertiser_conversion_id	string 오프라인 전환의 경우 광고주가 제공하는 ID입니다. 광고주가 이러한 ID를 지정하지 않으면 Search Ads 360에서 ID를 생성합니다. 온라인 전환의 경우 광고주의 플러드라이트 지침에 따라 id 열 또는 floodlight_order_id 열과 동일합니다.
product_id	string 클릭된 제품의 ID입니다.
product_channel	ProductChannel 클릭이 발생한 제품의 판매 채널: 온라인 또는 오프라인
product_language_code	string 제품에 대한 데이터가 포함된 판매자 센터 피드에 설정된 언어(ISO-639-1)입니다.
product_store_id	string 클릭된 오프라인 판매점 인벤토리 광고의 매장입니다. 이 ID는 오프라인 제품 피드에 사용된 매장 ID와 일치해야 합니다.
product_country_code	string 클릭한 제품이 포함된 인벤토리 피드에 등록된 국가(ISO-3166 형식)입니다.
attribution_type	AttributionType 전환의 원인: 방문 또는 키워드+광고
conversion_date_time	string 전환 이벤트의 타임스탬프입니다.
conversion_last_modified_date_time	string 전환이 마지막으로 수정된 시간의 타임스탬프입니다.
conversion_visit_date_time	string 전환이 발생한 방문의 타임스탬프
conversion_quantity	int64 전환으로 기록된 상품의 수량으로, qty url 매개변수에 의해 결정됩니다. 광고주가 매개변수를 동적으로 채워야 하며(예: 전환에서 판매된 항목 수) 그렇지 않은 경우 기본값은 1입니다.
conversion_revenue_micros	int64 전환 이벤트에 대해 조정된 수익(마이크로 단위)입니다. 이 금액은 항상 광고 게재 계정의 통화로 사용됩니다.
floodlight_original_revenue	int64 플러드라이트 통화 안내 수정 전 플러드라이트 이벤트와 연관된 원래의 변경되지 않은 수익입니다(현재 보고서의 통화).
floodlight_order_id	string 전환에 대해 광고주가 제공한 플러드라이트 주문 ID입니다.
status	ConversionStatus 전환 상태(사용 설정됨 또는 삭제됨)
asset_id	int64 전환 이벤트 중에 상호작용한 애셋의 ID입니다.
asset_field_type	AssetFieldType 전환 이벤트의 애셋 필드 유형입니다.

ConversionAction

전환 액션입니다.

입력란
resource_name	string 전환 액션의 리소스 이름입니다. 전환 액션 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/conversionActions/{conversion_action_id}
creation_time	string ISO 8601 형식의 플러드라이트 활동 생성의 타임스탬프입니다.
status	ConversionActionStatus 전환 이벤트 발생에 대한 이 전환 액션의 상태입니다.
type	ConversionActionType 이 전환 액션의 유형입니다.
category	ConversionActionCategory 이 전환 액션에 대해 보고된 전환의 카테고리입니다.
value_settings	ValueSettings 이 전환 액션과 연결된 전환 이벤트의 가치와 관련된 설정입니다.
attribution_model_settings	AttributionModelSettings 이 전환 액션의 기여 분석 모델과 관련된 설정입니다.
floodlight_settings	FloodlightSettings 플러드라이트 전환 유형에 대한 플러드라이트 설정
id	int64 전환 액션의 ID입니다.
name	string 전환 액션의 이름입니다. 이 필드는 필수 항목이며 새 전환 액션을 만들 때 비워 두지 않아야 합니다.
primary_for_goal	bool 전환 액션의 primary_for_goal 비트가 false인 경우 전환 액션은 고객 전환 목표 또는 캠페인 전환 목표와 관계없이 모든 캠페인에서 입찰할 수 없습니다. 하지만 맞춤 전환 목표는 primary_for_goal을 따르지 않으므로 캠페인에 primary_for_goal = false 전환 액션으로 구성된 맞춤 전환 목표가 있는 경우 이 전환 액션은 여전히 입찰이 가능합니다. 설정하지 않으면 기본적으로 primary_for_goal이 true입니다. V9에서 primary_for_goal은 선택사항으로 선언되지 않으므로 'update' 작업을 통해 만든 후에만 false로 설정할 수 있습니다.
owner_customer	string 전환 액션 소유자 고객의 리소스 이름입니다. 시스템 정의 전환 액션인 경우 null입니다.
include_in_client_account_conversions_metric	bool 이 전환 액션이 'client_account_conversions' 측정항목에 포함되어야 하는지를 나타냅니다.
include_in_conversions_metric	bool 이 전환 액션이 '전환수' 측정항목에 포함되어야 하는지 여부입니다.
click_through_lookback_window_days	int64 상호작용 (예: 클릭)과 전환 이벤트 사이에 경과할 수 있는 최대 일수입니다.
app_id	string 앱 전환 액션의 앱 ID

AttributionModelSettings

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

입력란
attribution_model	AttributionModel 이 전환 액션의 기여 분석 모델 유형입니다.
data_driven_model_status	DataDrivenModelStatus 전환 액션에 대한 데이터 기반 기여 분석 모델의 상태입니다.

FloodlightSettings

플러드라이트 전환 액션과 관련된 설정입니다.

입력란
activity_group_tag	string 전환을 보고할 때 플러드라이트 활동 그룹을 식별하는 데 사용되는 문자열입니다.
activity_tag	string 전환을 보고할 때 플러드라이트 활동을 식별하는 데 사용되는 문자열입니다.
activity_id	int64 DoubleClick Campaign Manager(DCM)의 플러드라이트 활동 ID입니다.

ValueSettings

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

입력란
default_value	double 이 전환 액션의 전환 이벤트가 유효하지 않거나, 허용되지 않거나, 누락된 값과 함께 전송되거나, 전환 액션이 항상 기본값을 사용하도록 구성된 경우에 사용할 값입니다.
default_currency_code	string 이 전환 액션의 전환 이벤트가 유효하지 않거나 누락된 통화 코드와 함께 전송되거나 이 전환 액션이 항상 기본값을 사용하도록 구성된 경우에 사용할 통화 코드입니다.
always_use_default_value	bool 이 전환 액션의 전환 이벤트에 지정된 값 및 통화 코드 대신 기본값과 기본 통화 코드를 사용할지 여부를 지정합니다.

ConversionCustomVariable

전환 맞춤 변수입니다. https://support.google.com/sa360/answer/13567857에서 '새 Search Ads 360의 맞춤 플러드라이트 측정항목 및 측정기준 정보'를 참고하세요.

입력란
resource_name	string 전환 맞춤 변수의 리소스 이름입니다. 전환 맞춤 변수 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id	int64 전환 맞춤 변수의 ID입니다.
name	string 필수 항목입니다. 전환 맞춤 변수의 이름입니다. 이름은 고유해야 합니다. 이름의 최대 길이는 100자(영문 기준)입니다. 앞뒤에 공백이 있으면 안 됩니다.
tag	string 필수 항목입니다. 전환 맞춤 변수의 태그입니다. 태그는 고유해야 하며 'u' 문자 바로 뒤에 100 이하의 숫자여야 합니다. 예: 'u4'
status	ConversionCustomVariableStatus 전환 이벤트 누적에 대한 전환 맞춤 변수의 상태입니다.
owner_customer	string 전환 맞춤 변수를 소유한 고객의 리소스 이름입니다.
family	ConversionCustomVariableFamily 전환 맞춤 변수의 그룹입니다.
cardinality	ConversionCustomVariableCardinality 전환 맞춤 변수의 카디널리티입니다.
floodlight_conversion_custom_variable_info	FloodlightConversionCustomVariableInfo Search Ads 360 플러드라이트 전환 맞춤 변수의 필드
custom_column_ids[]	int64 이 전환 맞춤 변수를 사용하는 맞춤 열의 ID입니다.

FloodlightConversionCustomVariableInfo

Search Ads 360 플러드라이트 전환 맞춤 변수에 대한 정보입니다.

입력란
floodlight_variable_type	FloodlightVariableType Search Ads 360에 정의된 플러드라이트 변수 유형입니다.
floodlight_variable_data_type	FloodlightVariableDataType Search Ads 360에 정의된 플러드라이트 변수 데이터 유형입니다.

ConversionTrackingSetting

Search Ads 360 전환 추적과 관련된 고객 전체 설정의 모음입니다.

입력란
accepted_customer_data_terms	bool 고객이 고객 데이터 약관에 동의했는지 여부 교차 계정 전환 추적을 사용하는 경우 이 값은 관리자로부터 상속됩니다. 이 필드는 읽기 전용입니다. 자세한 내용은 다음 페이지를 참조하세요.https://support.google.com/adspolicy/answer/7475709
conversion_tracking_status	ConversionTrackingStatus 전환 추적 상태입니다. 고객이 전환 추적을 사용 중인지와 이 고객의 전환 추적 소유자가 누구인지를 나타냅니다. 이 고객이 교차 계정 전환 추적을 사용하는 경우 요청의 login-customer-id에 따라 반환되는 값이 달라집니다.
enhanced_conversions_for_leads_enabled	bool 고객이 리드 확보용 향상된 전환을 선택했는지 여부 교차 계정 전환 추적을 사용하는 경우 이 값은 관리자로부터 상속됩니다. 이 필드는 읽기 전용입니다.
google_ads_conversion_customer	string 전환이 생성되고 관리되는 고객의 리소스 이름입니다. 이 필드는 읽기 전용입니다.
conversion_tracking_id	int64 이 계정에 사용된 전환 추적 ID입니다. 이 ID는 고객이 전환 추적을 사용하는지 여부를 나타내지 않습니다 (conversion_tracking_status 포함). 이 필드는 읽기 전용입니다.
google_ads_cross_account_conversion_tracking_id	int64 고객 관리자의 전환 추적 ID입니다. 고객이 전환 추적을 선택한 경우 설정되며 conversion_tracking_id를 재정의합니다. 이 필드는 Google Ads UI를 통해서만 관리할 수 있습니다. 이 필드는 읽기 전용입니다.
cross_account_conversion_tracking_id	int64 고객 관리자의 전환 추적 ID입니다. 고객이 교차 계정 전환 추적을 선택한 경우 설정되며 conversion_tracking_id를 재정의합니다.

CustomColumn

맞춤 열. https://support.google.com/sa360/answer/9633916에서 Search Ads 360 맞춤 열을 참고하세요.

입력란
resource_name	string 맞춤 열의 리소스 이름입니다. 맞춤 열 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/customColumns/{custom_column_id}
id	int64 맞춤 열의 ID입니다.
name	string 맞춤 열의 사용자 정의 이름입니다.
description	string 맞춤 열의 사용자가 정의한 설명입니다.
value_type	CustomColumnValueType 맞춤 열의 결과 값 유형입니다.
references_attributes	bool 맞춤 열이 하나 이상의 속성을 참조하는 경우 true입니다.
references_metrics	bool 맞춤 열에서 하나 이상의 측정항목을 참조하는 경우 true입니다.
queryable	bool SearchAds360Service.Search 및 SearchAds360Service.SearchStream의 쿼리에서 맞춤 열을 사용할 수 있는 경우 true입니다.
referenced_system_columns[]	string 이 맞춤 열에서 참조된 시스템 열의 목록입니다. 예를 들어 '노출수와 클릭수의 합계'라는 맞춤 열에 {"metrics.clicks", "metrics.impressions"} 시스템 열이 참조되었습니다.

고객

고객입니다.

입력란
resource_name	string 고객의 리소스 이름입니다. 고객 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}
conversion_tracking_setting	ConversionTrackingSetting 고객에 대한 전환 추적 설정
account_type	AccountType 엔진 계정 유형(예: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track 등)
double_click_campaign_manager_setting	DoubleClickCampaignManagerSetting 관리자 고객의 DoubleClick Campaign Manager (DCM) 설정
account_status	AccountStatus 계정 상태(예: 운영중, 일시중지됨, 삭제됨)
last_modified_time	string 이 고객이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.
engine_id	string 외부 엔진 계정의 계정 ID입니다.
status	CustomerStatus 고객의 상태입니다.
creation_time	string 이 고객이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.
id	int64 고객의 ID입니다.
descriptive_name	string 고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다.
currency_code	string 계정에 사용되는 통화입니다. ISO 4217 표준의 통화 코드 중 일부가 지원됩니다.
time_zone	string 고객의 현지 시간대 ID입니다.
tracking_url_template	string 매개변수를 사용하여 추적 URL을 작성하기 위한 URL 템플릿입니다.
final_url_suffix	string 최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다.
auto_tagging_enabled	bool 고객에 대해 자동 태그 추가가 사용 설정되었는지 여부입니다.
manager	bool 고객이 관리자인지 여부

CustomerAsset

고객과 애셋 간의 연결입니다.

입력란
resource_name	string 고객 애셋의 리소스 이름입니다. CustomerAsset 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/customerAssets/{asset_id}~{field_type}
asset	string 필수 항목입니다. 고객에 연결된 애셋입니다.
status	AssetLinkStatus 고객 확장 소재의 상태입니다.

CustomerAssetSet

CustomerAssetSet은 고객과 애셋 세트 간의 연결입니다. CustomerAssetSet을 추가하면 애셋 세트가 고객과 연결됩니다.

입력란
resource_name	string 고객 애셋 세트의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/customerAssetSets/{asset_set_id}
asset_set	string 고객과 연결된 애셋 세트입니다.
customer	string 이 애셋 세트가 연결된 고객입니다.
status	AssetSetLinkStatus 고객 확장 소재 조합 애셋의 상태입니다. 읽기 전용입니다.

CustomerClient

지정된 고객과 클라이언트 고객 간의 링크입니다. CustomerClient는 관리자 고객에게만 존재합니다. 관리자뿐만 아니라 모든 직접 및 간접 고객 고객이 포함됩니다.

입력란
resource_name	string 고객 클라이언트의 리소스 이름입니다. CustomerClient 리소스 이름의 형식은 customers/{customer_id}/customerClients/{client_customer_id}입니다.
applied_labels[]	string 요청하는 고객이 소유하고 클라이언트 고객에게 적용되는 라벨의 리소스 이름입니다. 라벨 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/labels/{label_id}
status	CustomerStatus 클라이언트 고객의 상태입니다. 읽기 전용입니다.
client_customer	string 특정 고객에 연결된 클라이언트-고객의 리소스 이름입니다. 읽기 전용입니다.
hidden	bool 숨겨진 계정인지 여부를 지정합니다. 읽기 전용입니다.
level	int64 특정 고객과 클라이언트 간의 거리입니다. 자체 링크의 경우 레벨 값은 0이 됩니다. 읽기 전용입니다.
time_zone	string 클라이언트의 시간대를 나타내는 공통 언어 데이터 저장소(CLDR) 문자열 표현입니다(예: America/Los_Angeles). 읽기 전용입니다.
test_account	bool 클라이언트가 테스트 계정인지 식별합니다. 읽기 전용입니다.
manager	bool 클라이언트가 관리자인지 식별합니다. 읽기 전용입니다.
descriptive_name	string 클라이언트를 설명하는 이름입니다. 읽기 전용입니다.
currency_code	string 클라이언트의 통화 코드 (예: 'USD', 'EUR')입니다. 읽기 전용입니다.
id	int64 클라이언트 고객의 ID입니다. 읽기 전용입니다.

CustomerManagerLink

고객-관리자 링크 관계를 나타냅니다.

입력란
resource_name	string 리소스의 이름입니다. CustomerManagerLink 리소스 이름의 형식은 customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}입니다.
status	ManagerLinkStatus 고객과 관리자 간의 연결 상태입니다.
manager_customer	string 고객에 연결된 관리자 고객입니다.
manager_link_id	int64 고객-관리자 링크의 ID입니다. 이 필드는 읽기 전용입니다.

DoubleClickCampaignManagerSetting

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

입력란
advertiser_id	int64 이 고객과 연결된 Campaign Manager 광고주의 ID입니다.
network_id	int64 이 고객과 연결된 Campaign Manager 네트워크의 ID입니다.
time_zone	string 고객과 연결된 Campaign Manager 네트워크의 시간대로 IANA 시간대 데이터베이스 형식(예: America/New_York)입니다.

DynamicSearchAdsSearchTermView

동적 검색 광고 검색어 보기

입력란
resource_name	string 동적 검색 광고 검색어 보기의 리소스 이름입니다. 동적 검색 광고 검색어 보기 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landing_page	string 노출 시 동적으로 선택된 방문 페이지 URL입니다. 이 필드는 읽기 전용입니다.

GenderView

성별 보기 gender_view 리소스는 추가된 기준이 아닌 효과적인 게재 상태를 반영합니다. 성별 기준이 없는 광고그룹은 기본적으로 모든 성별에 게재되므로 모든 성별이 통계와 함께 gender_view에 표시됩니다.

입력란
resource_name	string 성별 뷰의 리소스 이름입니다. 성별 보기 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

지역 타겟 상수입니다.

입력란
resource_name	string 지역 타겟 상수의 리소스 이름입니다. 지역 타겟 상수 리소스 이름의 형식은 다음과 같습니다. geoTargetConstants/{geo_target_constant_id}
status	GeoTargetConstantStatus 지역 타겟팅 상수 상태입니다.
id	int64 지역 타겟 상수의 ID입니다.
name	string 지역 타겟 상수 영어 이름입니다.
country_code	string 타겟과 연결된 ISO-3166-1 alpha-2 국가 코드입니다.
target_type	string 지역 타겟팅 상수 타겟 유형입니다.
canonical_name	string 대상의 이름과 상위 항목 및 국가의 이름으로 구성된 정규화된 영어 이름입니다.
parent_geo_target	string 상위 지역 타겟 상수의 리소스 이름입니다. 지역 타겟 상수 리소스 이름의 형식은 다음과 같습니다. geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

키워드 뷰

입력란
resource_name	string 키워드 뷰의 리소스 이름입니다. 키워드 보기 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

라벨

라벨입니다.

입력란
resource_name	string 리소스의 이름입니다. 라벨 리소스 이름의 형식은 customers/{customer_id}/labels/{label_id}입니다.
status	LabelStatus 라벨의 상태입니다. 읽기 전용입니다.
text_label	TextLabel 색이 있는 배경에 텍스트를 표시하는 라벨 유형입니다.
id	int64 라벨의 ID입니다. 읽기 전용입니다.
name	string 라벨의 이름입니다. 이 입력란은 필수이며 새 라벨을 만들 때 비워 둘 수 없습니다. 이 문자열의 길이는 1에서 80 사이여야 합니다(1 및 80 포함).

LanguageConstant

언어

입력란
resource_name	string 언어 상수의 리소스 이름입니다. 언어 상수 리소스 이름의 형식은 다음과 같습니다. languageConstants/{criterion_id}
id	int64 언어 상수의 ID입니다.
code	string 언어 코드(예: 'en_US', 'en_AU', 'es', 'fr' 등)
name	string 언어의 전체 이름입니다(예: '영어(미국)', '스페인어' 등).
targetable	bool 타겟팅 가능한 언어인지 여부입니다.

ListingGroupFilterDimension

애셋 그룹 등록정보 그룹 필터의 등록정보 측정기준입니다.

입력란
통합 필드 dimension. 아래 유형 중 하나의 측정기준은 항상 존재합니다. dimension은 다음 중 하나여야 합니다.
product_bidding_category	ProductBiddingCategory 제품의 입찰 카테고리입니다.
product_brand	ProductBrand 제품의 브랜드입니다.
product_channel	ProductChannel 제품의 지역입니다.
product_condition	ProductCondition 제품의 상태입니다.
product_custom_attribute	ProductCustomAttribute 제품의 맞춤 속성입니다.
product_item_id	ProductItemId 제품의 상품 ID입니다.
product_type	ProductType 제품의 유형입니다.

ProductBiddingCategory

특정 수준에서 입찰 카테고리의 한 요소입니다. 최상위 카테고리는 레벨 1, 그 하위 카테고리는 레벨 2와 같은 식입니다. 현재 최대 5개의 등급을 지원합니다. 사용자는 카테고리 수준을 나타내는 측정기준 유형을 지정해야 합니다. 동일한 하위 부문의 모든 사례는 동일한 측정기준 유형 (카테고리 수준)을 가져야 합니다.

입력란
level	ListingGroupFilterBiddingCategoryLevel 분류에서 카테고리의 수준을 나타냅니다.
id	int64 제품 입찰 카테고리의 ID입니다. 이 ID는 다음 도움말에 설명된 google_product_category ID와 동일합니다. https://support.google.com/merchants/answer/6324436

ProductBrand

제품의 브랜드입니다.

입력란
value	string 제품 브랜드의 문자열 값입니다.

ProductChannel

제품의 지역입니다.

입력란
channel	ListingGroupFilterProductChannel 지역의 값입니다.

ProductCondition

제품의 상태입니다.

입력란
condition	ListingGroupFilterProductCondition 조건의 값입니다.

ProductCustomAttribute

제품의 맞춤 속성입니다.

입력란
index	ListingGroupFilterCustomAttributeIndex 맞춤 속성의 색인을 나타냅니다.
value	string 제품 맞춤 속성의 문자열 값입니다.

ProductItemId

제품의 상품 ID입니다.

입력란
value	string ID의 값입니다.

ProductType

제품의 유형입니다.

입력란
level	ListingGroupFilterProductTypeLevel 유형의 수준입니다.
value	string 유형의 값입니다.

ListingGroupFilterDimensionPath

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

입력란
dimensions[]	ListingGroupFilterDimension 등록정보 그룹 필터 계층 구조 (루트 노드 제외)를 거쳐 이 등록정보 그룹 필터로 이어지는 측정기준의 전체 경로입니다.

LocationView

위치 보기에는 위치 기준별로 캠페인 실적이 요약되어 있습니다.

입력란
resource_name	string 위치 뷰의 리소스 이름입니다. 위치 뷰 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

제품 입찰 카테고리.

입력란
resource_name	string 제품 입찰 카테고리의 리소스 이름입니다. 제품 입찰 카테고리 리소스 이름의 형식은 다음과 같습니다. productBiddingCategoryConstants/{country_code}~{level}~{id}
level	ProductBiddingCategoryLevel 제품 입찰 카테고리의 수준입니다.
status	ProductBiddingCategoryStatus 제품 입찰 카테고리의 상태입니다.
id	int64 제품 입찰 카테고리의 ID입니다. 이 ID는 이 도움말(https://support.google.com/merchants/answer/6324436)에 설명된 google_product_category ID와 동일합니다.
country_code	string 제품 입찰 카테고리의 2자리 대문자 국가 코드입니다.
product_bidding_category_constant_parent	string 상위 제품 입찰 카테고리의 리소스 이름입니다.
language_code	string 제품 입찰 카테고리의 언어 코드입니다.
localized_name	string language_code에 따라 현지화된 제품 입찰 카테고리의 표시 값입니다.

ProductGroupView

제품 그룹 보기

입력란
resource_name	string 제품 그룹 뷰의 리소스 이름입니다. 제품 그룹 보기 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

SearchAds360Service에서 사용하는 필드 또는 리소스 (아티팩트)입니다.

입력란
resource_name	string 아티팩트의 리소스 이름입니다. 아티팩트 리소스 이름의 형식은 다음과 같습니다. SearchAds360Fields/{name}
category	SearchAds360FieldCategory 아티팩트의 카테고리입니다.
selectable_with[]	string 설명된 아티팩트로 선택 가능한 모든 리소스, 세그먼트, 측정항목의 이름입니다.
attribute_resources[]	string 설명된 아티팩트로 선택 가능한 모든 리소스의 이름입니다. 이 리소스의 필드는 검색어에 포함될 때 측정항목을 분류하지 않습니다. 이 필드는 카테고리가 RESOURCE인 아티팩트에만 설정됩니다.
metrics[]	string 이 필드에는 FROM 절에서 사용될 때 설명된 아티팩트로 선택 가능한 모든 측정항목의 이름이 나열됩니다. 카테고리가 RESOURCE인 아티팩트에만 설정됩니다.
segments[]	string 이 필드에는 세그먼트든 다른 리소스든, 검색어에 포함된 세그먼트 측정항목의 모든 아티팩트의 이름과 설명된 아티팩트가 FROM 절에 사용된 경우의 이름이 나열됩니다. 카테고리가 RESOURCE인 아티팩트에만 설정됩니다.
enum_values[]	string ENUM 유형의 필드인 경우 아티팩트가 가정할 수 있는 값입니다. 이 필드는 segment 또는 ATTRIBUTE 카테고리의 아티팩트에만 설정됩니다.
data_type	SearchAds360FieldDataType 이 필드는 WHERE 절의 아티팩트와 함께 사용할 수 있는 연산자를 결정합니다.
name	string 아티팩트의 이름입니다.
selectable	bool 검색어의 SELECT 절에 아티팩트를 사용할 수 있는지 여부입니다.
filterable	bool 검색어의 WHERE 절에서 아티팩트를 사용할 수 있는지 여부입니다.
sortable	bool 검색어의 ORDER BY 절에 아티팩트를 사용할 수 있는지 여부입니다.
type_url	string 아티팩트의 데이터 유형을 설명하는 proto의 URL입니다.
is_repeated	bool 필드 아티팩트가 반복되는지 여부입니다.

ShoppingPerformanceView

쇼핑 실적 보기 여러 제품 측정기준 수준에서 집계된 쇼핑 캠페인 통계를 제공합니다. 브랜드, 카테고리, 맞춤 속성, 제품 상태, 제품 유형 등 판매자 센터의 제품 측정기준 값에는 해당 이벤트가 기록된 날짜 및 시간을 기준으로 각 측정기준의 상태가 반영됩니다.

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

UserList

사용자 목록. 고객이 타겟팅할 수 있는 사용자의 목록입니다.

입력란
resource_name	string 사용자 목록의 리소스 이름입니다. 사용자 목록 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/userLists/{user_list_id}
type	UserListType 이 목록의 유형입니다. 이 필드는 읽기 전용입니다.
id	int64 사용자 목록의 ID입니다.
name	string 이 사용자 목록의 이름입니다. access_reason에 따라 사용자 목록 이름이 고유하지 않을 수 있습니다 (예: access_reason=SHARED인 경우).

이동

방문

입력란
resource_name	string 방문의 리소스 이름입니다. 방문 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}
id	int64 방문의 ID입니다.
criterion_id	int64 Search Ads 360 키워드 ID입니다. 값이 0인 경우 키워드가 기여한 상태가 아님을 나타냅니다.
merchant_id	int64 클릭된 제품이 포함된 Search Ads 360 인벤토리 계정 ID입니다. Search Ads 360에서 인벤토리 계정을 연결할 때 Search Ads 360에서 이 ID를 생성합니다.
ad_id	int64 광고 ID 값이 0이면 광고가 표시되지 않음을 나타냅니다.
click_id	string 방문 페이지에 클릭 ID URL 매개변수로 전달되는 각 방문에 대한 고유한 문자열입니다.
visit_date_time	string 방문 이벤트의 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.
product_id	string 클릭된 제품의 ID입니다.
product_channel	ProductChannel 클릭이 발생한 제품의 판매 채널: 온라인 또는 오프라인
product_language_code	string 제품에 대한 데이터가 포함된 판매자 센터 피드에 설정된 언어(ISO-639-1)입니다.
product_store_id	string 클릭된 오프라인 판매점 인벤토리 광고의 매장입니다. 이 ID는 오프라인 제품 피드에 사용된 매장 ID와 일치해야 합니다.
product_country_code	string 클릭한 제품이 포함된 인벤토리 피드에 등록된 국가(ISO-3166 형식)입니다.
asset_id	int64 방문 이벤트 중에 상호작용한 애셋의 ID입니다.
asset_field_type	AssetFieldType 방문 이벤트의 애셋 필드 유형입니다.

WebpageView

웹페이지 뷰입니다.

입력란
resource_name	string 웹페이지 뷰의 리소스 이름입니다. 웹페이지 보기 리소스 이름의 형식은 다음과 같습니다. customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}