Package google.ads.searchads360.v0.resources

색인

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)을 설정하지 않으면 입찰 전략은 예산 내에서 가능한 가장 높은 ROAS를 달성하는 것을 목표로 합니다.

MaximizeConversions

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

필드
target_cpa

int64

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

target_cpa_micros

int64

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

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

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

광고그룹

광고 그룹

필드
resource_name

string

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

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

광고 그룹의 상태입니다.

type

AdGroupType

광고 그룹의 유형입니다.

ad_rotation_mode

AdGroupAdRotationMode

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

creation_time

string

이 ad_group이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "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입니다. 이 입력란은 Search Ads 360 계정(예: Yahoo Japan, Microsoft, Baidu 등)에만 해당합니다. Search Ads 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부터 생성 작업에 필요합니다. 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

통합 콜아웃 확장 소재

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자리 코드).

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

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

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

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 리소스에서 읽습니다. 반면, 제한된 속성은 전략의 소유자 고객과 해당 관리자만 사용할 수 있습니다. 제한된 속성은 입찰전략 리소스에서만 읽을 수 있습니다.

frequency_caps[]

FrequencyCapEntry

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

selective_optimization

SelectiveOptimization

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

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인 실적 최대화 캠페인에만 설정할 수 있습니다.

통합 필드 campaign_bidding_strategy. 캠페인의 입찰 전략입니다.

(BidStrategy 서비스를 통해 생성된 포트폴리오) 또는 캠페인에 삽입된 표준이어야 합니다. 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_search_network

bool

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

target_content_network

bool

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

target_partner_search_network

bool

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

OptimizationGoalSetting

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

필드
optimization_goal_types[]

OptimizationGoalType

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

SelectiveOptimization

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

필드
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

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

ad_id

int64

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

click_id

string

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

visit_id

int64

전환에 기여한 Search Ads 360 방문 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와 일치해야 합니다.

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

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

conversion_revenue_micros

int64

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

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

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

필드
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(Common Locale Data Repository) 문자열 표현입니다(예: America/Los_Angeles). 읽기 전용입니다.

test_account

bool

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

manager

bool

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

descriptive_name

string

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

currency_code

string

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

id

int64

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

DoubleClickCampaignManagerSetting

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

필드
advertiser_id

int64

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

network_id

int64

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

time_zone

string

IANA 시간대 데이터베이스 형식의 이 고객과 연결된 Campaign Manager 네트워크의 시간대입니다(예: 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와 일치해야 합니다.

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}