GoogleAdsRow

クエリから返された行。

JSON 表現
{
  "accountBudget": {
    object (AccountBudget)
  },
  "accountBudgetProposal": {
    object (AccountBudgetProposal)
  },
  "accountLink": {
    object (AccountLink)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdAssetCombinationView": {
    object (AdGroupAdAssetCombinationView)
  },
  "adGroupAdAssetView": {
    object (AdGroupAdAssetView)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionCustomizer": {
    object (AdGroupCriterionCustomizer)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupCriterionSimulation": {
    object (AdGroupCriterionSimulation)
  },
  "adGroupCustomizer": {
    object (AdGroupCustomizer)
  },
  "adGroupExtensionSetting": {
    object (AdGroupExtensionSetting)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "adGroupSimulation": {
    object (AdGroupSimulation)
  },
  "adParameter": {
    object (AdParameter)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "adScheduleView": {
    object (AdScheduleView)
  },
  "domainCategory": {
    object (DomainCategory)
  },
  "asset": {
    object (Asset)
  },
  "assetFieldTypeView": {
    object (AssetFieldTypeView)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupProductGroupView": {
    object (AssetGroupProductGroupView)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetTypeView": {
    object (AssetSetTypeView)
  },
  "batchJob": {
    object (BatchJob)
  },
  "biddingDataExclusion": {
    object (BiddingDataExclusion)
  },
  "biddingSeasonalityAdjustment": {
    object (BiddingSeasonalityAdjustment)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "biddingStrategySimulation": {
    object (BiddingStrategySimulation)
  },
  "billingSetup": {
    object (BillingSetup)
  },
  "callView": {
    object (CallView)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignBidModifier": {
    object (CampaignBidModifier)
  },
  "campaignConversionGoal": {
    object (CampaignConversionGoal)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignCustomizer": {
    object (CampaignCustomizer)
  },
  "campaignDraft": {
    object (CampaignDraft)
  },
  "campaignExtensionSetting": {
    object (CampaignExtensionSetting)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "campaignGroup": {
    object (CampaignGroup)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "campaignLifecycleGoal": {
    object (CampaignLifecycleGoal)
  },
  "campaignSearchTermInsight": {
    object (CampaignSearchTermInsight)
  },
  "campaignSharedSet": {
    object (CampaignSharedSet)
  },
  "campaignSimulation": {
    object (CampaignSimulation)
  },
  "carrierConstant": {
    object (CarrierConstant)
  },
  "changeEvent": {
    object (ChangeEvent)
  },
  "changeStatus": {
    object (ChangeStatus)
  },
  "combinedAudience": {
    object (CombinedAudience)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "conversionGoalCampaignConfig": {
    object (ConversionGoalCampaignConfig)
  },
  "conversionValueRule": {
    object (ConversionValueRule)
  },
  "conversionValueRuleSet": {
    object (ConversionValueRuleSet)
  },
  "clickView": {
    object (ClickView)
  },
  "currencyConstant": {
    object (CurrencyConstant)
  },
  "customAudience": {
    object (CustomAudience)
  },
  "customConversionGoal": {
    object (CustomConversionGoal)
  },
  "customInterest": {
    object (CustomInterest)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerCustomizer": {
    object (CustomerCustomizer)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClientLink": {
    object (CustomerClientLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "customerConversionGoal": {
    object (CustomerConversionGoal)
  },
  "customerExtensionSetting": {
    object (CustomerExtensionSetting)
  },
  "customerFeed": {
    object (CustomerFeed)
  },
  "customerLabel": {
    object (CustomerLabel)
  },
  "customerLifecycleGoal": {
    object (CustomerLifecycleGoal)
  },
  "customerNegativeCriterion": {
    object (CustomerNegativeCriterion)
  },
  "customerSearchTermInsight": {
    object (CustomerSearchTermInsight)
  },
  "customerUserAccess": {
    object (CustomerUserAccess)
  },
  "customerUserAccessInvitation": {
    object (CustomerUserAccessInvitation)
  },
  "customizerAttribute": {
    object (CustomizerAttribute)
  },
  "detailPlacementView": {
    object (DetailPlacementView)
  },
  "detailedDemographic": {
    object (DetailedDemographic)
  },
  "displayKeywordView": {
    object (DisplayKeywordView)
  },
  "distanceView": {
    object (DistanceView)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "expandedLandingPageView": {
    object (ExpandedLandingPageView)
  },
  "extensionFeedItem": {
    object (ExtensionFeedItem)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "feedItemSet": {
    object (FeedItemSet)
  },
  "feedItemSetLink": {
    object (FeedItemSetLink)
  },
  "feedItemTarget": {
    object (FeedItemTarget)
  },
  "feedMapping": {
    object (FeedMapping)
  },
  "feedPlaceholderView": {
    object (FeedPlaceholderView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geographicView": {
    object (GeographicView)
  },
  "groupPlacementView": {
    object (GroupPlacementView)
  },
  "hotelGroupView": {
    object (HotelGroupView)
  },
  "hotelPerformanceView": {
    object (HotelPerformanceView)
  },
  "hotelReconciliation": {
    object (HotelReconciliation)
  },
  "incomeRangeView": {
    object (IncomeRangeView)
  },
  "keywordView": {
    object (KeywordView)
  },
  "keywordPlan": {
    object (KeywordPlan)
  },
  "keywordPlanCampaign": {
    object (KeywordPlanCampaign)
  },
  "keywordPlanCampaignKeyword": {
    object (KeywordPlanCampaignKeyword)
  },
  "keywordPlanAdGroup": {
    object (KeywordPlanAdGroup)
  },
  "keywordPlanAdGroupKeyword": {
    object (KeywordPlanAdGroupKeyword)
  },
  "keywordThemeConstant": {
    object (KeywordThemeConstant)
  },
  "label": {
    object (Label)
  },
  "landingPageView": {
    object (LandingPageView)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "managedPlacementView": {
    object (ManagedPlacementView)
  },
  "mediaFile": {
    object (MediaFile)
  },
  "localServicesEmployee": {
    object (LocalServicesEmployee)
  },
  "localServicesVerificationArtifact": {
    object (LocalServicesVerificationArtifact)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineConversionUploadClientSummary": {
    object (OfflineConversionUploadClientSummary)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productCategoryConstant": {
    object (ProductCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "productLinkInvitation": {
    object (ProductLinkInvitation)
  },
  "recommendation": {
    object (Recommendation)
  },
  "recommendationSubscription": {
    object (RecommendationSubscription)
  },
  "searchTermView": {
    object (SearchTermView)
  },
  "sharedCriterion": {
    object (SharedCriterion)
  },
  "sharedSet": {
    object (SharedSet)
  },
  "smartCampaignSetting": {
    object (SmartCampaignSetting)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "smartCampaignSearchTermView": {
    object (SmartCampaignSearchTermView)
  },
  "thirdPartyAppAnalyticsLink": {
    object (ThirdPartyAppAnalyticsLink)
  },
  "topicView": {
    object (TopicView)
  },
  "travelActivityGroupView": {
    object (TravelActivityGroupView)
  },
  "travelActivityPerformanceView": {
    object (TravelActivityPerformanceView)
  },
  "experiment": {
    object (Experiment)
  },
  "experimentArm": {
    object (ExperimentArm)
  },
  "userInterest": {
    object (UserInterest)
  },
  "lifeEvent": {
    object (LifeEvent)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "remarketingAction": {
    object (RemarketingAction)
  },
  "topicConstant": {
    object (TopicConstant)
  },
  "video": {
    object (Video)
  },
  "webpageView": {
    object (WebpageView)
  },
  "leadFormSubmissionData": {
    object (LeadFormSubmissionData)
  },
  "localServicesLead": {
    object (LocalServicesLead)
  },
  "localServicesLeadConversation": {
    object (LocalServicesLeadConversation)
  },
  "androidPrivacySharedKeyGoogleAdGroup": {
    object (AndroidPrivacySharedKeyGoogleAdGroup)
  },
  "androidPrivacySharedKeyGoogleCampaign": {
    object (AndroidPrivacySharedKeyGoogleCampaign)
  },
  "androidPrivacySharedKeyGoogleNetworkType": {
    object (AndroidPrivacySharedKeyGoogleNetworkType)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  }
}
フィールド
accountBudget

object (AccountBudget)

クエリ内のアカウントの予算。

accountBudgetProposal

object (AccountBudgetProposal)

クエリで参照されているアカウント予算の提案。

adGroup

object (AdGroup)

クエリで参照される広告グループ。

adGroupAd

object (AdGroupAd)

クエリで参照される広告。

adGroupAdAssetCombinationView

object (AdGroupAdAssetCombinationView)

クエリ内の広告グループの広告アセットの組み合わせのビュー。

adGroupAdAssetView

object (AdGroupAdAssetView)

クエリ内の広告グループの広告アセットビュー。

adGroupAdLabel

object (AdGroupAdLabel)

クエリで参照される広告グループの広告のラベル。

adGroupAsset

object (AdGroupAsset)

クエリで参照される広告グループ アセット。

adGroupAssetSet

object (AdGroupAssetSet)

クエリで参照される広告グループのアセットセット。

adGroupAudienceView

object (AdGroupAudienceView)

クエリで参照されている広告グループのオーディエンス ビュー。

adGroupBidModifier

object (AdGroupBidModifier)

クエリで参照される入札単価調整。

adGroupCriterion

object (AdGroupCriterion)

クエリで参照される条件。

adGroupCriterionCustomizer

object (AdGroupCriterionCustomizer)

クエリで参照される広告グループの条件カスタマイザ。

adGroupCriterionLabel

object (AdGroupCriterionLabel)

クエリで参照される広告グループの条件ラベル。

adGroupCriterionSimulation

object (AdGroupCriterionSimulation)

クエリで参照される広告グループの条件のシミュレーション。

adGroupCustomizer

object (AdGroupCustomizer)

クエリで参照される広告グループ カスタマイザ。

adGroupExtensionSetting

object (AdGroupExtensionSetting)

クエリで参照されている広告グループの広告表示オプションの設定。

adGroupFeed

object (AdGroupFeed)

クエリで参照される広告グループ フィード。

adGroupLabel

object (AdGroupLabel)

クエリで参照される広告グループのラベル。

adGroupSimulation

object (AdGroupSimulation)

クエリで参照されている広告グループのシミュレーション。

adParameter

object (AdParameter)

クエリで参照される広告パラメータ。

ageRangeView

object (AgeRangeView)

クエリで参照される年齢層ビュー。

adScheduleView

object (AdScheduleView)

クエリで参照される広告のスケジュール ビュー。

domainCategory

object (DomainCategory)

クエリで参照されるドメイン カテゴリ。

asset

object (Asset)

クエリで参照されるアセット。

assetFieldTypeView

object (AssetFieldTypeView)

クエリで参照されるアセット フィールド タイプ ビュー。

assetGroupAsset

object (AssetGroupAsset)

クエリで参照されるアセット グループのアセット。

assetGroupSignal

object (AssetGroupSignal)

クエリで参照されるアセット グループ シグナル。

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

クエリで参照されているアセット グループのリスティング グループのフィルタ。

assetGroupProductGroupView

object (AssetGroupProductGroupView)

クエリで参照されるアセット グループの商品グループビュー。

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

クエリで参照されているアセット グループの上位の組み合わせビュー。

assetGroup

object (AssetGroup)

クエリで参照されるアセット グループ。

assetSetAsset

object (AssetSetAsset)

クエリで参照されるアセットセットのアセット。

assetSet

object (AssetSet)

クエリで参照されるアセットセット。

assetSetTypeView

object (AssetSetTypeView)

クエリで参照されるアセットセット タイプのビュー。

batchJob

object (BatchJob)

クエリで参照されるバッチジョブ。

biddingDataExclusion

object (BiddingDataExclusion)

クエリで参照されている入札データの除外。

biddingSeasonalityAdjustment

object (BiddingSeasonalityAdjustment)

クエリで参照されている入札の季節性の調整。

biddingStrategy

object (BiddingStrategy)

クエリで参照される入札戦略。

biddingStrategySimulation

object (BiddingStrategySimulation)

クエリで参照されている入札戦略シミュレーション。

billingSetup

object (BillingSetup)

クエリで参照される課金システムの設定。

callView

object (CallView)

クエリで参照される通話ビュー。

campaignBudget

object (CampaignBudget)

クエリで参照されるキャンペーンの予算。

campaign

object (Campaign)

クエリで参照されているキャンペーン。

campaignAsset

object (CampaignAsset)

クエリで参照されるキャンペーン アセット。

campaignAssetSet

object (CampaignAssetSet)

クエリで参照されるキャンペーン アセットセット。

campaignAudienceView

object (CampaignAudienceView)

クエリで参照されるキャンペーンのオーディエンス ビュー。

campaignBidModifier

object (CampaignBidModifier)

クエリで参照されているキャンペーン入札単価調整比。

campaignConversionGoal

object (CampaignConversionGoal)

クエリで参照される CampaignConversionGoal。

campaignCriterion

object (CampaignCriterion)

クエリで参照されるキャンペーンの条件。

campaignCustomizer

object (CampaignCustomizer)

クエリで参照されるキャンペーン カスタマイザ。

campaignDraft

object (CampaignDraft)

クエリで参照されているキャンペーンの下書き。

campaignExtensionSetting

object (CampaignExtensionSetting)

クエリで参照されているキャンペーン単位の広告表示オプション設定。

campaignFeed

object (CampaignFeed)

クエリで参照されるキャンペーン フィード。

campaignGroup

object (CampaignGroup)

AWQL クエリで参照されるキャンペーン グループ。

campaignLabel

object (CampaignLabel)

クエリで参照されるキャンペーンのラベル。

campaignLifecycleGoal

object (CampaignLifecycleGoal)

クエリで参照されるキャンペーン ライフサイクルの目標。

campaignSearchTermInsight

object (CampaignSearchTermInsight)

クエリで参照されているキャンペーンの検索語句に関する分析情報。

campaignSharedSet

object (CampaignSharedSet)

AWQL クエリで参照されるキャンペーン共有設定。

campaignSimulation

object (CampaignSimulation)

クエリで参照されるキャンペーン シミュレーション。

carrierConstant

object (CarrierConstant)

クエリで参照される携帯通信会社定数。

changeEvent

object (ChangeEvent)

クエリで参照される ChangeEvent。

changeStatus

object (ChangeStatus)

クエリで参照される ChangeStatus。

combinedAudience

object (CombinedAudience)

クエリで参照される CombinedAudience。

audience

object (Audience)

クエリで参照されるオーディエンス。

conversionAction

object (ConversionAction)

クエリで参照されるコンバージョン アクション。

conversionCustomVariable

object (ConversionCustomVariable)

クエリで参照されるコンバージョン カスタム変数。

conversionGoalCampaignConfig

object (ConversionGoalCampaignConfig)

クエリで参照される ConversionGoalCampaignConfig。

conversionValueRule

object (ConversionValueRule)

クエリで参照されるコンバージョン値のルール。

conversionValueRuleSet

object (ConversionValueRuleSet)

クエリで参照されているコンバージョン値のルールセット。

clickView

object (ClickView)

クエリで参照される ClickView。

currencyConstant

object (CurrencyConstant)

クエリで参照される通貨定数。

customAudience

object (CustomAudience)

クエリで参照される CustomAudience。

customConversionGoal

object (CustomConversionGoal)

クエリで参照される CustomConversionGoal。

customInterest

object (CustomInterest)

クエリで参照されるカスタム インタレスト。

customer

object (Customer)

クエリで参照されている顧客。

customerAsset

object (CustomerAsset)

クエリで参照されているお客様のアセット。

customerAssetSet

object (CustomerAssetSet)

クエリで参照されるお客様のアセットセット。

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

クエリで参照されているアクセス可能な入札戦略。

customerCustomizer

object (CustomerCustomizer)

クエリで参照されるカスタマー カスタマイザ。

customerClient

object (CustomerClient)

クエリで参照される CustomerClient。

customerConversionGoal

object (CustomerConversionGoal)

クエリで参照される CustomerConversionGoal。

customerExtensionSetting

object (CustomerExtensionSetting)

クエリで参照されている顧客の広告表示オプション設定。

customerFeed

object (CustomerFeed)

クエリで参照される顧客フィード。

customerLabel

object (CustomerLabel)

クエリで参照されるカスタマーラベル。

customerLifecycleGoal

object (CustomerLifecycleGoal)

クエリで参照されている顧客ライフサイクルの目標。

customerNegativeCriterion

object (CustomerNegativeCriterion)

クエリで参照される顧客の除外条件。

customerSearchTermInsight

object (CustomerSearchTermInsight)

クエリで参照される顧客の検索語句に関する分析情報。

customerUserAccess

object (CustomerUserAccess)

クエリで参照される CustomerUserAccess。

customerUserAccessInvitation

object (CustomerUserAccessInvitation)

クエリで参照される CustomerUserAccessInvitation。

customizerAttribute

object (CustomizerAttribute)

クエリで参照されるカスタマイザ属性。

detailPlacementView

object (DetailPlacementView)

クエリで参照される詳細プレースメント ビュー。

detailedDemographic

object (DetailedDemographic)

クエリで参照される詳細なユーザー属性。

displayKeywordView

object (DisplayKeywordView)

クエリで参照されるディスプレイ ネットワークのキーワードのビュー。

distanceView

object (DistanceView)

クエリで参照される距離ビュー。

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

クエリで参照されている動的検索広告の検索語句ビュー。

expandedLandingPageView

object (ExpandedLandingPageView)

クエリで参照される展開後のランディング ページ ビュー。

extensionFeedItem

object (ExtensionFeedItem)

クエリで参照されている広告表示オプションのフィード アイテム。

feed

object (Feed)

クエリで参照されるフィード。

feedItem

object (FeedItem)

クエリで参照されるフィード アイテム。

feedItemSet

object (FeedItemSet)

クエリで参照されているフィード アイテムセット。

feedItemTarget

object (FeedItemTarget)

クエリで参照されているフィード アイテム ターゲット。

feedMapping

object (FeedMapping)

クエリで参照されるフィード マッピング。

feedPlaceholderView

object (FeedPlaceholderView)

クエリで参照されるフィード プレースホルダ ビュー。

genderView

object (GenderView)

クエリで参照される性別ビュー。

geoTargetConstant

object (GeoTargetConstant)

クエリで参照される地域ターゲティング定数。

geographicView

object (GeographicView)

クエリで参照される地理ビュー。

groupPlacementView

object (GroupPlacementView)

クエリで参照されるグループ プレースメント ビュー。

hotelGroupView

object (HotelGroupView)

クエリで参照されるホテルグループ ビュー。

hotelPerformanceView

object (HotelPerformanceView)

クエリで参照されるホテルのパフォーマンス ビュー。

hotelReconciliation

object (HotelReconciliation)

クエリで参照されるホテルの調整。

incomeRangeView

object (IncomeRangeView)

クエリで参照される収入の範囲ビュー。

keywordView

object (KeywordView)

クエリで参照されるキーワード ビュー。

keywordPlan

object (KeywordPlan)

クエリで参照されるキーワード プラン。

keywordPlanCampaign

object (KeywordPlanCampaign)

クエリで参照されているキーワード プランのキャンペーン。

keywordPlanCampaignKeyword

object (KeywordPlanCampaignKeyword)

クエリで参照されるキーワード プランのキャンペーンのキーワード。

keywordPlanAdGroup

object (KeywordPlanAdGroup)

クエリで参照されるキーワード プランの広告グループ。

keywordPlanAdGroupKeyword

object (KeywordPlanAdGroupKeyword)

クエリで参照されているキーワード プランの広告グループ。

keywordThemeConstant

object (KeywordThemeConstant)

クエリで参照されるキーワード テーマ定数。

label

object (Label)

クエリで参照されるラベル。

landingPageView

object (LandingPageView)

クエリで参照されるランディング ページビュー。

languageConstant

object (LanguageConstant)

クエリで参照される言語定数。

locationView

object (LocationView)

クエリで参照されるロケーション ビュー。

managedPlacementView

object (ManagedPlacementView)

クエリで参照される手動プレースメント ビュー。

mediaFile

object (MediaFile)

クエリで参照されるメディア ファイル。

localServicesEmployee

object (LocalServicesEmployee)

クエリで参照されるローカル サービスの従業員。

localServicesVerificationArtifact

object (LocalServicesVerificationArtifact)

クエリで参照されるローカル サービスの検証アーティファクト。

mobileAppCategoryConstant

object (MobileAppCategoryConstant)

クエリで参照されるモバイルアプリ カテゴリの定数。

mobileDeviceConstant

object (MobileDeviceConstant)

クエリで参照されるモバイル デバイス定数。

offlineConversionUploadClientSummary

object (OfflineConversionUploadClientSummary)

顧客単位のオフライン コンバージョン アップロードの概要。

offlineUserDataJob

object (OfflineUserDataJob)

クエリで参照されるオフライン ユーザーデータ ジョブ。

operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

クエリで参照されるオペレーティング システムのバージョン定数。

paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

クエリで参照されている有料検索語句とオーガニック検索語句のビュー。

qualifyingQuestion

object (QualifyingQuestion)

クエリで参照される適格性評価の質問。

parentalStatusView

object (ParentalStatusView)

クエリで参照される子供の有無に関する設定ビュー。

perStoreView

object (PerStoreView)

クエリで参照される店舗別のビュー。

productCategoryConstant

object (ProductCategoryConstant)

クエリで参照される商品カテゴリ。

productGroupView

object (ProductGroupView)

クエリで参照される商品グループビュー。

recommendation

object (Recommendation)

クエリで参照される推奨事項。

recommendationSubscription

object (RecommendationSubscription)

クエリで参照される推奨事項サブスクリプション。

searchTermView

object (SearchTermView)

クエリで参照されている検索語句ビュー。

sharedCriterion

object (SharedCriterion)

クエリで参照される共有セット。

sharedSet

object (SharedSet)

クエリで参照される共有セット。

smartCampaignSetting

object (SmartCampaignSetting)

クエリで参照されているスマート アシスト キャンペーンの設定。

shoppingPerformanceView

object (ShoppingPerformanceView)

クエリで参照されるショッピングの掲載結果ビュー。

smartCampaignSearchTermView

object (SmartCampaignSearchTermView)

クエリで参照されるスマート アシスト キャンペーンの検索キーワード ビュー。

topicView

object (TopicView)

クエリで参照されるトピックビュー。

travelActivityGroupView

object (TravelActivityGroupView)

クエリで参照される旅行アクティビティ グループビュー。

travelActivityPerformanceView

object (TravelActivityPerformanceView)

クエリで参照される旅行アクティビティのパフォーマンス ビュー。

experiment

object (Experiment)

クエリで参照されるテスト。

experimentArm

object (ExperimentArm)

クエリで参照されるテスト群。

userInterest

object (UserInterest)

クエリで参照されるユーザーの興味 / 関心。

lifeEvent

object (LifeEvent)

クエリで参照されるライフイベント。

userList

object (UserList)

クエリで参照されるユーザーリスト。

userLocationView

object (UserLocationView)

クエリで参照されるユーザーの所在地ビュー。

remarketingAction

object (RemarketingAction)

クエリで参照されるリマーケティング アクション。

topicConstant

object (TopicConstant)

クエリで参照されるトピック定数。

video

object (Video)

クエリで参照されている動画。

webpageView

object (WebpageView)

クエリで参照されるウェブページ ビュー。

leadFormSubmissionData

object (LeadFormSubmissionData)

クエリで参照されるリードフォームのユーザー送信。

localServicesLead

object (LocalServicesLead)

クエリで参照されるローカル サービスのリード。

localServicesLeadConversation

object (LocalServicesLeadConversation)

クエリで参照されているローカル サービス リーダーの会話。

androidPrivacySharedKeyGoogleAdGroup

object (AndroidPrivacySharedKeyGoogleAdGroup)

クエリで参照される Android プライバシー共有キーの Google 広告グループ。

androidPrivacySharedKeyGoogleCampaign

object (AndroidPrivacySharedKeyGoogleCampaign)

クエリで参照されている Android プライバシー共有キーの Google 広告キャンペーン。

androidPrivacySharedKeyGoogleNetworkType

object (AndroidPrivacySharedKeyGoogleNetworkType)

クエリで参照される Android プライバシー共有キーの Google ネットワーク タイプ。

metrics

object (Metrics)

指標。

segments

object (Segments)

セグメント。

AccountBudget

アカウント単位の予算。予算自体に関する情報のほか、予算に対する最新の承認済み変更と、承認待ちの提案変更も含まれます。承認待ちの提案された変更(ある場合)は、[pendingProposal] に表示されます。予算に関する有効な詳細情報は、「approved_」と「adjusted_」の接頭辞が付いたフィールドと、接頭辞のないフィールドで確認できます。有効な詳細の一部は、ユーザーが最初にリクエストしたものと異なる場合があります(例: 利用限度額)。これらの違いは、[proposed_]、[approved_]、場合によっては [adjusted_] フィールドに表示されます。

このリソースは AccountBudgetProposal を使用して変更されます。直接変更することはできません。予算に設定できる保留中の提案は一度に 1 つのみです。pendingProposal を介して読み取られます。

予算が承認されると、クレジットの調整など、調整の対象となる場合があります。調整を行うと、[承認済み] フィールドと [調整済み] フィールドに違いが生じます。調整を行わないと、これらのフィールドは同じになります。

JSON 表現
{
  "resourceName": string,
  "status": enum (AccountBudgetStatus),
  "totalAdjustmentsMicros": string,
  "amountServedMicros": string,
  "pendingProposal": {
    object (PendingAccountBudgetProposal)
  },
  "id": string,
  "billingSetup": string,
  "name": string,
  "proposedStartDateTime": string,
  "approvedStartDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,

  // Union field proposed_end_time can be only one of the following:
  "proposedEndDateTime": string,
  "proposedEndTimeType": enum (TimeType)
  // End of list of possible types for union field proposed_end_time.

  // Union field approved_end_time can be only one of the following:
  "approvedEndDateTime": string,
  "approvedEndTimeType": enum (TimeType)
  // End of list of possible types for union field approved_end_time.

  // Union field proposed_spending_limit can be only one of the following:
  "proposedSpendingLimitMicros": string,
  "proposedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field proposed_spending_limit.

  // Union field approved_spending_limit can be only one of the following:
  "approvedSpendingLimitMicros": string,
  "approvedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field approved_spending_limit.

  // Union field adjusted_spending_limit can be only one of the following:
  "adjustedSpendingLimitMicros": string,
  "adjustedSpendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field adjusted_spending_limit.
}
フィールド
resourceName

string

出力専用。アカウント単位の予算のリソース名。AccountBudget リソース名の形式は次のとおりです。

customers/{customerId}/accountBudgets/{account_budget_id}

status

enum (AccountBudgetStatus)

出力専用。このアカウント単位の予算のステータス。

totalAdjustmentsMicros

string (int64 format)

出力専用。調整額の合計。

調整の例としては、サービス調整があります。

amountServedMicros

string (int64 format)

出力専用。配信された広告の値(マイクロ単位)。

これには、超過配信費用が含まれます。この場合、クレジットが予算に自動的に適用されることがあります(totalAdjustmentsMicros を参照)。

pendingProposal

object (PendingAccountBudgetProposal)

出力専用。この予算を変更するための保留中の提案(該当する場合)。

id

string (int64 format)

出力専用。アカウント単位の予算の ID。

billingSetup

string

出力専用。このアカウント単位の予算に関連付けられているお支払い情報の設定のリソース名。BillingSetup リソース名の形式は次のとおりです。

customers/{customerId}/billingSetups/{billing_setup_id}

name

string

出力専用。アカウント単位の予算の名前。

proposedStartDateTime

string

出力専用。アカウント単位の予算として提案する開始時間(yyyy-MM-dd HH:mm:ss 形式)です。開始時刻タイプとして NOW が指定された場合は、これがリクエストの時刻です。

approvedStartDateTime

string

出力専用。アカウント単位の予算の承認開始時間(yyyy-MM-dd HH:mm:ss 形式)。

たとえば、提案された開始時間の後に新しい予算が承認された場合、承認された開始時間は承認時刻になります。

purchaseOrderNumber

string

出力専用。注文書番号は、ユーザーが毎月の請求書でこの予算を参照するのに役立つ値です。

notes

string

出力専用。予算に関するメモです。

共用体フィールド proposed_end_time。アカウント単位の予算の提案された終了時間。proposed_end_time は次のいずれかになります。
proposedEndDateTime

string

出力専用。指定された終了時刻(yyyy-MM-dd HH:mm:ss 形式)。

proposedEndTimeType

enum (TimeType)

出力専用。明確に定義されたタイプで示される終了時刻(例: FOREVER)。

共用体フィールド approved_end_time。アカウント単位の予算の承認済みの終了時間。

たとえば、予算の終了時刻が更新され、提案した終了時刻より後にプロポーザルが承認された場合、承認された終了時刻は承認時刻になります。approved_end_time は次のいずれかになります。

approvedEndDateTime

string

出力専用。承認済みの終了時間(yyyy-MM-dd HH:mm:ss 形式)です。

approvedEndTimeType

enum (TimeType)

出力専用。明確に定義されたタイプ(例: FOREVER)として承認された終了時間。

共用体フィールド proposed_spending_limit。提案された費用上限。proposed_spending_limit は次のいずれかになります。
proposedSpendingLimitMicros

string (int64 format)

出力専用。提案された費用上限(マイクロ秒単位)。100 万が 1 単位に相当します。

proposedSpendingLimitType

enum (SpendingLimitType)

出力専用。明確に定義されたタイプとして提案された費用上限(例: INFINITE)。

共用体フィールド approved_spending_limit。承認された費用上限。

たとえば、提案が承認された時点で、そのアカウントの費用が提案された費用の上限を超えた場合、承認された費用の上限は費用がすでに設定された金額に設定されます。approved_spending_limit は次のいずれかになります。

approvedSpendingLimitMicros

string (int64 format)

出力専用。承認された費用上限(マイクロ単位)。100 万が 1 単位に相当します。これは、提案された費用上限が有限である場合にのみ入力され、常に提案された費用上限以上になります。

approvedSpendingLimitType

enum (SpendingLimitType)

出力専用。明確に定義されたタイプ(INFINITE など)の承認済み費用の上限。これは、承認された費用上限が INFINITE の場合にのみ入力されます。

共用体フィールド adjusted_spending_limit。調整適用後の費用上限。調整は total_adjustments_micros に格納されます。

この値により、アカウントに支出できる最終的な金額が決まります。adjusted_spending_limit は次のいずれかになります。

adjustedSpendingLimitMicros

string (int64 format)

出力専用。調整された費用上限(マイクロ秒単位)。100 万が 1 単位に相当します。

承認された費用の上限が有限の場合、調整された費用の上限は、この予算に適用された調整の種類によって異なる場合があります(該当する場合)。

各種の調整について詳しくは、https://support.google.com/google-ads/answer/1704323 をご覧ください。

たとえば、引き落とし調整により、アカウントで使用できる費用が減額されます。

adjustedSpendingLimitType

enum (SpendingLimitType)

出力専用。調整された費用上限を明確に定義されたタイプ(例: INFINITE)。これは、調整された費用上限が INFINITE の場合にのみ入力されます。これは、承認された費用上限が INFINITE の場合に true であることが保証されます。

AccountBudgetStatus

AccountBudget のステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
PENDING アカウントの予算は承認待ちです。
APPROVED アカウントの予算が承認されました。
CANCELLED アカウントの予算がユーザーによってキャンセルされました。

PendingAccountBudgetProposal

含まれるアカウント単位の予算に関連付けられている保留中のプロポーザル(該当する場合)。

JSON 表現
{
  "proposalType": enum (AccountBudgetProposalType),
  "accountBudgetProposal": string,
  "name": string,
  "startDateTime": string,
  "purchaseOrderNumber": string,
  "notes": string,
  "creationDateTime": string,

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.

  // Union field spending_limit can be only one of the following:
  "spendingLimitMicros": string,
  "spendingLimitType": enum (SpendingLimitType)
  // End of list of possible types for union field spending_limit.
}
フィールド
proposalType

enum (AccountBudgetProposalType)

出力専用。このプロポーザルのタイプ(END など。このプロポーザルに関連付けられた予算を終了します)。

accountBudgetProposal

string

出力専用。提案のリソース名。AccountBudgetProposal リソース名の形式は次のとおりです。

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id}

name

string

出力専用。アカウント単位の予算に割り当てる名前。

startDateTime

string

出力専用。開始時刻は yyyy-MM-dd HH:mm:ss 形式です。

purchaseOrderNumber

string

出力専用。注文書番号は、ユーザーが毎月の請求書でこの予算を参照するのに役立つ値です。

notes

string

出力専用。この予算に関するメモです。

creationDateTime

string

出力専用。このアカウントレベルの予算提案が作成された時刻。yyyy-MM-dd HH:mm:ss の形式です。

共用体フィールド end_time。アカウント単位の予算の終了時刻。end_time は次のいずれかになります。
endDateTime

string

出力専用。終了日時(yyyy-MM-dd HH:mm:ss 形式)。

endTimeType

enum (TimeType)

出力専用。明確に定義された型(FOREVER など)の終了時間。

共用体フィールド spending_limit。費用上限。spending_limit は次のいずれかになります。
spendingLimitMicros

string (int64 format)

出力専用。費用上限(マイクロ秒単位)。100 万が 1 単位に相当します。

spendingLimitType

enum (SpendingLimitType)

出力専用。明確に定義されたタイプ(INFINITE など)の使用量上限。

AdGroupAdAssetCombinationView

広告グループの広告アセットの組み合わせの使用状況が表示されます。今後は、レスポンシブ検索広告の AdGroupAdAssetCombinationView のみがサポートされます。今後、他の広告タイプもサポートされる予定です。

JSON 表現
{
  "resourceName": string,
  "servedAssets": [
    {
      object (AssetUsage)
    }
  ],
  "enabled": boolean
}
フィールド
resourceName

string

出力専用。広告グループの広告アセットの組み合わせビューのリソース名。組み合わせ ID は 128 ビットで、上位 64 ビットは asset_combination_id_high に格納され、下位 64 ビットは asset_combination_id_low に格納されます。AdGroupAd アセットの組み合わせビューのリソース名の形式は customers/{customerId}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high} です。

servedAssets[]

object (AssetUsage)

出力専用。配信されたアセット。

enabled

boolean

出力専用。アセットの組み合わせと最新バージョンの広告の間のステータス。true の場合、アセットの組み合わせは最新バージョンの広告にリンクされています。false の場合、リンクは以前存在していたものの、削除されており、最新バージョンの広告には存在しないことを意味します。

AssetUsage

アセットの使用状況に関する情報が含まれます。

JSON 表現
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
フィールド
asset

string

アセットのリソース名。

servedAssetFieldType

enum (ServedAssetFieldType)

アセットの配信フィールド タイプ。

AdGroupAdAssetView

AdGroupAd と Asset の間のリンク。現在、AdGroupAdAssetView はアプリ広告とレスポンシブ検索広告でのみサポートされています。

JSON 表現
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "source": enum (AssetSource),
  "adGroupAd": string,
  "asset": string,
  "enabled": boolean
}
フィールド
resourceName

string

出力専用。広告グループの広告アセットビューのリソース名。広告グループ広告アセットビューのリソース名の形式は、(v4 より前)次のとおりです。

customers/{customerId}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}

広告グループ広告アセットビューのリソース名の形式は次のとおりです(v4 以降)。

customers/{customerId}/adGroupAdAssetViews/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}

fieldType

enum (AssetFieldType)

出力専用。広告でのアセットの役割。

policySummary

object (AdGroupAdAssetPolicySummary)

出力専用。広告グループの広告アセットのポリシー情報。

performanceLabel

enum (AssetPerformanceLabel)

出力専用。アセットのリンクのパフォーマンス。

pinnedField

enum (ServedAssetFieldType)

出力専用。固定フィールド。

source

enum (AssetSource)

出力専用。広告グループの広告アセットのソース。

adGroupAd

string

出力専用。アセットがリンクされている広告グループ広告。

asset

string

出力専用。広告グループの広告にリンクされているアセット。

enabled

boolean

出力専用。アセットと最新バージョンの広告のステータス。true の場合、アセットは最新バージョンの広告にリンクされています。false の場合、リンクは存在していたが削除され、最新バージョンの広告には存在しないことを意味します。

AdGroupAdAssetPolicySummary

広告グループの広告アセットのポリシー情報が含まれます。

JSON 表現
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
フィールド
policyTopicEntries[]

object (PolicyTopicEntry)

出力専用。広告グループ広告アセットのポリシー違反のリスト。

reviewStatus

enum (PolicyReviewStatus)

出力専用。この広告グループの広告アセットが審査プロセスのどの段階にあるかを示します。

approvalStatus

enum (PolicyApprovalStatus)

出力専用。この広告グループの広告アセットの全体的な承認状況。個々のポリシー項目のエントリのステータスに基づいて計算されます。

AdGroupAudienceView

広告グループのオーディエンス ビュー。ディスプレイ ネットワーク広告と YouTube ネットワーク広告のインタレスト リストやリマーケティング リスト、検索広告向けリマーケティング リスト(RLSA)について、オーディエンス単位で集計した掲載結果データが含まれます。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。広告グループのオーディエンス ビューのリソース名。広告グループ オーディエンス ビューのリソース名の形式は次のとおりです。

customers/{customerId}/adGroupAudienceViews/{adGroupId}~{criterionId}

AdGroupCriterionSimulation

広告グループの条件のシミュレーションです。サポートされている広告チャネルの種類、条件の種類、シミュレーションの種類、シミュレーションの変更方法は、それぞれ以下に記載しています。V5 以降のホテルの AdGroupCriterion シミュレーション オペレーション。

  1. ディスプレイ - キーワード - CPC_BID - UNIFORM
  2. 検索 - キーワード - CPC_BID - UNIFORM
  3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM
  4. ホテル - リスティング グループ - CPC_BID - ユニフォーム
  5. ホテル - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
JSON 表現
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "criterionId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "percentCpcBidPointList": {
    object (PercentCpcBidSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
フィールド
resourceName

string

出力専用。広告グループの条件シミュレーションのリソース名。広告グループの条件のシミュレーション リソース名の形式は次のとおりです。

customers/{customerId}/adGroupCriterionSimulations/{adGroupId}~{criterionId}~{type}~{modificationMethod}~{startDate}~{endDate}

type

enum (SimulationType)

出力専用。シミュレーションで変更するフィールド。

modificationMethod

enum (SimulationModificationMethod)

出力専用。シミュレーションによってフィールドがどのように変更されるかを示します。

adGroupId

string (int64 format)

出力専用。シミュレーションの広告グループ ID。

criterionId

string (int64 format)

出力専用。シミュレーションの条件 ID。

startDate

string

出力専用。シミュレーションのベースとなる最初の日(YYYY-MM-DD 形式)。

endDate

string

出力専用。シミュレーションのベースとなる最終日(YYYY-MM-DD 形式)。

共用体フィールド point_list。シミュレーション ポイントのリスト。point_list は次のいずれかになります。
cpcBidPointList

object (CpcBidSimulationPointList)

出力専用。シミュレーション タイプが CPC_BID の場合のシミュレーション ポイント。

percentCpcBidPointList

object (PercentCpcBidSimulationPointList)

出力専用。シミュレーション タイプが PERCENT_CPC_BID の場合のシミュレーション ポイント。

SimulationType

シミュレーションによって変更されるフィールドを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
CPC_BID シミュレーションはクリック単価の入札単価を対象としています。
CPV_BID このシミュレーションは、広告視聴単価に基づくものです。
TARGET_CPA このシミュレーションは目標コンバージョン単価を想定したものです。
BID_MODIFIER 入札単価調整比を使ったシミュレーションです。
TARGET_ROAS このシミュレーションは、広告費用対効果の目標値に関するものです。
PERCENT_CPC_BID 割合クリック単価を使用したシミュレーションです。
TARGET_IMPRESSION_SHARE このシミュレーションは、目標インプレッション シェアに関するものです。
BUDGET シミュレーションは予算を対象としています。

SimulationModificationMethod

シミュレーションでフィールドを変更する方法を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
UNIFORM シミュレーションの値は、特定のリソースのすべての子に均一に適用されました。子リソースのオーバーライドが考慮されていませんでした。
DEFAULT シミュレーションの値が特定のリソースに適用されました。子リソースのオーバーライドが適用され、トラフィック見積もりにこれらのリソースは含まれません。
SCALING シミュレーション内の値はすべて同じ係数でスケーリングされました。たとえば、TargetCpa のシミュレーション キャンペーンでは、キャンペーンの目標値とすべての広告グループの目標値が係数 X で調整されました。

CpcBidSimulationPointList

CPC_BID タイプのシミュレーションのシミュレーション ポイントのコンテナ。

JSON 表現
{
  "points": [
    {
      object (CpcBidSimulationPoint)
    }
  ]
}
フィールド
points[]

object (CpcBidSimulationPoint)

一連の CPC 入札額の予測指標。

CpcBidSimulationPoint

特定のクリック単価の予測指標。

JSON 表現
{
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,

  // Union field cpc_simulation_key_value can be only one of the following:
  "cpcBidMicros": string,
  "cpcBidScalingModifier": number
  // End of list of possible types for union field cpc_simulation_key_value.
}
フィールド
requiredBudgetAmountMicros

string (int64 format)

推定トラフィックを獲得するために広告主が設定する必要がある 1 日の予算の予測値(広告主の通貨のマイクロ単位)。

biddableConversions

number

入札単価設定に使用されるコンバージョン数の予測値。

biddableConversionsValue

number

入札対象コンバージョンの予測合計値。

clicks

string (int64 format)

予測されるクリック数。

costMicros

string (int64 format)

予測費用(マイクロ単位)。

impressions

string (int64 format)

予測されるインプレッション数。

topSlotImpressions

string (int64 format)

トップスロット インプレッションの予測値。このフィールドをサポートしているのは、検索広告チャネルのタイプのみです。

共用体フィールド cpc_simulation_key_value。SimulationModificationMethod = UNIFORM または DEFAULT の場合は、cpc_bid_micros が設定されます。SimulationModificationMethod = SCALING の場合、cpc_bid_scaling_modifier が設定されます。cpc_simulation_key_value は次のいずれかになります。
cpcBidMicros

string (int64 format)

予測される指標の基となる、シミュレートされたクリック単価です。

cpcBidScalingModifier

number

予測指標のベースとなるシミュレートされたスケーリング モディファイア。シミュレートされたエンティティに関連するすべてのクリック単価は、この調整比によって調整されます。

PercentCpcBidSimulationPointList

PERCENT_CPC_BID タイプのシミュレーションのシミュレーション ポイントのコンテナ。

JSON 表現
{
  "points": [
    {
      object (PercentCpcBidSimulationPoint)
    }
  ]
}
フィールド
points[]

object (PercentCpcBidSimulationPoint)

一連のクリック単価の割合に対する推定指標。

PercentCpcBidSimulationPoint

特定のクリック単価の割合に対する予測指標。このフィールドは、ホテル広告チャネル タイプでのみサポートされています。

JSON 表現
{
  "percentCpcBidMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
フィールド
percentCpcBidMicros

string (int64 format)

予測される指標の基となる、シミュレーションされたクリック単価の割合です。商品やサービスの広告価格の割合で表される、クリック単価の割合。ここに格納される値は 1,000,000 * [小数] です。

biddableConversions

number

入札単価設定に使用されるコンバージョン数の予測値。

biddableConversionsValue

number

入札対象コンバージョンの予測合計値(現地通貨)。

clicks

string (int64 format)

予測クリック数。

costMicros

string (int64 format)

予測費用(マイクロ単位)。

impressions

string (int64 format)

予測されるインプレッション数。

topSlotImpressions

string (int64 format)

上部スロット インプレッションの予測数。

AdGroupSimulation

広告グループのシミュレーションです。広告チャネル タイプ、シミュレーション タイプ、シミュレーション変更方法のサポートされている組み合わせは次のとおりです。

  1. 検索 - CPC_BID - デフォルト
  2. 検索 - CPC_BID - UNIFORM
  3. 検索 - TARGET_CPA - UNIFORM
  4. 検索 - TARGET_ROAS - UNIFORM
  5. DISPLAY - CPC_BID - デフォルト
  6. DISPLAY - CPC_BID - UNIFORM
  7. ディスプレイ - TARGET_CPA - UNIFORM
JSON 表現
{
  "resourceName": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "adGroupId": string,
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "cpvBidPointList": {
    object (CpvBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
フィールド
resourceName

string

出力専用。広告グループ シミュレーションのリソース名。広告グループ シミュレーションのリソース名の形式は次のとおりです。

customers/{customerId}/adGroupSimulations/{adGroupId}~{type}~{modificationMethod}~{startDate}~{endDate}

type

enum (SimulationType)

出力専用。シミュレーションで変更するフィールド。

modificationMethod

enum (SimulationModificationMethod)

出力専用。シミュレーションによってフィールドがどのように変更されるかを示します。

adGroupId

string (int64 format)

出力専用。シミュレーションの広告グループ ID。

startDate

string

出力専用。シミュレーションのベースとなる最初の日(YYYY-MM-DD 形式)。

endDate

string

出力専用。シミュレーションのベースとなる最終日(YYYY-MM-DD 形式)

共用体フィールド point_list。シミュレーション ポイントのリスト。point_list は次のいずれかになります。
cpcBidPointList

object (CpcBidSimulationPointList)

出力専用。シミュレーション タイプが CPC_BID の場合のシミュレーション ポイント。

cpvBidPointList

object (CpvBidSimulationPointList)

出力専用。シミュレーション タイプが CPV_BID の場合のシミュレーション ポイント。

targetCpaPointList

object (TargetCpaSimulationPointList)

出力専用。シミュレーション タイプが TARGET_CPA の場合のシミュレーション ポイント。

targetRoasPointList

object (TargetRoasSimulationPointList)

出力専用。シミュレーション タイプが TARGET_ROAS の場合のシミュレーション ポイント。

CpvBidSimulationPointList

CPV_BID タイプのシミュレーションのシミュレーション ポイントのコンテナ。

JSON 表現
{
  "points": [
    {
      object (CpvBidSimulationPoint)
    }
  ]
}
フィールド
points[]

object (CpvBidSimulationPoint)

一連の CPV 入札単価に対する予測される指標。

CpvBidSimulationPoint

特定の CPV 入札単価の予測指標。

JSON 表現
{
  "cpvBidMicros": string,
  "costMicros": string,
  "impressions": string,
  "views": string
}
フィールド
cpvBidMicros

string (int64 format)

予測指標の基になるシミュレートされた CPV 入札単価。

costMicros

string (int64 format)

予測費用(マイクロ単位)。

impressions

string (int64 format)

予測インプレッション数。

views

string (int64 format)

予測される視聴回数。

TargetCpaSimulationPointList

TARGET_CPA タイプのシミュレーションのシミュレーション ポイントのコンテナ。

JSON 表現
{
  "points": [
    {
      object (TargetCpaSimulationPoint)
    }
  ]
}
フィールド
points[]

object (TargetCpaSimulationPoint)

一連の目標コンバージョン単価の金額について予測される指標です。

TargetCpaSimulationPoint

特定の目標コンバージョン単価の予測指標。

JSON 表現
{
  "requiredBudgetAmountMicros": string,
  "appInstalls": number,
  "inAppActions": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "interactions": string,

  // Union field target_cpa_simulation_key_value can be only one of the
  // following:
  "targetCpaMicros": string,
  "targetCpaScalingModifier": number
  // End of list of possible types for union field
  // target_cpa_simulation_key_value.
}
フィールド
requiredBudgetAmountMicros

string (int64 format)

推定トラフィックを獲得するために広告主が設定する必要がある 1 日の予算の予測値(広告主の通貨のマイクロ単位)。

appInstalls

number

予測されるアプリのインストール数。

inAppActions

number

アプリ内コンバージョンの予測数。

biddableConversions

number

入札対象のコンバージョン数の予測。

biddableConversionsValue

number

入札対象コンバージョンの予測合計値。

clicks

string (int64 format)

予測されるクリック数。

costMicros

string (int64 format)

予測費用(マイクロ単位)。

impressions

string (int64 format)

予測されるインプレッション数。

topSlotImpressions

string (int64 format)

トップスロット インプレッションの予測数。このフィールドは、検索広告チャネル タイプでのみサポートされています。

interactions

string (int64 format)

予測されるインタラクション数。このフィールドは、ファインド広告チャネル タイプでのみサポートされています。

共用体フィールド target_cpa_simulation_key_value。SimulationModificationMethod = UNIFORM または DEFAULT の場合、target_cpa_micros が設定されます。SimulationModificationMethod が SCALING の場合、target_cpa_scaling_modifier が設定されます。target_cpa_simulation_key_value は次のいずれかになります。
targetCpaMicros

string (int64 format)

予測指標の基になるシミュレートされた目標コンバージョン単価。

targetCpaScalingModifier

number

予測指標の基となるシミュレートされたスケーリング修飾子。シミュレートされたエンティティに関連するすべての CPA 目標は、この調整係数で調整されます。

TargetRoasSimulationPointList

TARGET_ROAS タイプのシミュレーションのシミュレーション ポイントのコンテナ。

JSON 表現
{
  "points": [
    {
      object (TargetRoasSimulationPoint)
    }
  ]
}
フィールド
points[]

object (TargetRoasSimulationPoint)

一連の目標広告費用対効果の金額に対する予測指標。

TargetRoasSimulationPoint

特定の目標広告費用対効果の金額に対する予測指標。

JSON 表現
{
  "requiredBudgetAmountMicros": string,
  "targetRoas": number,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string
}
フィールド
requiredBudgetAmountMicros

string (int64 format)

推定トラフィックを獲得するために広告主が設定する必要がある 1 日の必要予算の予測額(広告主の通貨のマイクロ単位)。

targetRoas

number

予測される指標の基となる、シミュレートされた目標広告費用対効果です。

biddableConversions

number

入札対象のコンバージョン数の予測。

biddableConversionsValue

number

入札対象コンバージョンの予測合計値。

clicks

string (int64 format)

予測されるクリック数。

costMicros

string (int64 format)

予測費用(マイクロ単位)。

impressions

string (int64 format)

予測されるインプレッション数。

topSlotImpressions

string (int64 format)

トップスロット インプレッションの予測数。このフィールドは、検索広告チャネル タイプでのみサポートされています。

AgeRangeView

年齢層のビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。年齢層ビューのリソース名。年齢層ビューのリソース名の形式は次のとおりです。

customers/{customerId}/ageRangeViews/{adGroupId}~{criterionId}

AdScheduleView

広告のスケジュール ビューには、AdSchedule 条件別のキャンペーンのパフォーマンスの概要が表示されます。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。広告スケジュール ビューのリソース名。AdSchedule ビューのリソース名の形式は次のとおりです。

customers/{customerId}/adScheduleViews/{campaignId}~{criterionId}

DomainCategory

ドメインのクロールによって自動生成されるカテゴリ。キャンペーンで DynamicSearchAdsSetting を使用している場合、ドメインのカテゴリが生成されます。カテゴリは、WebpageConditionInfo を使用してターゲットに設定できます。参照: https://support.google.com/google-ads/answer/2471185

JSON 表現
{
  "resourceName": string,
  "campaign": string,
  "category": string,
  "languageCode": string,
  "domain": string,
  "coverageFraction": number,
  "categoryRank": string,
  "hasChildren": boolean,
  "recommendedCpcBidMicros": string
}
フィールド
resourceName

string

出力専用。ドメイン カテゴリのリソース名。ドメイン カテゴリのリソース名の形式は次のとおりです。

customers/{customerId}/domainCategories/{campaignId}~{category_base64}~{languageCode}

campaign

string

出力専用。このカテゴリの使用が推奨されるキャンペーンです。

category

string

出力専用。ウェブサイト ドメインに推奨されるカテゴリ。たとえば、家電に関するウェブサイトの場合は、「カメラ」、「テレビ」などのカテゴリが推奨されます。

languageCode

string

出力専用。ウェブサイトの言語を指定する言語コード(英語の場合は「en」など)。言語は、動的検索広告に必要な DynamicSearchAdsSetting で指定できます。Google 広告 で特定して広告を作成し、検索の内容と照合するページの言語を指定します。

domain

string

出力専用。ウェブサイトのドメイン。ドメインは、動的検索広告に必要な DynamicSearchAdsSetting で指定できます。

coverageFraction

number

出力専用。このカテゴリに一致するサイト上のページの割合。

categoryRank

string (int64 format)

出力専用。カテゴリセットにおけるこのカテゴリの位置。数字が小さいほどドメインとの一致が良好であることを示し、null は推奨されないことを示します。

hasChildren

boolean

出力専用。このカテゴリにサブカテゴリがあるかどうかを示します。

recommendedCpcBidMicros

string (int64 format)

出力専用。カテゴリに推奨されるクリック単価。

AssetFieldTypeView

アセット フィールド タイプのビュー。このビューでは、アセットを広告表示オプションとして使用している場合、各アセットのフィールド タイプについて、過大カウントされない指標がレポートされます。

JSON 表現
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType)
}
フィールド
resourceName

string

出力専用。アセット フィールド タイプビューのリソース名。アセット フィールド タイプのビューのリソース名の形式は次のとおりです。

customers/{customerId}/assetFieldTypeViews/{fieldType}

fieldType

enum (AssetFieldType)

出力専用。アセット フィールド タイプビューのアセット フィールド タイプ。

AssetGroupProductGroupView

アセット グループの商品グループビュー。

JSON 表現
{
  "resourceName": string,
  "assetGroup": string,
  "assetGroupListingGroupFilter": string
}
フィールド
resourceName

string

出力専用。アセット グループの商品グループビューのリソース名。アセット グループの商品グループビューのリソース名の形式は次のとおりです。

customers/{customerId}/assetGroupProductGroupViews/{assetGroupId}~{listing_group_filter_id}

assetGroup

string

出力専用。リスティング グループのフィルタに関連付けられているアセット グループ。

assetGroupListingGroupFilter

string

出力専用。アセット グループのリスティング グループのフィルタのリソース名。

AssetGroupTopCombinationView

広告グループの広告アセットの組み合わせの使用状況が表示されます。

JSON 表現
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
フィールド
resourceName

string

出力専用。アセット グループの最上位の組み合わせビューのリソース名。AssetGroup の上位の組み合わせビューのリソース名の形式は、「customers/{customerId}/assetGroupTopCombinationViews/{assetGroupId}~{asset_combination_category}」です。

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

出力専用。一緒に配信されたアセットの組み合わせのうち、上位の組み合わせ。

AssetGroupAssetCombinationData

アセット グループのアセットの組み合わせのデータ

JSON 表現
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
フィールド
assetCombinationServedAssets[]

object (AssetUsage)

出力専用。配信されたアセット。

AssetSetTypeView

アセットセット タイプのビュー。このビューには、アセットセットの種類ごとに、重複カウントされていない指標が表示されます。子アセットセットのタイプは、このレポートには含まれません。統計情報は、親アセットセット タイプで集計されます。

JSON 表現
{
  "resourceName": string,
  "assetSetType": enum (AssetSetType)
}
フィールド
resourceName

string

出力専用。アセットセット タイプビューのリソース名。アセットセット タイプ ビューのリソース名の形式は次のとおりです。

customers/{customerId}/assetSetTypeViews/{assetSetType}

assetSetType

enum (AssetSetType)

出力専用。アセットセット タイプビューのアセットセット タイプ。

BiddingStrategySimulation

入札戦略のシミュレーション。サポートされているシミュレーション タイプとシミュレーション変更方法の組み合わせは次のとおりです。

  1. TARGET_CPA - UNIFORM
  2. TARGET_ROAS - UNIFORM
JSON 表現
{
  "resourceName": string,
  "biddingStrategyId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
フィールド
resourceName

string

出力専用。入札戦略シミュレーションのリソース名。入札戦略シミュレーションのリソース名の形式は次のとおりです。

customers/{customerId}/biddingStrategySimulations/{biddingStrategyId}~{type}~{modificationMethod}~{startDate}~{endDate}

biddingStrategyId

string (int64 format)

出力専用。シミュレーションの入札戦略共有設定 ID。

type

enum (SimulationType)

出力専用。シミュレーションで変更するフィールド。

modificationMethod

enum (SimulationModificationMethod)

出力専用。シミュレーションによってフィールドがどのように変更されるかを示します。

startDate

string

出力専用。シミュレーションのベースとなる初日(YYYY-MM-DD 形式)。

endDate

string

出力専用。シミュレーションのベースとなる最終日(YYYY-MM-DD 形式)

共用体フィールド point_list。シミュレーション ポイントのリスト。point_list は次のいずれかになります。
targetCpaPointList

object (TargetCpaSimulationPointList)

出力専用。シミュレーション タイプが TARGET_CPA の場合、シミュレーション ポイント。

targetRoasPointList

object (TargetRoasSimulationPointList)

出力専用。シミュレーション タイプが TARGET_ROAS の場合のシミュレーション ポイント。

CallView

電話専用広告または電話番号表示オプションのコール トラッキングのデータを含む通話ビュー。

JSON 表現
{
  "resourceName": string,
  "callerCountryCode": string,
  "callerAreaCode": string,
  "callDurationSeconds": string,
  "startCallDateTime": string,
  "endCallDateTime": string,
  "callTrackingDisplayLocation": enum (CallTrackingDisplayLocation),
  "type": enum (CallType),
  "callStatus": enum (GoogleVoiceCallStatus)
}
フィールド
resourceName

string

出力専用。通話ビューのリソース名。コールビューのリソース名の形式は次のとおりです。

customers/{customerId}/callViews/{call_detail_id}

callerCountryCode

string

出力専用。発信者の国コード。

callerAreaCode

string

出力専用。発信者の市外局番。通話時間が 15 秒未満の場合は null。

callDurationSeconds

string (int64 format)

出力専用。広告主様が指定した通話時間(秒単位)。

startCallDateTime

string

出力専用。広告主様が指定した通話開始日時。

endCallDateTime

string

出力専用。広告主が指定した通話終了日時。

callTrackingDisplayLocation

enum (CallTrackingDisplayLocation)

出力専用。コール トラッキングが表示される場所。

type

enum (CallType)

出力専用。通話のタイプ。

callStatus

enum (GoogleVoiceCallStatus)

出力専用。通話のステータス。

CallTrackingDisplayLocation

コール トラッキングの表示位置の候補です。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
AD 広告から発信された電話。
LANDING_PAGE ランディング ページ広告経由の通話が指している。

CallType

呼び出し元の可能性があるプロパティのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
MANUALLY_DIALED 電話が手動でダイヤルされた。

GoogleVoiceCallStatus

Google Voice 通話のステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
MISSED 応答がありませんでした。
RECEIVED 通話が受信されました。

CampaignAudienceView

キャンペーンのオーディエンス ビュー。ディスプレイ ネットワーク広告と YouTube ネットワーク広告のインタレストとリマーケティング リスト、検索広告向けリマーケティング リスト(RLSA)について、キャンペーンやオーディエンスの条件ごとに集計した掲載結果データが含まれます。このビューには、キャンペーン単位で適用されているオーディエンスのみが表示されます。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。キャンペーン オーディエンス ビューのリソース名。キャンペーンのオーディエンス ビューのリソース名の形式は次のとおりです。

customers/{customerId}/campaignAudienceViews/{campaignId}~{criterionId}

CampaignSearchTermInsight

キャンペーンの検索語句のビュー。過去のデータは 2023 年 3 月よりご利用いただけます。

JSON 表現
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string,
  "campaignId": string
}
フィールド
resourceName

string

出力専用。キャンペーン単位の検索語句分析のリソース名。キャンペーン単位の検索語句分析情報のリソース名の形式は次のとおりです。

customers/{customerId}/campaignSearchTermInsights/{campaignId}~{categoryId}

categoryLabel

string

出力専用。検索カテゴリのラベル。空の文字列は、他のカテゴリに当てはまらない検索キーワードのキャッチオール カテゴリを示します。

id

string (int64 format)

出力専用。分析情報の ID。

campaignId

string (int64 format)

出力専用。キャンペーンの ID です。

CampaignSimulation

キャンペーンのシミュレーション広告チャネル タイプ、シミュレーション タイプ、シミュレーション変更方法のサポートされている組み合わせは次のとおりです。

  • 検索 - CPC_BID - UNIFORM
  • 検索 - CPC_BID - スケーリング
  • 検索 - TARGET_CPA - UNIFORM
  • 検索 - TARGET_CPA - スケーリング
  • 検索 - TARGET_ROAS - UNIFORM
  • 検索 - TARGET_impression_SHARE - UNIFORM
  • 検索 - 予算 - 統合
  • ショッピング - 予算 - 制服
  • ショッピング - TARGET_ROAS - UNIFORM
  • MULTI_CHANNEL - TARGET_CPA - UNIFORM
  • MULTI_CHANNEL - TARGET_ROAS - UNIFORM
  • ファインド - TARGET_CPA - デフォルト
  • ディスプレイ - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • P-MAX - TARGET_ROAS - UNIFORM
  • P-MAX - 予算 - ユニフォーム
JSON 表現
{
  "resourceName": string,
  "campaignId": string,
  "type": enum (SimulationType),
  "modificationMethod": enum (SimulationModificationMethod),
  "startDate": string,
  "endDate": string,

  // Union field point_list can be only one of the following:
  "cpcBidPointList": {
    object (CpcBidSimulationPointList)
  },
  "targetCpaPointList": {
    object (TargetCpaSimulationPointList)
  },
  "targetRoasPointList": {
    object (TargetRoasSimulationPointList)
  },
  "targetImpressionSharePointList": {
    object (TargetImpressionShareSimulationPointList)
  },
  "budgetPointList": {
    object (BudgetSimulationPointList)
  }
  // End of list of possible types for union field point_list.
}
フィールド
resourceName

string

出力専用。キャンペーン シミュレーションのリソース名。キャンペーン シミュレーションのリソース名の形式は次のとおりです。

customers/{customerId}/campaignSimulations/{campaignId}~{type}~{modificationMethod}~{startDate}~{endDate}

campaignId

string (int64 format)

出力専用。シミュレーションのキャンペーン ID。

type

enum (SimulationType)

出力専用。シミュレーションで変更するフィールド。

modificationMethod

enum (SimulationModificationMethod)

出力専用。シミュレーションによってフィールドがどのように変更されるかを示します。

startDate

string

出力専用。シミュレーションのベースとなる初日(YYYY-MM-DD 形式)。

endDate

string

出力専用。シミュレーションのベースとなる最終日(YYYY-MM-DD 形式)

共用体フィールド point_list。シミュレーション ポイントのリスト。point_list は次のいずれかになります。
cpcBidPointList

object (CpcBidSimulationPointList)

出力専用。シミュレーション タイプが CPC_BID の場合のシミュレーション ポイント。

targetCpaPointList

object (TargetCpaSimulationPointList)

出力専用。シミュレーション タイプが TARGET_CPA の場合、シミュレーション ポイント。

targetRoasPointList

object (TargetRoasSimulationPointList)

出力専用。シミュレーション タイプが TARGET_ROAS の場合のシミュレーション ポイント。

targetImpressionSharePointList

object (TargetImpressionShareSimulationPointList)

出力専用。シミュレーション タイプが TARGET_IMPRESSION_SHARE の場合のシミュレーション ポイント。

budgetPointList

object (BudgetSimulationPointList)

出力専用。シミュレーション タイプが BUDGET の場合のシミュレーション ポイント。

TargetImpressionShareSimulationPointList

TARGET_PROFILE_SHARE タイプのシミュレーションのシミュレーション ポイントのコンテナです。

JSON 表現
{
  "points": [
    {
      object (TargetImpressionShareSimulationPoint)
    }
  ]
}
フィールド
points[]

object (TargetImpressionShareSimulationPoint)

特定の目標インプレッション シェア値についての予測指標。

TargetImpressionShareSimulationPoint

特定の目標インプレッション シェア値の予測指標。

JSON 表現
{
  "targetImpressionShareMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "requiredBudgetAmountMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "absoluteTopImpressions": string
}
フィールド
targetImpressionShareMicros

string (int64 format)

予測指標の基となるシミュレーション上の目標インプレッション シェア値(マイクロ単位)。たとえば、10% のインプレッション シェアは 0.1 に相当し、100_000 として保存されます。この値は検証され、100% を超えることはありません。

requiredCpcBidCeilingMicros

string (int64 format)

このシミュレーションを実現するために広告主様が設定する必要がある 1 日のクリック単価の下限値(1 マイクロ単位)。

requiredBudgetAmountMicros

string (int64 format)

推定トラフィックを獲得するために広告主が設定する必要がある 1 日の必要予算の予測額(広告主の通貨のマイクロ単位)。

biddableConversions

number

入札単価設定に使用されるコンバージョン数の予測値。

biddableConversionsValue

number

入札対象コンバージョンの予測合計値。

clicks

string (int64 format)

予測されるクリック数。

costMicros

string (int64 format)

予測費用(マイクロ単位)。

impressions

string (int64 format)

予測されるインプレッション数。

topSlotImpressions

string (int64 format)

トップスロット インプレッションの予測値。このフィールドをサポートしているのは、検索広告チャネルのタイプのみです。

absoluteTopImpressions

string (int64 format)

検索広告の最上部インプレッション数の予測値。このフィールドをサポートしているのは、検索広告チャネルのタイプのみです。

BudgetSimulationPointList

「予算」タイプのシミュレーション用のシミュレーション ポイントのコンテナ。

JSON 表現
{
  "points": [
    {
      object (BudgetSimulationPoint)
    }
  ]
}
フィールド
points[]

object (BudgetSimulationPoint)

一連の予算額の予測指標。

BudgetSimulationPoint

特定の予算額の予測指標。

JSON 表現
{
  "budgetAmountMicros": string,
  "requiredCpcBidCeilingMicros": string,
  "biddableConversions": number,
  "biddableConversionsValue": number,
  "clicks": string,
  "costMicros": string,
  "impressions": string,
  "topSlotImpressions": string,
  "interactions": string
}
フィールド
budgetAmountMicros

string (int64 format)

予測される指標の基となるシミュレーションされた予算です。

requiredCpcBidCeilingMicros

string (int64 format)

このシミュレーションを実現するために広告主様が設定する必要がある 1 日のクリック単価の下限値(1 マイクロ単位)。この項目に対応しているのは、目標予算を使用しているキャンペーンのみです。

biddableConversions

number

入札単価設定に使用されるコンバージョン数の予測値。

biddableConversionsValue

number

入札対象コンバージョンの予測合計値。

clicks

string (int64 format)

予測されるクリック数。

costMicros

string (int64 format)

予測費用(マイクロ単位)。

impressions

string (int64 format)

予測されるインプレッション数。

topSlotImpressions

string (int64 format)

トップスロット インプレッションの予測数。このフィールドは、検索広告チャネル タイプでのみサポートされています。

interactions

string (int64 format)

予測されるインタラクション数。このフィールドは、ファインド広告チャネル タイプでのみサポートされています。

CarrierConstant

キャンペーンのターゲット設定で使用できる携帯通信会社の条件。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "name": string,
  "countryCode": string
}
フィールド
resourceName

string

出力専用。運送業者の条件のリソース名。携帯通信会社の条件リソース名の形式は次のとおりです。

carrierConstants/{criterionId}

id

string (int64 format)

出力専用。運送業者の条件の ID。

name

string

出力専用。携帯通信会社のフルネーム(英語)。

countryCode

string

出力専用。携帯通信会社が所在する国の国コード(「AR」、「FR」など)。

ChangeEvent

特定のリソースタイプで返されるリソースの詳細な変更について説明します。過去 30 日間に UI または API を介して行われた変更が含まれます。変更されたフィールドの変更前の値と変更後の値が表示されます。ChangeEvent には、新しい変更が反映されるまでに最大 3 分の遅延が発生する可能性があります。

JSON 表現
{
  "resourceName": string,
  "changeDateTime": string,
  "changeResourceType": enum (ChangeEventResourceType),
  "changeResourceName": string,
  "clientType": enum (ChangeClientType),
  "userEmail": string,
  "oldResource": {
    object (ChangedResource)
  },
  "newResource": {
    object (ChangedResource)
  },
  "resourceChangeOperation": enum (ResourceChangeOperation),
  "changedFields": string,
  "campaign": string,
  "adGroup": string,
  "feed": string,
  "feedItem": string,
  "asset": string
}
フィールド
resourceName

string

出力専用。変更イベントのリソース名。変更イベントのリソース名の形式は次のとおりです。

customers/{customerId}/changeEvents/{timestamp_micros}~{command_index}~{mutate_index}

changeDateTime

string

出力専用。このリソースに変更が commit された時刻。

changeResourceType

enum (ChangeEventResourceType)

出力専用。変更されたリソースのタイプ。これにより、oldResource と newResource で設定されるリソースが決まります。

changeResourceName

string

出力専用。この変更が発生した Simply リソース。

clientType

enum (ChangeClientType)

出力専用。変更が行われた場所。

userEmail

string

出力専用。この変更を行ったユーザーのメールアドレス。

oldResource

object (ChangedResource)

出力専用。変更前の古いリソース。変更されたフィールドのみが設定されます。

newResource

object (ChangedResource)

出力専用。変更後の新しいリソース。変更されたフィールドのみが設定されます。

resourceChangeOperation

enum (ResourceChangeOperation)

出力専用。変更されたリソースに対するオペレーション。

changedFields

string (FieldMask format)

出力専用。返されたリソースで変更されたフィールドのリスト。

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"

campaign

string

出力専用。この変更の影響を受けるキャンペーン。

adGroup

string

出力専用。この変更の影響を受ける広告グループ。

feed

string

出力専用。この変更の影響を受けるフィード。

feedItem

string

出力専用。この変更の影響を受ける FeedItem。

asset

string

出力専用。この変更の影響を受けるアセット。

ChangeEventResourceType

ChangeEvent リソースでサポートされるリソースタイプをリストする列挙型。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な分類されていないリソースを表します。
AD 広告リソースの変更。
AD_GROUP AdGroup リソースの変更。
AD_GROUP_CRITERION AdGroupCriterion リソースの変更。
CAMPAIGN キャンペーン リソースの変更。
CAMPAIGN_BUDGET CampaignBudget リソースの変更。
AD_GROUP_BID_MODIFIER AdGroupBidModifier リソースの変更。
CAMPAIGN_CRITERION CampaignCriterion リソースの変更。
FEED フィード リソースの変更。
FEED_ITEM FeedItem リソースの変更。
CAMPAIGN_FEED CampaignFeed リソースの変更。
AD_GROUP_FEED AdGroupFeed リソースの変更。
AD_GROUP_AD AdGroupAd リソースの変更。
ASSET Asset リソースの変更。
CUSTOMER_ASSET CustomerAsset リソースの変更。
CAMPAIGN_ASSET CampaignAsset リソースの変更。
AD_GROUP_ASSET AdGroupAsset リソースの変更。
ASSET_SET AssetSet リソースの変更。
ASSET_SET_ASSET AssetSetAsset リソースの変更。
CAMPAIGN_ASSET_SET CampaignAssetSet リソースの変更。

ChangeClientType

changeEvent リソースが作成されたソース。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な未分類のクライアント タイプを表します。
GOOGLE_ADS_WEB_CLIENT 「ads.google.com」で行った変更。たとえば、キャンペーン管理による変更などです。
GOOGLE_ADS_AUTOMATED_RULE Google 広告の自動化ルールで行われた変更。
GOOGLE_ADS_SCRIPTS Google 広告スクリプトによって行われた変更。
GOOGLE_ADS_BULK_UPLOAD Google 広告の一括アップロードによる変更。
GOOGLE_ADS_API Google Ads API によって行われた変更。
GOOGLE_ADS_EDITOR Google 広告エディタによる変更。この値はプレースホルダです。API はこれらの変更を返しません。
GOOGLE_ADS_MOBILE_APP Google 広告モバイルアプリによって行われた変更。
GOOGLE_ADS_RECOMMENDATIONS Google 広告の最適化案を通じて行われた変更。
SEARCH_ADS_360_SYNC 検索広告 360 の同期により行われた変更。
SEARCH_ADS_360_POST 検索広告 360 の送信で行われた変更。
INTERNAL_TOOL 内部ツールによって行われた変更。たとえば、ユーザーがキャンペーンなどのエンティティに URL テンプレートを設定すると、その URL は SA360 クリックサーバー URL で自動的にラップされます。
OTHER 分類に該当しない変更の種類(Google 広告でのクーポンの利用による変更など)。
GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION Google 広告の推奨事項を定期購入して行った変更。

ChangedResource

サポートされているすべてのリソースを表すラッパー プロトコル。changeResourceType のリソースのみが設定されます。

JSON 表現
{
  "ad": {
    object (Ad)
  },
  "adGroup": {
    object (AdGroup)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "feed": {
    object (Feed)
  },
  "feedItem": {
    object (FeedItem)
  },
  "campaignFeed": {
    object (CampaignFeed)
  },
  "adGroupFeed": {
    object (AdGroupFeed)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "asset": {
    object (Asset)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  }
}
フィールド
ad

object (Ad)

出力専用。changeResourceType == AD の場合に設定します。

adGroup

object (AdGroup)

出力専用。changeResourceType == AD_GROUP の場合に設定します。

adGroupCriterion

object (AdGroupCriterion)

出力専用。changeResourceType == AD_GROUP_CRITERION の場合に設定します。

campaign

object (Campaign)

出力専用。changeResourceType == CAMPAIGN の場合に設定します。

campaignBudget

object (CampaignBudget)

出力専用。changeResourceType == CAMPAIGN_budget の場合に設定します。

adGroupBidModifier

object (AdGroupBidModifier)

出力専用。changeResourceType == AD_GROUP_BID_MODIFIER の場合に設定します。

campaignCriterion

object (CampaignCriterion)

出力専用。changeResourceType == CAMPAIGN_CRITERION の場合に設定します。

feed

object (Feed)

出力専用。changeResourceType == FEED の場合に設定します。

feedItem

object (FeedItem)

出力専用。changeResourceType == FEED_ITEM の場合に設定します。

campaignFeed

object (CampaignFeed)

出力専用。changeResourceType == CAMPAIGN_FEED の場合は設定します。

adGroupFeed

object (AdGroupFeed)

出力専用。changeResourceType == AD_GROUP_FEED の場合に設定します。

adGroupAd

object (AdGroupAd)

出力専用。changeResourceType == AD_GROUP_AD の場合に設定します。

asset

object (Asset)

出力専用。changeResourceType == ASSET の場合に設定します。

customerAsset

object (CustomerAsset)

出力専用。changeResourceType == CUSTOMER_ASSET の場合に設定します。

campaignAsset

object (CampaignAsset)

出力専用。changeResourceType == CAMPAIGN_ASSET の場合に設定します。

adGroupAsset

object (AdGroupAsset)

出力専用。changeResourceType == AD_GROUP_ASSET の場合に設定します。

assetSet

object (AssetSet)

出力専用。changeResourceType == ASSET_SET の場合に設定されます。

assetSetAsset

object (AssetSetAsset)

出力専用。changeResourceType == ASSET_SET_ASSET の場合に設定されます。

campaignAssetSet

object (CampaignAssetSet)

出力専用。changeResourceType == CAMPAIGN_ASSET_SET の場合に設定します。

ResourceChangeOperation

changeEvent リソースの変更されたリソースに対するオペレーション。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な分類されていないオペレーションを表します。
CREATE リソースが作成されました。
UPDATE リソースが変更されました。
REMOVE リソースが削除されました。

ChangeStatus

返されたリソースのステータスを示します。ChangeStatus に新しい変更が反映されるまで、最大 3 分の遅延が発生する可能性があります。

JSON 表現
{
  "resourceName": string,
  "resourceType": enum (ChangeStatusResourceType),
  "resourceStatus": enum (ChangeStatusOperation),
  "sharedSet": string,
  "campaignSharedSet": string,
  "asset": string,
  "customerAsset": string,
  "campaignAsset": string,
  "adGroupAsset": string,
  "combinedAudience": string,
  "lastChangeDateTime": string,
  "campaign": string,
  "adGroup": string,
  "adGroupAd": string,
  "adGroupCriterion": string,
  "campaignCriterion": string,
  "feed": string,
  "feedItem": string,
  "adGroupFeed": string,
  "campaignFeed": string,
  "adGroupBidModifier": string
}
フィールド
resourceName

string

出力専用。変更ステータスのリソース名。変更ステータスのリソース名の形式は次のとおりです。

customers/{customerId}/changeStatus/{change_status_id}

resourceType

enum (ChangeStatusResourceType)

出力専用。変更されたリソースのタイプを表します。これにより、設定されるフィールドが決まります。たとえば AD_GROUP の場合、campaign フィールドと adGroup フィールドが設定されます。

resourceStatus

enum (ChangeStatusOperation)

出力専用。変更されたリソースのステータスを表します。

sharedSet

string

出力専用。この変更の影響を受ける SharedSet。

campaignSharedSet

string

出力専用。この変更の影響を受ける CampaignSharedSet。

asset

string

出力専用。この変更の影響を受けるアセット。

customerAsset

string

出力専用。この変更の影響を受ける CustomerAsset。

campaignAsset

string

出力専用。この変更の影響を受ける CampaignAsset。

adGroupAsset

string

出力専用。この変更の影響を受ける AdGroupAsset。

combinedAudience

string

出力専用。この変更の影響を受ける CombinedAudience。

lastChangeDateTime

string

出力専用。このリソースで最近行われた変更の時刻。

campaign

string

出力専用。この変更の影響を受けるキャンペーン。

adGroup

string

出力専用。この変更の影響を受ける広告グループ。

adGroupAd

string

出力専用。この変更の影響を受ける AdGroupAd。

adGroupCriterion

string

出力専用。この変更の影響を受ける AdGroupCriterion。

campaignCriterion

string

出力専用。この変更の影響を受ける CampaignCriterion。

feed

string

出力専用。この変更の影響を受けるフィード。

feedItem

string

出力専用。この変更の影響を受ける FeedItem。

adGroupFeed

string

出力専用。この変更の影響を受ける AdGroupFeed。

campaignFeed

string

出力専用。この変更の影響を受ける CampaignFeed。

adGroupBidModifier

string

出力専用。この変更の影響を受ける AdGroupBidModifier。

ChangeStatusResourceType

ChangeStatus リソースによってサポートされるリソースタイプをリストする列挙型。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な未分類のリソースを表します。
AD_GROUP 広告グループリソースの変更。
AD_GROUP_AD AdGroupAd リソースの変更。
AD_GROUP_CRITERION AdGroupCriterion リソースの変更。
CAMPAIGN キャンペーン リソースの変更。
CAMPAIGN_CRITERION CampaignCriterion リソースの変更。
FEED フィード リソースの変更。
FEED_ITEM FeedItem リソースの変更。
AD_GROUP_FEED AdGroupFeed リソースの変更。
CAMPAIGN_FEED CampaignFeed リソースの変更。
AD_GROUP_BID_MODIFIER AdGroupBidModifier リソースの変更。
SHARED_SET SharedSet リソースの変更。
CAMPAIGN_SHARED_SET CampaignSharedSet リソースの変更。
ASSET Asset リソースの変更。
CUSTOMER_ASSET CustomerAsset リソースの変更。
CAMPAIGN_ASSET CampaignAsset リソースの変更。
AD_GROUP_ASSET AdGroupAsset リソースの変更。
COMBINED_AUDIENCE CombinedAudience リソースの変更。

ChangeStatusOperation

変更されたリソースのステータス

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な未分類のリソースを表します。
ADDED リソースが作成されました。
CHANGED リソースが変更されました。
REMOVED リソースが削除されました。

CombinedAudience

異なるオーディエンスを含む組み合わせオーディエンスのリソースを記述します。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "status": enum (CombinedAudienceStatus),
  "name": string,
  "description": string
}
フィールド
resourceName

string

変更不可。組み合わせオーディエンスのリソース名。組み合わせオーディエンスの名前の形式は次のとおりです。

customers/{customerId}/combinedAudience/{combined_audience_id}

id

string (int64 format)

出力専用。組み合わせオーディエンスの ID。

status

enum (CombinedAudienceStatus)

出力専用。この組み合わせオーディエンスのステータス。組み合わせオーディエンスが有効か削除されているかを示します。

name

string

出力専用。組み合わせオーディエンスの名前。すべての組み合わせオーディエンスで一意である必要があります。

description

string

出力専用。この統合オーディエンスの説明。

CombinedAudienceStatus

組み合わせオーディエンスのステータス タイプを示す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED 有効なステータス - 組み合わせオーディエンスが有効で、ターゲットに設定できます。
REMOVED 「削除済み」ステータス - 統合オーディエンスが削除され、ターゲティングに使用できません。

ClickView

有効なクリックと無効なクリックの両方を含む、各クリックレベルで集計された指標が表示されたクリックビュー。検索以外のキャンペーンの場合、metrics.clicks は有効なインタラクションと無効なインタラクションの数を表します。ClickView を含むクエリには、結果を 1 日に制限するフィルタが必要で、リクエスト日時の 90 日前までさかのぼって日付をリクエストできます。

JSON 表現
{
  "resourceName": string,
  "areaOfInterest": {
    object (ClickLocation)
  },
  "locationOfPresence": {
    object (ClickLocation)
  },
  "keyword": string,
  "keywordInfo": {
    object (KeywordInfo)
  },
  "gclid": string,
  "pageNumber": string,
  "adGroupAd": string,
  "campaignLocationTarget": string,
  "userList": string
}
フィールド
resourceName

string

出力専用。クリックビューのリソース名。クリックビューのリソース名の形式は次のとおりです。

customers/{customerId}/clickViews/{date (yyyy-MM-dd)}~{gclid}

areaOfInterest

object (ClickLocation)

出力専用。インプレッションに関連付けられている対象領域に一致する位置情報の条件。

locationOfPresence

object (ClickLocation)

出力専用。インプレッションに関連付けられたユーザーの所在地に一致する地域条件。

keyword

string

出力専用。関連するキーワード(存在し、クリックが SEARCH チャネルに対応している場合)

keywordInfo

object (KeywordInfo)

出力専用。関連付けられているキーワードに関する基本情報(存在する場合)。

gclid

string

出力専用。Google クリック ID。

pageNumber

string (int64 format)

出力専用。広告が表示された検索結果のページ番号。

adGroupAd

string

出力専用。関連する広告。

campaignLocationTarget

string

出力専用。関連付けられたキャンペーンの対象地域(存在する場合)。

userList

string

出力専用。関連付けられているユーザーリスト(存在する場合)。

ClickLocation

クリックに関連付けられた地域の条件です。

JSON 表現
{
  "city": string,
  "country": string,
  "metro": string,
  "mostSpecific": string,
  "region": string
}
フィールド
city

string

インプレッションに関連付けられた都市の地域条件。

country

string

インプレッションに関連付けられている国 / 地域の条件。

metro

string

インプレッションに関連付けられた大都市圏の地域条件。

mostSpecific

string

インプレッションに関連付けられている最も詳細な地域条件。

region

string

インプレッションに関連付けられている地域の位置情報の条件。

CurrencyConstant

通貨定数。

JSON 表現
{
  "resourceName": string,
  "code": string,
  "name": string,
  "symbol": string,
  "billableUnitMicros": string
}
フィールド
resourceName

string

出力専用。通貨定数のリソース名。通貨定数リソース名の形式は次のとおりです。

currencyConstants/{code}

code

string

出力専用。ISO 4217 の 3 文字の通貨コード(「USD」など)

name

string

出力専用。通貨の英語の正式名称。

symbol

string

出力専用。この通貨を表す標準の記号(例: 米ドルの場合は「$」)。

billableUnitMicros

string (int64 format)

出力専用。この通貨の請求単位。請求金額は、この値の倍数にする必要があります。

AccessibleBiddingStrategy

顧客が所有し、共有している入札戦略のビューを表します。

BiddingStrategy とは異なり、このリソースには、お客様が所有する戦略に加えて、お客様のマネージャーが所有し、お客様と共有している戦略も含まれます。このリソースでは、指標は提供されず、 BiddingStrategy 属性の限定されたサブセットのみが公開されます。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
フィールド
resourceName

string

出力専用。アクセス可能な入札戦略のリソース名。AccessibleBidStrategy リソース名の形式は次のとおりです。

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}

id

string (int64 format)

出力専用。入札戦略の ID。

name

string

出力専用。入札戦略の名前。

type

enum (BiddingStrategyType)

出力専用。入札戦略のタイプ。

ownerCustomerId

string (int64 format)

出力専用。入札戦略を所有する顧客の ID。

ownerDescriptiveName

string

出力専用。入札戦略を所有するお客様の descriptiveName。

共用体フィールド scheme。入札スキーム。

設定できる値は 1 つだけです。scheme は次のいずれかになります。

maximizeConversionValue

object (MaximizeConversionValue)

出力専用。予算を消化しながらキャンペーンのコンバージョン値を最大化できる自動入札戦略。

maximizeConversions

object (MaximizeConversions)

出力専用。指定の予算を消化しつつキャンペーンのコンバージョン数を最大化できる自動入札戦略。

targetCpa

object (TargetCpa)

出力専用。指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が設定される入札戦略です。

targetImpressionShare

object (TargetImpressionShare)

出力専用。選択したインプレッションの割合を重視して自動的に最適化する入札戦略。

targetRoas

object (TargetRoas)

出力専用。特定の目標広告費用対効果(ROAS)を平均しながら収益を最大化できる入札戦略。

targetSpend

object (TargetSpend)

出力専用。予算内でクリック数を最大化できるように入札単価を設定する入札戦略です。

MaximizeConversionValue

予算を消化しながらキャンペーンのコンバージョン値を最大化できるよう、入札が自動化される入札戦略です。

JSON 表現
{
  "targetRoas": number
}
フィールド
targetRoas

number

出力専用。目標広告費用対効果(LTV)オプション。設定した場合、入札戦略では目標広告費用対効果を平均化しながら、収益を最大化します。目標広告費用対効果が高い場合、入札戦略では予算全額を使用できない可能性があります。目標広告費用対効果が設定されていない場合、入札戦略では予算に対して可能な限り高い広告費用対効果を達成することを目指します。

MaximizeConversions

指定の予算を消化しつつキャンペーンのコンバージョン数を最大化できる自動入札戦略。

JSON 表現
{
  "targetCpaMicros": string
}
フィールド
targetCpaMicros

string (int64 format)

出力専用。目標コンバージョン単価(CPA)オプション。これは、顧客獲得 1 回あたりに費やす平均金額です。

TargetCpa

指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が調整される自動入札戦略です。

JSON 表現
{
  "targetCpaMicros": string
}
フィールド
targetCpaMicros

string (int64 format)

出力専用。平均 CPA の目標値。この目標は、アカウントの通貨に基づき、請求可能な最小単位以上である必要があります。

TargetImpressionShare

検索広告の一定の割合が検索結果の 1 ページ目上部(または他の目標掲載位置)に表示されるように入札単価を設定する自動入札戦略。

JSON 表現
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
フィールド
location

enum (TargetImpressionShareLocation)

出力専用。検索結果ページの目標掲載位置。

locationFractionMicros

string (int64 format)

ターゲット地域に表示される広告の割合(マイクロ単位)。たとえば、1% は 10,000 です。

cpcBidCeilingMicros

string (int64 format)

出力専用。自動入札システムで指定できる、最も高いクリック単価。これは上限を設定する広告主が入力する必須項目で、ローカルのマイクロ秒単位で指定します。

TargetRoas

特定の目標広告費用対効果(ROAS)を平均しながら収益を最大化できる自動入札戦略。

JSON 表現
{
  "targetRoas": number
}
フィールド
targetRoas

number

出力専用。コンバージョン データに基づいて選択された費用単位あたりの収益。

TargetSpend

予算内でクリック数を最大化できるように入札単価を自動的に調整する自動入札戦略です。

JSON 表現
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
フィールド
targetSpendMicros
(deprecated)

string (int64 format)

出力専用。クリック数を最大化するための目標予算。目標予算の入札者は、この値と、自然なスロットリング予算額のうち、少ない方の金額を支出しようとします。指定しない場合、予算が目標予算として使用されます。このフィールドは非推奨のため使用不可です。詳しくは、https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html をご覧ください。

cpcBidCeilingMicros

string (int64 format)

出力専用。入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。

CustomerClient

特定のお客様とクライアント カスタマー間のリンク。CustomerClient は、マネージャー ユーザーにのみ存在します。直接的および間接的なクライアントのすべての顧客と、マネージャー自体が含まれます。

JSON 表現
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
フィールド
resourceName

string

出力専用。顧客クライアントのリソース名。CustomerClient リソース名の形式は customers/{customerId}/customerClients/{client_customer_id} です。

appliedLabels[]

string

出力専用。リクエスト元のお客様が所有し、クライアントのお客様に適用されているラベルのリソース名。ラベルのリソース名の形式は次のとおりです。

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

出力専用。クライアントのお客様のステータス。読み取り専用。

clientCustomer

string

出力専用。特定の顧客にリンクされているクライアント カスタマーのリソース名。読み取り専用。

hidden

boolean

出力専用。非表示のアカウントかどうかを指定します。読み取り専用。

level

string (int64 format)

出力専用。対象の顧客と顧客の距離セルフリンクの場合、レベル値は 0 になります。読み取り専用。

timeZone

string

出力専用。クライアントのタイムゾーンを表す Common Locale Data Repository(CLDR)文字列表現(America/Los_Angeles など)。読み取り専用。

testAccount

boolean

出力専用。クライアントがテスト アカウントかどうかを示します。読み取り専用。

manager

boolean

出力専用。クライアントがマネージャーかどうかを識別します。読み取り専用。

descriptiveName

string

出力専用。クライアントのわかりやすい名前です。読み取り専用。

currencyCode

string

出力専用。クライアントの通貨コード(「USD」、「EUR」など)。読み取り専用。

id

string (int64 format)

出力専用。クライアントのお客様の ID。読み取り専用。

CustomerSearchTermInsight

ユーザーの検索語句ビュー。過去のデータは 2023 年 3 月よりご利用いただけます。

JSON 表現
{
  "resourceName": string,
  "categoryLabel": string,
  "id": string
}
フィールド
resourceName

string

出力専用。顧客レベルの検索語句に関する分析情報のリソース名。顧客レベルの検索語句分析情報のリソース名の形式は次のとおりです。

customers/{customerId}/customerSearchTermInsights/{categoryId}

categoryLabel

string

出力専用。検索カテゴリのラベル。空の文字列は、他のカテゴリに該当しない検索語句のカテゴリをすべて含むカテゴリを表します。

id

string (int64 format)

出力専用。分析情報の ID。

DetailPlacementView

広告グループ別と URL 別または YouTube 動画別に集計された指標を含む視聴。

JSON 表現
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "groupPlacementTargetUrl": string,
  "targetUrl": string
}
フィールド
resourceName

string

出力専用。詳細プレースメント ビューのリソース名。詳細プレースメント ビューのリソース名の形式は次のとおりです。

customers/{customerId}/detailPlacementViews/{adGroupId}~{base64_placement}

placementType

enum (PlacementType)

出力専用。プレースメントのタイプ(ウェブサイト、YouTube 動画、モバイルアプリなど)。

placement

string

出力専用。詳細レベルでの自動プレースメントの文字列(例: ウェブサイトの URL、モバイルアプリ ID、YouTube 動画 ID)。

displayName

string

出力専用。表示名は、ウェブサイトの URL 名、YouTube 動画の YouTube 動画名、モバイルアプリの翻訳されたモバイルアプリ名です。

groupPlacementTargetUrl

string

出力専用。グループ プレースメントの URL(ドメイン、アプリストアのモバイルアプリへのリンク、YouTube チャンネルの URL など)。

targetUrl

string

出力専用。プレースメントの URL(ウェブサイト、アプリストア内のモバイルアプリへのリンク、YouTube 動画の URL など)。

PlacementType

フィード マッピングで使用可能なプレースメント タイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
WEBSITE ウェブサイト(「www.flowers4sale.com」など)。
MOBILE_APP_CATEGORY モバイル アプリケーションのカテゴリ(「ゲーム」など)。
MOBILE_APPLICATION モバイルアプリ(例: mobileapp::2-com.whatsthewordanswers)。
YOUTUBE_VIDEO YouTube 動画(「youtube.com/video/wtLJPvx7-ys」など)。
YOUTUBE_CHANNEL YouTube チャンネル(例: youtube.com::L8ZULXASCc1I_oaOT0NaOQ)。
GOOGLE_PRODUCTS Google が所有および運営するサーフェス(例: tv.google.com)。

DetailedDemographic

詳しいユーザー属性: 長年の生活習慣に基づいてユーザーにリーチするためにターゲティングする特定のインタレスト ベースの業種。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
フィールド
resourceName

string

出力専用。詳細なユーザー属性のリソース名。詳細なユーザー属性リソース名の形式は次のとおりです。

customers/{customerId}/detailedDemographics/{detailed_demographic_id}

id

string (int64 format)

出力専用。詳細なユーザー属性の ID。

name

string

出力専用。詳細なユーザー属性の名前。(例:「最終学歴」)

parent

string

出力専用。詳細のユーザー属性の親。

launchedToAll

boolean

出力専用。詳細なユーザー属性がすべてのチャンネルと言語 / 地域で提供されている場合は true。

availabilities[]

object (CriterionCategoryAvailability)

出力専用。詳細なユーザー属性の利用可能状況情報。

CriterionCategoryAvailability

広告チャネルごとの、カテゴリの可用性に関する情報。

JSON 表現
{
  "channel": {
    object (CriterionCategoryChannelAvailability)
  },
  "locale": [
    {
      object (CriterionCategoryLocaleAvailability)
    }
  ]
}
フィールド
channel

object (CriterionCategoryChannelAvailability)

カテゴリで使用できるチャンネル タイプとサブタイプ。

locale[]

object (CriterionCategoryLocaleAvailability)

チャンネルのカテゴリで使用できる言語 / 地域。

CriterionCategoryChannelAvailability

カテゴリを使用できる広告チャネル タイプとサブタイプの情報。

JSON 表現
{
  "availabilityMode": enum (CriterionCategoryChannelAvailabilityMode),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": [
    enum (AdvertisingChannelSubType)
  ],
  "includeDefaultChannelSubType": boolean
}
フィールド
availabilityMode

enum (CriterionCategoryChannelAvailabilityMode)

チャネルの可用性の形式。ALL_CHANNELS(残りのフィールドは設定されません)、CHANNEL_TYPE(advertisingChannelType タイプのみが設定され、そのカテゴリは、その下のすべてのサブタイプで使用できます)、CHANNEL_TYPE_AND_SUBTYPES(advertisingChannelType、advertisingChannelSubType、includeDefaultChannelSubType のすべてが設定されます)のいずれかです。

advertisingChannelType

enum (AdvertisingChannelType)

カテゴリを利用できるチャンネル タイプ。

advertisingChannelSubType[]

enum (AdvertisingChannelSubType)

カテゴリが使用できるチャネルタイプに含まれるチャネルのサブタイプ。

includeDefaultChannelSubType

boolean

デフォルトのチャンネル サブタイプが含まれているかどうか。たとえば、advertisingChannelType が DISPLAY、includeDefaultChannelSubType が false の場合、チャネル サブタイプが設定されていないデフォルトのディスプレイ キャンペーンは、この在庫状況設定に含まれていません。

CriterionCategoryChannelAvailabilityMode

有効な CriterionCategoryChannelAvailabilityMode を含む列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ALL_CHANNELS このカテゴリは、すべてのチャネル タイプとサブタイプのキャンペーンで使用できます。
CHANNEL_TYPE_AND_ALL_SUBTYPES このカテゴリは、特定のチャネルタイプ(下位のすべてのサブタイプを含む)のキャンペーンで使用できます。
CHANNEL_TYPE_AND_SUBSET_SUBTYPES このカテゴリは、特定のチャネルタイプとサブタイプのキャンペーンで使用できます。

CriterionCategoryLocaleAvailability

カテゴリが利用可能な言語 / 地域に関する情報。

JSON 表現
{
  "availabilityMode": enum (CriterionCategoryLocaleAvailabilityMode),
  "countryCode": string,
  "languageCode": string
}
フィールド
availabilityMode

enum (CriterionCategoryLocaleAvailabilityMode)

利用できる言語 / 地域の形式。LAUNCHED_TO_ALL(国と言語の両方が空)、COUNTRY(国のみ設定)、LANGUAGE(言語のみを設定)、COUNTRY_AND_LANGUAGE(国と言語の両方が設定されます)を指定できます。

countryCode

string

カテゴリに関連付けられた ISO-3166-1 alpha-2 の国コード。

languageCode

string

カテゴリに関連付けられた言語の ISO 639-1 コード。

CriterionCategoryLocaleAvailabilityMode

有効な CriterionCategoryLocaleAvailabilityMode を含む列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
ALL_LOCALES このカテゴリは、すべての言語 / 地域のキャンペーンで使用できます。
COUNTRY_AND_ALL_LANGUAGES このカテゴリは、言語に関係なく、リスト内の国 / 地域内のキャンペーンで使用できます。
LANGUAGE_AND_ALL_COUNTRIES このカテゴリは、国に関係なく、リスト内の言語リスト内のキャンペーンで使用できます。
COUNTRY_AND_LANGUAGE このカテゴリは、国と言語の組み合わせリスト内のキャンペーンで使用できます。

DisplayKeywordView

ディスプレイ ネットワークのキーワードのビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。ディスプレイ キーワード ビューのリソース名。ディスプレイ キーワード ビューのリソース名の形式は次のとおりです。

customers/{customerId}/displayKeywordViews/{adGroupId}~{criterionId}

DistanceView

広告主の住所表示オプションからのユーザーの距離別に集計された指標が表示される距離ビュー。各 DistanceBucket には、指定した距離内のすべてのインプレッションが含まれます。1 回のインプレッションが、ユーザーの距離を含むすべての DistanceBucket の指標にカウントされます。

JSON 表現
{
  "resourceName": string,
  "distanceBucket": enum (DistanceBucket),
  "metricSystem": boolean
}
フィールド
resourceName

string

出力専用。距離ビューのリソース名。距離ビューのリソース名の形式は次のとおりです。

customers/{customerId}/distanceViews/1~{distanceBucket}

distanceBucket

enum (DistanceBucket)

出力専用。住所表示オプションからのユーザーの距離をグループ化。

metricSystem

boolean

出力専用。DistanceBucket がメートル法を使用している場合は true、それ以外の場合は false。

DistanceBucket

広告主の住所表示オプションからの、ユーザーの距離の距離バケット。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
WITHIN_700M ユーザーがその場所から 700 m 以内にいた。
WITHIN_1KM ユーザーがその場所から 1 km 以内にいた。
WITHIN_5KM ユーザーがその場所から 5 km 以内にいた。
WITHIN_10KM お客様がその場所から 10 km 以内にいる。
WITHIN_15KM ユーザーがその場所から 15 km 以内にいた。
WITHIN_20KM ユーザーがその場所から 20 km 以内にいた。
WITHIN_25KM ユーザーがその場所から 25km 以内にいた。
WITHIN_30KM ユーザーがその場所から 30 km 以内にいた。
WITHIN_35KM ユーザーがその場所から 35 km 以内にいた。
WITHIN_40KM お客様が店舗から 40 km 以内にいる。
WITHIN_45KM ユーザーがその場所から 45km 以内にいた。
WITHIN_50KM お客様がその場所から 50 km 以内にいる。
WITHIN_55KM ユーザーがその場所から 55 km 以内にいた。
WITHIN_60KM お客様がその場所から 60 km 以内にいる。
WITHIN_65KM ユーザーがその場所から 65km 以内にいた。
BEYOND_65KM ユーザーが店舗の 65km を超えていた。
WITHIN_0_7MILES ユーザーがその場所から 1.1 km 以内にいた。
WITHIN_1MILE お客様が店舗から 1.6 km 以内にいる。
WITHIN_5MILES お客様が店舗から 8 キロメートル以内にいる。
WITHIN_10MILES ユーザーがその場所から 10 マイル以内にいる。
WITHIN_15MILES ユーザーがその場所から 25 マイル以内にいる。
WITHIN_20MILES ユーザーがその場所から 32 km 以内にいた。
WITHIN_25MILES ユーザーがその場所から 42 km 以内にいた。
WITHIN_30MILES お客様が店舗から 50 km 以内にいる。
WITHIN_35MILES ユーザーがその場所から 35 マイル以内にいる。
WITHIN_40MILES ユーザーがその場所から 40 マイル以内にいる。
BEYOND_40MILES お客様が拠点から 40 マイル以上離れている。

DynamicSearchAdsSearchTermView

動的検索広告の検索語句ビュー。

JSON 表現
{
  "resourceName": string,
  "searchTerm": string,
  "headline": string,
  "landingPage": string,
  "pageUrl": string,
  "hasNegativeKeyword": boolean,
  "hasMatchingKeyword": boolean,
  "hasNegativeUrl": boolean
}
フィールド
resourceName

string

出力専用。動的検索広告の検索語句ビューのリソース名。動的検索広告の検索語句ビューのリソース名の形式は次のとおりです。

customers/{customerId}/dynamicSearchAdsSearchTermViews/{adGroupId}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

searchTerm

string

出力専用。検索語句

このフィールドは読み取り専用です。

headline

string

出力専用。動的検索広告の動的に生成された広告見出し。

このフィールドは読み取り専用です。

landingPage

string

出力専用。動的に選択されたインプレッションのランディング ページ URL。

このフィールドは読み取り専用です。

pageUrl

string

出力専用。インプレッションに対して配信されたページフィード アイテムの URL。

このフィールドは読み取り専用です。

hasNegativeKeyword

boolean

出力専用。クエリが除外キーワードと一致する場合は true。

このフィールドは読み取り専用です。

hasMatchingKeyword

boolean

出力専用。検索語句がターゲット キーワードに追加されている場合、true になります。

このフィールドは読み取り専用です。

hasNegativeUrl

boolean

出力専用。クエリが除外 URL と一致する場合は true。

このフィールドは読み取り専用です。

ExpandedLandingPageView

拡張後の最終ページ URL レベルで集計された指標が表示されるランディング ページ ビュー。

JSON 表現
{
  "resourceName": string,
  "expandedFinalUrl": string
}
フィールド
resourceName

string

出力専用。展開後のランディング ページ ビューのリソース名。展開後のランディング ページビューのリソース名の形式は次のとおりです。

customers/{customerId}/expandedLandingPageViews/{expanded_final_url_fingerprint}

expandedFinalUrl

string

出力専用。クリックされたときに表示される最終ページ URL。

FeedPlaceholderView

フィード プレースホルダのビュー。

JSON 表現
{
  "resourceName": string,
  "placeholderType": enum (PlaceholderType)
}
フィールド
resourceName

string

出力専用。フィード プレースホルダ ビューのリソース名。フィード プレースホルダ ビューのリソース名の形式は次のとおりです。

customers/{customerId}/feedPlaceholderViews/{placeholderType}

placeholderType

enum (PlaceholderType)

出力専用。フィードのプレースホルダ ビューのプレースホルダ タイプ。

GenderView

性別ビュー。genderView リソースは、追加された条件ではなく、有効なサービス提供状態を反映しています。性別の条件がない広告グループは、デフォルトですべての性別で表示されるため、すべての性別が統計とともに genderView に表示されます。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。性別ビューのリソース名。性別ビューのリソース名の形式は次のとおりです。

customers/{customerId}/genderViews/{adGroupId}~{criterionId}

GeographicView

地図ビュー。

地理的ビューには、国レベルで集計されたすべての指標が国ごとに 1 行ずつ表示されます。ユーザーの実際の所在地、または関心のある地域に関する指標がレポートされます。他のセグメント フィールドを使用している場合は、国ごとに複数の行が返されることがあります。

JSON 表現
{
  "resourceName": string,
  "locationType": enum (GeoTargetingType),
  "countryCriterionId": string
}
フィールド
resourceName

string

出力専用。地理ビューのリソース名。地理ビューのリソース名の形式は次のとおりです。

customers/{customerId}/geographicViews/{countryCriterionId}~{locationType}

locationType

enum (GeoTargetingType)

出力専用。キャンペーンの地域ターゲティングのタイプ。

countryCriterionId

string (int64 format)

出力専用。国の条件 ID です。

GeoTargetingType

考えられる地域ターゲティング タイプです。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
AREA_OF_INTEREST ユーザーがクエリを実行する際に関心を持っている場所。
LOCATION_OF_PRESENCE クエリを発行したユーザーの所在地。

GroupPlacementView

グループ プレースメント ビュー。

JSON 表現
{
  "resourceName": string,
  "placementType": enum (PlacementType),
  "placement": string,
  "displayName": string,
  "targetUrl": string
}
フィールド
resourceName

string

出力専用。グループ プレースメント ビューのリソース名。グループ プレースメント ビューのリソース名の形式は次のとおりです。

customers/{customerId}/groupPlacementViews/{adGroupId}~{base64_placement}

placementType

enum (PlacementType)

出力専用。プレースメントの種類(ウェブサイト、YouTube チャンネル、モバイルアプリなど)。

placement

string

出力専用。グループレベルの自動プレースメント文字列(ウェブドメイン、モバイルアプリ ID、YouTube チャンネル ID など)。

displayName

string

出力専用。ウェブサイトのドメイン名と YouTube チャンネルの YouTube チャンネル名。

targetUrl

string

出力専用。グループ プレースメントの URL(ドメイン、アプリストアのモバイルアプリへのリンク、YouTube チャンネルの URL など)。

HotelGroupView

ホテルグループ ビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。ホテルグループ ビューのリソース名。ホテルグループ ビューのリソース名の形式は次のとおりです。

customers/{customerId}/hotelGroupViews/{adGroupId}~{criterionId}

HotelPerformanceView

ホテルの掲載結果ビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。ホテルのパフォーマンス ビューのリソース名。ホテルのパフォーマンス ビューのリソース名の形式は次のとおりです。

customers/{customerId}/hotelPerformanceView

HotelReconciliation

ホテルの調整。広告主様のレコードと照合するための、ホテル予約のコンバージョン情報が含まれています。これらの行は、一括アップロードによる請求の前に更新またはキャンセルされる場合があります。

JSON 表現
{
  "resourceName": string,
  "commissionId": string,
  "orderId": string,
  "campaign": string,
  "hotelCenterId": string,
  "hotelId": string,
  "checkInDate": string,
  "checkOutDate": string,
  "reconciledValueMicros": string,
  "billed": boolean,
  "status": enum (HotelReconciliationStatus)
}
フィールド
resourceName

string

変更不可。ホテルの調整のリソース名。ホテル調整のリソース名の形式は次のとおりです。

customers/{customerId}/hotelReconciliations/{commissionId}

commissionId

string

必須。出力専用。手数料 ID は、この予約に割り当てられる Google の ID です。すべての予約イベントに手数料 ID が割り当てられるため、ゲスト宿泊と照合しやすくなっています。

orderId

string

出力専用。オーダー ID は、コンバージョン トラッキング タグの「transaction_id」パラメータで指定した、この予約の識別子です。

campaign

string

出力専用。コンバージョンに関連付けられたキャンペーンのリソース名。

hotelCenterId

string (int64 format)

出力専用。ホテル キャンペーンの料金を指定する Hotel Center アカウントの識別子。

hotelId

string

出力専用。Hotel Center フィードで指定されている、予約された宿泊施設の一意の識別子。ホテル ID は、コンバージョン トラッキング タグの「ID」パラメータから取得されます。

checkInDate

string

出力専用。チェックイン日は予約時に記録されます。調整時にチェックイン日を変更した場合、この列の元の日付が、変更された日付に置き換わります。形式は YYYY-MM-DD です。

checkOutDate

string

出力専用。予約時に記録されたチェックアウト日。調整時にチェックイン日を変更した場合、この列の元の日付が、変更された日付に置き換わります。形式は YYYY-MM-DD です。

reconciledValueMicros

string (int64 format)

必須。出力専用。調整済みの値とは、予約に対して宿泊客が支払った最終的な金額です。なんらかの理由(旅行プランの変更や客室のアップセルなど)で元の予約額が変更された場合、最終的に回収された金額が調整済みの値となります。予約がキャンセルされた場合、調整済みの値には、請求されたキャンセル料や払い戻し不可の宿泊料金を含める必要があります。値は基本単位通貨の 100 万分の 1 です。たとえば、$12.35 は 12350000 として表されます。通貨単位は、お客様のデフォルトの通貨です。

billed

boolean

出力専用。該当の予約が請求済みかどうか。請求後は予約を変更できません。

status

enum (HotelReconciliationStatus)

必須。出力専用。調整と請求に関する予約の現在のステータス。予約の調整は、チェックアウト日から 45 日以内に行う必要があります。45 日以内に調整されなかった予約は、調整前の金額に基づいて請求が行われます。

HotelReconciliationStatus

ホテル予約の調整のステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
RESERVATION_ENABLED 予約日が将来の日付になっているか、宿泊が始まっているもののチェックアウト日は過ぎていません。有効な予約は調整できません。
RECONCILIATION_NEEDED チェックアウトが済んだか、キャンセルなしで予約日が過ぎています。チェックアウト日から 45 日以内に調整されなかった予約は、元の予約料金に基づいて請求が行われます。
RECONCILED これらの予約は調整されました。調整済みの予約の請求は、チェックアウト日から 45 日後に行われます。
CANCELED この予約はキャンセル済みに設定されています。値が 0 より大きいキャンセル済みの宿泊(最短滞在期間ルールやキャンセル料などの原因による)は、チェックアウト日から 45 日後に請求が行われます。

IncomeRangeView

収入の範囲ビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。収入の範囲ビューのリソース名。収入範囲ビューのリソース名の形式は次のとおりです。

customers/{customerId}/incomeRangeViews/{adGroupId}~{criterionId}

KeywordView

キーワード ビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。キーワード ビューのリソース名。キーワード ビューのリソース名の形式は次のとおりです。

customers/{customerId}/keywordViews/{adGroupId}~{criterionId}

LandingPageView

最終ページ URL レベルで集計された指標が表示されるランディング ページ ビュー。

JSON 表現
{
  "resourceName": string,
  "unexpandedFinalUrl": string
}
フィールド
resourceName

string

出力専用。ランディング ページビューのリソース名。ランディング ページ ビューのリソース名の形式は次のとおりです。

customers/{customerId}/landingPageViews/{unexpanded_final_url_fingerprint}

unexpandedFinalUrl

string

出力専用。広告主指定の最終ページ URL。

LanguageConstant

言語。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
フィールド
resourceName

string

出力専用。言語定数のリソース名。言語定数リソース名の形式は次のとおりです。

languageConstants/{criterionId}

id

string (int64 format)

出力専用。言語定数の ID。

code

string

出力専用。言語コード(「en_US」、「en_AU」、「es」、「fr」など)。

name

string

出力専用。英語の正式名称(「英語(米国)」「スペイン語」など)。

targetable

boolean

出力専用。言語をターゲットに設定できるかどうか。

LocationView

地域ビューには、地域条件別のキャンペーンのパフォーマンスの概要が表示されます。Location 条件が設定されていない場合、結果は返されません。代わりに、ユーザーの位置情報を確認するには、GeographicView または userLocationView を使用します。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。ロケーション ビューのリソース名。ロケーション ビューのリソース名の形式は次のとおりです。

customers/{customerId}/locationViews/{campaignId}~{criterionId}

ManagedPlacementView

手動プレースメント ビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。手動プレースメント ビューのリソース名。マネージド プレースメント ビューのリソース名の形式は次のとおりです。

customers/{customerId}/managedPlacementViews/{adGroupId}~{criterionId}

MediaFile

メディア ファイル。

JSON 表現
{
  "resourceName": string,
  "type": enum (MediaType),
  "mimeType": enum (MimeType),
  "id": string,
  "sourceUrl": string,
  "name": string,
  "fileSize": string,

  // Union field mediatype can be only one of the following:
  "image": {
    object (MediaImage)
  },
  "mediaBundle": {
    object (MediaBundle)
  },
  "audio": {
    object (MediaAudio)
  },
  "video": {
    object (MediaVideo)
  }
  // End of list of possible types for union field mediatype.
}
フィールド
resourceName

string

変更不可。メディア ファイルのリソース名。メディア ファイルのリソース名の形式は次のとおりです。

customers/{customerId}/mediaFiles/{media_file_id}

type

enum (MediaType)

変更不可。メディア ファイルのタイプ。

mimeType

enum (MimeType)

出力専用。メディア ファイルの MIME タイプ。

id

string (int64 format)

出力専用。メディア ファイルの ID。

sourceUrl

string

変更不可。元のメディア ファイルをダウンロードした URL(またはファイル名)。AUDIO タイプと IMAGE タイプのメディアにのみ使用されます。

name

string

変更不可。メディア ファイルの名前。クライアントはこの名前を使用して、以前にアップロードされたメディアを識別できます。

fileSize

string (int64 format)

出力専用。メディア ファイルのサイズ(バイト単位)。

共用体フィールド mediatype。メディア ファイルの特定のタイプ。mediatype は次のいずれかになります。
image

object (MediaImage)

変更不可。画像をカプセル化します。

mediaBundle

object (MediaBundle)

変更不可。コンテンツが HTML5 アセットを含む ZIP アーカイブ メディア。

audio

object (MediaAudio)

出力専用。Audio をカプセル化します。

video

object (MediaVideo)

変更不可。動画をカプセル化します。

MediaType

メディアの種類。

列挙型
UNSPECIFIED メディアタイプが指定されていません。
UNKNOWN

このバージョンでは、受信した値は不明です。

これはレスポンス専用の値です。

IMAGE イメージ広告に使用される静止画像。
ICON マップ広告に使用される小さい画像。
MEDIA_BUNDLE ZIP ファイル。テンプレート広告のフィールドで使用されます。
AUDIO 音声ファイル。
VIDEO 動画ファイル。
DYNAMIC_IMAGE アニメーション GIF などのアニメーション画像。

MediaImage

画像をカプセル化します。

JSON 表現
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
フィールド
data

string (bytes format)

変更不可。RAW 画像データ。

Base64 でエンコードされた文字列。

fullSizeImageUrl

string

出力専用。画像のフルサイズの URL。

previewSizeImageUrl

string

出力専用。画像のプレビューサイズ バージョンの URL。

MediaBundle

コンテンツが HTML5 アセットを含む ZIP アーカイブ メディアを表します。

JSON 表現
{
  "data": string,
  "url": string
}
フィールド
data

string (bytes format)

変更不可。未加工の圧縮データ。

Base64 でエンコードされた文字列。

url

string

出力専用。アップロードされた ZIP 圧縮データにアクセスするための URL。たとえば、https://tpc.googlesyndication.com/simgad/123 です。このフィールドは読み取り専用です。

MediaAudio

Audio をカプセル化します。

JSON 表現
{
  "adDurationMillis": string
}
フィールド
adDurationMillis

string (int64 format)

出力専用。音声の再生時間(ミリ秒単位)。

MediaVideo

動画をカプセル化します。

JSON 表現
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
フィールド
adDurationMillis

string (int64 format)

出力専用。動画の再生時間(ミリ秒単位)。

youtubeVideoId

string

変更不可。YouTube 動画 ID(YouTube の URL で確認できます)。この ID に接頭辞「https://www.youtube.com/watch?v=」を追加すると、その動画の YouTube ストリーミング URL が取得されます。

advertisingIdCode

string

出力専用。この動画の広告デジタル識別コードは、アメリカ広告代理店協会によって定義され、主にテレビコマーシャルに使用されます。

isciCode

string

出力専用。この動画の業界標準の商業識別子コード。主にテレビコマーシャルに使用されます。

LocalServicesEmployee

ローカル サービスの従業員リソース。

JSON 表現
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesEmployeeStatus),
  "type": enum (LocalServicesEmployeeType),
  "universityDegrees": [
    {
      object (UniversityDegree)
    }
  ],
  "residencies": [
    {
      object (Residency)
    }
  ],
  "fellowships": [
    {
      object (Fellowship)
    }
  ],
  "languagesSpoken": [
    string
  ],
  "categoryIds": [
    string
  ],
  "id": string,
  "jobTitle": string,
  "yearStartedPracticing": integer,
  "nationalProviderIdNumber": string,
  "emailAddress": string,
  "firstName": string,
  "middleName": string,
  "lastName": string
}
フィールド
resourceName

string

変更不可。ローカル サービス確認のリソース名。Local Services Verification リソース名の形式は次のとおりです。

customers/{customerId}/localServicesEmployees/{gls_employee_id}

creationDateTime

string

出力専用。社員の作成時のタイムスタンプ。形式は「YYYY-MM-DD HH:MM:SS」です(Google 広告アカウントのタイムゾーンを使用します)。例: 「2018-03-05 09:15:00」、「2018-02-01 14:34:30」

status

enum (LocalServicesEmployeeStatus)

出力専用。DELETED や ENABLED などの従業員ステータス。

type

enum (LocalServicesEmployeeType)

出力専用。従業員タイプ。

universityDegrees[]

object (UniversityDegree)

出力専用。社員が取得した学位のリスト(表示する学位のみ)。

residencies[]

object (Residency)

出力専用。従業員が入国を終えた教育機関。

fellowships[]

object (Fellowship)

出力専用。従業員がフェローシップを完了した教育機関。

languagesSpoken[]

string

出力専用。従業員が話している言語。https://developers.google.com/admin-sdk/directory/v1/languages の言語タグで表します。

categoryIds[]

string

出力専用。社員のカテゴリ。ローカル サービス カテゴリ ID のリストについては、https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids をご覧ください。

id

string (int64 format)

出力専用。社員の ID。

jobTitle

string

出力専用。この従業員の役職(法務分野の「シニア パートナー」など)。

yearStartedPracticing

integer

出力専用。この従業員がこの分野で実務を開始した年。

nationalProviderIdNumber

string

出力専用。社員に関連付けられた NPI ID。

emailAddress

string

出力専用。従業員のメールアドレス。

firstName

string

出力専用。社員の名(ファースト ネーム)。

middleName

string

出力専用。従業員のミドルネーム。

lastName

string

出力専用。従業員の姓。

LocalServicesEmployeeStatus

ローカル サービスの従業員のステータスを表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
ENABLED 従業員は削除されず、従業員のステータスは有効です。
REMOVED 社員が削除されます。ビジネスから従業員を削除するために使用されます。

LocalServicesEmployeeType

ローカル サービスの従業員のタイプを表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
BUSINESS_OWNER ビジネスのオーナーを表します。
EMPLOYEE ビジネスの従業員を表します。

UniversityDegree

この従業員が取得し、取り上げたい学位のリスト。

JSON 表現
{
  "institutionName": string,
  "degree": string,
  "graduationYear": integer
}
フィールド
institutionName

string

出力専用。学位を取得した大学の名前。

degree

string

出力専用。取得した学位の名前。

graduationYear

integer

出力専用。卒業年。

居住権

従業員の医療所在地に関する詳細。レジデンシーは、有資格の医療従事者が上級臨床医の監督下で実務を行う、卒業後の医学教育の段階です。

JSON 表現
{
  "institutionName": string,
  "completionYear": integer
}
フィールド
institutionName

string

出力専用。入国を完了した教育機関の名前。

completionYear

integer

出力専用。修了年。

交流

この従業員のメディカル フェローシップに関する詳細。フェローシップは、研修終了後に専門家が実施する医学トレーニングの期間です。

JSON 表現
{
  "institutionName": string,
  "completionYear": integer
}
フィールド
institutionName

string

出力専用。研究を完了した教育機関の名前。

completionYear

integer

出力専用。完了年。

LocalServicesVerificationArtifact

ローカル サービスの確認リソース。

JSON 表現
{
  "resourceName": string,
  "creationDateTime": string,
  "status": enum (LocalServicesVerificationArtifactStatus),
  "artifactType": enum (LocalServicesVerificationArtifactType),
  "id": string,

  // Union field artifact_data can be only one of the following:
  "backgroundCheckVerificationArtifact": {
    object (BackgroundCheckVerificationArtifact)
  },
  "insuranceVerificationArtifact": {
    object (InsuranceVerificationArtifact)
  },
  "licenseVerificationArtifact": {
    object (LicenseVerificationArtifact)
  },
  "businessRegistrationCheckVerificationArtifact": {
    object (BusinessRegistrationCheckVerificationArtifact)
  }
  // End of list of possible types for union field artifact_data.
}
フィールド
resourceName

string

変更不可。ローカル サービス確認のリソース名。Local Services Verification リソース名の形式は次のとおりです。

customers/{customerId}/localServicesVerificationArtifacts/{verification_artifact_id}

creationDateTime

string

出力専用。この検証アーティファクトが作成されたときのタイムスタンプ。形式は、Google 広告アカウントのタイムゾーンにおける「YYYY-MM-DD HH:MM:SS」です。例: "2018-03-05 09:15:00"、"2018-02-01 14:34:30"

status

enum (LocalServicesVerificationArtifactStatus)

出力専用。検証アーティファクトのステータス。

artifactType

enum (LocalServicesVerificationArtifactType)

出力専用。検証アーティファクトのタイプ。

id

string (int64 format)

出力専用。検証アーティファクトの ID。

共用体フィールド artifact_data。確認情報のタイプ。artifact_data は次のいずれかになります。
backgroundCheckVerificationArtifact

object (BackgroundCheckVerificationArtifact)

出力専用。バックグラウンド チェックの確認アーティファクト。

insuranceVerificationArtifact

object (InsuranceVerificationArtifact)

出力専用。保険の確認アーティファクト。

licenseVerificationArtifact

object (LicenseVerificationArtifact)

出力専用。ライセンス確認アーティファクト。

businessRegistrationCheckVerificationArtifact

object (BusinessRegistrationCheckVerificationArtifact)

出力専用。事業登録確認の確認アーティファクト。

LocalServicesVerificationArtifactStatus

ローカル サービスの検証アーティファクトのステータスを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
PASSED アーティファクトが検証に合格しました。
FAILED アーティファクトの検証で不合格になりました。
PENDING アーティファクトは検証中です。
NO_SUBMISSION アーティファクトは、検証される前にユーザーが情報をアップロードする必要があります。
CANCELLED アーティファクトがユーザーによってキャンセルされました。

LocalServicesVerificationArtifactType

ローカル サービスの検証アーティファクトの種類を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BACKGROUND_CHECK バックグラウンド チェックの検証アーティファクト。
INSURANCE 保険の確認アーティファクト。
LICENSE ライセンス確認アーティファクト。
BUSINESS_REGISTRATION_CHECK 事業登録チェックの検証アーティファクト。

BackgroundCheckVerificationArtifact

ローカル サービスのバックグラウンド チェックに固有の情報を保持する proto。

JSON 表現
{
  "caseUrl": string,
  "finalAdjudicationDateTime": string
}
フィールド
caseUrl

string

出力専用。バックグラウンド ケースにアクセスするための URL。

finalAdjudicationDateTime

string

出力専用。このバックグラウンド チェックのケースの結果が承認されたときのタイムスタンプ。形式は「YYYY-MM-DD HH:MM:SS」です(Google 広告アカウントのタイムゾーンを使用します)。例: 「2018-03-05 09:15:00」、「2018-02-01 14:34:30」

InsuranceVerificationArtifact

ローカル サービス保険に固有の情報を保持する proto。

JSON 表現
{
  "amountMicros": string,
  "rejectionReason": enum (LocalServicesInsuranceRejectionReason),
  "insuranceDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
フィールド
amountMicros

string (int64 format)

出力専用。保険金額。これは、保険証書に記載されている通貨の「マイクロ」単位で測定されます。

rejectionReason

enum (LocalServicesInsuranceRejectionReason)

出力専用。保険証書の不承認の理由。

insuranceDocumentReadonly

object (LocalServicesDocumentReadOnly)

出力専用。アップロードされた保険証書の情報を含む読み取り専用フィールド。

LocalServicesInsuranceRejectionReason

ローカル サービス保険の確認アーティファクトが拒否される理由を表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BUSINESS_NAME_MISMATCH ビジネス名がローカル サービス広告のビジネス名と一致していません。
INSURANCE_AMOUNT_INSUFFICIENT 保険金額が、その地域とカテゴリ ID の組み合わせに関する法律概要のドキュメントに記載されている要件を満たしていません。
EXPIRED 保険証書の有効期限が切れています。
NO_SIGNATURE 保険証書に署名がありません。
NO_POLICY_NUMBER 保険証書に保険証券番号が記載されていません。
NO_COMMERCIAL_GENERAL_LIABILITY 保険証書で Commercial General Liability(CGL)ボックスがマークされていない。
EDITABLE_FORMAT 保険証書が編集可能な形式です。
CATEGORY_MISMATCH 保険証書は、特定のカテゴリの保険を対象としていません。
MISSING_EXPIRATION_DATE 保険証明書に有効期限が記載されていません。
POOR_QUALITY 保険証明書の品質が低い(画像が不鮮明、判読できないなど)
POTENTIALLY_EDITED 保険証券が改ざんされている疑いがある。
WRONG_DOCUMENT_TYPE 保険証書が承認されませんでした。たとえば、保険提案の書類で、保険の保障がないような書類は受け付けられません。
NON_FINAL 保険証明書が最終的なものではない。
OTHER 保険証書に明記されていない別の欠陥があります。

LocalServicesDocumentReadOnly

読み取り専用データを含むローカル サービス ドキュメント。

JSON 表現
{
  "documentUrl": string
}
フィールド
documentUrl

string

すでにアップロードされているローカル サービス ドキュメントにアクセスするための URL。

LicenseVerificationArtifact

ローカル サービス ライセンスに固有の情報を保持するプロト。

JSON 表現
{
  "licenseType": string,
  "licenseNumber": string,
  "licenseeFirstName": string,
  "licenseeLastName": string,
  "rejectionReason": enum (LocalServicesLicenseRejectionReason),
  "licenseDocumentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
フィールド
licenseType

string

出力専用。ライセンスの種類または名前。

licenseNumber

string

出力専用。ライセンス番号。

licenseeFirstName

string

出力専用。ライセンシーの名(ファースト ネーム)。

licenseeLastName

string

出力専用。ライセンシーの姓。

rejectionReason

enum (LocalServicesLicenseRejectionReason)

出力専用。ライセンス拒否の理由。

licenseDocumentReadonly

object (LocalServicesDocumentReadOnly)

出力専用。アップロードしたライセンス ドキュメントの情報を含む読み取り専用フィールド。

LocalServicesLicenseRejectionReason

ローカル サービス ライセンス確認アーティファクトの不承認の理由として考えられるものを記述した列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BUSINESS_NAME_MISMATCH ビジネス名がローカル サービス広告のビジネス名と一致していません。
UNAUTHORIZED ライセンスが承認されていないか、ライセンスが取り消されています。
EXPIRED ライセンスの有効期限が切れています。
POOR_QUALITY ライセンスの画質が悪い - 画像がぼやけている、判読できないなど
UNVERIFIABLE 正規の画像ではないため、ライセンスを確認できません。
WRONG_DOCUMENT_OR_ID ライセンスは、リクエストされたドキュメントの種類ではないか、無効な ID が含まれています。
OTHER ライセンスに明示されていない別の欠陥があります。

BusinessRegistrationCheckVerificationArtifact

ローカル サービス ビジネスの登録チェックに固有の情報を保持する proto。

JSON 表現
{
  "registrationType": enum (LocalServicesBusinessRegistrationType),
  "checkId": string,
  "rejectionReason": enum (LocalServicesBusinessRegistrationCheckRejectionReason),

  // Union field business_registration can be only one of the following:
  "registrationNumber": {
    object (BusinessRegistrationNumber)
  },
  "registrationDocument": {
    object (BusinessRegistrationDocument)
  }
  // End of list of possible types for union field business_registration.
}
フィールド
registrationType

enum (LocalServicesBusinessRegistrationType)

出力専用。事業登録チェックの種類(番号、書類)。

checkId

string

出力専用。「VAT 税 ID」の要件を表すチェックの ID(vat_tax_id など)。

rejectionReason

enum (LocalServicesBusinessRegistrationCheckRejectionReason)

出力専用。登録書類の不承認の理由。

共用体フィールド business_registration。法人登録の登録情報。さまざまな国の要件に応じて、次のいずれかのフォームを使用します。business_registration は次のいずれかになります。
registrationNumber

object (BusinessRegistrationNumber)

出力専用。ビジネスの政府機関発行番号を保存するメッセージ。

registrationDocument

object (BusinessRegistrationDocument)

出力専用。ビジネスのドキュメント情報を保存するメッセージ。

LocalServicesBusinessRegistrationType

ローカル サービス ビジネスの登録チェックの検証アーティファクトの有効な登録タイプを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
NUMBER 登録番号のチェックタイプ。
DOCUMENT 登録書類の確認タイプ。

LocalServicesBusinessRegistrationCheckRejectionReason

ローカル サービスの事業登録チェックの検証アーティファクトが拒否される理由を示す列挙型です。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BUSINESS_NAME_MISMATCH ビジネスの名前が、ローカル サービス広告のビジネスの名前と一致しません。
BUSINESS_DETAILS_MISMATCH ビジネスの詳細が一致しません。
ID_NOT_FOUND 法人登録 ID が見つかりません。
POOR_DOCUMENT_IMAGE_QUALITY アップロードした書類が不鮮明、不鮮明など
DOCUMENT_EXPIRED アップロードした書類は有効期限が切れています。
DOCUMENT_INVALID 書類が取り消された、または無効になった。
DOCUMENT_TYPE_MISMATCH ドキュメントの種類が一致しません。
DOCUMENT_UNVERIFIABLE アップロードされた書類が正当なものであることを確認できませんでした。
OTHER 問題により、事業登録プロセスを完了できませんでした。詳しくは、https://support.google.com/localservices をご覧ください。

BusinessRegistrationNumber

ローカル サービス事業者登録番号に固有の情報を保持するプロト。

JSON 表現
{
  "number": string
}
フィールド
number

string

出力専用。政府機関が発行したビジネスの番号です。

BusinessRegistrationDocument

ローカル サービス事業登録書類に固有の情報を保持するプロト。

JSON 表現
{
  "documentReadonly": {
    object (LocalServicesDocumentReadOnly)
  }
}
フィールド
documentReadonly

object (LocalServicesDocumentReadOnly)

出力専用。アップロードされた法人登記証明書の情報を含む読み取り専用フィールド。

MobileAppCategoryConstant

モバイルアプリのカテゴリ定数。

JSON 表現
{
  "resourceName": string,
  "id": integer,
  "name": string
}
フィールド
resourceName

string

出力専用。モバイルアプリ カテゴリ定数のリソース名。モバイルアプリ カテゴリの定数リソース名の形式は次のとおりです。

mobileAppCategoryConstants/{mobile_app_category_id}

id

integer

出力専用。モバイルアプリ カテゴリ定数の ID。

name

string

出力専用。モバイルアプリのカテゴリ名です。

MobileDeviceConstant

モバイル デバイスの定数。

JSON 表現
{
  "resourceName": string,
  "type": enum (MobileDeviceType),
  "id": string,
  "name": string,
  "manufacturerName": string,
  "operatingSystemName": string
}
フィールド
resourceName

string

出力専用。モバイル デバイス定数のリソース名。モバイル デバイスの定数リソース名の形式は次のとおりです。

mobileDeviceConstants/{criterionId}

type

enum (MobileDeviceType)

出力専用。モバイル デバイスのタイプ。

id

string (int64 format)

出力専用。モバイル デバイス定数の ID。

name

string

出力専用。モバイル デバイスの名前。

manufacturerName

string

出力専用。モバイル デバイスのメーカー。

operatingSystemName

string

出力専用。モバイル デバイスのオペレーティング システム。

MobileDeviceType

モバイル デバイスの種類。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
MOBILE スマートフォン。
TABLET タブレット

OfflineConversionUploadClientSummary

顧客単位のオフライン コンバージョン アップロードの概要。

JSON 表現
{
  "resourceName": string,
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionAlert)
    }
  ]
}
フィールド
resourceName

string

出力専用。顧客レベルのオフライン コンバージョン アップロードの概要のリソース名。オフライン コンバージョンのアップロード クライアント概要のリソース名の形式は次のとおりです。

customers/{customerId}/offlineConversionUploadClientSummaries/{client}

client

enum (OfflineEventUploadClient)

出力専用。アップロード イベントのクライアント タイプ。

status

enum (OfflineConversionDiagnosticStatus)

出力専用。オフライン コンバージョン クライアントの概要の全体的なステータス。ステータスは、アップロードの統計情報を含む最新の暦日に基づいて生成されます。

totalEventCount

string (int64 format)

出力専用。アップロードされたイベントの合計数。

successfulEventCount

string (int64 format)

出力専用。正常にアップロードされたイベントの合計数。

successRate

number

出力専用。成功率。

lastUploadDateTime

string

出力専用。最新のアップロード バッチの日付。形式は「yyyy-mm-dd hh:mm:ss」で、Google 広告アカウントのタイムゾーンを使用します。

dailySummaries[]

object (OfflineConversionSummary)

出力専用。過去 N 日間の履歴データの概要。

jobSummaries[]

object (OfflineConversionSummary)

出力専用。直近 N 個のジョブ別の履歴統計情報のサマリー。

alerts[]

object (OfflineConversionAlert)

出力専用。各エラーコードの詳細。アラートは、アップロードの統計情報を含む直近の暦日から生成されます。

OfflineEventUploadClient

クライアントの種類。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
GOOGLE_ADS_API Google Ads API。
GOOGLE_ADS_WEB_CLIENT Google 広告ウェブ クライアント(Google 広告の管理画面、SFTP など、複数のソースが含まれる場合があります)。
ADS_DATA_CONNECTOR 接続プラットフォーム。

OfflineConversionDiagnosticStatus

オフライン データを取り込む設定に関して考えられるステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
EXCELLENT オフライン データを取り込む設定が有効で、ダウンストリーム処理に最適です。
GOOD オフライン データを取り込む設定が有効ですが、さらに改善の余地があります。アラートを確認する。
NEEDS_ATTENTION オフライン データを取り込む設定が有効ですが、注意が必要なエラーがあります。アラートを確認する。
NO_RECENT_UPLOAD オフライン データを取り込む設定では、過去 28 日間にデータが受信されていません。なんらかの問題がある可能性があります。

OfflineConversionSummary

過去のアップロードの概要(アップロード日またはジョブ別にグループ化)。

JSON 表現
{
  "successfulCount": string,
  "failedCount": string,

  // Union field dimension_key can be only one of the following:
  "jobId": string,
  "uploadDate": string
  // End of list of possible types for union field dimension_key.
}
フィールド
successfulCount

string (int64 format)

出力専用。成功したイベントの合計数。

failedCount

string (int64 format)

出力専用。失敗したイベントの合計数。

共用体フィールド dimension_key。サマリーのディメンション キー。dimension_key は次のいずれかになります。
jobId

string (int64 format)

出力専用。過去 N 件のジョブのディメンション キー。

uploadDate

string

出力専用。過去 N 日間のディメンション キー。

OfflineConversionAlert

オフライン コンバージョンのクライアントの概要に関するアラート。

JSON 表現
{
  "error": {
    object (OfflineConversionError)
  },
  "errorPercentage": number
}
フィールド
error

object (OfflineConversionError)

出力専用。オフライン コンバージョン クライアント アラートのエラー。

errorPercentage

number

出力専用。エラーの割合。このフィールドの範囲は [0, 1.0] にする必要があります。

OfflineConversionError

オフライン コンバージョンのクライアントの概要で考えられるエラー。

JSON 表現
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
フィールド
共用体フィールド error_code。説明のエラー。error_code は次のいずれかになります。
collectionSizeError

enum (CollectionSizeError)

出力専用。コレクション サイズのエラーです。

conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

出力専用。コンバージョン調整のアップロード エラーです。

conversionUploadError

enum (ConversionUploadError)

出力専用。コンバージョンのアップロード エラー。

dateError

enum (DateError)

出力専用。日付エラー。

distinctError

enum (DistinctError)

出力専用。明らかなエラー。

fieldError

enum (FieldError)

出力専用。フィールド エラーです。

mutateError

enum (MutateError)

出力専用。変更エラーが発生しました。

notAllowlistedError

enum (NotAllowlistedError)

出力専用。許可リストに登録されていないエラー。

stringFormatError

enum (StringFormatError)

出力専用。文字列の形式に誤りがあります。

stringLengthError

enum (StringLengthError)

出力専用。文字列の長さにエラーがあります。

CollectionSizeError

収集サイズで発生する可能性のあるエラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型が指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
TOO_FEW 人数が少なすぎます。
TOO_MANY 多すぎます。

ConversionAdjustmentUploadError

コンバージョン調整のアップロードで発生する可能性のあるエラーを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
TOO_RECENT_CONVERSION_ACTION 作成したコンバージョン アクションにイベントをインポートできません。6 時間後にもう一度インポートをお試しください。
CONVERSION_ALREADY_RETRACTED コンバージョンはすでに撤回されています。この調整は処理されませんでした。
CONVERSION_NOT_FOUND このコンバージョン アクションとコンバージョン ID のコンバージョンが見つかりません。コンバージョン ID が正しいコンバージョン アクションに関連付けられていることを確認してから、もう一度お試しください。
CONVERSION_EXPIRED 発生から 54 日以上経過しているコンバージョンは調整できません。
ADJUSTMENT_PRECEDES_CONVERSION 調整に、関連するコンバージョンの前に adjustmentDateTime が発生しました。adjustmentDateTime が正しいことを確認してから、もう一度お試しください。
MORE_RECENT_RESTATEMENT_FOUND 関連付けられたコンバージョンについて、より近い調整 adjustmentDateTime がすでに報告されています。調整 adjustmentDateTime が正しいことを確認してから、もう一度お試しください。
TOO_RECENT_CONVERSION コンバージョンの発生が最近すぎるため、調整を記録できません。発生から 24 時間以上経過しているコンバージョンを調整してみてください。
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE デフォルト値を使用するよう設定されているコンバージョンは調整できません。コンバージョン アクションの値の設定を確認してから、もう一度お試しください。
TOO_MANY_ADJUSTMENTS_IN_REQUEST 1 回の API リクエストでアップロードする調整は 2,001 件未満にしてください。
TOO_MANY_ADJUSTMENTS コンバージョンの調整回数が上限に達しています。既存のコンバージョンに必要な調整のみを行ってください。
RESTATEMENT_ALREADY_EXISTS コンバージョンの以前の修正で同じ adjustmentDateTime が使用されています。調整に正しい固有の adjustmentDateTime が指定されていることを確認してから、もう一度お試しください。
DUPLICATE_ADJUSTMENT_IN_REQUEST インポートされた調整に、adjustmentDateTimeが同一のコンバージョンの調整が重複しています。調整の adjustmentDateTime が正しいことを確認してから、もう一度お試しください。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS コンバージョン設定で顧客データの処理に関する規約に同意していることを確認してから、もう一度お試しください。
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT 指定したコンバージョン アクションでは拡張コンバージョンを使用できません。
INVALID_USER_IDENTIFIER ユーザー提供データは SHA-256 でハッシュ化し、ガイドラインに沿って正規化してください。
UNSUPPORTED_USER_IDENTIFIER SHA-256 を使用してハッシュ化されたメールアドレスや電話番号などのユーザー提供データを使用して、もう一度お試しください。
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET gclidDateTimePair と orderId の両方を設定することはできません。どちらか一方を使用してもう一度お試しください。
CONVERSION_ALREADY_ENHANCED コンバージョンに、同じオーダー ID とコンバージョン アクションの拡張がすでにあります。データが正しく設定されていることを確認してから、もう一度お試しください。
DUPLICATE_ENHANCEMENT_IN_REQUEST 同じコンバージョン アクションとオーダー ID の拡張が複数あります。データが正しく設定されていることを確認してから、もう一度お試しください。
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT Google の顧客データに関するポリシーにより、このアカウントでは拡張コンバージョンを使用できません。Google 担当者に連絡する。
MISSING_ORDER_ID_FOR_WEBPAGE ウェブサイト コンバージョンの調整には、オーダー ID(トランザクション ID)が必要です。ウェブサイトのタグによってオーダー ID が取得されていることを確認し、調整で同じオーダー ID を送信してください。
ORDER_ID_CONTAINS_PII 個人を特定できる情報(PII)を含むオーダー ID では調整を使用できません。
INVALID_JOB_ID リクエストで指定されたジョブ ID が許可された範囲内にありません。ジョブ ID は「1, 2^31」の範囲の正の整数で指定してください。
NO_CONVERSION_ACTION_FOUND 調整リクエストで指定されたコンバージョン アクションが見つかりません。このアカウントで使用できることを確認してください。
INVALID_CONVERSION_ACTION_TYPE 調整リクエストで指定されたコンバージョン アクションのタイプは、調整のアップロードに対応していません。RETRACTION または RESTATEMENT のコンバージョン調整タイプは、SALESFORCEUPLOAD_CLICKWEBPAGE のコンバージョン アクション タイプでのみ使用できます。ENHANCEMENT タイプのコンバージョン調整は、WEBPAGE タイプのコンバージョン アクションでのみ使用できます。

ConversionUploadError

発生する可能性のあるコンバージョンのアップロード エラーを表す列挙型。

列挙型
UNSPECIFIED 列挙型が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
TOO_MANY_CONVERSIONS_IN_REQUEST 1 回のリクエストでアップロードするイベントの数は 2,001 個未満です。
UNPARSEABLE_GCLID インポートされた GCLID をデコードできませんでした。クリック ID が変更されていないことを確認してください。
CONVERSION_PRECEDES_EVENT インポートされたイベントに、クリックより前の conversionDateTime があります。conversionDateTime が正しいことを確認してから、もう一度お試しください。
EXPIRED_EVENT このコンバージョンのクリックスルー計測期間よりも前にクリックが発生しているため、インポートされたイベントを記録できません。最新のデータをインポートしてください。
TOO_RECENT_EVENT 指定された ID または iOS URL パラメータに関連付けられているクリックが発生してから 6 時間経っていません。6 時間後にもう一度お試しください。
EVENT_NOT_FOUND インポートされたイベントをクリックに関連付けることができませんでした。これは、そのイベントが Google 広告の広告キャンペーンからのものではない可能性があります。
UNAUTHORIZED_CUSTOMER クリック ID または通話が、アクセス権のない Google 広告アカウントに関連付けられています。クライアント センター(MCC)アカウントで管理されているアカウントのコンバージョンをインポートしてください。
TOO_RECENT_CONVERSION_ACTION 作成したコンバージョン アクションにイベントをインポートできません。6 時間後にもう一度インポートをお試しください。
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME クリックの時点で、その Google 広告アカウントの有効なコンバージョン アカウントでコンバージョン トラッキングが有効になっていませんでした。
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION インポートされたイベントに外部のアトリビューション データが含まれていますが、コンバージョン アクションは外部のアトリビューション モデルを使用するように設定されていません。コンバージョン アクションが正しく設定されていることを確認してから、もう一度お試しください。
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION コンバージョン アクションは外部のアトリビューション モデルを使用するように設定されていますが、インポートされたイベントにデータがありません。インポートされたイベントに、外部のアトリビューションの貢献度とすべての必須項目が含まれていることを確認してください。
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 外部のアトリビューション モデルで測定されたコンバージョンには、オーダー ID を使用できません。コンバージョンが正しく設定され、インポートされたイベントに必要なデータのみが含まれていることを確認してから、もう一度お試しください。
ORDER_ID_ALREADY_IN_USE インポートされたイベントに以前に記録されたオーダー ID が含まれているため、イベントは処理されませんでした。
DUPLICATE_ORDER_ID インポートされたイベントに同じオーダー ID の複数のコンバージョンが含まれているため、イベントが処理されませんでした。オーダー ID が一意であることを確認してから、もう一度お試しください。
TOO_RECENT_CALL 過去 6 時間以内に発生した通話はインポートできません。6 時間後にもう一度アップロードをお試しください。
EXPIRED_CALL このコンバージョン アクションのルックバック ウィンドウより前に発生したため、通話を記録できません。最新のデータを取得するようにインポートが構成されていることを確認してください。
CALL_NOT_FOUND インポートされたイベントに関連する通話またはクリックが見つかりません。正しい ID が含まれるようにデータソースが設定されていることを確認してください。
CONVERSION_PRECEDES_CALL 呼び出しに、関連付けられたクリックの前に conversionDateTime がある。conversionDateTime が正しいことを確認してください。
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME 通話がインポートされた時点で、クリックが属している Google 広告アカウントの有効なコンバージョン アカウントでコンバージョン トラッキングが有効になっていませんでした。
UNPARSEABLE_CALLERS_PHONE_NUMBER 電話番号が E.164(+16502531234)、国際電話(+64 3-331 6005)、米国国内電話番号(6502531234)の形式であることを確認してください。
CLICK_CONVERSION_ALREADY_EXISTS インポートされたイベントのクリックとconversionDateTimeが、既存のコンバージョンと同じです。固有のイベントごとに一意の conversionDateTime またはオーダー ID を使用して、もう一度お試しください。
CALL_CONVERSION_ALREADY_EXISTS インポートされた通話のconversionDateTimeが、既存のコンバージョンと同じです。conversionDateTime が正しく設定されていることを確認してから、もう一度お試しください。
DUPLICATE_CLICK_CONVERSION_IN_REQUEST 複数のイベントのクリックと conversionDateTime が同じです。conversionDateTime が正しく設定されていることを確認してから、もう一度お試しください。
DUPLICATE_CALL_CONVERSION_IN_REQUEST 複数のイベントに同じ呼び出しと conversionDateTime があります。conversionDateTime が正しく設定されていることを確認してから、もう一度お試しください。
CUSTOM_VARIABLE_NOT_ENABLED コンバージョン設定でカスタム変数を有効にしてから、もう一度お試しください。
CUSTOM_VARIABLE_VALUE_CONTAINS_PII 個人を特定できる情報(PII)を含むカスタム変数を含むイベントはインポートできません。これらの変数を削除してから、もう一度お試しください。
INVALID_CUSTOMER_FOR_CLICK インポートされたイベントのクリックが、別の Google 広告アカウントに関連付けられています。インポート先のアカウントが正しいことを確認してください。
INVALID_CUSTOMER_FOR_CALL 通話からのクリックが、別の Google 広告アカウントに関連付けられています。インポート先のアカウントが正しいことを確認してください。Customer に対して conversionTrackingSetting.google_ads_conversion_customer をクエリして、正しいアカウントを特定します。
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY コンバージョンの発生元が Apple App Transparency Tracking(ATT)ポリシーに準拠していないか、顧客がトラッキングに同意していないため、コンバージョンをインポートできません。
CLICK_NOT_FOUND このイベントのメールアドレスまたは電話番号がクリックと一致しません。これは、Google 広告で作成した広告キャンペーンからのクリックではないことが原因である可能性があるため、この警告は無視してかまいません。インポートされたイベントの数が想定よりも多い場合は、設定の確認が必要になることがあります。
INVALID_USER_IDENTIFIER ユーザー提供データを SHA-256 を使用してハッシュ化し、ガイドラインに沿って正規化していることを確認してください。
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER ユーザー提供データは外部のアトリビューション モデルでは使用できません。別のアトリビューション モデルを使用するか、ユーザー ID を省略してもう一度お試しください。
UNSUPPORTED_USER_IDENTIFIER 指定されたユーザー ID はサポートされていません。ハッシュ化されたメールアドレスまたは電話番号のみを使用して、もう一度お試しください。
GBRAID_WBRAID_BOTH_SET gbraid パラメータと wbraid パラメータの両方を使用することはできません。どちらか一方を使用してもう一度お試しください。
UNPARSEABLE_WBRAID イベントのインポート データを解析できません。wbraid パラメータが変更されていないことを確認してから、もう一度お試しください。
UNPARSEABLE_GBRAID イベントのインポート データを解析できません。gbraid パラメータが変更されていないことを確認してから、もう一度お試しください。
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID クリックスルー コンバージョンのカウントを使用するコンバージョン アクションは、gbraid パラメータと wbraid パラメータでは使用できません。
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Google の顧客データに関するポリシーにより、このアカウントでは拡張コンバージョンを使用できません。Google 担当者に連絡する。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS コンバージョン設定で顧客データの処理に関する規約に同意していることを確認してから、もう一度お試しください。設定を確認するには、Customer の conversionTrackingSetting.accepted_customer_data_terms に対するクエリを実行します。
ORDER_ID_CONTAINS_PII 個人を特定できる情報(PII)を含むオーダー ID のイベントはインポートできません。
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS コンバージョン設定でリードの拡張コンバージョンが有効になっていることを確認してから、もう一度お試しください。設定を確認するには、Customer で conversionTrackingSetting.Enhanced_conversions_for_leads_enabled をクエリします。
INVALID_JOB_ID リクエストで指定されたジョブ ID が許可された範囲外です。ジョブ ID は「1, 2^31」の範囲の正の整数で指定してください。
NO_CONVERSION_ACTION_FOUND アップロード リクエストで指定されたコンバージョン アクションが見つかりません。このアカウントで使用できることを確認してください。
INVALID_CONVERSION_ACTION_TYPE アップロード リクエストで指定されたコンバージョン アクションは、コンバージョンをアップロードするように設定されていません。

DateError

発生する可能性のある日付エラーを説明する列挙型。

列挙型
UNSPECIFIED 列挙型が指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
INVALID_FIELD_VALUES_IN_DATE 指定したフィールド値が有効な日付に対応していません。
INVALID_FIELD_VALUES_IN_DATE_TIME 指定されたフィールド値が有効な日時に対応していません。
INVALID_STRING_DATE 文字列の日付の形式は yyyy-mm-dd にする必要があります。
INVALID_STRING_DATE_TIME_MICROS 文字列の日時の形式は yyyy-mm-dd hh:mm:ss.ssssss にする必要があります。
INVALID_STRING_DATE_TIME_SECONDS 文字列の日時の形式は yyyy-mm-dd hh:mm:ss にする必要があります。
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET 文字列の日時は、yyyy-mm-dd hh:mm:ss+|-hh:mm の形式で指定する必要があります。
EARLIER_THAN_MINIMUM_DATE 許容される最小値より前の日付です。
LATER_THAN_MAXIMUM_DATE 日付が上限を超えています。
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE 期間の範囲の順序が正しくありません。
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL 範囲内の日付が両方とも null です。

DistinctError

発生する可能性のある個別のエラーを表す列挙型。

列挙型
UNSPECIFIED 列挙型が指定されていません。
UNKNOWN 受け取ったエラーコードは、このバージョンでは不明です。
DUPLICATE_ELEMENT 要素が重複しています。
DUPLICATE_TYPE タイプが重複しています。

FieldError

フィールドで発生する可能性のあるエラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型が指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
REQUIRED 必須項目が存在しません。
IMMUTABLE_FIELD 変更しようとしたフィールドが不変である。
INVALID_VALUE フィールドの値が無効です。
VALUE_MUST_BE_UNSET このフィールドは設定できません。
REQUIRED_NONEMPTY_LIST 必須の繰り返しフィールドが空でした。
FIELD_CANNOT_BE_CLEARED フィールドを消去することはできません。
BLOCKED_VALUE フィールドの値がこのフィールドの拒否リストに登録されています。
FIELD_CAN_ONLY_BE_CLEARED フィールドの値は、消去を除き変更できません。

MutateError

発生する可能性のある変更エラーを説明する列挙型です。

列挙型
UNSPECIFIED 列挙型が指定されていません。
UNKNOWN 受け取ったエラーコードは、このバージョンでは不明です。
RESOURCE_NOT_FOUND リクエストしたリソースが見つかりませんでした。
ID_EXISTS_IN_MULTIPLE_MUTATES 1 回のリクエストで同じリソースを 2 回変更することはできません。
INCONSISTENT_FIELD_VALUES フィールドの内容が、同じデータを表す別のフィールドと一致しない。
MUTATE_NOT_ALLOWED リクエストされたリソースに対して変更を行うことはできません。
RESOURCE_NOT_IN_GOOGLE_ADS リソースが Google 広告にない。別の広告システムに属している。
RESOURCE_ALREADY_EXISTS 作成しようとしているリソースはすでに存在します。
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY このリソースは「validateOnly」と一緒に使用できません。
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE このオペレーションは「partialFailure」では使用できません。
RESOURCE_READ_ONLY 読み取り専用フィールドへの書き込みを試行します。

NotAllowlistedError

許可リストに登録されていないエラーを説明する列挙型です。

列挙型
UNSPECIFIED 列挙型が指定されていません。
UNKNOWN 受け取ったエラーコードは、このバージョンでは不明です。
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE ユーザーは、この機能にアクセスするための許可リストに登録されていません。

StringFormatError

発生する可能性のある文字列形式エラーを表す列挙型。

列挙型
UNSPECIFIED 列挙型が指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
ILLEGAL_CHARS 入力文字列値に使用できない文字が含まれています。
INVALID_FORMAT 入力文字列値が関連フィールドで無効です。

StringLengthError

発生する可能性のある文字列長エラーを表す列挙型。

列挙型
UNSPECIFIED 列挙型が指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
EMPTY 指定するフィールドには、空白以外の文字を少なくとも 1 つ含める必要があります。
TOO_SHORT 短すぎます。
TOO_LONG 長すぎます。

OperatingSystemVersionConstant

モバイル オペレーティング システムのバージョンまたはバージョンの範囲(operatorType に応じて異なります)。利用可能なモバイル プラットフォームの一覧については、https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms をご覧ください。

JSON 表現
{
  "resourceName": string,
  "operatorType": enum (OperatingSystemVersionOperatorType),
  "id": string,
  "name": string,
  "osMajorVersion": integer,
  "osMinorVersion": integer
}
フィールド
resourceName

string

出力専用。オペレーティング システムのバージョン定数のリソース名。オペレーティング システム バージョンの定数リソース名の形式は次のとおりです。

operatingSystemVersionConstants/{criterionId}

operatorType

enum (OperatingSystemVersionOperatorType)

出力専用。この定数が単一のバージョンを表すか、バージョンの範囲を表すかを決定します。

id

string (int64 format)

出力専用。オペレーティング システム バージョンの ID。

name

string

出力専用。オペレーティング システムの名前。

osMajorVersion

integer

出力専用。OS のメジャー バージョン番号。

osMinorVersion

integer

出力専用。OS のマイナー バージョン番号。

OperatingSystemVersionOperatorType

オペレーティング システムのバージョンのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
EQUALS_TO 指定したバージョンに等しい。
GREATER_THAN_EQUALS_TO 指定したバージョン以上。

PaidOrganicSearchTermView

有料のオーガニック検索語句のビューには、広告とオーガニック リスティングの検索に関する統計情報が、広告グループ単位で検索語句ごとに集計されて表示されます。

JSON 表現
{
  "resourceName": string,
  "searchTerm": string
}
フィールド
resourceName

string

出力専用。検索語句ビューのリソース名。検索キーワード ビューのリソース名の形式は次のとおりです。

customers/{customerId}/paidOrganicSearchTermViews/{campaignId}~ {adGroupId}~{URL-base64 search term}

searchTerm

string

出力専用。検索キーワード。

QualifyingQuestion

リードフォームの評価のための質問

JSON 表現
{
  "resourceName": string,
  "qualifyingQuestionId": string,
  "locale": string,
  "text": string
}
フィールド
resourceName

string

出力専用。適格性確認質問のリソース名。

'qualifyingQuestions/{qualifyingQuestionId}'

qualifyingQuestionId

string (int64 format)

出力専用。見込み顧客を選別するための質問の ID。

locale

string

出力専用。見込み顧客を選別するための質問の言語 / 地域。

text

string

出力専用。見込み顧客を選別するための質問。

ParentalStatusView

子供の有無に関するビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。子供の有無ビューのリソース名。子供の有無ビューのリソース名の形式は次のとおりです。

customers/{customerId}/parentalStatusViews/{adGroupId}~{criterionId}

PerStoreView

店舗別のビュー。このビューでは、広告主様の店舗ごとのインプレッション リーチとローカル アクションのコンバージョンに関する統計情報を確認できます。

JSON 表現
{
  "resourceName": string,
  "placeId": string
}
フィールド
resourceName

string

出力専用。店舗別ビューのリソース名。店舗別ビューのリソース名の形式は次のとおりです。

customers/{customerId}/perStoreViews/{placeId}

placeId

string

出力専用。店舗別ビューのプレイス ID。

ProductCategoryConstant

商品カテゴリ。

JSON 表現
{
  "resourceName": string,
  "categoryId": string,
  "level": enum (ProductCategoryLevel),
  "state": enum (ProductCategoryState),
  "localizations": [
    {
      object (ProductCategoryLocalization)
    }
  ],
  "productCategoryConstantParent": string
}
フィールド
resourceName

string

出力専用。商品カテゴリのリソース名。商品カテゴリのリソース名の形式は次のとおりです。

productCategoryConstants/{level}~{categoryId}

categoryId

string (int64 format)

出力専用。商品カテゴリの ID。

この ID は、https://support.google.com/merchants/answer/6324436 の記事で説明されている google_product_category ID と同じです。

level

enum (ProductCategoryLevel)

出力専用。商品カテゴリのレベル。

state

enum (ProductCategoryState)

出力専用。商品カテゴリの状態。

localizations[]

object (ProductCategoryLocalization)

出力専用。商品カテゴリの利用可能なすべてのローカライズのリスト。

productCategoryConstantParent

string

出力専用。親商品カテゴリのリソース名。

ProductCategoryState

商品カテゴリの状態を表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED カテゴリは有効になっています。
OBSOLETE このカテゴリは使われていません。レポート作成にのみ使用されます。

ProductCategoryLocalization

商品カテゴリのローカライズ。

JSON 表現
{
  "regionCode": string,
  "languageCode": string,
  "value": string
}
フィールド
regionCode

string

出力専用。ローカライズされたカテゴリの大文字の 2 文字の ISO 3166-1 国コード。

languageCode

string

出力専用。ローカライズされたカテゴリの 2 文字の ISO 639-1 言語コード。

value

string

出力専用。指定された言語 / 地域のカテゴリ名。

ProductGroupView

商品グループビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。商品グループビューのリソース名。商品グループビューのリソース名の形式は次のとおりです。

customers/{customerId}/productGroupViews/{adGroupId}~{criterionId}

SearchTermView

検索語句ビュー: 広告グループ単位で検索語句ごとに集計された指標が表示されます。

JSON 表現
{
  "resourceName": string,
  "status": enum (SearchTermTargetingStatus),
  "searchTerm": string,
  "adGroup": string
}
フィールド
resourceName

string

出力専用。検索語句ビューのリソース名。検索キーワード ビューのリソース名の形式は次のとおりです。

customers/{customerId}/searchTermViews/{campaignId}~{adGroupId}~{URL-base64_search_term}

status

enum (SearchTermTargetingStatus)

出力専用。検索語句が現在、ターゲットに設定しているキーワードまたは除外キーワードに含まれているかどうかを示します。

searchTerm

string

出力専用。検索キーワード。

adGroup

string

出力専用。検索語句が配信された広告グループ。

SearchTermTargetingStatus

検索語句がターゲットに設定したキーワードか、除外キーワードのキーワードかを示します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ADDED 検索キーワードがターゲットとするキーワードに追加される。
EXCLUDED 検索語句が除外キーワードと一致しています。
ADDED_EXCLUDED 検索語句が追加され、除外されました。
NONE 検索語句がターゲットに設定されておらず、除外もされていません。

ShoppingPerformanceView

ショッピングのパフォーマンス ビュー。複数の商品ディメンション レベルで集計されたショッピング キャンペーンの統計情報を提供します。Merchant Center の商品ディメンションの値(ブランド、カテゴリ、カスタム属性、商品の状態、商品タイプなど)には、対応するイベントが記録された日時における各ディメンションの状態が反映されます。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。ショッピングの掲載結果ビューのリソース名。ショッピングのパフォーマンス ビューのリソース名の形式は、customers/{customerId}/shoppingPerformanceView です。

SmartCampaignSearchTermView

スマート アシスト キャンペーンの検索語句ビュー。

JSON 表現
{
  "resourceName": string,
  "searchTerm": string,
  "campaign": string
}
フィールド
resourceName

string

出力専用。スマート アシスト キャンペーンの検索語句ビューのリソース名。スマート キャンペーンの検索語句ビューのリソース名の形式は次のとおりです。

customers/{customerId}/smartCampaignSearchTermViews/{campaignId}~{URL-base64_search_term}

searchTerm

string

出力専用。検索キーワード。

campaign

string

出力専用。検索語句が配信されたスマート アシスト キャンペーン。

TopicView

トピックビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。トピックビューのリソース名。トピックビューのリソース名の形式は次のとおりです。

customers/{customerId}/topicViews/{adGroupId}~{criterionId}

TravelActivityGroupView

旅行アクティビティ グループのビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。旅行アクティビティ グループ ビューのリソース名。Travel Activity Group ビューのリソース名の形式は次のとおりです。

customers/{customerId}/travelActivityGroupViews/{adGroupId}~{criterionId}

TravelActivityPerformanceView

旅行アクティビティのパフォーマンス ビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。旅行アクティビティのパフォーマンス ビューのリソース名。旅行アクティビティのパフォーマンス ビューのリソース名の形式は次のとおりです。

customers/{customerId}/travelActivityPerformanceView

UserInterest

ユーザーの興味 / 関心: ターゲットとする特定の興味 / 関心に基づくカテゴリ。

JSON 表現
{
  "resourceName": string,
  "taxonomyType": enum (UserInterestTaxonomyType),
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ],
  "userInterestId": string,
  "name": string,
  "userInterestParent": string,
  "launchedToAll": boolean
}
フィールド
resourceName

string

出力専用。ユーザー インタレストのリソース名。ユーザー インタレストのリソース名の形式は次のとおりです。

customers/{customerId}/userInterests/{userInterestId}

taxonomyType

enum (UserInterestTaxonomyType)

出力専用。ユーザーの興味 / 関心の分類タイプ。

availabilities[]

object (CriterionCategoryAvailability)

出力専用。ユーザーの興味 / 関心の可用性情報。

userInterestId

string (int64 format)

出力専用。ユーザー インタレストの ID。

name

string

出力専用。ユーザー インタレストの名称。

userInterestParent

string

出力専用。ユーザー インタレストの親。

launchedToAll

boolean

出力専用。ユーザーの興味 / 関心がすべてのチャンネルと言語 / 地域に適用される場合は true。

UserInterestTaxonomyType

有効な UserInterestTaxonomyTypes を含む列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
AFFINITY このユーザーの興味 / 関心のアフィニティ。
IN_MARKET このユーザー インタレストの市場。
MOBILE_APP_INSTALL_USER 指定されたカテゴリのアプリをインストールしたことが確認されているユーザー。
VERTICAL_GEO インタレスト ベースの業種の地理的位置です。
NEW_SMART_PHONE_USER 新しいスマートフォン ユーザーのユーザーの興味や関心の条件。

LifeEvent

ライフイベント: 人生の大きな節目を迎えているユーザーにリーチできる、特定のインタレスト ベースのカテゴリ。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "name": string,
  "parent": string,
  "launchedToAll": boolean,
  "availabilities": [
    {
      object (CriterionCategoryAvailability)
    }
  ]
}
フィールド
resourceName

string

出力専用。ライフイベントのリソース名。ライフイベントのリソース名の形式は次のとおりです。

customers/{customerId}/lifeEvents/{lifeEventId}

id

string (int64 format)

出力専用。ライフイベントの ID。

name

string

出力専用。ライフイベントの名前(例: 最近引越し)

parent

string

出力専用。LifeEvent の親。

launchedToAll

boolean

出力専用。ライフイベントがすべてのチャンネルとロケールで配信される場合は true。

availabilities[]

object (CriterionCategoryAvailability)

出力専用。ライフイベントの可用性情報。

UserLocationView

ユーザーの位置情報のビュー。

ユーザーの位置情報ビューには、国別に集計されたすべての指標が国ごとに 1 行ずつ表示されます。ユーザーの実際の物理的な位置情報に基づいて、ターゲット設定された場所とターゲット設定されていない場所で指標がレポートされます。他のセグメント フィールドが使用されている場合は、国ごとに複数の行が表示されることがあります。

JSON 表現
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
フィールド
resourceName

string

出力専用。ユーザーの位置情報ビューのリソース名。UserLocation ビューのリソース名の形式は次のとおりです。

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string (int64 format)

出力専用。国の条件 ID。

targetingLocation

boolean

出力専用。位置情報がターゲットに設定されているかどうかを示します。

TopicConstant

トピックを使用すると、Google ディスプレイ ネットワークで該当するカテゴリ(「ペット、動物/ペット/犬」など)に基づいて、プレースメントをターゲットに設定したり除外したりできます。

JSON 表現
{
  "resourceName": string,
  "path": [
    string
  ],
  "id": string,
  "topicConstantParent": string
}
フィールド
resourceName

string

出力専用。トピック定数のリソース名。トピック定数リソース名の形式は次のとおりです。

topicConstants/{topic_id}

path[]

string

出力専用。ターゲットに設定または除外するカテゴリ。配列の後続の各要素は、より具体的なサブカテゴリを示します。たとえば、{"ペット、動物", "ペット", "犬"} は、「ペット、動物/ペット/犬」カテゴリを表します。利用可能なトピック カテゴリの一覧については、https://developers.google.com/google-ads/api/reference/data/verticals をご覧ください。

id

string (int64 format)

出力専用。トピックの ID。

topicConstantParent

string

出力専用。トピック定数の親のリソース名。

動画

動画。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "channelId": string,
  "durationMillis": string,
  "title": string
}
フィールド
resourceName

string

出力専用。動画のリソース名。動画リソース名の形式は次のとおりです。

customers/{customerId}/videos/{videoId}

id

string

出力専用。動画の ID。

channelId

string

出力専用。動画のオーナー チャンネル ID。

durationMillis

string (int64 format)

出力専用。動画の再生時間(ミリ秒単位)。

title

string

出力専用。動画のタイトル。

WebpageView

ウェブページのビュー。

JSON 表現
{
  "resourceName": string
}
フィールド
resourceName

string

出力専用。ウェブページ ビューのリソース名。ウェブページビューのリソース名の形式は次のとおりです。

customers/{customerId}/webpageViews/{adGroupId}~{criterionId}

LeadFormSubmissionData

リードフォームの送信からのデータです。

JSON 表現
{
  "resourceName": string,
  "id": string,
  "asset": string,
  "campaign": string,
  "leadFormSubmissionFields": [
    {
      object (LeadFormSubmissionField)
    }
  ],
  "customLeadFormSubmissionFields": [
    {
      object (CustomLeadFormSubmissionField)
    }
  ],
  "adGroup": string,
  "adGroupAd": string,
  "gclid": string,
  "submissionDateTime": string
}
フィールド
resourceName

string

出力専用。見込み顧客フォーム送信データのリソース名。リードフォーム送信データのリソース名の形式は次のとおりです。

customers/{customerId}/leadFormSubmissionData/{lead_form_submission_data_id}

id

string

出力専用。このリードフォーム送信の ID。

asset

string

出力専用。送信されたリードフォームに関連付けられているアセット。

campaign

string

出力専用。送信されたリードフォームに関連付けられているキャンペーン。

leadFormSubmissionFields[]

object (LeadFormSubmissionField)

出力専用。リードフォームに関連付けられた送信データ。

customLeadFormSubmissionFields[]

object (CustomLeadFormSubmissionField)

出力専用。カスタム リードフォームに関連付けられた送信データ。

adGroup

string

出力専用。送信されたリードフォームに関連付けられている広告グループ。

adGroupAd

string

出力専用。送信されたリードフォームに関連付けられている AdGroupAd です。

gclid

string

出力専用。提供されたリードフォームに関連付けられている Google クリック ID。

submissionDateTime

string

出力専用。リードフォームが送信された日時。形式は「yyyy-mm-dd hh:mm:ss+|-hh:mm」です(例: 2019-01-01 12:32:45-08:00)。

LeadFormSubmissionField

送信されたリードフォームの項目。

JSON 表現
{
  "fieldType": enum (LeadFormFieldUserInputType),
  "fieldValue": string
}
フィールド
fieldType

enum (LeadFormFieldUserInputType)

出力専用。リードフォームの項目のタイプです。

fieldValue

string

出力専用。見込み顧客フォームのフィールドのフィールド値。

CustomLeadFormSubmissionField

送信されたカスタム質問のフィールド

JSON 表現
{
  "questionText": string,
  "fieldValue": string
}
フィールド
questionText

string

出力専用。カスタム質問の質問文。最大文字数は 300 文字です。

fieldValue

string

出力専用。カスタムの質問の回答のフィールド値。最大文字数は 70 文字です。

LocalServicesLead

ローカル サービス リードからのデータ。ユーザーが広告主からサービスに電話をかけたり、メッセージを送信したり、サービスを予約したりしたときに生成される、見込み顧客の詳細が含まれます。詳細: https://ads.google.com/local-services-ads

JSON 表現
{
  "resourceName": string,
  "id": string,
  "categoryId": string,
  "serviceId": string,
  "contactDetails": {
    object (ContactDetails)
  },
  "leadType": enum (LeadType),
  "leadStatus": enum (LeadStatus),
  "creationDateTime": string,
  "locale": string,
  "leadCharged": boolean,
  "note": {
    object (Note)
  },
  "creditDetails": {
    object (CreditDetails)
  }
}
フィールド
resourceName

string

出力専用。ローカル サービス見込み顧客データのリソース名。ローカル サービス リードのリソース名の形式は次のとおりです。

customers/{customerId}/localServicesLead/{local_services_lead_id}

id

string (int64 format)

出力専用。このリードの ID。

categoryId

string

出力専用。見込み顧客のサービス カテゴリ。例: xcat:service_area_business_hvacxcat:service_area_business_real_estate_agent など。詳しくは、https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids をご覧ください。

serviceId

string

出力専用。カテゴリのサービス。例: buyer_agentseller_agentxcat:service_area_business_real_estate_agent のカテゴリの場合)。

contactDetails

object (ContactDetails)

出力専用。リードの連絡先情報。

leadType

enum (LeadType)

出力専用。ローカル サービス リードのタイプ: 電話、メッセージ、予約など

leadStatus

enum (LeadStatus)

出力専用。見込み顧客の現在のステータス。

creationDateTime

string

出力専用。ローカル サービス広告によってリードが作成された日時。形式は「YYYY-MM-DD HH:MM:SS」です(Google 広告アカウントのタイムゾーンを使用します)。例: 「2018-03-05 09:15:00」、「2018-02-01 14:34:30」

locale

string

出力専用。見込み顧客にリンクされているローカル サービス プロバイダが使用する言語。https://developers.google.com/google-ads/api/data/codes-formats#locales をご覧ください。

leadCharged

boolean

出力専用。広告主に見込み顧客の費用が請求された場合は true。

note

object (Note)

出力専用。広告主が見込み顧客に追加したメモ。

creditDetails

object (CreditDetails)

出力専用。見込み顧客のクレジットの詳細。

ContactDetails

ユーザーの連絡先情報を含むフィールド。

JSON 表現
{
  "phoneNumber": string,
  "email": string,
  "consumerName": string
}
フィールド
phoneNumber

string

出力専用。お客様の電話番号(E.164 形式)。

email

string

出力専用。購入者のメールアドレス。

consumerName

string

出力専用。消費者の名前(消費者が google.com のメッセージ フォームまたは予約フォームで指定した名前である場合)

LeadType

見込み顧客の種類。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
MESSAGE メッセージ セールスリード。
PHONE_CALL 電話によって作成された見込み顧客。
BOOKING 予約セールスリード。

LeadStatus

見込み顧客のステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
NEW 広告主がまだ確認していない新しい見込み顧客。
ACTIVE 広告主様と接点を持ったことのある見込み顧客。
BOOKED 見込み顧客が予約されています。
DECLINED 見込み顧客が広告主によって承認されませんでした。
EXPIRED 無効なため、リードの有効期限が切れました。
DISABLED スパムまたは異議申し立てにより、無効になっています。
CONSUMER_DECLINED お客様が見込み顧客を拒否した。
WIPED_OUT 見込み顧客の個人情報は消去されます。

広告主が見込み顧客に追加したメモを表します。広告主様はメモを編集できます。編集すると、編集時間がリセットされ、説明が変更されます。

JSON 表現
{
  "editDateTime": string,
  "description": string
}
フィールド
editDateTime

string

出力専用。見込み顧客のメモが編集された日時。形式は、Google 広告アカウントのタイムゾーンにおける「YYYY-MM-DD HH:MM:SS」です。例: 「2018-03-05 09:15:00」、「2018-02-01 14:34:30」

description

string

出力専用。リードノートの内容。

CreditDetails

セールスリードのクレジットの詳細を表します。

JSON 表現
{
  "creditState": enum (CreditState),
  "creditStateLastUpdateDateTime": string
}
フィールド
creditState

enum (CreditState)

出力専用。リードの信用状態。

creditStateLastUpdateDateTime

string

出力専用。見込み顧客のクレジット状態が最後に更新された日時。形式は、Google 広告アカウントのタイムゾーンにおける「YYYY-MM-DD HH:MM:SS」です。例: 「2018-03-05 09:15:00」、「2018-02-01 14:34:30」

CreditState

見込み顧客のクレジット状態。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
PENDING クレジットが申請され、Google 広告のバックエンドで処理中ですが、まだアカウントに適用されていません。
CREDITED クレジットが Google 広告アカウントに発行されました。

LocalServicesLeadConversation

ローカル サービスの見込み顧客との会話からのデータ。ユーザーが広告主に対して電話、メッセージ、または予約を行ったときに生成される、見込み顧客の会話の詳細が含まれます。見込み顧客に追加される。詳細: https://ads.google.com/local-services-ads

JSON 表現
{
  "resourceName": string,
  "id": string,
  "conversationChannel": enum (ConversationType),
  "participantType": enum (ParticipantType),
  "lead": string,
  "eventDateTime": string,
  "phoneCallDetails": {
    object (PhoneCallDetails)
  },
  "messageDetails": {
    object (MessageDetails)
  }
}
フィールド
resourceName

string

出力専用。ローカル サービスのリードの会話データのリソース名。「Local Services Lead Conversation」リソース名の形式は、

customers/{customerId}/localServicesLeadConversation/{local_services_lead_conversation_id}

id

string (int64 format)

出力専用。このリードの会話の ID。

conversationChannel

enum (ConversationType)

出力専用。GLS セールスリードとの会話のタイプ(EMAIL、MESSAGE、PHONE_CALL、SMS など)。

participantType

enum (ParticipantType)

出力専用。見込み顧客との会話の参加者のタイプ(ADVERTISER または CONSUMER)。

lead

string

出力専用。見込み顧客の会話に関連付けられた見込み顧客のリソース名。

eventDateTime

string

出力専用。ローカル サービス広告によってセールスリードとの会話が作成された日時。形式は、Google 広告アカウントのタイムゾーンにおける「YYYY-MM-DD HH:MM:SS」です。例: 「2018-03-05 09:15:00」、「2018-02-01 14:34:30」

phoneCallDetails

object (PhoneCallDetails)

出力専用。PHONE_CALL の場合の電話会話の詳細。

messageDetails

object (MessageDetails)

出力専用。EMAIL、MESSAGE、または SMS の場合のメッセージ スレッドの詳細。

ConversationType

セールスリードとの会話のタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
EMAIL 見込み顧客との会話をメールで送る。
MESSAGE メッセージ セールスリードとの会話。
PHONE_CALL 電話リードとの会話。
SMS SMS による見込み顧客の会話。
BOOKING 予約見込み顧客との会話。

ParticipantType

リードの会話の参加者の種類。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
ADVERTISER ローカル サービス広告プロバイダの参加者です。
CONSUMER ローカル サービス広告の消費者参加者。

PhoneCallDetails

電話の会話の詳細を表します。

JSON 表現
{
  "callDurationMillis": string,
  "callRecordingUrl": string
}
フィールド
callDurationMillis

string (int64 format)

出力専用。通話時間(エンドツーエンド)(ミリ秒単位)。

callRecordingUrl

string

出力専用。通話の録音の音声ファイルへの URL。

MessageDetails

メール、メッセージ、SMS の場合のテキスト メッセージの詳細を表します。

JSON 表現
{
  "text": string,
  "attachmentUrls": [
    string
  ]
}
フィールド
text

string

出力専用。メッセージのテキスト コンテンツ。

attachmentUrls[]

string

出力専用。SMS またはメールの添付ファイルの URL。この URL を使用すると、開発者トークンを使って添付ファイルの内容をダウンロードすることができます。

AndroidPrivacySharedKeyGoogleAdGroup

Google 広告グループ キーの Android プライバシー共有キービュー。

JSON 表現
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "adGroupId": string,
  "sharedAdGroupKey": string
}
フィールド
resourceName

string

出力専用。Android のプライバシー共有キーのリソース名。Android プライバシー共有鍵のリソース名の形式は次のとおりです。

customers/{customerId}/androidPrivacySharedKeyGoogleAdGroups/{campaignId}~{adGroupId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}

campaignId

string (int64 format)

出力専用。共有キーのエンコードで使用されるキャンペーン ID。

androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

出力専用。共有キーのエンコードで使用されるインタラクション タイプの列挙型。

androidPrivacyInteractionDate

string

出力専用。共有キーのエンコードで使用される操作日。UTC タイムゾーンの「YYYY-MM-DD」形式で指定します。

androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

出力専用。共有鍵のエンコードで使用されるネットワーク タイプの列挙型。

adGroupId

string (int64 format)

出力専用。共有キーのエンコードで使用される広告グループ ID。

sharedAdGroupKey

string

出力専用。エンコードされた共有広告グループ キーの 128 ビットの 16 進数文字列(「0x」接頭辞を含む)。このキーを使用して集計コンバージョンキーとビット演算 OR 演算子を実行し、Android プライバシー サンドボックスで集計 API レポートを取得するための完全な集計キーを作成できます。

AndroidPrivacyInteractionType

インタラクションの種類を列挙する

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
CLICK 物理的なクリック操作のタイプ。
ENGAGED_VIEW 10 秒のエンゲージ ビュー インタラクション タイプ。
VIEW 表示(広告インプレッション)インタラクション タイプ。

AndroidPrivacyNetworkType

ネットワークの種類を列挙する

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
SEARCH 検索ネットワーク。
DISPLAY ディスプレイ ネットワークです。
YOUTUBE YouTube ネットワーク。

AndroidPrivacySharedKeyGoogleCampaign

Google キャンペーン キーの Android プライバシー共有鍵ビュー。

JSON 表現
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "sharedCampaignKey": string
}
フィールド
resourceName

string

出力専用。Android のプライバシー共有キーのリソース名。Android プライバシー共有鍵のリソース名の形式は次のとおりです。

customers/{customerId}/androidPrivacySharedKeyGoogleCampaigns/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}

campaignId

string (int64 format)

出力専用。共有キーのエンコードで使用されるキャンペーン ID。

androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

出力専用。共有キーのエンコードで使用されるインタラクション タイプの列挙型。

androidPrivacyInteractionDate

string

出力専用。共有キーのエンコードで使用される操作日。UTC タイムゾーンの「YYYY-MM-DD」形式で指定します。

sharedCampaignKey

string

出力専用。エンコードされた共有キャンペーン キーの 128 ビットの 16 進数文字列(「0x」接頭辞を含む)。このキーを使用して集計コンバージョンキーとビット演算 OR 演算子を実行し、Android プライバシー サンドボックスで集計 API レポートを取得するための完全な集計キーを作成します。

AndroidPrivacySharedKeyGoogleNetworkType

Google ネットワーク タイプ キーの Android プライバシー共有鍵ビュー。

JSON 表現
{
  "resourceName": string,
  "campaignId": string,
  "androidPrivacyInteractionType": enum (AndroidPrivacyInteractionType),
  "androidPrivacyInteractionDate": string,
  "androidPrivacyNetworkType": enum (AndroidPrivacyNetworkType),
  "sharedNetworkTypeKey": string
}
フィールド
resourceName

string

出力専用。Android のプライバシー共有キーのリソース名。Android プライバシー共有鍵のリソース名の形式は次のとおりです。

customers/{customerId}/androidPrivacySharedKeyGoogleNetworkTypes/{campaignId}~{androidPrivacyInteractionType}~{androidPrivacyNetworkType}~{androidPrivacyInteractionDate(yyyy-mm-dd)}

campaignId

string (int64 format)

出力専用。共有キーのエンコードで使用されるキャンペーン ID。

androidPrivacyInteractionType

enum (AndroidPrivacyInteractionType)

出力専用。共有キーのエンコードで使用されるインタラクション タイプの列挙型。

androidPrivacyInteractionDate

string

出力専用。共有キーのエンコードで使用される操作日。UTC タイムゾーンの「YYYY-MM-DD」形式で指定します。

androidPrivacyNetworkType

enum (AndroidPrivacyNetworkType)

出力専用。共有鍵のエンコードで使用されるネットワーク タイプの列挙型。

sharedNetworkTypeKey

string

出力専用。エンコードされた共有ネットワーク タイプ鍵の 128 ビットの 16 進数文字列。接頭辞「0x」を含みます。このキーを使用して集計コンバージョンキーとビット演算 OR 演算子を実行し、Android プライバシー サンドボックスで集計 API レポートを取得するための完全な集計キーを作成します。

指標

指標データ。

JSON 表現
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkInstalls": string,
  "skAdNetworkTotalConversions": string,
  "publisherPurchasedClicks": string,
  "publisherOrganicClicks": string,
  "publisherUnknownClicks": string,
  "absoluteTopImpressionPercentage": number,
  "activeViewCpm": number,
  "activeViewCtr": number,
  "activeViewImpressions": string,
  "activeViewMeasurability": number,
  "activeViewMeasurableCostMicros": string,
  "activeViewMeasurableImpressions": string,
  "activeViewViewability": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allNewCustomerLifetimeValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "allConversionsFromStoreWebsite": number,
  "auctionInsightSearchAbsoluteTopImpressionPercentage": number,
  "auctionInsightSearchImpressionShare": number,
  "auctionInsightSearchOutrankingShare": number,
  "auctionInsightSearchOverlapRate": number,
  "auctionInsightSearchPositionAboveRate": number,
  "auctionInsightSearchTopImpressionPercentage": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpe": number,
  "averageCpm": number,
  "averageCpv": number,
  "averagePageViews": number,
  "averageTimeOnSite": number,
  "benchmarkAverageMaxCpc": number,
  "biddableAppInstallConversions": number,
  "biddableAppPostInstallConversions": number,
  "benchmarkCtr": number,
  "bounceRate": number,
  "clicks": string,
  "combinedClicks": string,
  "combinedClicksPerQuery": number,
  "combinedQueries": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "conversionLastReceivedRequestDateTime": string,
  "conversionLastConversionDate": string,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "conversionsValue": number,
  "newCustomerLifetimeValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "conversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValueMicros": string,
  "ctr": number,
  "currentModelAttributedConversions": number,
  "currentModelAttributedConversionsFromInteractionsRate": number,
  "currentModelAttributedConversionsFromInteractionsValuePerInteraction": number,
  "currentModelAttributedConversionsValue": number,
  "currentModelAttributedConversionsValuePerCost": number,
  "engagementRate": number,
  "engagements": string,
  "hotelAverageLeadValueMicros": number,
  "hotelCommissionRateMicros": string,
  "hotelExpectedCommissionCost": number,
  "hotelPriceDifferencePercentage": number,
  "hotelEligibleImpressions": string,
  "historicalQualityScore": string,
  "gmailForwards": string,
  "gmailSaves": string,
  "gmailSecondaryClicks": string,
  "impressionsFromStoreReach": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "messageChats": string,
  "messageImpressions": string,
  "messageChatRate": number,
  "mobileFriendlyClicksPercentage": number,
  "optimizationScoreUplift": number,
  "optimizationScoreUrl": string,
  "organicClicks": string,
  "organicClicksPerQuery": number,
  "organicImpressions": string,
  "organicImpressionsPerQuery": number,
  "organicQueries": string,
  "percentNewVisitors": number,
  "phoneCalls": string,
  "phoneImpressions": string,
  "phoneThroughRate": number,
  "relativeCtr": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "searchVolume": {
    object (SearchVolumeRange)
  },
  "speedScore": string,
  "averageTargetCpaMicros": string,
  "averageTargetRoas": number,
  "topImpressionPercentage": number,
  "validAcceleratedMobilePagesClicksPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "valuePerCurrentModelAttributedConversion": number,
  "videoQuartileP100Rate": number,
  "videoQuartileP25Rate": number,
  "videoQuartileP50Rate": number,
  "videoQuartileP75Rate": number,
  "videoViewRate": number,
  "videoViews": string,
  "viewThroughConversions": string,
  "allConversionsFromLocationAssetClickToCall": number,
  "allConversionsFromLocationAssetDirections": number,
  "allConversionsFromLocationAssetMenu": number,
  "allConversionsFromLocationAssetOrder": number,
  "allConversionsFromLocationAssetOtherEngagement": number,
  "allConversionsFromLocationAssetStoreVisits": number,
  "allConversionsFromLocationAssetWebsite": number,
  "eligibleImpressionsFromLocationAssetStoreReach": string,
  "viewThroughConversionsFromLocationAssetClickToCall": number,
  "viewThroughConversionsFromLocationAssetDirections": number,
  "viewThroughConversionsFromLocationAssetMenu": number,
  "viewThroughConversionsFromLocationAssetOrder": number,
  "viewThroughConversionsFromLocationAssetOtherEngagement": number,
  "viewThroughConversionsFromLocationAssetStoreVisits": number,
  "viewThroughConversionsFromLocationAssetWebsite": number,
  "orders": number,
  "averageOrderValueMicros": string,
  "averageCartSize": number,
  "costOfGoodsSoldMicros": string,
  "grossProfitMicros": string,
  "grossProfitMargin": number,
  "revenueMicros": string,
  "unitsSold": number,
  "crossSellCostOfGoodsSoldMicros": string,
  "crossSellGrossProfitMicros": string,
  "crossSellRevenueMicros": string,
  "crossSellUnitsSold": number,
  "leadCostOfGoodsSoldMicros": string,
  "leadGrossProfitMicros": string,
  "leadRevenueMicros": string,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
フィールド
allConversionsValueByConversionDate

number

すべてのコンバージョン値。この列を日付とともに選択した場合、日付列の値はコンバージョンの日付を意味します。by_conversion_date 列の詳細については、https://support.google.com/google-ads/answer/9549009 をご覧ください。

allConversionsByConversionDate

number

コンバージョンの合計数です。これには、includeInConversionsMetric の値に関係なく、すべてのコンバージョンが含まれます。この列を日付とともに選択した場合、日付列の値はコンバージョンの日付を意味します。by_conversion_date 列の詳細については、https://support.google.com/google-ads/answer/9549009 をご覧ください。

conversionsValueByConversionDate

number

コンバージョンの値。includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/google-ads/answer/9549009 をご覧ください。

conversionsByConversionDate

number

コンバージョン数です。includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/google-ads/answer/9549009 をご覧ください。

historicalCreativeQualityScore

enum (QualityScoreBucket)

クリエイティブの品質スコア(履歴)。

historicalLandingPageQualityScore

enum (QualityScoreBucket)

過去のランディング ページの利便性。

historicalSearchPredictedCtr

enum (QualityScoreBucket)

過去の検索の予測クリック率(CTR)。

interactionEventTypes[]

enum (InteractionEventType)

支払い対象のインタラクションと無料インタラクションのタイプ。

skAdNetworkInstalls

string (int64 format)

iOS の Store Kit 広告ネットワークのコンバージョン数。

skAdNetworkTotalConversions

string (int64 format)

iOS の Store Kit 広告ネットワークのコンバージョンの合計数。

publisherPurchasedClicks

string (int64 format)

有料またはインセンティブ型のトラフィックで、パブリッシャーが所有していないプロパティからのクリック

publisherOrganicClicks

string (int64 format)

有料またはインセンティブ型ではないトラフィックで、パブリッシャーが所有していないプロパティからのクリック

publisherUnknownClicks

string (int64 format)

「パブリッシャーによる購入」または「パブリッシャーによる自然検索」として認識されていないトラフィックからのクリック

absoluteTopImpressionPercentage

number

「検索広告の最上部インプレッション シェア」とは、検索結果ページの最も目立つ位置に検索広告が表示されたインプレッションの割合です。

activeViewCpm

number

視認範囲のインプレッションの平均費用(activeViewImpressions)。

activeViewCtr

number

アクティブ ビュー測定可能なクリック数をアクティブ ビュー視認範囲のインプレッション数で割った値です。

この指標は、ディスプレイ ネットワークに対してのみ報告されます。

activeViewImpressions

string (int64 format)

ディスプレイ ネットワークのサイトで広告が表示可能になった頻度の測定です。

activeViewMeasurability

number

配信インプレッション数に対してアクティブ ビューによって測定できたインプレッションの割合。

activeViewMeasurableCostMicros

string (int64 format)

アクティブ ビューで測定可能だったインプレッションの費用です。

activeViewMeasurableImpressions

string (int64 format)

プレースメントがユーザーに表示される位置に広告が表示される回数。

activeViewViewability

number

アクティブ ビュー対応のサイトに広告が表示された回数(測定可能なインプレッション)と、広告が閲覧可能だった(視認範囲のインプレッション)回数の割合。

allConversionsFromInteractionsRate

number

インタラクションからのコンバージョンの数(ビュースルー コンバージョンとは逆)を、広告インタラクションの数で割った値です。

allConversionsValue

number

すべてのコンバージョン値。

allNewCustomerLifetimeValue

number

すべての新規顧客のライフタイム コンバージョン値。「顧客の獲得」目標をアカウント単位またはキャンペーン単位で設定している場合は、入札単価設定に使用されるコンバージョンと入札対象ではないコンバージョンの両方について、新規顧客のコンバージョン値が加算されます。「顧客の獲得」目標を採用しているキャンペーンで [新規顧客に対する入札単価を高くする] を選択している場合、これらの値は [allconversionValue] に含まれます。詳しくは、https://support.google.com/google-ads/answer/12080169 をご覧ください。

allConversions

number

コンバージョンの合計数です。これには、includeInConversionsMetric の値に関係なく、すべてのコンバージョンが含まれます。

allConversionsValuePerCost

number

すべてのコンバージョンの値を、広告インタラクション(テキスト広告のクリックや動画広告の視聴など)の合計費用で割った値。

allConversionsFromClickToCall

number

ユーザーが広告をクリックした後に、[発信] ボタンを押して広告主様の店舗に電話した回数を示します。通話時間と、電話がつながったかどうかは考慮されません。

この指標はフィードアイテムにのみ適用されます。

allConversionsFromDirections

number

ユーザーが広告をクリックした後に、[経路検索] ボタンをクリックして店舗へのルートを表示した回数。

この指標はフィードアイテムにのみ適用されます。

allConversionsFromInteractionsValuePerInteraction

number

インタラクションから発生したすべてのコンバージョンのコンバージョン値をインタラクションの合計数で割った値。

allConversionsFromMenu

number

ユーザーが広告をクリックした後に、広告主様の店舗のメニューを表示するリンクをクリックした回数を示します。

この指標はフィード アイテムにのみ適用されます。

allConversionsFromOrder

number

ユーザーが広告をクリックした後に、店舗で注文を行った回数。

この指標はフィードアイテムにのみ適用されます。

allConversionsFromOtherEngagement

number

ユーザーが広告をクリックした後で発生した、その他のコンバージョン(クチコミの投稿、店舗の場所の保存など)の件数を示します。

この指標はフィードアイテムにのみ適用されます。

allConversionsFromStoreVisit

number

ユーザーが広告をクリックした後に、店舗を訪問したと推定される回数です。

この指標はフィードアイテムにのみ適用されます。

allConversionsFromStoreWebsite

number

ユーザーが広告をクリックした後で、広告主様の店舗の URL に誘導された回数を示します。

この指標はフィード アイテムにのみ適用されます。

auctionInsightSearchAbsoluteTopImpressionPercentage

number

オークション分析レポートの一部で、検索結果ページの最も目立つ位置に他の広告主様の広告が表示された頻度を示します。この割合は、ページに表示されたオークションに対してのみ計算されます。

この指標は一般公開されていません。

auctionInsightSearchImpressionShare

number

この指標はオークション分析レポートの一部で、他の参加者が獲得したインプレッション数が、広告が表示可能だった合計インプレッション数に対して占める割合を示します。0.1 未満の値はすべて 0.0999 として報告されます。

この指標は一般公開されていません。

auctionInsightSearchOutrankingShare

number

この指標はオークション分析レポートの一部で、広告がオークションの他の参加者の広告よりも上位に表示されたインプレッション数(広告が表示可能だった合計インプレッション数に占める割合)を示します。0.1 未満の値はすべて 0.0999 として報告されます。

この指標は一般公開されていません。

auctionInsightSearchOverlapRate

number

オークション分析レポートの一部で、お客様の広告がインプレッションを獲得した際に、他の広告主様の広告もインプレッションを獲得した頻度を示します。

この指標は一般公開されていません。

auctionInsightSearchPositionAboveRate

number

この指標はオークション分析レポートの一部で、お客様と他の広告主様の両方の広告が同じページに掲載された際に、他の広告主様の広告がお客様のものより上位に掲載された割合を表します。

この指標は一般公開されていません。

auctionInsightSearchTopImpressionPercentage

number

オークション分析レポートの一部で、上位のオーガニック検索結果のすぐ近くに他の広告主様の広告が表示された頻度を示します。この割合は、ページに表示されたオークションのみに基づいて計算されます。

この指標は一般公開されていません。

averageCost

number

インタラクション 1 回に対してお支払いいただく料金の平均額です。広告にかかった費用の合計を、インタラクション数の合計で割った値です。

averageCpc

number

すべてのクリックの合計費用を、発生したクリックの合計数で割った値です。

averageCpe

number

広告エンゲージメントに対して請求された平均金額。すべての広告エンゲージメントにかかった合計費用を、広告エンゲージメントの合計数で割った値です。

averageCpm

number

平均インプレッション単価(CPM)。

averageCpv

number

広告の 1 回の視聴に対してお支払いいただく金額の平均です。平均広告視聴単価は、すべての広告の視聴にかかった合計費用を視聴回数で割って算出します。

averagePageViews

number

セッションあたりのページの平均閲覧回数です。

averageTimeOnSite

number

すべてのセッションの合計継続時間(秒単位)÷ セッション数。Google アナリティクスからインポートされました。

benchmarkAverageMaxCpc

number

類似商品に対して他の広告主様がどのように入札しているかを示します。

biddableAppInstallConversions

number

アプリのインストール数。

biddableAppPostInstallConversions

number

アプリ内コンバージョンの数。

benchmarkCtr

number

広告を見たユーザーがそれをクリックした頻度に基づいて、他の広告主の類似商品のショッピング広告のパフォーマンスを示します。

bounceRate

number

ユーザーがサイトの 1 つのページにのみアクセスしたクリックの割合。Google アナリティクスからインポートされました。

clicks

string (int64 format)

クリック数です。

combinedClicks

string (int64 format)

無料の検索結果での広告またはサイトのリスティングがクリックされた回数。詳しくは、ヘルプページ(https://support.google.com/google-ads/answer/3097241)をご覧ください。

combinedClicksPerQuery

number

無料の検索結果で広告またはサイトのリスティングがクリックされた回数(combinedClicks)を、合計クエリ数で割った値です。詳しくは、https://support.google.com/google-ads/answer/3097241 のヘルプページをご覧ください。

combinedQueries

string (int64 format)

無料の検索結果でお客様のサイトのページを返したか、お客様のテキスト広告のいずれかを表示した検索の回数。詳しくは、ヘルプページ(https://support.google.com/google-ads/answer/3097241)をご覧ください。

contentBudgetLostImpressionShare

number

予算が少なすぎるために、ディスプレイ ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: コンテンツ予算のインプレッション シェア損失率は 0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

contentImpressionShare

number

ディスプレイ ネットワークでお客様が実際に獲得したインプレッションの回数を、お客様の広告が表示候補となった推定回数で割ったものです。注: コンテンツのインプレッション シェアは 0.1~1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

conversionLastReceivedRequestDateTime

string

このコンバージョン アクションのコンバージョン タグが正常に配信され、Google 広告で確認された最後の日時。この配信イベントは、アトリビューション可能なコンバージョンに起因するものではない可能性があります(たとえば、適切な広告主の広告をクリックしていなかったブラウザからタグが配信された場合など)。日付と時刻は、お客様のタイムゾーンで指定します。

conversionLastConversionDate

string

このコンバージョン アクションの最新のコンバージョンの日付。日付はお客様のタイムゾーンで表示されます。

contentRankLostImpressionShare

number

広告ランクが低いために、広告がディスプレイ ネットワークで獲得できなかったインプレッションの推測割合。注: コンテンツ ランクのインプレッション シェア損失率は 0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

conversionsFromInteractionsRate

number

インタラクションからのコンバージョンの数を広告インタラクションの数(テキストのクリックや動画広告の閲覧など)で割った値。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

conversionsValue

number

コンバージョン値。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

newCustomerLifetimeValue

number

新規顧客のライフタイム コンバージョン値。アカウント単位またはキャンペーン単位で顧客獲得目標を設定している場合、入札対象コンバージョンの新規顧客からの追加のコンバージョン値が含まれます。キャンペーンで顧客の獲得目標を採用し、[新規顧客の獲得に高い入札単価を設定] を選択している場合、これらの値は最適化のために [conversionsValue] に含まれます。詳しくは、https://support.google.com/google-ads/answer/12080169 をご覧ください。

conversionsValuePerCost

number

コンバージョンの値を広告インタラクションの費用で割った値。includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

conversionsFromInteractionsValuePerInteraction

number

インタラクションから発生したコンバージョン値を広告インタラクションの数で割った値。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

conversions

number

コンバージョン数です。includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

costMicros

string (int64 format)

指定された期間における、クリック単価(CPC)による費用とインプレッション単価(CPM)による費用の総額です。

costPerAllConversions

number

広告インタラクションの費用をすべてのコンバージョンで割った値です。

costPerConversion

number

広告インタラクションの費用をコンバージョンで割った値です。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

costPerCurrentModelAttributedConversion

number

広告インタラクションの費用を、現在のモデルに起因するコンバージョンで割った値です。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

crossDeviceConversions

number

顧客が 1 つのデバイスで Google 広告で作成した広告をクリックした後、別のデバイスまたはブラウザで変換することによって発生するコンバージョン。クロスデバイス コンバージョンは、allConversions にすでに含まれています。

crossDeviceConversionsValueMicros

string (int64 format)

クロスデバイス コンバージョンの合計値(マイクロ単位)。

ctr

number

広告から発生したクリック数(クリック数)を、広告が表示された回数(インプレッション数)で割った値です。

currentModelAttributedConversions

number

現在選択しているアトリビューション モデルで、過去のコンバージョン データがどのように表示されるかを確認できます。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

currentModelAttributedConversionsFromInteractionsRate

number

現在のモデルで、インタラクションに起因するコンバージョンを広告インタラクション(テキスト広告のクリックや動画広告の視聴など)の数で割った値。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

モデルによって貢献度が割り当てられた現在のインタラクションに起因するコンバージョンの値を、広告インタラクションの数で割った値。includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

currentModelAttributedConversionsValue

number

現在のモデルで貢献度が割り当てられたコンバージョンの値。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

currentModelAttributedConversionsValuePerCost

number

現在のモデルに起因するコンバージョンの値を広告インタラクションの費用で割った値です。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

engagementRate

number

表示された広告に対して、ユーザーが広告を操作する頻度。広告の展開回数を広告が表示された回数で割った値です。

engagements

string (int64 format)

エンゲージメントの数。エンゲージメントは、ユーザーがライトボックス広告を展開したときにカウントされます。また、今後はその他の広告タイプもエンゲージメント関連の指標に対応していく予定です。

hotelAverageLeadValueMicros

number

クリックに基づく見込み顧客の平均価値。

hotelCommissionRateMicros

string (int64 format)

コミッション入札単価(マイクロ単位)。20% のコミッションは 200,000 と表されます。

hotelExpectedCommissionCost

number

推定コミッション費用。コミッション額に広告主様の通貨で表した hotel_commission_rate を掛けた値。

hotelPriceDifferencePercentage

number

報告対象のホテル広告主が提示した価格と、競合広告主が提示した最低価格の平均価格差。

hotelEligibleImpressions

string (int64 format)

フィード パフォーマンスに基づいてホテル パートナーが獲得できたはずのインプレッション数。

historicalQualityScore

string (int64 format)

品質スコア(履歴)。

gmailForwards

string (int64 format)

広告がメッセージとして他の人に転送された回数。

gmailSaves

string (int64 format)

ユーザーが Gmail 広告をメッセージとして受信トレイに保存した回数。

gmailSecondaryClicks

string (int64 format)

Gmail 広告の展開されている状態でのランディング ページのクリック数。

impressionsFromStoreReach

string (int64 format)

店舗の位置情報ベースの広告が表示された回数を示します。

この指標はフィード アイテムにのみ適用されます。

impressions

string (int64 format)

検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。

interactionRate

number

広告が表示された後にその広告をユーザーが操作する頻度。これは、インタラクション数を広告が表示された回数で割った値です。

interactions

string (int64 format)

インタラクションの数。インタラクションとは、その広告フォーマットに関連付けられた主要なユーザー行動(テキスト広告やショッピング広告に対するクリック、動画広告の視聴など)を指します。

invalidClickRate

number

レポート対象期間中のクリック総数(フィルタ済みとフィルタなしのクリック数)のうち、除外されたクリックの割合。

invalidClicks

string (int64 format)

Google が不正と判断し、料金を請求しないクリック数です。

messageChats

string (int64 format)

メッセージ トラッキング対象だった Click-to-Message インプレッションに対して開始されたメッセージ チャットの数。

messageImpressions

string (int64 format)

メッセージ トラッキング対象だった Click-to-Message インプレッション数。

messageChatRate

number

開始されたメッセージ チャットの数(messageChats)をメッセージのインプレッション数(messageImpressions)で割った値です。メッセージ オプションとメッセージ トラッキングが有効になっている広告インプレッションからユーザーがメッセージ チャットを開始する割合。メッセージのインプレッション 1 回あたりのこの割合は 1.0 を超える場合があります。

mobileFriendlyClicksPercentage

number

モバイル向けページに移動するモバイル クリックの割合。

optimizationScoreUplift

number

すべての最適化案による最適化スコアの上昇合計。

optimizationScoreUrl

string

Google 広告ウェブ インターフェースの [最適化スコア] ページの URL。この指標は customer または campaign から選択でき、segments.recommendation_type でセグメント化できます。たとえば、SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer は、一意の(customer、recommendationType)の組み合わせごとに URL を返します。

organicClicks

string (int64 format)

個々の検索語句によってオーガニック検索結果に表示されたサイトのリスティングがクリックされた回数です。詳しくは、https://support.google.com/google-ads/answer/3097241 のヘルプページをご覧ください。

organicClicksPerQuery

number

無料の検索結果でサイトのリスティングがクリックされた回数(organicClicks)を、お客様のサイトからページを返した検索の合計数(organicQueries)で割った値です。詳しくは、ヘルプページ(https://support.google.com/google-ads/answer/3097241)をご覧ください。

organicImpressions

string (int64 format)

無料検索結果でのサイトのリスティング数。詳しくは、ヘルプページ(https://support.google.com/google-ads/answer/3097241)をご覧ください。

organicImpressionsPerQuery

number

サイトのページが無料の検索結果に掲載された回数(organicImpressions)を、無料の検索結果にサイトのリスティングが返された検索数(organicQueries)で割った値です。詳しくは、https://support.google.com/google-ads/answer/3097241 のヘルプページをご覧ください。

organicQueries

string (int64 format)

無料の検索結果でサイトのリスティングを返した検索の合計回数。詳しくは、https://support.google.com/google-ads/answer/3097241 のヘルプページをご覧ください。

percentNewVisitors

number

(以前にサイトを訪問したことのないユーザーによる)初回セッションの割合。Google アナリティクスからインポートされました。

phoneCalls

string (int64 format)

オフラインの電話通話の数。

phoneImpressions

string (int64 format)

オフラインの転送電話番号の表示回数。

phoneThroughRate

number

着信回数(phoneCalls)を電話番号が表示された回数(phoneImpressions)で割った値。

relativeCtr

number

クリック率(Ctr)を、広告を表示するウェブサイト上のすべての広告主の平均クリック率で割った値です。ディスプレイ ネットワーク サイトでの広告のパフォーマンスを、同じサイトの他の広告と比較して測定します。

searchAbsoluteTopImpressionShare

number

最も目立つ位置に表示されるお客様のショッピングまたは検索の広告のインプレッションの割合。詳しくは、https://support.google.com/google-ads/answer/7501826 をご覧ください。0.1 未満の値はすべて 0.0999 として報告されます。

searchBudgetLostAbsoluteTopImpressionShare

number

予算の低さが原因で、広告が検索結果ページの上位の広告の 1 番目に入らなかった頻度の推定値です。注: 検索予算の検索広告の最上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchBudgetLostImpressionShare

number

予算が少なすぎるために、検索ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: 検索予算のインプレッション シェア損失率は、0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchBudgetLostTopImpressionShare

number

予算が少ないことが原因で、広告が上位のオーガニック検索結果のすぐ近くに表示されなかった回数の推定数。注: 検索予算の検索広告のページ上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchClickShare

number

検索ネットワークでのクリック数を、獲得可能だったと推定されるクリック数で割った値です。注: 検索クリック数シェアは 0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

searchExactMatchImpressionShare

number

キーワードのマッチタイプにかかわらず、キーワードと完全に一致した(またはキーワードの類似パターンである)検索語句に対して、検索ネットワークで受け取ることが可能だったインプレッションの推定数でインプレッション数を割った値です。注: 検索の完全一致のインプレッション シェアは 0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

searchImpressionShare

number

検索ネットワークでお客様が実際に獲得したインプレッションの回数を、お客様の広告が表示候補となった推定回数で割ったものです。注: 検索広告のインプレッション シェアは、0.1~1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

searchRankLostAbsoluteTopImpressionShare

number

広告ランクの低さが原因で、広告が検索結果ページの上位の広告の 1 番目に入らなかった割合(推定値)です。注: 検索ランクの検索広告の最上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchRankLostImpressionShare

number

広告ランクが低いために、広告が検索ネットワークで獲得できなかったインプレッションの推測割合。注: 検索ランクのインプレッション シェア損失率は、0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchRankLostTopImpressionShare

number

広告ランクの低さが原因で、広告が上位のオーガニック検索結果のすぐ近くに表示されなかった割合(推定)。注: 検索ランクの検索広告のページ上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

searchTopImpressionShare

number

上位の広告として実際に表示された広告のインプレッション数を、上位の広告として表示が見込めた広告のインプレッション数で割った値です。注: 検索の検索広告のページ上部インプレッション シェアは、0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

通常、上位の広告は上位のオーガニック検索結果の上に表示されますが、特定の検索語句では上位のオーガニック検索結果の下に表示されることもあります。

searchVolume

object (SearchVolumeRange)

検索語句の分析カテゴリの検索ボリュームの範囲。

speedScore

string (int64 format)

ユーザーがモバイルアプリをクリックした後のページの読み込み速度を表します。スコアは 1~10 の範囲で、10 が最速です。

averageTargetCpaMicros

string (int64 format)

平均目標コンバージョン単価。または、未設定の場合は未設定(ポートフォリオ入札戦略、または目標コンバージョン単価以外からトラフィックが発生したキャンペーンなど)になります。

averageTargetRoas

number

平均目標広告費用対効果。または、未設定の場合は未設定(たとえば、ポートフォリオ入札戦略または目標広告費用対効果以外からのトラフィックがあるキャンペーンなど)を設定します。

topImpressionPercentage

number

上位のオーガニック検索結果のすぐ近くに表示された広告インプレッションの割合です。

validAcceleratedMobilePagesClicksPercentage

number

有効な AMP ページに到達する Accelerated Mobile Pages(AMP)ランディング ページへの広告クリックの割合です。

valuePerAllConversions

number

すべてのコンバージョンをすべてのコンバージョン数で割った値。

valuePerAllConversionsByConversionDate

number

すべてのコンバージョン値をすべてのコンバージョン数で割った値。この列を日付とともに選択した場合、日付列の値はコンバージョンの日付を意味します。by_conversion_date 列について詳しくは、https://support.google.com/google-ads/answer/9549009 をご覧ください。

valuePerConversion

number

コンバージョンをコンバージョン数で割った値。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

valuePerConversionsByConversionDate

number

コンバージョンをコンバージョン数で割った値。includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/google-ads/answer/9549009 をご覧ください。

valuePerCurrentModelAttributedConversion

number

現在のモデルに起因するコンバージョンの値をコンバージョン数で割った値。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

videoQuartileP100Rate

number

ユーザーが動画を最後まで視聴したインプレッション数の割合。

videoQuartileP25Rate

number

ユーザーが動画の 25% を視聴したインプレッション数の割合。

videoQuartileP50Rate

number

ユーザーが動画の 50% を視聴したインプレッション数の割合。

videoQuartileP75Rate

number

ユーザーが動画の 75% を視聴したインプレッション数の割合。

videoViewRate

number

TrueView 動画広告の視聴回数を、インプレッション数(TrueView インディスプレイ広告のサムネイル インプレッションを含む)で割った値です。

videoViews

string (int64 format)

動画広告が再生された回数。

viewThroughConversions

string (int64 format)

ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像やリッチメディア広告を閲覧した後、別の広告を操作(クリックなど)することなく、サイトでコンバージョンに至ると発生します。

allConversionsFromLocationAssetClickToCall

number

課金対象の広告イベント(クリックまたはインプレッション)の後に、任意の位置サーフェスでの通話ボタンのクリック数。この指標は、アセットベースの位置情報から取得されます。

allConversionsFromLocationAssetDirections

number

課金対象の広告イベント(クリックまたはインプレッション)後に、任意の場所のサーフェスで運転ルートがクリックされた回数。この測定はアセットベースの地域から取得されます。

allConversionsFromLocationAssetMenu

number

課金対象の広告イベント(クリックまたはインプレッション)の発生後に、任意の場所サーフェスで発生したメニューリンクのクリック数。この測定はアセットベースの地域から取得されます。

allConversionsFromLocationAssetOrder

number

請求対象の広告イベント(クリックまたはインプレッション)後に、任意の場所のサーフェスでの注文クリック数。この指標は、アセットベースの位置情報から取得されます。

allConversionsFromLocationAssetOtherEngagement

number

請求対象の広告イベント(クリックまたはインプレッション)後に、任意の場所のサーフェスで行われた他のタイプのローカル アクション クリックの数。この測定はアセットベースの地域から取得されます。

allConversionsFromLocationAssetStoreVisits

number

請求対象の広告イベント(クリックまたはインプレッション)後の来店数の推定値。この測定はアセットベースの地域から取得されます。

allConversionsFromLocationAssetWebsite

number

課金対象の広告イベント(クリックまたはインプレッション)の後に、いずれかの場所でウェブサイトの URL がクリックされた回数。この指標は、アセットベースの位置情報から取得されます。

eligibleImpressionsFromLocationAssetStoreReach

string (int64 format)

店舗の場所が表示されたか、その場所がターゲティングに使用されていたインプレッション数。この測定はアセットベースの地域から取得されます。

viewThroughConversionsFromLocationAssetClickToCall

number

インプレッション後に、任意の店舗情報サーフェスで発生した通話ボタンのクリック数。この測定はアセットベースの地域から取得されます。

viewThroughConversionsFromLocationAssetDirections

number

インプレッション後に任意の場所のサーフェスで運転ルートがクリックされた回数。この測定はアセットベースの地域から取得されます。

viewThroughConversionsFromLocationAssetMenu

number

インプレッション後に、任意のロケーション サーフェスでのメニューリンクのクリック数。この指標は、アセットベースの位置情報から取得されます。

viewThroughConversionsFromLocationAssetOrder

number

インプレッション後に店舗サーフェスでクリックされた注文数。この指標は、アセットベースの位置情報から取得されます。

viewThroughConversionsFromLocationAssetOtherEngagement

number

インプレッション後にいずれかの場所のサーフェスで行われた、他のタイプのローカル アクションのクリック数です。この指標は、アセットベースの位置情報から取得されます。

viewThroughConversionsFromLocationAssetStoreVisits

number

インプレッション後に店舗に訪問したと推定されるユーザーの数です。この測定はアセットベースの地域から取得されます。

viewThroughConversionsFromLocationAssetWebsite

number

インプレッション後に、任意の店舗サーフェスでウェブサイトの URL がクリックされた回数。この測定はアセットベースの地域から取得されます。

orders

number

注文数は、広告に起因する購入コンバージョンの合計数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。あるコンバージョンについて、アトリビューションで過去の広告との接点(テキスト広告やショッピング広告のクリック、動画広告の視聴など)に貢献度が割り当てられると、そのコンバージョンが 1 件の注文としてカウントされます。例: ユーザーが帽子のショッピング広告をクリックし、販売者のウェブサイトで同じ帽子とシャツを 1 回の注文で購入しました。この場合、購入した商品は 2 つですが、1 件の注文としてカウントされます。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

averageOrderValueMicros

string (int64 format)

平均注文額とは、広告が貢献した注文 1 件あたりの平均収益です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。平均注文額は、注文の総収益を注文の総数で割った値です。例: 3 件の注文があり、それぞれ 10 ドル、15 ドル、20 ドルの収益がありました。この場合、平均注文額は 15 ドル((10 ドル + 15 ドル + 20 ドル)÷3)となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

averageCartSize

number

カートの平均サイズは、広告が貢献した各注文に含まれる商品の平均数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。カートの平均サイズは、販売された商品の総数を注文の総数で割った値です。例: 2 件の注文があり、1 件目には 3 個の商品、2 件目には 2 個の商品が含まれていました。この場合、カートの平均サイズは商品数 2.5 個((3+2)÷2)となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

costOfGoodsSoldMicros

string (int64 format)

売上原価(COGS)は、広告に起因する注文で販売された商品の売上原価の総額です。仕組み: Merchant Center で、すべての商品に売上原価を追加できます。カート コンバージョン レポートを作成すると、販売した商品の売上原価が照合され、個々の注文での総利益の計算に使われます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文の売上原価は 8 ドル(3 ドル + 5 ドル)となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

grossProfitMicros

string (int64 format)

総利益は、広告が貢献した注文で得られた収益から売上原価(COGS)を差し引いた額です。仕組み: 総利益とは、広告が貢献した商品販売で得られた収益から売上原価を差し引いた額です。総利益の計算の対象となるのは、Merchant Center で売上原価が設定されている商品のみです。例: ユーザーが帽子のショッピング広告をクリックし、販売者のウェブサイトから同じ帽子とシャツを 1 回の注文で購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。帽子の売上原価は 3 ドルで、シャツには売上原価が設定されていません。この場合、この注文で総利益の計算対象となるのは帽子のみとなり、総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

grossProfitMargin

number

粗利益率とは、広告が貢献した注文から得た総収益に対する総利益(総収益から売上原価を差し引いた金額)の割合です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。粗利益率は、総利益を総収益で割って 100% を掛けたものです。粗利益率の計算の対象となるのは、Merchant Center で売上原価が設定されている商品のみです。例: ユーザーが販売者のウェブサイトで帽子とシャツを 1 回の注文で購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。シャツの価格は 20 ドルで、売上原価は設定されていません。この注文で粗利益率の計算対象となるのは、売上原価が設定されている帽子のみになるため、粗利益率は 70%((10 ドル - 3 ドル) ÷ 10 ドル × 100%)となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

revenueMicros

string (int64 format)

収益は、広告が貢献した注文で得られた合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。収益は、広告によって獲得したすべての注文の合計額から、割引額を差し引いた額です。例: ユーザーが帽子のショッピング広告をクリックし、販売者のウェブサイトから同じ帽子とシャツを 1 回の注文で購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。注文全体に 5 ドルの割引が適用されています。この場合、この注文での収益は 25 ドル((10 ドル + 20 ドル) - 5 ドル)となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

unitsSold

number

販売数は、広告に起因する注文から販売された商品の総数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。販売数は、広告に起因するすべての注文から販売された商品の総数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とともに、シャツとジャケットを購入しました。この注文での販売数は 3 です。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

crossSellCostOfGoodsSoldMicros

string (int64 format)

クロスセルの売上原価(COGS)は、別の商品の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの売上原価とは、広告で宣伝されずに販売に至った商品の売上原価の総額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この注文でのクロスセルの売上原価は 5 ドルです。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

crossSellGrossProfitMicros

string (int64 format)

クロスセルの総利益とは、ある商品が別の商品の広告を経由して販売に至った場合、その収益から売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入に含まれている商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの総利益とは、広告が貢献したクロスセルで得られた収益から売上原価を差し引いた額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。シャツの価格は 20 ドルで、売上原価は 5 ドルです。この場合、この注文でのクロスセルの総利益は 15 ドル(20 ドル - 5 ドル)となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

crossSellRevenueMicros

string (int64 format)

クロスセルの収益は、ある商品が別の商品の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。広告で宣伝された商品と販売された商品が一致しない場合、その商品販売はクロスセルと見なされます。クロスセルの収益は、広告が貢献したクロスセルで得られた収益の合計額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文でのクロスセルの収益は 20 ドルとなります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

crossSellUnitsSold

number

クロスセルの販売数とは、ある商品が別の商品の広告から販売につながった数の合計です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの販売数は、広告に起因するすべての注文のうち、クロスセルされた商品の総数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とともに、シャツとジャケットを購入しました。この場合、この注文でのクロスセルの販売数は 2 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

leadCostOfGoodsSoldMicros

string (int64 format)

主力商品の売上原価(COGS)は、その商品自体の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。広告に掲載された商品と販売された商品が一致する場合、これらの商品の原価は主力商品の売上原価と見なされます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文での主力商品の売上原価は 3 ドルとなります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

leadGrossProfitMicros

string (int64 format)

主力商品の総利益とは、その商品自体の広告を経由して販売に至った商品の収益から、売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。広告に掲載された商品と販売された商品が一致する場合、これらの商品販売で得られた収益から売上原価を差し引いた金額が主力商品の総利益になります。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。この場合、この注文の主力商品の総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

leadRevenueMicros

string (int64 format)

主力商品の収益とは、ある商品がそれ自体の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の販売で得られた合計額が [主力商品の収益] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文での主力商品の収益は 10 ドルとなります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

leadUnitsSold

number

主力商品の販売数とは、その商品自体の広告を経由して販売に至った商品の合計数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の合計数が [主力商品の販売数] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツとジャケットを購入しました。この場合、この注文での主力商品の販売数は 1 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

uniqueUsers

string (int64 format)

指定した期間に広告を見たユニーク ユーザーの数。この指標は集計できません。また、リクエストできるのは 92 日以内の期間のみです。この指標は、ディスプレイ、動画、ファインド、アプリのキャンペーン タイプで使用できます。

averageImpressionFrequencyPerUser

number

リクエストされた期間中にユニーク ユーザーが広告を表示した平均回数。この指標は集計できません。92 日以内の期間でのみリクエストできます。この指標は、ディスプレイ、動画、ファインド、アプリの各キャンペーン タイプで使用できます。

InteractionEventType

支払い対象のインタラクションと無料インタラクションの種類を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
CLICK クリックしてサイトにアクセスします。ほとんどの場合、このインタラクションによって外部サイト(通常は広告主のランディング ページ)に移動します。これは、クリック イベントのデフォルトの InteractionEventType でもあります。
ENGAGEMENT 実際の場所で広告を操作するという、ユーザーが表明した意向。
VIDEO_VIEW ユーザーが動画広告を視聴しました。
NONE 広告コンバージョン イベントのデフォルトの InteractionEventType。これは、広告コンバージョン行で、無料インタラクション(広告コンバージョンなど)を「昇格」してコア指標の一部としてレポートする必要があることが示されていない場合に使用されます。これらは単純に他の(広告)コンバージョンです。

SearchVolumeRange

検索ボリュームの範囲。実際の検索ボリュームは、この範囲内にあります。

JSON 表現
{
  "min": string,
  "max": string
}
フィールド
min

string (int64 format)

検索ボリュームの下限。

max

string (int64 format)

検索ボリュームの上限。

セグメント

セグメントのみのフィールド

JSON 表現
{
  "adDestinationType": enum (AdDestinationType),
  "adNetworkType": enum (AdNetworkType),
  "budgetCampaignAssociationStatus": {
    object (BudgetCampaignAssociationStatus)
  },
  "clickType": enum (ClickType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionAttributionEventType": enum (ConversionAttributionEventType),
  "conversionLagBucket": enum (ConversionLagBucket),
  "conversionOrAdjustmentLagBucket": enum (ConversionOrAdjustmentLagBucket),
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "externalConversionSource": enum (ExternalConversionSource),
  "hotelCheckInDayOfWeek": enum (DayOfWeek),
  "hotelDateSelectionType": enum (HotelDateSelectionType),
  "hotelRateType": enum (HotelRateType),
  "hotelPriceBucket": enum (HotelPriceBucket),
  "keyword": {
    object (Keyword)
  },
  "monthOfYear": enum (MonthOfYear),
  "placeholderType": enum (PlaceholderType),
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "recommendationType": enum (RecommendationType),
  "searchEngineResultsPageType": enum (SearchEngineResultsPageType),
  "searchTermMatchType": enum (SearchTermMatchType),
  "slot": enum (Slot),
  "conversionValueRulePrimaryDimension": enum (ConversionValueRulePrimaryDimension),
  "skAdNetworkUserType": enum (SkAdNetworkUserType),
  "skAdNetworkAdEventType": enum (SkAdNetworkAdEventType),
  "skAdNetworkAttributionCredit": enum (SkAdNetworkAttributionCredit),
  "skAdNetworkCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "skAdNetworkSourceType": enum (SkAdNetworkSourceType),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityCity": string,
  "activityCountry": string,
  "activityRating": string,
  "activityState": string,
  "externalActivityId": string,
  "adGroup": string,
  "assetGroup": string,
  "auctionInsightDomain": string,
  "campaign": string,
  "conversionAction": string,
  "conversionActionName": string,
  "conversionAdjustment": boolean,
  "date": string,
  "geoTargetAirport": string,
  "geoTargetCanton": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetCounty": string,
  "geoTargetDistrict": string,
  "geoTargetMetro": string,
  "geoTargetMostSpecificLocation": string,
  "geoTargetPostalCode": string,
  "geoTargetProvince": string,
  "geoTargetRegion": string,
  "geoTargetState": string,
  "hotelBookingWindowDays": string,
  "hotelCenterId": string,
  "hotelCheckInDate": string,
  "hotelCity": string,
  "hotelClass": integer,
  "hotelCountry": string,
  "hotelLengthOfStay": integer,
  "hotelRateRuleId": string,
  "hotelState": string,
  "hour": integer,
  "interactionOnThisExtension": boolean,
  "month": string,
  "partnerHotelId": string,
  "productAggregatorId": string,
  "productCategoryLevel1": string,
  "productCategoryLevel2": string,
  "productCategoryLevel3": string,
  "productCategoryLevel4": string,
  "productCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productFeedLabel": string,
  "productItemId": string,
  "productLanguage": string,
  "productMerchantId": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "searchSubcategory": string,
  "searchTerm": string,
  "webpage": string,
  "week": string,
  "year": integer,
  "skAdNetworkConversionValue": string,
  "skAdNetworkSourceApp": {
    object (SkAdNetworkSourceApp)
  },
  "skAdNetworkSourceDomain": string,
  "skAdNetworkPostbackSequenceIndex": string,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
フィールド
adDestinationType

enum (AdDestinationType)

広告のリンク先の種類。

adNetworkType

enum (AdNetworkType)

広告ネットワークのタイプ。

budgetCampaignAssociationStatus

object (BudgetCampaignAssociationStatus)

予算とキャンペーンの関連付けのステータス。

clickType

enum (ClickType)

タイプをクリックします。

conversionActionCategory

enum (ConversionActionCategory)

コンバージョン アクションのカテゴリ。

conversionAttributionEventType

enum (ConversionAttributionEventType)

コンバージョン属性イベントタイプ。

conversionLagBucket

enum (ConversionLagBucket)

インプレッションからコンバージョンまでの日数を表す列挙値。

conversionOrAdjustmentLagBucket

enum (ConversionOrAdjustmentLagBucket)

インプレッションからコンバージョン、またはインプレッションからコンバージョンに対する調整までの日数を表す列挙値。

dayOfWeek

enum (DayOfWeek)

曜日(例: MONDAY)。

device

enum (Device)

指標が適用されるデバイス。

externalConversionSource

enum (ExternalConversionSource)

外部コンバージョンの発生元。

hotelCheckInDayOfWeek

enum (DayOfWeek)

ホテルのチェックイン日の曜日。

hotelDateSelectionType

enum (HotelDateSelectionType)

ホテル日付選択タイプ。

hotelRateType

enum (HotelRateType)

ホテルのレートタイプ。

hotelPriceBucket

enum (HotelPriceBucket)

ホテルの価格帯。

keyword

object (Keyword)

キーワード条件。

monthOfYear

enum (MonthOfYear)

月(1 月など)。

placeholderType

enum (PlaceholderType)

プレースホルダの種類。これは、フィードアイテムの指標でのみ使用されます。

productChannel

enum (ProductChannel)

商品のチャネル。

productChannelExclusivity

enum (ProductChannelExclusivity)

商品のチャネル独占性。

productCondition

enum (ProductCondition)

商品の状態。

recommendationType

enum (RecommendationType)

推奨事項の種類。

searchEngineResultsPageType

enum (SearchEngineResultsPageType)

検索エンジン結果ページ(SERP)の種類。

searchTermMatchType

enum (SearchTermMatchType)

広告の表示につながったキーワードのマッチタイプ(類似パターンを含む)。

slot

enum (Slot)

広告の位置。

conversionValueRulePrimaryDimension

enum (ConversionValueRulePrimaryDimension)

適用されたコンバージョン値のルールのメイン ディメンション。NO_RULE_APPLIED は、コンバージョン値のルールが適用されていないコンバージョンで記録された値の合計です。[元の値] には、値のルールが適用されたコンバージョンの元の値が表示されます。GEO_LOCATION、DEVICE、AUDIENCE には、コンバージョン値のルールの適用後に生じた調整額(差額)の合計が表示されます。

skAdNetworkUserType

enum (SkAdNetworkUserType)

iOS の Store Kit 広告ネットワークのユーザー タイプ。

skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

iOS の Store Kit 広告ネットワークの広告イベントタイプ。

skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

iOS の Store Kit 広告ネットワークのアトリビューションへの貢献度

skAdNetworkCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

iOS ストアキットの広告ネットワークのおおよそのコンバージョン値。

skAdNetworkSourceType

enum (SkAdNetworkSourceType)

iOS ストアキットの広告ネットワークのインストールを促進した広告が表示されたソースタイプ。null 値は、このセグメントが適用されないことを意味します。たとえば、iOS 以外のキャンペーンや、Apple から送信されたポストバックにソースドメインとソースアプリのどちらも含まれていなかった場合などです。

newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

ユーザーが新規顧客かリピーターかでコンバージョンを分類するために使用します。このセグメントは通常、顧客獲得目標の影響を測定するために使用されます。

activityAccountId

string (int64 format)

アクティビティ アカウント ID。

activityCity

string

旅行アクティビティを利用できる都市。

activityCountry

string

旅行アクティビティが利用可能な国。

activityRating

string (int64 format)

アクティビティの評価。

activityState

string

旅行アクティビティを利用できる州。

externalActivityId

string

広告主様が指定したアクティビティ ID。

adGroup

string

広告グループのリソース名。

assetGroup

string

アセット グループのリソース名。

auctionInsightDomain

string

オークション分析レポートの参加者のドメイン(表示 URL)。

campaign

string

キャンペーンのリソース名。

conversionAction

string

コンバージョン アクションのリソース名。

conversionActionName

string

コンバージョン アクション名。

conversionAdjustment

boolean

これにより、コンバージョン列が、元のコンバージョン数とコンバージョン値、およびコンバージョンが調整された場合の差分別に分割されます。False の行には元のデータが含まれ、true の行には、現在と最初に指定したデータとの差分が含まれます。2 つのデータを合計して調整後のデータを取得します。

date

string

指標が適用される日付。yyyy-MM-dd 形式(例: 2018-04-17)。

geoTargetAirport

string

空港を表す地域ターゲティング定数のリソース名。

geoTargetCanton

string

州を表す地域ターゲティング定数のリソース名。

geoTargetCity

string

都市を表す地域ターゲティング定数のリソース名。

geoTargetCountry

string

国を表す地域ターゲティング定数のリソース名。

geoTargetCounty

string

郡を表す地域ターゲティング定数のリソース名。

geoTargetDistrict

string

地区を表す地域ターゲティング定数のリソース名。

geoTargetMetro

string

大都市圏を表す地域ターゲティング定数のリソース名。

geoTargetMostSpecificLocation

string

特定の場所を表す地域ターゲティング定数のリソース名。

geoTargetPostalCode

string

郵便番号を表す地域ターゲティング定数のリソース名。

geoTargetProvince

string

都道府県を表す地域ターゲティング定数のリソース名。

geoTargetRegion

string

リージョンを表す地域ターゲティング定数のリソース名。

geoTargetState

string

州を表す地域ターゲティング定数のリソース名。

hotelBookingWindowDays

string (int64 format)

ホテルの予約可能期間(日数)。

hotelCenterId

string (int64 format)

Hotel Center の ID。

hotelCheckInDate

string

ホテルのチェックイン日。形式は yyyy-MM-dd です。

hotelCity

string

ホテルの都市。

hotelClass

integer

ホテルのクラス。

hotelCountry

string

ホテル所在地(国)。

hotelLengthOfStay

integer

ホテルの滞在日数。

hotelRateRuleId

string

ホテルのレートルール ID。

hotelState

string

ホテルの所在地(都市)。

hour

integer

時間帯(0 ~ 23 の数値)。

interactionOnThisExtension

boolean

フィード アイテムの指標でのみ使用されます。インタラクションの指標が、フィード アイテム自体で発生したのか、別の広告表示オプションや広告ユニットで発生したのかを示します。

month

string

月の初日の日付で表される月。yyyy-MM-dd の形式。

partnerHotelId

string

パートナー ホテル ID。

productAggregatorId

string (int64 format)

商品のアグリゲータ ID。

productCategoryLevel1

string

商品のカテゴリ(レベル 1)。

productCategoryLevel2

string

商品のカテゴリ(レベル 2)。

productCategoryLevel3

string

商品のカテゴリ(レベル 3)。

productCategoryLevel4

string

商品のカテゴリ(レベル 4)。

productCategoryLevel5

string

商品のカテゴリ(レベル 5)。

productBrand

string

商品のブランド。

productCountry

string

商品の販売先の国の地域ターゲティング定数のリソース名。

productCustomAttribute0

string

商品のカスタム属性 0。

productCustomAttribute1

string

商品のカスタム属性 1。

productCustomAttribute2

string

商品のカスタム属性 2。

productCustomAttribute3

string

商品のカスタム属性 3。

productCustomAttribute4

string

商品のカスタム属性 4。

productFeedLabel

string

商品のフィードラベル。

productItemId

string

商品の商品アイテム ID。

productLanguage

string

商品の言語の言語定数のリソース名。

productMerchantId

string (int64 format)

商品の販売者 ID。

productStoreId

string

商品のストア ID。

productTitle

string

商品のタイトル。

productTypeL1

string

商品のタイプ(レベル 1)。

productTypeL2

string

商品のタイプ(レベル 2)。

productTypeL3

string

商品のタイプ(レベル 3)。

productTypeL4

string

商品のタイプ(レベル 4)。

productTypeL5

string

商品のタイプ(レベル 5)。

quarter

string

四半期の初日の日付で表される四半期。四半期には暦年を使用します。たとえば、2018 年の第 2 四半期は 2018 年 4 月 1 日から始まります。yyyy-MM-dd の形式。

searchSubcategory

string

検索語句のサブカテゴリ。空の文字列は、他のサブカテゴリに該当しない検索語句のカテゴリをすべて含むサブカテゴリを表します。

searchTerm

string

検索語句。

webpage

string

ウェブページ条件を表す広告グループ条件のリソース名。

week

string

月曜日から日曜日までとして定義される週。月曜日の日付で表されます。形式は yyyy-MM-dd です。

year

integer

年(yyyy の形式)。

skAdNetworkConversionValue

string (int64 format)

iOS の Store Kit 広告ネットワークのコンバージョン値。null 値は、このセグメントが適用されないことを意味します(iOS 以外のキャンペーンなど)。

skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

iOS Store Kit 広告ネットワークのインストールを促進する広告が表示されたアプリ。null 値は、このセグメントが適用されないことを意味します(iOS 以外のキャンペーンなど)。また、Apple から送信されたポストバックに含まれていなかった場合も null になります。

skAdNetworkSourceDomain

string

iOS Store Kit 広告ネットワークのインストールを促進する広告が表示されたウェブサイト。null 値は、このセグメントが適用されないことを意味します(iOS 以外のキャンペーンや、Apple から送信されたポストバックに含まれていなかった場合など)。

skAdNetworkPostbackSequenceIndex

string (int64 format)

iOS ストアキットの広告ネットワークのポストバック シーケンス インデックス。

assetInteractionTarget

object (AssetInteractionTarget)

CustomerAsset、CampaignAsset、AdGroupAsset の指標でのみ使用。インタラクションの指標が、アセット自体で発生したのか、別のアセットや広告ユニットで発生したのかを示します。インタラクション(クリックなど)は、広告が同時に配信された場合、その広告のすべての要素(広告自体とサイトリンクなどのコンポーネント)全体でカウントされます。InteractionOnThisAsset が true の場合は、インタラクションがこの特定のアセットで発生していることを意味します。InteractionOnThisAsset が false の場合は、インタラクションがこの特定のアセットではなく、このアセットが配信される配信広告の他の部分にあることを意味します。

AdDestinationType

Google 広告のリンク先の種類を列挙する

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
NOT_APPLICABLE ユーザーを広告から他のサイトに誘導することを意図していない広告
WEBSITE ウェブサイト
APP_STORE iOS App Store または Google Play ストア
PHONE_CALL 電話アプリ
MAP_DIRECTIONS マップアプリ
LOCATION_LISTING 地域専用ページ
MESSAGE テキスト メッセージ
LEAD_FORM 見込み顧客の発掘フォーム
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS 不明なキーを含むコンバージョンの広告のリンク先

AdNetworkType

Google 広告ネットワーク タイプを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
SEARCH Google 検索。
SEARCH_PARTNERS 検索パートナー
CONTENT ディスプレイ ネットワークです。
MIXED クロスネットワーク。
YOUTUBE YouTube
GOOGLE_TV Google TV

BudgetCampaignAssociationStatus

BudgetCampaignAssociationStatus セグメント。

JSON 表現
{
  "status": enum (BudgetCampaignAssociationStatus),
  "campaign": string
}
フィールド
status

enum (BudgetCampaignAssociationStatus)

予算キャンペーンの関連付けのステータス。

campaign

string

キャンペーンのリソース名。

BudgetCampaignAssociationStatus

予算とキャンペーンの関連付けのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED キャンペーンで現在予算が使用されている。
REMOVED キャンペーンで予算が使用されなくなった。

ClickType

Google 広告のクリックタイプを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
BREADCRUMBS パンくずリスト。
BROADBAND_PLAN ブロードバンドのプラン。
CALL_TRACKING 手動でダイヤルされた通話。
CALLS 電話件数] の順にクリックします。
CLICK_ON_ENGAGEMENT_AD エンゲージメント広告をクリックします。
GET_DIRECTIONS 運転ルート。
LOCATION_EXPANSION 場所の詳細を取得します。
LOCATION_FORMAT_CALL 通話する。
LOCATION_FORMAT_DIRECTIONS ルート] を選択します。
LOCATION_FORMAT_IMAGE 画像。
LOCATION_FORMAT_LANDING_PAGE ランディング ページに移動する。
LOCATION_FORMAT_MAP 地図
LOCATION_FORMAT_STORE_INFO 店舗情報に移動。
LOCATION_FORMAT_TEXT テキスト。
MOBILE_CALL_TRACKING 携帯電話の電話。
OFFER_PRINTS 印刷のオファー。
OTHER その他
PRODUCT_EXTENSION_CLICKS 商品情報プラスボックスの商品情報。
PRODUCT_LISTING_AD_CLICKS ショッピング - 商品 - オンライン。
STORE_LOCATOR 付近の店舗を表示します。
URL_CLICKS 広告見出し
VIDEO_APP_STORE_CLICKS アプリストア。
VIDEO_CALL_TO_ACTION_CLICKS Call-to-Action オーバーレイ
VIDEO_CARD_ACTION_HEADLINE_CLICKS カード
VIDEO_END_CAP_CLICKS エンドキャップ。
VIDEO_WEBSITE_CLICKS ウェブサイト。
WIRELESS_PLAN ワイヤレス プラン。
PRODUCT_LISTING_AD_LOCAL ショッピング - 商品 - ローカル。
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL ショッピング - 商品 - マルチチャネル ローカル。
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE ショッピング - 商品 - マルチチャネル オンライン。
PRODUCT_LISTING_ADS_COUPON ショッピング - 商品 - クーポン。
PRODUCT_LISTING_AD_TRANSACTABLE ショッピング - 商品 - Google で販売。
PROMOTION_EXTENSION プロモーション表示オプション。
HOTEL_PRICE ホテルの料金。
PRICE_EXTENSION 価格表示オプション。
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION Google で予約 - ホテルの客室の選択。
SHOPPING_COMPARISON_LISTING ショッピング - ショッピング比較
CROSS_NETWORK クロス ネットワーク。P-MAX キャンペーンとファインド キャンペーンからエクスポートします。

ConversionAttributionEventType

貢献度が割り当てられたコンバージョンのイベントタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは不明な値を表します。
IMPRESSION コンバージョンがインプレッションに関連付けられます。
INTERACTION コンバージョンがインタラクションに関連付けられる。

ConversionLagBucket

インプレッションからコンバージョンまでの日数を表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
LESS_THAN_ONE_DAY コンバージョン達成までの期間(0 ~ 1 日)。0 日が含まれ、1 日は含まれません。
ONE_TO_TWO_DAYS コンバージョン達成までの期間の範囲を 1~2 日に変更しました。1 日は含まれますが、2 日は含まれません。
TWO_TO_THREE_DAYS コンバージョン達成までの期間(2 ~ 3 日)。2 日間は含まれますが、3 日間は含まれません。
THREE_TO_FOUR_DAYS コンバージョン達成までの期間(3 ~ 4 日)。3 日は含まれますが、4 日は含まれません。
FOUR_TO_FIVE_DAYS コンバージョン達成までの期間のバケットを 4 日から 5 日に変更しました。4 日間は含まれますが、5 日間は含まれません。
FIVE_TO_SIX_DAYS コンバージョン達成までの期間のバケットを 5 日から 6 日に変更しました。5 日は含まれますが、6 日は含まれません。
SIX_TO_SEVEN_DAYS コンバージョン達成までの期間のバッグを 6 日から 7 日に変更しました。6 日間は含まれますが、7 日間は含まれません。
SEVEN_TO_EIGHT_DAYS コンバージョン達成までの期間(7 ~ 8 日)。7 日間は含まれますが、8 日間は含まれません。
EIGHT_TO_NINE_DAYS コンバージョン達成までの期間(8 ~ 9 日)。8 日間は含まれますが、9 日間は含まれません。
NINE_TO_TEN_DAYS コンバージョン達成までの期間のバッグを 9 日から 10 日に変更しました。9 日間は含まれますが、10 日間は含まれません。
TEN_TO_ELEVEN_DAYS コンバージョン達成までの期間(10 ~ 11 日)。10 日は含まれますが、11 日は含まれません。
ELEVEN_TO_TWELVE_DAYS コンバージョン達成までの期間のバケットを 11 日から 12 日に変更しました。11 日は含まれますが、12 日は含まれません。
TWELVE_TO_THIRTEEN_DAYS コンバージョン達成までの期間のバケットを 12 日から 13 日に変更しました。12 日は含まれますが、13 日は含まれません。
THIRTEEN_TO_FOURTEEN_DAYS コンバージョン達成までの期間(13 ~ 14 日間)。13 日は含まれますが、14 日は含まれません。
FOURTEEN_TO_TWENTY_ONE_DAYS コンバージョン達成までの期間(14 ~ 21 日間)。14 日は含まれますが、21 日は含まれません。
TWENTY_ONE_TO_THIRTY_DAYS コンバージョン達成までの期間のバケットを 21 日から 30 日に変更しました。21 日は含まれますが、30 日は含まれません。
THIRTY_TO_FORTY_FIVE_DAYS コンバージョン達成までの期間(30 ~ 45 日)。30 日は含まれますが、45 日は含まれません。
FORTY_FIVE_TO_SIXTY_DAYS コンバージョン達成までの期間のバケットを 45 日から 60 日に変更しました。45 日は含まれますが、60 日は含まれません。
SIXTY_TO_NINETY_DAYS コンバージョン達成までの期間のバケットを 60 日から 90 日に変更しました。60 日間は含まれますが、90 日間は含まれません。

ConversionOrAdjustmentLagBucket

インプレッションからコンバージョンまでの日数、またはインプレッションからコンバージョンの調整までの日数を表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
CONVERSION_LESS_THAN_ONE_DAY コンバージョン達成までの期間(0 ~ 1 日)。0 日が含まれ、1 日は含まれません。
CONVERSION_ONE_TO_TWO_DAYS コンバージョン達成までの期間の範囲を 1~2 日に変更しました。1 日は含まれますが、2 日は含まれません。
CONVERSION_TWO_TO_THREE_DAYS コンバージョン達成までの期間(2 ~ 3 日)。2 日間は含まれますが、3 日間は含まれません。
CONVERSION_THREE_TO_FOUR_DAYS コンバージョン達成までの期間(3 ~ 4 日)。3 日は含まれますが、4 日は含まれません。
CONVERSION_FOUR_TO_FIVE_DAYS コンバージョン達成までの期間のバケットを 4 日から 5 日に変更しました。4 日間は含まれますが、5 日間は含まれません。
CONVERSION_FIVE_TO_SIX_DAYS コンバージョン達成までの期間のバケットを 5 日から 6 日に変更しました。5 日は含まれますが、6 日は含まれません。
CONVERSION_SIX_TO_SEVEN_DAYS コンバージョン達成までの期間のバッグを 6 日から 7 日に変更しました。6 日間は含まれますが、7 日間は含まれません。
CONVERSION_SEVEN_TO_EIGHT_DAYS コンバージョン達成までの期間(7 ~ 8 日)。7 日間は含まれますが、8 日間は含まれません。
CONVERSION_EIGHT_TO_NINE_DAYS コンバージョン達成までの期間(8 ~ 9 日)。8 日間は含まれますが、9 日間は含まれません。
CONVERSION_NINE_TO_TEN_DAYS コンバージョン達成までの期間のバッグを 9 日から 10 日に変更しました。9 日間は含まれますが、10 日間は含まれません。
CONVERSION_TEN_TO_ELEVEN_DAYS コンバージョン達成までの期間(10 ~ 11 日)。10 日は含まれますが、11 日は含まれません。
CONVERSION_ELEVEN_TO_TWELVE_DAYS コンバージョン達成までの期間のバケットを 11 日から 12 日に変更しました。11 日は含まれますが、12 日は含まれません。
CONVERSION_TWELVE_TO_THIRTEEN_DAYS コンバージョン達成までの期間のバケットを 12 日から 13 日に変更しました。12 日は含まれますが、13 日は含まれません。
CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS コンバージョン達成までの期間(13 ~ 14 日間)。13 日は含まれますが、14 日は含まれません。
CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS コンバージョン達成までの期間(14 ~ 21 日間)。14 日は含まれますが、21 日は含まれません。
CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS コンバージョン達成までの期間のバケットを 21 日から 30 日に変更しました。21 日は含まれますが、30 日は含まれません。
CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS コンバージョン達成までの期間(30 ~ 45 日)。30 日は含まれますが、45 日は含まれません。
CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS コンバージョン達成までの期間のバケットを 45 日から 60 日に変更しました。45 日は含まれますが、60 日は含まれません。
CONVERSION_SIXTY_TO_NINETY_DAYS コンバージョン達成までの期間(60 ~ 90 日)。60 日は含まれますが、90 日は含まれません。
ADJUSTMENT_LESS_THAN_ONE_DAY コンバージョンの調整ラグバケット(0 ~ 1 日)。0 日が含まれ、1 日は含まれません。
ADJUSTMENT_ONE_TO_TWO_DAYS コンバージョンの調整までの期間(1 ~ 2 日)。1 日は含まれますが、2 日は含まれません。
ADJUSTMENT_TWO_TO_THREE_DAYS コンバージョン調整までの所要期間(2 ~ 3 日)。2 日は含まれますが、3 日は含まれません。
ADJUSTMENT_THREE_TO_FOUR_DAYS コンバージョン調整ラグ バケットを 3 日から 4 日に変更しました。3 日間は含まれますが、4 日間は含まれません。
ADJUSTMENT_FOUR_TO_FIVE_DAYS コンバージョン調整までの所要期間(4 ~ 5 日)4 日間は含まれますが、5 日間は含まれません。
ADJUSTMENT_FIVE_TO_SIX_DAYS コンバージョンの調整期間(5 ~ 6 日)5 日は含まれますが、6 日は含まれません。
ADJUSTMENT_SIX_TO_SEVEN_DAYS コンバージョン調整までの所要期間(6 ~ 7 日)6 日間は含まれますが、7 日間は含まれません。
ADJUSTMENT_SEVEN_TO_EIGHT_DAYS コンバージョン調整ラグ バケットを 7 日から 8 日に変更しました。7 日間は含まれますが、8 日間は含まれません。
ADJUSTMENT_EIGHT_TO_NINE_DAYS コンバージョン調整ラグ バケットを 8 日から 9 日に変更しました。8 日間は含まれますが、9 日間は含まれません。
ADJUSTMENT_NINE_TO_TEN_DAYS コンバージョンの調整ラグバケット(9 ~ 10 日間)。9 日間は含まれますが、10 日間は含まれません。
ADJUSTMENT_TEN_TO_ELEVEN_DAYS コンバージョン調整ラグ バケットを 10 日から 11 日に変更しました。10 日間は含まれますが、11 日目は含まれません。
ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS コンバージョンの調整期間(11 ~ 12 日間)11 日は含まれますが、12 日は含まれません。
ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS コンバージョン調整の遅延バケットを 12 日から 13 日に変更しました。12 日は含まれますが、13 日は含まれません。
ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS コンバージョンの調整期間(13 ~ 14 日間)13 日は含まれますが、14 日は含まれません。
ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS コンバージョンの調整期間(14 ~ 21 日間)14 日は含まれますが、21 日は含まれません。
ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS コンバージョンの調整期間(21 ~ 30 日)21 日間は含まれますが、30 日間は含まれません。
ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS コンバージョンの調整期間(30 ~ 45 日間)30 日は含まれますが、45 日は含まれません。
ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS コンバージョンの調整期間(45 ~ 60 日)45 日間は含まれますが、60 日は含まれません。
ADJUSTMENT_SIXTY_TO_NINETY_DAYS コンバージョンの調整期間(60 ~ 90 日間)60 日は含まれますが、90 日は含まれません。
ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS コンバージョンの調整期間(90 ~ 145 日)90 日は含まれますが、145 日は含まれません。
CONVERSION_UNKNOWN コンバージョン達成までの期間バケットが不明です。これは、Google 広告でコンバージョン達成までの期間バケットが利用可能になる前の日付用です。
ADJUSTMENT_UNKNOWN コンバージョン調整のラグ バケットは不明です。これは、Google 広告でコンバージョン調整ラグ バケットが利用可能になる前の日付です。

ExternalConversionSource

ConversionAction に関連付けられた外部のコンバージョンの発生元。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは不明な値を表します。
WEBPAGE ユーザーが広告を表示した後に特定のウェブページに移動したときに発生するコンバージョン。Google 広告の管理画面では「ウェブサイト」と表示されます。
ANALYTICS リンクされた Google アナリティクスの目標またはトランザクションから発生したコンバージョン。Google 広告の管理画面では「アナリティクス」と表示されます。
UPLOAD ConversionUploadService を使用してアップロードされたウェブサイト コンバージョン。Google 広告の管理画面には「クリックからインポート」と表示されます。
AD_CALL_METRICS ユーザーが広告の電話番号表示オプションを直接クリックしたときに発生するコンバージョン。Google 広告の管理画面では「広告からの通話」と表示されます。
WEBSITE_CALL_METRICS ユーザーが広告をクリックした後に、広告主様のウェブサイトから動的に生成された電話番号(インストール済みの JavaScript を使って)に電話をかけたときに発生するコンバージョン。Google 広告の UI には「ウェブサイトからの通話」と表示されます。
STORE_VISITS ユーザーが Google 広告をクリックした後に広告主の実店舗にアクセスしたときに発生するコンバージョン。Google 広告の管理画面では「来店」と表示されます。
ANDROID_IN_APP ユーザーが Android アプリで購入などのアプリ内行動を行ったときに発生するコンバージョン。Google 広告の管理画面では「Android アプリ内行動」と表示されます。
IOS_IN_APP ユーザーが iOS アプリで購入などのアプリ内ユーザー行動を行ったときに発生するコンバージョン。Google 広告の管理画面では「iOS のアプリ内コンバージョン」として表示されます。
IOS_FIRST_OPEN ユーザーが iOS アプリを初めて開いたときに発生するコンバージョン。Google 広告の UI には「iOS アプリのインストール(初回起動)」と表示されます。
APP_UNSPECIFIED AppPlatform が指定されていない従来のアプリ コンバージョン。Google 広告の管理画面では「モバイルアプリ」と表示されます。
ANDROID_FIRST_OPEN ユーザーが Android アプリを初めて開いたときに発生するコンバージョン。Google 広告の UI には「Android アプリのインストール(初回起動)」と表示されます。
UPLOAD_CALLS ConversionUploadService を通じてアップロードされた通話コンバージョン。Google 広告の管理画面では「通話からインポート」と表示されます。
FIREBASE リンクされた Firebase イベントに起因するコンバージョン。Google 広告の UI には「Firebase」と表示されます。
CLICK_TO_CALL ユーザーがスマートフォンの電話番号をクリックしたときに発生するコンバージョン。Google 広告の管理画面では「電話番号のクリック」と表示されます。
SALESFORCE Salesforce から発生したコンバージョン。Google 広告の管理画面では「Salesforce.com」と表示されます。
STORE_SALES_CRM CRM に記録された店舗内購入によるコンバージョン。Google 広告の管理画面には「店舗での販売(データ パートナー)」と表示されます。
STORE_SALES_PAYMENT_NETWORK 決済ネットワークによる店舗での購入によって発生したコンバージョン。Google 広告の管理画面では「店舗での販売(支払いネットワーク)」と表示されます。
GOOGLE_PLAY コーディング不要の Google Play コンバージョン。Google 広告の管理画面では「Google Play」と表示されます。
THIRD_PARTY_APP_ANALYTICS リンクされた第三者アプリ分析イベントに起因するコンバージョン。Google 広告の管理画面には「第三者アプリ分析」として表示されます。
GOOGLE_ATTRIBUTION Google アトリビューションによって制御されるコンバージョン。
STORE_SALES_DIRECT_UPLOAD ファーストパーティまたはサードパーティの販売者データのアップロードに基づく店舗販売コンバージョン。Google 広告の管理画面では「店舗販売(直接アップロード)」と表示されます。
STORE_SALES アップロードしたファーストパーティまたはサードパーティの販売者データに基づく店舗販売コンバージョンや、決済ネットワークのカードを使用した店舗での購入コンバージョン。Google 広告の管理画面では「店舗販売」と表示されます。
SEARCH_ADS_360 検索広告 360 の Floodlight データからインポートされたコンバージョン。
GOOGLE_HOSTED 広告の操作後に Google のプロダクトやサービスで発生したローカル アクションをトラッキングするコンバージョン。
FLOODLIGHT Floodlight タグによって報告されたコンバージョン。
ANALYTICS_SEARCH_ADS_360 検索広告 360 専用の Google アナリティクスのコンバージョン。Google 広告の管理画面では「アナリティクス(検索広告 360)」と表示されます。
FIREBASE_SEARCH_ADS_360 検索広告 360 にリンクされた Firebase イベントからのコンバージョン。
DISPLAY_AND_VIDEO_360_FLOODLIGHT ディスプレイ&ビデオ 360 の Floodlight によってレポートされるコンバージョン。

HotelRateType

利用可能なホテルのレートタイプを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
UNAVAILABLE 料金タイプの情報を利用できません。
PUBLIC_RATE すべてのユーザーが利用できる料金。
QUALIFIED_RATE メンバーシップ プログラムの料金が利用可能で、公開料金の提供など、基本的な要件を満たしている。UI の処理には公開料金に取り消し線が引かれ、ユーザーが割引を利用できることを示します。適格な料金について詳しくは、https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates をご覧ください。
PRIVATE_RATE ログインしているすべてのユーザー、モバイル ユーザーの 20%、カナダのすべてのモバイル ユーザーなど、特定の利用条件を満たすユーザーが利用できる料金。

HotelPriceBucket

ホテルの料金バケットの候補を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
LOWEST_UNIQUE 唯一の最低価格。パートナーが最低料金で、その料金からわずかに変動しないパートナーが他にいない。
LOWEST_TIED 価格が最も安い。パートナーの最低価格からわずかな変動幅の範囲内である。
NOT_LOWEST 最低価格ではない。パートナーが最低価格からわずかな差異以内に該当しない場合。
ONLY_PARTNER_SHOWN パートナーのみが表示された。

キーワード

キーワードの条件セグメントです。

JSON 表現
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
フィールド
info

object (KeywordInfo)

キーワードの情報。

adGroupCriterion

string

AdGroupCriterion リソース名。

SearchEngineResultsPageType

検索エンジン結果ページ(SERP)の種類。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ADS_ONLY 検索エンジンの検索結果ページに広告のみが表示されていた。
ORGANIC_ONLY 検索エンジン結果ページにはオーガニック検索結果のみが含まれていました。
ADS_AND_ORGANIC 検索エンジン結果ページに広告とオーガニック検索結果の両方が含まれていた。

SearchTermMatchType

広告表示につながったキーワードのマッチタイプ(バリエーションを含む)。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BROAD 部分一致。
EXACT 完全一致。
PHRASE フレーズ一致。
NEAR_EXACT 完全一致(類似パターン)。
NEAR_PHRASE フレーズ一致(類似パターン)

スロット

広告の表示可能な位置を列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
SEARCH_SIDE Google 検索: 側部。
SEARCH_TOP Google 検索: 上部。
SEARCH_OTHER Google 検索: その他
CONTENT Google ディスプレイ ネットワークを担当しております。
SEARCH_PARTNER_TOP 検索パートナー: 上部。
SEARCH_PARTNER_OTHER 検索パートナー: その他。
MIXED クロス ネットワーク。

ConversionValueRulePrimaryDimension

コンバージョン値のルールの統計情報のメイン ディメンションを識別します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
NO_RULE_APPLIED 値のルールが有効になった後に、値のないルールが適用されたコンバージョンの場合。
ORIGINAL 以下は、価値ルールが適用されたコンバージョンです。元の統計情報です。
NEW_VS_RETURNING_USER 新規顧客またはリピート ユーザーの条件が満たされた場合。
GEO_LOCATION クエリ時の位置情報の条件が満たされたとき。
DEVICE クエリ時の閲覧デバイスの条件が満たされたとき。
AUDIENCE クエリ時のオーディエンスの条件が満たされたとき。
MULTIPLE 複数のルールが適用される場合。

SkAdNetworkUserType

SkAdNetwork ユーザータイプを列挙する

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
UNAVAILABLE 値がポストバックに含まれていなかった、またはそれ以外の理由によりこのデータを使用できない。
NEW_INSTALLER ユーザーがアプリケーションを初めてインストールした。
REINSTALLER ユーザーがすでにアプリをインストールしている。

SkAdNetworkAdEventType

SkAdNetwork 広告イベントタイプを列挙する

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
UNAVAILABLE 値がポストバックに存在しないか、他の理由でこのデータがありません。
INTERACTION ユーザーが広告を操作しました。
VIEW ユーザーが広告を視聴しました。

SkAdNetworkSourceApp

SkAdNetworkSourceApp セグメント。

JSON 表現
{
  "skAdNetworkSourceAppId": string
}
フィールド
skAdNetworkSourceAppId

string

iOS ストアキットの広告ネットワークのインストールを促す広告が表示されたアプリ ID。

SkAdNetworkAttributionCredit

SkAdNetwork アトリビューションの貢献度を列挙します。

列挙型
UNSPECIFIED デフォルト値。この値は null と同じです。
UNKNOWN この API バージョンでは値が不明です。この API バージョンでは、true の列挙型値を返すことはできません。また、まだサポートされていません。
UNAVAILABLE 値がポストバックに存在しないか、他の理由でこのデータがありません。
WON Google が広告の帰属表示を獲得した広告ネットワークである。
CONTRIBUTED Google はアトリビューション認定の対象でしたが、落札できませんでした。

SkAdNetworkSourceType

SKAdNetwork のソースタイプを列挙する

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
UNAVAILABLE ソースアプリ ID またはソースドメインがポストバックに含まれていなかった、またはそれ以外の理由によりこのデータを使用できない。
WEBSITE 広告がウェブページに表示された。
MOBILE_APPLICATION アプリで広告が表示された。

AssetInteractionTarget

AssetInteractionTarget セグメント。

JSON 表現
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
フィールド
asset

string

アセットのリソース名。

interactionOnThisAsset

boolean

CustomerAsset、CampaignAsset、AdGroupAsset の指標でのみ使用。インタラクションの指標が、アセット自体で発生したのか、別のアセットや広告ユニットで発生したのかを示します。

ConvertingUserPriorEngagementTypeAndLtvBucket

コンバージョンに至ったユーザーの以前のエンゲージメント タイプとライフタイム バリュー バケットを列挙します

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
NEW コンバージョンに至るユーザーは、その広告主にとって初めてである。
RETURNING コンバージョンに至ったユーザーが広告主様のサイトに戻っています。リピーターの定義は、2 回目の来店と 2 回目のオンライン購入など、コンバージョンの種類によって異なります。
NEW_AND_HIGH_LTV コンバージョンに至ったユーザーが広告主様にとって新規で、ライフタイム バリューが高い。