- JSON 表現
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- 広告
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- AdTextAsset
- 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
- お客様
- 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[] |
カスタム列。 |
広告グループ
広告グループ。
JSON 表現 |
---|
{ "resourceName": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
広告グループのリソース名。広告グループのリソース名の形式は次のとおりです。
|
status |
広告グループのステータス。 |
type |
広告グループのタイプ。 |
adRotationMode |
広告グループの広告のローテーション モード。 |
creationTime |
この adGroup が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
targetingSetting |
ターゲティング関連の機能の設定です。 |
labels[] |
この広告グループに適用されているラベルのリソース名。 |
engineId |
外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます(Yahoo! Japan、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 で選択した条件にのみ広告を表示するか、この targetDimension のすべての値をターゲットに設定し、他の TargetDimensions のターゲティングに基づいて広告を表示するかを指定します。値を |
TargetingDimension
使用可能なターゲティング ディメンションを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
KEYWORD |
キーワードの条件(「火星クルーズ」など)。キーワードは個別の入札単価ディメンションとして使用できます。キーワードは常にターゲティング ディメンションであるため、ターゲットを [すべて] に設定することはできません。TargetRestriction ディメンションがあります。 |
AUDIENCE |
ユーザーリスト、ユーザーの関心、カスタム アフィニティ、購買意向の強いカスタムなどのオーディエンス条件。 |
TOPIC |
コンテンツのカテゴリをターゲティングするためのトピック条件(「category::Animals>Pets」など)ディスプレイと動画のターゲティングに使用されます。 |
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 |
ファインド動画レスポンシブ広告です。 |
MULTIMEDIA_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 |
区切り文字でパス 1 に追加されるテキスト。 |
adTrackingId |
広告のトラッキング ID。 |
SearchAds360ResponsiveSearchAdInfo
検索広告 360 のレスポンシブ検索広告。
JSON 表現 |
---|
{ "headlines": [ { object ( |
フィールド | |
---|---|
headlines[] |
広告見出しのテキスト アセットのリスト。広告が配信されると、このリストから広告見出しが選択されます。 |
descriptions[] |
説明のテキスト アセットのリスト。広告が配信されると、このリストから説明文が選択されます。 |
path1 |
自動生成された表示 URL に付加される、区切り文字付きのテキスト。 |
path2 |
区切り文字でパス 1 に追加されるテキスト。 |
adTrackingId |
広告のトラッキング ID。 |
AdTextAsset
広告内で使用されるテキスト アセット。
JSON 表現 |
---|
{ "text": string } |
フィールド | |
---|---|
text |
アセットのテキスト。 |
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 |
バイドゥ: クリエイティブは承認されませんでした。 |
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW |
Baidu: モバイル 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! Japan、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 |
Baidu: モバイルでは入札単価または品質が低すぎますが、パソコンでの表示には適格です。 |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
Baidu: 入札単価または品質がパソコンでは低すぎるが、モバイルでは表示条件を満たす。 |
AD_GROUP_CRITERION_INVALID_SEARCH |
Baidu: 入札単価または品質が低すぎるため表示できません。 |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
バイドゥ: 検索ボリュームが少ないため、バイドゥで一時停止しています。 |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
Baidu: モバイル 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 |
引数の web 条件は、比較対象のウェブ条件と等しくなります。 |
CONTAINS |
引数 web 条件は、比較対象のウェブ条件の一部です。 |
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 |
画像/png の MIME タイプ。 |
FLASH |
application/x-shockwave-flash の MIME タイプ。 |
TEXT_HTML |
text/html の MIME タイプ。 |
PDF |
アプリケーション/PDF の MIME タイプ。 |
MSWORD |
アプリケーション/ミリ秒の MIME タイプ。 |
MSEXCEL |
application/vnd.ms-excel の MIME タイプ。 |
RTF |
application/rtf の MIME タイプ。 |
AUDIO_WAV |
Audio/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 は、曜日と広告が表示される期間として指定されます。
同じ日に追加できる AdSchedule は 6 つまでです。
JSON 表現 |
---|
{ "startMinute": enum ( |
フィールド | |
---|---|
startMinute |
このスケジュールが開始される開始時刻からの分。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
endMinute |
このスケジュールが終了する終了時刻の分数。スケジュールに終了時刻は含まれません。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
dayOfWeek |
スケジュールが適用される曜日。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
startHour |
24 時間表記の開始時刻。このフィールドは 0 ~ 23 の範囲で指定してください。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
endHour |
24 時間表記の終了時刻24 は 1 日の終わりを表します。このフィールドは 0 ~ 24 の値にする必要があります。 このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。 |
MinuteOfHour
15 時間単位の列挙。例: 「FIFTEEN」
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
このバージョンでは値が不明です。 |
ZERO |
正時から 0 分後。 |
FIFTEEN |
正時から 15 分後です。 |
THIRTY |
正時から 30 分後。 |
FORTY_FIVE |
正時から 45 分後です。 |
DayOfWeek
曜日を列挙します(例: "Monday")。
列挙型 | |
---|---|
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!Japan のみの項目が表示されます。 |
useSearcherTimeZone |
検索ユーザーのタイムゾーンでサイトリンク アセットを表示するかどうかを指定します。Microsoft 広告に適用されます。 |
mobilePreferred |
サイトリンク アセットをモバイル デバイスに表示する設定かどうか。Microsoft 広告に適用されます。 |
UnifiedPageFeedAsset
統合されたページフィード アセット。
JSON 表現 |
---|
{ "pageUrl": string, "labels": [ string ] } |
フィールド | |
---|---|
pageUrl |
広告主がターゲットとするウェブページ。 |
labels[] |
ページの URL をグループ化するために使用するラベル。 |
MobileAppAsset
モバイルアプリを表すアセット。
JSON 表現 |
---|
{
"appId": string,
"appStore": enum ( |
フィールド | |
---|---|
appId |
必須。モバイルアプリを一意に識別する文字列。「com.android.ebay」のようにプラットフォームのネイティブ ID のみを含めてください。Android または「12345689」追加できます |
appStore |
必須。この特定のアプリを配信するアプリケーション ストア。 |
MobileAppVendor
モバイルアプリ ベンダーのタイプ
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
APPLE_APP_STORE |
Apple App Store のモバイルアプリ ベンダー。 |
GOOGLE_APP_STORE |
Google アプリストアのモバイルアプリ ベンダーです。 |
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 |
行動を促すフレーズのタイプは「今すぐ注文」です。 |
PLAY_NOW |
行動を促すフレーズのタイプが再生されました。 |
SEE_MORE |
行動を促すフレーズのタイプは「もっと見る」です。 |
START_NOW |
行動を促すフレーズのタイプは今から始める。 |
VISIT_SITE |
行動を促すフレーズのタイプは「サイトにアクセス」です。 |
WATCH_NOW |
行動を促すフレーズのタイプは「今すぐ視聴」です。 |
UnifiedLocationAsset
統合された住所アセット。
JSON 表現 |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
フィールド | |
---|---|
placeId |
プレイス ID は、Google プレイスのデータベースおよび Google マップで、特定の場所を一意に識別する ID です。このフィールドは、お客様 ID とアセットタイプごとに一意です。プレイス 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 |
アセットが長い広告見出しで使用されています(MultiAssetResponseAd で使用)。 |
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 入札戦略に適用し、その後で広告配信中アカウントと MCC アカウントのリンクを解除した場合です。この場合、アクセスできなくなったクライアント センター(MCC)入札戦略からキャンペーンが自動的に切り離され、無効な入札戦略タイプに移行します。 |
MANUAL_CPA |
広告主が指定したアクションごとに入札単価を設定できる個別単価設定。 |
MANUAL_CPC |
クリックに基づく個別の入札単価。クリック 1 回ごとに支払います。 |
MANUAL_CPM |
インプレッションに基づく個別単価設定。1,000 回のインプレッションごとにユーザーが支払います。 |
MANUAL_CPV |
動画の視聴 1 回あたりで設定可能な金額を支払う入札戦略。 |
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)を維持しながら収益を最大化できる自動入札戦略です。 |
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)オプション。コンバージョン アクション 1 回に対して支出する平均金額を、入札戦略の通貨のマイクロ単位で指定します。設定すると、目標コンバージョン単価以下で最大限のコンバージョンを獲得できます。目標コンバージョン単価が設定されていない場合、入札戦略は、予算内で可能な限り低いコンバージョン単価の達成を目指します。 |
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 |
AccessibleBidStrategy のリソース名です。「bidStrategy」で識別される、接続されているポートフォリオ入札戦略の無制限の属性の読み取り専用ビューです。キャンペーンでポートフォリオ戦略を使用していない場合は空になります。制限のない戦略属性は、戦略を共有しているすべてのお客様が利用でき、AccessibleBiddingStrategy リソースから読み取られます。これに対して、制限付きの属性は、戦略のオーナーである顧客とそのマネージャーのみが使用できます。制限付き属性は、BidStrategy リソースからのみ読み取ることができます。 |
frequencyCaps[] |
各ユーザーにこのキャンペーンの広告が表示される頻度を制限するリスト。 |
selectiveOptimization |
このキャンペーンの選択的最適化の設定。このキャンペーンの最適化で重視するコンバージョン アクションが含まれます。この機能は、MULTI_CHANNEL を AdvertisingChannelType として使用し、APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を AdvertisingChannelSubType として使用するアプリ キャンペーンにのみ適用されます。 |
optimizationGoalSetting |
このキャンペーンの最適化目標の設定です。一連の最適化の目標タイプが含まれます。 |
trackingSetting |
トラッキング情報に関するキャンペーン単位の設定。 |
engineId |
外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます(Yahoo! Japan、Microsoft、Baidu など)。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。 |
excludedParentAssetFieldTypes[] |
このキャンペーンから除外するアセット フィールド タイプ。これらの項目タイプのアセットリンクは、このキャンペーンに上位レベルから継承されません。 |
createTime |
このキャンペーンが作成されたときのタイムスタンプ。タイムスタンプの形式は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss」です。使用できます。createTime は v1 で非推奨となります。代わりに createTime を使用してください。 |
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 |
標準の「目標コンバージョン単価」入札戦略では、指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価が自動的に設定されます。 |
targetImpressionShare |
目標インプレッション シェア入札戦略。指定した割合のインプレッションを達成できるように入札単価を設定する自動入札戦略。 |
targetRoas |
標準の目標広告費用対効果入札戦略。特定の目標広告費用対効果(ROAS)の平均値を設定しながら、収益を自動的に最大化します。 |
targetSpend |
予算内でクリック数を最大化できるように入札単価を自動的に設定する、標準の目標予算入札戦略です。 |
percentCpc |
商品やサービスの広告価格に対する割合で入札する、標準のクリック単価入札戦略。 |
targetCpm |
インプレッション単価を自動的に最適化する入札戦略。 |
CampaignStatus
キャンペーンの有効なステータスです。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ENABLED |
キャンペーンが有効で、広告を表示できます。 |
PAUSED |
キャンペーンはユーザーによって一時停止されています。 |
REMOVED |
キャンペーンが削除されました。 |
CampaignServingStatus
キャンペーンの配信ステータスです。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
受け取った値は、このバージョンでは不明です。 これはレスポンス専用の値です。 |
SERVING |
配信中。 |
NONE |
なし。 |
ENDED |
終了しました。 |
PENDING |
Pending. |
SUSPENDED |
停止中。 |
BiddingStrategySystemStatus
BiddingStrategy の考えられるシステム ステータスです。
列挙型 | |
---|---|
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 がない)または SSC のリマーケティング リストがありません。 |
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 |
P-MAX キャンペーンです |
LOCAL_SERVICES |
ローカル サービス キャンペーン。 |
DISCOVERY |
ファインド キャンペーン |
TRAVEL |
旅行キャンペーン |
SOCIAL |
ソーシャル キャンペーン。 |
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 |
動画アクション キャンペーン |
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 |
旅行関連の目標達成のためのキャンペーンです |
SOCIAL_FACEBOOK_TRACKING_ONLY |
Facebook トラッキングはソーシャル キャンペーンのみです。 |
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 つの広告(または広告セット)をユーザーに表示する最大回数を指定するルール。
SelectiveOptimization
このキャンペーンの選択的最適化の設定。このキャンペーンの最適化で重視するコンバージョン アクションが含まれます。この機能は、MULTI_CHANNEL を AdvertisingChannelType として使用し、APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を AdvertisingChannelSubType として使用するアプリ キャンペーンにのみ適用されます。
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 |
入札戦略で設定可能な入札単価の上限。これは広告主が入力するオプションのフィールドで、ローカルのマイクロ秒単位で指定します。注: 値がゼロ(ゼロ)の場合は、bid_floor が未定義の場合と同じように解釈されます。 |
enhancedCpcEnabled |
コンバージョンの可能性に応じて、オークションごとに入札単価が調整されます。個々の入札単価が cpcBidCeilingMicros を超える場合がありますが、キャンペーンの平均入札単価は上限を超えないようにしてください。 |
TargetCpm
この型にはフィールドがありません。
目標インプレッション単価(CPM)は自動入札戦略の一種で、設定した目標インプレッション単価で掲載結果が最適化されるように入札単価が設定されます。
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[] |
FeedItem がターゲットに設定されている FeedItemSets です。複数の 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 では、「update」を使用して作成された場合にのみ primaryForGoal を false に設定可能オプションとして宣言されていないためです。 |
ownerCustomer |
コンバージョン アクションのオーナーである顧客のリソース名。システム定義のコンバージョン アクションの場合は null。 |
includeInClientAccountConversionsMetric |
このコンバージョン アクションを「clientAccountConversions」に含めるかどうか表示されます。 |
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 アクティビティ。販売 1 件あたりの合計金額も取得できます。読み取り専用。 |
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
コンバージョン カスタム変数。「検索広告 360 リニューアル版のカスタム Floodlight の指標とディメンションについて」をご覧くださいhttps://support.google.com/sa360/answer/13567857
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 |
「String」の Floodlight 変数を表します。あります。この変数は、DIMENSION タイプの Floodlight 変数に割り当てることができます。 |
顧客
お客様です。
JSON 表現 |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
フィールド | |
---|---|
resourceName |
顧客のリソース名。顧客のリソース名の形式は次のとおりです。
|
conversionTrackingSetting |
顧客のコンバージョン トラッキング設定。 |
accountType |
エンジン アカウント タイプ(Google 広告、Microsoft Advertising、Yahoo! JAPAN、Baidu、Facebook、エンジン トラッキングなど) |
doubleClickCampaignManagerSetting |
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 |
お客様が顧客データに関する規約に同意したかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC アカウントから継承されます。このフィールドは読み取り専用です。詳しくは、https://support.google.com/adspolicy/answer/7475709 をご覧ください。 |
conversionTrackingStatus |
コンバージョン トラッキングのステータス。顧客がコンバージョン トラッキングを使用しているかどうか、またこの顧客のコンバージョン トラッキングの所有者は誰なのかが表示されます。この顧客がクロスアカウント コンバージョン トラッキングを使用している場合、返される値はリクエストの |
enhancedConversionsForLeadsEnabled |
お客様がリードの拡張コンバージョンを有効にしているかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC アカウントから継承されます。このフィールドは読み取り専用です。 |
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 で指定された MCC アカウントによって作成、管理されます。 |
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER |
コンバージョン アクションが、リクエストの login-customer-id で指定された顧客または管理者とは別の管理者が作成、管理している。 |
AccountType
考えられるエンジン アカウントの種類です。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
BAIDU |
Baidu アカウント。 |
ENGINE_TRACK |
エンジントラッキングアカウントです |
FACEBOOK |
できます。 |
FACEBOOK_GATEWAY |
ゲートウェイ経由で管理される Facebook アカウント |
GOOGLE_ADS |
Google 広告アカウント。 |
MICROSOFT |
Microsoft Advertising アカウント。 |
SEARCH_ADS_360 |
検索広告 360 のクライアント センター(MCC)アカウント。 |
YAHOO_JAPAN |
Yahoo Japan アカウント |
DoubleClickCampaignManagerSetting
DoubleClick Campaign Manager(DCM)の設定です。
JSON 表現 |
---|
{ "advertiserId": string, "networkId": string, "timeZone": string } |
フィールド | |
---|---|
advertiserId |
この顧客に関連付けられているキャンペーン マネージャー 広告主の ID。 |
networkId |
この顧客に関連付けられているキャンペーン マネージャー ネットワークの ID。 |
timeZone |
この顧客に関連付けられているキャンペーン マネージャー ネットワークのタイムゾーン。IANA タイムゾーン データベース形式(America/New_York など)で指定します。 |
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 |
アクセス可能な入札戦略のリソース名。AccessibleBidStrategy リソース名の形式は次のとおりです。
|
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。このフィールドは読み取り専用です。 |
startTime |
CustomerManagerLink が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
ManagerLinkStatus
リンクのステータス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
ACTIVE |
現在有効な関係を示します |
INACTIVE |
関係の終了を示します |
PENDING |
マネージャーから関係がリクエストされたものの、クライアントがまだ承認していないことを示します。 |
REFUSED |
マネージャーから関係がリクエストされましたが、クライアントが拒否しました。 |
CANCELED |
マネージャーが関係をリクエストしたものの、管理者がそれをキャンセルしたことを示します。 |
CustomerClient
特定の顧客とクライアントの顧客間のリンク。CustomerClient は、マネージャーのお客様専用です。直接的および間接的なクライアントのすべての顧客と、マネージャー自体が含まれます。
JSON 表現 |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
フィールド | |
---|---|
resourceName |
顧客クライアントのリソース名。CustomerClient リソース名の形式は |
appliedLabels[] |
クライアントの顧客に適用され、リクエスト元の顧客が所有するラベルのリソース名。ラベルリソース名の形式は次のとおりです。
|
status |
クライアントの顧客のステータス。読み取り専用。 |
clientCustomer |
特定の顧客にリンクされている顧客顧客のリソース名。読み取り専用。 |
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 |
ラベルの背景色(16 進数形式)。この文字列は、正規表現「^#([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 |
ウェブページ ビューのリソース名。ウェブページビューのリソース名の形式は次のとおりです。
|
アクセス
1 回の訪問です。
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 |
コンバージョンの合計数です。これには、includeInConversionsMetric の値に関係なく、すべてのコンバージョンが含まれます。この列を日付とともに選択した場合、日付列の値はコンバージョンの日付を意味します。by_conversion_date 列について詳しくは、https://support.google.com/sa360/answer/9250611 をご覧ください。 |
conversionCustomMetrics[] |
コンバージョンのカスタム指標。 |
conversionsValueByConversionDate |
コンバージョンの日付ごとの、入札単価設定に使用されるコンバージョン値の合計。この列を日付とともに選択した場合、日付列の値はコンバージョンの日付を意味します。 |
conversionsByConversionDate |
入札対象のコンバージョン タイプのコンバージョンの日付別の合計コンバージョン数。アトリビューション モデリングにより、小数値になる場合があります。この列を日付とともに選択した場合、日付列の値はコンバージョンの日付を意味します。 |
historicalCreativeQualityScore |
クリエイティブの過去の品質スコア。 |
historicalLandingPageQualityScore |
過去のランディング ページの利便性。 |
historicalSearchPredictedCtr |
過去の検索の予測クリック率(CTR)。 |
interactionEventTypes[] |
支払い対象のインタラクションと無料インタラクションのタイプ。 |
rawEventConversionMetrics[] |
未加工のイベント コンバージョン指標。 |
absoluteTopImpressionPercentage |
「検索広告の最上部インプレッション シェア」とは、検索結果ページの最も目立つ位置に検索広告が表示されたインプレッションの割合です。 |
allConversionsFromInteractionsRate |
インタラクションからのコンバージョンの数(ビュースルー コンバージョンとは逆)を、広告インタラクションの数で割った値です。 |
allConversionsValue |
すべてのコンバージョン値。 |
allConversions |
コンバージョンの合計数です。これには、includeInConversionsMetric の値に関係なく、すべてのコンバージョンが含まれます。 |
allConversionsValuePerCost |
すべてのコンバージョンの値を、広告インタラクション(テキスト広告のクリックや動画広告の視聴など)の総費用で割った値。 |
allConversionsFromClickToCall |
ユーザーが [電話] をクリックした回数広告をクリック中またはクリックすると、店舗に電話できるようになります。この数値には、通話がつながったかどうかや通話時間は含まれません。 この指標はフィード アイテムにのみ適用されます。 |
allConversionsFromDirections |
ユーザーが「経路検索」をクリックした回数広告をクリックした後にショップに移動するボタン この指標はフィード アイテムにのみ適用されます。 |
allConversionsFromInteractionsValuePerInteraction |
インタラクションから発生したすべてのコンバージョンのコンバージョン値をインタラクションの合計数で割った値。 |
allConversionsFromMenu |
ユーザーが広告をクリックした後に、ショップのメニューを表示するためのリンクをクリックした回数。 この指標はフィード アイテムにのみ適用されます。 |
allConversionsFromOrder |
ユーザーが広告をクリックした後に、店舗で注文を行った回数。 この指標はフィード アイテムにのみ適用されます。 |
allConversionsFromOtherEngagement |
ユーザーが広告をクリックした後に発生したその他のコンバージョン(レビューの投稿、店舗の場所の保存など)の数。 この指標はフィード アイテムにのみ適用されます。 |
allConversionsFromStoreVisit |
ユーザーが広告をクリックした後に、店舗を訪問したと推定される回数。 この指標はフィード アイテムにのみ適用されます。 |
visits |
検索広告 360 で正常に記録され、広告主のランディング ページに転送されたクリック数。 |
allConversionsFromStoreWebsite |
ユーザーが広告をクリックした後に、ショップの URL に移動した回数。 この指標はフィード アイテムにのみ適用されます。 |
averageCost |
インタラクション 1 回に対して支払う金額の平均。広告にかかった費用の合計を、インタラクション数の合計で割った値です。 |
averageCpc |
すべてのクリックの合計費用を、発生したクリックの合計数で割った値。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
averageCpm |
平均インプレッション単価(CPM)。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
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 |
インタラクションから発生したコンバージョン値を広告インタラクションの数で割った値。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
clientAccountConversions |
クライアント アカウントのコンバージョン数。これには、includeInClientAccountConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
costMicros |
指定の期間における、クリック単価(CPC)による費用とインプレッション単価(CPM)による費用の総額。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
costPerAllConversions |
広告インタラクションの費用をすべてのコンバージョンで割った値です。 |
costPerConversion |
入札対象のコンバージョンあたりの平均コンバージョン対象費用。 |
costPerCurrentModelAttributedConversion |
広告インタラクションの費用を、現在のモデルに起因するコンバージョンで割った値です。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
crossDeviceConversions |
ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、すでにすべてのコンバージョンに含まれています。 |
crossDeviceConversionsValue |
クロスデバイス コンバージョンの合計値。 |
ctr |
広告から発生したクリック数(クリック数)を、広告が表示された回数(インプレッション数)で割った値です。 |
conversions |
コンバージョン数です。これには、includeInConversionsMetric 属性が true に設定されているコンバージョン アクションのみが含まれます。コンバージョンに基づく入札を使用している場合、入札戦略はこれらのコンバージョンを重視して最適化されます。 |
conversionsValue |
conversions フィールドに含まれるコンバージョンのコンバージョン値の合計。この指標は、コンバージョン アクションに値を設定している場合にのみ有用です。 |
averageQualityScore |
平均品質スコア。 |
historicalQualityScore |
品質スコア(履歴)。 |
impressions |
検索結果ページやGoogle ネットワークのウェブサイトに広告が表示された頻度です。 |
interactionRate |
広告が表示された後にその広告をユーザーが操作する頻度。これは、インタラクション数を広告が表示された回数で割った値です。 |
interactions |
インタラクションの数。インタラクションとは、その広告フォーマットに関連付けられた主要なユーザー行動(テキスト広告やショッピング広告に対するクリック、動画広告の視聴など)を指します。 |
invalidClickRate |
レポート対象期間中のクリック総数(フィルタ済みとフィルタなしのクリック数)のうち、除外されたクリックの割合。 |
invalidClicks |
Google が不正と判断し、料金を請求しないクリック数です。 |
mobileFriendlyClicksPercentage |
モバイル向けページに移動するモバイル クリックの割合。 |
searchAbsoluteTopImpressionShare |
最も目立つ位置に表示されるお客様のショッピングまたは検索の広告のインプレッションの割合。詳しくは、https://support.google.com/sa360/answer/9566729 をご覧ください。0.1 未満の値はすべて 0.0999 として報告されます。 |
searchBudgetLostAbsoluteTopImpressionShare |
予算の低さが原因で、広告が検索結果ページの上位の広告の 1 番目に入らなかった頻度の推定値です。注: 検索予算の検索広告の最上部インプレッション シェア損失率は、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 |
上位の広告の 1 つとして実際に獲得できたインプレッション数と、上位の広告として獲得可能だったインプレッション数の推定値を比較したものです。注: 検索の検索広告のページ上部インプレッション シェアは、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 ドルです。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
crossSellCostOfGoodsSoldMicros |
クロスセルの売上原価(COGS)は、別の商品の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの売上原価とは、広告に掲載されずに販売された商品の売上原価の総額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この注文でのクロスセルの売上原価は 5 ドルです。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
clientAccountCrossSellGrossProfitMicros |
クライアント アカウントのクロスセルの総利益とは、ある商品が別の商品の広告を経由して販売に至った場合、その収益から売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入に含まれている商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの総利益とは、広告が貢献したクロスセルで得られた収益から売上原価を差し引いたものです。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。シャツの価格は 20 ドルで、売上原価は 5 ドルです。この場合、この注文でのクロスセルの総利益は 15 ドル(20 ドル - 5 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
crossSellGrossProfitMicros |
クロスセルの総利益とは、ある商品が別の商品の広告を経由して販売に至った場合、その収益から売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入に含まれている商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの総利益とは、広告が貢献したクロスセルで得られた収益から売上原価を差し引いたものです。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。シャツの価格は 20 ドルで、売上原価は 5 ドルです。この場合、この注文でのクロスセルの総利益は 15 ドル(20 ドル - 5 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
clientAccountCrossSellRevenueMicros |
クライアント アカウントのクロスセルの収益は、ある商品が別の商品の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの収益は、広告が貢献したクロスセルで得られた収益の合計額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文でのクロスセルの収益は 20 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
crossSellRevenueMicros |
クロスセルの収益は、ある商品が別の商品の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの収益は、広告が貢献したクロスセルで得られた収益の合計額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文でのクロスセルの収益は 20 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
clientAccountCrossSellUnitsSold |
クライアント アカウントのクロスセルの販売数は、ある商品が別の商品の広告から販売につながった数の合計です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの販売数は、広告に起因するすべての注文のうち、クロスセルされた商品の総数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツとジャケットを購入しました。この場合、この注文でのクロスセルの販売数は 2 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。 |
crossSellUnitsSold |
クロスセルの販売数とは、ある商品が別の商品の広告から販売につながった数の合計です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの販売数は、広告に起因するすべての注文のうち、クロスセルされた商品の総数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツとジャケットを購入しました。この場合、この注文でのクロスセルの販売数は 2 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。 |
clientAccountLeadCostOfGoodsSoldMicros |
クライアント アカウントの主力商品の売上原価(COGS)は、その商品自体の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の原価は主力商品の売上原価と見なされます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文での主力商品の売上原価は 3 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
leadCostOfGoodsSoldMicros |
主力商品の売上原価(COGS)は、その商品自体の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の原価は主力商品の売上原価と見なされます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文での主力商品の売上原価は 3 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
clientAccountLeadGrossProfitMicros |
クライアント アカウントの主力商品の総利益とは、その商品自体の広告を経由して販売に至った商品の収益から、売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品で得られた収益から売上原価を差し引いた金額が主力商品の総利益になります。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。この場合、この注文の主力商品の総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
leadGrossProfitMicros |
主力商品の総利益とは、その商品自体の広告を経由して販売に至った商品の収益から、売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品で得られた収益から売上原価を差し引いた金額が主力商品の総利益になります。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。この場合、この注文の主力商品の総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
clientAccountLeadRevenueMicros |
クライアント アカウントの主力商品の収益とは、ある商品がそれ自体の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の販売で得られた合計額が [主力商品の収益] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文での主力商品の収益は 10 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
leadRevenueMicros |
主力商品の収益とは、ある商品がそれ自体の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが購入前に操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の販売で得られた合計額が [主力商品の収益] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文での主力商品の収益は 10 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。 |
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)。 |
geoTargetCity |
都市を表す地域ターゲティング定数のリソース名。 |
geoTargetCountry |
国を表す地域ターゲティング定数のリソース名。 |
geoTargetMetro |
大都市圏を表す地域ターゲティング定数のリソース名。 |
geoTargetRegion |
リージョンを表す地域ターゲティング定数のリソース名。 |
hour |
時間帯(0 ~ 23 の数値)。 |
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 年 4 月 1 日から始まります。形式は 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 の指標でのみ使用。インタラクションの指標が、アセット自体で発生したのか、別のアセットや広告ユニットで発生したのかを示します。 |