v17 (2024-06-05)
다음 기능과 변경사항이 v17에 추가되었습니다.
Google Ads
AdService.getAd
을 삭제했습니다. 이렇게 하면AdService
가 Google Ads API의 다른 서비스와 연계됩니다. 광고 및 기타 리소스 유형을 가져오는 데 권장되는 방법은 객체 검색을 참고하세요.- 크기 및 형식과 관련하여
ImageAdInfo.image_asset
에 더 많은 유효성 검사가 추가되었습니다. 이미지가 유효하지 않으면 다음 오류가 발생할 수 있습니다.
애셋
- 새 enum을 추가했습니다.
ClickType.AD_IMAGE
- 실적 최대화 캠페인 및 검색 캠페인에 대한 새 측정항목이 포함된 다음과 같은 새 보고서가 추가되었습니다.
대상
일괄 작업
- 제출된
AddBatchJobOperationsRequest
가 1,048,4504바이트보다 클 때 발생하는BatchJobError.REQUEST_TOO_LARGE
를 추가했습니다. BatchJobService
를 사용할 때MutateOperation.asset_group_operation
설정 지원을 추가했습니다. 이렇게 하면 일괄 처리를 통해 전체 실적 최대화 캠페인을 만들고 관리할 수 있습니다. 새로운 전용 가이드를 참고하세요.
캠페인
- 캠페인, 광고, 애셋과 같은 Google Ads API 전반의 모든 필드, 열거형, 모든 리소스 오류에서 디스커버리가 디맨드젠 캠페인으로 변경되었습니다. 예를 들어
AdvertisingChannelType.DISCOVERY
는 이제AdvertisingChannelType.DEMAND_GEN
입니다. - 캠페인의 모든 키워드에
키워드 검색 유형을 설정할 수 있도록
Campaign.keyword_match_type
를 추가했습니다.
전환수
- SKAdNetwork 전환의 경우
segments.sk_ad_network_conversion_value
에서segments.sk_ad_network_fine_conversion_value
로 이름이 변경되었습니다.segments.sk_ad_network_redistributed_fine_conversion_value
를 추가했습니다.
- 이제 다음 측정항목이 0인 경우에도 응답과 함께 반환됩니다. 이렇게 하면 다른 측정항목과 일관성을 유지할 수 있습니다.
기준
- 광고그룹 기준이 게재되는지 또는 광고가 게재되지 않는 이유를 표시하기 위해 다음 필드를
AdGroupCriterion
에 추가합니다.primary_status
primary_status_reasons
gender_view
의metrics.search_impression_share
지원을 추가했습니다.keyword_view
의metrics.phone_calls
지원을 추가했습니다.
현지 서비스
LocalServicesLead
에 새LocalServicesLeadConversation
를 추가하는 데 사용되는LocalServicesLeadService.AppendLeadConversation()
를 추가했습니다. 이를 통해 리드가 생성된 방식에 따라 SMS와 같은 적절한 채널을 통해 사용자에게 메시지를 전송합니다.AppendLeadConversationRequest.conversations
의 크기는 1,000으로 제한됩니다.lead_type
가LeadType.MESSAGE
로 설정된LocalServicesLead
만Conversation.local_services_lead
에서 지정할 수 있습니다.
ConversationType
에 새 enum 값을 추가했습니다.WHATSAPP
: WhatsApp을 통해 도입된 대화를 나타냅니다.ADS_API
: 새로운LocalServicesLeadService.AppendLeadConversation()
메서드를 사용하여 도입된 대화를 나타냅니다.
local_services_verification_artifact
에 다음과 같은 새 필드가 추가되었습니다.local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
local_services_verification_artifact.license_verification_artifact.expiration_date_time
보고
- 이제
product_link
를 쿼리할 때 하나의 연결된 제품과 관련된 필드만 선택할 수 있습니다. 여러 연결된 제품의 필드를 여러 개 선택하면QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
이 발생합니다. 예를 들어 동일한 쿼리에서product_link.advertising_partner.customer
와product_link.data_partner.data_partner_id
를 선택할 수 없습니다. page_size
를GoogleAdsService.Search
에 전달하면RequestError.PAGE_SIZE_NOT_SUPPORTED
오류가 발생합니다.
쇼핑
- Google Ads UI의 제품 페이지에 해당하는 새 보고서
shopping_product
가 추가되었습니다. Google Ads 계정에 연결된 Google 판매자 센터 계정에서 제품의 현재 상태와 관련된 데이터를 반환하는 기능을 지원합니다.GoogleAdsService.Search
또는GoogleAdsService.SearchStream
를 사용할 때segments.date
를 사용하여shopping_product
보고서의 측정항목을 필터링할 수 있습니다. 날짜별 분류는 허용되지 않으며ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
오류를 반환합니다.
통합 목표
- 잠재고객 고객 유형을 구성하는
UserListCustomerTypeService.MutateUserListCustomerTypes()
를 추가했습니다. CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
을 삭제했습니다. 고객 수명 주기 목표의 잠재고객 설정을 구성하려면 대신UserListCustomerTypeService.MutateUserListCustomerTypes()
를 사용하세요.UserListCustomerType.customer_type_category
를UserListCustomerTypeCategory.PURCHASERS
로 설정하여 사용자 목록을 연결하거나 연결 해제하여 고객 수명 주기 목표에 대한 기존 고객 정의에 포함하거나 제외합니다. 자세한 내용은 잠재고객 분류를 참조하세요.
동영상
- 다음 값을
ContentLabelType
에 추가했습니다. 고객 수준에서 이러한ContentLabelTypes
을 제외할 수 있습니다.BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
BRAND_SUITABILITY_GAMES_FIGHTING
BRAND_SUITABILITY_GAMES_MATURE
BRAND_SUITABILITY_HEALTH_SENSITIVE
BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
BRAND_SUITABILITY_NEWS_RECENT
BRAND_SUITABILITY_NEWS_SENSITIVE
BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
BRAND_SUITABILITY_POLITICS
BRAND_SUITABILITY_RELIGION
DemandGenVideoResponsiveAdInfo
를 생성할 때 동영상 애셋의 인벤토리 환경설정을 지원하는AdVideoAsset.ad_video_asset_info
를 추가했습니다.- (허용된 계정만 해당)
Campaign.video_brand_safety_suitability
를 변경 가능하게 만들었습니다.
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-02-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
의 만료일을 나타냅니다.
- enum:
- 오류:
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
를 추가했습니다.
애셋
asset_group
변경사항:segments.year
및segments.month
와 같은 시간 관련 세그먼트에 관한 지원을 추가했습니다.campaign
를 리소스를 세분화하는 대신 기여 분석 리소스로 만들었습니다.
캠페인
- 디맨드젠 캠페인의 변경사항:
- 기존 디맨드젠 캠페인에
Campaign.shopping_setting
설정에 대한 지원이 추가되었습니다. - 디맨드젠 캠페인의 제품 피드(선택사항)를 사용 중지하는
ShoppingSetting.disable_product_feed
를 추가했습니다. Ad.demand_gen_product_ad
및 이에 상응하는DemandGenProductAdInfo
를 추가했습니다. 이는 null이 아닌Campaign.shopping_setting
를 포함하는 디맨드젠 캠페인에 사용할 수 있습니다.
- 기존 디맨드젠 캠페인에
- 광고그룹의 게재 여부 또는 광고가 게재되지 않는 이유를 표시하기 위해
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의 다른 작업 유형과 일치하도록
CustomerLifecycleGoalOperation
및CampaignLifecycleGoalOperation
에update
를 추가했습니다.
v15 (2023-10-18)
v15에 다음과 같은 새로운 기능과 업데이트가 도입되었습니다.
계정 관리
- 승인되지 않은 계정 활동으로 인해 계정이 정지된 경우
customer.status
및customer_client.status
가 이제SUSPENDED
로 반환됩니다. 이전에는ENABLED
로 반환되었습니다. - Google Ads 계정과 판매자 센터 계정 간의 연결 추가 및 삭제에 대한 지원이 추가되었습니다.
ProductLink.merchant_center
및MerchantCenterIdentifier
를 추가했습니다.LinkedProductType.MERCHANT_CENTER
를 추가했습니다.
- 다른 제품에서 보낸 연결 초대 업데이트를 지원하도록
ProductLinkInvitationService
및ProductLinkInvitation
를 추가했습니다. Hotel Center 및 판매자 센터 계정에서 사용할 수 있습니다. MerchantCenterLinkService
을 삭제했습니다.- Google Ads 계정을 판매자 센터 계정과 연결하려면
ProductLinkInvitationService
및ProductLinkService
를 사용합니다.
- Google Ads 계정을 판매자 센터 계정과 연결하려면
AccountLink.hotel_center
및AccountLinkService
를 사용하여 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.asset_group
는Audience.scope
가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
)가 포함됩니다.- enum:
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를 설정하는 것이 좋습니다.SET_TARGET_ROAS
가 지정되지 않은 캠페인의 경우 타겟 ROAS를 설정하는 것이 좋습니다.
보고
campaign
(디스플레이, 동영상, 디스커버리, 앱 캠페인에 사용 가능) 및segments.device
로 쿼리할 수 있는 다음과 같은 새 측정항목이 추가되었습니다.
쇼핑
- 값이 이제
ShoppingSetting.feed_label
로 반환되는ShoppingSetting.sales_country
를 삭제했습니다.ShoppingSetting.feed_label
필드를 사용하여 캠페인에 특정 판매자 센터 피드를 계속 사용할 수 있습니다. 이전에ShoppingSetting.sales_country
에 사용한 피드 라벨 값 또는 2자리 국가 코드로 설정해야 합니다. 자세한 내용은 피드 라벨 지원 도움말을 참고하세요.
- 보고에서 국가 코드에 대한 제품 카테고리의 종속 항목이 삭제되었습니다.
지원되는 카테고리 ID 집합은 변경되지 않았습니다.
shopping_performance_view
에 사용되는 다음 필드가 대체되었습니다.segments.product_category_level1
로segments.product_bidding_category_level1
segments.product_category_level2
로segments.product_bidding_category_level2
segments.product_category_level3
로segments.product_bidding_category_level3
segments.product_category_level4
로segments.product_bidding_category_level4
segments.product_category_level5
로segments.product_bidding_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
를 추가했습니다.
보관처리된 출시 노트
보관처리된 출시 노트는 종료된 버전을 참고하세요.