Package google.ads.searchads360.v0.common

インデックス

AdScheduleInfo

AdSchedule 条件を表します。

AdSchedule は、曜日と広告が表示される期間として指定されます。

同じ日に追加できる AdSchedule は 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 は 1 日の終わりを表します。このフィールドは 0 ~ 24 の値にする必要があります。

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

AdTextAsset

広告内で使用されるテキスト アセット。

フィールド
text

string

アセットのテキスト。

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 つの広告(または広告セット)をユーザーに表示する最大回数を指定するルール。

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

FeedItem がターゲットに設定されている FeedItemSets です。複数の 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)オプション。コンバージョン アクション 1 回に対して支出する平均金額を、入札戦略の通貨のマイクロ単位で指定します。設定すると、目標コンバージョン単価以下で最大限のコンバージョンを獲得できます。目標コンバージョン単価が設定されていない場合、入札戦略は、予算内で可能な限り低いコンバージョン単価の達成を目指します。

指標

指標データ。

フィールド
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

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

average_cpm

double

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

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)による費用の総額。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

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

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

average_quality_score

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

予算の低さが原因で、広告が検索結果ページの上位の広告の 1 番目に入らなかった頻度の推定値です。注: 検索予算の検索広告の最上部インプレッション シェア損失率は、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

上位の広告の 1 つとして実際に獲得できたインプレッション数と、上位の広告として獲得可能だったインプレッション数の推定値を比較したものです。注: 検索の検索広告のページ上部インプレッション シェアは、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 ドルです。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

cross_sell_cost_of_goods_sold_micros

int64

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

client_account_cross_sell_gross_profit_micros

int64

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

cross_sell_gross_profit_micros

int64

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

client_account_cross_sell_revenue_micros

int64

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

cross_sell_revenue_micros

int64

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

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 ドルとなります。この指標は、カート コンバージョン レポートでのみ使用できます。この指標は金銭的価値であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。

lead_cost_of_goods_sold_micros

int64

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

client_account_lead_gross_profit_micros

int64

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

lead_gross_profit_micros

int64

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

client_account_lead_revenue_micros

int64

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

lead_revenue_micros

int64

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

client_account_lead_units_sold

double

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

lead_units_sold

double

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

MobileAppAsset

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

フィールド
app_id

string

必須。モバイルアプリを一意に識別する文字列。「com.android.ebay」のようにプラットフォームのネイティブ ID のみを含めてください。Android または「12345689」追加できます

app_store

MobileAppVendor

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

PercentCpc

商品やサービスの広告価格の比率で入札する入札戦略。

フィールド
cpc_bid_ceiling_micros

int64

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

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

区切り文字でパス 1 に追加されるテキスト。

ad_tracking_id

int64

広告のトラッキング ID。

SearchAds360ProductAdInfo

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

検索広告 360 の商品広告。

SearchAds360ResponsiveSearchAdInfo

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

フィールド
headlines[]

AdTextAsset

広告見出しのテキスト アセットのリスト。広告が配信されると、このリストから広告見出しが選択されます。

descriptions[]

AdTextAsset

説明のテキスト アセットのリスト。広告が配信されると、このリストから説明文が選択されます。

path1

string

自動生成された表示 URL に付加される、区切り文字付きのテキスト。

path2

string

区切り文字でパス 1 に追加されるテキスト。

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)。

geo_target_city

string

都市を表す地域ターゲティング定数のリソース名。

geo_target_country

string

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

geo_target_metro

string

大都市圏を表す地域ターゲティング定数のリソース名。

geo_target_region

string

リージョンを表す地域ターゲティング定数のリソース名。

hour

int32

時間帯(0 ~ 23 の数値)。

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 年 4 月 1 日から始まります。形式は yyyy-MM-dd です。

week

string

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

year

int32

年(yyyy 形式)。

asset_interaction_target

AssetInteractionTarget

CustomerAsset、CampaignAsset、AdGroupAsset の指標でのみ使用。インタラクションの指標が、アセット自体で発生したのか、別のアセットや広告ユニットで発生したのかを示します。インタラクション(クリックなど)は、広告が同時に配信された場合、その広告のすべての要素(広告自体とサイトリンクなどのコンポーネント)全体でカウントされます。transaction_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

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

目標インプレッション単価(CPM)は自動入札戦略の一種で、設定した目標インプレッション単価で掲載結果が最適化されるように入札単価が設定されます。

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

ラベルの背景色(16 進数形式)。この文字列は、正規表現「^#([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 とアセットタイプごとに一意です。プレイス 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!Japan のみの項目が表示されます。

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 文字の文字列値です。