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)
  },
  "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)
  },
  "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)
  },
  "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)
  },
  "mobileAppCategoryConstant": {
    object (MobileAppCategoryConstant)
  },
  "mobileDeviceConstant": {
    object (MobileDeviceConstant)
  },
  "offlineUserDataJob": {
    object (OfflineUserDataJob)
  },
  "operatingSystemVersionConstant": {
    object (OperatingSystemVersionConstant)
  },
  "paidOrganicSearchTermView": {
    object (PaidOrganicSearchTermView)
  },
  "qualifyingQuestion": {
    object (QualifyingQuestion)
  },
  "parentalStatusView": {
    object (ParentalStatusView)
  },
  "perStoreView": {
    object (PerStoreView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "productLink": {
    object (ProductLink)
  },
  "recommendation": {
    object (Recommendation)
  },
  "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)
  },
  "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)

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

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)

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

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)

クエリで参照される 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)

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

customerNegativeCriterion

object (CustomerNegativeCriterion)

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

customerSearchTermInsight

object (CustomerSearchTermInsight)

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

customerUserAccess

object (CustomerUserAccess)

クエリで参照される CustomerUserAccess。

customerUserAccessInvitation

object (CustomerUserAccessInvitation)

クエリで参照される CustomerUserAccessInvite。

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)

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

mobileAppCategoryConstant

object (MobileAppCategoryConstant)

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

mobileDeviceConstant

object (MobileDeviceConstant)

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

offlineUserDataJob

object (OfflineUserDataJob)

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

operatingSystemVersionConstant

object (OperatingSystemVersionConstant)

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

paidOrganicSearchTermView

object (PaidOrganicSearchTermView)

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

qualifyingQuestion

object (QualifyingQuestion)

クエリで言及されている見込み顧客を選別するための質問。

parentalStatusView

object (ParentalStatusView)

クエリで参照されている子供の有無のビュー。

perStoreView

object (PerStoreView)

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

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

クエリで参照されている商品の入札カテゴリ。

productGroupView

object (ProductGroupView)

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

recommendation

object (Recommendation)

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

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)

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

metrics

object (Metrics)

指標。

segments

object (Segments)

セグメント。

AccountBudget

アカウント単位の予算。予算そのものに関する情報だけでなく、予算に対して最近承認された変更と承認待ちの変更の提案に関する情報も含まれます。承認待ちで提案された変更がある場合は、[pendingProposal] に表示されます。予算に関する有効な詳細は、先頭に「approved_」と「adjusted_」が付いているフィールド、および接頭辞が付いていないフィールドで確認できます。一部の効果的な詳細はユーザーが最初にリクエストした内容(費用上限など)と異なる場合があるため、これらの違いは「proposed_」、「approved_」、場合によっては「adjusted_」フィールドで並置されます。

このリソースは AccountBudgetProposal を使用して変更されており、直接変更することはできません。1 つの予算に同時に保留されるプロポーザルは 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)

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

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

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 Asset Combination ビューのリソース名の形式は 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 とアセットのリンク。現在のところ、AppAds とレスポンシブ検索広告では AdGroupAdAssetView のみがサポートされています。

JSON 表現
{
  "resourceName": string,
  "fieldType": enum (AssetFieldType),
  "policySummary": {
    object (AdGroupAdAssetPolicySummary)
  },
  "performanceLabel": enum (AssetPerformanceLabel),
  "pinnedField": enum (ServedAssetFieldType),
  "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)

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

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

広告グループの条件のシミュレーション。広告チャネルのタイプ、条件タイプ、シミュレーション タイプ、シミュレーションの変更方法のサポートされている組み合わせについては、下記をご覧ください。Hotel AdGroupCriterion のシミュレーション オペレーションは V5 から開始されます。

  1. ディスプレイ - キーワード - CPC_BID - UNIFORM
  2. 検索 - キーワード - CPC_BID - UNIFORM
  3. ショッピング - リスティング グループ - CPC_BID - UNIFORM
  4. ホテル - リスティング グループ - CPC_BID - UNIFORM
  5. ホテル - リスティング グループ - クリック単価の割合(クリック単価) - 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)

一連のクリック単価入札額の予測指標。

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. 検索 - 目標広告費用対効果 - UNIFORM
  5. ディスプレイ - CPC_BID - デフォルト
  6. ディスプレイ - 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

特定の広告視聴単価での予測される指標です。

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

string (int64 format)

予測指標の基となるシミュレーションの広告視聴単価。

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,

  // 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)

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

共用体フィールド 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/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

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

assetGroupListingGroupFilter

string

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

AssetSetTypeView

アセットセット タイプのビュー。このビューでは、アセットセットのタイプごとに過大カウントされていない指標がレポートされます。子アセットセットのタイプは、このレポートには含まれません。これらのデータは、親アセットセット タイプごとに集計されます。

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

string

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

customers/{customerId}/assetSetTypeViews/{assetSetType}

assetSetType

enum (AssetSetType)

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

BiddingStrategySimulation

入札戦略のシミュレーション。シミュレーション タイプとシミュレーション変更方法のサポートされている組み合わせについては、以下で説明します。

  1. TARGET_CPA - UNIFORM
  2. 目標広告費用対効果 - 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 - 調整
  • 検索 - 目標広告費用対効果 - UNIFORM
  • 検索 - TARGET_impressions_SHARE - UNIFORM
  • 検索 - 予算 - 統一
  • ショッピング - 予算 - ユニフォーム
  • ショッピング - 目標広告費用対効果 - UNIFORM
  • MULTI_CHANNEL - TARGET_CPA - UNIFORM
  • MULTI_CHANNEL - 目標広告費用対効果 - UNIFORM
  • ファインド - 目標コンバージョン単価 - デフォルト
  • ディスプレイ - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - TARGET_CPA - UNIFORM
  • PERFORMANCE_MAX - 目標広告費用対効果 - UNIFORM
  • P-MAX - 予算 - UNIFORM
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_STATE_SHARE の場合のシミュレーション ポイント。

budgetPointList

object (BudgetSimulationPointList)

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

TargetImpressionShareSimulationPointList

TARGET_ENCE_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 万(100%)を超えることはありません。

requiredCpcBidCeilingMicros

string (int64 format)

このシミュレーションを実現するために広告主様が設定する必要がある、1 日あたりの必要なクリック単価の上限を、100 万米ドル単位(マイクロ秒単位)で示します。

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
}
フィールド
budgetAmountMicros

string (int64 format)

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

requiredCpcBidCeilingMicros

string (int64 format)

このシミュレーションを実現するために広告主様が設定する必要がある、1 日あたりの必要なクリック単価の上限を、100 万米ドル単位(マイクロ秒単位)で示します。このフィールドは、目標予算入札戦略が設定されているキャンペーンでのみ使用できます。

biddableConversions

number

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

biddableConversionsValue

number

入札単価設定に使用されるコンバージョンの推定合計額です。

clicks

string (int64 format)

予測されるクリック数。

costMicros

string (int64 format)

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

impressions

string (int64 format)

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

topSlotImpressions

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 広告グループ リソースの変更。
AD_GROUP_CRITERION AdGroupCriterion リソースの変更。
CAMPAIGN 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 アセット リソースの変更。
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 テンプレートを設定すると、検索広告 360 のクリックサーブ URL で自動的にラップされます。
OTHER 分類されていない変更の種類(例: 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 リソースの変更。
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 アセット リソースの変更。
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

出力専用。アクセス可能な入札戦略のリソース名。AccessibleBiddingStrategy リソース名の形式:

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}

id

string (int64 format)

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

name

string

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

type

enum (BiddingStrategyType)

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

ownerCustomerId

string (int64 format)

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

ownerDescriptiveName

string

出力のみ。入札戦略を所有する顧客の説明名。

共用体フィールド scheme。入札方式。

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

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

targetCpa

object (TargetCpa)

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

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

指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する自動入札戦略です。

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

string (int64 format)

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

TargetImpressionShare

一定の割合の検索広告が最初のページ(または他の対象地域)の上部に表示されるように入札単価を設定する自動入札戦略です。

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 は、マネージャーの顧客に対してのみ存在します。直接クライアントと間接クライアントのすべての顧客と、MCC アカウントが含まれます。

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

出力専用。特定の顧客に関連付けられている client-customer のリソース名。読み取り専用。

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

出力専用。detailsDemographic の親。

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 ユーザーは場所の 25 km 以内にいました。
WITHIN_30KM ユーザーは場所の 30 km 以内にいました。
WITHIN_35KM ユーザーは場所の 35 km 以内にいました。
WITHIN_40KM ユーザーは場所の 40 km 以内にいました。
WITHIN_45KM ユーザーは場所の 45 km 以内にいました。
WITHIN_50KM ユーザーは場所の 50 km 以内にいました。
WITHIN_55KM ユーザーは場所の 55 km 以内にいました。
WITHIN_60KM ユーザーは場所の 60 km 以内にいました。
WITHIN_65KM ユーザーは場所の 65 km 以内にいました。
BEYOND_65KM ユーザーは場所の 65km を超えていた。
WITHIN_0_7MILES ユーザーは場所の 1.2 km 以内にいました。
WITHIN_1MILE ユーザーは場所の 1 マイル以内にいました。
WITHIN_5MILES ユーザーは場所の 8 km 以内にいました。
WITHIN_10MILES ユーザーは場所の 10 マイル以内にいました。
WITHIN_15MILES ユーザーは場所の 15 マイル以内にいました。
WITHIN_20MILES ユーザーは場所の 20 マイル以内にいました。
WITHIN_25MILES ユーザーは場所の 40 km 以内にいました。
WITHIN_30MILES ユーザーは場所の 30 マイル以内にいました。
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 アカウントの ID。

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

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

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

string

出力専用。ビジネス ビューのリソース名。ビジネス情報ビューのリソース名の形式は次のとおりです。

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

ManagedPlacementView

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

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

string

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

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

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 タブレット。

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。

ProductBiddingCategoryConstant

商品の入札カテゴリ。

JSON 表現
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
フィールド
resourceName

string

出力専用。商品入札カテゴリのリソース名。商品入札カテゴリのリソース名の形式は次のとおりです。

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

出力専用。商品入札カテゴリのレベル。

status

enum (ProductBiddingCategoryStatus)

出力専用。商品入札カテゴリのステータス。

id

string (int64 format)

出力専用。商品入札カテゴリの ID。

この ID は google_product_category ID に相当します。詳しくは、https://support.google.com/merchants/answer/6324436 をご覧ください。

countryCode

string

出力専用。商品入札カテゴリの大文字 2 文字の国コード。

productBiddingCategoryConstantParent

string

出力専用。親の商品入札カテゴリのリソース名。

languageCode

string

出力専用。商品入札カテゴリの言語コード。

localizedName

string

出力専用。languageCode に従ってローカライズされた商品入札カテゴリの値を表示します。

ProductBiddingCategoryStatus

商品入札カテゴリのステータスを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ACTIVE カテゴリは有効で、入札に使用できます。
OBSOLETE このカテゴリは古くなっています。レポート作成にのみ使用されます。

ProductGroupView

商品グループの表示。

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

string

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

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

推奨事項

推奨事項。

JSON 表現
{
  "resourceName": string,
  "type": enum (RecommendationType),
  "impact": {
    object (RecommendationImpact)
  },
  "campaigns": [
    string
  ],
  "campaignBudget": string,
  "campaign": string,
  "adGroup": string,
  "dismissed": boolean,

  // Union field recommendation can be only one of the following:
  "campaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "forecastingCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "keywordRecommendation": {
    object (KeywordRecommendation)
  },
  "textAdRecommendation": {
    object (TextAdRecommendation)
  },
  "targetCpaOptInRecommendation": {
    object (TargetCpaOptInRecommendation)
  },
  "maximizeConversionsOptInRecommendation": {
    object (MaximizeConversionsOptInRecommendation)
  },
  "enhancedCpcOptInRecommendation": {
    object (EnhancedCpcOptInRecommendation)
  },
  "searchPartnersOptInRecommendation": {
    object (SearchPartnersOptInRecommendation)
  },
  "maximizeClicksOptInRecommendation": {
    object (MaximizeClicksOptInRecommendation)
  },
  "optimizeAdRotationRecommendation": {
    object (OptimizeAdRotationRecommendation)
  },
  "keywordMatchTypeRecommendation": {
    object (KeywordMatchTypeRecommendation)
  },
  "moveUnusedBudgetRecommendation": {
    object (MoveUnusedBudgetRecommendation)
  },
  "targetRoasOptInRecommendation": {
    object (TargetRoasOptInRecommendation)
  },
  "responsiveSearchAdRecommendation": {
    object (ResponsiveSearchAdRecommendation)
  },
  "marginalRoiCampaignBudgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "useBroadMatchKeywordRecommendation": {
    object (UseBroadMatchKeywordRecommendation)
  },
  "responsiveSearchAdAssetRecommendation": {
    object (ResponsiveSearchAdAssetRecommendation)
  },
  "upgradeSmartShoppingCampaignToPerformanceMaxRecommendation": {
    object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)
  },
  "responsiveSearchAdImproveAdStrengthRecommendation": {
    object (ResponsiveSearchAdImproveAdStrengthRecommendation)
  },
  "displayExpansionOptInRecommendation": {
    object (DisplayExpansionOptInRecommendation)
  },
  "upgradeLocalCampaignToPerformanceMaxRecommendation": {
    object (UpgradeLocalCampaignToPerformanceMaxRecommendation)
  },
  "raiseTargetCpaBidTooLowRecommendation": {
    object (RaiseTargetCpaBidTooLowRecommendation)
  },
  "forecastingSetTargetRoasRecommendation": {
    object (ForecastingSetTargetRoasRecommendation)
  },
  "calloutAssetRecommendation": {
    object (CalloutAssetRecommendation)
  },
  "sitelinkAssetRecommendation": {
    object (SitelinkAssetRecommendation)
  },
  "callAssetRecommendation": {
    object (CallAssetRecommendation)
  },
  "shoppingAddAgeGroupRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddColorRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGenderRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddGtinRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddMoreIdentifiersRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddSizeRecommendation": {
    object (ShoppingOfferAttributeRecommendation)
  },
  "shoppingAddProductsToCampaignRecommendation": {
    object (ShoppingAddProductsToCampaignRecommendation)
  },
  "shoppingFixDisapprovedProductsRecommendation": {
    object (ShoppingFixDisapprovedProductsRecommendation)
  },
  "shoppingTargetAllOffersRecommendation": {
    object (ShoppingTargetAllOffersRecommendation)
  },
  "shoppingFixSuspendedMerchantCenterAccountRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingFixMerchantCenterAccountSuspensionWarningRecommendation": {
    object (ShoppingMerchantCenterAccountSuspensionRecommendation)
  },
  "shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation": {
    object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)
  },
  "dynamicImageExtensionOptInRecommendation": {
    object (DynamicImageExtensionOptInRecommendation)
  },
  "raiseTargetCpaRecommendation": {
    object (RaiseTargetCpaRecommendation)
  },
  "lowerTargetRoasRecommendation": {
    object (LowerTargetRoasRecommendation)
  },
  "performanceMaxOptInRecommendation": {
    object (PerformanceMaxOptInRecommendation)
  },
  "improvePerformanceMaxAdStrengthRecommendation": {
    object (ImprovePerformanceMaxAdStrengthRecommendation)
  },
  "migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation": {
    object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)
  }
  // End of list of possible types for union field recommendation.
}
フィールド
resourceName

string

変更不可。推奨事項のリソース名。

customers/{customerId}/recommendations/{recommendation_id}

type

enum (RecommendationType)

出力専用。推奨事項のタイプ。

impact

object (RecommendationImpact)

出力専用。最適化案の適用がアカウントのパフォーマンスに及ぼす影響。

campaigns[]

string

出力専用。この最適化案のターゲットとなっているキャンペーンです。

このフィールドは、最適化案の種類が CAMPAIGN_予算、FORECASTING_CAMPAIGN_budget、MARGINAL_ROI_CAMPAIGN_budget、MOVE_UNUSED_budget の場合に設定されます。

campaignBudget

string

出力専用。この最適化案でターゲットとする予算。この値は、最適化案が 1 つのキャンペーン予算に影響する場合にのみ設定されます。

このフィールドは、次の最適化案タイプで設定されます: CAMPAIGN_予算、FORECASTING_CAMPAIGN_budget、MARGINAL_ROI_CAMPAIGN_budget、MOVE_UNUSED_budget

campaign

string

出力専用。この最適化案のターゲットとなっているキャンペーン。

この項目は、次の最適化案の種類に設定されます: CALL_EXTENSION、CALLOUT_EXTENSION、OPC_EX_TARGETS、OPC_TARGET_LIMIT_TARGETS、OPC_LIMIT_TARGETS、OPC_TARGET_LIST_APPS、OPC_PROJECTS、OPC_LIMIT_TARGETS、OPC_PROJECTS、OPC_TARGETS_TARGETS、OPC_TARGETS、OPC_TARGET_CON_PROJECTS_ 1,000,000,000,000,000

adGroup

string

出力専用。この最適化案のターゲットとなっている広告グループ。これは、最適化案が 1 つの広告グループに影響する場合にのみ設定されます。

このフィールドは、最適化案の種類が KEYWORD、OPTIMIZE_AD_ROTATION、RESPONSIVE_SEARCH_AD、RESPONSIVE_SEARCH_AD_ASSET、TEXT_AD の場合に設定されます。

dismissed

boolean

出力専用。推奨事項が拒否されるかどうか。

共用体フィールド recommendation。推奨事項の詳細。recommendation は次のいずれかになります。
campaignBudgetRecommendation

object (CampaignBudgetRecommendation)

出力専用。キャンペーンの予算に関する最適化案。

forecastingCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

出力専用。キャンペーン予算の予測に関する最適化案。

keywordRecommendation

object (KeywordRecommendation)

出力専用。キーワードに関する最適化案。

textAdRecommendation

object (TextAdRecommendation)

出力専用。拡張テキスト広告の追加に関する最適化案。

targetCpaOptInRecommendation

object (TargetCpaOptInRecommendation)

出力専用。「目標コンバージョン単価」の有効化に関する最適化案。

maximizeConversionsOptInRecommendation

object (MaximizeConversionsOptInRecommendation)

出力専用。「コンバージョン数の最大化」の最適化案。

enhancedCpcOptInRecommendation

object (EnhancedCpcOptInRecommendation)

出力専用。拡張クリック単価のオプトインの最適化案

searchPartnersOptInRecommendation

object (SearchPartnersOptInRecommendation)

出力専用。検索パートナーのオプトインに関する最適化案。

maximizeClicksOptInRecommendation

object (MaximizeClicksOptInRecommendation)

出力専用。「クリック数の最大化」のオプトインの最適化案。

optimizeAdRotationRecommendation

object (OptimizeAdRotationRecommendation)

出力専用。広告のローテーションの最適化に関する最適化案。

keywordMatchTypeRecommendation

object (KeywordMatchTypeRecommendation)

出力専用。キーワードのマッチタイプに関する最適化案。

moveUnusedBudgetRecommendation

object (MoveUnusedBudgetRecommendation)

出力専用。未使用の予算を振り替える最適化案。

targetRoasOptInRecommendation

object (TargetRoasOptInRecommendation)

出力専用。「目標広告費用対効果」の有効化に関する最適化案。

responsiveSearchAdRecommendation

object (ResponsiveSearchAdRecommendation)

出力専用。レスポンシブ検索広告の追加の最適化案。

marginalRoiCampaignBudgetRecommendation

object (CampaignBudgetRecommendation)

出力専用。限界費用対効果を重視したキャンペーン予算の推奨値です。

useBroadMatchKeywordRecommendation

object (UseBroadMatchKeywordRecommendation)

出力専用。部分一致キーワードの使用に関する最適化案。

responsiveSearchAdAssetRecommendation

object (ResponsiveSearchAdAssetRecommendation)

出力専用。レスポンシブ検索広告アセットの最適化案。

upgradeSmartShoppingCampaignToPerformanceMaxRecommendation

object (UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation)

出力専用。スマート ショッピング キャンペーンを P-MAX キャンペーンにアップグレードする最適化案。

responsiveSearchAdImproveAdStrengthRecommendation

object (ResponsiveSearchAdImproveAdStrengthRecommendation)

出力専用。レスポンシブ検索広告により、広告の有効性に関する最適化案が改善される。

displayExpansionOptInRecommendation

object (DisplayExpansionOptInRecommendation)

出力専用。ディスプレイ ネットワーク対応の有効化に関する最適化案。

upgradeLocalCampaignToPerformanceMaxRecommendation

object (UpgradeLocalCampaignToPerformanceMaxRecommendation)

出力専用。ローカル キャンペーンを P-MAX キャンペーンにアップグレードする最適化案。

raiseTargetCpaBidTooLowRecommendation

object (RaiseTargetCpaBidTooLowRecommendation)

出力専用。目標コンバージョン単価の引き上げが低すぎる最適化案。

forecastingSetTargetRoasRecommendation

object (ForecastingSetTargetRoasRecommendation)

出力専用。予測に基づく目標広告費用対効果の最適化案。

calloutAssetRecommendation

object (CalloutAssetRecommendation)

出力専用。コールアウト アセットの最適化案。

callAssetRecommendation

object (CallAssetRecommendation)

出力専用。電話番号アセットの最適化案。

shoppingAddAgeGroupRecommendation

object (ShoppingOfferAttributeRecommendation)

出力専用。ショッピング追加年齢層の最適化案。

shoppingAddColorRecommendation

object (ShoppingOfferAttributeRecommendation)

出力専用。ショッピングの追加色に関する推奨事項。

shoppingAddGenderRecommendation

object (ShoppingOfferAttributeRecommendation)

出力専用。ショッピングの追加の性別に関する最適化案。

shoppingAddGtinRecommendation

object (ShoppingOfferAttributeRecommendation)

出力専用。ショッピングの GTIN 追加に関する最適化案です。

shoppingAddMoreIdentifiersRecommendation

object (ShoppingOfferAttributeRecommendation)

出力専用。ショッピング ID の追加に関する最適化案。

shoppingAddSizeRecommendation

object (ShoppingOfferAttributeRecommendation)

出力専用。ショッピング広告の推奨サイズ。

shoppingAddProductsToCampaignRecommendation

object (ShoppingAddProductsToCampaignRecommendation)

出力専用。ショッピング キャンペーンへの商品の追加に関する最適化案。

shoppingFixDisapprovedProductsRecommendation

object (ShoppingFixDisapprovedProductsRecommendation)

出力専用。ショッピングの修正で不承認となった商品の最適化案です。

shoppingTargetAllOffersRecommendation

object (ShoppingTargetAllOffersRecommendation)

出力専用。ショッピング ターゲットのすべての商品の提案。

shoppingFixSuspendedMerchantCenterAccountRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

出力専用。このショッピングの修正により、Merchant Center アカウントの最適化案が停止されました。

shoppingFixMerchantCenterAccountSuspensionWarningRecommendation

object (ShoppingMerchantCenterAccountSuspensionRecommendation)

出力専用。ショッピングの修正に関する Merchant Center アカウントの一時停止に関する警告の最適化案。

shoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

object (ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation)

出力専用。ショッピング キャンペーンによって、通常のショッピング キャンペーンの商品が P-MAX の最適化案に移行されます。

dynamicImageExtensionOptInRecommendation

object (DynamicImageExtensionOptInRecommendation)

出力専用。アカウントで動的画像表示オプションを有効にすることをおすすめします。これにより、広告のランディング ページから最適な画像が検出され、テキスト広告を補完できます。

raiseTargetCpaRecommendation

object (RaiseTargetCpaRecommendation)

出力専用。目標コンバージョン単価を引き上げるための最適化案です。

lowerTargetRoasRecommendation

object (LowerTargetRoasRecommendation)

出力専用。目標広告費用対効果を引き下げる最適化案。

performanceMaxOptInRecommendation

object (PerformanceMaxOptInRecommendation)

出力専用。P-MAX のオプトインに関する最適化案。

improvePerformanceMaxAdStrengthRecommendation

object (ImprovePerformanceMaxAdStrengthRecommendation)

出力専用。P-MAX の広告の有効性に関する最適化案の改善。

migrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

object (MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation)

出力専用。動的検索広告から P-MAX への移行に関する最適化案。

RecommendationType

最適化案の種類。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
CAMPAIGN_BUDGET 現在予算による制約を受けているキャンペーンの予算に関する最適化案(今後予算による制約が発生することが見込まれるキャンペーンに適用される FORECASTING_CAMPAIGN_budget に関する最適化案とは対照的です)。
KEYWORD キーワード候補
TEXT_AD 新しいテキスト広告の追加をおすすめしています。
TARGET_CPA_OPT_IN 「目標コンバージョン単価」入札戦略を使用するようにキャンペーンを更新することをおすすめします。
MAXIMIZE_CONVERSIONS_OPT_IN キャンペーンを更新して、「コンバージョン数の最大化」入札戦略を使用するようおすすめします。
ENHANCED_CPC_OPT_IN キャンペーンで拡張クリック単価を有効にすることをおすすめする。
SEARCH_PARTNERS_OPT_IN Google 検索パートナーのウェブサイトへのキャンペーンの広告掲載を開始するための最適化案です。
MAXIMIZE_CLICKS_OPT_IN 「クリック数の最大化」入札戦略を使用するようにキャンペーンを更新することが推奨されます。
OPTIMIZE_AD_ROTATION 該当の広告グループで、広告のローテーション設定「最適化」を使用することをおすすめします。
KEYWORD_MATCH_TYPE 既存のキーワードを、あるマッチタイプから部分一致のマッチタイプに変更することをおすすめします。
MOVE_UNUSED_BUDGET 未使用の予算をある予算から制約のある予算に振り替える最適化案。
FORECASTING_CAMPAIGN_BUDGET 今後予算による制約が発生することが見込まれるキャンペーンの予算に関する最適化案(現在、予算による制約を受けているキャンペーンに適用される CAMPAIGN_budget の最適化案とは対照的)。
TARGET_ROAS_OPT_IN 目標広告費用対効果に基づく入札戦略を使用するようにキャンペーンを更新することが推奨されます。
RESPONSIVE_SEARCH_AD 新しいレスポンシブ検索広告を追加することをおすすめします。
MARGINAL_ROI_CAMPAIGN_BUDGET 予算の調整で ROI の向上が見込まれる場合の予算の最適化案です。
USE_BROAD_MATCH_KEYWORD コンバージョン重視の入札戦略で完全に自動化されたキャンペーンに対して、部分一致バージョンのキーワードを追加することが推奨されます。
RESPONSIVE_SEARCH_AD_ASSET 新しいレスポンシブ検索広告アセットを追加するための最適化案。
UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX スマート ショッピング キャンペーンを P-MAX キャンペーンにアップグレードするための最適化案。
RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH レスポンシブ検索広告の有効性を改善するための最適化案。
DISPLAY_EXPANSION_OPT_IN キャンペーンを更新してディスプレイ ネットワーク対応を使用することを推奨する。
UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX ローカル キャンペーンを P-MAX キャンペーンにアップグレードするための最適化案。
RAISE_TARGET_CPA_BID_TOO_LOW 目標コンバージョン単価が低すぎ、コンバージョンがほとんどまたはまったくない場合に、引き上げが推奨される。コンバージョンは非同期で適用され、関連するキャンペーン内の広告グループの数によっては数分かかる場合があります。
FORECASTING_SET_TARGET_ROAS トラフィックの増加が見込まれる季節限定イベントの前に予算を引き上げ、入札戦略を「コンバージョン値の最大化」から「目標広告費用対効果」に変更することをおすすめします。
CALLOUT_ASSET キャンペーン単位またはお客様単位でコールアウト アセットを追加することをおすすめします。
CALL_ASSET キャンペーン単位または顧客単位で電話番号アセットを追加することをおすすめします。
SHOPPING_ADD_AGE_GROUP 年齢層が指定されていないために降格された商品に、年齢層 [age_group] 属性を追加することをおすすめします。
SHOPPING_ADD_COLOR 色がないために順位が下がった商品に色を追加することをおすすめします。
SHOPPING_ADD_GENDER 性別が指定されていないために降格された商品に性別を追加するための推奨事項。
SHOPPING_ADD_GTIN GTIN(国際取引商品番号)がないために順位が下がった商品に GTIN(国際取引商品番号)を追加することをおすすめします。
SHOPPING_ADD_MORE_IDENTIFIERS ID が指定されていないために順位が下がった商品に、ID をさらに追加することをおすすめします。
SHOPPING_ADD_SIZE サイズが指定されていないために降格された商品にサイズを追加するための推奨事項。
SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN ターゲティングされている商品がないために配信できないキャンペーンについて顧客に通知する推奨事項です。
SHOPPING_FIX_DISAPPROVED_PRODUCTS 不承認となった商品の割合が高いキャンペーンについてユーザーに通知する、ショッピングに関する最適化案。
SHOPPING_TARGET_ALL_OFFERS すべての商品をターゲットとする汎用のキャンペーンを作成することをおすすめします。
SHOPPING_FIX_SUSPENDED_MERCHANT_CENTER_ACCOUNT 強制停止されている Merchant Center アカウントの問題を解決するための最適化案。
SHOPPING_FIX_MERCHANT_CENTER_ACCOUNT_SUSPENSION_WARNING Merchant Center アカウントの強制停止に関する警告の問題を解決するための最適化案。
SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX 通常のショッピング キャンペーンがターゲットとする商品を既存の P-MAX キャンペーンに移行するための最適化案。
DYNAMIC_IMAGE_EXTENSION_OPT_IN アカウントで動的画像表示オプションを有効にすることをおすすめします。これにより、広告のランディング ページから最適な画像が検出され、テキスト広告を補完できます。
RAISE_TARGET_CPA 過去のコンバージョンからモデル化された Google の予測に基づいて目標コンバージョン単価を引き上げるための最適化案。コンバージョンは非同期で適用され、関連するキャンペーン内の広告グループの数によっては数分かかる場合があります。
LOWER_TARGET_ROAS 目標広告費用対効果を引き下げる最適化案。
PERFORMANCE_MAX_OPT_IN P-MAX キャンペーンを有効にするための最適化案。
IMPROVE_PERFORMANCE_MAX_AD_STRENGTH P-MAX キャンペーンのアセット グループの有効性を「優良」の評価に改善するための最適化案。
MIGRATE_DYNAMIC_SEARCH_ADS_CAMPAIGN_TO_PERFORMANCE_MAX 動的検索広告を P-MAX キャンペーンに移行するための最適化案。

RecommendationImpact

最適化案で説明されている変更を行った場合の影響。最適化案の種類によっては、影響に関する情報が表示されない場合があります。

JSON 表現
{
  "baseMetrics": {
    object (RecommendationMetrics)
  },
  "potentialMetrics": {
    object (RecommendationMetrics)
  }
}
フィールド
baseMetrics

object (RecommendationMetrics)

出力専用。推奨事項が生成された時点の基本指標。

potentialMetrics

object (RecommendationMetrics)

出力専用。最適化案が適用されている場合の推定指標。

RecommendationMetrics

アカウントのパフォーマンスに関する週次指標。最適化案の種類によっては、過去 90 日間の平均が算出されるため、小数値になることがあります。

JSON 表現
{
  "impressions": number,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "videoViews": number
}
フィールド
impressions

number

出力専用。広告のインプレッション数。

clicks

number

出力専用。広告クリック数。

costMicros

string (int64 format)

出力専用。広告費用(マイクロ単位)。アカウントの現地通貨で表します。

conversions

number

出力専用。コンバージョン数。

videoViews

number

出力専用。動画広告キャンペーンの動画再生回数です。

CampaignBudgetRecommendation

予算による制約を受けているキャンペーンの予算に関する最適化案。

JSON 表現
{
  "budgetOptions": [
    {
      object (CampaignBudgetRecommendationOption)
    }
  ],
  "currentBudgetAmountMicros": string,
  "recommendedBudgetAmountMicros": string
}
フィールド
budgetOptions[]

object (CampaignBudgetRecommendationOption)

出力専用。可能な予算額の一部の値に対する、予算額とそれに関連する推定影響。

currentBudgetAmountMicros

string (int64 format)

出力専用。現在の予算額(マイクロ秒単位)。

recommendedBudgetAmountMicros

string (int64 format)

出力専用。推奨される予算額(マイクロ単位)。

CampaignBudgetRecommendationOption

指定した予算額で見込まれる効果。

JSON 表現
{
  "impact": {
    object (RecommendationImpact)
  },
  "budgetAmountMicros": string
}
フィールド
impact

object (RecommendationImpact)

出力専用。予算をこのオプションで指定された金額に変更した場合の影響の見積もり。

budgetAmountMicros

string (int64 format)

出力専用。このオプションの予算額。

KeywordRecommendation

キーワードに関する最適化案。

JSON 表現
{
  "keyword": {
    object (KeywordInfo)
  },
  "searchTerms": [
    {
      object (SearchTerm)
    }
  ],
  "recommendedCpcBidMicros": string
}
フィールド
keyword

object (KeywordInfo)

出力専用。推奨されるキーワード。

searchTerms[]

object (SearchTerm)

出力専用。このキーワードに一致する検索語句のリストです。同じ検索語句が複数のキーワードで繰り返される場合があります。

recommendedCpcBidMicros

string (int64 format)

出力専用。推奨されるクリック単価(CPC)。

SearchTerm

キーワード候補に関連する検索語句の情報。

JSON 表現
{
  "text": string,
  "estimatedWeeklySearchCount": string
}
フィールド
text

string

出力専用。検索キーワードのテキスト。

estimatedWeeklySearchCount

string (int64 format)

出力専用。この検索語句の週ごとの推定検索数です。

TextAdRecommendation

テキスト広告の最適化案。

JSON 表現
{
  "ad": {
    object (Ad)
  },
  "creationDate": string,
  "autoApplyDate": string
}
フィールド
ad

object (Ad)

出力専用。おすすめの広告です。

creationDate

string

出力専用。推奨された広告の作成日。YYYY-MM-DD 形式(例: 2018-04-17)。

autoApplyDate

string

出力専用。日付(存在する場合)は、最適化案が自動適用される最も早い日付です。YYYY-MM-DD 形式(例: 2018-04-17)。

TargetCpaOptInRecommendation

「目標コンバージョン単価」オプトインの最適化案。

JSON 表現
{
  "options": [
    {
      object (TargetCpaOptInRecommendationOption)
    }
  ],
  "recommendedTargetCpaMicros": string
}
フィールド
options[]

object (TargetCpaOptInRecommendationOption)

出力専用。「目標コンバージョン単価」戦略で使用可能な目標とそれに対応するオプション。

recommendedTargetCpaMicros

string (int64 format)

出力専用。推奨される平均コンバージョン単価の目標値です。必要な予算額と、この最適化案を使用した場合の影響をオプション リストで確認します。

TargetCpaOptInRecommendationOption

「目標コンバージョン単価」オプトイン オプションと影響の見積もり。

JSON 表現
{
  "goal": enum (TargetCpaOptInRecommendationGoal),
  "impact": {
    object (RecommendationImpact)
  },
  "targetCpaMicros": string,
  "requiredCampaignBudgetAmountMicros": string
}
フィールド
goal

enum (TargetCpaOptInRecommendationGoal)

出力専用。このオプションで達成される目標。

impact

object (RecommendationImpact)

出力専用。このオプションを選択した場合の推定影響。

targetCpaMicros

string (int64 format)

出力専用。平均コンバージョン単価の目標値。

requiredCampaignBudgetAmountMicros

string (int64 format)

出力専用。目標コンバージョン単価を達成するために必要なキャンペーンの最小予算(現地通貨)。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。

TargetCpaOptInRecommendationGoal

TargetCpaOptIn 推奨事項の目標。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SAME_COST 費用を一定に保つには、目標コンバージョン単価を設定することを推奨します。
SAME_CONVERSIONS 目標コンバージョン単価を設定して、同じコンバージョンを維持できるようにすることをおすすめします。
SAME_CPA 同じコンバージョン単価を維持するために目標コンバージョン単価を設定することを推奨。
CLOSEST_CPA 目標コンバージョン単価を、実際のコンバージョン単価(過去 28 日間で計算)にできるだけ近く、かつより低い値に設定することをおすすめします。

MaximizeConversionsOptInRecommendation

「コンバージョン数の最大化」のオプトインの最適化案。

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

string (int64 format)

出力専用。推奨される新しい予算額。

EnhancedCpcOptInRecommendation

このタイプにはフィールドがありません。

拡張クリック単価のオプトインの最適化案

SearchPartnersOptInRecommendation

このタイプにはフィールドがありません。

検索パートナーのオプトインに関する最適化案。

MaximizeClicksOptInRecommendation

「クリック数の最大化」オプトインの最適化案。

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

string (int64 format)

出力専用。推奨される新しい予算額。現在の予算が高すぎる場合にのみ設定します。

OptimizeAdRotationRecommendation

このタイプにはフィールドがありません。

広告のローテーションの最適化に関する最適化案。

KeywordMatchTypeRecommendation

キーワードのマッチタイプに関する最適化案。

JSON 表現
{
  "keyword": {
    object (KeywordInfo)
  },
  "recommendedMatchType": enum (KeywordMatchType)
}
フィールド
keyword

object (KeywordInfo)

出力専用。マッチタイプを広くする必要がある既存のキーワード。

recommendedMatchType

enum (KeywordMatchType)

出力専用。推奨される新しいマッチタイプです。

MoveUnusedBudgetRecommendation

未使用の予算を振り替える最適化案。

JSON 表現
{
  "budgetRecommendation": {
    object (CampaignBudgetRecommendation)
  },
  "excessCampaignBudget": string
}
フィールド
budgetRecommendation

object (CampaignBudgetRecommendation)

出力専用。予算による制約の引き上げに関する最適化案。

excessCampaignBudget

string

出力専用。余剰予算の resourceName です。

TargetRoasOptInRecommendation

「目標広告費用対効果」の有効化に関する最適化案。

JSON 表現
{
  "recommendedTargetRoas": number,
  "requiredCampaignBudgetAmountMicros": string
}
フィールド
recommendedTargetRoas

number

出力専用。推奨される目標広告費用対効果(費用単位あたりの収益)。値は 0.01 ~ 1000.0 です。

requiredCampaignBudgetAmountMicros

string (int64 format)

出力専用。目標広告費用対効果を達成するために必要な、アカウントの最小キャンペーン予算(現地通貨)。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。

ResponsiveSearchAdRecommendation

レスポンシブ検索広告の追加の最適化案。

JSON 表現
{
  "ad": {
    object (Ad)
  }
}
フィールド
ad

object (Ad)

出力専用。おすすめの広告です。

UseBroadMatchKeywordRecommendation

部分一致キーワードの使用に関する最適化案。

JSON 表現
{
  "keyword": [
    {
      object (KeywordInfo)
    }
  ],
  "suggestedKeywordsCount": string,
  "campaignKeywordsCount": string,
  "campaignUsesSharedBudget": boolean,
  "requiredCampaignBudgetAmountMicros": string
}
フィールド
keyword[]

object (KeywordInfo)

出力専用。部分一致に拡張されるキーワードの例。

suggestedKeywordsCount

string (int64 format)

出力専用。キャンペーンで部分一致に拡張するキーワードの合計数。

campaignKeywordsCount

string (int64 format)

出力専用。キャンペーンのキーワードの合計数。

campaignUsesSharedBudget

boolean

出力専用。関連付けられたキャンペーンで共有予算を使用しているかどうか。

requiredCampaignBudgetAmountMicros

string (int64 format)

出力専用。最適化案の適用後に予算による制約を受けないようにするために推奨される予算です。

ResponsiveSearchAdAssetRecommendation

レスポンシブ検索広告アセットの追加に関する最適化案。

JSON 表現
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAssets": {
    object (Ad)
  }
}
フィールド
currentAd

object (Ad)

出力専用。更新する現在の広告。

recommendedAssets

object (Ad)

出力専用。推奨アセット。新しい広告見出しや説明文のみが自動的に入力され、それ以外の場合は空になります。

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

スマート ショッピング キャンペーンを P-MAX キャンペーンにアップグレードする最適化案。

JSON 表現
{
  "merchantId": string,
  "salesCountryCode": string
}
フィールド
merchantId

string (int64 format)

出力専用。Merchant Center アカウントの ID。

salesCountryCode

string

出力専用。販売者の在庫の商品を含める国。

ResponsiveSearchAdImproveAdStrengthRecommendation

レスポンシブ検索広告により、広告の有効性に関する最適化案が改善される。

JSON 表現
{
  "currentAd": {
    object (Ad)
  },
  "recommendedAd": {
    object (Ad)
  }
}
フィールド
currentAd

object (Ad)

出力専用。更新する現在の広告。

recommendedAd

object (Ad)

出力専用。更新された広告。

DisplayExpansionOptInRecommendation

このタイプにはフィールドがありません。

ディスプレイ ネットワーク対応の有効化に関する最適化案。

UpgradeLocalCampaignToPerformanceMaxRecommendation

このタイプにはフィールドがありません。

「ローカル キャンペーンを P-MAX キャンペーンにアップグレードする」の最適化案。

RaiseTargetCpaBidTooLowRecommendation

目標コンバージョン単価の引き上げが低すぎる最適化案。

JSON 表現
{
  "recommendedTargetMultiplier": number,
  "averageTargetCpaMicros": string
}
フィールド
recommendedTargetMultiplier

number

出力専用。1.0 より大きい数値は、目標コンバージョン単価の引き上げを推奨する係数を示します。

averageTargetCpaMicros

string (int64 format)

出力専用。キャンペーンの現在の平均目標コンバージョン単価(マイクロ秒単位)。

ForecastingSetTargetRoasRecommendation

予測に基づく目標広告費用対効果の最適化案。

JSON 表現
{
  "recommendedTargetRoas": number,
  "campaignBudget": {
    object (CampaignBudget)
  }
}
フィールド
recommendedTargetRoas

number

出力専用。推奨される目標広告費用対効果(費用単位あたりの収益)。値は 0.01 ~ 1000.0 です。

campaignBudget

object (CampaignBudget)

出力専用。キャンペーンの予算

CampaignBudget

さまざまな予算の最適化案タイプ間で共有されるキャンペーン予算。

JSON 表現
{
  "currentAmountMicros": string,
  "recommendedNewAmountMicros": string,
  "newStartDate": string
}
フィールド
currentAmountMicros

string (int64 format)

出力専用。現在の予算額。

recommendedNewAmountMicros

string (int64 format)

出力専用。推奨予算額です。

newStartDate

string

出力専用。新しい予算の使用が開始される日付。このフィールドは、最適化案の種類が FORECASTING_SET_TARGET_ROAS YYYY-MM-DD 形式(例: 2018-04-17)の場合に設定されます。

CalloutAssetRecommendation

コールアウト アセットの最適化案。

JSON 表現
{
  "recommendedCampaignCalloutAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerCalloutAssets": [
    {
      object (Asset)
    }
  ]
}
フィールド
recommendedCampaignCalloutAssets[]

object (Asset)

出力専用。キャンペーン単位で推奨される新しいコールアウト表示オプション アセット。

recommendedCustomerCalloutAssets[]

object (Asset)

出力専用。新しいコールアウト表示オプションのアセットは、お客様単位で推奨されます。

SitelinkAssetRecommendation

サイトリンク アセットに関する最適化案です。

JSON 表現
{
  "recommendedCampaignSitelinkAssets": [
    {
      object (Asset)
    }
  ],
  "recommendedCustomerSitelinkAssets": [
    {
      object (Asset)
    }
  ]
}
フィールド

CallAssetRecommendation

このタイプにはフィールドがありません。

電話番号アセットの最適化案。

ShoppingOfferAttributeRecommendation

属性が指定されていないために降格された商品に属性を追加することを推奨するショッピングの推奨事項。

JSON 表現
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "offersCount": string,
  "demotedOffersCount": string
}
フィールド
merchant

object (MerchantInfo)

出力専用。Merchant Center アカウントの詳細。

feedLabel

string

出力専用。キャンペーンのフィードラベル。

offersCount

string (int64 format)

出力専用。オンラインで配信可能な商品の数。

demotedOffersCount

string (int64 format)

出力専用。属性が指定されていないために降格された、オンラインで配信可能な商品の数。詳しくは Merchant Center をご覧ください。

MerchantInfo

Merchant Center アカウントの詳細。

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

string (int64 format)

出力専用。Merchant Center アカウント ID。

name

string

出力専用。Merchant Center アカウントの名前。

multiClient

boolean

出力専用。Merchant Center アカウントがマルチクライアント アカウント(MCA)であるかどうか。

ShoppingAddProductsToCampaignRecommendation

ショッピング キャンペーンの広告枠に商品を追加するためのショッピングの最適化案。

JSON 表現
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "reason": enum (Reason)
}
フィールド
merchant

object (MerchantInfo)

出力専用。Merchant Center アカウントの詳細。

feedLabel

string

出力専用。キャンペーンのフィードラベル。

reason

enum (Reason)

出力専用。キャンペーンに商品が関連付けられていない理由。

理由

ショッピング キャンペーンで 1 個の商品をターゲットに設定する結果となる問題。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS この Merchant Center アカウントに登録済みの商品がありません。
MERCHANT_CENTER_ACCOUNT_HAS_NO_SUBMITTED_PRODUCTS_IN_FEED Merchant Center アカウントのフィード内に登録済みの商品がありません。
ADS_ACCOUNT_EXCLUDES_OFFERS_FROM_CAMPAIGN Google 広告アカウントに有効なキャンペーン フィルタがあるため、キャンペーンに特典は含まれません。
ALL_PRODUCTS_ARE_EXCLUDED_FROM_CAMPAIGN 掲載可能なすべての商品が、キャンペーンのターゲットから明示的に除外されています。

ShoppingFixDisapprovedProductsRecommendation

ショッピング キャンペーンの広告枠で不承認となった商品を修正するための、ショッピングの最適化案。

JSON 表現
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string,
  "productsCount": string,
  "disapprovedProductsCount": string
}
フィールド
merchant

object (MerchantInfo)

出力専用。Merchant Center アカウントの詳細。

feedLabel

string

出力専用。キャンペーンのフィードラベル。

productsCount

string (int64 format)

出力専用。キャンペーンの商品の数。

disapprovedProductsCount

string (int64 format)

出力専用。不承認となったキャンペーンの商品の数。

ShoppingTargetAllOffersRecommendation

すべての商品をターゲットとする汎用のキャンペーンを作成することが推奨されるショッピング キャンペーン。

JSON 表現
{
  "merchant": {
    object (MerchantInfo)
  },
  "untargetedOffersCount": string,
  "feedLabel": string
}
フィールド
merchant

object (MerchantInfo)

出力専用。Merchant Center アカウントの詳細。

untargetedOffersCount

string (int64 format)

出力専用。ターゲット未設定の商品の数。

feedLabel

string

出力専用。商品フィードのラベル。

ShoppingMerchantCenterAccountSuspensionRecommendation

Merchant Center アカウントの強制停止の問題を解決するためのショッピングの最適化案。

JSON 表現
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
フィールド
merchant

object (MerchantInfo)

出力専用。Merchant Center アカウントの詳細。

feedLabel

string

出力専用。強制停止が発生したキャンペーンのフィードラベル。

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

通常のショッピング キャンペーンのターゲットを絞った商品を P-MAX キャンペーンに移行するためのショッピングの最適化案です。

JSON 表現
{
  "merchant": {
    object (MerchantInfo)
  },
  "feedLabel": string
}
フィールド
merchant

object (MerchantInfo)

出力専用。Merchant Center アカウントの詳細。

feedLabel

string

出力専用。この候補を共有するキャンペーンでターゲットとする商品のフィードラベル。

DynamicImageExtensionOptInRecommendation

このタイプにはフィールドがありません。

アカウントで動的画像表示オプションを有効にすることをおすすめします。これにより、広告のランディング ページから最適な画像が検出され、テキスト広告を補完できます。

RaiseTargetCpaRecommendation

目標コンバージョン単価を引き上げるための最適化案です。

JSON 表現
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  },
  "appBiddingGoal": enum (AppBiddingGoal)
}
フィールド
targetAdjustment

object (TargetAdjustmentInfo)

出力専用。推奨される目標値の調整を説明する関連情報。

appBiddingGoal

enum (AppBiddingGoal)

出力専用。入札戦略の最適化の目標を表します。アプリ キャンペーンについてのみ入力されます。

TargetAdjustmentInfo

目標調整の最適化案の情報。

JSON 表現
{
  "recommendedTargetMultiplier": number,
  "currentAverageTargetMicros": string,
  "sharedSet": string
}
フィールド
recommendedTargetMultiplier

number

出力専用。推奨される目標値の調整係数。

currentAverageTargetMicros

string (int64 format)

出力専用。この最適化案の対象となるキャンペーンまたはポートフォリオの現在の平均目標値。

sharedSet

string

出力専用。目標が定義されているポートフォリオ入札戦略の共有設定リソース名。最適化案がポートフォリオ レベルの場合にのみ入力されます。

AppBiddingGoal

アプリ キャンペーンの入札戦略の最適化で重視する目標を表します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンの API では不明な値を表します。
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME アプリ キャンペーンの入札戦略は、アプリのインストール数の最大化を目的としている必要があります。
OPTIMIZE_FOR_IN_APP_CONVERSION_VOLUME アプリ キャンペーンの入札戦略は、選択したアプリ内コンバージョンの数を最大化することを目的としています。
OPTIMIZE_FOR_TOTAL_CONVERSION_VALUE アプリ キャンペーンの入札戦略は、すべてのコンバージョン(インストール コンバージョンと選択アプリ内コンバージョン)の価値を最大化することを目的としています。
OPTIMIZE_FOR_TARGET_IN_APP_CONVERSION アプリ キャンペーンの入札戦略は、選択したアプリ内コンバージョンの数を最大化しながら、目標アプリ内コンバージョン単価を達成するか上回ることを目標とする必要があります。
OPTIMIZE_FOR_RETURN_ON_ADVERTISING_SPEND アプリ キャンペーンの入札戦略は、広告費用対効果の目標値を達成または超過しながら、すべてのコンバージョンの価値(インストールとアプリ内コンバージョン)を最大化することを目指します。
OPTIMIZE_FOR_INSTALL_CONVERSION_VOLUME_WITHOUT_TARGET_CPI アプリ キャンペーンの入札戦略では、広告主様が指定した目標インストール単価を設定せずに、アプリのインストール数を最大化することが目的です。
OPTIMIZE_FOR_PRE_REGISTRATION_CONVERSION_VOLUME アプリ キャンペーンの入札戦略は、アプリの事前登録を最大化することを目的としています。

LowerTargetRoasRecommendation

目標広告費用対効果を引き下げる最適化案。

JSON 表現
{
  "targetAdjustment": {
    object (TargetAdjustmentInfo)
  }
}
フィールド
targetAdjustment

object (TargetAdjustmentInfo)

出力専用。推奨される目標値の調整を説明する関連情報。

PerformanceMaxOptInRecommendation

このタイプにはフィールドがありません。

P-MAX のオプトインに関する最適化案。

ImprovePerformanceMaxAdStrengthRecommendation

P-MAX キャンペーンのアセット グループの有効性を「優良」の評価に改善するための最適化案。

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

string

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

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

動的検索広告から P-MAX への移行に関する最適化案。

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

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

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

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 文字以下にする必要があります。

指標

指標データ。

JSON 表現
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "skAdNetworkConversions": 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,
  "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
}
フィールド
allConversionsValueByConversionDate

number

すべてのコンバージョン値です。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/google-ads/answer/9549009 をご覧ください。

allConversionsByConversionDate

number

コンバージョンの合計数。これには、includeInConversionMetric の値に関係なく、すべてのコンバージョンが含まれます。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/google-ads/answer/9549009 をご覧ください。

conversionsValueByConversionDate

number

コンバージョン値。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/google-ads/answer/9549009 をご覧ください。

conversionsByConversionDate

number

コンバージョン数。includeInConversionMetric 属性が 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)

支払い対象のインタラクションと無料インタラクションのタイプ。

skAdNetworkConversions

string (int64 format)

iOS ストアキットの広告ネットワーク コンバージョン数です。

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

コンバージョンの合計数。これには、includeInConversionMetric の値に関係なく、すべてのコンバージョンが含まれます。

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)を、combinedQueries で割った値です。詳しくは、ヘルプページ(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

インタラクションからのコンバージョンの数を広告インタラクションの数(テキストのクリックや動画広告の閲覧など)で割った値。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

conversionsValue

number

コンバージョン値。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

newCustomerLifetimeValue

number

新規顧客のライフタイム コンバージョン値です。顧客獲得の目標をアカウント単位またはキャンペーン単位で設定している場合、これには、入札単価設定に使用されるコンバージョンでの新規顧客による追加のコンバージョン値が含まれます。キャンペーンで「顧客の獲得」目標が採用されていて、[新規顧客に対する入札単価を高く設定] が選択されている場合、これらの値は最適化のために [conversionsValue] に組み込まれます。詳しくは、https://support.google.com/google-ads/answer/12080169 をご覧ください。

conversionsValuePerCost

number

コンバージョン値を広告インタラクションの費用で割った値。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

conversionsFromInteractionsValuePerInteraction

number

インタラクションによるコンバージョン値を広告インタラクション数で割った値。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

conversions

number

コンバージョン数。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

costMicros

string (int64 format)

指定された期間における、クリック単価(CPC)による費用とインプレッション単価(CPM)による費用の総額。

costPerAllConversions

number

広告インタラクションの費用をすべてのコンバージョンで割った値です。

costPerConversion

number

広告インタラクションの費用をコンバージョンで割った値です。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

costPerCurrentModelAttributedConversion

number

広告インタラクションの費用を、現在のモデルに起因するコンバージョンで割った値です。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

crossDeviceConversions

number

顧客が 1 つのデバイスで Google 広告で作成した広告をクリックした後、別のデバイスまたはブラウザで変換することによって発生するコンバージョン。クロスデバイス コンバージョンは、すべてのコンバージョンにすでに含まれています。

ctr

number

広告から発生したクリック数(クリック数)を、広告が表示された回数(インプレッション数)で割った値。

currentModelAttributedConversions

number

現在選択したアトリビューション モデルで、過去のコンバージョン データがどのように表示されるかを確認できます。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

currentModelAttributedConversionsFromInteractionsRate

number

現在のモデルでは、インタラクションに起因するコンバージョンを広告インタラクション(テキスト広告のクリックや動画広告の視聴など)の数で割った値です。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

currentModelAttributedConversionsFromInteractionsValuePerInteraction

number

現在モデルで貢献度が割り当てられたインタラクションのコンバージョンの値を、広告インタラクションの数で割った値です。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

currentModelAttributedConversionsValue

number

現在のモデルによって貢献度が割り当てられたコンバージョンの値。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

currentModelAttributedConversionsValuePerCost

number

現在のモデルによって貢献度が割り当てられたコンバージョンの値を、広告インタラクションの費用で割った値。includeInConversionMetric 属性が 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)の数を、メッセージのインプレッション数(message インプレッション数)で割った値。メッセージ オプションとメッセージ トラッキングが有効になっている広告のインプレッションからユーザーがメッセージ チャットを開始した割合。このレートは、特定のメッセージ インプレッションに対して 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、recommendedType)ごとに 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

サイトのページがオーガニック検索結果に表示された回数(organic インプレッション数)を、オーガニック検索結果でサイトのリスティングが返された検索数(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)を電話番号が表示された回数(phone インプレッション数)で割った値。

relativeCtr

number

クリック率(Ctr)を、広告を表示するウェブサイト上のすべての広告主の平均クリック率で割った値です。ディスプレイ ネットワーク サイトでの広告のパフォーマンスを、同じサイトの他の広告と比較して測定します。

searchAbsoluteTopImpressionShare

number

最も目立つ位置に表示されるお客様のショッピングまたは検索の広告のインプレッションの割合。詳しくは、https://support.google.com/google-ads/answer/7501826 をご覧ください。0.1 未満の値はすべて 0.0999 として報告されます。

searchBudgetLostAbsoluteTopImpressionShare

number

予算の低さが原因で、検索結果ページの上位の広告の中で、広告が最初に表示されなかった頻度の推定値です。注: 検索予算の検索広告の最上部インプレッション シェア損失率は、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

広告ランクの低さが原因で、検索結果ページの上位の広告の中で、広告が最初に表示されなかった頻度の推定値です。注: 検索ランクの検索広告の最上部インプレッション シェア損失率は、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

コンバージョンをコンバージョン数で割った値。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。

valuePerConversionsByConversionDate

number

コンバージョンをコンバージョン数で割った値。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/google-ads/answer/9549009 をご覧ください。

valuePerCurrentModelAttributedConversion

number

現在のモデルに起因するコンバージョンの値をコンバージョン数で割った値。includeInConversionMetric 属性が 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 のクリック数。この測定は、アセットベースのビジネスから取得されます。

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),
  "newVersusReturningCustomers": enum (ConvertingUserPriorEngagementTypeAndLtvBucket),
  "activityAccountId": string,
  "activityRating": 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,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": 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)
  },
  "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 は、値のルールが適用されていないコンバージョンの合計値を示します。「ORIGINAL」は、価値のルールが適用されたコンバージョンの元の値を示します。GEO_LOCATION、DEVICE、AUDIENCE は、価値のルールが適用された後の正味の調整を示します。

skAdNetworkUserType

enum (SkAdNetworkUserType)

iOS ストアキットの広告ネットワークのユーザータイプ。

skAdNetworkAdEventType

enum (SkAdNetworkAdEventType)

iOS ストアキットの広告ネットワーク広告イベントタイプ。

skAdNetworkAttributionCredit

enum (SkAdNetworkAttributionCredit)

iOS ストアキットの広告ネットワーク アトリビューション クレジット

newVersusReturningCustomers

enum (ConvertingUserPriorEngagementTypeAndLtvBucket)

新規顧客かリピーターかでコンバージョンをセグメント化する場合に使用します。この分類は通常、「顧客獲得」目標の影響を測定するために使用されます。

activityAccountId

string (int64 format)

アクティビティ アカウント ID。

activityRating

string (int64 format)

アクティビティの評価。

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。

productBiddingCategoryLevel1

string

商品の入札カテゴリ(レベル 1)。

productBiddingCategoryLevel2

string

商品の入札カテゴリ(レベル 2)。

productBiddingCategoryLevel3

string

商品の入札カテゴリ(レベル 3)。

productBiddingCategoryLevel4

string

商品の入札カテゴリ(レベル 4)。

productBiddingCategoryLevel5

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-04-01 に始まります。形式は yyyy-MM-dd です。

searchSubcategory

string

検索語句のサブカテゴリ。空の文字列は、別のサブカテゴリに当てはまらない検索語句のキャッチオール サブカテゴリを示します。

searchTerm

string

検索キーワード。

webpage

string

ウェブページの条件を表す広告グループの条件のリソース名。

week

string

月曜日から日曜日までとして定義される週。月曜日の日付で表されます。形式は yyyy-MM-dd です。

year

integer

年(yyyy 形式)。

skAdNetworkConversionValue

string (int64 format)

iOS ストアキットの広告ネットワークのコンバージョン値です。値が null の場合、iOS 以外のキャンペーンなど、このセグメントは適用できません。

skAdNetworkSourceApp

object (SkAdNetworkSourceApp)

iOS Store Kit の広告ネットワークのインストールを促す広告が表示されたアプリ。値が null の場合、このセグメントは適用外(iOS 以外のキャンペーンなど)であるか、Apple から送信されたポストバックに存在しないことを意味します。

assetInteractionTarget

object (AssetInteractionTarget)

CustomerAsset、CampaignAsset、AdGroupAsset の各指標でのみ使用します。インタラクションの指標がアセット自体で発生したか、別のアセットや広告ユニットで発生したかを示します。インタラクション(クリックなど)は、広告が同時に配信されると、配信された広告のすべての要素(広告自体とサイトリンクなどのその他のコンポーネント)でカウントされます。interactionOnThisAsset が true の場合は、操作がこの特定のアセットで発生し、InteractionOnThisAsset が false の場合は、操作がこの特定のアセットではなく、このアセットとともに配信される広告の他の部分で発生しています。

AdDestinationType

Google 広告のリンク先タイプを列挙

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
NOT_APPLICABLE ユーザーを広告から別のリンク先にユーザーを誘導することを意図していない広告
WEBSITE ウェブサイト
APP_STORE iOS App Store または Play ストア
PHONE_CALL 電話アプリ
MAP_DIRECTIONS マップアプリ
LOCATION_LISTING ロケーション専用ページ
MESSAGE テキスト メッセージ
LEAD_FORM 見込み顧客の発掘フォーム
YOUTUBE YouTube
UNMODELED_FOR_CONVERSIONS キーが不明なコンバージョンの広告のリンク先

AdNetworkType

Google 広告ネットワーク タイプを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
SEARCH Google 検索。
SEARCH_PARTNERS 検索パートナー
CONTENT ディスプレイ ネットワークです。
YOUTUBE_WATCH YouTube 動画
MIXED クロスネットワーク。

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 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 コンバージョン達成までの期間バケット UNKNOWN です。これは、Google 広告でコンバージョン達成までの期間バケットが利用可能になる前の日付を対象としています。
ADJUSTMENT_UNKNOWN コンバージョン調整のラグバケット UNKNOWN です。これは、Google 広告でコンバージョン調整のラグバケットが使用可能になる前の日付を対象としています。

ExternalConversionSource

ConversionAction に関連付けられている外部のコンバージョンの発生元。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンで不明な値を表します。
WEBPAGE ユーザーが広告を見た後に特定のウェブページにアクセスしたときに発生するコンバージョン。Google 広告の管理画面では「ウェブサイト」として表示されます。
ANALYTICS リンクされた Google アナリティクスの目標またはトランザクションに起因するコンバージョン。Google 広告の管理画面には「アナリティクス」と表示されます。
UPLOAD ConversionUploadService を使用してアップロードされたウェブサイト コンバージョン。Google 広告の管理画面には「クリックからのインポート」として表示されます。
AD_CALL_METRICS ユーザーが広告の電話番号表示オプションを直接クリックしたときに発生するコンバージョン。Google 広告の管理画面で「広告経由の通話数」として表示されます。
WEBSITE_CALL_METRICS ユーザーが広告をクリックした後に、広告主のウェブサイトから(JavaScript をインストールして)動的に生成された電話番号に発信したときに発生するコンバージョン。Google 広告の管理画面では「ウェブサイトからの通話」として表示されます。
STORE_VISITS ユーザーが Google 広告をクリックした後に広告主の実店舗を訪問した場合に発生するコンバージョン。Google 広告の管理画面には「来店」として表示されます。
ANDROID_IN_APP ユーザーが Android アプリでの購入などのアプリ内コンバージョンを達成したときに発生するコンバージョン。Google 広告の管理画面には「Android のアプリ内アクション」として表示されます。
IOS_IN_APP ユーザーが iOS アプリでの購入などのアプリ内コンバージョンを達成したときに発生するコンバージョン。Google 広告の管理画面に「iOS のアプリ内コンバージョン」として表示されます。
IOS_FIRST_OPEN ユーザーが初めて iOS アプリを開いたときに発生するコンバージョン。Google 広告の管理画面では「iOS アプリのインストール(初回起動)」と表示されます。
APP_UNSPECIFIED AppPlatform が指定されていない従来のアプリ コンバージョン。Google 広告の管理画面には「モバイルアプリ」と表示されます。
ANDROID_FIRST_OPEN ユーザーが初めて Android アプリを開いたときに発生するコンバージョン。Google 広告の管理画面には「Android アプリのインストール(初回起動)」と表示されます。
UPLOAD_CALLS ConversionUploadService を介してアップロードされた通話コンバージョン。Google 広告の管理画面には「通話からのインポート」として表示されます。
FIREBASE リンクされた Firebase イベントに由来するコンバージョン。Google 広告の管理画面には「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 Google アナリティクスからの検索広告 360 専用のコンバージョン。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

検索エンジンの検索結果ページのタイプ。

列挙型
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 バージョンでは値が不明です。true の列挙値は、この API バージョンでは返せないか、まだサポートされていません。
UNAVAILABLE 値がポストバックに存在しなかったか、他の理由でこのデータがありません。
WON 広告のアトリビューションを獲得した広告ネットワークは Google でした。
CONTRIBUTED Google はアトリビューションを保証しましたが、落札できませんでした。

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 コンバージョンに至ったユーザーは広告主にとって新しく、ライフタイム バリューが高い。