インデックス
AccessibleBiddingStrategy(メッセージ)AccessibleBiddingStrategy.MaximizeConversionValue(メッセージ)AccessibleBiddingStrategy.MaximizeConversions(メッセージ)AccessibleBiddingStrategy.TargetCpa(メッセージ)AccessibleBiddingStrategy.TargetImpressionShare(メッセージ)AccessibleBiddingStrategy.TargetRoas(メッセージ)AccessibleBiddingStrategy.TargetSpend(メッセージ)Ad(メッセージ)AdGroup(メッセージ)AdGroupAd(メッセージ)AdGroupAdEffectiveLabel(メッセージ)AdGroupAdLabel(メッセージ)AdGroupAsset(メッセージ)AdGroupAssetSet(メッセージ)AdGroupAudienceView(メッセージ)AdGroupBidModifier(メッセージ)AdGroupCriterion(メッセージ)AdGroupCriterion.PositionEstimates(メッセージ)AdGroupCriterion.QualityInfo(メッセージ)AdGroupCriterionEffectiveLabel(メッセージ)AdGroupCriterionLabel(メッセージ)AdGroupEffectiveLabel(メッセージ)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(メッセージ)CampaignEffectiveLabel(メッセージ)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(メッセージ)UserLocationView(メッセージ)Visit(メッセージ)WebpageView(メッセージ)
AccessibleBiddingStrategy
お客様が所有し、共有している入札戦略のビューを表します。
BiddingStrategy とは対照的に、このリソースには、このお客様が所有する戦略に加えて、お客様のマネージャーが所有し、このお客様と共有している戦略が含まれます。このリソースは指標を提供せず、BiddingStrategy 属性の限定されたサブセットのみを公開します。
| フィールド | |
|---|---|
resource_name |
アクセス可能な入札戦略のリソース名。AccessibleBiddingStrategy リソース名の形式は次のとおりです。
|
id |
入札戦略の ID。 |
name |
入札戦略の名前。 |
type |
入札戦略のタイプ。 |
owner_customer_id |
入札戦略を所有するお客様の ID。 |
owner_descriptive_name |
入札戦略を所有するお客様の descriptive_name。 |
共用体フィールド 設定できるのは 1 つだけです。 |
|
maximize_conversion_value |
予算を消化しながらキャンペーンのコンバージョン値を最大化する自動入札戦略。 |
maximize_conversions |
予算を消化しながらキャンペーンで最大限のコンバージョン数が得られるようにする自動入札戦略。 |
target_cpa |
指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が調整される入札戦略です。 |
target_impression_share |
選択したインプレッションの割合に向けて自動的に最適化する入札戦略。 |
target_roas |
特定の目標広告費用対効果(ROAS)の平均値を達成しながら、収益の最大化を図る入札戦略。 |
target_spend |
予算内でクリック数を最大化できるように入札単価を設定する入札戦略。 |
MaximizeConversionValue
予算を消化しながらキャンペーンのコンバージョン値を最大化する自動入札戦略。
| フィールド | |
|---|---|
target_roas |
目標広告費用対効果(LTV)オプション。設定した場合、入札戦略では目標広告費用対効果を平均化しながら、収益を最大化します。目標広告費用対効果が高い場合、入札戦略では予算全額を使用できない可能性があります。目標広告費用対効果が設定されていない場合、入札戦略では予算に対して可能な限り高い広告費用対効果を達成することを目指します。 |
MaximizeConversions
予算を消化しながらキャンペーンで最大限のコンバージョン数が得られるようにする自動入札戦略。
| フィールド | |
|---|---|
target_cpa |
目標コンバージョン単価(CPA)オプション。これは、1 件の獲得あたりに費やしたい平均額です。 |
target_cpa_micros |
目標コンバージョン単価(CPA)オプション。これは、1 件の獲得あたりに費やしたい平均額です。 |
TargetCpa
指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が調整される自動入札戦略です。
| フィールド | |
|---|---|
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 のリスト。 |
final_app_urls[] |
特定のアプリがインストールされている場合にモバイルで使用される、アプリの最終リンク先 URL のリスト。 |
final_mobile_urls[] |
広告のすべてのクロスドメイン リダイレクトの後に可能性のあるモバイルの最終ページ URL のリスト。 |
type |
広告タイプ。 |
id |
広告の ID です。 |
tracking_url_template |
トラッキング URL を作成するための URL テンプレート。 |
final_url_suffix |
最終ページ URL の作成時に使用するサフィックス。 |
display_url |
一部の広告フォーマットの広告説明に表示される URL。 |
name |
広告の名前。広告を識別するためにのみ使用されます。一意である必要はなく、配信される広告には影響しません。 |
共用体フィールド 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[] |
この広告グループに適用されているラベルのリソース名。 |
effective_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)の文字を含めることはできません。 |
tracking_url_template |
トラッキング URL を作成するための URL テンプレート。 |
cpc_bid_micros |
最大 CPC(クリック単価)入札。 |
engine_status |
広告グループのエンジン ステータス。 |
final_url_suffix |
パラメータを最終ページ URL に追加するための URL テンプレート。 |
AdGroupAd
広告グループの広告。
| フィールド | |
|---|---|
resource_name |
広告のリソース名。広告グループ広告のリソース名の形式は次のとおりです。
|
status |
広告のステータスです。 |
ad |
広告。 |
creation_time |
この ad_group_ad が作成されたときのタイムスタンプ。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
labels[] |
この広告グループの広告に適用されているラベルのリソース名。 |
effective_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」形式です。 |
AdGroupAdEffectiveLabel
広告グループ広告と効果的なラベルの関係。有効なラベルとは、この広告グループ広告に継承または直接割り当てられたラベルのことです。
| フィールド | |
|---|---|
resource_name |
広告グループ広告の有効なラベルのリソース名。広告グループ広告の有効なラベルのリソース名の形式は |
ad_group_ad |
有効なラベルが添付されている広告グループ広告。 |
label |
広告グループ広告に割り当てられている有効なラベル。 |
owner_customer_id |
有効なラベルを所有するお客様の ID。 |
AdGroupAdLabel
広告グループ広告とラベルの関係。
| フィールド | |
|---|---|
resource_name |
広告グループ広告ラベルのリソース名です。広告グループ広告ラベルのリソース名の形式は、 |
ad_group_ad |
ラベルが添付される広告グループ広告。 |
label |
広告グループ広告に割り当てられるラベル。 |
owner_customer_id |
ラベルを所有するお客様の ID。 |
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[] |
この広告グループの条件に適用されているラベルのリソース名。 |
effective_labels[] |
この広告グループの条件に適用されている有効なラベルのリソース名。有効なラベルとは、この広告グループの条件に継承または直接割り当てられたラベルのことです。 |
position_estimates |
さまざまなポジションの条件別入札単価の見積もり。 |
final_urls[] |
広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。 |
final_mobile_urls[] |
すべてのクロスドメイン リダイレクトの後に可能性のあるモバイルの最終ページ URL のリスト。 |
url_custom_parameters[] |
|
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 が値を決定するための十分な情報を持っていない場合は、このフィールドに値が入力されないことがあります。 |
AdGroupCriterionEffectiveLabel
広告グループ条件と有効なラベルの関係。有効なラベルとは、この広告グループの条件に継承または直接割り当てられたラベルのことです。
| フィールド | |
|---|---|
resource_name |
広告グループの条件の有効なラベルのリソース名。広告グループ条件の有効なラベルのリソース名の形式は、 |
ad_group_criterion |
有効なラベルが添付されている広告グループ条件。 |
label |
広告グループ条件に割り当てられている有効なラベル。 |
owner_customer_id |
有効なラベルを所有するお客様の ID。 |
AdGroupCriterionLabel
広告グループ条件とラベルの関係。
| フィールド | |
|---|---|
resource_name |
広告グループ条件ラベルのリソース名。広告グループ条件ラベルのリソース名の形式は、 |
ad_group_criterion |
ラベルが添付される広告グループ条件。 |
label |
広告グループ条件に割り当てられるラベル。 |
owner_customer_id |
ラベルを所有するお客様の ID。 |
AdGroupEffectiveLabel
広告グループと有効なラベルの関係。有効なラベルとは、この広告グループに継承または直接割り当てられたラベルのことです。
| フィールド | |
|---|---|
resource_name |
広告グループの有効なラベルのリソース名。広告グループの有効なラベルのリソース名の形式は |
ad_group |
有効なラベルが添付されている広告グループ。 |
label |
広告グループに割り当てられている有効なラベル。 |
owner_customer_id |
有効なラベルを所有するお客様の ID。 |
AdGroupLabel
広告グループとラベルの関係。
| フィールド | |
|---|---|
resource_name |
広告グループラベルのリソース名。広告グループ ラベルのリソース名の形式は、 |
ad_group |
ラベルが添付される広告グループ。 |
label |
広告グループ広告に割り当てられるラベル。 |
owner_customer_id |
ラベルを所有するお客様の ID。 |
AgeRangeView
年齢層ビュー。
| フィールド | |
|---|---|
resource_name |
年齢範囲ビューのリソース名。年齢範囲ビューのリソース名の形式は次のとおりです。
|
アセット
アセットは広告の一部であり、複数の広告で共有できます。画像(ImageAsset)や動画(YoutubeVideoAsset)などがあります。アセットは不変であり、削除することはできません。アセットの配信を停止するには、アセットを使用しているエンティティからアセットを削除します。
| フィールド | |
|---|---|
resource_name |
アセットのリソース名。アセット リソース名の形式は次のとおりです。
|
type |
アセットのタイプ。 |
final_urls[] |
すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。 |
final_mobile_urls[] |
すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。 |
url_custom_parameters[] |
tracking_url_template、final_urls、final_mobile_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 テンプレート。 |
final_url_suffix |
並行トラッキングで配信されるランディング ページ 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 |
アセット グループのトップの組み合わせビューのリソース名。アセット グループの上位の組み合わせビューのリソース名の形式は、`"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 |
指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が調整される入札戦略です。 |
target_impression_share |
選択したインプレッションの割合に向けて自動的に最適化する入札戦略。 |
target_outrank_share |
特定の競合他社よりも上位に表示されるべきオークションの目標割合に基づいて入札単価を設定する入札戦略。このフィールドのサポートは終了しています。このフィールドを使用して新しい入札戦略を作成したり、このフィールドを使用して入札戦略をキャンペーンに適用したりすることはできません。このスキームがすでに設定されている戦略への変更は許可されます。 |
target_roas |
特定の目標広告費用対効果(ROAS)の平均値を達成しながら、収益の最大化を図る入札戦略。 |
target_spend |
予算内でクリック数を最大化できるように入札単価を設定する入札戦略。 |
キャンペーン
キャンペーン。
| フィールド | |
|---|---|
resource_name |
キャンペーンのリソース名。キャンペーン リソース名の形式は次のとおりです。
|
status |
キャンペーンのステータス。 新しいキャンペーンを追加すると、ステータスはデフォルトで ENABLED に設定されます。 |
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 |
広告の地域ターゲティングの設定。 |
effective_labels[] |
このキャンペーンに適用されている有効なラベルのリソース名。有効なラベルは、このキャンペーンに継承または直接割り当てられたラベルです。 |
labels[] |
このキャンペーンに適用されたラベルのリソース名。 |
bidding_strategy_type |
入札戦略のタイプ。 入札戦略を作成するには、標準入札戦略を作成する入札スキームを設定するか、ポートフォリオ入札戦略を作成する このフィールドは読み取り専用です。 |
accessible_bidding_strategy |
AccessibleBiddingStrategy のリソース名。これは、'bidding_strategy' で識別される、関連付けられたポートフォリオ入札戦略の制限のない属性の読み取り専用ビューです。キャンペーンでポートフォリオ戦略を使用していない場合は空。制限なしの戦略属性は、戦略が共有されているすべてのお客様が利用でき、AccessibleBiddingStrategy リソースから読み取られます。一方、制限付き属性は、戦略の所有者であるお客様とその管理者のみが利用できます。制限付き属性は、BiddingStrategy リソースからのみ読み取ることができます。 |
frequency_caps[] |
各ユーザーにこのキャンペーンの広告を表示する頻度を制限するリスト。 |
selective_optimization |
このキャンペーンの選択的な最適化設定。このキャンペーンの最適化で重視するコンバージョン アクションのセットが含まれます。この機能は、AdvertisingChannelType に MULTI_CHANNEL、AdvertisingChannelSubType に APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用するアプリ キャンペーンにのみ適用されます。 |
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 で非推奨になります。代わりに creation_time を使用してください。 |
creation_time |
このキャンペーンが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
last_modified_time |
このキャンペーンが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。 |
feed_types[] |
このキャンペーンに直接添付されているフィードのタイプ。 |
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 です。 |
共用体フィールド ポートフォリオ(BiddingStrategy サービスで作成)または標準(キャンペーンに埋め込み)のいずれかである必要があります。 |
|
bidding_strategy |
キャンペーンで使用されるポートフォリオ入札戦略のリソース名。 |
manual_cpa |
標準の個別アクション単価制入札戦略。広告主が指定したアクションごとに広告主が入札単価を設定できる個別単価設定の入札戦略。ローカル サービス キャンペーンでのみサポートされます。 |
manual_cpc |
標準の個別クリック単価制の入札戦略。ユーザーがクリックごとに支払うクリックベースの手動入札。 |
manual_cpm |
標準の個別インプレッション単価制入札戦略。ユーザーが 1,000 インプレッションごとに支払うインプレッション ベースの手動入札。 |
maximize_conversions |
「コンバージョン数の最大化」の標準入札戦略。予算を消化しつつコンバージョン数を最大化します。 |
maximize_conversion_value |
予算を消化しつつ収益を最大化できるよう入札単価が自動的に設定される、標準の「コンバージョン値の最大化」入札戦略。 |
target_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
このキャンペーンの選択的な最適化設定。このキャンペーンの最適化で重視するコンバージョン アクションのセットが含まれます。この機能は、AdvertisingChannelType に MULTI_CHANNEL、AdvertisingChannelSubType に APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用するアプリ キャンペーンにのみ適用されます。
| フィールド | |
|---|---|
conversion_actions[] |
このキャンペーンの最適化に使用するコンバージョン アクションのリソース名のセット。 |
ShoppingSetting
ショッピング キャンペーンの設定。キャンペーンで宣伝できる商品の範囲と、このキャンペーンが他のショッピング キャンペーンとどのように連携するかを定義します。
| フィールド | |
|---|---|
feed_label |
キャンペーンに含める商品のフィードラベル。設定できるのは、feed_label または sales_country のいずれか 1 つのみです。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 |
地域グループ |
CampaignEffectiveLabel
キャンペーンと有効なラベルの関係を表します。有効なラベルは、このキャンペーンに継承または直接割り当てられたラベルです。
| フィールド | |
|---|---|
resource_name |
リソースの名前です。CampaignEffectivelabel リソース名の形式は |
campaign |
有効なラベルが添付されているキャンペーン。 |
label |
キャンペーンに割り当てられた有効なラベル。 |
owner_customer_id |
有効なラベルを所有するお客様の ID。 |
CampaignLabel
キャンペーンとラベルの関係を表します。
| フィールド | |
|---|---|
resource_name |
リソースの名前です。キャンペーン ラベルのリソース名の形式は |
campaign |
ラベルが添付されるキャンペーン。 |
label |
キャンペーンに割り当てられるラベル。 |
owner_customer_id |
ラベルを所有するお客様の ID。 |
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 に設定することしかできません。 |
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
コンバージョン カスタム変数。https://support.google.com/sa360/answer/13567857 の「検索広告 360 リニューアル版のカスタム Floodlight 指標およびディメンションについて」を参照してください。
| フィールド | |
|---|---|
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 広告の UI でのみ管理できます。このフィールドは読み取り専用です。 |
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"} というシステム列を参照しています。 |
render_type |
カスタム列の結果値の解釈方法。 |
お客様
お客様。
| フィールド | |
|---|---|
resource_name |
顧客のリソース名。顧客のリソース名の形式は次のとおりです。
|
conversion_tracking_setting |
お客様のコンバージョン トラッキングの設定。 |
account_type |
エンジン アカウント タイプ(Google 広告、Microsoft Advertising、Yahoo! JAPAN、Baidu、Facebook、エンジン トラッキングなど) |
double_click_campaign_manager_setting |
クライアント センター(MCC)アカウントの 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」形式で指定します。 |
manager_id |
マネージャーのお客様 ID。値 0 は、顧客に検索広告 360 マネージャーがいないことを示します。 |
manager_descriptive_name |
マネージャーのわかりやすい名前。 |
sub_manager_id |
サブ マネージャーのお客様 ID。値 0 は、顧客にサブ検索広告 360 マネージャーがないことを示します。 |
sub_manager_descriptive_name |
サブ マネージャーのわかりやすい名前。 |
associate_manager_id |
アソシエイト マネージャーのお客様 ID。値 0 は、顧客に検索広告 360 の関連付けられたマネージャーがいないことを示します。 |
associate_manager_descriptive_name |
アソシエイト マネージャーのわかりやすい名前。 |
account_level |
お客様のアカウント レベル(マネージャー、サブマネージャー、アソシエイト マネージャー、サービス アカウント)。 |
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 は、クライアント センター(MCC)アカウントのお客様にのみ存在します。直接クライアントと間接クライアントのすべてのお客様と、マネージャー自体が含まれます。
| フィールド | |
|---|---|
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
顧客とクライアント センターのリンク関係を表します。
| フィールド | |
|---|---|
resource_name |
リソースの名前です。CustomerManagerLink リソース名の形式は |
status |
お客様とクライアント センター間のリンクのステータス。 |
manager_customer |
お客様にリンクされているクライアント センター(MCC)アカウント。 |
manager_link_id |
顧客とマネージャーのリンクの ID。このフィールドは読み取り専用です。 |
start_time |
CustomerManagerLink が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。 |
DoubleClickCampaignManagerSetting
クライアント センター(MCC)アカウントの 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 は、この記事(https://support.google.com/merchants/answer/6324436)で説明されている google_product_category ID と同等です。 |
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 は、この記事(https://support.google.com/merchants/answer/6324436)で説明されている google_product_category ID と同等です。 |
country_code |
商品の入札カテゴリの 2 文字の大文字の国コード。 |
product_bidding_category_constant_parent |
親の商品入札カテゴリのリソース名。 |
language_code |
商品の入札カテゴリの言語コード。 |
localized_name |
language_code に従ってローカライズされた商品入札カテゴリの値を表示します。 |
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 の場合など)。 |
UserLocationView
ユーザーの所在地ビュー。
[User Location View] には、国単位で集計されたすべての指標が、国ごとに 1 行で表示されます。対象地域と非対象地域別に、ユーザーの実際の所在地における指標が表示されます。他のセグメント フィールドを使用すると、国ごとに複数の行が返されることがあります。
| フィールド | |
|---|---|
resource_name |
ユーザーの所在地ビューのリソース名。UserLocation ビューのリソース名の形式は次のとおりです。
|
country_criterion_id |
国の条件 ID。 |
targeting_location |
ビジネスがターゲットに設定されたかどうかを示します。 |
アクセス
訪問。
| フィールド | |
|---|---|
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 |
ウェブページ ビューのリソース名。ウェブページ ビューのリソース名の形式は次のとおりです。
|