Package google.ads.searchads360.v0.common

目次

AdScheduleInfo

AdSchedule 条件を表します。

AdSchedule は、広告を表示する曜日と時間帯として指定します。

同じ日に追加できる AdSchedules は 6 つまでです。

フィールド
start_minute

MinuteOfHour

このスケジュールが開始される開始時間の数分後。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

end_minute

MinuteOfHour

終了時刻の後の分。このスケジュールが終了します。スケジュールに終了分は含まれません。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

day_of_week

DayOfWeek

スケジュールを適用する曜日。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

start_hour

int32

開始時刻(24 時間制)。このフィールドは 0 ~ 23 の範囲で指定する必要があります。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

end_hour

int32

24 時間制の終了時刻。24 は一日の終わりを表します。このフィールドは 0 ~ 24 の範囲で指定する必要があります。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

AgeRangeInfo

年齢層の基準です。

フィールド
type

AgeRangeType

年齢層のタイプ。

AssetInteractionTarget

AssetInteractionTarget セグメント。

フィールド
asset

string

アセットのリソース名。

interaction_on_this_asset

bool

CustomerAsset、CampaignAsset、AdGroupAsset の各指標でのみ使用します。インタラクションの指標がアセット自体で発生したか、別のアセットや広告ユニットで発生したかを示します。

AssetUsage

アセットの使用状況に関する情報が格納されています。

フィールド
asset

string

アセットのリソース名。

served_asset_field_type

ServedAssetFieldType

アセットの配信フィールド タイプ。

AudienceInfo

オーディエンスの条件です。

フィールド
audience

string

オーディエンス リソース名。

BusinessProfileLocation

リンクされたビジネス プロフィール アカウントから同期された、ビジネス プロフィールのビジネス情報。

フィールド
labels[]

string

広告主様がビジネス プロフィール アカウントでビジネス情報に対して指定したラベル。これはビジネス プロフィール アカウントから同期されます。

store_code

string

このビジネス拠点のビジネス プロフィールの店舗コード。これはビジネス プロフィール アカウントから同期されます。

listing_id

int64

このビジネス プロフィールのビジネス情報のリスティング ID。これは、リンクされているビジネス プロフィール アカウントから同期されます。

CallToActionAsset

行動を促すフレーズのアセット。

フィールド
call_to_action

CallToActionType

お気軽にお問い合わせください。

CustomParameter

tracking_url_templatefinal_urlsmobile_final_urls のカスタム パラメータ タグで使用できるマッピング。

フィールド
key

string

パラメータタグ名と一致するキー。

value

string

置換される値。

DeviceInfo

デバイスの条件。

フィールド
type

Device

デバイスのタイプ。

EnhancedCpc

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

コンバージョンにつながる可能性が高いクリックに対しては入札単価を引き上げ、可能性が低いクリックに対しては引き下げる自動入札戦略。

この入札戦略はサポートが終了したため、作成できなくなりました。同等の機能として、Enhanced_cpc_enabled を true に設定して ManualCpc を使用します。

FrequencyCapEntry

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

特定の期間内に 1 つの広告(または一部の広告)を 1 つのユーザーに表示できる最大回数を指定するルールです。

GenderInfo

性別の条件。

フィールド
type

GenderType

性別のタイプ。

ImageAsset

画像アセット。

フィールド
mime_type

MimeType

画像アセットの MIME タイプ。

full_size

ImageDimension

元のサイズでこの画像のメタデータ。

file_size

int64

画像アセットのファイルサイズ(バイト単位)。

ImageDimension

特定のサイズ(元のサイズまたはサイズ変更された画像)の画像のメタデータ。

フィールド
height_pixels

int64

画像の高さ。

width_pixels

int64

画像の幅。

url

string

この高さと幅の画像を返す URL。

キーワード

キーワードの条件セグメントです。

フィールド
info

KeywordInfo

キーワード情報。

ad_group_criterion

string

AdGroupCriterion リソース名。

KeywordInfo

キーワードの条件。

フィールド
match_type

KeywordMatchType

キーワードのマッチタイプ。

text

string

キーワードのテキスト(最大 80 文字、10 単語)。

LanguageInfo

言語の条件。

フィールド
language_constant

string

言語定数のリソース名。

ListingGroupInfo

リスティング グループの条件。

フィールド
type

ListingGroupType

リスティング グループのタイプ。

LocationGroupInfo

フィードで指定された場所のリストを中心とした半径です。

フィールド
geo_target_constants[]

string

フィード内の地域の範囲を制限する地域ターゲティングの定数。現在、使用できる地域ターゲティングの定数は 1 つのみです。

radius_units

LocationGroupRadiusUnits

半径の単位。地域ターゲティングの定数では、マイルとメートルがサポートされています。フィード アイテム セットではミリマイルとメートルがサポートされています。これは必須であり、CREATE オペレーションで設定する必要があります。

feed_item_sets[]

string

FeedItems がターゲットとする FeedItemSet。複数の ID を指定すると、少なくとも 1 つのセットに出現するすべての項目がターゲティングされます。このフィールドは geo_target_constants と一緒に使用できません。これはオプションであり、CREATE オペレーションでのみ設定できます。

radius

int64

対象地域を中心とした半径を指定する単位での距離です。これは必須であり、CREATE オペレーションで設定する必要があります。

LocationInfo

地域の条件。

フィールド
geo_target_constant

string

地域ターゲティングの定数リソース名。

ManualCpa

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

広告主様が指定したアクションごとに入札単価を設定できる個別単価設定戦略です。

ManualCpc

クリックベースの個別単価設定(クリック課金型)。

フィールド
enhanced_cpc_enabled

bool

コンバージョン オプティマイザーのデータに基づいて入札単価を拡張するかどうか。

ManualCpm

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

インプレッション ベースの手動入札。ユーザーが 1,000 回のインプレッションごとに料金を支払います。

MaximizeConversionValue

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

フィールド
cpc_bid_ceiling_micros

int64

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。

cpc_bid_floor_micros

int64

入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。

target_roas

double

目標広告費用対効果(LTV)オプション。設定した場合、入札戦略では目標広告費用対効果を平均化しながら、収益を最大化します。目標広告費用対効果が高い場合、入札戦略では予算全額を使用できない可能性があります。目標広告費用対効果が設定されていない場合、入札戦略では予算に対して可能な限り高い広告費用対効果を達成することを目指します。

MaximizeConversions

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

フィールド
cpc_bid_ceiling_micros

int64

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。

cpc_bid_floor_micros

int64

入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略でのみ変更可能です。

target_cpa_micros

int64

目標コンバージョン単価(CPA)オプション。指定したコンバージョン アクションあたりの平均費用として、入札戦略の通貨のマイクロ単位で指定します。設定すると、入札戦略は目標コンバージョン単価以下で最大限のコンバージョンを獲得します。目標コンバージョン単価が設定されていない場合は、予算内で可能な限り低いコンバージョン単価の達成を目指します。

指標

指標データ。

フィールド
all_conversions_value_by_conversion_date

double

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

all_conversions_by_conversion_date

double

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

conversion_custom_metrics[]

Value

コンバージョンのカスタム指標。

conversions_value_by_conversion_date

double

コンバージョンの日付ごとの、入札単価設定に使用されるコンバージョン値の合計。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。

conversions_by_conversion_date

double

入札対象のコンバージョンの種類のコンバージョン日別の合計コンバージョン数。アトリビューション モデリングにより、小数値になることがあります。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。

historical_creative_quality_score

QualityScoreBucket

クリエイティブの過去の品質スコア。

historical_landing_page_quality_score

QualityScoreBucket

過去のランディング ページの利便性の質。

historical_search_predicted_ctr

QualityScoreBucket

過去の検索の予測クリック率(CTR)。

interaction_event_types[]

InteractionEventType

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

raw_event_conversion_metrics[]

Value

未加工のイベント コンバージョン指標。

absolute_top_impression_percentage

double

「検索広告のページ最上部インプレッション シェア」とは、検索結果ページの最も目立つ位置に検索広告が表示されたインプレッションの割合です。

all_conversions_from_interactions_rate

double

インタラクションからのコンバージョンの数(ビュースルー コンバージョンとは逆)を、広告インタラクションの数で割った値です。

all_conversions_value

double

すべてのコンバージョン値。

all_conversions

double

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

all_conversions_value_per_cost

double

すべてのコンバージョンの値を、広告インタラクション(テキスト広告のクリックや動画広告の視聴など)の合計費用で割った値です。

all_conversions_from_click_to_call

double

ユーザーが広告のクリック中またはクリック後に [電話] ボタンをクリックして店舗に電話した回数です。この番号には、通話がつながったかどうかや通話時間は含まれません。

この指標はフィード アイテムにのみ適用されます。

all_conversions_from_directions

double

ユーザーが広告をクリックした後に、[ルートを検索] ボタンをクリックして店舗への移動を行った回数。

この指標はフィード アイテムにのみ適用されます。

all_conversions_from_interactions_value_per_interaction

double

インタラクションによるすべてのコンバージョン値をインタラクションの合計数で割った値。

all_conversions_from_menu

double

ユーザーが広告をクリックした後に、店舗のメニューを表示するリンクをクリックした回数。

この指標はフィード アイテムにのみ適用されます。

all_conversions_from_order

double

ユーザーが広告をクリックした後に、店舗で注文を行った回数。

この指標はフィード アイテムにのみ適用されます。

all_conversions_from_other_engagement

double

ユーザーが広告をクリックした後に発生したコンバージョン(クチコミの投稿、店舗の場所の保存など)の件数です。

この指標はフィード アイテムにのみ適用されます。

all_conversions_from_store_visit

double

ユーザーが広告をクリックした後に、店舗を訪問したと推定される回数。

この指標はフィード アイテムにのみ適用されます。

visits

double

検索広告 360 で正常に記録され、広告主のランディング ページに転送されたクリック数。

all_conversions_from_store_website

double

ユーザーが広告をクリックした後に、ショップの URL にアクセスした回数。

この指標はフィード アイテムにのみ適用されます。

average_cost

double

インタラクション 1 回に対して支払う平均金額です。広告にかかった費用の合計を、インタラクション数の合計で割った値です。

average_cpc

double

すべてのクリックの合計費用を、発生したクリックの合計数で割った値。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

average_cpm

double

平均インプレッション単価(CPM)。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

clicks

int64

クリック数。

content_budget_lost_impression_share

double

予算が少なすぎるために、ディスプレイ ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: コンテンツ予算のインプレッション シェア損失率は 0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

content_impression_share

double

ディスプレイ ネットワークで顧客が実際に獲得したインプレッションの回数を、顧客の広告が表示候補となった推定回数で割ったもの。注: コンテンツのインプレッション シェアは 0.1~1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

content_rank_lost_impression_share

double

広告ランクが低いために、広告がディスプレイ ネットワークで獲得できなかったインプレッションの推測割合。注: コンテンツ ランクのインプレッション シェア損失率は 0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

conversions_from_interactions_rate

double

入札対象のコンバージョンの平均(インタラクションから)です。広告インタラクションが入札単価設定に使用されるコンバージョンに、平均してどれくらいの頻度でつながっているかを確認できます。

client_account_conversions_value

double

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

conversions_value_per_cost

double

入札単価設定に使用されるコンバージョン値を、コンバージョンの対象となるインタラクションの合計費用で割った値。

conversions_from_interactions_value_per_interaction

double

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

client_account_conversions

double

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

cost_micros

int64

この期間のクリック単価(CPC)による費用とインプレッション単価(CPM)による費用の総額。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

cost_per_all_conversions

double

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

cost_per_conversion

double

入札単価設定に使用されるコンバージョンあたりの平均有効費用。

cost_per_current_model_attributed_conversion

double

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

cross_device_conversions

double

ユーザーがあるデバイスで広告をクリックし、別のデバイスまたはブラウザでコンバージョンを達成した場合のコンバージョン。クロスデバイス コンバージョンは、all_conversions にすでに含まれています。

cross_device_conversions_value

double

クロスデバイス コンバージョンの合計値。

ctr

double

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

conversions

double

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

conversions_value

double

[コンバージョン] 項目に含まれるコンバージョンのコンバージョン値の合計です。この指標は、コンバージョン アクションに値を設定している場合にのみ有用です。

historical_quality_score

int64

品質スコア(履歴)。

impressions

int64

検索結果ページや Google ネットワークのウェブサイトに広告が表示された頻度。

interaction_rate

double

広告が表示された後にその広告をユーザーが操作する頻度。これは、インタラクション数を広告が表示された回数で割った値です。

interactions

int64

インタラクションの数。インタラクションとは、その広告フォーマットに関連付けられた主要なユーザー行動(テキスト広告やショッピング広告に対するクリック、動画広告の視聴など)を指します。

invalid_click_rate

double

レポート対象期間中のクリック総数(フィルタ済みとフィルタなしのクリック数)のうち、除外されたクリックの割合。

invalid_clicks

int64

Google が不正と判断したクリックの数。料金は発生しません。

mobile_friendly_clicks_percentage

double

モバイル向けページに移動するモバイル クリックの割合。

search_absolute_top_impression_share

double

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

search_budget_lost_absolute_top_impression_share

double

予算の低さが原因で、検索結果ページの上位の広告の中で、広告が最初に表示されなかった頻度の推定値です。注: 検索予算の検索広告のページ最上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

search_budget_lost_impression_share

double

予算が少なすぎるために、検索ネットワークで表示可能だったものの、表示されなかった回数の推定される割合。注: 検索予算のインプレッション シェア損失率は、0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

search_budget_lost_top_impression_share

double

予算不足が原因で、広告が上位のオーガニック検索結果のすぐ近くに表示されなかった頻度の推定値です。注: 検索予算の検索広告のページ上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

search_click_share

double

検索ネットワークでのクリック数を、獲得可能だったと推定されるクリック数で割った値です。注: 検索クリック数シェアは 0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

search_exact_match_impression_share

double

キーワードのマッチタイプにかかわらず、キーワードと完全に一致した(またはキーワードの類似パターンである)検索語句に対して、検索ネットワークで受け取ることが可能だったインプレッションの推定数でインプレッション数を割った値です。注: 検索の完全一致のインプレッション シェアは 0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

search_impression_share

double

検索ネットワークで顧客が実際に獲得したインプレッションの回数を、顧客の広告が表示候補となった推定回数で割ったもの。注: 検索広告のインプレッション シェアは、0.1~1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

search_rank_lost_absolute_top_impression_share

double

広告ランクの低さが原因で、検索結果ページの上位の広告の中で、広告が最初に表示されなかった頻度の推定値です。注: 検索ランクの検索広告のページ最上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

search_rank_lost_impression_share

double

広告ランクが低いために、広告が検索ネットワークで獲得できなかったインプレッションの推測割合。注: 検索ランクのインプレッション シェア損失率は、0~0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

search_rank_lost_top_impression_share

double

広告ランクの低さが原因で、広告がオーガニック検索結果のすぐ近くに表示されなかった頻度の推定値です。注: 検索ランクの検索広告のページ上部インプレッション シェア損失率は、0 ~ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。

search_top_impression_share

double

上位の広告で獲得したインプレッション数を、上位広告の中で獲得可能だったと推定されるインプレッション数を基準として比較したものです。注: 検索の検索広告のページ上部インプレッション シェアは、0.1 ~ 1 の範囲で報告されます。0.1 未満の値はすべて 0.0999 として報告されます。

通常、上位の広告は上位のオーガニック検索結果の上に表示されますが、特定の検索語句では上位のオーガニック検索結果の下に表示されることもあります。

top_impression_percentage

double

上位のオーガニック検索結果の隣に表示された広告のインプレッションの割合です。

value_per_all_conversions

double

すべてのコンバージョンをすべてのコンバージョン数で割った値。

value_per_all_conversions_by_conversion_date

double

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

value_per_conversion

double

入札単価設定に使用されるコンバージョン値を、入札単価設定に使用されるコンバージョン数で割った値です。入札単価設定に使用される各コンバージョンの平均的な価値が表示されます。

value_per_conversions_by_conversion_date

double

コンバージョンの日付別の入札対象コンバージョン値を、コンバージョンの日付ごとの入札対象コンバージョン数で割った値です。入札単価設定に使用される各コンバージョンの平均的な価値(コンバージョンの日付別)が表示されます。この列に日付を選択した場合、日付列の値はコンバージョンの日付を表します。

client_account_view_through_conversions

int64

ビュースルー コンバージョンの合計数。この状況は、ユーザーが画像やリッチメディア広告を閲覧した後、別の広告を操作(クリックなど)することなく、サイトでコンバージョンに至ると発生します。

client_account_cross_sell_cost_of_goods_sold_micros

int64

クライアント アカウントのクロスセルの売上原価(COGS)は、別の商品の広告を経由して購入された商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの売上原価とは、広告に掲載されずに販売された商品の売上原価の総額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文でのクロスセルの売上原価は 5 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

cross_sell_cost_of_goods_sold_micros

int64

クロスセルの売上原価(COGS)は、別の商品の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの売上原価とは、広告に掲載されずに販売された商品の売上原価の総額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文でのクロスセルの売上原価は 5 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

client_account_cross_sell_gross_profit_micros

int64

クライアント アカウントのクロスセルの総利益とは、ある商品が別の商品の広告を経由して販売に至った場合、その収益から売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入に含まれている商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの総利益とは、広告が貢献したクロスセルで得られた収益から売上原価を差し引いたものです。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。シャツの価格は 20 ドルで、売上原価は 5 ドルです。この場合、この注文でのクロスセルの総利益は 15 ドル(20 ドル - 5 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

cross_sell_gross_profit_micros

int64

クロスセルの総利益とは、ある商品が別の商品の広告によって販売につながった場合、その収益から売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入に含まれている商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの総利益とは、広告が貢献したクロスセルで得られた収益から売上原価を差し引いたものです。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。シャツの価格は 20 ドルで、売上原価は 5 ドルです。この場合、この注文でのクロスセルの総利益は 15 ドル(20 ドル - 5 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

client_account_cross_sell_revenue_micros

int64

クライアント アカウントのクロスセルの収益は、ある商品が別の商品の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの収益は、広告が貢献したクロスセルで得られた収益の合計額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文でのクロスセルの収益は 20 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

cross_sell_revenue_micros

int64

クロスセルの収益は、ある商品が別の商品の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの収益は、広告が貢献したクロスセルで得られた収益の合計額です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文でのクロスセルの収益は 20 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

client_account_cross_sell_units_sold

double

クライアント アカウントのクロスセルの販売数は、ある商品が別の商品の広告によって販売につながった数の合計です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの販売数は、広告に起因するすべての注文のうち、クロスセルで販売された商品の合計数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文でのクロスセルの販売数は 2 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

cross_sell_units_sold

double

クロスセルの販売数は、別の商品の広告を経由して販売に至った商品の合計数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。これらの商品が一致しない場合、クロスセルと見なされます。クロスセルの販売数は、広告に起因するすべての注文のうち、クロスセルで販売された商品の合計数です。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文でのクロスセルの販売数は 2 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

client_account_lead_cost_of_goods_sold_micros

int64

クライアント アカウントの主力商品の売上原価(COGS)とは、その商品自体の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の原価は主力商品の売上原価と見なされます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文での主力商品の売上原価は 3 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

lead_cost_of_goods_sold_micros

int64

主力商品の売上原価(COGS)は、その商品自体の広告を経由して販売に至った商品の売上原価の総額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。ユーザーが操作した広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の原価は主力商品の売上原価と見なされます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の売上原価は 3 ドルで、シャツの売上原価は 5 ドルです。この場合、この注文での主力商品の売上原価は 3 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

client_account_lead_gross_profit_micros

int64

クライアント アカウントの主力商品の総利益とは、その商品自体の広告を経由して販売に至った商品の収益から、売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の収益から売上原価を差し引いた金額が主力商品の総利益になります。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。この場合、この注文の主力商品の総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

lead_gross_profit_micros

int64

主力商品の総利益とは、その商品自体の広告を経由して販売に至った商品の収益から、売上原価(COGS)を差し引いたものです。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の収益から売上原価を差し引いた金額が主力商品の総利益になります。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドルで、売上原価は 3 ドルです。この場合、この注文の主力商品の総利益は 7 ドル(10 ドル - 3 ドル)となります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

client_account_lead_revenue_micros

int64

クライアント アカウントの主力商品の収益とは、ある商品がそれ自体の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の販売で得られた合計額が [主力商品の収益] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文での主力商品の収益は 10 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

lead_revenue_micros

int64

主力商品の収益とは、ある商品がそれ自体の広告を経由して販売に至った際に生じた収益の合計額です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。販売された商品が広告に掲載された商品と一致する場合、これらの商品の販売で得られた合計額が [主力商品の収益] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子とシャツを購入しました。帽子の価格は 10 ドル、シャツの価格は 20 ドルです。この場合、この注文での主力商品の収益は 10 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金額であり、デフォルトでは顧客の通貨で返されます。https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause で metrics_currency パラメータをご覧ください。

client_account_lead_units_sold

double

クライアント アカウントの主力商品の販売数は、その商品自体の広告を経由して販売に至った商品の合計数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。広告に掲載された商品と販売された商品が一致する場合、これらの販売された商品の合計数が [主力商品の販売数] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文での主力商品の販売数は 1 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

lead_units_sold

double

主力商品の販売数は、その商品自体の広告を経由して販売に至った商品の合計数です。仕組み: ウェブサイト上で完了した購入について、カート コンバージョン レポートを作成します。購入前に接点があった広告に関連商品(ショッピング広告を参照)が掲載されている場合、その商品は宣伝対象の商品と見なされます。その購入者のその注文に含まれる商品はすべて、販売された商品となります。広告に掲載された商品と販売された商品が一致する場合、これらの販売された商品の合計数が [主力商品の販売数] に表示されます。例: ユーザーが帽子のショッピング広告をクリックし、その帽子、シャツ、ジャケットを購入しました。この場合、この注文での主力商品の販売数は 1 となります。この指標は、カート コンバージョン レポートを設定している場合のみ使用できます。

MobileAppAsset

モバイルアプリを表すアセット。

フィールド
app_id

string

必須。モバイルアプリを一意に識別する文字列です。Android の場合は「com.android.ebay」、iOS の場合は「12345689」のように、プラットフォームのネイティブ ID のみを含める必要があります。

app_store

MobileAppVendor

必須。この特定のアプリを配信するアプリケーション ストア。

PercentCpc

商品やサービスの広告価格に対して、わずかな金額で入札する入札戦略。

フィールド
cpc_bid_ceiling_micros

int64

入札戦略で設定可能な入札単価の上限。これは広告主が入力するオプションのフィールドで、ローカルのマイクロ秒単位で指定します。注: 値が 0 の場合は、bid_latency が未定義の場合と同様に解釈されます。

enhanced_cpc_enabled

bool

コンバージョンにつながる可能性に応じて、オークションごとに入札単価を調整します。個別単価は cpc_bid_ceiling_micro を超えることもありますが、キャンペーンの平均入札額を超えないようにする必要があります。

RealTimeBiddingSetting

リアルタイム ビッダー(Ad Exchange ネットワークをターゲットとするキャンペーンのみ)の設定。

フィールド
opt_in

bool

キャンペーンでリアルタイム ビッダーが有効になっているかどうか。

SearchAds360ExpandedDynamicSearchAdInfo

拡張動的検索広告。

フィールド
description1

string

広告の説明欄の 1 行目。

description2

string

広告の説明欄の 2 行目。

ad_tracking_id

int64

広告のトラッキング ID。

SearchAds360ExpandedTextAdInfo

検索広告 360 の拡張テキスト広告。

フィールド
headline

string

広告の見出し。

headline2

string

広告の 2 番目の見出し。

headline3

string

広告の 3 番目の見出し。

description1

string

広告の説明欄の 1 行目。

description2

string

広告の説明欄の 2 行目。

path1

string

自動生成された表示 URL に区切り文字が追加されたテキスト。

path2

string

path1 に区切り文字で追加されたテキスト。

ad_tracking_id

int64

広告のトラッキング ID。

SearchAds360ProductAdInfo

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

検索広告 360 の商品広告。

SearchAds360ResponsiveSearchAdInfo

検索広告 360 のレスポンシブ検索広告。

フィールド
path1

string

自動生成された表示 URL に区切り文字が追加されたテキスト。

path2

string

path1 に区切り文字で追加されたテキスト。

ad_tracking_id

int64

広告のトラッキング ID。

SearchAds360TextAdInfo

検索広告 360 のテキスト広告。

フィールド
headline

string

広告の見出し。

description1

string

広告の説明欄の 1 行目。

description2

string

広告の説明欄の 2 行目。

display_url

string

広告の表示 URL。

display_mobile_url

string

広告が表示されたモバイル URL。

ad_tracking_id

int64

広告のトラッキング ID。

セグメント

セグメント専用フィールド。

フィールド
ad_network_type

AdNetworkType

広告ネットワークのタイプ。

conversion_action_category

ConversionActionCategory

コンバージョン アクションのカテゴリ。

conversion_custom_dimensions[]

Value

コンバージョンのカスタム ディメンション。

day_of_week

DayOfWeek

曜日(例: MONDAY)。

device

Device

指標が適用されるデバイス。

keyword

Keyword

キーワードの条件。

product_channel

ProductChannel

商品のチャネル。

product_channel_exclusivity

ProductChannelExclusivity

商品のチャネル独占性。

product_condition

ProductCondition

商品の状態。

product_sold_condition

ProductCondition

販売された商品の状態。

raw_event_conversion_dimensions[]

Value

未加工のイベント コンバージョン ディメンション。

conversion_action

string

コンバージョン アクションのリソース名。

conversion_action_name

string

コンバージョン アクション名。

date

string

指標が適用される日付。yyyy-MM-dd 形式(例: 2018-04-17)。

month

string

月の初日の日付で表される月。形式は yyyy-MM-dd です。

product_bidding_category_level1

string

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

product_bidding_category_level2

string

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

product_bidding_category_level3

string

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

product_bidding_category_level4

string

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

product_bidding_category_level5

string

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

product_brand

string

商品のブランド。

product_country

string

商品の販売先の国の地域ターゲティング定数のリソース名。

product_custom_attribute0

string

商品のカスタム属性 0。

product_custom_attribute1

string

商品のカスタム属性 1。

product_custom_attribute2

string

商品のカスタム属性 2。

product_custom_attribute3

string

商品のカスタム属性 3。

product_custom_attribute4

string

商品のカスタム属性 4。

product_item_id

string

商品の商品アイテム ID。

product_language

string

商品の言語の言語定数のリソース名。

product_sold_bidding_category_level1

string

販売された商品の入札カテゴリ(レベル 1)。

product_sold_bidding_category_level2

string

販売された商品の入札カテゴリ(レベル 2)。

product_sold_bidding_category_level3

string

販売された商品の入札カテゴリ(レベル 3)。

product_sold_bidding_category_level4

string

販売された商品の入札カテゴリ(レベル 4)。

product_sold_bidding_category_level5

string

販売された商品の入札カテゴリ(レベル 5)。

product_sold_brand

string

販売した商品のブランド。

product_sold_custom_attribute0

string

販売された商品のカスタム属性 0。

product_sold_custom_attribute1

string

販売された商品のカスタム属性 1。

product_sold_custom_attribute2

string

販売された商品のカスタム属性 2。

product_sold_custom_attribute3

string

販売された商品のカスタム属性 3。

product_sold_custom_attribute4

string

販売された商品のカスタム属性 4。

product_sold_item_id

string

販売された商品の商品アイテム ID。

product_sold_title

string

販売された商品のタイトル。

product_sold_type_l1

string

販売された商品のタイプ(レベル 1)。

product_sold_type_l2

string

販売された商品のタイプ(レベル 2)。

product_sold_type_l3

string

販売された商品のタイプ(レベル 3)。

product_sold_type_l4

string

販売された商品のタイプ(レベル 4)。

product_sold_type_l5

string

販売された商品のタイプ(レベル 5)。

product_store_id

string

商品のストア ID。

product_title

string

商品のタイトル。

product_type_l1

string

商品のタイプ(レベル 1)。

product_type_l2

string

商品のタイプ(レベル 2)。

product_type_l3

string

商品のタイプ(レベル 3)。

product_type_l4

string

商品のタイプ(レベル 4)。

product_type_l5

string

商品のタイプ(レベル 5)。

quarter

string

四半期の初日の日付で表される四半期。四半期に暦年を使用します。たとえば、2018 年の第 2 四半期は 2018-04-01 に始まります。形式は yyyy-MM-dd です。

week

string

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

year

int32

年(yyyy 形式)。

asset_interaction_target

AssetInteractionTarget

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

TargetCpa

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

フィールド
target_cpa_micros

int64

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

cpc_bid_ceiling_micros

int64

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。

cpc_bid_floor_micros

int64

入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。

TargetCpm

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

目標インプレッション単価(目標インプレッション単価)は自動入札戦略の一種で、設定した目標インプレッション単価に基づいてパフォーマンスが最適化されるように入札単価が設定されます。

TargetImpressionShare

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

フィールド
location

TargetImpressionShareLocation

検索結果ページの対象地域

location_fraction_micros

int64

対象地域で表示する広告の割合(マイクロ単位)。たとえば、1% は 10,000 に相当します。

cpc_bid_ceiling_micros

int64

自動入札システムで指定できる、最も高いクリック単価。これは上限を設定する広告主が入力する必須項目で、ローカルのマイクロ秒単位で指定します。

TargetOutrankShare

特定の競合他社よりも上位に掲載すべきオークションの目標割合に基づいて入札単価を設定する自動入札戦略。この戦略は非推奨になりました。

フィールド
cpc_bid_ceiling_micros

Int64Value

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。

TargetRestriction

ターゲティング ディメンションごとのターゲット設定のリスト。

フィールド
targeting_dimension

TargetingDimension

これらの設定が適用されるターゲティング ディメンション。

bid_only

bool

この target_dimension で選択した条件でのみ広告を表示するか、この target_dimension のすべての値をターゲットに設定して、他の TargetDimensions のターゲティングに基づいて広告を表示するかを指定します。値が true の場合、入札単価調整比のみが適用され、ターゲティングには影響しません。値を false にすると、その条件によってターゲティングと入札単価調整比の適用が制限されます。

TargetRoas

特定の目標広告費用対効果(ROAS)を平均化しつつ、収益を最大化できる自動入札戦略です。

フィールド
target_roas

double

必須。費用単価の選択された収益(コンバージョン データに基づく)。値は 0.01~1000.0 の範囲で指定する必要があります。

cpc_bid_ceiling_micros

int64

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。

cpc_bid_floor_micros

int64

入札戦略で設定可能な入札単価の下限。この制限は、この戦略で管理するすべてのキーワードに適用されます。ポートフォリオ入札戦略の場合にのみ設定する必要があります。

TargetSpend

予算内でクリック数を最大化できるように入札単価を設定する自動入札戦略です。

フィールド
target_spend_micros
(deprecated)

int64

クリック数を最大化するための目標予算。目標予算の入札者は、この値と、自然なスロットリング予算額のうち、少ない方の金額を支出しようとします。指定しない場合、予算が目標予算として使用されます。このフィールドは非推奨のため使用不可です。詳しくは、https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html をご覧ください。

cpc_bid_ceiling_micros

int64

入札戦略で設定可能な入札単価の上限。この制限は、この戦略で管理するすべてのキーワードに適用されます。

TargetingSetting

ターゲティング関連機能の設定(キャンペーン単位、広告グループ単位)。ターゲット設定について詳しくは、https://support.google.com/google-ads/answer/7365594 をご覧ください。

フィールド
target_restrictions[]

TargetRestriction

ターゲティング ディメンションごとに、キャンペーンまたは広告グループのリーチを制限する設定。

TextAsset

テキスト アセット。

フィールド
text

string

テキスト アセットのテキスト コンテンツ。

TextLabel

色付きの背景にテキストを表示するラベルの一種。

フィールド
background_color

string

ラベルの背景色(RGB 形式)。この文字列は、正規表現「^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$」と一致する必要があります。注: MCC アカウントでは、背景色が表示されない場合があります。

description

string

ラベルの簡単な説明。長さは 200 文字以下にする必要があります。

UnifiedCallAsset

統合された電話番号アセット。

フィールド
country_code

string

電話番号の 2 文字の国コード。例: 「US」、「us」。

phone_number

string

広告主の未加工の電話番号。例: 「1234567890」、「(123)456-7890」

call_conversion_reporting_state

CallConversionReportingState

この CallAsset では、独自の通話コンバージョン設定を使用するか、アカウント単位の設定を使用するか、通話コンバージョンを無効にするかを示します。

call_conversion_action

string

通話コンバージョンを関連付けるコンバージョン アクション。設定しない場合は、デフォルトのコンバージョン アクションが使用されます。このフィールドは、call_conversion_reporting_state が USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION に設定されている場合にのみ有効になります。

ad_schedule_targets[]

AdScheduleInfo

アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。

call_only

bool

ウェブサイトへのリンクのない電話番号のみが通話に表示されるかどうか。Microsoft 広告に適用されます。

call_tracking_enabled

bool

コール トラッキングで通話を有効にするかどうか。Microsoft 広告に適用されます。

use_searcher_time_zone

bool

検索ユーザーのタイムゾーンで電話番号表示オプションを表示するかどうかを指定します。Microsoft 広告に適用されます。

start_date

string

このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。

end_date

string

このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。

UnifiedCalloutAsset

統合されたコールアウト アセット。

フィールド
callout_text

string

コールアウトのテキスト。この文字列の長さは 1~25 で指定します。

start_date

string

このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。

end_date

string

このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。

ad_schedule_targets[]

AdScheduleInfo

アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。

use_searcher_time_zone

bool

検索ユーザーのタイムゾーンでアセットを表示するかどうかを指定します。Microsoft 広告に適用されます。

UnifiedLocationAsset

統合された住所アセット。

フィールド
place_id

string

プレイス ID は、Google プレイスのデータベースおよび Google マップで、特定の場所を一意に識別する ID です。このフィールドは、特定のお客様 ID とアセットタイプに対して一意です。Place ID について詳しくは、https://developers.google.com/places/web-service/place-id をご覧ください。

business_profile_locations[]

BusinessProfileLocation

顧客のビジネス拠点のリスト。ビジネス プロフィール アカウントから住所アセットを同期している場合にのみ返されます。同じアカウントで、同じ場所 ID を参照する複数のビジネス プロフィールのリスティングを作成できます。

location_ownership_type

LocationOwnershipType

ビジネスのオーナー権限のタイプ。タイプが BUSINESS_OWNER の場合は、住所表示オプションとして表示されます。タイプが AFFILIATE の場合は、アフィリエイト住所として使用されます。

UnifiedPageFeedAsset

統合されたページフィード アセット。

フィールド
page_url

string

広告主がターゲットとするウェブページ。

labels[]

string

ページ URL のグループ化に使用されるラベル。

UnifiedSitelinkAsset

統合されたサイトリンク アセット。

フィールド
description1

string

サイトリンクの説明の 1 行目。設定する場合は、長さを 1~35 の範囲で設定し、description2 も設定する必要があります。

description2

string

サイトリンクの説明の 2 行目。設定する場合、長さは 1~35 の範囲で指定する必要があります。また、description1 も設定する必要があります。

start_date

string

このアセットが有効で配信を開始できる開始日(yyyy-MM-dd 形式)。

end_date

string

このアセットが有効で配信されている最終日(yyyy-MM-dd 形式)。

ad_schedule_targets[]

AdScheduleInfo

アセットを配信するすべての時間間隔を指定する、重複しないスケジュールのリスト。1 日に最大 6 個のスケジュールを作成できます(合計 42 個)。

tracking_id

int64

サイトリンク アセットのクリックをトラッキングするために使用される ID。これは Yahoo!日本のみのフィールドです。

use_searcher_time_zone

bool

検索ユーザーのタイムゾーンでサイトリンク アセットを表示するかどうか。Microsoft 広告に適用されます。

mobile_preferred

bool

サイトリンク アセットをモバイル デバイスで表示するための設定かどうかを指定します。Microsoft 広告に適用されます。

UserListInfo

ユーザーリストの条件。ターゲットに設定する広告主が定義したユーザーリストを表します。

フィールド
user_list

string

ユーザーリストのリソース名。

汎用的なデータコンテナ。

フィールド
共用体フィールド value。値。value は次のいずれかになります。
boolean_value

bool

ブール値。

int64_value

int64

int64。

float_value

float

浮動小数点数。

double_value

double

double。

string_value

string

文字列。

WebpageConditionInfo

広告主のウェブサイトのウェブページをターゲットに設定するための論理式。

フィールド
operand

WebpageConditionOperand

ウェブページのターゲティング条件のオペランド。

operator

WebpageConditionOperator

ウェブページ ターゲティング条件の演算子。

argument

string

ウェブページのターゲティング条件の引数。

WebpageInfo

広告主のウェブサイトのウェブページをターゲットに設定するための条件を表します。

フィールド
conditions[]

WebpageConditionInfo

ウェブページ ターゲティングの条件または論理式。ターゲティングの評価時に、ウェブページのターゲティング条件のリストが 1 つにまとめられます。条件のリストが空の場合は、キャンペーンのウェブサイトのすべてのページがターゲットに設定されていることを示します。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

coverage_percentage

double

ウェブサイトの条件カバレッジの割合。広告グループとキャンペーンのウェブサイト ターゲット、除外ウェブサイト ターゲット、除外キーワードに基づいて計算されたウェブサイトのカバレッジの割合。たとえば、カバレッジが 1 の場合は、カバレッジが 100% であることを示します。このフィールドは読み取り専用です。

criterion_name

string

このパラメータで定義されている条件の名前。name の値は、このタイプのパラメータの条件を識別、並べ替え、フィルタするために使用されます。

このフィールドは、CREATE オペレーションでは必須であり、UPDATE オペレーションでは禁止されています。

YoutubeVideoAsset

YouTube アセット。

フィールド
youtube_video_title

string

YouTube 動画のタイトル。

youtube_video_id

string

YouTube 動画 ID。YouTube 動画の URL で使用される 11 文字の文字列値です。