v16.1.0 (2024-04-24)
다음 기능과 변경사항이 v16.1에 추가되었습니다.
계정 관리
CustomerNegativeCriterion.ip_block
: 고객 수준에서 IP를 제외 기준으로 추가할 수 있습니다.- 새 enum 값:
ProductLinkError.LINK_EXISTS
. - 새 enum 값:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
애셋
ad_group_ad_asset_view
및asset_field_type_view
의 디맨드젠 캠페인과 관련된 애셋을 지원합니다.- 새 enum 값:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
대상
- 새 열거형 값:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
. 고객이 보유할 수 있는 유사 사용자 목록 수를 1,000개로 제한합니다.
캠페인
campaign_simulation
보고서를 사용하여 앱 캠페인의 타겟 ROAS 캠페인 입찰가 시뮬레이션을 반환할 수 있습니다.- 새 enum 값:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
. - 새 enum 값:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
. - 새 enum 값:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
.
전환수
SkAdNetworkConversionValueSchema.postback_mappings
: SKAdNetwork 4.0 기능을 지원합니다.CustomerSkAdNetworkConversionValueSchemaService
경고 지원을MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
로 추가했습니다.true
로 설정하면 작업 실패와 관련된 비차단 오류가MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
로 반환됩니다.CustomerSkAdNetworkConversionValueSchemaError
의 새 enum 값:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
기준
BrandInfo
의 새 필드:display_name
primary_url
rejection_reason
status
- 새 enum:
BrandRequestRejectionReason
. - 새 enum 값:
CriterionType.LIFE_EVENT
.
실험
현지 서비스
local_services_lead.credit_details.credit_state
및local_services_lead.credit_details.credit_state_last_update_date_time
는 각각 크레딧 상태가 업데이트된 시점의 크레딧 상태와 타임스탬프를 반환합니다.local_services_lead_conversation.message_details.attachment_urls
: 첨부파일의 콘텐츠를 다운로드하는 데 사용할 수 있는 URL을 반환합니다.
동영상
customer.video_brand_safety_suitability
및BrandSafetySuitability
: 고객 수준에서 동영상 브랜드 안전성 적합성 검색을 지원합니다.- 새 enum 값:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
v16 (2024년 2월 21일)
다음 기능과 변경사항이 v16에 추가되었습니다.
계정 관리
advertising_partner
가AccountLink
에서ProductLink
및ProductLinkInvitation
로 이전되었습니다.AccountLink
에서data_partner
및google_ads
를 삭제했습니다.- 광고주 확인을
관리하는
IdentityVerificationService
를 추가했습니다.StartIdentityVerification()
는 제공된verification_program
를 통해 인증 세션을 시작하는 데 사용됩니다. 새 인증 세션을 만들고 성공적으로 생성된 인증에 대해 빈 응답을 반환합니다.GetIdentityVerification()
를 사용하여 인증 정보를 가져올 수 있으며 이 경우IdentityVerification
의 여러 객체가 반환됩니다. 각IdentityVerification
에는 다음이 포함됩니다.verification_program
: 본인 인증 프로그램 유형입니다.- 광고주가 인증을 완료해야 하는 기한과 관련된 세부정보가 포함된
identity_verification_requirement
verification_progress
: 다음을 포함하여 인증 세션과 관련된 세부정보가 포함됩니다.program_status
는 이 인증 세션의 현재 상태를 나타냅니다.action_url
는 고객을 URL로 안내하여 인증을 완료할 수 있도록 합니다.invitation_link_expiration_time
은action_url
의 만료일을 나타냅니다.
- 열거형:
- 오류:
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
를 추가했습니다.
애셋
asset_group
변경사항:segments.year
및segments.month
와 같은 시간 관련 세그먼트 지원을 추가했습니다.- 리소스를 세분화하는 대신
campaign
를 기여 분석 리소스로 만들었습니다.
캠페인
- 디맨드젠 캠페인 변경사항:
- 기존 디맨드젠 캠페인에
Campaign.shopping_setting
설정 지원이 추가되었습니다. - 디맨드젠 캠페인의 제품 피드(선택사항)를 사용 중지하는
ShoppingSetting.disable_product_feed
를 추가했습니다. - null이 아닌
Campaign.shopping_setting
가 있는 디맨드젠 캠페인에서 사용할 수 있는Ad.demand_gen_product_ad
및 상응하는DemandGenProductAdInfo
를 추가했습니다.
- 기존 디맨드젠 캠페인에
- 광고 그룹의 게재 여부 또는 게재되지 않는 이유를 보여주는
AdGroup
의 다음 필드에 추가되었습니다.primary_status
primary_status_reasons
- 광고 그룹 광고의 게재 여부 또는 게재되지 않는 이유를 보여주는
AdGroupAd
의 다음 필드에 추가되었습니다.primary_status
primary_status_reasons
AdGroupError
에 다음 값을 추가했습니다.CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
실험
- 실험에서 동기화를 사용 설정해야 하는지 지정하는
Experiment.sync_enabled
를 추가했습니다. 동기화를 사용 설정하면 실험이 진행되는 동안 기존 캠페인의 변경사항이 실험 캠페인에 자동으로 복사됩니다. ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
를 추가했습니다.CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
를 추가했습니다.
호텔 및 여행
- 할 일 광고의
ListingDimensionInfo
에 다음 필드를 추가하여 여행 활동이 제공되는 주 및 도시를 기반으로 등록정보 그룹을 만들 수 있습니다. - 다음 세그먼트에 관한 지원이
travel_activity_performance_view
에 추가되었습니다.
현지 서비스
- 광고주가 비즈니스 등록 인증 절차의 진행 상황을 모니터링할 수 있도록
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
및BusinessRegistrationCheckArtifact
를 추가했습니다. - 광고주가 추가한 직원 정보를 검색할 수 있도록 새 리소스
local_services_employee
를 추가했습니다.
계획
AudienceInsightsAttributeMetadata
에서score
를 삭제했습니다.
권장사항
- 추천 유형 및 광고 채널 유형과 같은 지정된 설정을 기반으로 추천을 반환하는
RecommendationService.GenerateRecommendations()
가 추가되었습니다. 이는 캠페인을 구성할 때 특히 유용합니다 RecommendationMetrics.conversions_value
를 추가했습니다.- 키워드 검색 유형이 설정되지 않은 추천 키워드의
recommended_match_type
가UNKNOWN
대신UNSPECIFIED
로 설정됩니다. - 다음 유형의 추천이 추가되었습니다.
MAXIMIZE_CONVERSION_VALUE_OPT_IN
: 전환 가치 극대화 입찰 전략을 선택하는 것이 좋습니다.IMPROVE_GOOGLE_TAG_COVERAGE
: 더 많은 페이지에 Google 태그를 배포할 것을 권장합니다.PERFORMANCE_MAX_FINAL_URL_OPT_IN
실적 최대화 캠페인에 최종 URL 확장을 사용 설정하는 것이 좋습니다.REFRESH_CUSTOMER_MATCH_LIST
: 지난 90일 동안 업데이트되지 않은 고객 목록을 업데이트할 것을 권장합니다.- 맞춤 잠재고객을 만드는 것이 좋은
CUSTOM_AUDIENCE_OPT_IN
LEAD_FORM_ASSET
: 캠페인 또는 고객 수준에서 리드 양식 확장 소재를 추가하는 것이 좋습니다.IMPROVE_DEMAND_GEN_AD_STRENGTH
- 디맨드젠 캠페인의 광고 효력을 개선하는 것이 좋습니다.
쇼핑
- Comparison Shopping Service Center 계정에 연결된 쇼핑 캠페인에 더 자세한 오류를 제공하기 위해
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
및CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
가 추가되었습니다. AssetGroupListingGroupFilterError
에 다음 값을 추가했습니다.DIMENSION_TYPE_NOT_ALLOWED
DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
FILTER_EXCLUSION_NOT_ALLOWED
LISTING_SOURCE_NOT_ALLOWED
MULTIPLE_LISTING_SOURCES
MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
PAGE_FEED_FILTER_HAS_PARENT
수명 주기 목표
- 이러한 작업 유형이 API의 다른 작업 유형과 일치하도록
update
를CustomerLifecycleGoalOperation
및CampaignLifecycleGoalOperation
에 추가했습니다.
v15 (2023년 10월 18일)
v15에서는 다음과 같은 새로운 기능 및 업데이트가 도입되었습니다.
계정 관리
- 승인되지 않은 계정 활동으로 인해 계정이 정지된 경우
customer.status
및customer_client.status
는 이제SUSPENDED
로 반환됩니다. 이전에는ENABLED
로 반환되었습니다. - Google Ads 계정과 판매자 센터 계정 간의 연결을 추가하고 삭제할 수 있는 지원이 추가되었습니다.
ProductLink.merchant_center
및MerchantCenterIdentifier
를 추가했습니다.LinkedProductType.MERCHANT_CENTER
를 추가했습니다.
- Hotel Center 및 판매자 센터 계정에 사용할 수 있는 다른 제품에서 전송된 링크 초대의 업데이트를 지원하기 위해
ProductLinkInvitationService
및ProductLinkInvitation
를 추가했습니다. MerchantCenterLinkService
을 삭제했습니다.- Google Ads 계정을 판매자 센터 계정과 연결하려면
ProductLinkInvitationService
및ProductLinkService
을 사용합니다.
- Google Ads 계정을 판매자 센터 계정과 연결하려면
AccountLinkService
를 사용하여 Hotel Center 계정에서AccountLink.hotel_center
및 연결 초대를 업데이트하는 지원이 삭제되었습니다.- Hotel Center 계정에서 연결 초대를 업데이트하려면
ProductLinkInvitationService
를 사용하세요.
- Hotel Center 계정에서 연결 초대를 업데이트하려면
애셋
- 애셋을 사용한 이미지 추가 및 삭제를 지원하기 위해
ImageAdInfo.media_file
를ImageAdInfo.image_asset
로 대체했습니다. 따라서 더 이상 필요하지 않은MediaFileService
도 삭제했습니다. - 맞춤 라벨 및 URL 하위 문자열을 기반으로 등록정보 그룹 필터 생성을 지원하기 위해
ListingGroupFilterDimension.webpage
를 추가했습니다.- 또한
AssetGroupListingGroupFilter.vertical
를AssetGroupListingGroupFilter.listing_source
및ListingGroupFilterListingSource
로 대체했습니다.
- 또한
- 애셋 그룹 애셋의 소스를
표시하는
asset_group_asset.source
를 추가했습니다. - 광고그룹 광고 확장 소재의
소스를 표시하는
ad_group_ad_asset_view.source
가 추가되었습니다.
대상
- 고객 일치 타겟팅에서 동의 제공을 지원하기 위해
CustomerMatchUserListMetadata.consent
를 추가했습니다. 2024년 3월 6일부터 EEA 사용자에 대한 동의가 누락되면 동의 값이 동의하지 않은 것으로 간주됩니다. 사용자 동의가 이루어지지 않은 EEA 사용자의 데이터는 처리되지 않으며 고객 일치 타겟팅을 사용한 광고 개인 최적화에 사용될 수 없습니다. 자세한 내용은 고객 일치 타겟팅 가이드를 참조하세요. - 매장 판매의 경우 동의를 제공할 수 있도록
UserData.consent
를 추가했습니다. 자세한 내용은 오프라인 매장 판매 가이드를 참조하세요. 매장 판매에 고객 일치 타겟팅을 사용하는 경우 FAQ에서 자세한 내용을 확인하세요. - 제공된 기존 시드 잠재고객을 기반으로 생성되는 잠재고객인 유사 세그먼트 생성을 지원하기 위해
UserList.lookalike_user_list
를 추가했습니다. 유사 세그먼트는 디맨드젠 캠페인에서만 사용할 수 있습니다.
캠페인
실적 최대화 캠페인 업데이트:
- 이제
AssetGroupSignal
에서 향상된 타겟팅을 위해 애셋 그룹에 연결할 수 있는 두 가지 신호 유형을 지원합니다.AssetGroupSignal.audience
- 잠재고객 사용을 특정 애셋 그룹으로 제한하기 위해
Audience.scope
및Audience.asset_group
를 추가했습니다.Audience.scope
가ASSET_GROUP
인 경우에만Audience.asset_group
를 설정해야 합니다.
- 잠재고객 사용을 특정 애셋 그룹으로 제한하기 위해
AssetGroupSignal.search_theme
- 이 새로운 기준 유형을 지원하는
CriterionType.SEARCH_THEME
를 추가했습니다. 이 새로운 기준 유형은 실적 최대화 캠페인에서AssetGroupSignal.search_theme
에SearchThemeInfo
기준을 입력하여AssetGroupSignal
를 만드는 경우에만 사용할 수 있습니다.
- 이 새로운 기준 유형을 지원하는
- 애셋 그룹
신호를 추가할 때 예외 요청을 지원할 수 있도록
AssetGroupSignalOperation.exempt_policy_violation_keys
를 추가했습니다. - 애셋 그룹 수준에서
실적이 가장 우수한 애셋을 보고하는
새
asset_group_top_combination_view
가 추가되었습니다. - 이제 측정항목 필드로
asset_group
를 쿼리하여 실적 최대화 캠페인의 실적을 검색할 수 있습니다. PerformanceMaxUpgradeStatus
에서UPGRADE_ELIGIBLE
의 이름을UPGRADE_ELIGIBLE
로 바꿨습니다.
- 이제
디맨드젠 캠페인 및 디스커버리 타겟 CPA 캠페인의 경우 캠페인 수준의 타겟 CPA 입찰가 시뮬레이션(
campaign_simulation.target_cpa_point_list.points
)에서 이제TargetCpaSimulationPoint.clicks
대신TargetCpaSimulationPoint.interactions
을 반환합니다.제공된 브랜드 접두사와 제외된 브랜드 목록을 기반으로 브랜드를 추천할 수 있는
BrandSuggestionService
를 추가했습니다. 이러한 브랜드는BRAND
기준을 만들고BRANDS
공유 세트에 추가한 다음brand_list
을 공유 세트로 설정하여CampaignCriterion
를 만들어 캠페인에 연결할 수 있습니다. 캠페인 기준은 검색 캠페인에서 타겟팅하고 실적 최대화 캠페인에서 제외할 수 있습니다.각 애셋 유형의 자동화 상태를 표시하는
Campaign.asset_automation_settings[]
를 추가했습니다.CampaignPrimaryStatusReason
enum에 다음 값을 추가했습니다.NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
전환수
- 동의 제공을 지원하기 위해
CallConversion.consent
및ClickConversion.consent
를 추가했습니다. 자세한 내용은 통화 전환 가이드 및 클릭 전환 가이드를 참고하세요. customer
또는campaign
로 쿼리할 때 사용할 수 있는 SKAdNetwork 변환과 관련된 다음 필드를 추가했습니다.metrics.sk_ad_network_conversions
가metrics.sk_ad_network_installs
로 대체되었습니다.- 오프라인 전환 업로드 진단 지원을 추가했습니다.
offline_conversion_upload_client_summary
가customer
리소스의 필드에서 최상위 보고서로 이동했습니다. 이 보고서를 사용하여 성공 이벤트 수, 성공률, 오류 비율 등 전환 업로드 상태에 대한 유용한 세부정보를 확인할 수 있습니다.- 주의사항: 업로드되었지만
ConversionUploadError.CLICK_NOT_FOUND
오류가 발생한 전환은 계속 성공한 것으로 계산되지만OfflineConversionAlert
로 표시되기도 합니다.
- 주의사항: 업로드되었지만
- 여러 업로드 요청을 논리적으로 단일 개념 작업으로 그룹화할 수 있도록 다음 요청 유형의 선택적 매개변수로
job_id
를 추가했습니다. - 다음 오류에
INVALID_JOB_ID
가 추가되었습니다. - 다음 오류에서
INVALID_CONVERSION_ACTION
가NO_CONVERSION_ACTION_FOUND
및INVALID_CONVERSION_ACTION_TYPE
로 대체되었습니다.
- 리디렉션 없는 Android 개인 정보 보호 샌드박스 교차 네트워크 기여 분석을 지원하는 보고서 3개를 추가했습니다.
android_privacy_shared_key_google_campaign
:shared_campaign_key
및 키 인코딩에 도움이 되는 일부 필드가 포함되어 있습니다.android_privacy_shared_key_google_ad_group
:shared_ad_group_key
및 키 인코딩에 도움이 되는 일부 필드가 포함되어 있습니다.android_privacy_shared_key_google_network_type
:shared_network_type_key
및 키 인코딩에 도움이 되는 일부 필드가 포함되어 있습니다.
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
를 추가했습니다. 지원 중단된 규칙 기반 기여 분석 모델 중 하나를 사용하려고 시도하는ConversionActionOperation
는 이제 이 오류와 함께 실패합니다. 이전에는UNKNOWN
오류와 함께 작업이 실패했습니다.
호텔 및 여행
travel_activity_group_view
및travel_activity_performance_view
의 다음 필드에 관한 지원이 추가되었습니다.- 세그먼트:
- 측정항목:
metrics.search_absolute_top_impression_share
metrics.search_budget_lost_absolute_top_impression_share
metrics.search_budget_lost_impression_share
metrics.search_budget_lost_top_impression_share
metrics.search_impression_share
metrics.search_rank_lost_absolute_top_impression_share
metrics.search_rank_lost_impression_share
metrics.search_rank_lost_top_impression_share
metrics.search_top_impression_share
지역 서비스 광고
- 지역 서비스 광고주의 세분화된 라이선스 및 보험 상태를 반환하기 위해
LocalServicesSettings
및 관련 필드를customer
보고서에 추가했습니다. - 지역 서비스에 관한 다음과 같은 새 보고서가 추가되었습니다.
local_services_lead
에는lead_charged
,lead_type
,lead_status
등 지역 서비스 광고 리드와 관련된 모든 세부정보가 포함되어 있습니다.- 열거형:
local_services_lead_conversation
에는conversation_channel
,call_duration_millis
,call_recording_url
와 같은 메시지 및 전화 대화 세부정보가 포함됩니다.- 전화 통화 녹음 URL은 대상 고객 계정 및 관리자 계정에 대해 인증됩니다.
local_services_verification_artifact
는 백그라운드 확인, 비즈니스 라이선스, 비즈니스 보험 데이터와 같은 지역 서비스 광고주의 아티팩트를 반환합니다. URL을 통해 라이선스 및 보험과 관련된 모든 문서에 액세스할 수 있습니다.
계획
- 적용 가능한 제품 유형의
ReachPlanService.ListPlannableProducts
에 대해Forecast.views
및PlannedProductForecast.views
를 반환하는 지원을 추가했습니다. - 제품에 사용할 수 있는 노출 영역을 설명하는
ReachPlanService.ListPlannableProducts
의PlannableTargeting.surface_targeting
반환 지원이 추가되었습니다. - 새
ReachPlanSurface
enum을 추가했습니다. PlannedProductForecast.average_frequency
를 반환하는AdvancedProductTargeting.target_frequency_settings
를 사용하여 타겟 게재빈도를 타겟팅하기 위한 지원이 추가되었습니다.- 타겟팅 가능한 추천 잠재고객을 반환하는
AudienceInsightsService.GenerateSuggestedTargetingInsights
를 추가했습니다. ReachPlanError
에 다음 값을 추가했습니다.NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
권장사항
- 추천 구독을 관리하는
RecommendationSubscriptionService
를 추가했습니다. - 다음 유형의 추천이 추가되었습니다.
FORECASTING_SET_TARGET_CPA
: 트래픽이 증가할 것으로 예측되는 시즌 이벤트 전에 타겟 CPA를 지정하지 않은 캠페인의 타겟 CPA를 설정하는 것이 좋습니다.SET_TARGET_CPA
이는 캠페인의 타겟 CPA 설정이 지정되지 않은 캠페인에 타겟 CPA를 설정하는 것이 좋습니다.SET_TARGET_ROAS
: 캠페인에 타겟 ROAS가 지정되지 않은 경우 타겟 ROAS를 설정하는 것이 좋습니다.
보고
campaign
(디스플레이, 동영상, 디스커버리 및 앱 캠페인에 사용 가능) 및segments.device
로 쿼리할 수 있는 다음과 같은 새로운 측정항목이 추가되었습니다.
쇼핑
ShoppingSetting.sales_country
가 삭제되었습니다. 이 항목의 값은 이제ShoppingSetting.feed_label
로 반환됩니다.ShoppingSetting.feed_label
필드를 사용하여 캠페인에 특정 판매자 센터 피드를 계속 사용할 수 있습니다. 이전에ShoppingSetting.sales_country
에 사용한 피드 라벨 값 또는 2자리 국가 코드로 설정해야 합니다. 자세한 내용은 피드 라벨 지원 도움말을 참고하세요.
- 보고서에서 국가 코드에 대한 제품 카테고리의 종속 항목을 삭제했습니다.
지원되는 카테고리 ID 집합이 변경되지 않았습니다.
shopping_performance_view
에 사용되는 다음 필드를 대체했습니다.segments.product_bidding_category_level1
(segments.product_category_level1
포함)segments.product_bidding_category_level2
(segments.product_category_level2
포함)segments.product_bidding_category_level3
(segments.product_category_level3
포함)segments.product_bidding_category_level4
(segments.product_category_level4
포함)segments.product_bidding_category_level5
(segments.product_category_level5
포함)
product_bidding_category_constant
를product_category_constant
로 대체하여 카테고리의 사용 가능한 모든 현지화 항목을 반복되는 필드에 반환합니다.ListingDimensionInfo.product_bidding_category
가ListingDimensionInfo.product_category
로 대체되었습니다.ListingGroupFilterDimension.product_bidding_category
가ListingGroupFilterDimension.product_category
로 대체되었습니다.
- 검색 캠페인에
Campaign.shopping_setting
를 추가하는 지원을 삭제했습니다.Campaign.shopping_setting
를 사용하여 검색 캠페인을 만들거나 기존 검색 캠페인에Campaign.shopping_setting
를 추가하려고 하면 이제OPERATION_NOT_PERMITTED_FOR_CONTEXT
가 발생합니다. CampaignCriterion.listing_scope
를 검색 캠페인에 추가하는 지원을 삭제했습니다.CampaignCriterion.listing_scope
를 기존 검색 캠페인에 추가하려고 하면 이제OPERATION_NOT_PERMITTED_FOR_CONTEXT
이 발생합니다.- 다음 장바구니 데이터를 사용한 전환 추적 측정항목을 추가했습니다.
metrics.orders
metrics.average_order_value_micros
metrics.average_cart_size
metrics.cost_of_goods_sold_micros
metrics.gross_profit_micros
metrics.gross_profit_margin
metrics.revenue_micros
metrics.units_sold
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
- 이러한 모든 측정항목은 다음 보고서에서 선택할 수 있습니다.
통합 목표
- 고객 수준에서 고객 획득 목표를 구성하기 위해
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
가 추가되었습니다. - 캠페인 수준에서
고객 획득 목표를 구성할 수 있도록
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
가 추가되었습니다. CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
를 추가했습니다.ConversionGoalCampaignConfigError
에 다음 값을 추가했습니다.EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
동영상
- 캠페인 수준에서 Google TV를 타겟팅하는 기능이 추가되었습니다.
- 캠페인 수준에서 YouTube를 타겟팅하는 기능이 추가되었습니다.
NetworkSettings.target_youtube
추가됨AdNetworkType
에서YOUTUBE_WATCH
및YOUTUBE_SEARCH
를YOUTUBE
로 병합했습니다.CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
를 추가했습니다.
v14.1.0 (2023-08-09)
v14.1에서는 다음과 같은 새로운 기능 및 업데이트가 도입되었습니다.
계정 관리
Customer.customer_agreement_setting
: 고객이 리드 양식 서비스 약관에 동의했는지 표시합니다.
애셋
- 애셋 그룹의 게재 여부 또는 게재되지 않는 이유를 보여주는
AssetGroup
의 새 필드:primary_status
primary_status_reasons
- 애셋 그룹 애셋이 게재되고 있는지
또는 게재되지 않는 이유를 보여주는
AssetGroupAsset
의 새로운 필드primary_status
primary_status_details
primary_status_reasons
CallToActionType
enum의 새 값:BUY_NOW
DONATE_NOW
ORDER_NOW
PLAY_NOW
SEE_MORE
START_NOW
VISIT_SITE
WATCH_NOW
AssetLinkError
enum의 새 값:CUSTOMER_NOT_VERIFIED
UNSUPPORTED_CALL_TO_ACTION
PAGE_FEED_INVALID_LABEL_TEXT
청구
Invoice
및AccountSummary
의 새 필드:export_charge_subtotal_amount_micros
export_charge_tax_amount_micros
export_charge_total_amount_micros
캠페인
CampaignPrimaryStatusReason
enum의 새 값:HAS_ASSET_GROUPS_DISAPPROVED
HAS_ASSET_GROUPS_LIMITED_BY_POLICY
MOST_ASSET_GROUPS_UNDER_REVIEW
(허용된 계정만 해당)
DiscoveryCampaignSettings
및upgraded_targeting
:upgraded_targeting
를true
로 설정하면 위치 및 언어를 광고그룹 기준으로 추가할 수 있습니다.
기준
(허용된 계정만 해당)
LanguageInfo
및LocationInfo
를AdGroupCriterion
로 추가할 수 있습니다.- 이 기능은 업그레이드된 타겟팅이 사용 설정된 디스커버리 캠페인에서만 사용할 수 있습니다.
실험
ExperimentError
enum의 새 값:DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
CANNOT_REMOVE_IN_CREATION_EXPERIMENT
CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES
권장사항
- 새로운 유형의 추천:
PerformanceMaxOptInRecommendation
계정에서 첫 번째 실적 최대화 캠페인을 만드는 것이 좋습니다.ImprovePerformanceMaxAdStrengthRecommendation
: 실적 최대화 캠페인의 애셋 그룹의 강도를 개선하는 것이 좋습니다.MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
이는 동적 검색 광고 캠페인을 실적 최대화 캠페인으로 이전하는 것을 권장합니다.
보고
- 신규 고객과 재구매 고객에 대한 새로운 측정항목 및 세그먼트:
- 새로운
customer_search_term_insight
및campaign_search_term_insight
뷰:metrics.search_volume
는 검색어 통계 카테고리의 볼륨 범위를 보여줍니다.
쇼핑
- 등록정보 그룹의 새로운 필드:
- 새 필드:
ShoppingSetting.advertising_partner_ids
CampaignError
enum의 새 값:NOT_LINKED_ADVERTISING_PARTNER
INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS
동영상
- (허용된 계정만 해당)
AdType.DISCOVERY_VIDEO_RESPONSIVE_AD
및 상응하는DiscoveryVideoResponsiveAdInfo
v14 (2023년 6월 7일)
v14에서는 다음과 같은 새로운 기능 및 업데이트가 도입되었습니다.
캠페인
전환수
Google 애널리틱스 전환을 식별하고 전환을 유니버설 애널리틱스 또는 GA4 속성에서 가져왔는지 확인하기 위한 지원이 추가되었습니다.
ConversionActionType
에 다음 값을 추가했습니다.UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
ConversionAction.google_analytics_4_settings
추가됨
고객의 오프라인 전환 업로드 및 조정 상태 및 진단 정보를 요약하는
Customer.offline_conversion_client_summaries
가 추가되었습니다.- enum
OfflineEventUploadClient
:GOOGLE_ADS_API
GOOGLE_ADS_WEB_CLIENT
ADS_DATA_CONNECTOR
OfflineConversionDiagnosticStatus
:EXCELLENT
GOOD
NEEDS_ATTENTION
NO_RECENT_UPLOAD
- enum
응답을
OfflineConversionUploadSummary.job_id
에 연결하기 위해ConversionAdjustmentUploadService.UploadConversionAdjustments
및ConversionUploadService.UploadClickConversions
에서 반환된 응답에job_id
를 추가했습니다.
기준
계정 수준 제외 키워드의 검색, 생성, 업데이트에 대한 지원이 추가되었습니다.
- 필드:
- 열거형:
CriterionType.NEGATIVE_KEYWORD_LIST
SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ResourceLimitType
SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
- 오류:
CriterionError
NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
호텔 광고
SuggestTravelAssetsRequest.place_id
의 이름이SuggestTravelAssetsRequest.place_ids
로 변경되었습니다.
계획
KeywordPlanService
에서 다음 메서드가 삭제되었습니다.GenerateForecastCurve
GenerateForecastMetrics
GenerateForecastTimeSeries
GenerateHistoricalMetrics
- 먼저 키워드 계획을 만들지 않고도 키워드 캠페인 예측 측정항목을 생성할 수 있도록
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
가 추가되었습니다. campaign_criterion_simulation
보고서 검색 지원을 삭제했습니다.AudienceInsightsService.ListAudienceInsightsAttributes
에 측정기준으로YOUTUBE_DYNAMIC_LINEUP
지원이 추가되었습니다.- 라인업 내 샘플 채널을 제공하기 위해
GenerateAudienceCompositionInsights
응답에 사용되는DynamicLineupAttributeMetadata.sample_channels
가 추가되었습니다.
권장사항
- 계정에 동적 이미지 광고 확장을
사용하도록 권장하는
DynamicImageExtensionOptInRecommendation
가 추가됨 - 타겟 ROAS를 낮추도록 권장하는
LowerTargetRoasRecommendation
가 추가되었습니다. - 타겟 CPA를 높이도록 권장하는
RaiseTargetCpaRecommendation
이(가) 추가됨 ResponsiveSearchAdAssetRecommendation.current_ad
추가됨
보고
ad_group_ad_asset_view.pinned_field
에서 사용할 수 있는ServedAssetFieldType
에 다음 값을 추가했습니다.SITELINK
CALL
MOBILE_APP
CALLOUT
STRUCTURED_SNIPPET
PRICE
PROMOTION
AD_IMAGE
LEAD_FORM
BUSINESS_LOGO
보관처리된 출시 노트
보관처리된 출시 노트는 지원 중단된 버전을 참고하세요.