Package google.ads.searchads360.v0.common

インデックス

AdScheduleInfo

広告スケジュールの条件を表します。

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 は当日を意味します。このフィールドは 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

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

特定の期間中にユーザーに表示できる広告(または広告セット)の最大回数を指定するルール。

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

ターゲットとなるフィードアイテムを含むフィードアイテムセット。複数の 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

すべてのクリックの合計費用を、発生したクリックの合計数で割った値。この指標は金額であり、デフォルトではお客様の通貨で返されます。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

入札単価設定可能なコンバージョン 1 件あたりの平均コンバージョン対象費用。

cost_per_current_model_attributed_conversion

double

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

cross_device_conversions

double

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

cross_device_conversions_by_conversion_date

double

コンバージョンの日付別のクロスデバイス コンバージョン数。by_conversion_date 列について詳しくは、https://support.google.com/sa360/answer/9250611 をご覧ください。

cross_device_conversions_value

double

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

cross_device_conversions_value_by_conversion_date

double

コンバージョンの日付別のクロスデバイス コンバージョン値の合計。by_conversion_date 列の詳細については、https://support.google.com/sa360/answer/9250611 をご覧ください。

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 が不正と判断し、料金を請求しないクリック数です。

general_invalid_click_rate

double

一般的な無効なクリックであるという理由で、総クリック数(除外されたクリック数 + 除外されなかったクリック数)から除外されたクリック数の割合。これらは、Google が無効と判断したクリック(既知の無効なデータセンター トラフィック、bot、スパイダーなどのクローラー、不規則なパターンなど)で、定期的なフィルタリング手段によって検出されます。無効なクリックに対しては料金が発生せず、アカウントのデータに影響することもありません。詳しくは、ヘルプページ(https://support.google.com/campaignmanager/answer/6076504)をご覧ください。

general_invalid_clicks

int64

一般的な無効なクリックの数。これらは、定期的なフィルタリング手段によって検出された無効なクリックのサブセット(既知の無効なデータセンター トラフィック、bot、スパイダーなどのクローラー、不規則なパターンなど)です。無効なクリックに対しては料金が発生せず、アカウントのデータに影響することもありません。詳しくは、https://support.google.com/campaignmanager/answer/6076504 のヘルプページをご覧ください。

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

入札単価設定に使用されるコンバージョンの値を、入札単価設定に使用されるコンバージョン数で割った値。入札対象のコンバージョン 1 件あたりの推定平均価値が表示されます。

value_per_conversions_by_conversion_date

double

コンバージョンの日付別の入札対象コンバージョン値を、コンバージョンの日付別の入札対象コンバージョンで割った値。入札対象のコンバージョン 1 件あたりの価値の平均(コンバージョンの日付別)が表示されます。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。

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

必須。モバイルアプリを一意に識別する文字列。プラットフォームのネイティブ ID のみを含めてください(Android の場合は「com.android.ebay」、iOS の場合は「12345689」)。

app_store

MobileAppVendor

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

PercentCpc

商品やサービスの広告掲載価格の一部を入札単価とする入札戦略。

フィールド
cpc_bid_ceiling_micros

int64

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

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 の指標でのみ使用されます。インタラクション指標がアセット自体で発生したか、別のアセットまたは広告ユニットで発生したかを示します。インタラクション(クリックなど)は、配信された広告のすべての部分(広告自体やサイトリンクなどのコンポーネント)でカウントされます(これらの部分が一緒に配信された場合)。interaction_on_this_asset が true の場合、この特定のアセットでインタラクションが発生したことを意味します。interaction_on_this_asset が false の場合、この特定のアセットではなく、このアセットとともに配信された広告の他の部分でインタラクションが発生したことを意味します。

TargetCpa

指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が調整される自動入札戦略です。

フィールド
target_cpa_micros

int64

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

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

TargetCpm

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

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

TargetImpressionShare

検索広告の一定の割合が検索結果の 1 ページ目上部(または他の目標掲載位置)に表示されるように入札単価を設定する自動入札戦略。

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

この targeting_dimension で選択した条件にのみ広告を表示するか、この targeting_dimension のすべての値をターゲットに設定し、他の TargetingDimensions のターゲティングに基づいて広告を表示するかを指定します。値が 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})$」に一致する必要があります。注: マネージャー アカウントでは、背景色が表示されないことがあります。

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 Advertising に適用されます。

call_tracking_enabled

bool

通話を電話トラッキングで有効にするかどうか。Microsoft Advertising に適用されます。

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 Advertising に適用されます。

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! の日本国内のみのフィールド。

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

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

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

YoutubeVideoAsset

YouTube アセット。

フィールド
youtube_video_title

string

YouTube 動画のタイトル。

youtube_video_id

string

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