- JSON 表現
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- 広告
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- AdGroupAdEngineStatus
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfo
- デバイス
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- PositionEstimates
- AdGroupCriterionEngineStatus
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionLabel
- AdGroupLabel
- AgeRangeView
- アセット
- AssetType
- AssetStatus
- AssetEngineStatus
- YoutubeVideoAsset
- ImageAsset
- MimeType
- ImageDimension
- TextAsset
- UnifiedCalloutAsset
- AdScheduleInfo
- MinuteOfHour
- DayOfWeek
- UnifiedSitelinkAsset
- UnifiedPageFeedAsset
- MobileAppAsset
- MobileAppVendor
- UnifiedCallAsset
- CallConversionReportingState
- CallToActionAsset
- CallToActionType
- UnifiedLocationAsset
- BusinessProfileLocation
- LocationOwnershipType
- AssetGroupAsset
- AssetFieldType
- AssetGroupSignal
- AudienceInfo
- AssetGroupListingGroupFilter
- ListingGroupFilterType
- ListingGroupFilterVertical
- ListingGroupFilterDimension
- ProductBiddingCategory
- ListingGroupFilterBiddingCategoryLevel
- ProductBrand
- ProductChannel
- ListingGroupFilterProductChannel
- ProductCondition
- ListingGroupFilterProductCondition
- ProductCustomAttribute
- ListingGroupFilterCustomAttributeIndex
- ProductItemId
- ProductType
- ListingGroupFilterProductTypeLevel
- ListingGroupFilterDimensionPath
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetUsage
- ServedAssetFieldType
- AssetGroup
- AssetGroupStatus
- AdStrength
- AssetSetAsset
- AssetSetAssetStatus
- AssetSet
- BiddingStrategy
- BiddingStrategyStatus
- BiddingStrategyType
- EnhancedCpc
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetImpressionShareLocation
- TargetOutrankShare
- TargetRoas
- TargetSpend
- CampaignBudget
- BudgetDeliveryMethod
- BudgetPeriod
- キャンペーン
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- AdvertisingChannelType
- AdvertisingChannelSubType
- CustomParameter
- RealTimeBiddingSetting
- NetworkSettings
- DynamicSearchAdsSetting
- ShoppingSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- FrequencyCapEntry
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- ManualCpa
- ManualCpc
- ManualCpm
- PercentCpc
- TargetCpm
- CampaignAsset
- CampaignAssetSet
- CampaignAudienceView
- CampaignCriterion
- CampaignCriterionStatus
- LanguageInfo
- LocationGroupInfo
- LocationGroupRadiusUnits
- CampaignLabel
- CartDataSalesView
- 対象
- ConversionAction
- ConversionActionStatus
- ConversionActionType
- ConversionActionCategory
- ValueSettings
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FloodlightSettings
- ConversionCustomVariable
- ConversionCustomVariableStatus
- ConversionCustomVariableFamily
- ConversionCustomVariableCardinality
- FloodlightConversionCustomVariableInfo
- FloodlightVariableType
- FloodlightVariableDataType
- Customer(顧客)
- ConversionTrackingSetting
- ConversionTrackingStatus
- AccountType
- DoubleClickCampaignManagerSetting
- AccountStatus
- CustomerStatus
- CustomerAsset
- CustomerAssetSet
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerManagerLink
- ManagerLinkStatus
- CustomerClient
- DynamicSearchAdsSearchTermView
- GenderView
- GeoTargetConstant
- GeoTargetConstantStatus
- KeywordView
- ラベル
- LabelStatus
- TextLabel
- LanguageConstant
- LocationView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryLevel
- ProductBiddingCategoryStatus
- ProductGroupView
- ShoppingPerformanceView
- UserList
- UserListType
- WebpageView
- アクセス
- ProductChannel
- コンバージョン
- AttributionType
- ConversionStatus
- 指標
- Value
- QualityScoreBucket
- InteractionEventType
- セグメント
- AdNetworkType
- キーワード
- ProductChannelExclusivity
- ProductCondition
- AssetInteractionTarget
クエリから返された行。
JSON 表現 |
---|
{ "adGroup": { object ( |
フィールド | |
---|---|
adGroup |
クエリで参照されている広告グループ。 |
adGroupAd |
クエリで参照されている広告。 |
adGroupAdLabel |
クエリで参照される広告グループの広告ラベル。 |
adGroupAsset |
クエリで参照される広告グループのアセット。 |
adGroupAssetSet |
クエリで参照されている広告グループのアセットセット。 |
adGroupAudienceView |
クエリで参照されている広告グループのオーディエンス ビュー。 |
adGroupBidModifier |
クエリで参照されている入札単価調整比。 |
adGroupCriterion |
クエリで参照されている条件。 |
adGroupCriterionLabel |
クエリで参照される広告グループの条件ラベル。 |
adGroupLabel |
クエリで参照される広告グループのラベル。 |
ageRangeView |
クエリで参照される年齢層ビュー。 |
asset |
クエリで参照されるアセット。 |
assetGroupAsset |
クエリで参照されるアセット グループのアセット。 |
assetGroupSignal |
クエリで参照されるアセット グループのシグナル。 |
assetGroupListingGroupFilter |
クエリで参照されるアセット グループのリスティング グループのフィルタ。 |
assetGroupTopCombinationView |
クエリで参照されているアセット グループの上位の組み合わせのビュー。 |
assetGroup |
クエリで参照されるアセット グループ。 |
assetSetAsset |
クエリで参照されるアセットセットのアセット。 |
assetSet |
クエリで参照されるアセットセット。 |
biddingStrategy |
クエリで参照されている入札戦略。 |
campaignBudget |
クエリで参照されるキャンペーン予算。 |
campaign |
クエリで参照されているキャンペーン。 |
campaignAsset |
クエリで参照されるキャンペーン アセット。 |
campaignAssetSet |
クエリで参照されているキャンペーンのアセットセット。 |
campaignAudienceView |
クエリで参照されているキャンペーンのオーディエンス ビュー。 |
campaignCriterion |
クエリで参照されているキャンペーンの条件。 |
campaignLabel |
クエリで参照されるキャンペーン ラベル。 |
cartDataSalesView |
クエリで参照されるカートデータのセールスビュー。 |
audience |
クエリで参照されているオーディエンス。 |
conversionAction |
クエリで参照されるコンバージョン アクション。 |
conversionCustomVariable |
クエリで参照されるコンバージョン カスタム変数。 |
customer |
クエリで参照されている顧客。 |
customerAsset |
クエリで参照される顧客アセット。 |
customerAssetSet |
クエリで参照される顧客アセットセット。 |
accessibleBiddingStrategy |
クエリで参照されているアクセス可能な入札戦略。 |
customerManagerLink |
クエリで参照される CustomerManagerLink。 |
customerClient |
クエリで参照される CustomerClient。 |
dynamicSearchAdsSearchTermView |
クエリで参照されている動的検索広告の検索語句ビュー。 |
genderView |
クエリで参照される性別ビュー。 |
geoTargetConstant |
クエリで参照されている地域ターゲティングの定数。 |
keywordView |
クエリで参照されているキーワード ビュー。 |
label |
クエリで参照されるラベル。 |
languageConstant |
クエリで参照される言語定数。 |
locationView |
クエリで参照されるロケーション ビュー。 |
productBiddingCategoryConstant |
クエリで参照されている商品の入札カテゴリ。 |
productGroupView |
クエリで参照される商品グループのビュー。 |
shoppingPerformanceView |
クエリで参照されるショッピングのパフォーマンス ビュー。 |
userList |
クエリで参照されるユーザーリスト。 |
webpageView |
クエリで参照されるウェブページ ビュー。 |
visit |
クエリで参照されるイベントレベルの訪問。 |
conversion |
クエリで参照されるイベント単位のコンバージョン。 |
metrics |
指標。 |
segments |
セグメント。 |
customColumns[] |
カスタム列。 |
AdGroup
広告グループ。
JSON 表現 |
---|
{ "resourceName": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
広告グループのリソース名。広告グループのリソース名の形式は次のとおりです。
|
status |
広告グループのステータス。 |
type |
広告グループのタイプ。 |
adRotationMode |
広告グループの広告のローテーション モード。 |
creationTime |
この広告グループが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
targetingSetting |
ターゲティング関連機能の設定。 |
labels[] |
この広告グループに適用されているラベルのリソース名。 |
engineId |
外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウント(Yahoo、Microsoft、Baidu など)専用です。Google 広告エンティティの場合は、代わりに「adGroup.id」を使用します。 |
startDate |
この広告グループの広告配信を開始する日付。デフォルトでは、広告グループの開始日は、現在または開始日のいずれか遅い方になります。このフィールドを設定した場合、ユーザーのタイムゾーンで指定の日付の開始時間に広告グループが開始されます。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。 形式: YYYY-MM-DD 例: 2019-03-14 |
endDate |
広告グループの広告配信を終了する日付。デフォルトでは、広告グループは広告グループの終了日に終了します。このフィールドが設定されている場合、ユーザーのタイムゾーンで指定の日付に広告グループが終了します。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。 形式: YYYY-MM-DD 例: 2019-03-14 |
languageCode |
広告グループ内の広告とキーワードの言語。このフィールドは、Microsoft Advertising アカウントでのみご利用いただけます。詳細: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
lastModifiedTime |
この広告グループが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
id |
広告グループの ID。 |
name |
広告グループの名前です。 新しい広告グループを作成する場合は、このフィールドは必須です。空にすることはできません。 含めることができる文字は、UTF-8 の全角で 255 文字未満にする必要があります。 null(コードポイント 0x0)、NL ラインフィード(コードポイント 0xA)、改行(コードポイント 0xD)の文字を含めることはできません。 |
cpcBidMicros |
最大 CPC(クリック単価)入札。 |
engineStatus |
広告グループのエンジン ステータス。 |
AdGroupStatus
広告グループのステータス。
列挙型 | |
---|---|
UNSPECIFIED |
ステータスが指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
ENABLED |
広告グループは有効です。 |
PAUSED |
広告グループは一時停止されています。 |
REMOVED |
広告グループが削除されている。 |
AdGroupType
広告グループのタイプを列挙する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
タイプが指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
SEARCH_STANDARD |
検索キャンペーンのデフォルトの広告グループタイプです。 |
DISPLAY_STANDARD |
ディスプレイ キャンペーンのデフォルトの広告グループタイプです。 |
SHOPPING_PRODUCT_ADS |
標準の商品広告を配信するショッピング キャンペーンの広告グループタイプです。 |
SHOPPING_SHOWCASE_ADS |
ショッピングの検索結果に表示されるショーケース広告または販売者広告の配信に限定されている広告グループのタイプです。 |
HOTEL_ADS |
ホテル キャンペーンのデフォルトの広告グループタイプです。 |
SHOPPING_SMART_ADS |
スマート ショッピング キャンペーンの広告グループのタイプ。 |
VIDEO_BUMPER |
スキップ不可の短いインストリーム動画広告です。 |
VIDEO_TRUE_VIEW_IN_STREAM |
TrueView(スキップ可能)インストリーム動画広告。 |
VIDEO_TRUE_VIEW_IN_DISPLAY |
TrueView インディスプレイ動画広告 |
VIDEO_NON_SKIPPABLE_IN_STREAM |
スキップ不可のインストリーム動画広告です。 |
VIDEO_OUTSTREAM |
アウトストリーム動画広告。 |
SEARCH_DYNAMIC_ADS |
動的検索広告の広告グループの広告グループのタイプです。 |
SHOPPING_COMPARISON_LISTING_ADS |
ショッピング比較キャンペーンの広告グループのタイプ。 |
PROMOTED_HOTEL_ADS |
プロモート ホテルの広告グループの広告グループタイプ。 |
VIDEO_RESPONSIVE |
動画レスポンシブ広告グループ |
VIDEO_EFFICIENT_REACH |
動画による効率的なリーチの広告グループ |
SMART_CAMPAIGN_ADS |
スマート アシスト キャンペーンの広告グループの種類です。 |
TRAVEL_ADS |
旅行キャンペーンの広告グループの種類です。 |
AdGroupAdRotationMode
広告グループの広告ローテーション モードです。
列挙型 | |
---|---|
UNSPECIFIED |
広告のローテーション モードが指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
OPTIMIZE |
クリック数またはコンバージョン数に基づいて広告グループの広告を最適化する。 |
ROTATE_FOREVER |
均等にローテーションします。 |
AdGroupEngineStatus
広告グループ エンジンのステータス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
AD_GROUP_ELIGIBLE |
非推奨です。使用しないでください。 |
AD_GROUP_EXPIRED |
終了日を過ぎているため、この広告グループでは広告が掲載されていません。 |
AD_GROUP_REMOVED |
広告グループは削除されています。 |
AD_GROUP_DRAFT |
この広告グループは下書きのままであるため、この広告グループでは広告が掲載されていません。 |
AD_GROUP_PAUSED |
広告グループは一時停止されています。 |
AD_GROUP_SERVING |
広告グループは有効で、現在広告が配信されている。 |
AD_GROUP_SUBMITTED |
広告グループが送信されました(Microsoft Bing Ads の以前のステータス)。 |
CAMPAIGN_PAUSED |
キャンペーンが一時停止されているため、この広告グループでは広告が掲載されていません。 |
ACCOUNT_PAUSED |
アカウントが一時停止されているため、この広告グループでは広告が掲載されていません。 |
TargetingSetting
ターゲティング関連機能の設定(キャンペーン単位、広告グループ単位)。ターゲット設定について詳しくは、https://support.google.com/google-ads/answer/7365594 をご覧ください。
JSON 表現 |
---|
{
"targetRestrictions": [
{
object ( |
フィールド | |
---|---|
targetRestrictions[] |
ターゲティング ディメンションごとに、キャンペーンまたは広告グループのリーチを制限する設定。 |
TargetRestriction
ターゲティング ディメンションごとのターゲット設定のリスト。
JSON 表現 |
---|
{
"targetingDimension": enum ( |
フィールド | |
---|---|
targetingDimension |
これらの設定が適用されるターゲティング ディメンション。 |
bidOnly |
この targetDimension で選択した条件でのみ広告を表示するか、このターゲティングディメンションのすべての値をターゲティングして、他の TargetDimensions のターゲティングに基づいて広告を表示するかを指定します。値が |
TargetingDimension
ターゲティング可能なディメンションを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
KEYWORD |
キーワード条件(「mars cruise」など)。カスタム入札単価ディメンションとして「キーワード」を使用できる。キーワードは常にターゲティング ディメンションであるため、TargetRestriction でターゲットの「すべて」ディメンションとして設定することはできません。 |
AUDIENCE |
オーディエンスの条件(ユーザーリスト、ユーザーの興味や関心、カスタム アフィニティ、購買意向の強いオーディエンスなど)。 |
TOPIC |
コンテンツのターゲティング カテゴリを指定するトピック条件(例: 「category::動物>ペット」。ディスプレイや動画のターゲティングに使用します)。 |
GENDER |
性別のターゲティング条件。 |
AGE_RANGE |
年齢層のターゲティング条件。 |
PLACEMENT |
プレースメントの条件には、「www.flowers4sale.com」などのウェブサイト、モバイルアプリ、モバイルアプリのカテゴリ、YouTube 動画、YouTube チャンネルなどがあります。 |
PARENTAL_STATUS |
子供の有無によるターゲティングの条件です。 |
INCOME_RANGE |
収入の範囲ターゲティングの条件。 |
AdGroupAd
広告グループの広告。
JSON 表現 |
---|
{ "resourceName": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
広告のリソース名。広告グループの広告リソース名の形式は次のとおりです。
|
status |
広告のステータス。 |
ad |
広告。 |
creationTime |
この adGroupAd が作成されたときのタイムスタンプ。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
labels[] |
この広告グループの広告に適用されているラベルのリソース名。 |
engineId |
外部エンジン アカウントの広告の ID。このフィールドは、検索広告 360 アカウント(Yahoo、Microsoft、Baidu など)専用です。検索広告 360 以外のエンティティの場合は、代わりに「adGroupAd.ad.id」を使用します。 |
engineStatus |
外部エンジン アカウントの広告の追加ステータス。外部アカウントの種類によって、アクティブ、有効、確認待ちなどのステータスが表示されます。 |
lastModifiedTime |
この広告グループの広告が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
AdGroupAdStatus
AdGroupAd のステータスです。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
ENABLED |
広告グループの広告が有効になっている。 |
PAUSED |
広告グループの広告は一時停止されています。 |
REMOVED |
広告グループの広告は削除されます。 |
広告
広告
JSON 表現 |
---|
{ "resourceName": string, "finalUrls": [ string ], "type": enum ( |
フィールド | |
---|---|
resourceName |
広告のリソース名。広告リソース名の形式は次のとおりです。
|
finalUrls[] |
広告のすべてのクロスドメイン リダイレクト後の転送先となる可能性のある最終ページ URL のリスト。 |
type |
広告タイプ。 |
id |
広告の ID。 |
displayUrl |
一部の広告フォーマットの広告説明に表示される URL。 |
name |
広告の名前。広告を識別するためにのみ使用されます。一意である必要はなく、配信される広告には影響しません。name フィールドは現在、DisplayUploadAd、ImageAd、ShoppingComparisonListingAd、VideoAd でのみサポートされています。 |
共用体フィールド ad_data 。広告タイプに関する詳細情報。必ず 1 つの値を設定する必要があります。ad_data は次のいずれかになります。 |
|
textAd |
テキスト広告に関する詳細です。 |
expandedTextAd |
拡張テキスト広告に関する詳細情報です。 |
responsiveSearchAd |
レスポンシブ検索広告に関する詳細。 |
productAd |
商品広告に関する詳細です。 |
expandedDynamicSearchAd |
拡張動的検索広告に関する詳細です。 |
AdType
使用可能な広告の種類。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
TEXT_AD |
テキスト広告である。 |
EXPANDED_TEXT_AD |
広告が拡張テキスト広告である。 |
CALL_ONLY_AD |
電話専用広告である。 |
EXPANDED_DYNAMIC_SEARCH_AD |
広告が拡張動的検索広告である。 |
HOTEL_AD |
広告がホテル広告である。 |
SHOPPING_SMART_AD |
スマート ショッピング広告である。 |
SHOPPING_PRODUCT_AD |
通常のショッピング広告である。 |
VIDEO_AD |
広告が動画広告である。 |
GMAIL_AD |
この広告は Gmail 広告です。 |
IMAGE_AD |
この広告はイメージ広告です。 |
RESPONSIVE_SEARCH_AD |
広告がレスポンシブ検索広告である。 |
LEGACY_RESPONSIVE_DISPLAY_AD |
広告が以前のレスポンシブ ディスプレイ広告である。 |
APP_AD |
アプリ広告である。 |
LEGACY_APP_INSTALL_AD |
広告が以前のアプリ インストール広告です。 |
RESPONSIVE_DISPLAY_AD |
広告がレスポンシブ ディスプレイ広告である。 |
LOCAL_AD |
広告がローカル広告である。 |
HTML5_UPLOAD_AD |
この広告は、商品カテゴリが HTML5_UPLOAD_AD のディスプレイ アップロード広告です。 |
DYNAMIC_HTML5_AD |
この広告は、いずれかの DYNAMIC_HTML5_* 商品カテゴリのディスプレイ アップロード広告です。 |
APP_ENGAGEMENT_AD |
アプリ エンゲージメント広告である。 |
SHOPPING_COMPARISON_LISTING_AD |
ショッピング比較広告である。 |
VIDEO_BUMPER_AD |
動画のバンパー広告。 |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
スキップ不可の動画インストリーム広告です。 |
VIDEO_OUTSTREAM_AD |
アウトストリーム動画広告です。 |
VIDEO_TRUEVIEW_DISCOVERY_AD |
動画 TrueView インディスプレイ広告。 |
VIDEO_TRUEVIEW_IN_STREAM_AD |
動画 TrueView インストリーム広告。 |
VIDEO_RESPONSIVE_AD |
動画レスポンシブ広告。 |
SMART_CAMPAIGN_AD |
スマート アシスト キャンペーン広告です。 |
APP_PRE_REGISTRATION_AD |
ユニバーサル アプリ事前登録広告です。 |
DISCOVERY_MULTI_ASSET_AD |
ファインド マルチアセット広告です。 |
DISCOVERY_CAROUSEL_AD |
ファインド カルーセル広告です。 |
TRAVEL_AD |
旅行の広告。 |
DISCOVERY_VIDEO_RESPONSIVE_AD |
ファインド動画レスポンシブ広告です。 |
SearchAds360TextAdInfo
検索広告 360 のテキスト広告。
JSON 表現 |
---|
{ "headline": string, "description1": string, "description2": string, "displayUrl": string, "displayMobileUrl": string, "adTrackingId": string } |
フィールド | |
---|---|
headline |
広告の見出し。 |
description1 |
広告の説明欄の 1 行目。 |
description2 |
広告の説明欄の 2 行目。 |
displayUrl |
広告の表示 URL。 |
displayMobileUrl |
広告が表示されたモバイル URL。 |
adTrackingId |
広告のトラッキング ID。 |
SearchAds360ExpandedTextAdInfo
検索広告 360 の拡張テキスト広告。
JSON 表現 |
---|
{ "headline": string, "headline2": string, "headline3": string, "description1": string, "description2": string, "path1": string, "path2": string, "adTrackingId": string } |
フィールド | |
---|---|
headline |
広告の見出し。 |
headline2 |
広告の 2 番目の見出し。 |
headline3 |
広告の 3 番目の見出し。 |
description1 |
広告の説明欄の 1 行目。 |
description2 |
広告の説明欄の 2 行目。 |
path1 |
自動生成された表示 URL に区切り文字が追加されたテキスト。 |
path2 |
path1 に区切り文字で追加されたテキスト。 |
adTrackingId |
広告のトラッキング ID。 |
SearchAds360ResponsiveSearchAdInfo
検索広告 360 のレスポンシブ検索広告。
JSON 表現 |
---|
{ "path1": string, "path2": string, "adTrackingId": string } |
フィールド | |
---|---|
path1 |
自動生成された表示 URL に区切り文字が追加されたテキスト。 |
path2 |
path1 に区切り文字で追加されたテキスト。 |
adTrackingId |
広告のトラッキング ID。 |
SearchAds360ProductAdInfo
この型にはフィールドがありません。
検索広告 360 の商品広告。
SearchAds360ExpandedDynamicSearchAdInfo
拡張動的検索広告。
JSON 表現 |
---|
{ "description1": string, "description2": string, "adTrackingId": string } |
フィールド | |
---|---|
description1 |
広告の説明欄の 1 行目。 |
description2 |
広告の説明欄の 2 行目。 |
adTrackingId |
広告のトラッキング ID。 |
AdGroupAdEngineStatus
AdGroupAd のエンジン ステータスを列挙します。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
AD_GROUP_AD_ELIGIBLE |
非推奨です。使用しないでください。 |
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: クリエイティブは承認されませんでした。 |
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW |
バイドゥ: モバイル URL が審査中です。 |
AD_GROUP_AD_PARTIALLY_INVALID |
バイドゥ: クリエイティブはモバイル デバイスでは無効ですが、パソコンでは有効です。 |
AD_GROUP_AD_TO_BE_ACTIVATED |
バイドゥ: クリエイティブを有効にする準備が整いました。 |
AD_GROUP_AD_NOT_REVIEWED |
Baidu: クリエイティブが審査されていません。 |
AD_GROUP_AD_ON_HOLD |
非推奨です。使用しない。以前は Gemini で使用 |
AD_GROUP_AD_PAUSED |
クリエイティブは一時停止しました。 |
AD_GROUP_AD_REMOVED |
クリエイティブを削除しました。 |
AD_GROUP_AD_PENDING_REVIEW |
クリエイティブは審査待ちです。 |
AD_GROUP_AD_UNDER_REVIEW |
クリエイティブは審査中です。 |
AD_GROUP_AD_APPROVED |
クリエイティブが承認されました。 |
AD_GROUP_AD_DISAPPROVED |
クリエイティブが不承認となりました。 |
AD_GROUP_AD_SERVING |
クリエイティブを配信しています。 |
AD_GROUP_AD_ACCOUNT_PAUSED |
アカウントが一時停止されているため、クリエイティブは一時停止されています。 |
AD_GROUP_AD_CAMPAIGN_PAUSED |
キャンペーンが一時停止されているため、クリエイティブは一時停止されています。 |
AD_GROUP_AD_AD_GROUP_PAUSED |
広告グループが一時停止されているため、クリエイティブは一時停止されています。 |
AdGroupAdLabel
広告グループの広告とラベルの関係。
JSON 表現 |
---|
{ "resourceName": string, "adGroupAd": string, "label": string } |
フィールド | |
---|---|
resourceName |
広告グループ広告ラベルのリソース名です。広告グループの広告ラベルのリソース名の形式は |
adGroupAd |
ラベルが添付される広告グループ広告。 |
label |
広告グループ広告に割り当てられるラベル。 |
AdGroupAsset
広告グループとアセット間のリンク。
JSON 表現 |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
フィールド | |
---|---|
resourceName |
広告グループ アセットのリソース名。AdGroupAsset リソース名の形式は次のとおりです。
|
adGroup |
必須。アセットがリンクされている広告グループ。 |
asset |
必須。広告グループにリンクされているアセットです。 |
status |
広告グループ アセットのステータスです。 |
AssetLinkStatus
アセットリンクのステータスを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ENABLED |
アセットのリンクが有効になっています。 |
REMOVED |
アセットのリンクを削除しました。 |
PAUSED |
アセットのリンクは一時停止されています。 |
AdGroupAssetSet
AdGroupAssetSet は、広告グループとアセットセット間のリンクです。AdGroupAssetSet を作成すると、アセットセットが広告グループにリンクされます。
JSON 表現 |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
フィールド | |
---|---|
resourceName |
広告グループのアセットセットのリソース名。広告グループのアセットセットのリソース名の形式は次のとおりです。
|
adGroup |
このアセットセットがリンクされている広告グループ。 |
assetSet |
広告グループにリンクされているアセットセット。 |
status |
広告グループのアセットセットのステータス。読み取り専用です。 |
AssetSetLinkStatus
アセットセットとそのコンテナ間のリンクの考えられるステータス。
列挙型 | |
---|---|
UNSPECIFIED |
ステータスが指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。これはレスポンス専用の値です。 |
ENABLED |
アセットセットとそのコンテナのリンクが有効になっています。 |
REMOVED |
アセットセットとそのコンテナ間のリンクが解除されます。 |
AdGroupAudienceView
広告グループのオーディエンス ビュー。ディスプレイ ネットワーク広告と YouTube ネットワーク広告のインタレスト カテゴリとリマーケティング リスト、検索広告向けリマーケティング リスト(RLSA)に関する掲載結果データ(オーディエンス単位で集計)が含まれます。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
広告グループのオーディエンス ビューのリソース名。広告グループのオーディエンス ビューのリソース名の形式は次のとおりです。
|
AdGroupBidModifier
広告グループの入札単価調整比を表します。
JSON 表現 |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
フィールド | |
---|---|
resourceName |
広告グループの入札単価調整比のリソース名。広告グループの入札単価調整比のリソース名の形式は次のとおりです。
|
bidModifier |
条件が一致した場合の入札の修飾子。修飾子は 0.1~10.0 の範囲内にする必要があります。PreferredContent の範囲は 1.0~6.0 です。デバイスタイプをオプトアウトするには、0 を使用します。 |
共用体フィールド V5 以降の作成オペレーションでは必須です。 |
|
device |
デバイスの条件。 |
DeviceInfo
デバイスの条件。
JSON 表現 |
---|
{
"type": enum ( |
フィールド | |
---|---|
type |
デバイスのタイプ。 |
デバイス
ターゲティングに使用できる Google 広告のデバイスを列挙します。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
このバージョンでは値が不明です。 |
MOBILE |
フル インターネット ブラウザ搭載のモバイル デバイス。 |
TABLET |
フル インターネット ブラウザ搭載のタブレット。 |
DESKTOP |
パソコン。 |
CONNECTED_TV |
スマートテレビとゲーム機。 |
OTHER |
その他のデバイスタイプ。 |
AdGroupCriterion
広告グループの条件。adGroupCriterion レポートでは、広告グループに明示的に追加された条件のみが返されます。
JSON 表現 |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
広告グループの条件のリソース名。広告グループの条件のリソース名の形式は次のとおりです。
|
creationTime |
この広告グループの条件が作成された時点のタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
status |
条件のステータス。 これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。 |
qualityInfo |
基準の品質に関する情報。 |
type |
条件のタイプ。 |
labels[] |
この広告グループの条件に適用されているラベルのリソース名。 |
positionEstimates |
さまざまな掲載順位におけるクライテリアの入札単価の見積もりです。 |
finalUrls[] |
広告のすべてのクロスドメイン リダイレクト後の転送先となる可能性のある最終ページ URL のリスト。 |
engineId |
外部エンジン アカウントの広告グループの条件の ID。このフィールドは、Google 広告アカウント以外のアカウント(Yahoo、Microsoft、Baidu など)専用です。Google 広告エンティティの場合は、代わりに「adGroupCriterion.criterion_id」を使用します。 |
lastModifiedTime |
この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
criterionId |
条件の ID。 |
adGroup |
条件が属する広告グループです。 |
negative |
条件をターゲットに設定するか( このフィールドは変更できません。条件を正から負に変更するには、その条件を削除してから再度追加します。 |
bidModifier |
条件が一致した場合の入札の修飾子。修飾子は 0.1~10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
cpcBidMicros |
クリック単価(CPC)。 |
effectiveCpcBidMicros |
有効な CPC(クリック単価)入札。 |
engineStatus |
広告グループのエンジン ステータスの条件。 |
finalUrlSuffix |
パラメータを最終ページ URL に追加するための URL テンプレート。 |
trackingUrlTemplate |
トラッキング URL を作成するための URL テンプレート。 |
共用体フィールド 1 つのみ設定する必要があります。 |
|
keyword |
キーワード。 |
listingGroup |
リスティング グループ。 |
ageRange |
年齢層。 |
gender |
性別。 |
userList |
ユーザーリスト。 |
webpage |
ウェブページ |
location |
位置情報] をタップします。 |
AdGroupCriterionStatus
AdGroupCriterion のステータスです。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
ENABLED |
広告グループの条件が有効になっています。 |
PAUSED |
広告グループの条件は一時停止されています。 |
REMOVED |
広告グループの条件が削除されます。 |
QualityInfo
広告グループの条件の品質情報のコンテナです。
JSON 表現 |
---|
{ "qualityScore": integer } |
フィールド | |
---|---|
qualityScore |
品質スコア。 Google が値を決定するための十分な情報を持っていない場合は、このフィールドに値が入力されないことがあります。 |
CriterionType
指定可能な条件タイプを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
KEYWORD |
キーワード(例: 「火星 クルーズ」)。 |
PLACEMENT |
プレースメント。ウェブサイトとも呼ばれます。例: www.flowers4sale.com |
MOBILE_APP_CATEGORY |
ターゲットとするモバイルアプリ カテゴリ。 |
MOBILE_APPLICATION |
ターゲットとするモバイルアプリ。 |
DEVICE |
ターゲットに設定するデバイス。 |
LOCATION |
ターゲットに設定する地域です。 |
LISTING_GROUP |
ターゲットとするリスティング グループ。 |
AD_SCHEDULE |
広告のスケジュール。 |
AGE_RANGE |
年齢層。 |
GENDER |
性別。 |
INCOME_RANGE |
収入の範囲。 |
PARENTAL_STATUS |
子供の有無。 |
YOUTUBE_VIDEO |
YouTube 動画。 |
YOUTUBE_CHANNEL |
YouTube チャンネル。 |
USER_LIST |
ユーザーリスト。 |
PROXIMITY |
近接。 |
TOPIC |
ディスプレイ ネットワークのトピック ターゲット(「ペット、動物」など)。 |
LISTING_SCOPE |
対象とするリスティング スコープ。 |
LANGUAGE |
学びました。 |
IP_BLOCK |
IpBlock です。 |
CONTENT_LABEL |
カテゴリを除外するためのコンテンツ ラベル。 |
CARRIER |
携帯通信会社] に移動します。 |
USER_INTEREST |
ユーザーが関心を持っているカテゴリ。 |
WEBPAGE |
動的検索広告のウェブページの条件。 |
OPERATING_SYSTEM_VERSION |
OSの種類です |
APP_PAYMENT_MODEL |
アプリの支払いモデル。 |
MOBILE_DEVICE |
モバイル デバイス。 |
CUSTOM_AFFINITY |
カスタム アフィニティ。 |
CUSTOM_INTENT |
カスタム インテント。 |
LOCATION_GROUP |
ビジネス グループ。 |
CUSTOM_AUDIENCE |
作成 |
COMBINED_AUDIENCE |
組み合わせオーディエンス |
KEYWORD_THEME |
スマート アシスト キャンペーンのキーワードのテーマ |
AUDIENCE |
対象読者 |
LOCAL_SERVICE_ID |
ローカル サービス広告のサービス ID。 |
BRAND |
ブランド |
BRAND_LIST |
ブランドリスト |
LIFE_EVENT |
ライフイベント |
PositionEstimates
さまざまな掲載順位におけるクライテリアの入札単価の見積もりです。
JSON 表現 |
---|
{ "topOfPageCpcMicros": string } |
フィールド | |
---|---|
topOfPageCpcMicros |
検索結果の最初のページの上部に広告を表示するために必要なクリック単価の見積もり額です。 |
AdGroupCriterionEngineStatus
AdGroupCriterion のエンジン ステータスを列挙します。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
AD_GROUP_CRITERION_ELIGIBLE |
非推奨です。使用しないでください。 |
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: 入札単価または品質が低すぎるため表示できません。 |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
バイドゥ: モバイルでは入札単価または品質が低すぎるが、パソコンでは表示条件を満たす。 |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
バイドゥ: 入札単価または品質がパソコンでは低すぎるが、モバイルでは表示可能。 |
AD_GROUP_CRITERION_INVALID_SEARCH |
Baidu: 入札単価または品質が低すぎるため表示できません。 |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
バイドゥ: 検索ボリュームが少ないため、バイドゥによって一時停止されています。 |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
バイドゥ: モバイル URL が審査中です。 |
AD_GROUP_CRITERION_PARTIALLY_INVALID |
バイドゥ: 一方のデバイスのランディング ページは無効だが、もう一方のデバイスのランディング ページは有効です。 |
AD_GROUP_CRITERION_TO_BE_ACTIVATED |
バイドゥ: キーワードはバイドゥ アカウント管理によって作成および一時停止され、有効化できるようになりました。 |
AD_GROUP_CRITERION_UNDER_REVIEW |
バイドゥ: バイドゥで審査中。Gemini: 条件は審査中です。 |
AD_GROUP_CRITERION_NOT_REVIEWED |
Baidu: 審査対象の条件。 |
AD_GROUP_CRITERION_ON_HOLD |
非推奨です。使用しない。以前は Gemini で使用 |
AD_GROUP_CRITERION_PENDING_REVIEW |
Y!J : 条件の審査待ち |
AD_GROUP_CRITERION_PAUSED |
条件が一時停止されました。 |
AD_GROUP_CRITERION_REMOVED |
条件が削除されました。 |
AD_GROUP_CRITERION_APPROVED |
条件が承認されました。 |
AD_GROUP_CRITERION_DISAPPROVED |
条件は承認されませんでした。 |
AD_GROUP_CRITERION_SERVING |
条件は有効で、配信中です。 |
AD_GROUP_CRITERION_ACCOUNT_PAUSED |
アカウントが一時停止されたため、条件も一時停止されています。 |
KeywordInfo
キーワードの条件。
JSON 表現 |
---|
{
"matchType": enum ( |
フィールド | |
---|---|
matchType |
キーワードのマッチタイプ。 |
text |
キーワードのテキスト(最大 80 文字、10 単語)。 |
KeywordMatchType
キーワードのマッチタイプ
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
EXACT |
完全一致。 |
PHRASE |
フレーズ一致です。 |
BROAD |
部分一致。 |
ListingGroupInfo
リスティング グループの条件。
JSON 表現 |
---|
{
"type": enum ( |
フィールド | |
---|---|
type |
リスティング グループのタイプ。 |
ListingGroupType
リスティング グループのタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
SUBDIVISION |
リスティング ディメンションに沿った商品の区分。これらのノードは、ターゲット リスティング エントリを提供するために使用されるのではなく、ツリーの構造を定義することのみを目的としています。 |
UNIT |
入札単価を定義するリスティング グループのユニット。 |
AgeRangeInfo
年齢層の基準です。
JSON 表現 |
---|
{
"type": enum ( |
フィールド | |
---|---|
type |
年齢層のタイプ。 |
AgeRangeType
ユーザー属性の年齢層の種類(18 ~ 24 歳など)。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
AGE_RANGE_18_24 |
18 ~ 24 歳。 |
AGE_RANGE_25_34 |
25 ~ 34 歳。 |
AGE_RANGE_35_44 |
35 ~ 44 歳。 |
AGE_RANGE_45_54 |
45 ~ 54 歳。 |
AGE_RANGE_55_64 |
55 ~ 64 歳。 |
AGE_RANGE_65_UP |
65 歳以上。 |
AGE_RANGE_UNDETERMINED |
年齢層不明。 |
GenderInfo
性別の条件。
JSON 表現 |
---|
{
"type": enum ( |
フィールド | |
---|---|
type |
性別のタイプ。 |
GenderType
ユーザー属性のタイプ(女性など)。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
MALE |
男性。 |
FEMALE |
女性。 |
UNDETERMINED |
性別が指定されていません。 |
UserListInfo
ユーザーリストの条件。ターゲットに設定する広告主が定義したユーザーリストを表します。
JSON 表現 |
---|
{ "userList": string } |
フィールド | |
---|---|
userList |
ユーザーリストのリソース名。 |
WebpageInfo
広告主のウェブサイトのウェブページをターゲットに設定するための条件を表します。
JSON 表現 |
---|
{
"conditions": [
{
object ( |
フィールド | |
---|---|
conditions[] |
ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
coveragePercentage |
ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。このフィールドは読み取り専用です。 |
criterionName |
このパラメータで定義されている条件の名前。name の値は、このタイプのパラメータの条件を識別、並べ替え、フィルタするために使用されます。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
WebpageConditionInfo
広告主のウェブサイトのウェブページをターゲットに設定するための論理式。
JSON 表現 |
---|
{ "operand": enum ( |
フィールド | |
---|---|
operand |
ウェブページのターゲティング条件のオペランド。 |
operator |
ウェブページ ターゲティング条件の演算子。 |
argument |
ウェブページのターゲティング条件の引数。 |
WebpageConditionOperand
ウェブページの条件内のウェブページの条件オペランド。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
URL |
ウェブページ URL のターゲティング条件を示すオペランド。 |
CATEGORY |
ウェブページ カテゴリ ターゲティング条件を示すオペランド。 |
PAGE_TITLE |
ウェブページ タイトルのターゲティング条件を示すオペランド。 |
PAGE_CONTENT |
ウェブページ コンテンツ ターゲティング条件を示すオペランド。 |
CUSTOM_LABEL |
ウェブページのカスタムラベルのターゲティング条件を示すオペランド。 |
WebpageConditionOperator
ウェブページの条件で使用するウェブページ条件演算子です。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
EQUALS |
引数のウェブ条件が、比較対象のウェブ条件と同じである。 |
CONTAINS |
web condition 引数は、比較対象のウェブ条件の一部です。 |
LocationInfo
地域の条件。
JSON 表現 |
---|
{ "geoTargetConstant": string } |
フィールド | |
---|---|
geoTargetConstant |
地域ターゲティングの定数リソース名。 |
AdGroupCriterionLabel
広告グループの条件とラベルの関係。
JSON 表現 |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string } |
フィールド | |
---|---|
resourceName |
広告グループの条件ラベルのリソース名。広告グループの条件ラベルのリソース名の形式は、 |
adGroupCriterion |
ラベルが添付される広告グループ条件。 |
label |
広告グループの条件に割り当てられたラベル。 |
AdGroupLabel
広告グループとラベルの関係。
JSON 表現 |
---|
{ "resourceName": string, "adGroup": string, "label": string } |
フィールド | |
---|---|
resourceName |
広告グループラベルのリソース名。広告グループラベルのリソース名の形式は |
adGroup |
ラベルが添付される広告グループ。 |
label |
広告グループに割り当てられたラベル。 |
AgeRangeView
年齢層のビュー。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
年齢層ビューのリソース名。年齢層ビューのリソース名の形式は次のとおりです。
|
アセット
アセットは広告の一部で、複数の広告で共有できます。画像(ImageAsset)や動画(YouTubeVideoAsset)などを使用できます。アセットは変更できず、削除できません。アセットの配信を停止するには、そのアセットを使用しているエンティティからアセットを削除します。
JSON 表現 |
---|
{ "resourceName": string, "type": enum ( |
フィールド | |
---|---|
resourceName |
アセットのリソース名。アセットのリソース名の形式は次のとおりです。
|
type |
アセットのタイプ。 |
finalUrls[] |
すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。 |
status |
アセットのステータス。 |
creationTime |
この求人が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
lastModifiedTime |
このアセットが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
id |
アセットの ID。 |
name |
アセットの名前(省略可)。 |
trackingUrlTemplate |
トラッキング URL を作成するための URL テンプレート。 |
engineStatus |
アセットのエンジン ステータス。 |
共用体フィールド asset_data 。アセットの特定のタイプ。asset_data は次のいずれかになります。 |
|
youtubeVideoAsset |
YouTube 動画アセット。 |
imageAsset |
画像アセット。 |
textAsset |
テキスト アセット。 |
calloutAsset |
統合されたコールアウト アセット。 |
sitelinkAsset |
統合されたサイトリンク アセット。 |
pageFeedAsset |
統合されたページフィード アセット。 |
mobileAppAsset |
モバイルアプリのアセット。 |
callAsset |
統合された電話番号アセット。 |
callToActionAsset |
行動を促すフレーズのアセット。 |
locationAsset |
統合された住所アセット。 |
AssetType
使用可能なアセットタイプを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
YOUTUBE_VIDEO |
YouTube 動画アセット。 |
MEDIA_BUNDLE |
メディア バンドル アセット。 |
IMAGE |
画像アセット。 |
TEXT |
テキスト アセット。 |
LEAD_FORM |
リードフォーム アセット。 |
BOOK_ON_GOOGLE |
「Google で予約」アセット。 |
PROMOTION |
プロモーション アセット。 |
CALLOUT |
コールアウト アセット。 |
STRUCTURED_SNIPPET |
構造化スニペット アセット。 |
SITELINK |
サイトリンク アセット。 |
PAGE_FEED |
ページフィード アセット。 |
DYNAMIC_EDUCATION |
動的な教育アセット。 |
MOBILE_APP |
モバイルアプリ アセット。 |
HOTEL_CALLOUT |
ホテル コールアウト アセット。 |
CALL |
電話番号アセット。 |
PRICE |
価格アセット。 |
CALL_TO_ACTION |
行動を促すフレーズのアセット。 |
DYNAMIC_REAL_ESTATE |
動的な不動産アセット。 |
DYNAMIC_CUSTOM |
動的なカスタム アセット。 |
DYNAMIC_HOTELS_AND_RENTALS |
ホテルと賃貸物件の動的なアセット。 |
DYNAMIC_FLIGHTS |
動的なフライト アセット。 |
DISCOVERY_CAROUSEL_CARD |
ファインド カルーセル カードのアセット。 |
DYNAMIC_TRAVEL |
動的な旅行アセット。 |
DYNAMIC_LOCAL |
動的なローカル アセット。 |
DYNAMIC_JOBS |
動的な求人アセット。 |
LOCATION |
住所アセット。 |
HOTEL_PROPERTY |
ホテル物件のアセット。 |
AssetStatus
アセットのステータスです。
列挙型 | |
---|---|
UNSPECIFIED |
ステータスが指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。これはレスポンス専用の値です。 |
ENABLED |
アセットは有効になっています。 |
REMOVED |
アセットが削除されます。 |
ARCHIVED |
アセットはアーカイブされています。 |
PENDING_SYSTEM_GENERATED |
システムによって生成され、ユーザーの確認待ちのアセットです。 |
AssetEngineStatus
次の ID = 11
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
SERVING |
アセットは有効です。 |
SERVING_LIMITED |
アセットは有効(制限付き)です。 |
DISAPPROVED |
アセットは不承認(無効)です。 |
DISABLED |
アセットは無効(保留中)です。 |
REMOVED |
アセットが削除されました。 |
YoutubeVideoAsset
YouTube アセット。
JSON 表現 |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
フィールド | |
---|---|
youtubeVideoTitle |
YouTube 動画のタイトル。 |
youtubeVideoId |
YouTube 動画 ID。YouTube 動画の URL で使用される 11 文字の文字列値です。 |
ImageAsset
画像アセット。
JSON 表現 |
---|
{ "mimeType": enum ( |
フィールド | |
---|---|
mimeType |
画像アセットの MIME タイプ。 |
fullSize |
元のサイズでこの画像のメタデータ。 |
fileSize |
画像アセットのファイルサイズ(バイト単位)。 |
MimeType
MIME タイプ
列挙型 | |
---|---|
UNSPECIFIED |
MIME タイプが指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
IMAGE_JPEG |
image/jpeg の MIME タイプ。 |
IMAGE_GIF |
画像/GIF の MIME タイプ。 |
IMAGE_PNG |
image/png の MIME タイプ。 |
FLASH |
application/x-shockwave-flash の MIME タイプ。 |
TEXT_HTML |
text/html の MIME タイプ。 |
PDF |
application/pdf の MIME タイプ。 |
MSWORD |
application/msword の MIME タイプ。 |
MSEXCEL |
application/vnd.ms-excel の MIME タイプ。 |
RTF |
application/rtf の MIME タイプ。 |
AUDIO_WAV |
音声/wav の MIME タイプ。 |
AUDIO_MP3 |
Audio/mp3 の MIME タイプ。 |
HTML5_AD_ZIP |
application/x-html5-ad-zip の MIME タイプ。 |
ImageDimension
特定のサイズ(元のサイズまたはサイズ変更された画像)の画像のメタデータ。
JSON 表現 |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
フィールド | |
---|---|
heightPixels |
画像の高さ。 |
widthPixels |
画像の幅。 |
url |
この高さと幅の画像を返す URL。 |
TextAsset
テキスト アセット。
JSON 表現 |
---|
{ "text": string } |
フィールド | |
---|---|
text |
テキスト アセットのテキスト コンテンツ。 |
UnifiedCalloutAsset
統合されたコールアウト アセット。
JSON 表現 |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
フィールド | |
---|---|
calloutText |
コールアウトのテキスト。この文字列の長さは 1~25 で指定します。 |
startDate |
このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。 |
endDate |
このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。 |
adScheduleTargets[] |
アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。 |
useSearcherTimeZone |
検索ユーザーのタイムゾーンでアセットを表示するかどうかを指定します。Microsoft 広告に適用されます。 |
AdScheduleInfo
AdSchedule 条件を表します。
AdSchedule は、広告を表示する曜日と時間帯として指定します。
同じ日に追加できる AdSchedules は 6 つまでです。
JSON 表現 |
---|
{ "startMinute": enum ( |
フィールド | |
---|---|
startMinute |
このスケジュールが開始される開始時間の数分後。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
endMinute |
終了時刻の後の分。このスケジュールが終了します。スケジュールに終了分は含まれません。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
dayOfWeek |
スケジュールを適用する曜日。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
startHour |
開始時刻(24 時間制)。このフィールドは 0 ~ 23 の範囲で指定する必要があります。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
endHour |
24 時間制の終了時刻。24 は一日の終わりを表します。このフィールドは 0 ~ 24 の範囲で指定する必要があります。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
MinuteOfHour
15 分の 1 時間の列挙です。例: 「FIFTEEN」
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
このバージョンでは値が不明です。 |
ZERO |
正時 0 分を過ぎています。 |
FIFTEEN |
正時 15 分。 |
THIRTY |
正時 30 分後。 |
FORTY_FIVE |
正時 45 分後。 |
DayOfWeek
曜日を列挙します(例: 「月曜日」)。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
このバージョンでは値が不明です。 |
MONDAY |
月曜日 |
TUESDAY |
火曜日 |
WEDNESDAY |
水曜日 |
THURSDAY |
木曜日 |
FRIDAY |
金曜日です。 |
SATURDAY |
指定します。 |
SUNDAY |
Sunday |
UnifiedSitelinkAsset
統合されたサイトリンク アセット。
JSON 表現 |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
フィールド | |
---|---|
linkText |
サイトリンクの URL 表示テキスト。この文字列の長さは 1~25 で指定します。 |
description1 |
サイトリンクの説明の 1 行目。設定する場合は、長さを 1~35 の範囲で設定し、description2 も設定する必要があります。 |
description2 |
サイトリンクの説明の 2 行目。設定する場合、長さは 1~35 の範囲で指定する必要があります。また、description1 も設定する必要があります。 |
startDate |
このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。 |
endDate |
このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。 |
adScheduleTargets[] |
アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。 |
trackingId |
サイトリンク アセットのクリックをトラッキングするために使用される ID。これは Yahoo!日本のみのフィールドです。 |
useSearcherTimeZone |
検索ユーザーのタイムゾーンでサイトリンク アセットを表示するかどうか。Microsoft 広告に適用されます。 |
mobilePreferred |
サイトリンク アセットをモバイル デバイスで表示するための設定かどうかを指定します。Microsoft 広告に適用されます。 |
UnifiedPageFeedAsset
統合されたページフィード アセット。
JSON 表現 |
---|
{ "pageUrl": string, "labels": [ string ] } |
フィールド | |
---|---|
pageUrl |
広告主がターゲットとするウェブページ。 |
labels[] |
ページ URL のグループ化に使用されるラベル。 |
MobileAppAsset
モバイルアプリを表すアセット。
JSON 表現 |
---|
{
"appId": string,
"appStore": enum ( |
フィールド | |
---|---|
appId |
必須。モバイルアプリを一意に識別する文字列です。Android の場合は「com.android.ebay」、iOS の場合は「12345689」のように、プラットフォームのネイティブ ID のみを含める必要があります。 |
appStore |
必須。この特定のアプリを配信するアプリケーション ストア。 |
MobileAppVendor
モバイルアプリ ベンダーのタイプ
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
APPLE_APP_STORE |
Apple App Store のモバイルアプリ ベンダー。 |
GOOGLE_APP_STORE |
Google App Store のモバイルアプリ ベンダー。 |
UnifiedCallAsset
統合された電話番号アセット。
JSON 表現 |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
フィールド | |
---|---|
countryCode |
電話番号の 2 文字の国コード。例: 「US」、「us」。 |
phoneNumber |
広告主の未加工の電話番号。例: 「1234567890」、「(123)456-7890」 |
callConversionReportingState |
この CallAsset では、独自の通話コンバージョン設定を使用するか、アカウント単位の設定を使用するか、通話コンバージョンを無効にするかを示します。 |
callConversionAction |
通話コンバージョンを関連付けるコンバージョン アクション。設定しない場合は、デフォルトのコンバージョン アクションが使用されます。このフィールドは、callConversionReportingState が USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION に設定されている場合にのみ有効になります。 |
adScheduleTargets[] |
アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。 |
callOnly |
ウェブサイトへのリンクのない電話番号のみが通話に表示されるかどうか。Microsoft 広告に適用されます。 |
callTrackingEnabled |
コール トラッキングで通話を有効にするかどうか。Microsoft 広告に適用されます。 |
useSearcherTimeZone |
検索ユーザーのタイムゾーンで電話番号表示オプションを表示するかどうかを指定します。Microsoft 広告に適用されます。 |
startDate |
このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。 |
endDate |
このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。 |
CallConversionReportingState
通話コンバージョン アクションの状態で使用可能なデータタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
DISABLED |
通話コンバージョン アクションが無効になっています。 |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
通話コンバージョン アクションでは、アカウント単位で設定された通話コンバージョンの種類が使用されます。 |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
通話コンバージョン アクションでは、リソース(電話専用広告または電話番号表示オプション)単位で設定された通話コンバージョンの種類が使用されます。 |
CallToActionAsset
行動を促すフレーズのアセット。
JSON 表現 |
---|
{
"callToAction": enum ( |
フィールド | |
---|---|
callToAction |
お気軽にお問い合わせください。 |
CallToActionType
行動を促すフレーズのタイプを説明する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
LEARN_MORE |
カスタム外部リンクの種類は詳細です。 |
GET_QUOTE |
行動を促すフレーズのタイプは「見積もりを依頼」です。 |
APPLY_NOW |
行動を促すフレーズのタイプを適用しました。 |
SIGN_UP |
カスタム外部リンクの種類は登録です。 |
CONTACT_US |
行動を促すフレーズの種類は「お問い合わせ」です。 |
SUBSCRIBE |
行動を促すフレーズのタイプは、チャンネル登録です。 |
DOWNLOAD |
行動を促すフレーズのタイプは「ダウンロード」です。 |
BOOK_NOW |
行動を促すフレーズのタイプは「今すぐ予約」です。 |
SHOP_NOW |
行動を促すフレーズのタイプは「今すぐ購入」です。 |
BUY_NOW |
行動を促すフレーズのタイプは「今すぐ購入」です。 |
DONATE_NOW |
行動を促すフレーズの種類は「今すぐ寄付する」です。 |
ORDER_NOW |
行動を促すフレーズのタイプは「order」です。 |
PLAY_NOW |
行動を促すフレーズのタイプは「今すぐ再生」です。 |
SEE_MORE |
行動を促すフレーズのタイプは詳細です。 |
START_NOW |
行動を促すフレーズのタイプは「今すぐ開始」です。 |
VISIT_SITE |
行動を促すフレーズのタイプは「サイトにアクセス」です。 |
WATCH_NOW |
行動を促すフレーズのタイプは「今すぐ見る」です。 |
UnifiedLocationAsset
統合された住所アセット。
JSON 表現 |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
フィールド | |
---|---|
placeId |
プレイス ID は、Google プレイスのデータベースおよび Google マップで、特定の場所を一意に識別する ID です。このフィールドは、特定のお客様 ID とアセットタイプに対して一意です。Place ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。 |
businessProfileLocations[] |
顧客のビジネス拠点のリスト。ビジネス プロフィール アカウントから住所アセットを同期している場合にのみ返されます。同じアカウントで、同じ場所 ID を参照する複数のビジネス プロフィールのリスティングを作成できます。 |
locationOwnershipType |
ビジネスのオーナー権限のタイプ。タイプが BUSINESS_OWNER の場合は、住所表示オプションとして表示されます。タイプが AFFILIATE の場合は、アフィリエイト住所として使用されます。 |
BusinessProfileLocation
リンクされたビジネス プロフィール アカウントから同期された、ビジネス プロフィールのビジネス情報。
JSON 表現 |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
フィールド | |
---|---|
labels[] |
広告主様がビジネス プロフィール アカウントでビジネス情報に対して指定したラベル。これはビジネス プロフィール アカウントから同期されます。 |
storeCode |
このビジネス拠点のビジネス プロフィールの店舗コード。これはビジネス プロフィール アカウントから同期されます。 |
listingId |
このビジネス プロフィールのビジネス情報のリスティング ID。これは、リンクされているビジネス プロフィール アカウントから同期されます。 |
LocationOwnershipType
ビジネスのオーナー権限の種類。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
BUSINESS_OWNER |
ビジネス拠点のビジネス オーナー(従来版の住所表示オプション - LE)。 |
AFFILIATE |
アフィリエイト住所(第三者の住所表示オプション - ALE)。 |
AssetGroupAsset
AssetGroupAsset は、アセットとアセット グループ間のリンクです。AssetGroupAsset を追加すると、アセットがアセット グループとリンクされます。
JSON 表現 |
---|
{ "resourceName": string, "assetGroup": string, "asset": string, "fieldType": enum ( |
フィールド | |
---|---|
resourceName |
アセット グループのアセットのリソース名。アセット グループのアセット リソース名の形式:
|
assetGroup |
このアセット グループのアセットがリンクしているアセット グループ。 |
asset |
このアセット グループのアセットがリンクしているアセット。 |
fieldType |
アセット グループ内のアセットのプレースメントの説明。例: HEADLINE、YOUTUBE_VIDEO など |
status |
アセットとアセット グループ間のリンクのステータス。 |
AssetFieldType
アセットのプレースメントを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
HEADLINE |
広告見出しとして使用するためにアセットがリンクされています。 |
DESCRIPTION |
アセットは説明として使用するためにリンクされています。 |
MANDATORY_AD_TEXT |
必須の広告文として使用できるよう、アセットがリンクされている。 |
MARKETING_IMAGE |
アセットは、マーケティング画像として使用するためにリンクされています。 |
MEDIA_BUNDLE |
アセットがメディア バンドルとして使用するためにリンクされています。 |
YOUTUBE_VIDEO |
YouTube 動画として使用するためにアセットがリンクされています。 |
BOOK_ON_GOOGLE |
アセットがリンクされ、ホテル キャンペーンで「Google で予約」が有効になっていることを示す。 |
LEAD_FORM |
リードフォーム表示オプションとして使用するためにアセットがリンクされています。 |
PROMOTION |
プロモーション表示オプションとして使用するためにアセットがリンクされています。 |
CALLOUT |
コールアウト表示オプションとして使用するために、アセットがリンクされています。 |
STRUCTURED_SNIPPET |
構造化スニペット表示オプションとして使用するために、アセットがリンクされています。 |
SITELINK |
サイトリンクとして使用するためにアセットがリンクされています。 |
MOBILE_APP |
モバイル アプリリンク表示オプションとして使用するためにアセットがリンクされています。 |
HOTEL_CALLOUT |
ホテルのコールアウト表示オプションとして使用するためにアセットがリンクされています。 |
CALL |
電話番号表示オプションとして使用するようにアセットがリンクされています。 |
PRICE |
価格表示オプションとして使用するためにアセットがリンクされています。 |
LONG_HEADLINE |
長い広告見出しとして使用できるよう、アセットがリンクされています。 |
BUSINESS_NAME |
ビジネス名として使用するためにアセットがリンクされています。 |
SQUARE_MARKETING_IMAGE |
アセットは、スクエアのマーケティング画像として使用するためにリンクされています。 |
PORTRAIT_MARKETING_IMAGE |
縦向きのマーケティング画像として使用するためにアセットがリンクされています。 |
LOGO |
アセットがロゴとして使用されるようにリンクされています。 |
LANDSCAPE_LOGO |
横向きのロゴとして使用するためにアセットがリンクされています。 |
VIDEO |
アセットが YouTube 以外のロゴとして使用するためにリンクされています。 |
CALL_TO_ACTION_SELECTION |
行動を促すフレーズの選択に使用するためにアセットがリンクされています。 |
AD_IMAGE |
広告画像を選択するためにアセットがリンクされています。 |
BUSINESS_LOGO |
アセットがビジネスのロゴとして使用するためにリンクされています。 |
HOTEL_PROPERTY |
旅行関連の目標達成のための P-MAX キャンペーンで、ホテル物件として使用するためにアセットがリンクされています。 |
DISCOVERY_CAROUSEL_CARD |
ファインド カルーセル カードとして使用するためにアセットがリンクされています。 |
AssetGroupSignal
AssetGroupSignal は、アセット グループ内のシグナルを表します。シグナルがあれば、コンバージョンに至る見込みが特に高い P-MAX キャンペーンがわかります。P-MAX ではシグナルを使用して、検索、ディスプレイ、動画などのさまざまなチャネルでコンバージョンを見つけるため、購買意向が似ているユーザーやより強い新しいユーザーを探します。
JSON 表現 |
---|
{ "resourceName": string, "assetGroup": string, // Union field |
フィールド | |
---|---|
resourceName |
アセット グループ シグナルのリソース名。アセット グループのシグナルのリソース名の形式:
|
assetGroup |
このアセット グループのシグナルが属するアセット グループ。 |
共用体フィールド signal 。アセット グループのシグナル。signal は次のいずれかになります。 |
|
audience |
P-MAX キャンペーンで使用されるオーディエンス シグナル。 |
AudienceInfo
オーディエンスの条件です。
JSON 表現 |
---|
{ "audience": string } |
フィールド | |
---|---|
audience |
オーディエンス リソース名。 |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter は、アセット グループ内のリスティング グループのフィルタツリー ノードを表します。
JSON 表現 |
---|
{ "resourceName": string, "assetGroup": string, "id": string, "type": enum ( |
フィールド | |
---|---|
resourceName |
アセット グループのリスティング グループ フィルタのリソース名。アセット グループのリスティング グループのフィルタのリソース名の形式:
|
assetGroup |
このアセット グループのリスティング グループ フィルタが属しているアセット グループ。 |
id |
ListingGroupFilter の ID。 |
type |
リスティング グループのフィルタノードの種類。 |
vertical |
現在のノードツリーが表す垂直。同じツリー内のすべてのノードは同じカテゴリに属している必要があります。 |
caseValue |
このリスティング グループが親を絞り込むために使用するディメンション値。ルートグループに対して未定義です。 |
parentListingGroupFilter |
親のリスティング グループの区分のリソース名。ルート リスティング グループのフィルタノードの場合は null。 |
path |
このリスティング グループ フィルタを定義するディメンションのパス。 |
ListingGroupFilterType
リスティング グループのフィルタのタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
SUBDIVISION |
一部のリスティング ディメンションに基づく商品の区分。 |
UNIT_INCLUDED |
含まれるリスティング グループのフィルタリーフノード。 |
UNIT_EXCLUDED |
除外リスティング グループのフィルタリーフノード。 |
ListingGroupFilterVertical
リスティング グループのフィルタ カテゴリのタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
SHOPPING |
ショッピングのカテゴリを表します。このカテゴリは、小売向け P-MAX キャンペーンでのみ使用できます。 |
ListingGroupFilterDimension
アセット グループのリスティング グループ フィルタのリスティング ディメンション。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド dimension 。次のいずれかのタイプのディメンションが常に存在します。dimension は次のいずれかになります。 |
|
productBiddingCategory |
商品情報の入札カテゴリ。 |
productBrand |
商品のブランド。 |
productChannel |
商品の地域区分。 |
productCondition |
商品情報の状態。 |
productCustomAttribute |
商品のカスタム属性。 |
productItemId |
商品の商品アイテム ID。 |
productType |
商品情報のタイプ。 |
ProductBiddingCategory
特定のレベルの入札カテゴリの 1 つの要素。最上位のカテゴリはレベル 1、その子はレベル 2 というように続きます。現在、最大 5 つのレベルがサポートされています。ユーザーは、カテゴリのレベルを示すディメンション タイプを指定する必要があります。同じ区分のすべてのケースは、同じディメンション タイプ(カテゴリレベル)である必要があります。
JSON 表現 |
---|
{
"level": enum ( |
フィールド | |
---|---|
level |
分類におけるカテゴリのレベルを示します。 |
id |
商品入札カテゴリの ID。 この ID は google_product_category ID に相当します。詳しくは、https://support.google.com/merchants/answer/6324436 をご覧ください。 |
ListingGroupFilterBiddingCategoryLevel
リスティング グループのフィルタ入札カテゴリのレベル。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
LEVEL1 |
レベル 1。 |
LEVEL2 |
レベル 2。 |
LEVEL3 |
レベル 3 |
LEVEL4 |
レベル 4 |
LEVEL5 |
レベル 5 |
ProductBrand
商品のブランド。
JSON 表現 |
---|
{ "value": string } |
フィールド | |
---|---|
value |
商品ブランドの文字列値。 |
ProductChannel
商品の地域区分。
JSON 表現 |
---|
{
"channel": enum ( |
フィールド | |
---|---|
channel |
地域区分の値。 |
ListingGroupFilterProductChannel
商品の地域区分を記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ONLINE |
この商品はオンラインで販売されています。 |
LOCAL |
この商品は実店舗で販売されています。 |
ProductCondition
商品情報の状態。
JSON 表現 |
---|
{
"condition": enum ( |
フィールド | |
---|---|
condition |
条件の値。 |
ListingGroupFilterProductCondition
商品情報の状態を記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
NEW |
商品の状態が新品である。 |
REFURBISHED |
商品の状態は再生品です。 |
USED |
商品の状態が使用されます。 |
ProductCustomAttribute
商品のカスタム属性。
JSON 表現 |
---|
{
"index": enum ( |
フィールド | |
---|---|
index |
カスタム属性のインデックスを示します。 |
value |
商品のカスタム属性の文字列値。 |
ListingGroupFilterCustomAttributeIndex
顧客属性のインデックス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
INDEX0 |
最初のリスティング グループのフィルタのカスタム属性。 |
INDEX1 |
2 番目のリスティング グループのフィルタのカスタム属性。 |
INDEX2 |
3 番目のリスティング グループ フィルタのカスタム属性。 |
INDEX3 |
4 番目のリスティング グループ フィルタのカスタム属性。 |
INDEX4 |
5 番目のリスティング グループ フィルタのカスタム属性。 |
ProductItemId
商品の商品アイテム ID。
JSON 表現 |
---|
{ "value": string } |
フィールド | |
---|---|
value |
ID の値。 |
ProductType
商品情報のタイプ。
JSON 表現 |
---|
{
"level": enum ( |
フィールド | |
---|---|
level |
タイプのレベル。 |
value |
型の値。 |
ListingGroupFilterProductTypeLevel
商品情報のタイプのレベルを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
LEVEL1 |
レベル 1。 |
LEVEL2 |
レベル 2。 |
LEVEL3 |
レベル 3 |
LEVEL4 |
レベル 4 |
LEVEL5 |
レベル 5 |
ListingGroupFilterDimensionPath
リスティング グループのフィルタを定義する項目のパス。
JSON 表現 |
---|
{
"dimensions": [
{
object ( |
フィールド | |
---|---|
dimensions[] |
リスティング グループのフィルタ階層(ルートノードを除く)を通過するディメンションの、このリスティング グループ フィルタへの完全なパス。 |
AssetGroupTopCombinationView
広告グループの広告アセットの組み合わせの使用状況に関するビュー。
JSON 表現 |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
フィールド | |
---|---|
resourceName |
アセット グループの上位の組み合わせビューのリソース名。AssetGroup の上位の組み合わせビューのリソース名の形式は、"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}" です。 |
assetGroupTopCombinations[] |
同時に配信されたアセットの上位の組み合わせ。 |
AssetGroupAssetCombinationData
アセット グループのアセットの組み合わせデータ
JSON 表現 |
---|
{
"assetCombinationServedAssets": [
{
object ( |
フィールド | |
---|---|
assetCombinationServedAssets[] |
配信されたアセット。 |
AssetUsage
アセットの使用状況に関する情報が格納されています。
JSON 表現 |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
フィールド | |
---|---|
asset |
アセットのリソース名。 |
servedAssetFieldType |
アセットの配信フィールド タイプ。 |
ServedAssetFieldType
使用可能なアセット フィールドのタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
HEADLINE_1 |
アセットは広告見出し 1 で使用されています。 |
HEADLINE_2 |
アセットは広告見出し 2 で使用されています。 |
HEADLINE_3 |
アセットは広告見出し 3 で使用されています。 |
DESCRIPTION_1 |
アセットが説明文 1 で使用されている。 |
DESCRIPTION_2 |
アセットが説明文 2 で使用されている。 |
HEADLINE |
アセットが広告見出しで使用されています。広告見出しが 1 つしかない場合にのみ使用します。それ以外の場合は、HEADLINE_1、HEADLINE_2、または HEADLINE_3 の列挙型を使用します。 |
HEADLINE_IN_PORTRAIT |
このアセットは、縦向き画像の見出しとして使用されました。 |
LONG_HEADLINE |
アセットが長い広告見出し(MultiAsset レスポンシブ検索広告で使用)で使用されています。 |
DESCRIPTION |
アセットが説明で使用されました。広告内の説明文が 1 つしかない場合にのみ使用します。それ以外の場合は、DESCRIPTION_1 または DESCRIPTION_@ 列挙型を使用します。 |
DESCRIPTION_IN_PORTRAIT |
このアセットは、縦向き画像の説明として使われていました。 |
BUSINESS_NAME_IN_PORTRAIT |
このアセットは、縦向き画像のビジネス名として使用されていました。 |
BUSINESS_NAME |
アセットがビジネス名として使用されていた。 |
MARKETING_IMAGE |
アセットがマーケティング画像として使用されていた。 |
MARKETING_IMAGE_IN_PORTRAIT |
このアセットは、縦向き画像のマーケティング画像として使用されました。 |
SQUARE_MARKETING_IMAGE |
アセットはスクエアのマーケティング画像として使用されました。 |
PORTRAIT_MARKETING_IMAGE |
このアセットは、縦向きのマーケティング画像として使用されました。 |
LOGO |
アセットがロゴとして使用されていた。 |
LANDSCAPE_LOGO |
アセットが横長のロゴとして使用されていました。 |
CALL_TO_ACTION |
行動を促すフレーズとしてアセットが使用されていた。 |
YOU_TUBE_VIDEO |
アセットが YouTube 動画として使用されていた。 |
SITELINK |
このアセットはサイトリンクとして使用されています。 |
CALL |
このアセットは電話番号として使用されています。 |
MOBILE_APP |
このアセットはモバイルアプリとして使用されています。 |
CALLOUT |
このアセットはコールアウトとして使用されます。 |
STRUCTURED_SNIPPET |
このアセットは構造化スニペットとして使用されます。 |
PRICE |
このアセットは価格として使用されます。 |
PROMOTION |
このアセットはプロモーションとして使用されています。 |
AD_IMAGE |
このアセットは画像として使用されます。 |
LEAD_FORM |
アセットがリードフォームとして使用されます。 |
BUSINESS_LOGO |
アセットがビジネスのロゴとして使用されている。 |
AssetGroup
アセット グループAssetGroupAsset は、アセットをアセット グループにリンクするために使用されます。AssetGroupSignal は、シグナルをアセット グループに関連付けるために使用されます。
JSON 表現 |
---|
{ "resourceName": string, "id": string, "campaign": string, "name": string, "finalUrls": [ string ], "finalMobileUrls": [ string ], "status": enum ( |
フィールド | |
---|---|
resourceName |
アセット グループのリソース名。アセット グループのリソース名の形式は次のとおりです。
|
id |
アセット グループの ID |
campaign |
このアセット グループが関連付けられているキャンペーン。アセット グループにリンクされているアセット。 |
name |
必須。アセット グループの名前。必須。長さは 1 ~ 128 文字以内にする必要があります。キャンペーン内で一意である必要があります。 |
finalUrls[] |
すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。P-MAX では、オプトアウトしない限り、URL はデフォルトで拡張の対象となります。 |
finalMobileUrls[] |
すべてのクロスドメイン リダイレクト後のモバイルの最終ページ URL のリスト。P-MAX では、オプトアウトしない限り、URL はデフォルトで拡張の対象となります。 |
status |
アセット グループのステータス。 |
path1 |
広告に表示される URL に表示されるテキストの最初の部分です。 |
path2 |
広告に表示される URL に付加されて表示されるテキストの 2 番目の部分。このフィールドは、path1 が設定されている場合にのみ設定できます。 |
adStrength |
このアセット グループの全体的な広告の有効性。 |
AssetGroupStatus
アセット グループのステータスです。
列挙型 | |
---|---|
UNSPECIFIED |
ステータスが指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 |
ENABLED |
アセット グループは有効になっています。 |
PAUSED |
アセット グループは一時停止されています。 |
REMOVED |
アセット グループが削除されました。 |
AdStrength
広告の有効性を列挙する列挙型です。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
PENDING |
広告の有効性は現在「保留中」です。 |
NO_ADS |
広告を生成できませんでした。 |
POOR |
強度が足りません。 |
AVERAGE |
平均的な強度。 |
GOOD |
かなり強い。 |
EXCELLENT |
非常に強い。 |
AssetSetAsset
AssetSetAsset は、アセットとアセットセット間のリンクです。AssetSetAsset を追加すると、アセットとアセットセットがリンクされます。
JSON 表現 |
---|
{
"resourceName": string,
"assetSet": string,
"asset": string,
"status": enum ( |
フィールド | |
---|---|
resourceName |
アセットセットのアセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。
|
assetSet |
このアセットセットのアセットがリンクしているアセットセット。 |
asset |
このアセットセットのアセットがリンクしているアセット。 |
status |
アセットセットのアセットのステータス。読み取り専用です。 |
AssetSetAssetStatus
アセットセットのアセットのステータス。
列挙型 | |
---|---|
UNSPECIFIED |
ステータスが指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。これはレスポンス専用の値です。 |
ENABLED |
アセットセットのアセットが有効になっています。 |
REMOVED |
アセットセットのアセットが削除されました。 |
AssetSet
アセットのコレクションを表すアセットセット。AssetSetAsset を使用して、アセットをアセットセットにリンクします。
JSON 表現 |
---|
{ "id": string, "resourceName": string } |
フィールド | |
---|---|
id |
アセットセットの ID。 |
resourceName |
アセットセットのリソース名。アセットセットのリソース名の形式は次のとおりです。
|
BiddingStrategy
入札戦略。
JSON 表現 |
---|
{ "resourceName": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
入札戦略のリソース名。入札戦略のリソース名の形式は次のとおりです。
|
status |
入札戦略のステータス。 このフィールドは読み取り専用です。 |
type |
入札戦略のタイプ。入札スキームを設定して入札戦略を作成します。 このフィールドは読み取り専用です。 |
currencyCode |
入札戦略で使用される通貨(ISO 4217 の 3 文字のコード)。 クライアント センター(MCC)の顧客の入札戦略の場合、この通貨は作成時に設定でき、デフォルトは MCC 顧客の通貨になります。サービスを提供する顧客の場合は、このフィールドを設定できません。サービスを提供する顧客のすべての戦略で、サービス提供顧客の通貨が暗黙的に使用されます。いずれの場合も、effectiveCurrencyCode フィールドは戦略で使用される通貨を返します。 |
id |
入札戦略の ID。 |
name |
入札戦略の名前。アカウント内のすべての入札戦略は、それぞれ別の名前にする必要があります。 この文字列の長さは UTF-8 バイトで 1~255 の値にする必要があります(切り詰められます)。 |
effectiveCurrencyCode |
入札戦略で使用される通貨(ISO 4217 の 3 文字のコード)。 クライアント センター(MCC)顧客の入札戦略の場合、これは広告主が戦略の作成時に設定した通貨です。サービスを提供する顧客の場合、顧客の currencyCode になります。 入札戦略の指標は、この通貨でレポートされます。 このフィールドは読み取り専用です。 |
campaignCount |
この入札戦略が適用されているキャンペーンの数です。 このフィールドは読み取り専用です。 |
nonRemovedCampaignCount |
この入札戦略に適用された削除済み以外のキャンペーンの数。 このフィールドは読み取り専用です。 |
共用体フィールド 1 つのみ設定できます。 |
|
enhancedCpc |
コンバージョンにつながる可能性が高いクリックに対しては入札単価を引き上げ、可能性が低いクリックに対しては引き下げる入札戦略。 |
maximizeConversionValue |
予算を消化しながらキャンペーンのコンバージョン値を最大化するための自動入札戦略です。 |
maximizeConversions |
予算を消化しながらキャンペーンで最大限のコンバージョンを獲得するための自動入札戦略です。 |
targetCpa |
指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する入札戦略。 |
targetImpressionShare |
選択した割合のインプレッションを重視して自動的に最適化する入札戦略です。 |
targetOutrankShare |
特定の競合他社よりも上位に掲載する必要があるオークションの目標割合に基づいて入札単価を設定できる入札戦略。このフィールドのサポートは終了しています。このフィールドを使用して新しい入札戦略を作成したり、このフィールドを使用して入札戦略をキャンペーンに適用したりすることはできません。このスキームがすでに入力されている戦略への変更は可能です。 |
targetRoas |
特定の目標広告費用対効果(ROAS)を平均化しつつ、収益を最大化できる入札戦略。 |
targetSpend |
予算内でクリック数を最大限に獲得できるように入札単価を設定する入札戦略。 |
BiddingStrategyStatus
入札戦略のステータス。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
ENABLED |
入札戦略が有効になっています。 |
REMOVED |
入札戦略が削除されている。 |
BiddingStrategyType
利用可能な入札戦略タイプを説明する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
COMMISSION |
コミッションは自動入札戦略の一種で、広告主様はコンバージョン値の一定割合を支払う。 |
ENHANCED_CPC |
拡張クリック単価は、コンバージョンにつながる可能性が高いクリックに対しては入札単価を引き上げ、可能性が低いクリックに対しては引き下げる入札戦略です。 |
INVALID |
戻り値にのみ使用されます。キャンペーンに入札戦略が設定されていないことを示します。これにより、キャンペーンの広告が配信されなくなります。たとえば、マネージャーの入札戦略にキャンペーンを関連付けると、その後、広告配信中のアカウントと MCC アカウントとのリンクが解除されます。この場合、そのキャンペーンは、アクセス不可となっているマネージャーの入札戦略から自動的に接続解除され、無効な入札戦略タイプに移行します。 |
MANUAL_CPA |
広告主様が指定したアクションごとに入札単価を設定できる個別単価設定戦略です。 |
MANUAL_CPC |
クリックに基づく個別の入札単価。クリック 1 回ごとに支払います。 |
MANUAL_CPM |
インプレッション ベースの手動入札。ユーザーが 1,000 回のインプレッションごとに料金を支払います。 |
MANUAL_CPV |
動画の視聴ごとに設定可能な金額を支払う入札戦略です。 |
MAXIMIZE_CONVERSIONS |
1 日の予算内でコンバージョン数を自動的に最大化する入札戦略。 |
MAXIMIZE_CONVERSION_VALUE |
ご指定の予算を消化しつつ収益を最大化できるように入札単価を自動的に設定する自動入札戦略です。 |
PAGE_ONE_PROMOTED |
ページ 1 プロモート入札スキーム。上限クリック単価を設定して、google.com のページ 1 またはページ 1 のプロモート スロットのインプレッションをターゲットにします。この列挙値は非推奨となりました。 |
PERCENT_CPC |
クリック単価の割合は、商品やサービスの広告価格に対する割合を入札単価にする入札戦略です。 |
TARGET_CPA |
目標コンバージョン単価は、指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価を設定する自動入札戦略です。 |
TARGET_CPM |
目標インプレッション単価は、設定した目標インプレッション単価(CPM)でできるだけ多くのインプレッションを獲得できるように入札単価を設定する自動入札戦略です。 |
TARGET_IMPRESSION_SHARE |
一定の割合の検索広告が最初のページ(または他の対象地域)の上部に表示されるように入札単価を設定する自動入札戦略です。 |
TARGET_OUTRANK_SHARE |
目標優位表示シェアは自動入札戦略の一種であり、特定の競合他社よりも上位に表示すべきオークションの目標割合に基づいて入札単価を設定します。この列挙値は非推奨となりました。 |
TARGET_ROAS |
目標広告費用対効果(ROAS)は、特定の目標の平均広告費用対効果(ROAS)を平均化しつつ、収益を最大化するのに役立つ自動入札戦略です。 |
TARGET_SPEND |
目標予算は自動入札戦略の一種で、予算内でクリック数を最大化できるように入札単価が自動的に調整されます。 |
EnhancedCpc
この型にはフィールドがありません。
コンバージョンにつながる可能性が高いクリックに対しては入札単価を引き上げ、可能性が低いクリックに対しては引き下げる自動入札戦略。
この入札戦略はサポートが終了したため、作成できなくなりました。同等の機能のために、EnhancedCpcEnabled を true に設定した ManualCpc を使用します。
MaximizeConversionValue
予算を消化しながらキャンペーンのコンバージョン値を最大化するための自動入札戦略です。
JSON 表現 |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
フィールド | |
---|---|
cpcBidCeilingMicros |
入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。 |
cpcBidFloorMicros |
入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。 |
targetRoas |
目標広告費用対効果(LTV)オプション。設定した場合、入札戦略では目標広告費用対効果を平均化しながら、収益を最大化します。目標広告費用対効果が高い場合、入札戦略では予算全額を使用できない可能性があります。目標広告費用対効果が設定されていない場合、入札戦略では予算に対して可能な限り高い広告費用対効果を達成することを目指します。 |
MaximizeConversions
予算を消化しながらキャンペーンで最大限のコンバージョンを獲得するための自動入札戦略です。
JSON 表現 |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
フィールド | |
---|---|
cpcBidCeilingMicros |
入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。 |
cpcBidFloorMicros |
入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。 |
targetCpaMicros |
目標コンバージョン単価(CPA)オプション。指定したコンバージョン アクションあたりの平均費用として、入札戦略の通貨のマイクロ単位で指定します。設定すると、入札戦略は目標コンバージョン単価以下で最大限のコンバージョンを獲得します。目標コンバージョン単価が設定されていない場合は、予算内で可能な限り低いコンバージョン単価の達成を目指します。 |
TargetCpa
指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する自動入札戦略です。
JSON 表現 |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
フィールド | |
---|---|
targetCpaMicros |
平均 CPA の目標値。この目標は、アカウントの通貨に基づき、請求可能な最小単位以上である必要があります。 |
cpcBidCeilingMicros |
入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
cpcBidFloorMicros |
入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
TargetRoas
特定の目標広告費用対効果(ROAS)を平均化しつつ、収益を最大化できる自動入札戦略です。
JSON 表現 |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
フィールド | |
---|---|
targetRoas |
必須。費用単価の選択された収益(コンバージョン データに基づく)。値は 0.01~1000.0 の範囲で指定する必要があります。 |
cpcBidCeilingMicros |
入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
cpcBidFloorMicros |
入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。 |
TargetSpend
予算内でクリック数を最大化できるように入札単価を設定する自動入札戦略です。
JSON 表現 |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
フィールド | |
---|---|
targetSpendMicros |
クリック数を最大化するための目標予算。目標予算の入札者は、この値と、自然なスロットリング予算額のうち、少ない方の金額を支出しようとします。指定しない場合、予算が目標予算として使用されます。このフィールドは非推奨のため使用不可です。詳しくは、https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html をご覧ください。 |
cpcBidCeilingMicros |
入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。 |
CampaignBudget
キャンペーンの予算
JSON 表現 |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
フィールド | |
---|---|
resourceName |
キャンペーン予算のリソース名。キャンペーンの予算リソース名の形式は次のとおりです。
|
deliveryMethod |
キャンペーン予算が消費される割合を決定する配信方法。 作成オペレーションで指定しない場合のデフォルトは STANDARD です。 |
period |
予算を消化する期間。指定しない場合のデフォルトは DAILY です。 |
amountMicros |
アカウントに対する現地通貨での予算額。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。1 か月の費用の上限はこの金額の 30.4 倍です。 |
BudgetDeliveryMethod
予算の配分方法。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
STANDARD |
予算サーバーは、全期間を通じて均等に広告配信を調整します。 |
ACCELERATED |
予算サーバーによる広告配信が抑制されることはなく、広告はできるだけ早く配信されます。 |
BudgetPeriod
候補となる予算の期間。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
DAILY |
1 日の予算。 |
FIXED_DAILY |
1 日の予算は固定されており、 |
CUSTOM_PERIOD |
カスタム予算と total_amount を併用して、全期間の予算の上限を指定できます。 |
キャンペーン
キャンペーン。
JSON 表現 |
---|
{ "resourceName": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
キャンペーンのリソース名。キャンペーンのリソース名の形式は次のとおりです。
|
status |
キャンペーンのステータス。 新しいキャンペーンが追加されると、ステータスはデフォルトで有効に設定されます。 |
servingStatus |
キャンペーンの広告配信ステータス。 |
biddingStrategySystemStatus |
キャンペーンの入札戦略のシステム ステータスです。 |
adServingOptimizationStatus |
キャンペーンの広告配信の最適化ステータス。 |
advertisingChannelType |
キャンペーン内の広告のメインの配信ターゲット。ターゲティング オプションは 新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。 キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。 |
advertisingChannelSubType |
キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。 |
urlCustomParameters[] |
|
realTimeBiddingSetting |
リアルタイム ビッダー(Ad Exchange ネットワークをターゲットとするキャンペーンのみ)の設定。 |
networkSettings |
キャンペーンの掲載ネットワークの設定です。 |
dynamicSearchAdsSetting |
動的検索広告(DSA)を管理するための設定。 |
shoppingSetting |
ショッピング キャンペーンを管理するための設定です。 |
geoTargetTypeSetting |
広告の地域ターゲティングの設定。 |
labels[] |
このキャンペーンに適用されたラベルのリソース名。 |
biddingStrategyType |
入札戦略のタイプ。 入札戦略を作成するには、標準入札戦略を作成する入札スキームを設定するか、ポートフォリオ入札戦略を作成する [ このフィールドは読み取り専用です。 |
accessibleBiddingStrategy |
AccessibleBiddingStrategy のリソース名。「biddingStrategy」によって特定された、適用されたポートフォリオ入札戦略の無制限の属性の読み取り専用ビューです。キャンペーンでポートフォリオ戦略を使用していない場合は、空になります。入札戦略の属性は、その戦略を共有しているすべてのお客様が使用でき、AccessibleBiddingStrategy リソースから読み取られます。一方、制限付きの属性は、戦略の所有者とそのマネージャーだけが使用できます。制限付き属性は、 BiddingStrategy リソースからのみ読み取ることができます。 |
frequencyCaps[] |
このキャンペーンの広告が各ユーザーに表示される頻度を制限するリスト。 |
selectiveOptimization |
このキャンペーンの一部の最適化設定です。このキャンペーンの最適化で重視するコンバージョン アクションが含まれています。この機能は、 AdvertisingChannelType として MULTI_CHANNEL を使用し、 AdvertisingChannelSubType として APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用しているアプリ キャンペーンにのみ適用されます。 |
optimizationGoalSetting |
このキャンペーンの最適化目標の設定です。最適化の目標タイプのセットが含まれています。 |
trackingSetting |
キャンペーン単位のトラッキング情報の設定。 |
engineId |
外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます(Yahoo! Japan、Microsoft、Baidu など)。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。 |
excludedParentAssetFieldTypes[] |
このキャンペーンから除外するアセット フィールドのタイプです。これらのフィールド タイプのアセットリンクは、このキャンペーンの上位レベルから継承されません。 |
createTime |
このキャンペーンが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。createTime は v1 で非推奨になります。代わりに creationTime を使用してください。 |
creationTime |
このキャンペーンが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
lastModifiedTime |
このキャンペーンが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
id |
キャンペーンの ID。 |
name |
キャンペーンの名前です。 新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。 null(コードポイント 0x0)、NL ラインフィード(コードポイント 0xA)、改行(コードポイント 0xD)の文字を含めることはできません。 |
trackingUrlTemplate |
トラッキング URL を作成するための URL テンプレート。 |
campaignBudget |
キャンペーンの予算 |
startDate |
お客様のタイムゾーンでキャンペーンが配信を開始した日付(YYYY-MM-DD 形式)。 |
endDate |
ユーザーのタイムゾーンで配信されるキャンペーンの最終日(YYYY-MM-DD 形式)。作成時にはデフォルトで 2037-12-30 に設定され、キャンペーンは無期限に実行されます。既存のキャンペーンを無期限で行うように設定するには、このフィールドを 2037-12-30 に設定します。 |
finalUrlSuffix |
並行トラッキングで配信されるランディング ページにクエリ パラメータを追加するために使用される接尾辞。 |
urlExpansionOptOut |
よりターゲットを絞った URL への URL の拡張をオプトアウトすることを表します。オプトアウト(true)の場合、アセット グループの最終ページ URL、または広告主の Google Merchant Center またはビジネスデータ フィードで指定された URL のみがターゲティングされます。オプトイン(false)の場合、ドメイン全体がターゲティングされます。このフィールドを設定できるのは P-MAX キャンペーンのみで、デフォルト値は false です。 |
共用体フィールド ポートフォリオ(入札戦略サービスを通じて作成)または標準のいずれかで、キャンペーンに埋め込まれている必要があります。 |
|
biddingStrategy |
キャンペーンで使用されるポートフォリオ入札戦略。 |
manualCpa |
標準の「個別コンバージョン単価」入札戦略を使用します。広告主様が指定したアクションごとに入札単価を設定できる個別単価設定戦略です。ローカル サービス キャンペーンでのみ使用できます。 |
manualCpc |
標準の個別クリック単価入札戦略。クリックベースの個別単価設定(クリック課金型)。 |
manualCpm |
標準の個別インプレッション単価入札戦略です。インプレッション ベースの手動入札。ユーザーが 1,000 回のインプレッションごとに料金を支払います。 |
maximizeConversions |
ご指定の予算を消化しつつコンバージョン数を自動的に最大化する、標準の「コンバージョン数の最大化」入札戦略です。 |
maximizeConversionValue |
ご指定の予算を消化しつつ収益を最大化できるよう、入札単価を自動的に設定する、標準の「コンバージョン値の最大化」入札戦略 |
targetCpa |
標準の「目標コンバージョン単価」入札戦略です。設定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が自動的に設定されます。 |
targetImpressionShare |
目標インプレッション シェア入札戦略自動入札戦略の 1 つで、指定した割合のインプレッションを達成できるように入札単価を設定します。 |
targetRoas |
特定の目標広告費用対効果(ROAS)を平均化しつつ、収益を自動的に最大化する標準の「目標広告費用対効果」入札戦略。 |
targetSpend |
標準の目標予算入札戦略です。予算内でクリック数を最大限に獲得できるように入札単価が自動的に調整されます。 |
percentCpc |
商品やサービスの広告価格に対する割合を入札単価とする標準のクリック単価入札戦略です。 |
targetCpm |
インプレッション単価を自動的に最適化する入札戦略です。 |
CampaignStatus
キャンペーンのステータス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ENABLED |
キャンペーンは有効で、広告を表示できます。 |
PAUSED |
キャンペーンはユーザーによって一時停止されました。 |
REMOVED |
キャンペーンが削除されました。 |
CampaignServingStatus
キャンペーンの配信ステータスとして考えられるもの。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
SERVING |
配信中。 |
NONE |
なし。 |
ENDED |
終了。 |
PENDING |
Pending. |
SUSPENDED |
停止中。 |
BiddingStrategySystemStatus
入札戦略のシステム ステータスとして考えられるもの。
列挙型 | |
---|---|
UNSPECIFIED |
入札戦略のタイプが見つからなかった、ステータス情報が見つからないなど、予期しないエラーが発生したことを表します。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ENABLED |
この入札戦略は有効になっており、特に問題も見つかっていません。 |
LEARNING_NEW |
この入札戦略は最近作成されたか最近再度有効にされたため、学習中です。 |
LEARNING_SETTING_CHANGE |
最近設定が変更されたため、この入札戦略は学習中です。 |
LEARNING_BUDGET_CHANGE |
最近予算が変更されたため、この入札戦略は学習中です。 |
LEARNING_COMPOSITION_CHANGE |
この入札戦略が適用されているキャンペーン、広告グループ、またはキーワードの数が最近変更されたため、この入札戦略は学習中です。 |
LEARNING_CONVERSION_TYPE_CHANGE |
入札戦略は、コンバージョン レポートと、入札戦略に関係していたコンバージョンの種類をユーザーが最近変更したかどうかによって決まります。 |
LEARNING_CONVERSION_SETTING_CHANGE |
入札戦略がコンバージョン レポートを使用していて、顧客が最近コンバージョン設定を変更した。 |
LIMITED_BY_CPC_BID_CEILING |
この入札戦略は入札単価の上限によって制限されています。 |
LIMITED_BY_CPC_BID_FLOOR |
この入札戦略は入札単価の下限によって制限されています。 |
LIMITED_BY_DATA |
過去数週間に十分なコンバージョン トラフィックがなかったため、この入札戦略は制限されています。 |
LIMITED_BY_BUDGET |
この入札戦略では、かなりの割合のキーワードが予算による制限を受けています。 |
LIMITED_BY_LOW_PRIORITY_SPEND |
費用の優先度が下がっているため、この入札戦略は目標予算を達成できません。 |
LIMITED_BY_LOW_QUALITY |
この入札戦略では、かなりの割合のキーワードで品質スコアが低下しています。 |
LIMITED_BY_INVENTORY |
ターゲティングの範囲が狭いため、入札戦略で予算を使い切ることができません。 |
MISCONFIGURED_ZERO_ELIGIBILITY |
コンバージョン トラッキングが設定されていない(ping がない)か、スマート ショッピング キャンペーンでリマーケティング リストが設定されている。 |
MISCONFIGURED_CONVERSION_TYPES |
入札戦略がコンバージョン レポートを使用していて、この戦略でレポートされる可能性のあるコンバージョンの種類が顧客にはない場合。 |
MISCONFIGURED_CONVERSION_SETTINGS |
入札戦略がコンバージョン レポートに基づいていて、顧客のコンバージョン設定が誤っている。 |
MISCONFIGURED_SHARED_BUDGET |
入札戦略に含まれないキャンペーンが、戦略に含まれるキャンペーンと予算を共有している。 |
MISCONFIGURED_STRATEGY_TYPE |
キャンペーンの入札戦略タイプが無効で、配信されていません。 |
PAUSED |
この入札戦略は有効になっていません。この入札戦略が適用されている有効なキャンペーン、広告グループ、キーワードがない。または、入札戦略に有効な予算が関連付けられていません。 |
UNAVAILABLE |
現在、この入札戦略はステータス レポートに対応していません。 |
MULTIPLE_LEARNING |
お問い合わせの期間中、この入札戦略に複数のシステム ステータス LEARNING_* が発生しました。 |
MULTIPLE_LIMITED |
お問い合わせの期間中、この入札戦略に複数のシステム ステータス LIMITED_* がありました。 |
MULTIPLE_MISCONFIGURED |
お問い合わせの期間中、この入札戦略に複数のシステム ステータス MISCONFIGURED_* が発生しました。 |
MULTIPLE |
お問い合わせの期間中、この入札戦略には複数のシステム ステータスがありました。 |
AdServingOptimizationStatus
配信ステータスを表す列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
OPTIMIZE |
広告配信は、キャンペーンのクリック率に基づいて最適化されます。 |
CONVERSION_OPTIMIZE |
広告配信は、キャンペーンのクリック率 × コンバージョン数に基づいて最適化されます。キャンペーンがコンバージョン オプティマイザーの入札戦略に使用されていない場合、デフォルトで「OPTIMIZED」が使用されます。 |
ROTATE |
広告は 90 日間均等にローテーションされた後、クリック重視で最適化されます。 |
ROTATE_INDEFINITELY |
成果の低い広告をより均等に表示し、最適化は行いません。 |
UNAVAILABLE |
広告配信の最適化ステータスを表示できません。 |
AdvertisingChannelType
さまざまな広告チャネルのタイプを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
SEARCH |
検索ネットワークこれには、ディスプレイ ネットワーク向けキャンペーンと検索+ キャンペーンが含まれます。 |
DISPLAY |
Google ディスプレイ ネットワークのみ。 |
SHOPPING |
ショッピング キャンペーンは、ショッピング 宿泊施設と google.com の検索結果に表示されます。 |
HOTEL |
ホテル広告キャンペーン |
VIDEO |
動画キャンペーン。 |
MULTI_CHANNEL |
アプリ キャンペーンとアプリ エンゲージメント キャンペーン(複数のチャネルで実施) |
LOCAL |
ローカル広告キャンペーン |
SMART |
スマート アシスト キャンペーン |
PERFORMANCE_MAX |
おすすめします |
LOCAL_SERVICES |
ローカル サービス キャンペーン。 |
DISCOVERY |
ファインド キャンペーン。 |
TRAVEL |
旅行キャンペーン |
AdvertisingChannelSubType
さまざまなチャネルのサブタイプを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値としてのみ使用します。このバージョンで不明な値を表します。 |
SEARCH_MOBILE_APP |
検索キャンペーンのモバイルアプリ キャンペーン。 |
DISPLAY_MOBILE_APP |
ディスプレイ ネットワーク向けモバイルアプリ キャンペーン |
SEARCH_EXPRESS |
検索向け AdWords Express キャンペーン。 |
DISPLAY_EXPRESS |
ディスプレイ広告用の AdWords Express キャンペーン |
SHOPPING_SMART_ADS |
スマートショッピングキャンペーン |
DISPLAY_GMAIL_AD |
Gmail 広告キャンペーン |
DISPLAY_SMART_CAMPAIGN |
スマート ディスプレイ キャンペーン: このサブタイプの新しいキャンペーンは作成できません。 |
VIDEO_OUTSTREAM |
動画アウトストリーム キャンペーン |
VIDEO_ACTION |
動画 TrueView アクション キャンペーン。 |
VIDEO_NON_SKIPPABLE |
スキップ不可の動画広告を含む動画キャンペーン。 |
APP_CAMPAIGN |
アプリ キャンペーンを使用すると、Google 検索、Google Play、YouTube、Google ディスプレイ ネットワークなど、Google の主要なプロパティで Android アプリまたは iOS アプリを簡単に宣伝できます。 |
APP_CAMPAIGN_FOR_ENGAGEMENT |
検索、YouTube、Google ディスプレイ ネットワークなど、Google の主要な複数のサービスでアプリのリエンゲージメントを促進することに重点を置いたアプリ エンゲージメント キャンペーン。 |
LOCAL_CAMPAIGN |
ローカル広告に特化したキャンペーン。 |
SHOPPING_COMPARISON_LISTING_ADS |
ショッピング比較キャンペーン。 |
SMART_CAMPAIGN |
標準のスマート アシスト キャンペーン。 |
VIDEO_SEQUENCE |
シーケンス動画広告を含む動画キャンペーン。 |
APP_CAMPAIGN_FOR_PRE_REGISTRATION |
Google Play、YouTube、ディスプレイ ネットワークの複数の広告チャネルをターゲットとする、モバイルアプリの事前登録に特化したアプリ事前登録キャンペーンです。 |
VIDEO_REACH_TARGET_FREQUENCY |
フリークエンシー目標入札戦略を使用した動画リーチ キャンペーン。 |
TRAVEL_ACTIVITIES |
旅行活動キャンペーン |
CustomParameter
trackingUrlTemplate
、finalUrls
、mobile_final_urls
のカスタム パラメータ タグで使用できるマッピング。
JSON 表現 |
---|
{ "key": string, "value": string } |
フィールド | |
---|---|
key |
パラメータタグ名と一致するキー。 |
value |
置換される値。 |
RealTimeBiddingSetting
リアルタイム ビッダー(Ad Exchange ネットワークをターゲットとするキャンペーンのみ)の設定。
JSON 表現 |
---|
{ "optIn": boolean } |
フィールド | |
---|---|
optIn |
キャンペーンでリアルタイム ビッダーが有効になっているかどうか。 |
NetworkSettings
キャンペーンの掲載ネットワークの設定です。
JSON 表現 |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
フィールド | |
---|---|
targetGoogleSearch |
google.com の検索結果に広告を掲載するかどうか。 |
targetSearchNetwork |
Google 検索ネットワークのパートナー サイトに広告を配信するかどうか( |
targetContentNetwork |
Google ディスプレイ ネットワークの指定したプレースメントに広告を配信するかどうか。プレースメントは、プレースメント条件で指定します。 |
targetPartnerSearchNetwork |
Google パートナー ネットワークで広告を配信するかどうか。この機能は、一部の Google パートナー アカウントでのみご利用いただけます。 |
DynamicSearchAdsSetting
動的検索広告(DSA)を管理するための設定。
JSON 表現 |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
フィールド | |
---|---|
domainName |
必須。この設定が表すインターネット ドメイン名(「google.com」や「www.google.com」など)。 |
languageCode |
必須。ドメインの言語を指定する言語コード(例: en)。 |
useSuppliedUrlsOnly |
キャンペーンで、広告主指定の URL のみを使用しているかどうか。 |
ShoppingSetting
ショッピング キャンペーンの設定。キャンペーンで宣伝できる商品の範囲と、このキャンペーンと他のショッピング キャンペーンとの相互作用を定義します。
JSON 表現 |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
フィールド | |
---|---|
feedLabel |
キャンペーンに含める商品のフィードラベル。設定できるのは feedLabel または salesCountry のみです。salesCountry の代わりに使用する場合は、feedLabel フィールドにも同じ形式の国コード(例: 「XX」)を指定できます。それ以外の場合は、Google Merchant Center でフィードラベルに使用される文字列を指定できます。 |
useVehicleInventory |
車両リスティング広告枠をターゲットとするかどうか。 |
merchantId |
Merchant Center アカウントの ID。このフィールドは、作成オペレーションでは必須です。ショッピング キャンペーンの場合、このフィールドは変更できません。 |
salesCountry |
キャンペーンに含める商品の販売国。 |
campaignPriority |
キャンペーンの優先順位。優先度の数値が高いキャンペーンは、優先度の低いキャンペーンよりも優先されます。このフィールドはショッピング キャンペーンで必須で、値は 0 ~ 2 です。スマート ショッピング キャンペーンの場合、このフィールドは省略可能ですが、設定する場合は 3 にする必要があります。 |
enableLocal |
ローカル商品を含めるかどうか。 |
GeoTargetTypeSetting
広告の地域ターゲティングに関連する設定のコレクションを表します。
JSON 表現 |
---|
{ "positiveGeoTargetType": enum ( |
フィールド | |
---|---|
positiveGeoTargetType |
このキャンペーンで非除外地域ターゲティングに使用される設定です。 |
negativeGeoTargetType |
このキャンペーンの除外地域ターゲティングに使用される設定です。 |
PositiveGeoTargetType
指定可能な地域ターゲティングのタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
このバージョンでは値が不明です。 |
PRESENCE_OR_INTEREST |
ユーザーが広告主の対象地域にいるか、その地域に関心を示した場合に、広告が表示されることを指定します。 |
SEARCH_INTEREST |
ユーザーが広告主の対象地域を検索した場合に、広告が表示されることを指定します。検索キャンペーンと通常のショッピング キャンペーンでのみ使用できます。 |
PRESENCE |
ユーザーが広告主の対象地域にいるか、定期的に訪れている場合に、広告が表示されることを指定します。 |
NegativeGeoTargetType
除外対象地域のタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
このバージョンでは値が不明です。 |
PRESENCE_OR_INTEREST |
広告主の除外地域にいるユーザー、または広告主の除外地域に関心を示しているユーザーを除外します。 |
PRESENCE |
広告主の除外地域にいるユーザーに対して広告を表示しないよう指定します。 |
FrequencyCapEntry
この型にはフィールドがありません。
特定の期間内に 1 つの広告(または一部の広告)を 1 つのユーザーに表示できる最大回数を指定するルールです。
SelectiveOptimization
このキャンペーンの一部の最適化設定です。このキャンペーンの最適化で重視するコンバージョン アクションが含まれています。この機能は、 AdvertisingChannelType として MULTI_CHANNEL を使用し、 AdvertisingChannelSubType として APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用しているアプリ キャンペーンにのみ適用されます。
JSON 表現 |
---|
{ "conversionActions": [ string ] } |
フィールド | |
---|---|
conversionActions[] |
このキャンペーンの最適化のために選択したコンバージョン アクションのセット。 |
OptimizationGoalSetting
このキャンペーンの最適化目標の設定です。最適化の目標タイプのセットが含まれています。
JSON 表現 |
---|
{
"optimizationGoalTypes": [
enum ( |
フィールド | |
---|---|
optimizationGoalTypes[] |
最適化の目標タイプのリスト。 |
OptimizationGoalType
最適化の目標のタイプ
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値としてのみ使用します。このバージョンで不明な値を表します。 |
CALL_CLICKS |
通話クリック重視で最適化します。通話クリック コンバージョンとは、広告を見たユーザーが店舗に電話するために [電話] を選択した回数です。 |
DRIVING_DIRECTIONS |
運転ルート向けに最適化します。運転ルート コンバージョンとは、ユーザーが広告を見た後に [ルートを検索] を選択して来店した回数です。 |
APP_PRE_REGISTRATION |
事前登録を重視して最適化する。事前登録コンバージョンとは、アプリがリリースされたときに通知を受け取る事前登録の件数です。 |
TrackingSetting
キャンペーン単位のトラッキング情報の設定。
JSON 表現 |
---|
{ "trackingUrl": string } |
フィールド | |
---|---|
trackingUrl |
動的トラッキングに使用される URL。 |
ManualCpa
この型にはフィールドがありません。
広告主様が指定したアクションごとに入札単価を設定できる個別単価設定戦略です。
ManualCpc
クリックベースの個別単価設定(クリック課金型)。
JSON 表現 |
---|
{ "enhancedCpcEnabled": boolean } |
フィールド | |
---|---|
enhancedCpcEnabled |
コンバージョン オプティマイザーのデータに基づいて入札単価を拡張するかどうか。 |
ManualCpm
この型にはフィールドがありません。
インプレッション ベースの手動入札。ユーザーが 1,000 回のインプレッションごとに料金を支払います。
PercentCpc
商品やサービスの広告価格に対して、わずかな金額で入札する入札戦略。
JSON 表現 |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
フィールド | |
---|---|
cpcBidCeilingMicros |
入札戦略で設定可能な入札単価の上限。これは広告主が入力するオプションのフィールドで、ローカルのマイクロ秒単位で指定します。注: 値が 0 の場合は、bid_latency が未定義の場合と同様に解釈されます。 |
enhancedCpcEnabled |
コンバージョンにつながる可能性に応じて、オークションごとに入札単価を調整します。個々の入札単価は cpcBidCeilingMicros を上回る場合がありますが、キャンペーンの平均入札単価が上回らないようにしてください。 |
TargetCpm
この型にはフィールドがありません。
目標インプレッション単価(目標インプレッション単価)は自動入札戦略の一種で、設定した目標インプレッション単価に基づいてパフォーマンスが最適化されるように入札単価が設定されます。
CampaignAsset
キャンペーンとアセット間のリンク。
JSON 表現 |
---|
{
"resourceName": string,
"status": enum ( |
フィールド | |
---|---|
resourceName |
キャンペーン アセットのリソース名。CampaignAsset リソース名の形式は次のとおりです。
|
status |
キャンペーン アセットのステータスです。 |
campaign |
アセットがリンクされているキャンペーン。 |
asset |
キャンペーンにリンクされているアセット。 |
CampaignAssetSet
CampaignAssetSet は、キャンペーンとアセットセット間のリンクです。CampaignAssetSet を追加すると、アセットセットとキャンペーンがリンクされます。
JSON 表現 |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
フィールド | |
---|---|
resourceName |
キャンペーンのアセットセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。
|
campaign |
このアセットセットがリンクされているキャンペーン。 |
assetSet |
キャンペーンにリンクされているアセットセット。 |
status |
キャンペーンのアセットセットのアセットのステータス。読み取り専用です。 |
CampaignAudienceView
キャンペーンのオーディエンス ビュー。ディスプレイ ネットワーク広告と YouTube ネットワーク広告向けのインタレスト カテゴリとリマーケティング リスト、検索広告向けリマーケティング リスト(RLSA)に関する掲載結果データ(キャンペーンとオーディエンスの条件別に集計)が含まれます。このビューには、キャンペーン単位で設定されたオーディエンスのみが含まれます。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
キャンペーンのオーディエンス ビューのリソース名。キャンペーンのオーディエンス ビューのリソース名の形式は次のとおりです。
|
CampaignCriterion
キャンペーンの条件。
JSON 表現 |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
フィールド | |
---|---|
resourceName |
キャンペーンの条件のリソース名。キャンペーンの条件のリソース名の形式は次のとおりです。
|
displayName |
条件の表示名。 このフィールドはミューテーションの場合は無視されます。 |
type |
条件のタイプ。 |
status |
条件のステータス。 |
lastModifiedTime |
このキャンペーン条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
criterionId |
条件の ID。 このフィールドは、変更時は無視されます。 |
bidModifier |
条件が一致した場合の入札の修飾子。修飾子は 0.1 ~ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。デバイスタイプをオプトアウトするには、0 を使用します。 |
negative |
条件をターゲットに設定するか( |
共用体フィールド 1 つのみ設定する必要があります。 |
|
keyword |
キーワード。 |
location |
位置情報] をタップします。 |
device |
デバイス] など)を選択します。 |
ageRange |
年齢層。 |
gender |
性別。 |
userList |
ユーザーリスト。 |
language |
学びました。 |
webpage |
ウェブページ。 |
locationGroup |
地域グループ |
CampaignCriterionStatus
CampaignCriterion のステータス。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
ENABLED |
キャンペーンの条件は有効になっています。 |
PAUSED |
キャンペーンの条件は一時停止されています。 |
REMOVED |
キャンペーンの条件は削除されます。 |
LanguageInfo
言語の条件。
JSON 表現 |
---|
{ "languageConstant": string } |
フィールド | |
---|---|
languageConstant |
言語定数のリソース名。 |
LocationGroupInfo
フィードで指定された場所のリストを中心とした半径です。
JSON 表現 |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
フィールド | |
---|---|
geoTargetConstants[] |
フィード内の地域の範囲を制限する地域ターゲティングの定数。現在、使用できる地域ターゲティングの定数は 1 つのみです。 |
radiusUnits |
半径の単位。地域ターゲティングの定数では、マイルとメートルがサポートされています。フィード アイテム セットではミリマイルとメートルがサポートされています。これは必須であり、CREATE オペレーションで設定する必要があります。 |
feedItemSets[] |
FeedItems がターゲットとする FeedItemSet。複数の ID を指定すると、少なくとも 1 つのセットに出現するすべての項目がターゲティングされます。このフィールドは geoTargetConstants では使用できません。これはオプションであり、CREATE オペレーションでのみ設定できます。 |
radius |
対象地域を中心とした半径を指定する単位での距離です。これは必須であり、CREATE オペレーションで設定する必要があります。 |
LocationGroupRadiusUnits
地域グループ内の半径の距離の単位(例: MILES)
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
METERS |
メートル |
MILES |
マイル |
MILLI_MILES |
ミリマイル |
CampaignLabel
キャンペーンとラベルの関係を表します。
JSON 表現 |
---|
{ "resourceName": string, "campaign": string, "label": string } |
フィールド | |
---|---|
resourceName |
リソースの名前。キャンペーン ラベルのリソース名の形式は |
campaign |
ラベルが添付されるキャンペーン。 |
label |
キャンペーンに割り当てられるラベル。 |
CartDataSalesView
カートデータのセールスビュー。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
カートデータの販売ビューのリソース名。カートデータの販売ビューのリソース名の形式は |
対象読者
オーディエンスは効果的なターゲティング オプションです。詳しいユーザー属性やアフィニティなどのさまざまなセグメント属性を組み合わせて、ターゲット セグメントの各セクションを表すオーディエンスを作成できます。
JSON 表現 |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
フィールド | |
---|---|
resourceName |
オーディエンスのリソース名。オーディエンス名の形式は次のとおりです。
|
id |
オーディエンスの ID。 |
name |
必須。オーディエンスの名前。すべてのオーディエンスで一意である必要があります。長さは 1 ~ 255 にする必要があります。 |
description |
このオーディエンスの説明。 |
ConversionAction
コンバージョン アクション。
JSON 表現 |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
コンバージョン アクションのリソース名。コンバージョン アクションのリソース名の形式は次のとおりです。
|
creationTime |
Floodlight アクティビティの作成時点のタイムスタンプ(ISO 8601 形式)。 |
status |
コンバージョン イベントの発生に関するこのコンバージョン アクションのステータス。 |
type |
このコンバージョン アクションのタイプ。 |
category |
このコンバージョン アクションについてレポートされたコンバージョンのカテゴリです。 |
valueSettings |
このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関連する設定。 |
attributionModelSettings |
このコンバージョン アクションのアトリビューション モデルに関連する設定です。 |
floodlightSettings |
Floodlight コンバージョン タイプの Floodlight 設定。 |
id |
コンバージョン アクションの ID。 |
name |
コンバージョン アクションの名前。 新しいコンバージョン アクションを作成する場合は、このフィールドは必須です。空にすることはできません。 |
primaryForGoal |
コンバージョン アクションの primaryForGoal ビットが false の場合、そのコンバージョン アクションは、顧客のコンバージョン目標やキャンペーンのコンバージョン目標に関係なく、すべてのキャンペーンで入札不可になります。ただし、カスタム コンバージョン目標では primaryForGoal が考慮されないため、キャンペーンのカスタム コンバージョン目標で「primaryForGoal = false」のコンバージョン アクションが設定されていても、そのコンバージョン アクションは入札対象です。設定されていない場合、デフォルトで primaryForGoal は true になります。V9 では、primaryForGoal がオプションとして宣言されていないため、「update」オペレーションで作成された場合のみ false に設定できます。 |
ownerCustomer |
コンバージョン アクションの所有者の顧客のリソース名。システム定義のコンバージョン アクションの場合は null。 |
includeInClientAccountConversionsMetric |
このコンバージョン アクションを「clientAccountConversion」指標に含めるかどうか。 |
includeInConversionsMetric |
このコンバージョン アクションを「コンバージョン」指標に含めるかどうか。 |
clickThroughLookbackWindowDays |
インタラクション(クリックなど)からコンバージョン イベントまでの最大日数。 |
appId |
アプリ コンバージョン アクションのアプリ ID。 |
ConversionActionStatus
コンバージョン アクションのステータス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ENABLED |
コンバージョンが記録されます。 |
REMOVED |
コンバージョンは記録されません。 |
HIDDEN |
コンバージョンは記録されず、コンバージョン アクションは管理画面に表示されません。 |
ConversionActionType
コンバージョン アクションの種類。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
AD_CALL |
ユーザーが広告の電話番号表示オプションをクリックすると発生するコンバージョン。 |
CLICK_TO_CALL |
モバイル デバイスのユーザーが電話番号をクリックしたときに発生するコンバージョン。 |
GOOGLE_PLAY_DOWNLOAD |
ユーザーが Google Play ストアからモバイルアプリをダウンロードしたときに発生するコンバージョン。 |
GOOGLE_PLAY_IN_APP_PURCHASE |
ユーザーが Android の請求を通じてアプリ内で購入を行うと発生するコンバージョン。 |
UPLOAD_CALLS |
広告主様がトラッキングし、アップロードした通話コンバージョンです。 |
UPLOAD_CLICKS |
広告主によってトラッキングされ、貢献度が割り当てられたクリックとともにアップロードされたコンバージョン。 |
WEBPAGE |
ウェブページで発生するコンバージョン。 |
WEBSITE_CALL |
広告主のウェブサイトから動的に生成された電話番号にユーザーが電話をかけたときに発生するコンバージョン。 |
STORE_SALES_DIRECT_UPLOAD |
自社またはサードパーティの販売者データのアップロードに基づく店舗販売コンバージョン。店舗での販売の直接アップロードのタイプを使用できるのは、許可リストに登録されているお客様のみです。 |
STORE_SALES |
自社またはサードパーティの販売者データのアップロードや、決済ネットワークのカードを使用した実店舗での購入に基づく店舗販売コンバージョン。店舗販売のタイプを使用できるのは、許可リストに登録されているお客様のみです。読み取り専用。 |
FIREBASE_ANDROID_FIRST_OPEN |
Firebase でトラッキングされた Android アプリの初回起動コンバージョン。 |
FIREBASE_ANDROID_IN_APP_PURCHASE |
Firebase でトラッキングされた Android アプリのアプリ内購入コンバージョン。 |
FIREBASE_ANDROID_CUSTOM |
Firebase でトラッキングされた Android アプリのカスタム コンバージョン。 |
FIREBASE_IOS_FIRST_OPEN |
Firebase でトラッキングされた iOS アプリの初回起動コンバージョン。 |
FIREBASE_IOS_IN_APP_PURCHASE |
Firebase でトラッキングされた iOS アプリのアプリ内購入コンバージョン。 |
FIREBASE_IOS_CUSTOM |
Firebase でトラッキングされた iOS アプリのカスタム コンバージョン。 |
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN |
第三者のアプリ分析でトラッキングされた Android アプリの初回起動コンバージョン。 |
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
第三者のアプリ分析でトラッキングされた Android アプリ内の購入コンバージョン。 |
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM |
第三者のアプリ分析でトラッキングされた Android アプリのカスタム コンバージョン。 |
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN |
第三者のアプリ分析でトラッキングされた iOS アプリの初回起動コンバージョン。 |
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
第三者のアプリ分析でトラッキングされた iOS アプリ内の購入コンバージョン。 |
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM |
第三者のアプリ分析でトラッキングされた iOS アプリのカスタム コンバージョン。 |
ANDROID_APP_PRE_REGISTRATION |
ユーザーが Google Play ストアからモバイルアプリを事前登録したときに発生するコンバージョン。読み取り専用。 |
ANDROID_INSTALLS_ALL_OTHER_APPS |
アプリ固有のタイプでトラッキングされていない、すべての Google Play ダウンロードをトラッキングしているコンバージョン。読み取り専用。 |
FLOODLIGHT_ACTION |
ユーザーが広告主の広告を表示またはクリックした後に特定のウェブページを訪問した回数をカウントする Floodlight アクティビティ。読み取り専用。 |
FLOODLIGHT_TRANSACTION |
販売が成立した回数または購入されたアイテムの数をトラッキングする Floodlight アクティビティ。個々の販売の合計金額も取得できます。読み取り専用。 |
GOOGLE_HOSTED |
広告と接点を持った後に Google の商品やサービスに由来するローカル アクションをトラッキングしたコンバージョンです。読み取り専用。 |
LEAD_FORM_SUBMIT |
ユーザーがリードフォームを送信したときにレポートされるコンバージョン。読み取り専用。 |
SALESFORCE |
Salesforce で発生したコンバージョン。読み取り専用。 |
SEARCH_ADS_360 |
検索広告 360 の Floodlight データからインポートされたコンバージョン。読み取り専用。 |
SMART_CAMPAIGN_AD_CLICKS_TO_CALL |
スマート アシスト キャンペーンのカスタム条件を使用して、コール トラッキングを設定せずにスマート アシスト キャンペーン広告で発生した通話コンバージョンです。読み取り専用。 |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL |
ユーザーが Google マップ内の通話要素をクリックします。スマート アシスト キャンペーンのみ読み取り専用。 |
SMART_CAMPAIGN_MAP_DIRECTIONS |
ユーザーが Google マップ内のビジネス拠点へのルートをリクエストします。スマート アシスト キャンペーンのみ読み取り専用。 |
SMART_CAMPAIGN_TRACKED_CALLS |
スマート アシスト キャンペーンのカスタム条件を使用して、コール トラッキングを設定したスマート アシスト キャンペーン広告で発生した通話コンバージョンです。読み取り専用。 |
STORE_VISITS |
ユーザーが広告主の実店舗を訪問したときに発生するコンバージョン。読み取り専用。 |
WEBPAGE_CODELESS |
個別にコーディングされたイベント スニペットを使用しない、ウェブサイトのイベント(フォームの送信やページの読み込みなど)から作成されたコンバージョン。読み取り専用。 |
UNIVERSAL_ANALYTICS_GOAL |
リンクされたユニバーサル アナリティクスの目標に由来するコンバージョン。 |
UNIVERSAL_ANALYTICS_TRANSACTION |
リンクされたユニバーサル アナリティクスのトランザクションに由来するコンバージョン。 |
GOOGLE_ANALYTICS_4_CUSTOM |
リンクされた Google アナリティクス 4 カスタム イベント コンバージョンに由来するコンバージョン。 |
GOOGLE_ANALYTICS_4_PURCHASE |
リンクされた Google アナリティクス 4 の購入コンバージョンに由来するコンバージョン。 |
ConversionActionCategory
ConversionAction に関連付けられているコンバージョンのカテゴリ。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
DEFAULT |
デフォルトのカテゴリ。 |
PAGE_VIEW |
ページにアクセスしているユーザー。 |
PURCHASE |
購入、販売、または「注文完了」イベント。 |
SIGNUP |
登録ユーザーの操作。 |
LEAD |
見込み顧客を発掘するアクション。 |
DOWNLOAD |
ソフトウェアのダウンロード アクション(アプリの場合)。 |
ADD_TO_CART |
広告主様のサイトのショッピング カートやバッグに商品アイテムを追加すること。 |
BEGIN_CHECKOUT |
ユーザーが広告主のサイトで購入手続きのフローに入ったとき。 |
SUBSCRIBE_PAID |
商品やサービスの有料サブスクリプションの開始。 |
PHONE_CALL_LEAD |
広告主のサービスに対する関心を示すための呼び出し。 |
IMPORTED_LEAD |
外部ソースから Google 広告にインポートされたリード コンバージョン。 |
SUBMIT_LEAD_FORM |
広告主のサイトでビジネスに関心を示していることを示すフォームの送信。 |
BOOK_APPOINTMENT |
広告主のビジネスとの面談の予約。 |
REQUEST_QUOTE |
見積もりまたは価格見積もりのリクエスト。 |
GET_DIRECTIONS |
来店の意向がある広告主のビジネス拠点の検索。 |
OUTBOUND_CLICK |
広告主のパートナー サイトへのクリック。 |
CONTACT |
広告主への通話、SMS、メール、チャット、その他の連絡。 |
ENGAGEMENT |
サイトの滞在時間や Google アナリティクス(GA)のスマートゴールなど、ウェブサイトのエンゲージメント イベントです。Google アナリティクス、Firebase、Google アナリティクスのゴールド目標のインポートに使用することを目的としています。 |
STORE_VISIT |
実店舗への来店。 |
STORE_SALE |
実店舗での販売。 |
QUALIFIED_LEAD |
外部ソースから Google 広告にインポートされたリード コンバージョンで、広告主様(マーケティング チームまたはセールスチーム)によってさらに認定されたもの。見込み顧客が購入に至る過程で、広告主様は見込み顧客を獲得し、それに基づいて消費者に働きかけます。消費者が商品に興味を持ち、最終的に購入する可能性がある場合、広告主はそのような見込み顧客を「有望な見込み顧客」としてマークします。 |
CONVERTED_LEAD |
外部ソースから Google 広告にインポートされたリード コンバージョンで、見込み顧客の発掘を目標とする広告主様が指定したステージをさらに完了したもの。 |
ValueSettings
このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関連する設定。
JSON 表現 |
---|
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean } |
フィールド | |
---|---|
defaultValue |
このコンバージョン アクションのコンバージョン イベントに無効な値、許可されていない値、または値がない場合、または常にデフォルト値を使用するように設定されている場合に使用する値です。 |
defaultCurrencyCode |
このコンバージョン アクションのコンバージョン イベントの通貨コードが無効か指定されていない場合、または常にデフォルト値を使用するようにこのコンバージョン アクションが設定されている場合に使用する通貨コードです。 |
alwaysUseDefaultValue |
このコンバージョン アクションのコンバージョン イベントで指定された値と通貨コードの代わりに、デフォルト値とデフォルトの通貨コードを使用するかどうかを指定します。 |
AttributionModelSettings
このコンバージョン アクションのアトリビューション モデルに関連する設定です。
JSON 表現 |
---|
{ "attributionModel": enum ( |
フィールド | |
---|---|
attributionModel |
このコンバージョン アクションのアトリビューション モデルのタイプ。 |
dataDrivenModelStatus |
コンバージョン アクションのデータドリブン アトリビューション モデルのステータス。 |
AttributionModel
特定のコンバージョンのクレジットを、過去の多くの接点に配分する方法を記述するアトリビューション モデル。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
EXTERNAL |
外部のアトリビューションを使用します。 |
GOOGLE_ADS_LAST_CLICK |
コンバージョン経路のすべての貢献度をラストクリックに割り当てます。 |
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK |
Google 検索アトリビューションを使用して、コンバージョンのすべてのクレジットをファースト クリックに割り当てます。 |
GOOGLE_SEARCH_ATTRIBUTION_LINEAR |
Google 検索アトリビューションを使用して、発生したすべてのクリックにコンバージョンへの貢献度を均等に割り当てます。 |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
Google 検索アトリビューションを使用すると、コンバージョンに対する最近のクリックに、指数関数的に貢献度が割り当てられます(半減期は 1 週間)。 |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
コンバージョン経路の最初のクリックとラストクリックに、コンバージョンに対する貢献度の 40% を割り当てます。残りの 20% が他のすべてのクリックに均等に配分されます。Google 検索アトリビューションを使用します。 |
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN |
Google 検索アトリビューションを使用し、機械学習を利用して各クリックに貢献度を適切に配分する柔軟なモデル。 |
DataDrivenModelStatus
データドリブン モデルのステータスを列挙します。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
AVAILABLE |
データドリブン モデルを利用できる。 |
STALE |
データドリブン モデルが古くなっています。7 日以上更新されていません。コードはまだ使用されていますが、30 日間更新されないと期限切れになります。 |
EXPIRED |
データドリブン モデルの有効期限が切れています。30 日以上更新されていないため、使用できません。最もよくある原因としては、過去 30 日間に必要な数のイベントが発生していないことが考えられます。 |
NEVER_GENERATED |
データドリブン モデルが生成されたことはない。最もよくある原因としては、30 日間で必要な数のイベントが発生していないことが考えられます。 |
FloodlightSettings
Floodlight コンバージョン アクションに関連する設定。
JSON 表現 |
---|
{ "activityGroupTag": string, "activityTag": string, "activityId": string } |
フィールド | |
---|---|
activityGroupTag |
コンバージョンのレポート時に Floodlight アクティビティ グループの識別に使用される文字列。 |
activityTag |
コンバージョンのレポート時に Floodlight アクティビティを識別するために使用される文字列。 |
activityId |
DoubleClick Campaign Manager(DCM)の Floodlight アクティビティの ID。 |
ConversionCustomVariable
コンバージョン カスタム変数。詳しくは、https://support.google.com/sa360/answer/13567857 の「検索広告 360 リニューアル版でのカスタム Floodlight 指標とディメンションについて」をご覧ください。
JSON 表現 |
---|
{ "resourceName": string, "id": string, "name": string, "tag": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
コンバージョン カスタム変数のリソース名。コンバージョン カスタム変数のリソース名の形式は次のとおりです。
|
id |
コンバージョン カスタム変数の ID。 |
name |
必須。コンバージョン カスタム変数の名前。名前は一意である必要があります。名前の最大長は 100 文字です。前後に余分なスペースを入れないでください。 |
tag |
必須。コンバージョン カスタム変数のタグ。タグは一意で、「u」文字の直後に 100 以下の数字が続くものである必要があります。例: 「u4」。 |
status |
コンバージョン イベントの発生に関するコンバージョン カスタム変数のステータス。 |
ownerCustomer |
コンバージョン カスタム変数を所有する顧客のリソース名。 |
family |
コンバージョン カスタム変数のファミリーです。 |
cardinality |
コンバージョン カスタム変数の基数。 |
floodlightConversionCustomVariableInfo |
検索広告 360 Floodlight コンバージョン カスタム変数のフィールド。 |
customColumnIds[] |
このコンバージョン カスタム変数を使用するカスタム列の ID。 |
ConversionCustomVariableStatus
コンバージョン カスタム変数のステータス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ACTIVATION_NEEDED |
コンバージョン カスタム変数は有効化を待機しており、有効にするまで統計情報は発生しません。 このステータスは、CREATE および UPDATE リクエストでは使用できません。 |
ENABLED |
コンバージョン カスタム変数は有効になっており、統計情報が消費されます。 |
PAUSED |
コンバージョン カスタム変数は一時停止されており、再び有効にするまで統計情報は蓄積されません。 |
ConversionCustomVariableFamily
コンバージョン カスタム変数のファミリーです。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
STANDARD |
標準のコンバージョン カスタム変数。使用する前に、お客様は有効にする必要があります。 |
FLOODLIGHT |
カスタム Floodlight 変数からインポートされたコンバージョン カスタム変数。 |
ConversionCustomVariableCardinality
コンバージョン カスタム変数の基数。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
BELOW_ALL_LIMITS |
コンバージョン カスタム変数の基数がすべての上限を下回っています。この変数をセグメンテーションに使用できます。変数が有効になっている場合は、新しい値に対して統計情報が集計されます。 |
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT |
コンバージョン カスタム変数の基数がセグメント数の上限を超えていますが、統計情報の上限を超えていません。セグメンテーションは無効になりますが、変数を有効にすると新しい値の統計情報が集計されます。 |
APPROACHES_STATS_LIMIT |
コンバージョン カスタム変数はセグメンテーションの上限を超え、統計情報の上限に近づいています(90% を超えています)。セグメンテーションは無効になりますが、変数を有効にすると新しい値の統計情報が集計されます。 |
EXCEEDS_STATS_LIMIT |
コンバージョン カスタム変数が分割と統計情報の両方の上限を超えています。セグメンテーションは無効になり、有効な変数の統計情報は、既存の値によって変数の基数がそれ以上増えない場合にのみ蓄積されます。 |
FloodlightConversionCustomVariableInfo
検索広告 360 の Floodlight コンバージョン カスタム変数に関する情報です。
JSON 表現 |
---|
{ "floodlightVariableType": enum ( |
フィールド | |
---|---|
floodlightVariableType |
検索広告 360 で定義された Floodlight 変数タイプ。 |
floodlightVariableDataType |
検索広告 360 で定義されている Floodlight 変数のデータ型。 |
FloodlightVariableType
検索広告 360 で定義されている Floodlight 変数のタイプ。詳しくは、https://support.google.com/searchads/answer/4397154?hl=en をご覧ください。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
DIMENSION |
ディメンションの Floodlight 変数タイプ。 |
METRIC |
指標の Floodlight 変数タイプ。 |
UNSET |
Floodlight 変数タイプが設定されていません。 |
FloodlightVariableDataType
検索広告 360 で定義されている Floodlight 変数のデータ型。詳しくは、https://support.google.com/searchads/answer/4397154?hl=en をご覧ください。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
NUMBER |
「Number」タイプの Floodlight 変数を表します。この変数は、DIMENSION または METRIC タイプの Floodlight 変数に割り当てることができます。 |
STRING |
「文字列」タイプの Floodlight 変数を表します。この変数は、DIMENSION タイプの Floodlight 変数に割り当てることができます。 |
顧客
顧客です。
JSON 表現 |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
フィールド | |
---|---|
resourceName |
顧客のリソース名。顧客リソース名の形式は次のとおりです。
|
conversionTrackingSetting |
顧客のコンバージョン トラッキング設定。 |
accountType |
エンジン アカウント タイプ(Google 広告、Microsoft Advertising、Yahoo! JAPAN、Baidu、Facebook、エンジン トラッキングなど) |
doubleClickCampaignManagerSetting |
クライアント センター(MCC)の顧客用の DoubleClick Campaign Manager(DCM)の設定。 |
accountStatus |
アカウントのステータス(有効、一時停止、削除済みなど) |
lastModifiedTime |
この顧客が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
engineId |
外部エンジン アカウントのアカウント ID。 |
status |
顧客のステータス。 |
creationTime |
この顧客が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
id |
顧客の ID。 |
descriptiveName |
(省略可)顧客の一意でないわかりやすい名前。 |
currencyCode |
アカウントが運用されている通貨。ISO 4217 標準の通貨コードのサブセットがサポートされています。 |
timeZone |
顧客のローカル タイムゾーン ID。 |
trackingUrlTemplate |
パラメータからトラッキング URL を作成するための URL テンプレート。 |
finalUrlSuffix |
パラメータを最終ページ URL に追加するための URL テンプレート。 |
autoTaggingEnabled |
ユーザーに対して自動タグ設定が有効になっているかどうか。 |
manager |
お客様がマネージャーであるかどうか。 |
ConversionTrackingSetting
検索広告 360 のコンバージョン トラッキングに関連するユーザー全体の設定のコレクションです。
JSON 表現 |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
フィールド | |
---|---|
acceptedCustomerDataTerms |
お客様が顧客データに関する規約に同意したかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値はマネージャーから継承されます。このフィールドは読み取り専用です。詳しくは、https://support.google.com/adspolicy/answer/7475709 をご覧ください。 |
conversionTrackingStatus |
コンバージョン トラッキングのステータスです。顧客がコンバージョン トラッキングを使用しているかどうかと、その顧客のコンバージョン トラッキングの所有者は誰か。この顧客がクロスアカウント コンバージョン トラッキングを使用している場合、返される値はリクエストの |
enhancedConversionsForLeadsEnabled |
お客様がリードの拡張コンバージョンを有効にしているかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値はマネージャーから継承されます。このフィールドは読み取り専用です。 |
googleAdsConversionCustomer |
コンバージョンが作成、管理される顧客のリソース名。このフィールドは読み取り専用です。 |
conversionTrackingId |
このアカウントで使用されているコンバージョン トラッキング ID。この ID は、ユーザーがコンバージョン トラッキングを使用しているかどうかを示すものではありません(conversionTrackingStatus は使用しています)。このフィールドは読み取り専用です。 |
googleAdsCrossAccountConversionTrackingId |
顧客のマネージャーのコンバージョン トラッキング ID。ユーザーがコンバージョン トラッキングを有効にしているときに設定され、conversionTrackingId をオーバーライドします。この項目は Google 広告の管理画面でのみ管理できます。このフィールドは読み取り専用です。 |
crossAccountConversionTrackingId |
顧客のマネージャーのコンバージョン トラッキング ID。顧客がクロスアカウント コンバージョン トラッキングを有効にしている場合に設定され、conversionTrackingId をオーバーライドします。 |
ConversionTrackingStatus
顧客のコンバージョン トラッキング ステータス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
NOT_CONVERSION_TRACKED |
顧客はコンバージョン トラッキングを使用していない。 |
CONVERSION_TRACKING_MANAGED_BY_SELF |
コンバージョン アクションは、この顧客が作成、管理します。 |
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER |
コンバージョン アクションは、リクエストの login-customer-id で指定されたマネージャーによって作成、管理されます。 |
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER |
コンバージョン アクションが、リクエストの login-customer-id で指定された顧客またはマネージャーとは異なるマネージャーによって作成、管理されています。 |
AccountType
エンジン アカウントの種類として選択されます。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
BAIDU |
バイドゥ アカウント。 |
ENGINE_TRACK |
エンジントラッキングアカウントを使用します |
FACEBOOK |
ログインします。 |
FACEBOOK_GATEWAY |
ゲートウェイ経由で管理されている Facebook アカウント。 |
GOOGLE_ADS |
Google 広告アカウント。 |
MICROSOFT |
Microsoft Advertising アカウント。 |
SEARCH_ADS_360 |
検索広告 360 のクライアント センター(MCC)アカウント。 |
YAHOO_JAPAN |
Yahoo! Japan アカウント。 |
DoubleClickCampaignManagerSetting
クライアント センター(MCC)の顧客用の DoubleClick Campaign Manager(DCM)の設定。
JSON 表現 |
---|
{ "advertiserId": string, "networkId": string, "timeZone": string } |
フィールド | |
---|---|
advertiserId |
この顧客に関連付けられているキャンペーン マネージャー広告主の ID。 |
networkId |
この顧客に関連付けられているキャンペーン マネージャー ネットワークの ID。 |
timeZone |
この顧客に関連付けられている キャンペーン マネージャー ネットワークのタイムゾーン。America/New_York など、IANA タイムゾーン データベース形式で指定します。 |
AccountStatus
アカウントのステータス。
列挙型 | |
---|---|
UNSPECIFIED |
デフォルト値。 |
UNKNOWN |
不明な値。 |
ENABLED |
アカウントで広告を配信できる。 |
PAUSED |
アカウントはユーザーによって無効にされています。 |
SUSPENDED |
アカウントは内部プロセスによって無効にされています。 |
REMOVED |
アカウントは元に戻せません。 |
DRAFT |
アカウントはまだ設定中です。まだ有効化されていません。 |
CustomerStatus
顧客のステータス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ENABLED |
広告を配信できる有効なアカウントを示します。 |
CANCELED |
利用を停止したアカウントで広告を配信できないことを示します。管理者ユーザーが再度有効にできる。 |
SUSPENDED |
強制停止中のアカウントで広告を配信できないことを示します。Google サポートのみが有効化できます。 |
CLOSED |
広告を配信できない閉鎖されたアカウントであることを示します。テスト アカウントにも [CLOSED] ステータスが表示されます。ステータスは永続的であり、再開することはできません。 |
CustomerAsset
顧客とアセット間のリンク。
JSON 表現 |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
フィールド | |
---|---|
resourceName |
顧客アセットのリソース名。CustomerAsset のリソース名は次の形式です。
|
asset |
必須。顧客に関連付けられているアセット。 |
status |
顧客アセットのステータス。 |
CustomerAssetSet
CustomerAssetSet は、顧客とアセットセット間のリンクです。CustomerAssetSet を追加すると、アセットセットと顧客がリンクされます。
JSON 表現 |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
フィールド | |
---|---|
resourceName |
顧客アセットセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。
|
assetSet |
顧客に関連付けられているアセットセット。 |
customer |
このアセットセットがリンクされている顧客。 |
status |
顧客のアセットセットのアセットのステータスです。読み取り専用です。 |
AccessibleBiddingStrategy
顧客によって所有および共有されている入札戦略のビューを表します。
BiddingStrategy とは対照的に、このリソースには、このお客様が所有する戦略に加えて、お客様のマネージャーが所有し、お客様と共有する戦略も含まれます。このリソースでは指標を提供せず、 BiddingStrategy の属性のごく一部のサブセットのみを公開しています。
JSON 表現 |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
フィールド | |
---|---|
resourceName |
アクセス可能な入札戦略のリソース名。AccessibleBiddingStrategy リソース名の形式:
|
id |
入札戦略の ID。 |
name |
入札戦略の名前。 |
type |
入札戦略のタイプ。 |
ownerCustomerId |
入札戦略を所有する顧客の ID。 |
ownerDescriptiveName |
入札戦略を所有する顧客の名前。 |
共用体フィールド 1 つのみ設定できます。 |
|
maximizeConversionValue |
予算を消化しながらキャンペーンのコンバージョン値を最大化するための自動入札戦略です。 |
maximizeConversions |
予算を消化しながらキャンペーンで最大限のコンバージョンを獲得するための自動入札戦略です。 |
targetCpa |
指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する入札戦略。 |
targetImpressionShare |
選択した割合のインプレッションを重視して自動的に最適化する入札戦略です。 |
targetRoas |
特定の目標広告費用対効果(ROAS)を平均化しつつ、収益を最大化できる入札戦略。 |
targetSpend |
予算内でクリック数を最大限に獲得できるように入札単価を設定する入札戦略。 |
MaximizeConversionValue
予算を消化しながらキャンペーンのコンバージョン値を最大化するための自動入札戦略です。
JSON 表現 |
---|
{ "targetRoas": number } |
フィールド | |
---|---|
targetRoas |
目標広告費用対効果(LTV)オプション。設定した場合、入札戦略では目標広告費用対効果を平均化しながら、収益を最大化します。目標広告費用対効果が高い場合、入札戦略では予算全額を使用できない可能性があります。目標広告費用対効果が設定されていない場合、入札戦略では予算に対して可能な限り高い広告費用対効果を達成することを目指します。 |
MaximizeConversions
予算を消化しながらキャンペーンで最大限のコンバージョンを獲得するための自動入札戦略です。
JSON 表現 |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
フィールド | |
---|---|
targetCpa |
目標コンバージョン単価(CPA)オプション。1 コンバージョンあたりにお支払いいただける平均金額です。 |
targetCpaMicros |
目標コンバージョン単価(CPA)オプション。1 コンバージョンあたりにお支払いいただける平均金額です。 |
TargetCpa
指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する自動入札戦略です。
JSON 表現 |
---|
{ "targetCpaMicros": string } |
フィールド | |
---|---|
targetCpaMicros |
平均 CPA の目標値。この目標は、アカウントの通貨に基づき、請求可能な最小単位以上である必要があります。 |
TargetRoas
特定の目標広告費用対効果(ROAS)を平均化しつつ、収益を最大化できる自動入札戦略です。
JSON 表現 |
---|
{ "targetRoas": number } |
フィールド | |
---|---|
targetRoas |
費用単位あたりの選択された収益(コンバージョン データに基づく)。 |
TargetSpend
予算内でクリック数を最大化できるように入札単価を設定する自動入札戦略です。
JSON 表現 |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
フィールド | |
---|---|
targetSpendMicros |
クリック数を最大化するための目標予算。目標予算の入札者は、この値と、自然なスロットリング予算額のうち、少ない方の金額を支出しようとします。指定しない場合、予算が目標予算として使用されます。このフィールドは非推奨のため使用不可です。詳しくは、https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html をご覧ください。 |
cpcBidCeilingMicros |
入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。 |
CustomerManagerLink
顧客とクライアント センター(MCC)アカウントのリンク関係を表します。
JSON 表現 |
---|
{
"resourceName": string,
"status": enum ( |
フィールド | |
---|---|
resourceName |
リソースの名前。CustomerManagerLink のリソース名の形式は |
status |
顧客とマネージャー間のリンクのステータス。 |
managerCustomer |
そのお客様にリンクされている MCC アカウント。 |
managerLinkId |
顧客と MCC のリンクの ID。このフィールドは読み取り専用です。 |
ManagerLinkStatus
リンクのステータス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ACTIVE |
現在の効果のない関係を示します |
INACTIVE |
関係が終了していることを示します |
PENDING |
関係がマネージャーからリクエストされたものの、クライアントがまだ承認していないことを示します。 |
REFUSED |
マネージャーから関係がリクエストされましたが、クライアントは拒否しました。 |
CANCELED |
取引関係がマネージャーからリクエストされたが、マネージャーが取引をキャンセルしたことを示します。 |
CustomerClient
特定の顧客とクライアントの顧客間のリンク。CustomerClient は、マネージャーの顧客に対してのみ存在します。直接クライアントと間接クライアントのすべての顧客と、MCC アカウントが含まれます。
JSON 表現 |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
フィールド | |
---|---|
resourceName |
顧客クライアントのリソース名。CustomerClient リソース名の形式は |
appliedLabels[] |
リクエスト元のお客様が所有する、クライアントのお客様に適用されるラベルのリソース名。ラベルのリソース名の形式は次のとおりです。
|
status |
クライアントのお客様のステータス。読み取り専用。 |
clientCustomer |
特定の顧客に関連付けられている client-customer のリソース名。読み取り専用。 |
level |
特定の顧客と顧客の距離。セルフリンクの場合、レベルの値は 0 になります。読み取り専用。 |
timeZone |
クライアントのタイムゾーンを表す Common Locale Data Repository(CLDR)文字列表現(America/Los_Angeles など)。読み取り専用。 |
testAccount |
クライアントがテスト アカウントであるかどうかを示します。読み取り専用。 |
manager |
クライアントがマネージャーかどうかを示します。読み取り専用。 |
descriptiveName |
クライアントのわかりやすい名前。読み取り専用。 |
currencyCode |
クライアントの通貨コード(「USD」、「EUR」など)。読み取り専用。 |
id |
クライアント顧客の ID。読み取り専用。 |
DynamicSearchAdsSearchTermView
動的検索広告の検索語句のビュー。
JSON 表現 |
---|
{ "resourceName": string, "landingPage": string } |
フィールド | |
---|---|
resourceName |
動的検索広告の検索語句ビューのリソース名。動的検索広告の検索語句ビューのリソース名の形式は次のとおりです。
|
landingPage |
インプレッションに対して動的に選択されるランディング ページ URL。 このフィールドは読み取り専用です。 |
GenderView
性別ビュー。genderView リソースは、追加された条件ではなく、有効な配信状態を反映します。性別に関する条件が設定されていない広告グループでは、デフォルトですべての性別に表示されるため、すべての性別が genderView に統計情報とともに表示されます。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
性別ビューのリソース名。性別ビューのリソース名の形式は次のとおりです。
|
GeoTargetConstant
地域ターゲティングの定数。
JSON 表現 |
---|
{
"resourceName": string,
"status": enum ( |
フィールド | |
---|---|
resourceName |
地域ターゲティングの定数のリソース名。地域ターゲティングの定数リソース名の形式は次のとおりです。
|
status |
地域ターゲティングの定数ステータス。 |
id |
地域ターゲティング定数の ID です。 |
name |
地域ターゲティングの英語の定数名です。 |
countryCode |
ターゲット地域に関連付けられる国コード(ISO-3166-1 alpha-2)です。 |
targetType |
地域ターゲティングの定数ターゲット タイプです。 |
canonicalName |
英語の完全修飾名。ターゲット地域の名前と、その親国と国の名前で構成されます。 |
parentGeoTarget |
親の地域ターゲティング定数のリソース名。地域ターゲティングの定数リソース名の形式は次のとおりです。
|
GeoTargetConstantStatus
地域ターゲティングの定数に設定されるステータスです。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
ENABLED |
地域ターゲティングの定数が有効である。 |
REMOVAL_PLANNED |
地域ターゲティングの定数は廃止され、今後削除されます。 |
KeywordView
キーワード ビュー。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
キーワードビューのリソース名。キーワード ビューのリソース名の形式は次のとおりです。
|
ラベル
ラベル。
JSON 表現 |
---|
{ "resourceName": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
リソースの名前。ラベルのリソース名の形式は |
status |
ラベルのステータス。読み取り専用。 |
textLabel |
色付きの背景にテキストを表示するラベルの一種。 |
id |
ラベルの ID。読み取り専用。 |
name |
ラベルの名前。 このフィールドは必須です。新しいラベルを作成する場合は空にしないでください。 この文字列の長さは 1~80 で指定します。 |
LabelStatus
ラベルのステータス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ENABLED |
ラベルが有効になっています。 |
REMOVED |
ラベルが削除されます。 |
TextLabel
色付きの背景にテキストを表示するラベルの一種。
JSON 表現 |
---|
{ "backgroundColor": string, "description": string } |
フィールド | |
---|---|
backgroundColor |
ラベルの背景色(RGB 形式)。この文字列は、正規表現「^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$」と一致する必要があります。注: MCC アカウントでは、背景色が表示されない場合があります。 |
description |
ラベルの簡単な説明。長さは 200 文字以下にする必要があります。 |
LanguageConstant
言語。
JSON 表現 |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
フィールド | |
---|---|
resourceName |
言語定数のリソース名。言語定数のリソース名の形式は次のとおりです。
|
id |
言語定数の ID。 |
code |
言語コード(「en_US」、「en_AU」、「es」、「fr」など)。 |
name |
英語での完全な言語名(「英語(米国)」「スペイン語」など)。 |
targetable |
言語をターゲットに設定できるかどうか。 |
LocationView
地域ビューでは、地域に関する条件別にキャンペーンのパフォーマンスの概要を確認できます。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
ビジネス ビューのリソース名。ビジネス情報ビューのリソース名の形式は次のとおりです。
|
ProductBiddingCategoryConstant
商品の入札カテゴリ。
JSON 表現 |
---|
{ "resourceName": string, "level": enum ( |
フィールド | |
---|---|
resourceName |
商品入札カテゴリのリソース名。商品入札カテゴリのリソース名の形式は次のとおりです。
|
level |
商品入札カテゴリのレベル。 |
status |
商品入札カテゴリのステータス。 |
id |
商品入札カテゴリの ID。 この ID は google_product_category ID に相当します。詳しくは、https://support.google.com/merchants/answer/6324436 をご覧ください。 |
countryCode |
商品入札カテゴリの大文字 2 文字の国コード。 |
productBiddingCategoryConstantParent |
親の商品入札カテゴリのリソース名。 |
languageCode |
商品入札カテゴリの言語コード。 |
localizedName |
languageCode に従ってローカライズされた商品入札カテゴリの値を表示します。 |
ProductBiddingCategoryLevel
商品入札カテゴリのレベルを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
LEVEL1 |
レベル 1。 |
LEVEL2 |
レベル 2。 |
LEVEL3 |
レベル 3 |
LEVEL4 |
レベル 4 |
LEVEL5 |
レベル 5 |
ProductBiddingCategoryStatus
商品入札カテゴリのステータスを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ACTIVE |
カテゴリは有効で、入札に使用できます。 |
OBSOLETE |
このカテゴリは古くなっています。レポート作成にのみ使用されます。 |
ProductGroupView
商品グループの表示。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
商品グループビューのリソース名。商品グループビューのリソース名の形式は次のとおりです。
|
ShoppingPerformanceView
ショッピングのパフォーマンス ビュー。複数の商品ディメンション レベルで集計されたショッピング キャンペーンの統計情報が表示されます。ブランド、カテゴリ、カスタム属性、商品の状態、商品カテゴリなど、Merchant Center の商品ディメンションの値には、対応するイベントが記録されたときの各ディメンションの状態が反映されます。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
ショッピングのパフォーマンス ビューのリソース名。ショッピングのパフォーマンス ビューのリソース名の形式は |
UserList
ユーザーリスト。これは、お客様がターゲットに設定できるユーザーのリストです。
JSON 表現 |
---|
{
"resourceName": string,
"type": enum ( |
フィールド | |
---|---|
resourceName |
ユーザーリストのリソース名。ユーザーリストのリソース名の形式は次のとおりです。
|
type |
このリストのタイプ。 このフィールドは読み取り専用です。 |
id |
ユーザーリストの ID。 |
name |
このユーザー リストの名前。access_reason によっては、ユーザーリスト名が一意でないことがある(access_reason=SHARED の場合など) |
UserListType
ユーザーリストの型を含む列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
REMARKETING |
コンバージョン タイプのコレクションとして表される UserList。 |
LOGICAL |
他のユーザーリスト/インタレスト カテゴリの組み合わせとして表される UserList です。 |
EXTERNAL_REMARKETING |
Google アド マネージャー プラットフォームで作成されたユーザーリスト。 |
RULE_BASED |
ルールに関連付けられた UserList。 |
SIMILAR |
UserList には、別の UserList のユーザーと類似するユーザーを登録できます。 |
CRM_BASED |
広告主様がメールやその他の形式で提供する自社 CRM データのユーザーリスト。 |
WebpageView
ウェブページ ビュー。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
ウェブページ ビューのリソース名。ウェブページ ビューのリソース名の形式は次のとおりです。
|
アクセス
訪問。
JSON 表現 |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitDateTime": string, "productId": string, "productChannel": enum ( |
フィールド | |
---|---|
resourceName |
訪問のリソース名。訪問のリソース名の形式は次のとおりです。
|
id |
訪問の ID。 |
criterionId |
Search Ads 360 キーワード ID。値 0 は、キーワードにアトリビューションがないことを示します。 |
merchantId |
クリックされた商品を含む検索広告 360 在庫アカウント ID。検索広告 360 内で在庫アカウントをリンクすると、検索広告 360 でこの ID が生成されます。 |
adId |
広告 ID。値 0 は、広告が関連付けられていないことを示します。 |
clickId |
クリック ID URL パラメータとしてランディング ページに渡される、訪問ごとの一意の文字列。 |
visitDateTime |
訪問イベントのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
productId |
クリックされた商品の ID。 |
productChannel |
クリックされた商品の販売チャネル: オンラインまたはローカル。 |
productLanguageCode |
商品に関するデータを含む Merchant Center フィードに設定されている言語(ISO-639-1)。 |
productStoreId |
クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。 |
productCountryCode |
クリックされた商品を含む在庫フィードに登録されている国(ISO-3166 形式)。 |
assetId |
訪問イベント中に操作されたアセットの ID。 |
assetFieldType |
訪問イベントのアセット フィールド タイプ。 |
ProductChannel
商品の地域区分を記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ONLINE |
この商品はオンラインで販売されています。 |
LOCAL |
この商品は実店舗で販売されています。 |
コンバージョン
コンバージョン。
JSON 表現 |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitId": string, "advertiserConversionId": string, "productId": string, "productChannel": enum ( |
フィールド | |
---|---|
resourceName |
コンバージョンのリソース名。コンバージョン リソース名の形式は次のとおりです。
|
id |
コンバージョンの ID |
criterionId |
検索広告 360 の条件 ID。値 0 は、その条件が関連付けられていないことを示します。 |
merchantId |
クリックされた商品を含む検索広告 360 在庫アカウント ID。検索広告 360 内で在庫アカウントをリンクすると、検索広告 360 でこの ID が生成されます。 |
adId |
広告 ID。値 0 は、広告が関連付けられていないことを示します。 |
clickId |
コンバージョンが関連付けられている訪問の一意の文字列で、click id という URL パラメータとしてランディング ページに渡されます。 |
visitId |
コンバージョンが結び付けられた検索広告 360 の訪問 ID。 |
advertiserConversionId |
オフライン コンバージョンの場合は、広告主が提供する ID です。このような ID が広告主から指定されていない場合、検索広告 360 によって生成されます。オンライン コンバージョンの場合、広告主の Floodlight 処理に応じて、id 列または floodlightOrderId 列と同じになります。 |
productId |
クリックされた商品の ID。 |
productChannel |
クリックされた商品の販売チャネル: オンラインまたはローカル。 |
productLanguageCode |
商品に関するデータを含む Merchant Center フィードに設定されている言語(ISO-639-1)。 |
productStoreId |
クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。 |
productCountryCode |
クリックされた商品を含む在庫フィードに登録されている国(ISO-3166 形式)。 |
attributionType |
コンバージョンが関連付けられた要素: 「訪問」または「キーワード + 広告」。 |
conversionDateTime |
コンバージョン イベントのタイムスタンプ。 |
conversionLastModifiedDateTime |
コンバージョンが最後に変更された時刻のタイムスタンプ。 |
conversionVisitDateTime |
コンバージョンが関連付けられた訪問のタイムスタンプ。 |
conversionQuantity |
コンバージョンで記録されたアイテムの数量で、qty という URL パラメータによって特定されます。広告主がパラメータ(コンバージョンで販売されたアイテム数など)を動的に入力する必要がありますが、入力しない場合、デフォルトで 1 になります。 |
conversionRevenueMicros |
コンバージョン イベントの調整された収益(マイクロ秒単位)。これは常に広告配信中アカウントの通貨で表示されます。 |
floodlightOriginalRevenue |
Floodlight 通貨指示の変更前の、Floodlight イベントに関連付けられた、変更されていない元の収益(現在のレポートの通貨)。 |
floodlightOrderId |
コンバージョンに関して広告主から提供された Floodlight オーダー ID。 |
status |
コンバージョンのステータス(ENABLED または REMOVED)。 |
assetId |
コンバージョン イベント中に操作されたアセットの ID。 |
assetFieldType |
コンバージョン イベントのアセット フィールドのタイプ。 |
AttributionType
検索広告 360 のコンバージョン アトリビューション タイプ
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
VISIT |
コンバージョンは訪問に関連付けられます。 |
CRITERION_AD |
コンバージョンは、条件と広告のペアに関連付けられます。 |
ConversionStatus
コンバージョンのステータス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ENABLED |
コンバージョンは有効です。 |
REMOVED |
コンバージョンが削除されました。 |
指標
指標データ。
JSON 表現 |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
フィールド | |
---|---|
allConversionsValueByConversionDate |
すべてのコンバージョン値です。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/sa360/answer/9250611 をご覧ください。 |
allConversionsByConversionDate |
コンバージョンの合計数。これには、includeInConversionMetric の値に関係なく、すべてのコンバージョンが含まれます。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/sa360/answer/9250611 をご覧ください。 |
conversionCustomMetrics[] |
コンバージョンのカスタム指標。 |
conversionsValueByConversionDate |
コンバージョンの日付ごとの、入札単価設定に使用されるコンバージョン値の合計。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。 |
conversionsByConversionDate |
入札対象のコンバージョンの種類のコンバージョン日別の合計コンバージョン数。アトリビューション モデリングにより、小数値になることがあります。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。 |
historicalCreativeQualityScore |
クリエイティブの過去の品質スコア。 |
historicalLandingPageQualityScore |
過去のランディング ページの利便性の質。 |
historicalSearchPredictedCtr |
過去の検索の予測クリック率(CTR)。 |
interactionEventTypes[] |
支払い対象のインタラクションと無料インタラクションのタイプ。 |
rawEventConversionMetrics[] |
未加工のイベント コンバージョン指標。 |
absoluteTopImpressionPercentage |
「検索広告の最上部インプレッション シェア」とは、検索結果ページの最も目立つ位置に検索広告が表示されたインプレッションの割合です。 |
allConversionsFromInteractionsRate |
インタラクションからのコンバージョンの数(ビュースルー コンバージョンとは逆)を、広告インタラクションの数で割った値です。 |
allConversionsValue |
すべてのコンバージョン値。 |
allConversions |
コンバージョンの合計数。これには、includeInConversionMetric の値に関係なく、すべてのコンバージョンが含まれます。 |
allConversionsValuePerCost |
すべてのコンバージョンの値を、広告インタラクション(テキスト広告のクリックや動画広告の視聴など)の合計費用で割った値です。 |
allConversionsFromClickToCall |
ユーザーが広告のクリック中またはクリック後に [電話] ボタンをクリックして店舗に電話した回数です。この番号には、通話がつながったかどうかや通話時間は含まれません。 この指標はフィード アイテムにのみ適用されます。 |
allConversionsFromDirections |
ユーザーが広告をクリックした後に、[ルートを検索] ボタンをクリックして店舗への移動を行った回数。 この指標はフィード アイテムにのみ適用されます。 |
allConversionsFromInteractionsValuePerInteraction |
インタラクションによるすべてのコンバージョン値をインタラクションの合計数で割った値。 |
allConversionsFromMenu |
ユーザーが広告をクリックした後に、店舗のメニューを表示するリンクをクリックした回数。 この指標はフィード アイテムにのみ適用されます。 |
allConversionsFromOrder |
ユーザーが広告をクリックした後に、店舗で注文を行った回数。 この指標はフィード アイテムにのみ適用されます。 |
allConversionsFromOtherEngagement |
ユーザーが広告をクリックした後に発生したコンバージョン(クチコミの投稿、店舗の場所の保存など)の件数です。 この指標はフィード アイテムにのみ適用されます。 |
allConversionsFromStoreVisit |
ユーザーが広告をクリックした後に、店舗を訪問したと推定される回数。 この指標はフィード アイテムにのみ適用されます。 |
visits |
検索広告 360 で正常に記録され、広告主のランディング ページに転送されたクリック数。 |
allConversionsFromStoreWebsite |
ユーザーが広告をクリックした後に、ショップの URL にアクセスした回数。 この指標はフィード アイテムにのみ適用されます。 |
averageCost |
インタラクション 1 回に対して支払う平均金額です。広告にかかった費用の合計を、インタラクション数の合計で割った値です。 |
averageCpc |
すべてのクリックの合計費用を、発生したクリックの合計数で割った値。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
averageCpm |
平均インプレッション単価(CPM)。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
clicks |
クリック数。 |
contentBudgetLostImpressionShare |
予算が少なすぎるために、ディスプレイ ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: コンテンツ予算のインプレッション シェア損失率は 0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
contentImpressionShare |
ディスプレイ ネットワークで顧客が実際に獲得したインプレッションの回数を、顧客の広告が表示候補となった推定回数で割ったもの。注: コンテンツのインプレッション シェアは 0.1~1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。 |
contentRankLostImpressionShare |
広告ランクが低いために、広告がディスプレイ ネットワークで獲得できなかったインプレッションの推測割合。注: コンテンツ ランクのインプレッション シェア損失率は 0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
conversionsFromInteractionsRate |
入札対象のコンバージョンの平均(インタラクションから)です。広告インタラクションが入札単価設定に使用されるコンバージョンに、平均してどれくらいの頻度でつながっているかを確認できます。 |
clientAccountConversionsValue |
クライアント アカウントのコンバージョン値。includeInClientAccountConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
conversionsValuePerCost |
入札単価設定に使用されるコンバージョン値を、コンバージョンの対象となるインタラクションの合計費用で割った値。 |
conversionsFromInteractionsValuePerInteraction |
インタラクションによるコンバージョン値を広告インタラクション数で割った値。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
clientAccountConversions |
クライアント アカウントのコンバージョン数。includeInClientAccountConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
costMicros |
この期間のクリック単価(CPC)による費用とインプレッション単価(CPM)による費用の総額。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
costPerAllConversions |
広告インタラクションの費用をすべてのコンバージョンで割った値です。 |
costPerConversion |
入札単価設定に使用されるコンバージョンあたりの平均有効費用。 |
costPerCurrentModelAttributedConversion |
広告インタラクションの費用を、現在のモデルに起因するコンバージョンで割った値です。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
crossDeviceConversions |
ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、すべてのコンバージョンにすでに含まれています。 |
crossDeviceConversionsValue |
クロスデバイス コンバージョンの合計値。 |
ctr |
広告から発生したクリック数(クリック数)を、広告が表示された回数(インプレッション数)で割った値。 |
conversions |
コンバージョン数。includeInConversionMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
conversionsValue |
conversions フィールドに含まれるコンバージョンのコンバージョン値の合計。この指標は、コンバージョン アクションに値を設定している場合にのみ有用です。 |
historicalQualityScore |
品質スコア(履歴)。 |
impressions |
検索結果ページや Google ネットワークのウェブサイトに広告が表示された頻度。 |
interactionRate |
広告が表示された後にその広告をユーザーが操作する頻度。これは、インタラクション数を広告が表示された回数で割った値です。 |
interactions |
インタラクションの数。インタラクションとは、その広告フォーマットに関連付けられた主要なユーザー行動(テキスト広告やショッピング広告に対するクリック、動画広告の視聴など)を指します。 |
invalidClickRate |
レポート対象期間中のクリック総数(フィルタ済みとフィルタなしのクリック数)のうち、除外されたクリックの割合。 |
invalidClicks |
Google が不正と判断したクリックの数。料金は発生しません。 |
mobileFriendlyClicksPercentage |
モバイル向けページに移動するモバイル クリックの割合。 |
searchAbsoluteTopImpressionShare |
最も目立つ位置に表示されるお客様のショッピングまたは検索の広告のインプレッションの割合。詳しくは、https://support.google.com/sa360/answer/9566729 をご覧ください。0.1 未満の値はすべて 0.0999 として報告されます。 |
searchBudgetLostAbsoluteTopImpressionShare |
予算の低さが原因で、検索結果ページの上位の広告の中で、広告が最初に表示されなかった頻度の推定値です。注: 検索予算の検索広告の最上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
searchBudgetLostImpressionShare |
予算が少なすぎるために、検索ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: 検索予算のインプレッション シェア損失率は、0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
searchBudgetLostTopImpressionShare |
予算不足が原因で、広告が上位のオーガニック検索結果のすぐ近くに表示されなかった頻度の推定値です。注: 検索予算の検索広告のページ上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
searchClickShare |
検索ネットワークでのクリック数を、獲得可能だったと推定されるクリック数で割った値です。注: 検索クリック数シェアは 0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。 |
searchExactMatchImpressionShare |
キーワードのマッチタイプにかかわらず、キーワードと完全に一致した(またはキーワードの類似パターンである)検索語句に対して、検索ネットワークで受け取ることが可能だったインプレッションの推定数でインプレッション数を割った値です。注: 検索の完全一致のインプレッション シェアは 0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。 |
searchImpressionShare |
検索ネットワークで顧客が実際に獲得したインプレッションの回数を、顧客の広告が表示候補となった推定回数で割ったもの。注: 検索広告のインプレッション シェアは、0.1~1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。 |
searchRankLostAbsoluteTopImpressionShare |
広告ランクの低さが原因で、検索結果ページの上位の広告の中で、広告が最初に表示されなかった頻度の推定値です。注: 検索ランクの検索広告の最上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
searchRankLostImpressionShare |
広告ランクが低いために、広告が検索ネットワークで獲得できなかったインプレッションの推測割合。注: 検索ランクのインプレッション シェア損失率は、0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
searchRankLostTopImpressionShare |
広告ランクの低さが原因で、広告がオーガニック検索結果のすぐ近くに表示されなかった頻度の推定値です。注: 検索ランクの検索広告のページ上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。 |
searchTopImpressionShare |
上位の広告で獲得したインプレッション数を、上位広告の中で獲得可能だったと推定されるインプレッション数を基準として比較したものです。注: 検索の検索広告のページ上部インプレッション シェアは、0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。 通常、上位の広告は上位のオーガニック検索結果の上に表示されますが、特定の検索語句では上位のオーガニック検索結果の下に表示されることもあります。 |
topImpressionPercentage |
上位のオーガニック検索結果の隣に表示された広告のインプレッションの割合です。 |
valuePerAllConversions |
すべてのコンバージョンをすべてのコンバージョン数で割った値。 |
valuePerAllConversionsByConversionDate |
すべてのコンバージョン値を総コンバージョン数で割った値です。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。by_conversion_date 列について詳しくは、https://support.google.com/sa360/answer/9250611 をご覧ください。 |
valuePerConversion |
入札単価設定に使用されるコンバージョン値を、入札単価設定に使用されるコンバージョン数で割った値です。入札単価設定に使用される各コンバージョンの平均的な価値が表示されます。 |
valuePerConversionsByConversionDate |
コンバージョンの日付別の入札対象コンバージョン値を、コンバージョンの日付ごとの入札対象コンバージョン数で割った値です。入札単価設定に使用される各コンバージョンの平均的な価値(コンバージョンの日付別)が表示されます。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。 |
clientAccountViewThroughConversions |
ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像やリッチメディア広告を閲覧した後、別の広告を操作(クリックなど)することなく、サイトでコンバージョンに至ると発生します。 |
clientAccountCrossSellCostOfGoodsSoldMicros |
クライアント アカウントのクロスセルの売上原価(COGS)は、別の商品の広告を経由して購入された商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの売上原価とは、広告に掲載されずに販売された商品の売上原価の総額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文でのクロスセルの売上原価は 5 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
crossSellCostOfGoodsSoldMicros |
クロスセルの売上原価(COGS)は、別の商品の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの売上原価とは、広告に掲載されずに販売された商品の売上原価の総額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文でのクロスセルの売上原価は 5 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
clientAccountCrossSellGrossProfitMicros |
クライアント アカウントのクロスセルの総利益とは、ある商品が別の商品の広告を経由して販売に至った場合、その収益から売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入に含まれている商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの総利益とは、広告が貢献したクロスセルで得られた収益から売上原価を差し引いたものです。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。シャツの価格は 20 ドルで、売上原価は 5 ドルです。この場合、この注文でのクロスセルの総利益は 15 ドル(20 ドル - 5 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
crossSellGrossProfitMicros |
クロスセルの総利益とは、ある商品が別の商品の広告によって販売につながった場合、その収益から売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入に含まれている商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの総利益とは、広告が貢献したクロスセルで得られた収益から売上原価を差し引いたものです。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。シャツの価格は 20 ドルで、売上原価は 5 ドルです。この場合、この注文でのクロスセルの総利益は 15 ドル(20 ドル - 5 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
clientAccountCrossSellRevenueMicros |
クライアント アカウントのクロスセルの収益は、ある商品が別の商品の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの収益は、広告が貢献したクロスセルで得られた収益の合計額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文でのクロスセルの収益は 20 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
crossSellRevenueMicros |
クロスセルの収益は、ある商品が別の商品の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの収益は、広告が貢献したクロスセルで得られた収益の合計額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文でのクロスセルの収益は 20 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
clientAccountCrossSellUnitsSold |
クライアント アカウントのクロスセルの販売数は、ある商品が別の商品の広告によって販売につながった数の合計です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの販売数は、広告に起因するすべての注文のうち、クロスセルで販売された商品の合計数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文でのクロスセルの販売数は 2 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。 |
crossSellUnitsSold |
クロスセルの販売数は、別の商品の広告を経由して販売に至った商品の合計数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの販売数は、広告に起因するすべての注文のうち、クロスセルで販売された商品の合計数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文でのクロスセルの販売数は 2 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。 |
clientAccountLeadCostOfGoodsSoldMicros |
クライアント アカウントの主力商品の売上原価(COGS)とは、その商品自体の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の原価は主力商品の売上原価と見なされます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文での主力商品の売上原価は 3 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
leadCostOfGoodsSoldMicros |
主力商品の売上原価(COGS)は、その商品自体の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の原価は主力商品の売上原価と見なされます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文での主力商品の売上原価は 3 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
clientAccountLeadGrossProfitMicros |
クライアント アカウントの主力商品の総利益とは、その商品自体の広告を経由して販売に至った商品の収益から、売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の収益から売上原価を差し引いた金額が主力商品の総利益になります。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。この場合、この注文の主力商品の総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
leadGrossProfitMicros |
主力商品の総利益とは、その商品自体の広告を経由して販売に至った商品の収益から、売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の収益から売上原価を差し引いた金額が主力商品の総利益になります。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。この場合、この注文の主力商品の総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
clientAccountLeadRevenueMicros |
クライアント アカウントの主力商品の収益とは、ある商品がそれ自体の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の販売で得られた合計額が [主力商品の収益] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文での主力商品の収益は 10 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
leadRevenueMicros |
主力商品の収益とは、ある商品がそれ自体の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の販売で得られた合計額が [主力商品の収益] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文での主力商品の収益は 10 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。 |
clientAccountLeadUnitsSold |
クライアント アカウントの主力商品の販売数は、その商品自体の広告を経由して販売に至った商品の合計数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。広告に掲載された商品と販売された商品が一致する場合、これらの販売された商品の合計数が [主力商品の販売数] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文での主力商品の販売数は 1 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。 |
leadUnitsSold |
主力商品の販売数は、その商品自体の広告を経由して販売に至った商品の合計数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。広告に掲載された商品と販売された商品が一致する場合、これらの販売された商品の合計数が [主力商品の販売数] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文での主力商品の販売数は 1 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。 |
値
汎用的なデータコンテナ。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド value 。値。value は次のいずれかになります。 |
|
booleanValue |
ブール値。 |
int64Value |
int64。 |
floatValue |
浮動小数点数。 |
doubleValue |
double。 |
stringValue |
文字列。 |
QualityScoreBucket
品質スコアのバケットをリストした列挙型です。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
BELOW_AVERAGE |
クリエイティブの品質が平均を下回っています。 |
AVERAGE |
クリエイティブの品質は平均的です。 |
ABOVE_AVERAGE |
クリエイティブの品質が平均を上回っています。 |
InteractionEventType
支払い可能なインタラクションと無料のインタラクションの種類を記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
CLICK |
クリックしてサイトを表示ほとんどの場合、このインタラクションは外部の場所(通常は広告主のランディング ページ)に移動します。これは、クリック イベントのデフォルトの InteractionEventType でもあります。 |
ENGAGEMENT |
所定の場所で広告を操作する意思をユーザーが表明したものです。 |
VIDEO_VIEW |
ユーザーが動画広告を視聴しました。 |
NONE |
広告コンバージョン イベントのデフォルトの InteractionEventType。無料のインタラクション(広告コンバージョンなど)を「プロモート」し、主要指標の一部としてレポートすべきことが広告コンバージョンの行で示されていない場合に使用されます。これらは単に他の(広告)コンバージョンです。 |
セグメント
セグメント専用フィールド。
JSON 表現 |
---|
{ "adNetworkType": enum ( |
フィールド | |
---|---|
adNetworkType |
広告ネットワークのタイプ。 |
conversionActionCategory |
コンバージョン アクションのカテゴリ。 |
conversionCustomDimensions[] |
コンバージョンのカスタム ディメンション。 |
dayOfWeek |
曜日(例: MONDAY)。 |
device |
指標が適用されるデバイス。 |
keyword |
キーワードの条件。 |
productChannel |
商品のチャネル。 |
productChannelExclusivity |
商品のチャネル独占性。 |
productCondition |
商品の状態。 |
productSoldCondition |
販売された商品の状態。 |
rawEventConversionDimensions[] |
未加工のイベント コンバージョン ディメンション。 |
conversionAction |
コンバージョン アクションのリソース名。 |
conversionActionName |
コンバージョン アクション名。 |
date |
指標が適用される日付。yyyy-MM-dd 形式(例: 2018-04-17)。 |
month |
月の初日の日付で表される月。形式は yyyy-MM-dd です。 |
productBiddingCategoryLevel1 |
商品の入札カテゴリ(レベル 1)。 |
productBiddingCategoryLevel2 |
商品の入札カテゴリ(レベル 2)。 |
productBiddingCategoryLevel3 |
商品の入札カテゴリ(レベル 3)。 |
productBiddingCategoryLevel4 |
商品の入札カテゴリ(レベル 4)。 |
productBiddingCategoryLevel5 |
商品の入札カテゴリ(レベル 5)。 |
productBrand |
商品のブランド。 |
productCountry |
商品の販売先の国の地域ターゲティング定数のリソース名。 |
productCustomAttribute0 |
商品のカスタム属性 0。 |
productCustomAttribute1 |
商品のカスタム属性 1。 |
productCustomAttribute2 |
商品のカスタム属性 2。 |
productCustomAttribute3 |
商品のカスタム属性 3。 |
productCustomAttribute4 |
商品のカスタム属性 4。 |
productItemId |
商品の商品アイテム ID。 |
productLanguage |
商品の言語の言語定数のリソース名。 |
productSoldBiddingCategoryLevel1 |
販売された商品の入札カテゴリ(レベル 1)。 |
productSoldBiddingCategoryLevel2 |
販売された商品の入札カテゴリ(レベル 2)。 |
productSoldBiddingCategoryLevel3 |
販売された商品の入札カテゴリ(レベル 3)。 |
productSoldBiddingCategoryLevel4 |
販売された商品の入札カテゴリ(レベル 4)。 |
productSoldBiddingCategoryLevel5 |
販売された商品の入札カテゴリ(レベル 5)。 |
productSoldBrand |
販売した商品のブランド。 |
productSoldCustomAttribute0 |
販売された商品のカスタム属性 0。 |
productSoldCustomAttribute1 |
販売された商品のカスタム属性 1。 |
productSoldCustomAttribute2 |
販売された商品のカスタム属性 2。 |
productSoldCustomAttribute3 |
販売された商品のカスタム属性 3。 |
productSoldCustomAttribute4 |
販売された商品のカスタム属性 4。 |
productSoldItemId |
販売した商品の商品アイテム ID。 |
productSoldTitle |
販売した商品のタイトル。 |
productSoldTypeL1 |
販売した商品のタイプ(レベル 1)。 |
productSoldTypeL2 |
販売した商品のタイプ(レベル 2)。 |
productSoldTypeL3 |
販売した商品のタイプ(レベル 3)。 |
productSoldTypeL4 |
販売した商品のタイプ(レベル 4)。 |
productSoldTypeL5 |
販売した商品のタイプ(レベル 5)。 |
productStoreId |
商品のストア ID。 |
productTitle |
商品のタイトル。 |
productTypeL1 |
商品のタイプ(レベル 1)。 |
productTypeL2 |
商品のタイプ(レベル 2)。 |
productTypeL3 |
商品のタイプ(レベル 3)。 |
productTypeL4 |
商品のタイプ(レベル 4)。 |
productTypeL5 |
商品のタイプ(レベル 5)。 |
quarter |
四半期の初日の日付で表される四半期。四半期に暦年を使用します。たとえば、2018 年の第 2 四半期は 2018-04-01 に始まります。形式は yyyy-MM-dd です。 |
week |
月曜日から日曜日までとして定義される週。月曜日の日付で表されます。形式は yyyy-MM-dd です。 |
year |
年(yyyy 形式)。 |
assetInteractionTarget |
CustomerAsset、CampaignAsset、AdGroupAsset の各指標でのみ使用します。インタラクションの指標がアセット自体で発生したか、別のアセットや広告ユニットで発生したかを示します。インタラクション(クリックなど)は、広告が同時に配信されると、配信された広告のすべての要素(広告自体とサイトリンクなどのその他のコンポーネント)でカウントされます。interactionOnThisAsset が true の場合は、操作がこの特定のアセットで発生し、InteractionOnThisAsset が false の場合は、操作がこの特定のアセットではなく、このアセットとともに配信される広告の他の部分で発生しています。 |
AdNetworkType
Google 広告ネットワーク タイプを列挙します。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
このバージョンでは値が不明です。 |
SEARCH |
Google 検索。 |
SEARCH_PARTNERS |
検索パートナー |
CONTENT |
ディスプレイ ネットワークです。 |
YOUTUBE_SEARCH |
YouTube 検索。 |
YOUTUBE_WATCH |
YouTube 動画 |
MIXED |
クロスネットワーク。 |
キーワード
キーワードの条件セグメントです。
JSON 表現 |
---|
{
"info": {
object ( |
フィールド | |
---|---|
info |
キーワード情報。 |
adGroupCriterion |
AdGroupCriterion リソース名。 |
ProductChannelExclusivity
商品の在庫状況を記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
SINGLE_CHANNEL |
商品アイテムは 1 つのチャネル(ProductChannel で指定された実店舗またはオンライン)でのみ販売されます。 |
MULTI_CHANNEL |
商品アイテムが、対応するオンラインまたは実店舗と照合され、両方の ShoppingProductChannels で購入可能であることを示します。 |
ProductCondition
商品情報の状態を記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
OLD |
商品の状態が古い。 |
NEW |
商品の状態が新品である。 |
REFURBISHED |
商品の状態は再生品です。 |
USED |
商品の状態が使用されます。 |
AssetInteractionTarget
AssetInteractionTarget セグメント。
JSON 表現 |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
フィールド | |
---|---|
asset |
アセットのリソース名。 |
interactionOnThisAsset |
CustomerAsset、CampaignAsset、AdGroupAsset の各指標でのみ使用します。インタラクションの指標がアセット自体で発生したか、別のアセットや広告ユニットで発生したかを示します。 |