インデックス
AccessibleBiddingStrategy
(メッセージ)AccessibleBiddingStrategy.MaximizeConversionValue
(メッセージ)AccessibleBiddingStrategy.MaximizeConversions
(メッセージ)AccessibleBiddingStrategy.TargetCpa
(メッセージ)AccessibleBiddingStrategy.TargetImpressionShare
(メッセージ)AccessibleBiddingStrategy.TargetRoas
(メッセージ)AccessibleBiddingStrategy.TargetSpend
(メッセージ)Ad
(メッセージ)AdGroup
(メッセージ)AdGroupAd
(メッセージ)AdGroupAdLabel
(メッセージ)AdGroupAsset
(メッセージ)AdGroupAssetSet
(メッセージ)AdGroupAudienceView
(メッセージ)AdGroupBidModifier
(メッセージ)AdGroupCriterion
(メッセージ)AdGroupCriterion.PositionEstimates
(メッセージ)AdGroupCriterion.QualityInfo
(メッセージ)AdGroupCriterionLabel
(メッセージ)AdGroupLabel
(メッセージ)AgeRangeView
(メッセージ)Asset
(メッセージ)AssetGroup
(メッセージ)AssetGroupAsset
(メッセージ)AssetGroupAssetCombinationData
(メッセージ)AssetGroupListingGroupFilter
(メッセージ)AssetGroupSignal
(メッセージ)AssetGroupTopCombinationView
(メッセージ)AssetSet
(メッセージ)AssetSetAsset
(メッセージ)Audience
(メッセージ)BiddingStrategy
(メッセージ)Campaign
(メッセージ)Campaign.DynamicSearchAdsSetting
(メッセージ)Campaign.GeoTargetTypeSetting
(メッセージ)Campaign.NetworkSettings
(メッセージ)Campaign.OptimizationGoalSetting
(メッセージ)Campaign.SelectiveOptimization
(メッセージ)Campaign.ShoppingSetting
(メッセージ)Campaign.TrackingSetting
(メッセージ)CampaignAsset
(メッセージ)CampaignAssetSet
(メッセージ)CampaignAudienceView
(メッセージ)CampaignBudget
(メッセージ)CampaignCriterion
(メッセージ)CampaignLabel
(メッセージ)CartDataSalesView
(メッセージ)Conversion
(メッセージ)ConversionAction
(メッセージ)ConversionAction.AttributionModelSettings
(メッセージ)ConversionAction.FloodlightSettings
(メッセージ)ConversionAction.ValueSettings
(メッセージ)ConversionCustomVariable
(メッセージ)ConversionCustomVariable.FloodlightConversionCustomVariableInfo
(メッセージ)ConversionTrackingSetting
(メッセージ)CustomColumn
(メッセージ)Customer
(メッセージ)CustomerAsset
(メッセージ)CustomerAssetSet
(メッセージ)CustomerClient
(メッセージ)CustomerManagerLink
(メッセージ)DoubleClickCampaignManagerSetting
(メッセージ)DynamicSearchAdsSearchTermView
(メッセージ)GenderView
(メッセージ)GeoTargetConstant
(メッセージ)KeywordView
(メッセージ)Label
(メッセージ)LanguageConstant
(メッセージ)ListingGroupFilterDimension
(メッセージ)ListingGroupFilterDimension.ProductBiddingCategory
(メッセージ)ListingGroupFilterDimension.ProductBrand
(メッセージ)ListingGroupFilterDimension.ProductChannel
(メッセージ)ListingGroupFilterDimension.ProductCondition
(メッセージ)ListingGroupFilterDimension.ProductCustomAttribute
(メッセージ)ListingGroupFilterDimension.ProductItemId
(メッセージ)ListingGroupFilterDimension.ProductType
(メッセージ)ListingGroupFilterDimensionPath
(メッセージ)LocationView
(メッセージ)ProductBiddingCategoryConstant
(メッセージ)ProductGroupView
(メッセージ)SearchAds360Field
(メッセージ)ShoppingPerformanceView
(メッセージ)UserList
(メッセージ)Visit
(メッセージ)WebpageView
(メッセージ)
AccessibleBiddingStrategy
顧客が所有し、共有している入札戦略のビューを表します。
BiddingStrategy とは対照的に、このリソースには、この顧客が所有する戦略に加え、顧客のマネージャーが所有し、この顧客と共有している戦略が含まれます。このリソースでは、指標は提供されず、 BiddingStrategy 属性の限定されたサブセットのみが公開されます。
フィールド | |
---|---|
resource_name |
アクセス可能な入札戦略のリソース名。AccessibleBidStrategy リソース名の形式は次のとおりです。
|
id |
入札戦略の ID。 |
name |
入札戦略の名前。 |
type |
入札戦略のタイプ。 |
owner_customer_id |
入札戦略を所有する顧客の ID。 |
owner_descriptive_name |
description_name は、入札戦略を所有する顧客の名前です。 |
共用体フィールド 設定できるのは 1 つのみです。 |
|
maximize_conversion_value |
予算を消化しながらキャンペーンのコンバージョン値を最大化するための自動入札戦略。 |
maximize_conversions |
指定の予算を消化しつつキャンペーンのコンバージョン数を最大化できる自動入札戦略。 |
target_cpa |
指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する入札戦略。 |
target_impression_share |
選択したインプレッションの割合を重視して自動的に最適化する入札戦略。 |
target_roas |
特定の目標広告費用対効果(ROAS)を平均しながら収益を最大化できる入札戦略。 |
target_spend |
予算内でクリック数を最大化できるように入札単価を設定する入札戦略です。 |
MaximizeConversionValue
予算を消化しながらキャンペーンのコンバージョン値を最大化するための自動入札戦略。
フィールド | |
---|---|
target_roas |
目標広告費用対効果(LTV)オプション。設定した場合、入札戦略では目標広告費用対効果を平均化しながら、収益を最大化します。目標広告費用対効果が高い場合、入札戦略では予算全額を使用できない可能性があります。目標広告費用対効果が設定されていない場合、入札戦略では予算に対して可能な限り高い広告費用対効果を達成することを目指します。 |
MaximizeConversions
指定の予算を消化しつつキャンペーンのコンバージョン数を最大化できる自動入札戦略。
フィールド | |
---|---|
target_cpa |
目標コンバージョン単価(CPA)オプション。これは、顧客獲得 1 回あたりに費やす平均金額です。 |
target_cpa_micros |
目標コンバージョン単価(CPA)オプション。これは、顧客獲得 1 回あたりに費やす平均金額です。 |
TargetCpa
指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する自動入札戦略。
フィールド | |
---|---|
target_cpa_micros |
平均 CPA の目標値。この目標は、アカウントの通貨に基づき、請求可能な最小単位以上である必要があります。 |
TargetRoas
特定の目標広告費用対効果(ROAS)を平均しながら収益を最大化できる自動入札戦略。
フィールド | |
---|---|
target_roas |
コンバージョン データに基づいて選択された費用単位あたりの収益。 |
TargetSpend
予算内でクリック数を最大化できるように入札単価を設定する自動入札戦略。
フィールド | |
---|---|
target_spend_micros |
クリック数を最大化するための目標予算。目標予算の入札者は、この値と、自然なスロットリング予算額のうち、少ない方の金額を支出しようとします。指定しない場合、予算が目標予算として使用されます。このフィールドは非推奨のため使用不可です。詳しくは、https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html をご覧ください。 |
cpc_bid_ceiling_micros |
入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。 |
広告
広告
フィールド | |
---|---|
resource_name |
広告のリソース名。広告リソース名の形式は次のとおりです。
|
final_urls[] |
広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。 |
type |
広告タイプ。 |
id |
広告の ID です。 |
display_url |
一部の広告フォーマットの広告説明に表示される URL。 |
name |
広告の名前。広告を識別するためにのみ使用されます。一意である必要はなく、配信される広告には影響しません。name フィールドは現在、DisplayUploadAd、ImageAd、ShoppingComparisonListingAd、VideoAd でのみサポートされています。 |
共用体フィールド ad_data 。広告タイプに関する詳細。値を 1 つだけ設定する必要があります。ad_data は次のいずれかになります。 |
|
text_ad |
テキスト広告に関する詳細。 |
expanded_text_ad |
拡張テキスト広告に関する詳細。 |
responsive_search_ad |
レスポンシブ検索広告に関する詳細。 |
product_ad |
商品広告に関する詳細。 |
expanded_dynamic_search_ad |
拡張動的検索広告に関する詳細。 |
広告グループ
広告グループ。
フィールド | |
---|---|
resource_name |
広告グループのリソース名。広告グループのリソース名の形式は次のとおりです。
|
status |
広告グループのステータス。 |
type |
広告グループのタイプ。 |
ad_rotation_mode |
広告グループの広告のローテーション モード。 |
creation_time |
この ad_group が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
targeting_setting |
ターゲティング関連の機能の設定です。 |
labels[] |
この広告グループに適用されているラベルのリソース名。 |
engine_id |
外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます(Yahoo! Japan、Microsoft、Baidu など)。Google 広告エンティティの場合は、代わりに「ad_group.id」を使用します。 |
start_date |
この広告グループの広告配信を開始する日付。デフォルトでは、広告グループの開始日は、現在または開始日のいずれか遅い方になります。このフィールドを設定した場合、ユーザーのタイムゾーンで指定の日付の開始時間に広告グループが開始されます。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。 形式: YYYY-MM-DD 例: 2019-03-14 |
end_date |
広告グループの広告配信を終了する日付。デフォルトでは、広告グループは広告グループの終了日に終了します。このフィールドが設定されている場合、ユーザーのタイムゾーンで指定の日付に広告グループが終了します。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。 形式: YYYY-MM-DD 例: 2019-03-14 |
language_code |
広告グループ内の広告とキーワードの言語。このフィールドは、Microsoft Advertising アカウントでのみ使用できます。詳細: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
last_modified_time |
この広告グループが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
id |
広告グループの ID です。 |
name |
広告グループの名前です。 新しい広告グループを作成する場合は、このフィールドは必須です。空にすることはできません。 含めることができる文字は、UTF-8 の全角で 255 文字未満にする必要があります。 null(コードポイント 0x0)、NL ラインフィード(コードポイント 0xA)、改行(コードポイント 0xD)の文字を含めることはできません。 |
cpc_bid_micros |
最大 CPC(クリック単価)入札。 |
engine_status |
広告グループのエンジン ステータス。 |
AdGroupAd
広告グループの広告です。
フィールド | |
---|---|
resource_name |
広告のリソース名。広告グループの広告のリソース名の形式は次のとおりです。
|
status |
広告のステータスです。 |
ad |
広告。 |
creation_time |
この ad_group_ad が作成されたときのタイムスタンプ。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
labels[] |
この広告グループの広告に適用されているラベルのリソース名。 |
engine_id |
外部エンジン アカウントの広告の ID。このフィールドは検索広告 360 アカウント(Yahoo、Microsoft、Baidu など)専用です。検索広告 360 以外のエンティティの場合は、「ad_group_ad.ad.id」を使用しますしてください。 |
engine_status |
外部エンジン アカウントの広告の追加ステータス。外部アカウントの種類によって、アクティブ、有効、確認待ちなどのステータスが表示されます。 |
last_modified_time |
この広告グループの広告が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
AdGroupAdLabel
広告グループの広告とラベルの関係。
フィールド | |
---|---|
resource_name |
広告グループ広告ラベルのリソース名です。広告グループの広告ラベルのリソース名の形式は |
ad_group_ad |
ラベルが添付される広告グループ広告。 |
label |
広告グループ広告に割り当てられるラベル。 |
AdGroupAsset
広告グループとアセット間のリンクです。
フィールド | |
---|---|
resource_name |
広告グループ アセットのリソース名。AdGroupAsset リソース名の形式は次のとおりです。
|
ad_group |
必須。アセットがリンクされている広告グループ。 |
asset |
必須。広告グループにリンクされているアセットです。 |
status |
広告グループのアセットのステータス。 |
AdGroupAssetSet
AdGroupAssetSet は、広告グループとアセットセットをリンクしたものです。AdGroupAssetSet を作成すると、アセットセットと広告グループがリンクされます。
フィールド | |
---|---|
resource_name |
広告グループのアセットセットのリソース名。広告グループのアセットセットのリソース名の形式は次のとおりです。
|
ad_group |
このアセットセットがリンクされている広告グループ。 |
asset_set |
広告グループにリンクされているアセットセット。 |
status |
広告グループのアセットセットのステータス。読み取り専用です。 |
AdGroupAudienceView
広告グループのオーディエンス ビュー。ディスプレイ ネットワーク広告と YouTube ネットワーク広告のインタレスト リストやリマーケティング リスト、検索広告向けリマーケティング リスト(RLSA)について、オーディエンス単位で集計した掲載結果データが含まれます。
フィールド | |
---|---|
resource_name |
広告グループのオーディエンス ビューのリソース名。広告グループのオーディエンス ビューのリソース名の形式は次のとおりです。
|
AdGroupBidModifier
広告グループの入札単価調整比を表します。
フィールド | |
---|---|
resource_name |
広告グループの入札単価調整比のリソース名。広告グループの入札単価調整比のリソース名の形式は次のとおりです。
|
bid_modifier |
条件が一致した場合の入札の修飾子。修飾子は 0.1 ~ 10.0 の範囲内にする必要があります。PreferredContent の範囲は 1.0~6.0 です。デバイスタイプをオプトアウトするには、0 を使用します。 |
共用体フィールド V5 以降の作成オペレーションでは必須です。 |
|
device |
デバイスの条件です。 |
AdGroupCriterion
広告グループの条件。ad_group_criterion レポートでは、広告グループに明示的に追加された条件のみが返されます。
フィールド | |
---|---|
resource_name |
広告グループの条件のリソース名。広告グループの条件のリソース名の形式は次のとおりです。
|
creation_time |
この広告グループの条件が作成された時点のタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
status |
条件のステータス。 これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。 |
quality_info |
基準の品質に関する情報。 |
type |
条件のタイプ。 |
labels[] |
この広告グループの条件に適用されているラベルのリソース名。 |
position_estimates |
さまざまな掲載位置におけるクライテリアの入札単価の見積もりです。 |
final_urls[] |
広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。 |
engine_id |
外部エンジン アカウントの広告グループの条件の ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます(Yahoo! Japan、Microsoft、Baidu など)。Google 広告エンティティの場合は、「ad_group_criterion.criterion_id」を使用します。してください。 |
last_modified_time |
この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
criterion_id |
条件の ID。 |
ad_group |
条件が属する広告グループです。 |
negative |
条件をターゲティング( このフィールドは変更できません。評価基準を肯定的なものから否定的なものに切り替えるには、条件を削除してから再度追加します。 |
bid_modifier |
条件が一致した場合の入札の修飾子。修飾子は 0.1 ~ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
cpc_bid_micros |
クリック単価(CPC)。 |
effective_cpc_bid_micros |
有効 CPC(クリック単価)入札。 |
engine_status |
広告グループのエンジン ステータスの条件。 |
final_url_suffix |
パラメータを最終ページ URL に追加するための URL テンプレート。 |
tracking_url_template |
トラッキング URL を作成するための URL テンプレート。 |
共用体フィールド 1 つのみを設定する必要があります。 |
|
keyword |
キーワード。 |
listing_group |
リスティング グループ。 |
age_range |
年齢層。 |
gender |
性別。 |
user_list |
ユーザーリスト。 |
webpage |
ウェブページ |
location |
位置情報] をタップします。 |
PositionEstimates
さまざまな掲載位置におけるクライテリアの入札単価の見積もりです。
フィールド | |
---|---|
top_of_page_cpc_micros |
検索結果の最初のページの上部に広告を表示するために必要なクリック単価の見積もりです。 |
QualityInfo
広告グループの条件の品質情報のコンテナ。
フィールド | |
---|---|
quality_score |
品質スコア。 Google が値を決定するための十分な情報を持っていない場合は、このフィールドに値が入力されないことがあります。 |
AdGroupCriterionLabel
広告グループの条件とラベルの関係。
フィールド | |
---|---|
resource_name |
広告グループの条件ラベルのリソース名。広告グループの条件ラベルのリソース名の形式は、 |
ad_group_criterion |
ラベルが添付される広告グループ条件。 |
label |
広告グループの条件に割り当てられているラベル。 |
AdGroupLabel
広告グループとラベルの関係。
フィールド | |
---|---|
resource_name |
広告グループラベルのリソース名。広告グループラベルのリソース名の形式は |
ad_group |
ラベルが添付される広告グループ。 |
label |
広告グループに割り当てられているラベル。 |
AgeRangeView
年齢層のビュー。
フィールド | |
---|---|
resource_name |
年齢層ビューのリソース名。年齢層ビューのリソース名の形式は次のとおりです。
|
アセット
アセットは、複数の広告で共有できる広告の一部です。画像(ImageAsset)、動画(YouTubeVideoAsset)などを使用できます。アセットは不変であり、削除できません。アセットの配信を停止するには、そのアセットを使用しているエンティティからアセットを削除してください。
フィールド | |
---|---|
resource_name |
アセットのリソース名。アセット リソース名の形式は次のとおりです。
|
type |
アセットのタイプ。 |
final_urls[] |
すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。 |
status |
アセットのステータス。 |
creation_time |
この求人が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
last_modified_time |
このアセットが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
id |
アセットの ID です。 |
name |
アセットの名前(省略可)。 |
tracking_url_template |
トラッキング URL を作成するための URL テンプレート。 |
engine_status |
アセットのエンジン ステータス。 |
共用体フィールド asset_data 。アセットの具体的なタイプ。asset_data は次のいずれかになります。 |
|
youtube_video_asset |
YouTube 動画アセット。 |
image_asset |
画像アセット。 |
text_asset |
テキスト アセット。 |
callout_asset |
統一コールアウト アセット。 |
sitelink_asset |
統合されたサイトリンク アセット。 |
page_feed_asset |
統合されたページフィード アセット。 |
mobile_app_asset |
モバイルアプリ アセット。 |
call_asset |
統一された電話番号アセットです。 |
call_to_action_asset |
行動を促すフレーズのアセット。 |
location_asset |
統合された住所アセット。 |
AssetGroup
アセット グループAssetGroupAsset は、アセットをアセット グループにリンクするために使用します。AssetGroupSignal は、シグナルをアセット グループに関連付けるために使用されます。
フィールド | |
---|---|
resource_name |
アセット グループのリソース名。アセット グループのリソース名の形式は次のとおりです。
|
id |
アセット グループの ID |
campaign |
このアセット グループが関連付けられているキャンペーン。アセット グループにリンクされているアセット。 |
name |
必須。アセット グループの名前。必須。最小文字数は 1、最大文字数は 128 です。キャンペーン内で一意である必要があります。 |
final_urls[] |
すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。P-MAX では、無効にしている場合を除き、URL はデフォルトで拡張の対象となります。 |
final_mobile_urls[] |
すべてのクロスドメイン リダイレクト後のモバイルの最終ページ URL のリスト。P-MAX では、オプトアウトしていない限り、デフォルトで URL の拡張が有効になります。 |
status |
アセット グループのステータス。 |
path1 |
広告に表示される URL に表示されるテキストの最初の部分です。 |
path2 |
広告に表示される URL に追加されるテキストの 2 番目の部分です。このフィールドは、path1 が設定されている場合にのみ設定できます。 |
ad_strength |
このアセット グループの全体的な広告の有効性。 |
AssetGroupAsset
AssetGroupAsset は、アセットとアセット グループ間のリンクです。AssetGroupAsset を追加すると、アセットとアセット グループがリンクされます。
フィールド | |
---|---|
resource_name |
アセット グループ アセットのリソース名。アセット グループのアセットのリソース名の形式:
|
asset_group |
このアセット グループのアセットがリンクしているアセット グループです。 |
asset |
このアセット グループのアセットがリンクしているアセット。 |
field_type |
アセット グループ内のアセットのプレースメントの説明。例: HEADLINE、YOUTUBE_VIDEO など |
status |
アセットとアセット グループ間のリンクのステータス。 |
AssetGroupAssetCombinationData
アセット グループのアセットの組み合わせのデータ
フィールド | |
---|---|
asset_combination_served_assets[] |
配信されたアセット。 |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter は、アセット グループ内のリスティング グループのフィルタツリーノードを表します。
フィールド | |
---|---|
resource_name |
アセット グループのリスティング グループ フィルタのリソース名。アセット グループのリスティング グループのフィルタのリソース名の形式は次のとおりです。
|
asset_group |
このアセット グループのリスティング グループ フィルタが含まれているアセット グループ。 |
id |
ListingGroupFilter の ID。 |
type |
リスティング グループのフィルタノードのタイプ。 |
vertical |
現在のノードツリーが表すカテゴリ。同じツリー内のすべてのノードは同じカテゴリに属している必要があります。 |
case_value |
このリスティング グループの親を絞り込む際のディメンション値。ルートグループに対して未定義です。 |
parent_listing_group_filter |
親リスティング グループの区分のリソース名。ルート リスティング グループのフィルタノードの null。 |
path |
このリスティング グループのフィルタを定義するディメンションのパス。 |
AssetGroupSignal
AssetGroupSignal は、アセット グループのシグナルを表します。コンバージョンが発生する可能性が最も高い P-MAX キャンペーンには、シグナルが存在するかどうかがわかります。P-MAX では、シグナルを使用して、検索、ディスプレイ、動画などのさまざまなネットワークでコンバージョンを獲得するために、購買意向が似ているユーザーや購買意向が強い新しいユーザーを探します。
フィールド | |
---|---|
resource_name |
アセット グループ シグナルのリソース名。アセット グループ シグナルのリソース名の形式:
|
asset_group |
このアセット グループのシグナルが属するアセット グループです。 |
共用体フィールド signal 。アセット グループのシグナル。signal は次のいずれかになります。 |
|
audience |
P-MAX キャンペーンで使用するオーディエンス シグナル。 |
AssetGroupTopCombinationView
広告グループの広告アセットの組み合わせの使用状況が表示されます。
フィールド | |
---|---|
resource_name |
アセット グループの最上位の組み合わせビューのリソース名。AssetGroup の上位の組み合わせビューのリソース名の形式は、「customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}」です。 |
asset_group_top_combinations[] |
一緒に配信されたアセットの上位の組み合わせ。 |
AssetSet
アセットのコレクションを表すアセットセット。AssetSetAsset を使用して、アセットをアセットセットにリンクします。
フィールド | |
---|---|
id |
アセットセットの ID。 |
resource_name |
アセットセットのリソース名。アセットセットのリソース名の形式は次のとおりです。
|
AssetSetAsset
AssetSetAsset は、アセットとアセットセット間のリンクです。AssetSetAsset を追加すると、アセットをアセットセットとリンクさせることができます。
フィールド | |
---|---|
resource_name |
アセットセット アセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。
|
asset_set |
このアセットセットのアセットがリンクしているアセットセット。 |
asset |
このアセットセットのアセットがリンクしているアセット。 |
status |
アセットセット アセットのステータス。読み取り専用です。 |
オーディエンス
オーディエンスは効果的なターゲティング オプションです。さまざまなセグメント属性(詳しいユーザー属性やアフィニティなど)を組み合わせて、ターゲット セグメントの各セクションを表すオーディエンスを作成できます。
フィールド | |
---|---|
resource_name |
オーディエンスのリソース名。オーディエンス名の形式は、次のとおりです。
|
id |
オーディエンスの ID。 |
name |
必須。オーディエンスの名前。すべてのオーディエンスで一意である必要があります。最小文字数は 1、最大文字数は 255 です。 |
description |
このオーディエンスの説明。 |
BiddingStrategy
入札戦略。
フィールド | |
---|---|
resource_name |
入札戦略のリソース名。入札戦略のリソース名の形式は次のとおりです。
|
status |
入札戦略のステータス。 このフィールドは読み取り専用です。 |
type |
入札戦略のタイプ。入札スキームを設定して入札戦略を作成します。 このフィールドは読み取り専用です。 |
currency_code |
入札戦略で使用される通貨(ISO 4217 の 3 文字のコード)。 MCC クライアントの入札戦略の場合、この通貨は作成時に設定でき、デフォルトで MCC 顧客の通貨に設定されます。サービスを提供するお客様の場合、このフィールドは設定できません。サービスを提供するお客様のすべての戦略で、そのお客様の通貨が暗黙的に使用されます。すべての場合で、effective_currency_code フィールドはこの戦略で使用されている通貨を返します。 |
id |
入札戦略の ID。 |
name |
入札戦略の名前。アカウント内のすべての入札戦略は、それぞれ別の名前にする必要があります。 この文字列の長さは UTF-8 バイトで 1~255 の値にする必要があります(切り詰められます)。 |
effective_currency_code |
入札戦略で使用される通貨(ISO 4217 の 3 文字のコード)。 クライアント センター(MCC)顧客の入札戦略の場合、これは戦略の作成時に広告主が設定した通貨です。顧客にサービスを提供する場合は、顧客の currency_code になります。 入札戦略の指標はこの通貨でレポートに表示されます。 このフィールドは読み取り専用です。 |
campaign_count |
この入札戦略に関連付けられているキャンペーンの数。 このフィールドは読み取り専用です。 |
non_removed_campaign_count |
この入札戦略に関連付けられている、削除されていないキャンペーンの数です。 このフィールドは読み取り専用です。 |
共用体フィールド 設定できるのは 1 つのみです。 |
|
enhanced_cpc |
コンバージョンにつながる可能性が高いクリックについては入札単価を引き上げ、可能性が低いと思われるクリックについては引き下げる入札戦略です。 |
maximize_conversion_value |
予算を消化しながらキャンペーンのコンバージョン値を最大化するための自動入札戦略。 |
maximize_conversions |
指定の予算を消化しつつキャンペーンのコンバージョン数を最大化できる自動入札戦略。 |
target_cpa |
指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価を設定する入札戦略。 |
target_impression_share |
選択したインプレッションの割合を重視して自動的に最適化する入札戦略。 |
target_outrank_share |
特定の競合他社よりも上位に掲載する必要があるオークションの割合に基づいて、入札単価を設定する入札戦略。このフィールドのサポートは終了しています。このフィールドで新しい入札戦略を作成したり、このフィールドを指定した入札戦略をキャンペーンに適用したりすることはできません。このスキームがすでに入力されている戦略への変更は許可されます。 |
target_roas |
特定の目標広告費用対効果(ROAS)を平均しながら収益を最大化できる入札戦略。 |
target_spend |
予算内でクリック数を最大化できるように入札単価を設定する入札戦略です。 |
キャンペーン
キャンペーン。
フィールド | |
---|---|
resource_name |
キャンペーンのリソース名。キャンペーンのリソース名の形式は次のとおりです。
|
status |
キャンペーンのステータス。 新しいキャンペーンが追加されると、ステータスはデフォルトで「有効」になります。 |
serving_status |
キャンペーンの広告配信ステータスです。 |
bidding_strategy_system_status |
キャンペーンの入札戦略のシステム ステータス。 |
ad_serving_optimization_status |
キャンペーンの広告配信の最適化ステータス。 |
advertising_channel_type |
キャンペーン内の広告のメインの配信ターゲット。ターゲティング オプションは 新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。 キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。 |
advertising_channel_sub_type |
必要に応じて キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。 |
url_custom_parameters[] |
|
real_time_bidding_setting |
リアルタイム ビッダーの設定。この機能は、Ad Exchange ネットワークをターゲットとするキャンペーンでのみご利用いただけます。 |
network_settings |
キャンペーンの掲載ネットワークの設定です。 |
dynamic_search_ads_setting |
動的検索広告(DSA)を管理するための設定。 |
shopping_setting |
ショッピング キャンペーンを管理するための設定です。 |
geo_target_type_setting |
広告の地域ターゲティングの設定。 |
labels[] |
このキャンペーンに適用されたラベルのリソース名。 |
bidding_strategy_type |
入札戦略のタイプ。 入札戦略を作成するには、標準入札戦略を作成する入札スキームを設定するか、ポートフォリオ入札戦略を作成する このフィールドは読み取り専用です。 |
accessible_bidding_strategy |
AccessibleBiddingStrategy のリソース名。「bidding_strategy」で識別される、接続されているポートフォリオ入札戦略の無制限の属性の読み取り専用ビューです。キャンペーンでポートフォリオ戦略を使用していない場合は空になります。制限のない戦略属性は、戦略を共有しているすべてのお客様が利用でき、AccessibleBiddingStrategy リソースから読み取られます。これに対して、制限付きの属性は、戦略のオーナーである顧客とそのマネージャーのみが使用できます。制限付き属性は、BidStrategy リソースからのみ読み取ることができます。 |
frequency_caps[] |
各ユーザーにこのキャンペーンの広告が表示される頻度を制限するリスト。 |
selective_optimization |
このキャンペーンの選択的最適化の設定。このキャンペーンの最適化で重視するコンバージョン アクションが含まれます。この機能は、MULTI_CHANNEL を AdvertisingChannelType として使用し、APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を AdvertisingChannelSubType として使用するアプリ キャンペーンにのみ適用されます。 |
optimization_goal_setting |
このキャンペーンの最適化目標の設定です。一連の最適化の目標タイプが含まれます。 |
tracking_setting |
トラッキング情報に関するキャンペーン単位の設定。 |
engine_id |
外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます(Yahoo! Japan、Microsoft、Baidu など)。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。 |
excluded_parent_asset_field_types[] |
このキャンペーンから除外するアセット フィールド タイプ。これらの項目タイプのアセットリンクは、このキャンペーンに上位レベルから継承されません。 |
create_time |
このキャンペーンが作成されたときのタイムスタンプ。タイムスタンプの形式は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss」です。使用できます。create_time は v1 で非推奨となります。代わりに create_time を使用してください。 |
creation_time |
このキャンペーンが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
last_modified_time |
このキャンペーンが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
id |
キャンペーンの ID です。 |
name |
キャンペーンの名前です。 新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。 null(コードポイント 0x0)、NL ラインフィード(コードポイント 0xA)、改行(コードポイント 0xD)の文字を含めることはできません。 |
tracking_url_template |
トラッキング URL を作成するための URL テンプレート。 |
campaign_budget |
キャンペーンの予算。 |
start_date |
お客様のタイムゾーンでキャンペーンが配信を開始した日付(YYYY-MM-DD 形式)。 |
end_date |
ユーザーのタイムゾーンで配信されるキャンペーンの最終日(YYYY-MM-DD 形式)。作成時にはデフォルトで 2037-12-30 に設定され、キャンペーンは無期限に実行されます。既存のキャンペーンを無期限で行うように設定するには、このフィールドを 2037-12-30 に設定します。 |
final_url_suffix |
並行トラッキングで配信されるランディング ページにクエリ パラメータを追加するために使用するサフィックス。 |
url_expansion_opt_out |
よりターゲットを絞った URL への URL の拡張を無効にすることを表します。無効(true)にすると、アセット グループの最終ページ URL、または広告主様の Google Merchant Center かビジネスデータ フィードで指定された URL のみがターゲットになります。オプトイン(false)すると、ドメイン全体がターゲットに設定されます。このフィールドは P-MAX キャンペーンでのみ設定でき、デフォルト値は false です。 |
共用体フィールド ポートフォリオ(入札戦略サービスで作成)または標準(キャンペーンに組み込まれているもの)のいずれかである必要があります。 |
|
bidding_strategy |
キャンペーンで使用されるポートフォリオ入札戦略。 |
manual_cpa |
標準の個別コンバージョン単価入札戦略。広告主が指定したアクションごとに入札単価を設定できる個別単価設定。ローカル サービス キャンペーンのみでサポートされます。 |
manual_cpc |
標準の個別クリック単価入札戦略。ユーザーがクリックごとに支払う、個別クリックベースの入札。 |
manual_cpm |
標準の個別インプレッション単価入札戦略。インプレッションに基づく手動入札。1,000 回のインプレッションごとにユーザーが支払います。 |
maximize_conversions |
予算を消化しつつコンバージョン数を自動的に最大化できる、標準の「コンバージョン数の最大化」入札戦略。 |
maximize_conversion_value |
予算を消化しつつ収益を最大化するように入札単価を自動的に設定する、標準の「コンバージョン値の最大化」入札戦略。 |
target_cpa |
標準の「目標コンバージョン単価」入札戦略では、指定した目標コンバージョン単価(CPA)でコンバージョンを最大限に獲得できるように入札単価が自動的に設定されます。 |
target_impression_share |
目標インプレッション シェア入札戦略。指定した割合のインプレッションを達成できるように入札単価を設定する自動入札戦略。 |
target_roas |
標準の目標広告費用対効果入札戦略。特定の目標広告費用対効果(ROAS)の平均値を設定しながら、収益を自動的に最大化します。 |
target_spend |
予算内でクリック数を最大化できるように入札単価を自動的に設定する、標準の目標予算入札戦略です。 |
percent_cpc |
商品やサービスの広告価格に対する割合で入札する、標準のクリック単価入札戦略。 |
target_cpm |
インプレッション単価を自動的に最適化する入札戦略。 |
DynamicSearchAdsSetting
動的検索広告(DSA)を管理するための設定。
フィールド | |
---|---|
domain_name |
必須。この設定が表すインターネット ドメイン名(例: google.com)www.google.com などです。 |
language_code |
必須。ドメインの言語を指定する言語コード(「en」など)。 |
use_supplied_urls_only |
キャンペーンで広告主提供の URL のみを使用するかどうか。 |
GeoTargetTypeSetting
広告の地域ターゲティングに関連する設定のコレクションを表します。
フィールド | |
---|---|
positive_geo_target_type |
この特定のキャンペーンで非除外の地域ターゲティングに使用される設定です。 |
negative_geo_target_type |
この特定のキャンペーンの除外地域ターゲティングに使用される設定です。 |
NetworkSettings
キャンペーンの掲載ネットワークの設定です。
フィールド | |
---|---|
target_google_search |
google.com の検索結果に広告を掲載するかどうか。 |
target_search_network |
Google 検索ネットワークのパートナー サイトに広告を配信するかどうか( |
target_content_network |
Google ディスプレイ ネットワークの指定したプレースメントに広告を配信するかどうか。プレースメントは、プレースメント条件で指定します。 |
target_partner_search_network |
Google パートナー ネットワークで広告を配信するかどうか。この機能は、一部の Google パートナー アカウントでのみご利用いただけます。 |
OptimizationGoalSetting
このキャンペーンの最適化目標の設定です。一連の最適化の目標タイプが含まれます。
フィールド | |
---|---|
optimization_goal_types[] |
最適化の目標タイプのリスト。 |
SelectiveOptimization
このキャンペーンの選択的最適化の設定。このキャンペーンの最適化で重視するコンバージョン アクションが含まれます。この機能は、MULTI_CHANNEL を AdvertisingChannelType として使用し、APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を AdvertisingChannelSubType として使用するアプリ キャンペーンにのみ適用されます。
フィールド | |
---|---|
conversion_actions[] |
このキャンペーンを最適化するために選択したコンバージョン アクションのセット。 |
ShoppingSetting
ショッピング キャンペーンの設定。キャンペーンで宣伝できる商品全体と、このキャンペーンが他のショッピング キャンペーンとどのように相互作用するかを定義します。
フィールド | |
---|---|
feed_label |
キャンペーンに含める商品のフィードラベル。設定できるのは、feed_label または sales_country のみです。sales_country の代わりに、feed_label フィールドには、同じ形式の国コードを指定できます(「XX」など)。それ以外の場合は、Google Merchant Center のフィードラベルに使用する任意の文字列を指定できます。 |
use_vehicle_inventory |
車両リスティングの広告枠をターゲットに設定するかどうか。 |
merchant_id |
Merchant Center アカウントの ID。このフィールドは、作成オペレーションに必要です。ショッピング キャンペーンの場合、このフィールドは変更できません。 |
sales_country |
キャンペーンに含める商品の販売国。 |
campaign_priority |
キャンペーンの優先順位。優先度の数値が高いキャンペーンは、優先度の低いキャンペーンよりも優先されます。このフィールドはショッピング キャンペーンに必須で、値の範囲は 0 ~ 2 です。スマート ショッピング キャンペーンの場合、このフィールドは省略可能ですが、設定する場合は 3 に設定する必要があります。 |
enable_local |
ローカル商品を含めるかどうかを指定します。 |
TrackingSetting
トラッキング情報に関するキャンペーン単位の設定。
フィールド | |
---|---|
tracking_url |
動的トラッキングに使用する URL。 |
CampaignAsset
キャンペーンとアセット間のリンク。
フィールド | |
---|---|
resource_name |
キャンペーン アセットのリソース名。CampaignAsset リソース名の形式は次のとおりです。
|
status |
キャンペーン アセットのステータス。 |
campaign |
アセットがリンクされているキャンペーン。 |
asset |
キャンペーンにリンクされているアセット。 |
CampaignAssetSet
CampaignAssetSet はキャンペーンとアセットセット間のリンクです。CampaignAssetSet を追加すると、アセットセットとキャンペーンがリンクされます。
フィールド | |
---|---|
resource_name |
キャンペーンのアセットセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。
|
campaign |
このアセットセットがリンクされているキャンペーン。 |
asset_set |
キャンペーンにリンクされているアセットセット。 |
status |
キャンペーンのアセットセットのアセットのステータス。読み取り専用です。 |
CampaignAudienceView
キャンペーンのオーディエンス ビュー。ディスプレイ ネットワーク広告と YouTube ネットワーク広告のインタレストとリマーケティング リスト、検索広告向けリマーケティング リスト(RLSA)について、キャンペーンやオーディエンスの条件ごとに集計した掲載結果データが含まれます。このビューには、キャンペーン単位で設定されたオーディエンスのみが含まれます。
フィールド | |
---|---|
resource_name |
キャンペーン オーディエンス ビューのリソース名。キャンペーンのオーディエンス ビューのリソース名の形式は次のとおりです。
|
CampaignBudget
キャンペーンの予算
フィールド | |
---|---|
resource_name |
キャンペーン予算のリソース名。キャンペーン予算のリソース名の形式は次のとおりです。
|
delivery_method |
キャンペーン予算が消費される割合を決定する配信方法。 作成オペレーションで指定しない場合のデフォルトは STANDARD です。 |
period |
予算を消化する期間です。指定しない場合のデフォルトは DAILY です。 |
amount_micros |
アカウントに対する現地通貨での予算額。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。1 か月の費用の上限はこの金額の 30.4 倍です。 |
CampaignCriterion
キャンペーンの条件です。
フィールド | |
---|---|
resource_name |
キャンペーンの条件のリソース名。キャンペーンの条件のリソース名の形式は次のとおりです。
|
display_name |
条件の表示名。 このフィールドはミューテーションの場合は無視されます。 |
type |
条件のタイプ。 |
status |
条件のステータス。 |
last_modified_time |
このキャンペーン条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
criterion_id |
条件の ID。 このフィールドは変更時に無視されます。 |
bid_modifier |
条件が一致した場合の入札の修飾子。修飾子は 0.1 ~ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。デバイスタイプをオプトアウトするには、0 を使用します。 |
negative |
条件をターゲティング( |
共用体フィールド 1 つのみを設定する必要があります。 |
|
keyword |
キーワード。 |
location |
位置情報] をタップします。 |
device |
デバイス] など)を選択します。 |
age_range |
年齢層。 |
gender |
性別。 |
user_list |
ユーザーリスト。 |
language |
学びました。 |
webpage |
ウェブページ。 |
location_group |
地域グループ |
CampaignLabel
キャンペーンとラベルの関係を表します。
フィールド | |
---|---|
resource_name |
リソースの名前。キャンペーン ラベルのリソース名の形式: |
campaign |
ラベルが添付されるキャンペーン。 |
label |
キャンペーンに割り当てられるラベル。 |
CartDataSalesView
カートデータの販売ビュー。
フィールド | |
---|---|
resource_name |
カートデータの販売ビューのリソース名。カートデータの販売ビューのリソース名の形式は |
コンバージョン
コンバージョン。
フィールド | |
---|---|
resource_name |
コンバージョンのリソース名。コンバージョン リソース名の形式は次のとおりです。
|
id |
コンバージョンの ID |
criterion_id |
検索広告 360 の条件 ID。値 0 は、その条件が関連付けられていないことを示します。 |
merchant_id |
クリックされた商品を含む検索広告 360 在庫アカウント ID。検索広告 360 内で在庫アカウントをリンクすると、検索広告 360 でこの ID が生成されます。 |
ad_id |
広告 ID。値 0 は、広告が関連付けられていないことを示します。 |
click_id |
コンバージョンが関連付けられている訪問の一意の文字列で、click id という URL パラメータとしてランディング ページに渡されます。 |
visit_id |
コンバージョンが関連付けられた検索広告 360 の訪問 ID。 |
advertiser_conversion_id |
オフライン コンバージョンの場合は、広告主が提供する ID です。このような ID が広告主から指定されていない場合、検索広告 360 によって生成されます。オンライン コンバージョンの場合は、広告主の Floodlight 処理に応じて、id 列または floodlight_order_id 列と同じになります。 |
product_id |
クリックされた商品の ID。 |
product_channel |
クリックされた商品の販売チャネル: オンラインまたはローカル。 |
product_language_code |
商品に関するデータを含む Merchant Center フィードに設定されている言語(ISO-639-1)。 |
product_store_id |
クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。 |
product_country_code |
クリックされた商品を含む在庫フィードに登録されている国(ISO-3166 形式)。 |
attribution_type |
コンバージョンが関連付けられた要素: 「訪問」または「キーワード + 広告」。 |
conversion_date_time |
コンバージョン イベントのタイムスタンプ。 |
conversion_last_modified_date_time |
コンバージョンが最後に変更された時刻のタイムスタンプ。 |
conversion_visit_date_time |
コンバージョンが関連付けられた訪問のタイムスタンプ。 |
conversion_quantity |
コンバージョンで記録されたアイテムの数量で、qty という URL パラメータによって特定されます。広告主がパラメータ(コンバージョンで販売されたアイテム数など)を動的に入力する必要がありますが、入力しない場合、デフォルトで 1 になります。 |
conversion_revenue_micros |
コンバージョン イベントの調整された収益(マイクロ秒単位)。これは常に広告配信中アカウントの通貨で表示されます。 |
floodlight_original_revenue |
Floodlight 通貨指示の変更前の、Floodlight イベントに関連付けられた、変更されていない元の収益(現在のレポートの通貨)。 |
floodlight_order_id |
コンバージョンに関して広告主から提供された Floodlight オーダー ID。 |
status |
コンバージョンのステータス(ENABLED または REMOVED) |
asset_id |
コンバージョン イベント中に接点があったアセットの ID。 |
asset_field_type |
コンバージョン イベントのアセット フィールド タイプ。 |
ConversionAction
コンバージョン アクション。
フィールド | |
---|---|
resource_name |
コンバージョン アクションのリソース名。コンバージョン アクションのリソース名の形式は次のとおりです。
|
creation_time |
Floodlight アクティビティの作成時点のタイムスタンプ(ISO 8601 形式)。 |
status |
コンバージョン イベントの発生に関するこのコンバージョン アクションのステータス。 |
type |
このコンバージョン アクションのタイプ。 |
category |
このコンバージョン アクションについてレポートされたコンバージョンのカテゴリ。 |
value_settings |
このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関連する設定。 |
attribution_model_settings |
このコンバージョン アクションのアトリビューション モデルに関連する設定です。 |
floodlight_settings |
Floodlight コンバージョン タイプの Floodlight 設定。 |
id |
コンバージョン アクションの ID。 |
name |
コンバージョン アクションの名前。 新しいコンバージョン アクションを作成する場合は、このフィールドは必須です。空にすることはできません。 |
primary_for_goal |
コンバージョン アクションの primary_for_goal ビットが false の場合、顧客のコンバージョン目標やキャンペーンのコンバージョン目標に関係なく、そのコンバージョン アクションはすべてのキャンペーンで入札できません。ただし、カスタム コンバージョン目標では primary_for_goal が考慮されないため、キャンペーンで primary_for_goal = false コンバージョン アクションのカスタム コンバージョン目標が設定されている場合、そのコンバージョン アクションは入札対象となります。デフォルトでは、設定しない場合、primary_for_goal が true になります。V9 では、primary_for_goal を false に設定できるのは「update」で作成された後のみです。オプションとして宣言されていないためです。 |
owner_customer |
コンバージョン アクションのオーナーである顧客のリソース名。システム定義のコンバージョン アクションの場合は null。 |
include_in_client_account_conversions_metric |
このコンバージョン アクションを [client_account_conversions] に含めるかどうか表示されます。 |
include_in_conversions_metric |
このコンバージョン アクションを [コンバージョン] に含めるかどうか表示されます。 |
click_through_lookback_window_days |
インタラクション(クリックなど)からコンバージョン イベントの発生までの最大日数。 |
app_id |
アプリ コンバージョン アクションのアプリ ID。 |
AttributionModelSettings
このコンバージョン アクションのアトリビューション モデルに関連する設定です。
フィールド | |
---|---|
attribution_model |
このコンバージョン アクションのアトリビューション モデルタイプ。 |
data_driven_model_status |
コンバージョン アクションのデータドリブン アトリビューション モデルのステータス。 |
FloodlightSettings
Floodlight コンバージョン アクションに関連する設定。
フィールド | |
---|---|
activity_group_tag |
コンバージョンのレポート時に Floodlight アクティビティ グループの識別に使用される文字列。 |
activity_tag |
コンバージョンのレポート時に Floodlight アクティビティを識別するために使用される文字列。 |
activity_id |
DoubleClick Campaign Manager(DCM)の Floodlight アクティビティの ID。 |
ValueSettings
このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関連する設定。
フィールド | |
---|---|
default_value |
このコンバージョン アクションのコンバージョン イベントが無効な値、許可されていない値、または欠落している値とともに送信された場合、またはこのコンバージョン アクションが常にデフォルト値を使用するように設定されている場合に使用する値です。 |
default_currency_code |
このコンバージョン アクションのコンバージョン イベントが送信されたときに通貨コードが無効であるか、通貨コードが含まれていない場合、またはこのコンバージョン アクションが常にデフォルト値を使用するように設定されている場合に使用する通貨コード。 |
always_use_default_value |
このコンバージョン アクションのコンバージョン イベントで指定された値と通貨コードの代わりに、デフォルト値とデフォルトの通貨コードを使用するかどうかを指定します。 |
ConversionCustomVariable
コンバージョン カスタム変数。「検索広告 360 リニューアル版のカスタム Floodlight の指標とディメンションについて」をご覧くださいhttps://support.google.com/sa360/answer/13567857
フィールド | |
---|---|
resource_name |
コンバージョン カスタム変数のリソース名。コンバージョン カスタム変数のリソース名の形式は次のとおりです。
|
id |
コンバージョン カスタム変数の ID。 |
name |
必須。コンバージョン カスタム変数の名前。一意の名前にしてください。名前の最大長は 100 文字です。前後に余分なスペースを入れないでください。 |
tag |
必須。コンバージョン カスタム変数のタグ。タグは一意で、「u」で構成されている必要がありますその直後に 100 以下の数字が続きます。例: 「u4」。 |
status |
コンバージョン イベントの発生に関するコンバージョン カスタム変数のステータス。 |
owner_customer |
コンバージョン カスタム変数を所有する顧客のリソース名。 |
family |
コンバージョン カスタム変数のファミリー。 |
cardinality |
コンバージョン カスタム変数の基数。 |
floodlight_conversion_custom_variable_info |
検索広告 360 Floodlight コンバージョン カスタム変数のフィールド。 |
custom_column_ids[] |
このコンバージョン カスタム変数を使用するカスタム列の ID。 |
FloodlightConversionCustomVariableInfo
検索広告 360 の Floodlight コンバージョン カスタム変数に関する情報
フィールド | |
---|---|
floodlight_variable_type |
検索広告 360 で定義された Floodlight 変数タイプ。 |
floodlight_variable_data_type |
検索広告 360 で定義されている Floodlight 変数のデータ型。 |
ConversionTrackingSetting
検索広告 360 のコンバージョン トラッキングに関連する、顧客全体の設定のコレクション。
フィールド | |
---|---|
accepted_customer_data_terms |
お客様が顧客データに関する規約に同意したかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC アカウントから継承されます。このフィールドは読み取り専用です。詳しくは、https://support.google.com/adspolicy/answer/7475709 をご覧ください。 |
conversion_tracking_status |
コンバージョン トラッキングのステータス。顧客がコンバージョン トラッキングを使用しているかどうか、またこの顧客のコンバージョン トラッキングの所有者は誰なのかが表示されます。この顧客がクロスアカウント コンバージョン トラッキングを使用している場合、返される値はリクエストの |
enhanced_conversions_for_leads_enabled |
お客様がリードの拡張コンバージョンを有効にしているかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値は MCC アカウントから継承されます。このフィールドは読み取り専用です。 |
google_ads_conversion_customer |
コンバージョンの作成と管理が行われる顧客のリソース名。このフィールドは読み取り専用です。 |
conversion_tracking_id |
このアカウントで使用されているコンバージョン トラッキング ID。この ID は、顧客がコンバージョン トラッキングを使用しているかどうかを示すものではありません(conversion_tracking_status は使用します)。このフィールドは読み取り専用です。 |
google_ads_cross_account_conversion_tracking_id |
顧客の管理者のコンバージョン トラッキング ID。顧客がコンバージョン トラッキングを有効にした場合に設定され、conversion_tracking_id をオーバーライドします。この項目は Google 広告の管理画面でのみ管理できます。このフィールドは読み取り専用です。 |
cross_account_conversion_tracking_id |
顧客の管理者のコンバージョン トラッキング ID。これは、顧客がクロスアカウント コンバージョン トラッキングを有効にした場合に設定され、conversion_tracking_id をオーバーライドします。 |
CustomColumn
カスタム列。検索広告 360 のカスタム列について詳しくは、https://support.google.com/sa360/answer/9633916 をご覧ください。
フィールド | |
---|---|
resource_name |
カスタム列のリソース名。カスタム列のリソース名の形式は次のとおりです。
|
id |
カスタム列の ID です。 |
name |
カスタム列のユーザー定義の名前。 |
description |
カスタム列に関するユーザー定義の説明です。 |
value_type |
カスタム列の結果値の型。 |
references_attributes |
カスタム列が 1 つ以上の属性を参照している場合は true。 |
references_metrics |
カスタム列が 1 つ以上の指標を参照している場合は true。 |
queryable |
カスタム列が SearchAds360Service.Search と SearchAds360Service.SearchStream のクエリで使用できる場合は true。 |
referenced_system_columns[] |
このカスタム列の参照システム列のリストです。(例: 「インプレッション数とクリック数の合計」カスタム列)は {"metrics.clicks", "metrics.impressions"} のシステム列を参照しています。 |
顧客
お客様です。
フィールド | |
---|---|
resource_name |
顧客のリソース名。顧客のリソース名の形式は次のとおりです。
|
conversion_tracking_setting |
顧客のコンバージョン トラッキング設定。 |
account_type |
エンジン アカウント タイプ(Google 広告、Microsoft Advertising、Yahoo! JAPAN、Baidu、Facebook、エンジン トラッキングなど) |
double_click_campaign_manager_setting |
DoubleClick Campaign Manager(DCM)の設定です。 |
account_status |
アカウントのステータス(有効、一時停止、削除済みなど)。 |
last_modified_time |
この顧客が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
engine_id |
外部エンジン アカウントのアカウント ID。 |
status |
顧客のステータス。 |
creation_time |
この顧客が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
id |
顧客の ID。 |
descriptive_name |
顧客の一意でないわかりやすい名前(省略可)。 |
currency_code |
アカウントが運用されている通貨。ISO 4217 標準の通貨コードのサブセットがサポートされています。 |
time_zone |
顧客のローカル タイムゾーン ID。 |
tracking_url_template |
パラメータからトラッキング URL を作成するための URL テンプレート。 |
final_url_suffix |
パラメータを最終ページ URL に追加するための URL テンプレート。 |
auto_tagging_enabled |
ユーザーに対して自動タグ設定が有効になっているかどうか。 |
manager |
お客様がマネージャーであるかどうか |
CustomerAsset
顧客とアセット間のリンク。
フィールド | |
---|---|
resource_name |
顧客アセットのリソース名。CustomerAsset リソース名の形式は次のとおりです。
|
asset |
必須。顧客に関連付けられているアセット。 |
status |
お客様のアセットのステータス。 |
CustomerAssetSet
CustomerAssetSet はお客様とアセットセット間のリンクです。CustomerAssetSet を追加すると、アセットセットがお客様とリンクされます。
フィールド | |
---|---|
resource_name |
顧客アセットセットのリソース名。アセットセットのアセット リソース名の形式は次のとおりです。
|
asset_set |
顧客に関連付けられているアセットセット。 |
customer |
このアセットセットがリンクされている顧客。 |
status |
お客様のアセットセット アセットのステータス。読み取り専用です。 |
CustomerClient
特定の顧客とクライアントの顧客間のリンク。CustomerClient は、マネージャーのお客様専用です。直接的および間接的なクライアントのすべての顧客と、マネージャー自体が含まれます。
フィールド | |
---|---|
resource_name |
顧客クライアントのリソース名。CustomerClient リソース名の形式は |
applied_labels[] |
クライアントの顧客に適用され、リクエスト元の顧客が所有するラベルのリソース名。ラベルリソース名の形式は次のとおりです。
|
status |
クライアントの顧客のステータス。読み取り専用。 |
client_customer |
特定の顧客にリンクされている顧客顧客のリソース名。読み取り専用。 |
level |
対象の顧客と顧客の距離セルフリンクの場合、レベルの値は 0 です。読み取り専用。 |
time_zone |
クライアントのタイムゾーンを表す Common Locale Data Repository(CLDR)文字列表現(America/Los_Angeles など)。読み取り専用。 |
test_account |
クライアントがテスト アカウントかどうかを示します。読み取り専用。 |
manager |
クライアントがマネージャーかどうかを識別します。読み取り専用。 |
descriptive_name |
クライアントのわかりやすい名前です。読み取り専用。 |
currency_code |
クライアントの通貨コード(「USD」、「EUR」など)。読み取り専用。 |
id |
クライアントのお客様の ID。読み取り専用。 |
CustomerManagerLink
顧客と MCC のリンク関係を表します。
フィールド | |
---|---|
resource_name |
リソースの名前。CustomerManagerLink のリソース名の形式は |
status |
お客様とマネージャー間のリンクのステータス。 |
manager_customer |
顧客にリンクされている MCC 顧客。 |
manager_link_id |
顧客と MCC アカウントのリンクの ID。このフィールドは読み取り専用です。 |
start_time |
CustomerManagerLink が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
DoubleClickCampaignManagerSetting
DoubleClick Campaign Manager(DCM)の設定です。
フィールド | |
---|---|
advertiser_id |
この顧客に関連付けられているキャンペーン マネージャー 広告主の ID。 |
network_id |
この顧客に関連付けられているキャンペーン マネージャー ネットワークの ID。 |
time_zone |
この顧客に関連付けられているキャンペーン マネージャー ネットワークのタイムゾーン。IANA タイムゾーン データベース形式(America/New_York など)で指定します。 |
DynamicSearchAdsSearchTermView
動的検索広告の検索語句ビュー。
フィールド | |
---|---|
resource_name |
動的検索広告の検索語句ビューのリソース名。動的検索広告の検索語句ビューのリソース名の形式は次のとおりです。
|
landing_page |
動的に選択されたインプレッションのランディング ページ URL。 このフィールドは読み取り専用です。 |
GenderView
性別のビュー。gender_view リソースは、追加された条件ではなく、有効なサービス提供状態を反映しています。性別の条件がない広告グループは、デフォルトですべての性別で表示されるため、すべての性別が統計情報とともに gender_view に表示されます。
フィールド | |
---|---|
resource_name |
性別ビューのリソース名。性別ビューのリソース名の形式は次のとおりです。
|
GeoTargetConstant
地域ターゲティングの定数。
フィールド | |
---|---|
resource_name |
地域ターゲティング定数のリソース名。地域ターゲティングの定数リソース名の形式は次のとおりです。
|
status |
地域ターゲティングの定数ステータスです。 |
id |
地域ターゲティング定数の ID です。 |
name |
地域ターゲティングの英語の表記(固定表示)。 |
country_code |
ターゲット地域に関連付けられる国コード(ISO-3166-1 alpha-2)です。 |
target_type |
地域ターゲティングの定数ターゲット タイプ。 |
canonical_name |
ターゲットの名前と、その地域が属する親地域と国の名前で構成される英語の完全修飾名。 |
parent_geo_target |
親の地域ターゲティング定数のリソース名。地域ターゲティングの定数リソース名の形式は次のとおりです。
|
KeywordView
キーワード ビュー。
フィールド | |
---|---|
resource_name |
キーワード ビューのリソース名。キーワード ビューのリソース名の形式は次のとおりです。
|
ラベル
ラベル。
フィールド | |
---|---|
resource_name |
リソースの名前。ラベルのリソース名の形式は |
status |
ラベルのステータス。読み取り専用。 |
text_label |
色付きの背景にテキストを表示するラベルの一種。 |
id |
ラベルの ID。読み取り専用。 |
name |
ラベルの名前。 新しいラベルを作成する場合は、このフィールドは必須です。空にすることはできません。 この文字列の長さは 1~80 で指定します。 |
LanguageConstant
言語。
フィールド | |
---|---|
resource_name |
言語定数のリソース名。言語定数リソース名の形式は次のとおりです。
|
id |
言語定数の ID。 |
code |
言語コード(「en_US」、「en_AU」、「es」、「fr」など)。 |
name |
英語の正式名称(「英語(米国)」「スペイン語」など)。 |
targetable |
言語がターゲットに設定できるかどうか。 |
ListingGroupFilterDimension
アセット グループのリスティング グループ フィルタのリスティング ディメンション。
フィールド | |
---|---|
共用体フィールド dimension 。以下のいずれかのタイプのディメンションが常に存在します。dimension は次のいずれかになります。 |
|
product_bidding_category |
商品情報の入札カテゴリ。 |
product_brand |
商品情報のブランド。 |
product_channel |
商品情報の地域区分。 |
product_condition |
商品の状態。 |
product_custom_attribute |
商品情報のカスタム属性。 |
product_item_id |
商品情報の商品アイテム ID。 |
product_type |
商品情報のタイプ。 |
ProductBiddingCategory
特定のレベルの入札カテゴリの 1 つの要素です。最上位のカテゴリがレベル 1、その子がレベル 2 というように続きます。現時点では、最大 5 つのレベルがサポートされています。ユーザーは、カテゴリのレベルを示すディメンション タイプを指定する必要があります。同じ区分のケースはすべて、同じディメンション タイプ(カテゴリレベル)にする必要があります。
フィールド | |
---|---|
level |
分類のカテゴリのレベルを示します。 |
id |
商品の入札カテゴリの ID。 この ID は、次の記事で説明されている google_product_category ID に相当します。詳しくは、https://support.google.com/merchants/answer/6324436 をご覧ください。 |
ProductBrand
商品のブランド。
フィールド | |
---|---|
value |
商品ブランドの文字列値。 |
ProductChannel
商品情報の地域区分。
フィールド | |
---|---|
channel |
地域区分の値。 |
ProductCondition
商品の状態。
フィールド | |
---|---|
condition |
条件の値。 |
ProductCustomAttribute
商品情報のカスタム属性。
フィールド | |
---|---|
index |
カスタム属性のインデックスを示します。 |
value |
商品のカスタム属性の文字列値。 |
ProductItemId
商品情報の商品アイテム ID。
フィールド | |
---|---|
value |
ID の値。 |
ProductType
商品情報のタイプ。
フィールド | |
---|---|
level |
型のレベル。 |
value |
型の値。 |
ListingGroupFilterDimensionPath
リスティング グループのフィルタを定義するディメンションを定義するパス。
フィールド | |
---|---|
dimensions[] |
リスティング グループのフィルタ階層(ルートノードを除く)から、このリスティング グループ フィルタまでのディメンションの完全なパス。 |
LocationView
地域ビューには、地域条件別のキャンペーンのパフォーマンスの概要が表示されます。
フィールド | |
---|---|
resource_name |
ビジネス ビューのリソース名。ロケーション ビューのリソース名の形式は次のとおりです。
|
ProductBiddingCategoryConstant
商品の入札カテゴリ。
フィールド | |
---|---|
resource_name |
商品入札カテゴリのリソース名。商品入札カテゴリのリソース名の形式は次のとおりです。
|
level |
商品の入札カテゴリのレベル。 |
status |
商品の入札カテゴリのステータス。 |
id |
商品の入札カテゴリの ID。 この ID は google_product_category ID に相当します(詳しくは https://support.google.com/merchants/answer/6324436 をご覧ください)。 |
country_code |
商品の入札カテゴリの 2 文字の大文字の国コード。 |
product_bidding_category_constant_parent |
親の商品の入札カテゴリのリソース名。 |
language_code |
商品の入札カテゴリの言語コードです。 |
localized_name |
言語コードに従ってローカライズされた商品の入札カテゴリの値を表示します。 |
ProductGroupView
商品グループビュー。
フィールド | |
---|---|
resource_name |
商品グループビューのリソース名。商品グループビューのリソース名の形式は次のとおりです。
|
SearchAds360Field
SearchAds360Service で使用されるフィールドまたはリソース(アーティファクト)。
フィールド | |
---|---|
resource_name |
アーティファクトのリソース名。アーティファクト リソース名の形式は次のとおりです。
|
category |
アーティファクトのカテゴリ。 |
selectable_with[] |
記述されたアーティファクトで選択可能なすべてのリソース、セグメント、指標の名前。 |
attribute_resources[] |
記述されたアーティファクトで選択可能なすべてのリソースの名前。検索クエリに含まれている場合、これらのリソースのフィールドは指標を分割されません。 このフィールドは、カテゴリが RESOURCE のアーティファクトにのみ設定されます。 |
metrics[] |
このフィールドには、記述されたアーティファクトが FROM 句で使用されているときに、そのアーティファクトで選択可能なすべての指標の名前がリストされます。カテゴリが RESOURCE のアーティファクトにのみ設定されます。 |
segments[] |
このフィールドには、セグメントか別のリソースかを問わず、検索クエリに含まれ、記述されたアーティファクトが FROM 句で使用されるときに指標をセグメント化するすべてのアーティファクトの名前がリストされます。カテゴリが RESOURCE のアーティファクトにのみ設定されます。 |
enum_values[] |
ENUM 型のフィールドの場合にアーティファクトが仮定できる値。 このフィールドは、カテゴリ SEGMENT または ATTRIBUTE のアーティファクトにのみ設定されます。 |
data_type |
このフィールドにより、WHERE 句でアーティファクトで使用できる演算子が決まります。 |
name |
アーティファクトの名前。 |
selectable |
検索クエリの SELECT 句でアーティファクトを使用できるかどうか。 |
filterable |
検索クエリの WHERE 句でアーティファクトを使用できるかどうか。 |
sortable |
検索クエリの ORDER BY 句でアーティファクトを使用できるかどうか。 |
type_url |
アーティファクトのデータ型を記述する proto の URL。 |
is_repeated |
フィールド アーティファクトが繰り返されているかどうか。 |
ShoppingPerformanceView
ショッピングのパフォーマンス ビュー。複数の商品ディメンション レベルで集計されたショッピング キャンペーンの統計情報が表示されます。ブランド、カテゴリ、カスタム属性、商品の状態、商品カテゴリといった Merchant Center の商品ディメンションの値には、対応するイベントが記録された日時における各ディメンションの状態が反映されます。
フィールド | |
---|---|
resource_name |
ショッピングのパフォーマンス ビューのリソース名。ショッピングのパフォーマンス ビューのリソース名の形式は、 |
UserList
ユーザーリスト。これは、お客様がターゲットにできるユーザーのリストです。
フィールド | |
---|---|
resource_name |
ユーザーリストのリソース名。ユーザーリストのリソース名の形式は次のとおりです。
|
type |
このリストのタイプ。 このフィールドは読み取り専用です。 |
id |
ユーザーリストの ID。 |
name |
このユーザー リストの名前。access_reason によっては、ユーザーリスト名が一意でない場合があります(access_reason=SHARED の場合など)。 |
アクセス
1 回の訪問です。
フィールド | |
---|---|
resource_name |
訪問のリソース名。訪問リソース名の形式は次のとおりです。
|
id |
訪問の ID。 |
criterion_id |
Search Ads 360 キーワード ID。値 0 は、キーワードが関連付けられていないことを示します。 |
merchant_id |
クリックされた商品を含む検索広告 360 在庫アカウント ID。検索広告 360 内で在庫アカウントをリンクすると、検索広告 360 でこの ID が生成されます。 |
ad_id |
広告 ID。値 0 は、広告が関連付けられていないことを示します。 |
click_id |
クリック ID URL パラメータとしてランディング ページに渡される、訪問ごとの一意の文字列。 |
visit_date_time |
訪問イベントのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
product_id |
クリックされた商品の ID。 |
product_channel |
クリックされた商品の販売チャネル: オンラインまたはローカル。 |
product_language_code |
商品に関するデータを含む Merchant Center フィードに設定されている言語(ISO-639-1)。 |
product_store_id |
クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。 |
product_country_code |
クリックされた商品を含む在庫フィードに登録されている国(ISO-3166 形式)。 |
asset_id |
訪問イベント中に接点があったアセットの ID。 |
asset_field_type |
訪問イベントのアセット フィールド タイプ。 |
WebpageView
ウェブページ ビュー。
フィールド | |
---|---|
resource_name |
ウェブページ ビューのリソース名。ウェブページビューのリソース名の形式は次のとおりです。
|