SearchAds360Row

クエリから返された行。

JSON 表現 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
フィールド
adGroup

object (AdGroup)

クエリで参照される広告グループ。
adGroupAd

object (AdGroupAd)

クエリで参照されている広告。
adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

クエリで参照される広告グループ広告の有効なラベル。
adGroupAdLabel

object (AdGroupAdLabel)

クエリで参照される広告グループ広告ラベル。
adGroupAsset

object (AdGroupAsset)

クエリで参照される広告グループのアセット。
adGroupAssetSet

object (AdGroupAssetSet)

クエリで参照される広告グループ アセット セット。
adGroupAudienceView

object (AdGroupAudienceView)

クエリで参照される広告グループのオーディエンス ビュー。
adGroupBidModifier

object (AdGroupBidModifier)

クエリで参照される入札単価調整比。
adGroupCriterion

object (AdGroupCriterion)

クエリで参照される条件。
adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

クエリで参照される広告グループの条件の有効なラベル。
adGroupCriterionLabel

object (AdGroupCriterionLabel)

クエリで参照される広告グループの条件ラベル。
adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

クエリで参照される広告グループの有効なラベル。
adGroupLabel

object (AdGroupLabel)

クエリで参照される広告グループ ラベル。
ageRangeView

object (AgeRangeView)

クエリで参照される年齢層ビュー。
asset

object (Asset)

クエリで参照されるアセット。
assetGroupAsset

object (AssetGroupAsset)

クエリで参照されるアセット グループ アセット。
assetGroupSignal

object (AssetGroupSignal)

クエリで参照されるアセット グループ シグナル。
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

クエリで参照されるアセット グループのリスティング グループのフィルタ。
assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

クエリで参照されるアセット グループの上位の組み合わせビュー。
assetGroup

object (AssetGroup)

クエリで参照されるアセット グループ。
assetSetAsset

object (AssetSetAsset)

クエリで参照されるアセットセットのアセット。
assetSet

object (AssetSet)

クエリで参照されるアセットセット。
biddingStrategy

object (BiddingStrategy)

クエリで参照される入札戦略。
campaignBudget

object (CampaignBudget)

クエリで参照されるキャンペーンの予算。
campaign

object (Campaign)

クエリで参照されるキャンペーン。
campaignAsset

object (CampaignAsset)

クエリで参照されるキャンペーン アセット。
campaignAssetSet

object (CampaignAssetSet)

クエリで参照されるキャンペーン アセットセット。
campaignAudienceView

object (CampaignAudienceView)

クエリで参照されるキャンペーン オーディエンス ビュー。
campaignCriterion

object (CampaignCriterion)

クエリで参照されるキャンペーン条件。
campaignEffectiveLabel

object (CampaignEffectiveLabel)

クエリで参照されるキャンペーンの有効なラベル。
campaignLabel

object (CampaignLabel)

クエリで参照されるキャンペーン ラベル。
cartDataSalesView

object (CartDataSalesView)

クエリで参照されるカートデータ販売ビュー。
audience

object (Audience)

クエリで参照されるオーディエンス。
conversionAction

object (ConversionAction)

クエリで参照されるコンバージョン アクション。
conversionCustomVariable

object (ConversionCustomVariable)

クエリで参照されるコンバージョン カスタム変数。
customer

object (Customer)

クエリで参照されるお客様。
customerAsset

object (CustomerAsset)

クエリで参照される顧客アセット。
customerAssetSet

object (CustomerAssetSet)

クエリで参照される顧客アセット セット。
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

クエリで参照されるアクセス可能な入札戦略。
customerClient

object (CustomerClient)

クエリで参照される CustomerClient。
dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

クエリで参照される動的検索広告の検索語句ビュー。
genderView

object (GenderView)

クエリで参照される性別ビュー。
geoTargetConstant

object (GeoTargetConstant)

クエリで参照される地域ターゲティング定数。
keywordView

object (KeywordView)

クエリで参照されるキーワード ビュー。
label

object (Label)

クエリで参照されるラベル。
languageConstant

object (LanguageConstant)

クエリで参照される言語定数。
locationView

object (LocationView)

クエリで参照されるロケーション ビュー。
productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

クエリで参照される商品入札カテゴリ。
productGroupView

object (ProductGroupView)

クエリで参照される商品グループ ビュー。
shoppingPerformanceView

object (ShoppingPerformanceView)

クエリで参照されるショッピングのパフォーマンス ビュー。
userList

object (UserList)

クエリで参照されるユーザーリスト。
userLocationView

object (UserLocationView)

クエリで参照されるユーザーのロケーション ビュー。
webpageView

object (WebpageView)

クエリで参照されるウェブページ ビュー。
visit

object (Visit)

クエリで参照されるイベント単位の来店数。
conversion

object (Conversion)

クエリで参照されるイベント単位のコンバージョン。
metrics

object (Metrics)

指標。
segments

object (Segments)

セグメント。
customColumns[]

object (Value)

カスタム列。

広告グループ

広告グループ。

JSON 表現 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
フィールド
resourceName

string

広告グループのリソース名。広告グループのリソース名の形式は次のとおりです。

customers/{customerId}/adGroups/{ad_group_id}
status

enum (AdGroupStatus)

広告グループのステータス。
type

enum (AdGroupType)

広告グループのタイプ。
adRotationMode

enum (AdGroupAdRotationMode)

広告グループの広告のローテーション モード。
creationTime

string

この adGroup が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。
targetingSetting

object (TargetingSetting)

ターゲティング関連機能の設定。
labels[]

string

この広告グループに適用されているラベルのリソース名。
effectiveLabels[]

string

この広告グループに適用されている有効なラベルのリソース名。有効なラベルとは、この広告グループに継承または直接割り当てられたラベルのことです。
engineId

string

外部エンジン アカウントの広告グループの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます（Yahoo! Japan、Microsoft、Baidu など）。Google 広告エンティティの場合は、代わりに「adGroup.id」を使用します。
startDate

string

この広告グループの広告配信を開始する日付。デフォルトでは、広告グループの開始日は、現在または開始日のいずれか遅い方になります。このフィールドを設定した場合、ユーザーのタイムゾーンで指定の日付の開始時間に広告グループが開始されます。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。

形式: YYYY-MM-DD 例: 2019-03-14
endDate

string

広告グループの広告配信を終了する日付。デフォルトでは、広告グループは広告グループの終了日に終了します。このフィールドが設定されている場合、ユーザーのタイムゾーンで指定の日付に広告グループが終了します。このフィールドは、Microsoft Advertising アカウントと Facebook ゲートウェイ アカウントでのみ使用できます。

形式: YYYY-MM-DD 例: 2019-03-14
languageCode

string

広告グループ内の広告とキーワードの言語。このフィールドは、Microsoft Advertising アカウントでのみご利用いただけます。詳細: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
lastModifiedTime

string

この広告グループが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。
id

string (int64 format)

広告グループの ID です。
name

string

広告グループの名前です。

このフィールドは必須です。新しい広告グループを作成する場合は空にしないでください。

含めることができる文字は、UTF-8 の全角で 255 文字未満にする必要があります。

null（コードポイント 0x0）、NL ラインフィード（コードポイント 0xA）、改行（コードポイント 0xD）の文字を含めることはできません。
trackingUrlTemplate

string

トラッキング URL を作成するための URL テンプレート。
cpcBidMicros

string (int64 format)

最大 CPC（クリック単価）入札。
engineStatus

enum (AdGroupEngineStatus)

広告グループのエンジン ステータス。
finalUrlSuffix

string

パラメータを最終ページ URL に追加するための URL テンプレート。

AdGroupStatus

広告グループのステータスとして指定可能な値。

列挙型
UNSPECIFIED ステータスが指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
ENABLED 広告グループが有効になっている。
PAUSED 広告グループが一時停止されている。
REMOVED 広告グループが削除されます。

AdGroupType

広告グループの可能なタイプを列挙する列挙型。

列挙型
UNSPECIFIED タイプが指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
SEARCH_STANDARD 検索キャンペーンの広告グループのデフォルトのタイプ。
DISPLAY_STANDARD ディスプレイ キャンペーンのデフォルトの広告グループ タイプ。
SHOPPING_PRODUCT_ADS 標準的な商品広告を配信するショッピング キャンペーンの広告グループ タイプ。
SHOPPING_SHOWCASE_ADS ショッピングの検索結果にショーケース広告または販売者広告のみを表示する広告グループのタイプ。
HOTEL_ADS ホテル キャンペーンのデフォルトの広告グループ タイプ。
SHOPPING_SMART_ADS スマート ショッピング キャンペーンの広告グループのタイプ。
VIDEO_BUMPER 短いスキップ不可のインストリーム動画広告。
VIDEO_TRUE_VIEW_IN_STREAM TrueView（スキップ可能）インストリーム動画広告。
VIDEO_TRUE_VIEW_IN_DISPLAY TrueView インディスプレイ動画広告。
VIDEO_NON_SKIPPABLE_IN_STREAM スキップ不可のインストリーム動画広告。
VIDEO_OUTSTREAM アウトストリーム動画広告。
SEARCH_DYNAMIC_ADS 動的検索広告の広告グループの広告グループ タイプ。
SHOPPING_COMPARISON_LISTING_ADS ショッピング比較広告キャンペーンの広告グループのタイプ。
PROMOTED_HOTEL_ADS プロモーション対象ホテルの広告グループの広告グループ タイプ。
VIDEO_RESPONSIVE 動画レスポンシブ広告グループ。
VIDEO_EFFICIENT_REACH 動画の効率的なリーチの広告グループ。
SMART_CAMPAIGN_ADS スマート キャンペーンの広告グループ タイプ。
TRAVEL_ADS 旅行キャンペーンの広告グループ タイプ。

AdGroupAdRotationMode

広告グループの広告のローテーション モード。

列挙型
UNSPECIFIED 広告のローテーション モードが指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
OPTIMIZE クリック数またはコンバージョン数に基づいて広告グループの広告を最適化します。
ROTATE_FOREVER 永久に均等にローテーションします。

AdGroupEngineStatus

広告グループ エンジンのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AD_GROUP_ELIGIBLE

非推奨です。使用しないでください。
AD_GROUP_EXPIRED 広告グループの終了日が過ぎたため、この広告グループに対して広告が掲載されていません。
AD_GROUP_REMOVED 広告グループは削除されています。
AD_GROUP_DRAFT 関連付けられている広告グループがまだ下書きの状態であるため、この広告グループでは広告が配信されていません。
AD_GROUP_PAUSED 広告グループが一時停止されています。
AD_GROUP_SERVING 広告グループは有効で、現在広告が配信されています。
AD_GROUP_SUBMITTED 広告グループが送信されました（Microsoft Bing Ads の以前のステータス）。
CAMPAIGN_PAUSED キャンペーンが一時停止されているため、この広告グループの広告は配信されていません。
ACCOUNT_PAUSED アカウントが一時停止されているため、この広告グループの広告は掲載されていません。

TargetingSetting

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

JSON 表現 
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
フィールド
targetRestrictions[]

object (TargetRestriction)

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

TargetRestriction

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

JSON 表現 
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
フィールド
targetingDimension

enum (TargetingDimension)

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

boolean

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

TargetingDimension

ターゲット設定可能なディメンションを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
KEYWORD キーワード条件（例: 「火星クルーズ」）。KEYWORD はカスタム入札ディメンションとして使用できます。キーワードは常にターゲティング ディメンションであるため、TargetRestriction でターゲット「ALL」ディメンションとして設定することはできません。
AUDIENCE オーディエンス条件（ユーザーリスト、ユーザーの興味 / 関心、カスタム アフィニティ、カスタム 購買意向の強いユーザーを含む）。
TOPIC コンテンツのカテゴリをターゲットに設定するためのトピック条件（例: category::Animals>Pets）。ディスプレイ広告と動画広告のターゲティングに使用されます。
GENDER 性別をターゲットに設定するための条件。
AGE_RANGE 年齢層をターゲットに設定するための条件。
PLACEMENT プレースメント条件（「www.flowers4sale.com」などのウェブサイト、モバイルアプリ、モバイルアプリのカテゴリ、YouTube 動画、YouTube チャンネルなど）。
PARENTAL_STATUS 子供の有無によるターゲティングの条件。
INCOME_RANGE 所得別グループ ターゲティングの条件。

AdGroupAd

広告グループの広告。

JSON 表現 
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
フィールド
resourceName

string

広告のリソース名。広告グループ広告のリソース名の形式は次のとおりです。

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}
status

enum (AdGroupAdStatus)

広告のステータスです。
ad

object (Ad)

広告。
creationTime

string

この adGroupAd が作成されたときのタイムスタンプ。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。
labels[]

string

この広告グループの広告に適用されているラベルのリソース名。
effectiveLabels[]

string

この広告に適用されている有効なラベルのリソース名。有効なラベルとは、この広告に継承または直接割り当てられたラベルのことです。
engineId

string

外部エンジン アカウントの広告の ID。このフィールドは検索広告 360 アカウント（Yahoo、Microsoft、Baidu など）専用です。検索広告 360 以外のエンティティの場合は、代わりに「adGroupAd.ad.id」を使用します。
engineStatus

enum (AdGroupAdEngineStatus)

外部エンジン アカウントの広告の追加ステータス。外部アカウントの種類によって、アクティブ、有効、確認待ちなどのステータスが表示されます。
lastModifiedTime

string

この広告グループの広告が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。

AdGroupAdStatus

AdGroupAd のステータス。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
ENABLED 広告グループの広告が有効になっている。
PAUSED 広告グループの広告が一時停止されています。
REMOVED 広告グループの広告が削除されます。

FinalAppUrl

特定のオペレーティング システムのアプリにディープリンクするための URL。

JSON 表現 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
フィールド
osType

enum (AppUrlOperatingSystemType)

この URL のターゲット オペレーティング システム。必須。
url

string

アプリのディープリンク URL。ディープリンクは、表示したいコンテンツに対応するアプリ内の場所を指定するもので、{scheme}://{host_path} の形式にする必要があります。スキームは、開くアプリを識別します。アプリでは、アプリ名で始まるカスタム スキームを使用できます。ホストとパスは、コンテンツが存在するアプリ内の固有の場所を指定します。例: 「exampleapp://productid_1234」。必須。

AppUrlOperatingSystemType

オペレーティング システム

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
IOS Apple IOS オペレーティング システム。
ANDROID Android オペレーティング システム。

AdType

広告の可能なタイプ。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
TEXT_AD 広告がテキスト広告である。
EXPANDED_TEXT_AD 広告が拡張テキスト広告である。
CALL_ONLY_AD 広告は電話専用広告です。
EXPANDED_DYNAMIC_SEARCH_AD 広告は拡張動的検索広告です。
HOTEL_AD 広告はホテル広告です。
SHOPPING_SMART_AD 広告がスマート ショッピング広告である。
SHOPPING_PRODUCT_AD 広告は標準のショッピング広告です。
VIDEO_AD 広告が動画広告である。
GMAIL_AD この広告は Gmail 広告です。
IMAGE_AD この広告はイメージ広告です。
RESPONSIVE_SEARCH_AD 広告がレスポンシブ検索広告である。
LEGACY_RESPONSIVE_DISPLAY_AD 広告が従来のレスポンシブ ディスプレイ広告である。
APP_AD 広告がアプリ広告である。
LEGACY_APP_INSTALL_AD 広告が従来のアプリ インストール広告である。
RESPONSIVE_DISPLAY_AD 広告がレスポンシブ ディスプレイ広告である。
LOCAL_AD 広告がローカル広告である。
HTML5_UPLOAD_AD 広告は、商品タイプが HTML5_UPLOAD_AD のディスプレイ アップロード広告です。
DYNAMIC_HTML5_AD 広告は、DYNAMIC_HTML5_* 商品カテゴリのいずれかを含むディスプレイ アップロード広告です。
APP_ENGAGEMENT_AD 広告がアプリ エンゲージメント広告である。
SHOPPING_COMPARISON_LISTING_AD 広告がショッピング比較広告である。
VIDEO_BUMPER_AD バンパー動画広告。
VIDEO_NON_SKIPPABLE_IN_STREAM_AD 動画のスキップ不可のインストリーム広告。
VIDEO_OUTSTREAM_AD アウトストリーム動画広告。
VIDEO_TRUEVIEW_DISCOVERY_AD 動画 TrueView インディスプレイ広告。
VIDEO_TRUEVIEW_IN_STREAM_AD 動画の TrueView インストリーム広告。
VIDEO_RESPONSIVE_AD 動画レスポンシブ広告。
SMART_CAMPAIGN_AD スマート アシスト キャンペーンの広告。
APP_PRE_REGISTRATION_AD ユニバーサル アプリの事前登録広告。
DISCOVERY_MULTI_ASSET_AD ファインド マルチアセット広告。
TRAVEL_AD 旅行広告。
DISCOVERY_VIDEO_RESPONSIVE_AD ファインド動画レスポンシブ広告。
MULTIMEDIA_AD マルチメディア広告。

SearchAds360TextAdInfo

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

JSON 表現 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
フィールド
headline

string

広告の見出しです。
description1

string

広告の説明欄の 1 行目。
description2

string

広告の説明欄の 2 行目。
displayUrl

string

広告の表示 URL。
displayMobileUrl

string

広告のモバイル用表示 URL。
adTrackingId

string (int64 format)

広告のトラッキング ID。

SearchAds360ExpandedTextAdInfo

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

JSON 表現 
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
フィールド
headline

string

広告の見出しです。
headline2

string

広告の 2 番目の見出し。
headline3

string

広告の 3 番目の見出し。
description1

string

広告の説明欄の 1 行目。
description2

string

広告の説明欄の 2 行目。
path1

string

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

string

区切り文字を使用して path1 に追加されたテキスト。
adTrackingId

string (int64 format)

広告のトラッキング ID。

SearchAds360ResponsiveSearchAdInfo

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

JSON 表現 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
フィールド
headlines[]

object (AdTextAsset)

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

object (AdTextAsset)

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

string

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

string

区切り文字を使用して path1 に追加されたテキスト。
adTrackingId

string (int64 format)

広告のトラッキング ID。

AdTextAsset

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

JSON 表現 
{
  "text": string
}
フィールド
text

string

アセット テキスト。

SearchAds360ProductAdInfo

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

検索広告 360 の商品広告。

SearchAds360ExpandedDynamicSearchAdInfo

拡張動的検索広告。

JSON 表現 
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
フィールド
description1

string

広告の説明欄の 1 行目。
description2

string

広告の説明欄の 2 行目。
adTrackingId

string (int64 format)

広告のトラッキング ID。

AdGroupAdEngineStatus

AdGroupAd エンジン ステータスを列挙します。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AD_GROUP_AD_ELIGIBLE

非推奨です。使用しないでください。
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: クリエイティブが承認されませんでした。
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW バイドゥ: モバイル URL が審査中です。
AD_GROUP_AD_PARTIALLY_INVALID Baidu: クリエイティブがモバイル デバイスでは無効だが、パソコンでは有効。
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: クリエイティブを有効化する準備が整いました。
AD_GROUP_AD_NOT_REVIEWED Baidu: クリエイティブの審査が完了していません。
AD_GROUP_AD_ON_HOLD

非推奨です。使用しない。以前に Gemini で使用されていた
AD_GROUP_AD_PAUSED クリエイティブが一時停止されました。
AD_GROUP_AD_REMOVED クリエイティブが削除されました。
AD_GROUP_AD_PENDING_REVIEW クリエイティブは審査待ちです。
AD_GROUP_AD_UNDER_REVIEW クリエイティブは審査中です。
AD_GROUP_AD_APPROVED クリエイティブが承認されました。
AD_GROUP_AD_DISAPPROVED クリエイティブが不承認になりました。
AD_GROUP_AD_SERVING クリエイティブが配信中です。
AD_GROUP_AD_ACCOUNT_PAUSED アカウントが一時停止中のため、クリエイティブは一時停止されています。
AD_GROUP_AD_CAMPAIGN_PAUSED キャンペーンが一時停止されているため、クリエイティブが一時停止されています。
AD_GROUP_AD_AD_GROUP_PAUSED 広告グループが一時停止されているため、クリエイティブが一時停止されています。

AdGroupAdEffectiveLabel

広告グループ広告と効果的なラベルの関係。有効なラベルとは、この広告グループ広告に継承または直接割り当てられたラベルのことです。

JSON 表現 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
フィールド
resourceName

string

広告グループ広告の有効なラベルのリソース名。広告グループ広告の有効なラベルのリソース名の形式は customers/{ownerCustomerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id} です。
adGroupAd

string

有効なラベルが添付されている広告グループ広告。
label

string

広告グループ広告に割り当てられている有効なラベル。
ownerCustomerId

string (int64 format)

有効なラベルを所有するお客様の ID。

AdGroupAdLabel

広告グループ広告とラベルの関係。

JSON 表現 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
フィールド
resourceName

string

広告グループ広告ラベルのリソース名です。広告グループ広告ラベルのリソース名の形式は、customers/{ownerCustomerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id} です。
adGroupAd

string

ラベルが添付される広告グループ広告。
label

string

広告グループ広告に割り当てられるラベル。
ownerCustomerId

string (int64 format)

ラベルを所有するお客様の ID。

AdGroupAsset

広告グループとアセット間のリンク。

JSON 表現 
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
フィールド
resourceName

string

広告グループ アセットのリソース名。AdGroupAsset リソース名の形式は次のとおりです。

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}
adGroup

string

必須。アセットがリンクされている広告グループ。
asset

string

必須。広告グループにリンクされているアセットです。
status

enum (AssetLinkStatus)

広告グループ アセットのステータス。

AssetLinkStatus

アセットリンクのステータスを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED アセットリンクが有効になっている。
REMOVED アセットリンクが削除されました。
PAUSED アセットリンクが一時停止されています。

AdGroupAssetSet

AdGroupAssetSet は、広告グループとアセットセット間のリンクです。AdGroupAssetSet を作成すると、アセット セットが広告グループにリンクされます。

JSON 表現 
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
フィールド
resourceName

string

広告グループ アセットセットのリソース名。広告グループ アセットセットのリソース名の形式は次のとおりです。

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
adGroup

string

このアセットセットがリンクされている広告グループ。
assetSet

string

広告グループにリンクされているアセットセット。
status

enum (AssetSetLinkStatus)

広告グループのアセット セットのステータス。読み取り専用です。

AssetSetLinkStatus

アセットセットとそのコンテナ間のリンクのステータス。

列挙型
UNSPECIFIED ステータスが指定されていません。
UNKNOWN このバージョンでは、受信した値が不明です。これはレスポンス専用の値です。
ENABLED アセットセットとそのコンテナ間のリンクが有効になっています。
REMOVED アセットセットとそのコンテナ間のリンクが削除されます。

AdGroupAudienceView

広告グループのオーディエンス ビュー。ディスプレイ ネットワークと YouTube ネットワークの広告のインタレスト カテゴリとリマーケティング リスト、および検索広告向けリマーケティング リスト（RLSA）のパフォーマンス データが、オーディエンス単位で集計されて含まれます。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

広告グループ オーディエンス ビューのリソース名。広告グループ オーディエンス ビューのリソース名の形式は次のとおりです。

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

広告グループの入札単価調整比を表します。

JSON 表現 
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
フィールド
resourceName

string

広告グループの入札単価調整比のリソース名。広告グループの入札単価調整比のリソース名の形式は次のとおりです。

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}
bidModifier

number

条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。PreferredContent の範囲は 1.0～6.0 です。デバイスタイプをオプトアウトするには、0 を使用します。

共用体フィールド criterion。この広告グループの入札単価調整比の条件。

V5 以降の作成オペレーションで必須。criterion は次のいずれかになります。
device

object (DeviceInfo)

デバイス条件。

DeviceInfo

デバイス条件。

JSON 表現 
{
  "type": enum (Device)
}
フィールド
type

enum (Device)

端末のタイプ。

デバイス

ターゲティングに使用できる Google 広告のデバイスを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
MOBILE フル インターネット ブラウザ搭載のモバイル デバイス。
TABLET フル インターネット ブラウザ搭載のタブレット。
DESKTOP パソコン] を選択します。
CONNECTED_TV スマートテレビとゲーム機。
OTHER その他のデバイスタイプ。

AdGroupCriterion

広告グループの条件。adGroupCriterion レポートでは、広告グループに明示的に追加された条件のみが返されます。

JSON 表現 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
フィールド
resourceName

string

広告グループの条件のリソース名。広告グループの条件のリソース名の形式は次のとおりです。

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}
creationTime

string

この広告グループの条件が作成された時点のタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。
status

enum (AdGroupCriterionStatus)

条件のステータス。

これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。
qualityInfo

object (QualityInfo)

条件の品質に関する情報。
type

enum (CriterionType)

条件のタイプ。
labels[]

string

この広告グループの条件に適用されているラベルのリソース名。
effectiveLabels[]

string

この広告グループの条件に適用されている有効なラベルのリソース名。有効なラベルとは、この広告グループの条件に継承または直接割り当てられたラベルのことです。
positionEstimates

object (PositionEstimates)

さまざまなポジションの条件別入札単価の見積もり。
finalUrls[]

string

広告のすべてのクロスドメイン リダイレクトの後に可能性のある最終ページ URL のリスト。
finalMobileUrls[]

string

すべてのクロスドメイン リダイレクトの後に可能性のあるモバイルの最終ページ URL のリスト。
urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate、finalUrls、mobile_final_urls でカスタム パラメータ タグを置き換えるために使用されるマッピングのリスト。
engineId

string

外部エンジン アカウントの広告グループの条件の ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます（Yahoo! Japan、Microsoft、Baidu など）。Google 広告エンティティの場合は、代わりに「adGroupCriterion.criterion_id」を使用します。
lastModifiedTime

string

この広告グループの条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。
criterionId

string (int64 format)

条件の ID。
adGroup

string

条件が属する広告グループです。
negative

boolean

条件を絞り込むか（false）、除外するか（true）を指定します。

このフィールドは変更できません。評価基準をプラスからマイナスに切り替えるには、削除してから再度追加します。
bidModifier

number

条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。
cpcBidMicros

string (int64 format)

クリック単価（CPC）。
effectiveCpcBidMicros

string (int64 format)

有効 CPC（クリック単価）入札。
engineStatus

enum (AdGroupCriterionEngineStatus)

広告グループのエンジン ステータスの条件。
finalUrlSuffix

string

パラメータを最終ページ URL に追加するための URL テンプレート。
trackingUrlTemplate

string

トラッキング URL を作成するための URL テンプレート。

共用体フィールド criterion。広告グループの条件。

必ず 1 つ設定する必要があります。criterion は次のいずれかになります。
keyword

object (KeywordInfo)

キーワード。
listingGroup

object (ListingGroupInfo)

リスティング グループ。
ageRange

object (AgeRangeInfo)

年齢層。
gender

object (GenderInfo)

性別。
userList

object (UserListInfo)

ユーザーリスト。
webpage

object (WebpageInfo)

ウェブアプリ
location

object (LocationInfo)

位置情報] をタップします。

AdGroupCriterionStatus

AdGroupCriterion のステータス。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
ENABLED 広告グループの条件が有効になっている。
PAUSED 広告グループの条件が一時停止されています。
REMOVED 広告グループの条件が削除されます。

QualityInfo

広告グループの条件の品質情報用のコンテナ。

JSON 表現 
{
  "qualityScore": integer
}
フィールド
qualityScore

integer

品質スコア。

Google が値を決定するための十分な情報を持っていない場合は、このフィールドに値が入力されないことがあります。

CriterionType

使用可能な条件タイプを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
KEYWORD キーワード（例: 「火星クルーズ」）。
PLACEMENT プレースメント（ウェブサイトとも呼ばれます）。例: 「www.flowers4sale.com」
MOBILE_APP_CATEGORY ターゲットとするモバイル アプリケーションのカテゴリ。
MOBILE_APPLICATION ターゲットとするモバイル アプリケーション。
DEVICE ターゲットとするデバイス。
LOCATION ターゲットにする地域。
LISTING_GROUP ターゲットにするリスティング グループ。
AD_SCHEDULE 広告のスケジュール。
AGE_RANGE 年齢層。
GENDER 性別。
INCOME_RANGE 収入の範囲。
PARENTAL_STATUS 子供の有無。
YOUTUBE_VIDEO YouTube 動画。
YOUTUBE_CHANNEL YouTube チャンネル。
USER_LIST ユーザーリスト。
PROXIMITY 近接。
TOPIC ディスプレイ ネットワークのトピック ターゲット（「ペットと動物」など）。
LISTING_SCOPE ターゲットにするリスティング範囲。
LANGUAGE 学びました。
IP_BLOCK IpBlock。
CONTENT_LABEL カテゴリ除外のコンテンツ ラベル。
CARRIER 携帯通信会社] に移動します。
USER_INTEREST ユーザーが関心を持っているカテゴリ。
WEBPAGE 動的検索広告のウェブページ条件。
OPERATING_SYSTEM_VERSION OSの種類です
APP_PAYMENT_MODEL アプリの支払いモデル。
MOBILE_DEVICE モバイル デバイス。
CUSTOM_AFFINITY カスタム アフィニティ。
CUSTOM_INTENT カスタム インテント。
LOCATION_GROUP 地域グループ。
CUSTOM_AUDIENCE カスタム オーディエンス
COMBINED_AUDIENCE 組み合わせオーディエンス
KEYWORD_THEME スマート アシスト キャンペーンのキーワードのテーマ
AUDIENCE オーディエンス
LOCAL_SERVICE_ID ローカル サービス広告のサービス ID。
BRAND ブランド
BRAND_LIST ブランドのリスト
LIFE_EVENT ライフイベント

PositionEstimates

さまざまなポジションの条件別入札単価の見積もり。

JSON 表現 
{
  "topOfPageCpcMicros": string
}
フィールド
topOfPageCpcMicros

string (int64 format)

広告が検索結果の最初のページの上部に表示されるために必要なクリック単価の見積もり。

AdGroupCriterionEngineStatus

AdGroupCriterion のエンジン ステータスを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AD_GROUP_CRITERION_ELIGIBLE

非推奨です。使用しないでください。
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: 入札単価または品質が低すぎて表示できません。
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: 検索ボリュームが少ないため Baidu 側で一時停止されています。
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW バイドゥ: モバイル URL が審査中です。
AD_GROUP_CRITERION_PARTIALLY_INVALID バイドゥ: いずれかのデバイスのランディング ページが無効（他のデバイスのランディング ページは有効）。
AD_GROUP_CRITERION_TO_BE_ACTIVATED バイドゥ: キーワードは作成され、バイドゥ アカウント管理によって一時停止されており、有効化する準備が整っています。
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: バイドゥで審査中です。Gemini: 審査中の条件。
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: 審査対象の基準。
AD_GROUP_CRITERION_ON_HOLD

非推奨です。使用しない。以前に Gemini で使用されていた
AD_GROUP_CRITERION_PENDING_REVIEW Y!J : 審査待ちの条件
AD_GROUP_CRITERION_PAUSED 条件が一時停止されました。
AD_GROUP_CRITERION_REMOVED 評価基準が削除されました。
AD_GROUP_CRITERION_APPROVED 条件が承認されました。
AD_GROUP_CRITERION_DISAPPROVED 条件が不承認になりました。
AD_GROUP_CRITERION_SERVING 条件は有効で、配信中です。
AD_GROUP_CRITERION_ACCOUNT_PAUSED アカウントが一時停止されているため、条件が一時停止されています。

CustomParameter

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

JSON 表現 
{
  "key": string,
  "value": string
}
フィールド
key

string

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

string

置き換える値。

KeywordInfo

キーワード条件。

JSON 表現 
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
フィールド
matchType

enum (KeywordMatchType)

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

string

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

KeywordMatchType

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

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
EXACT 完全一致。
PHRASE フレーズ一致。
BROAD インテント マッチ。

ListingGroupInfo

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

JSON 表現 
{
  "type": enum (ListingGroupType)
}
フィールド
type

enum (ListingGroupType)

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

ListingGroupType

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

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SUBDIVISION リスティング ディメンションに沿った商品の細分化。これらのノードは、リスティング エントリをターゲットとするサービングでは使用されず、ツリーの構造を定義するためだけに使用されます。
UNIT 入札単価を定義する商品リスティング グループ単位。

AgeRangeInfo

年齢層の条件。

JSON 表現 
{
  "type": enum (AgeRangeType)
}
フィールド
type

enum (AgeRangeType)

年齢層のタイプ。

AgeRangeType

ユーザー属性の年齢層のタイプ（18 ～ 24 歳など）。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AGE_RANGE_18_24 18 ～ 24 歳。
AGE_RANGE_25_34 25 ～ 34 歳。
AGE_RANGE_35_44 35 ～ 44 歳。
AGE_RANGE_45_54 45 ～ 54 歳。
AGE_RANGE_55_64 55 ～ 64 歳。
AGE_RANGE_65_UP 65 歳以上。
AGE_RANGE_UNDETERMINED 年齢層が不明。

GenderInfo

性別の条件。

JSON 表現 
{
  "type": enum (GenderType)
}
フィールド
type

enum (GenderType)

性別のタイプ。

GenderType

ユーザー属性の性別のタイプ（女性など）。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
MALE 男性。
FEMALE 女性。
UNDETERMINED 性別未確定。

UserListInfo

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

JSON 表現 
{
  "userList": string
}
フィールド
userList

string

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

WebpageInfo

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

JSON 表現 
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
フィールド
conditions[]

object (WebpageConditionInfo)

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

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

number

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

string

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

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

WebpageConditionInfo

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

JSON 表現 
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
フィールド
operand

enum (WebpageConditionOperand)

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

enum (WebpageConditionOperator)

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

string

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

WebpageConditionOperand

ウェブページ条件のオペランド（ウェブページ条件）。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
URL ウェブページの URL ターゲティング条件を示すオペランド。
CATEGORY ウェブページのカテゴリのターゲティング条件を示すオペランド。
PAGE_TITLE ウェブページのタイトル ターゲティング条件を示すオペランド。
PAGE_CONTENT ウェブページのコンテンツ ターゲティング条件を示すオペランド。
CUSTOM_LABEL ウェブページのカスタムラベルのターゲティング条件を示すオペランド。

WebpageConditionOperator

ウェブページ条件のウェブページ条件演算子。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
EQUALS 引数のウェブ条件が比較対象のウェブ条件と等しい。
CONTAINS 引数ウェブ条件は、比較ウェブ条件の一部です。

LocationInfo

地域条件。

JSON 表現 
{
  "geoTargetConstant": string
}
フィールド
geoTargetConstant

string

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

AdGroupCriterionEffectiveLabel

広告グループ条件と有効なラベルの関係。有効なラベルとは、この広告グループの条件に継承または直接割り当てられたラベルのことです。

JSON 表現 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
フィールド
resourceName

string

広告グループの条件の有効なラベルのリソース名。広告グループ条件の有効なラベルのリソース名の形式は、customers/{ownerCustomerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id} です。
adGroupCriterion

string

有効なラベルが添付されている広告グループ条件。
label

string

広告グループ条件に割り当てられている有効なラベル。
ownerCustomerId

string (int64 format)

有効なラベルを所有するお客様の ID。

AdGroupCriterionLabel

広告グループ条件とラベルの関係。

JSON 表現 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
フィールド
resourceName

string

広告グループ条件ラベルのリソース名。広告グループ条件ラベルのリソース名の形式は、customers/{ownerCustomerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id} です。
adGroupCriterion

string

ラベルが添付される広告グループ条件。
label

string

広告グループ条件に割り当てられるラベル。
ownerCustomerId

string (int64 format)

ラベルを所有するお客様の ID。

AdGroupEffectiveLabel

広告グループと有効なラベルの関係。有効なラベルとは、この広告グループに継承または直接割り当てられたラベルのことです。

JSON 表現 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
フィールド
resourceName

string

広告グループの有効なラベルのリソース名。広告グループの有効なラベルのリソース名の形式は customers/{ownerCustomerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id} です。
adGroup

string

有効なラベルが添付されている広告グループ。
label

string

広告グループに割り当てられている有効なラベル。
ownerCustomerId

string (int64 format)

有効なラベルを所有するお客様の ID。

AdGroupLabel

広告グループとラベルの関係。

JSON 表現 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
フィールド
resourceName

string

広告グループラベルのリソース名。広告グループ ラベルのリソース名の形式は、customers/{ownerCustomerId}/adGroupLabels/{ad_group_id}~{label_id} です。
adGroup

string

ラベルが添付される広告グループ。
label

string

広告グループ広告に割り当てられるラベル。
ownerCustomerId

string (int64 format)

ラベルを所有するお客様の ID。

AgeRangeView

年齢層ビュー。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

年齢範囲ビューのリソース名。年齢範囲ビューのリソース名の形式は次のとおりです。

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

アセット

アセットは広告の一部であり、複数の広告で共有できます。画像（ImageAsset）や動画（YoutubeVideoAsset）などがあります。アセットは不変であり、削除することはできません。アセットの配信を停止するには、アセットを使用しているエンティティからアセットを削除します。

JSON 表現 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
フィールド
resourceName

string

アセットのリソース名。アセット リソース名の形式は次のとおりです。

customers/{customerId}/assets/{assetId}
type

enum (AssetType)

アセットのタイプ。
finalUrls[]

string

すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。
finalMobileUrls[]

string

すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。
urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate、finalUrls、finalMobileUrls で URL カスタム パラメータ タグを置き換えるために使用されるマッピングのリスト。
status

enum (AssetStatus)

アセットのステータス。
creationTime

string

この求人が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。
lastModifiedTime

string

このアセットが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。
id

string (int64 format)

アセットの ID です。
name

string

アセットの省略可能な名前。
trackingUrlTemplate

string

トラッキング URL を作成するための URL テンプレート。
finalUrlSuffix

string

並行トラッキングで配信されるランディング ページ URL にパラメータを追加するための URL テンプレート。
engineStatus

enum (AssetEngineStatus)

アセットのエンジン ステータス。
共用体フィールド asset_data。アセットの特定のタイプ。asset_data は次のいずれかになります。
youtubeVideoAsset

object (YoutubeVideoAsset)

YouTube 動画アセット。
imageAsset

object (ImageAsset)

画像アセット。
textAsset

object (TextAsset)

テキスト アセット。
calloutAsset

object (UnifiedCalloutAsset)

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

object (UnifiedPageFeedAsset)

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

object (MobileAppAsset)

モバイルアプリ アセット。
callAsset

object (UnifiedCallAsset)

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

object (CallToActionAsset)

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

object (UnifiedLocationAsset)

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

AssetType

アセットの可能なタイプを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
YOUTUBE_VIDEO YouTube 動画アセット。
MEDIA_BUNDLE メディア バンドル アセット。
IMAGE 画像アセット。
TEXT テキスト アセット。
LEAD_FORM リードフォーム アセット。
BOOK_ON_GOOGLE 「Google で予約」のアセット。
PROMOTION プロモーション アセット。
CALLOUT コールアウト アセット。
STRUCTURED_SNIPPET 構造化スニペット アセット。
PAGE_FEED ページフィード アセット。
DYNAMIC_EDUCATION 動的な教育アセット。
MOBILE_APP モバイルアプリ アセット。
HOTEL_CALLOUT ホテル コールアウト アセット。
CALL 電話番号アセット。
PRICE 価格アセット。
CALL_TO_ACTION 行動を促すフレーズのアセット。
DYNAMIC_REAL_ESTATE 不動産（動的アセット）。
DYNAMIC_CUSTOM 動的なカスタム アセット。
DYNAMIC_HOTELS_AND_RENTALS ホテルと民泊施設（動的アセット）。
DYNAMIC_FLIGHTS 動的なフライトのアセット。
DYNAMIC_TRAVEL 動的な旅行アセット。
DYNAMIC_LOCAL 動的なローカルのアセット。
DYNAMIC_JOBS 動的なジョブのアセット。
LOCATION 住所アセット。
HOTEL_PROPERTY ホテル物件のアセット。

AssetStatus

アセットのステータス。

列挙型
UNSPECIFIED ステータスが指定されていません。
UNKNOWN このバージョンでは、受信した値が不明です。これはレスポンス専用の値です。
ENABLED アセットが有効になっている。
REMOVED アセットが削除されます。
ARCHIVED アセットがアーカイブされている。
PENDING_SYSTEM_GENERATED アセットはシステムによって生成され、ユーザーの審査待ちの状態です。

AssetEngineStatus

アセット エンジンのステータスを表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SERVING アセットはアクティブです。
SERVING_LIMITED アセットはアクティブな状態ですが、制限されています。
DISAPPROVED アセットは不承認（対象外）です。
DISABLED アセットは無効（保留中）です。
REMOVED アセットは削除されました。

YoutubeVideoAsset

YouTube アセット。

JSON 表現 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
フィールド
youtubeVideoTitle

string

YouTube 動画のタイトル。
youtubeVideoId

string

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

ImageAsset

画像アセット。

JSON 表現 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
フィールド
mimeType

enum (MimeType)

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

object (ImageDimension)

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

string (int64 format)

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

MimeType

MIME タイプ

列挙型
UNSPECIFIED MIME タイプが指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
IMAGE_JPEG image/jpeg の MIME タイプ。
IMAGE_GIF image/gif の MIME タイプ。
IMAGE_PNG image/png の MIME タイプ。
FLASH application/x-shockwave-flash の MIME タイプ。
TEXT_HTML text/html の MIME タイプ。
PDF application/pdf の MIME タイプ。
MSWORD application/msword の MIME タイプ。
MSEXCEL application/vnd.ms-excel の MIME タイプ。
RTF application/rtf の MIME タイプ。
AUDIO_WAV audio/wav の MIME タイプ。
AUDIO_MP3 音声/mp3 の MIME タイプ。
HTML5_AD_ZIP application/x-html5-ad-zip の MIME タイプ。

ImageDimension

元のサイズまたはサイズ変更後の特定のサイズの画像のメタデータ。

JSON 表現 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
フィールド
heightPixels

string (int64 format)

画像の高さ。
widthPixels

string (int64 format)

画像の幅。
url

string

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

TextAsset

テキスト アセット。

JSON 表現 
{
  "text": string
}
フィールド
text

string

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

UnifiedCalloutAsset

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

JSON 表現 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
フィールド
calloutText

string

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

string

このアセットが有効になり、配信を開始できる開始日（yyyy-MM-dd 形式）。
endDate

string

このアセットが有効で、配信が継続されている最終日（yyyy-MM-dd 形式）。
adScheduleTargets[]

object (AdScheduleInfo)

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

boolean

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

AdScheduleInfo

AdSchedule 条件を表します。

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

同じ日に設定できる広告スケジュールは 6 つまでです。

JSON 表現 
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
フィールド
startMinute

enum (MinuteOfHour)

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

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

enum (MinuteOfHour)

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

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

enum (DayOfWeek)

スケジュールが適用される曜日。

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

integer

24 時間形式の開始時間。このフィールドは 0 ～ 23 の範囲で指定する必要があります。

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

integer

終了時間（24 時間形式）。24 は 1 日の終わりを示します。このフィールドは 0 ～ 24 の範囲で指定する必要があります。

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

MinuteOfHour

15 分単位の列挙型。例: 「FIFTEEN」

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
ZERO 正時。
FIFTEEN 15 分経過後。
THIRTY 30 分経過後。
FORTY_FIVE 45 分経過後。

DayOfWeek

曜日（「月曜日」など）を列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
MONDAY 月曜日。
TUESDAY 火曜日。
WEDNESDAY 水曜日。
THURSDAY 木曜日です。
FRIDAY 金曜日。
SATURDAY 指定します。
SUNDAY Sunday

UnifiedSitelinkAsset

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

JSON 表現 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
フィールド
linkText

string

サイトリンクの URL 表示テキスト。この文字列の長さは 1～25 で指定します。
description1

string

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

string

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

string

このアセットが有効になり、配信を開始できる開始日（yyyy-MM-dd 形式）。
endDate

string

このアセットが有効で、配信が継続されている最終日（yyyy-MM-dd 形式）。
adScheduleTargets[]

object (AdScheduleInfo)

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

string (int64 format)

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

boolean

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

boolean

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

UnifiedPageFeedAsset

統合ページ フィードのアセット。

JSON 表現 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
フィールド
pageUrl

string

広告主がターゲットにしたいウェブページ。
labels[]

string

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

MobileAppAsset

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

JSON 表現 
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
フィールド
appId

string

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

enum (MobileAppVendor)

必須。この特定のアプリを配信するアプリストア。

MobileAppVendor

モバイルアプリ ベンダーのタイプ

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
APPLE_APP_STORE Apple App Store のモバイルアプリ ベンダー。
GOOGLE_APP_STORE Google アプリストアのモバイルアプリ ベンダー。

UnifiedCallAsset

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

JSON 表現 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
フィールド
countryCode

string

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

string

広告主様の電話番号（未加工）。例: '1234567890'、'(123)456-7890'
callConversionReportingState

enum (CallConversionReportingState)

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

string

通話コンバージョンを割り当てるコンバージョン アクション。設定されていない場合は、デフォルトのコンバージョン アクションが使用されます。このフィールドは、callConversionReportingState が USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION に設定されている場合にのみ有効です。
adScheduleTargets[]

object (AdScheduleInfo)

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

boolean

電話専用広告で、ウェブサイトへのリンクなしで電話番号のみを表示するかどうか。Microsoft 広告に適用されます。
callTrackingEnabled

boolean

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

boolean

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

string

このアセットが有効になり、配信を開始できる開始日（yyyy-MM-dd 形式）。
endDate

string

このアセットが有効で、配信が継続されている最終日（yyyy-MM-dd 形式）。

CallConversionReportingState

通話コンバージョン アクションの状態に使用できるデータ型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
DISABLED 通話コンバージョン アクションが無効になっています。
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION 通話コンバージョン アクションでは、アカウント単位で設定された通話コンバージョン タイプが使用されます。
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 通話コンバージョン アクションでは、リソース（電話専用広告/電話番号表示オプション）レベルで設定された通話コンバージョン タイプが使用されます。

CallToActionAsset

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

JSON 表現 
{
  "callToAction": enum (CallToActionType)
}
フィールド
callToAction

enum (CallToActionType)

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

CallToActionType

行動を促すフレーズの可能なタイプを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
LEARN_MORE 行動を促すフレーズのタイプは「詳細」です。
GET_QUOTE 行動を促すフレーズのタイプは「見積もりを取得」です。
APPLY_NOW 行動を促すフレーズのタイプは「今すぐ申し込む」です。
SIGN_UP 行動を促すフレーズのタイプは「登録」です。
CONTACT_US 行動を促すフレーズのタイプは「お問い合わせ」です。
SUBSCRIBE 行動を促すフレーズのタイプは「登録」です。
DOWNLOAD 行動を促すフレーズのタイプはダウンロードです。
BOOK_NOW 行動を促すフレーズのタイプは「今すぐ予約」です。
SHOP_NOW 行動を促すフレーズのタイプは「今すぐ購入」です。
BUY_NOW 行動を促すフレーズの種類は「今すぐ購入」です。
DONATE_NOW 行動を促すフレーズのタイプは「今すぐ寄付」です。
ORDER_NOW 行動を促すフレーズのタイプは「今すぐ注文」です。
PLAY_NOW 行動を促すフレーズのタイプは「今すぐプレイ」です。
SEE_MORE 行動を促すフレーズのタイプは「詳細」です。
START_NOW 行動を促すフレーズのタイプは「今すぐ開始」です。
VISIT_SITE 行動を促すフレーズのタイプは「サイトにアクセス」です。
WATCH_NOW 行動を促すフレーズのタイプは「今すぐ視聴」です。

UnifiedLocationAsset

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

JSON 表現 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
フィールド
placeId

string

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

object (BusinessProfileLocation)

お客様のビジネス拠点のリスト。これは、住所アセットがビジネス プロフィール アカウントから同期されている場合にのみ返されます。同じアカウントに、同じプレイス ID を指す複数のビジネス プロフィール リスティングが存在する場合があります。
locationOwnershipType

enum (LocationOwnershipType)

ビジネス拠点の所有権の種類。タイプが BUSINESS_OWNER の場合、住所表示オプションとして配信されます。タイプが AFFILIATE の場合、アフィリエイトの住所表示オプションとして配信されます。

BusinessProfileLocation

リンクされたビジネス プロフィール アカウントから同期されたビジネス プロフィールのビジネス拠点データ。

JSON 表現 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
フィールド
labels[]

string

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

string

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

string (int64 format)

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

LocationOwnershipType

場所の所有権のタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BUSINESS_OWNER 拠点のビジネス オーナー（以前の住所表示オプション - LE）。
AFFILIATE アフィリエイト住所（サードパーティの住所表示オプション - ALE）。

AssetGroupAsset

AssetGroupAsset は、アセットとアセット グループ間のリンクです。AssetGroupAsset を追加すると、アセットがアセット グループにリンクされます。

JSON 表現 
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
フィールド
resourceName

string

アセット グループ アセットのリソース名。アセット グループのアセット リソース名は次の形式になります。

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}
assetGroup

string

このアセット グループのアセットがリンクしているアセット グループ。
asset

string

このアセット グループのアセットがリンクしているアセット。
fieldType

enum (AssetFieldType)

アセット グループ内でのアセットの配置の説明。例: HEADLINE、YOUTUBE_VIDEO など
status

enum (AssetLinkStatus)

アセットとアセット グループ間のリンクのステータス。

AssetFieldType

アセットの配置候補を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
HEADLINE アセットがリンクされ、見出しとして使用されます。
DESCRIPTION アセットは説明として使用するためにリンクされています。
MANDATORY_AD_TEXT アセットは、必須の広告文として使用するためにリンクされています。
MARKETING_IMAGE アセットは、マーケティング画像として使用するためにリンクされています。
MEDIA_BUNDLE アセットは、メディア バンドルとして使用するためにリンクされています。
YOUTUBE_VIDEO アセットが YouTube 動画として使用するためにリンクされます。
BOOK_ON_GOOGLE アセットがリンクされている場合、ホテル キャンペーンで「Google で予約」が有効になっていることを示します。
LEAD_FORM アセットがリンクされ、リードフォーム表示オプションとして使用されます。
PROMOTION アセットがリンクされ、プロモーション表示オプションとして使用されます。
CALLOUT アセットは、コールアウト表示オプションとして使用するためにリンクされています。
STRUCTURED_SNIPPET アセットは、構造化スニペット表示オプションとして使用するためにリンクされています。
MOBILE_APP アセットがモバイルアプリ リンクとして使用されるようにリンクされている。
HOTEL_CALLOUT アセットがリンクされ、ホテルのコールアウト表示オプションとして使用されます。
CALL アセットは、電話番号表示オプションとして使用するためにリンクされています。
PRICE アセットは価格表示オプションとして使用するためにリンクされています。
LONG_HEADLINE アセットは長い広告見出しとして使用するためにリンクされています。
BUSINESS_NAME アセットがビジネス名として使用するためにリンクされています。
SQUARE_MARKETING_IMAGE アセットは、正方形のマーケティング画像として使用するためにリンクされています。
PORTRAIT_MARKETING_IMAGE アセットは、縦向きのマーケティング画像として使用するためにリンクされています。
VIDEO アセットがリンクされ、YouTube 以外のロゴとして使用される。
CALL_TO_ACTION_SELECTION アセットがリンクされ、行動を促すフレーズを選択できるようになります。
AD_IMAGE アセットは、広告画像を選択するためにリンクされています。
HOTEL_PROPERTY アセットがリンクされ、旅行関連の目標達成のための P-MAX キャンペーンでホテル物件として使用されます。
LONG_DESCRIPTION アセットは、長い説明として使用するためにリンクされています。
CALL_TO_ACTION アセットは、行動を促すフレーズとして使用するためにリンクされています。

AssetGroupSignal

AssetGroupSignal は、アセット グループ内のシグナルを表します。シグナルが存在することで、コンバージョンに至る可能性の高いユーザーについて、P-MAX キャンペーンにシグナルを提供できます。P-MAX ではシグナルを使用して、検索、ディスプレイ、動画などのさまざまなネットワークにおけるコンバージョンを特定するため、新しい類似ユーザーまたは購買意向の強い新しいユーザーを探します。

JSON 表現 
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
フィールド
resourceName

string

アセット グループ シグナルのリソース名。アセット グループ シグナル リソース名の形式は次のとおりです。

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}
assetGroup

string

このアセット グループ シグナルが属するアセット グループ。
共用体フィールド signal。アセット グループのシグナル。signal は次のいずれかになります。
audience

object (AudienceInfo)

P-MAX キャンペーンで使用されるオーディエンス シグナル。

AudienceInfo

オーディエンスの条件。

JSON 表現 
{
  "audience": string
}
フィールド
audience

string

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

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter は、アセット グループ内のリスティング グループのフィルタ ツリーノードを表します。

JSON 表現 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
フィールド
resourceName

string

アセット グループのリスティング グループのフィルタのリソース名。アセット グループのリスティング グループのフィルタのリソース名の形式は次のとおりです。

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

このアセット グループのリスティング グループのフィルタが属するアセット グループ。
id

string (int64 format)

ListingGroupFilter の ID。
type

enum (ListingGroupFilterType)

リスティング グループのフィルタノードのタイプ。
vertical

enum (ListingGroupFilterVertical)

現在のノードツリーが表す業種。同じツリー内のすべてのノードは、同じカテゴリに属している必要があります。
caseValue

object (ListingGroupFilterDimension)

このリスティング グループが親を絞り込んでいるディメンション値。ルートグループの場合は未定義。
parentListingGroupFilter

string

親リスティング グループの細分のリソース名。ルート リスティング グループ フィルタノードの場合は null。
path

object (ListingGroupFilterDimensionPath)

このリスティング グループ フィルタを定義するディメンションのパス。

ListingGroupFilterType

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

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SUBDIVISION リスティングのディメンションに沿って商品を分割します。
UNIT_INCLUDED リスティング グループのフィルタのリーフノードが含まれています。
UNIT_EXCLUDED 除外されたリスティング グループ フィルタのリーフノード。

ListingGroupFilterVertical

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

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SHOPPING ショッピング カテゴリを表します。業種は、小売向け P-MAX キャンペーンでのみ使用できます。

ListingGroupFilterDimension

アセット グループのリスティング グループのフィルタのリスティング ディメンション。

JSON 表現 
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
フィールド
共用体フィールド dimension。次のいずれかのタイプのディメンションが常に存在します。dimension は次のいずれかになります。
productBiddingCategory

object (ProductBiddingCategory)

商品アイテムの入札カテゴリ。
productBrand

object (ProductBrand)

商品アイテムのブランド。
productChannel

object (ProductChannel)

商品提案の地域。
productCondition

object (ProductCondition)

商品提案の状態。
productCustomAttribute

object (ProductCustomAttribute)

商品提案のカスタム属性。
productItemId

object (ProductItemId)

アイテムの特典 ID。
productType

object (ProductType)

商品提案のタイプ。

ProductBiddingCategory

特定のレベルの入札カテゴリの 1 つの要素。最上位のカテゴリはレベル 1、その子カテゴリはレベル 2 となります。現在、最大 5 レベルまでサポートされています。ユーザーは、カテゴリのレベルを示すディメンション タイプを指定する必要があります。同じサブディビジョンのすべてのケースで、同じディメンション タイプ（カテゴリ レベル）を使用する必要があります。

JSON 表現 
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
フィールド
level

enum (ListingGroupFilterBiddingCategoryLevel)

分類内のカテゴリのレベルを示します。
id

string (int64 format)

商品の入札カテゴリの ID。

この ID は、この記事（https://support.google.com/merchants/answer/6324436）で説明されている google_product_category ID と同等です。

ListingGroupFilterBiddingCategoryLevel

リスティング グループのフィルタの入札カテゴリのレベル。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
LEVEL1 レベル 1。
LEVEL2 レベル 2。
LEVEL3 レベル 3。
LEVEL4 レベル 4。
LEVEL5 レベル 5。

ProductBrand

商品のブランド。

JSON 表現 
{
  "value": string
}
フィールド
value

string

商品のブランドの文字列値。

ProductChannel

商品提案の地域。

JSON 表現 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
フィールド
channel

enum (ListingGroupFilterProductChannel)

ローカリティの値。

ListingGroupFilterProductChannel

商品提案の地域性を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ONLINE アイテムがオンラインで販売されている。
LOCAL この商品は実店舗で販売されています。

ProductCondition

商品提案の状態。

JSON 表現 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
フィールド
condition

enum (ListingGroupFilterProductCondition)

条件の値。

ListingGroupFilterProductCondition

商品アイテムの状態を表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
NEW 商品の状態が新品である。
REFURBISHED 商品の状態が再生品である。
USED 商品の状態は中古です。

ProductCustomAttribute

商品提案のカスタム属性。

JSON 表現 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
フィールド
index

enum (ListingGroupFilterCustomAttributeIndex)

カスタム属性のインデックスを示します。
value

string

商品のカスタム属性の文字列値。

ListingGroupFilterCustomAttributeIndex

顧客属性のインデックス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
INDEX0 最初のリスティング グループのフィルタのカスタム属性。
INDEX1 2 番目のリスティング グループのフィルタのカスタム属性。
INDEX2 3 つ目のリスティング グループのフィルタのカスタム属性。
INDEX3 4 番目のリスティング グループのフィルタのカスタム属性。
INDEX4 5 番目のリスティング グループのフィルタのカスタム属性。

ProductItemId

アイテムの特典 ID。

JSON 表現 
{
  "value": string
}
フィールド
value

string

ID の値。

ProductType

商品提案のタイプ。

JSON 表現 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
フィールド
level

enum (ListingGroupFilterProductTypeLevel)

タイプのレベル。
value

string

型の値。

ListingGroupFilterProductTypeLevel

商品提案のタイプのレベルを表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
LEVEL1 レベル 1。
LEVEL2 レベル 2。
LEVEL3 レベル 3。
LEVEL4 レベル 4。
LEVEL5 レベル 5。

ListingGroupFilterDimensionPath

リスティング グループ フィルタを定義するディメンションのパスを定義します。

JSON 表現 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
フィールド
dimensions[]

object (ListingGroupFilterDimension)

リスティング グループ フィルタ階層（ルートノードを除く）を通るディメンションの完全なパス。このリスティング グループ フィルタまで。

AssetGroupTopCombinationView

アセット グループのアセットの組み合わせのうち、パフォーマンスの高い組み合わせの使用状況を表示します。

JSON 表現 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
フィールド
resourceName

string

アセット グループのトップの組み合わせビューのリソース名。アセット グループの上位の組み合わせビューのリソース名の形式は、「customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}」です。
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

一緒に配信されたアセットの組み合わせのうち、パフォーマンスの高い組み合わせ。

AssetGroupAssetCombinationData

アセット グループのアセットの組み合わせデータ

JSON 表現 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
フィールド
assetCombinationServedAssets[]

object (AssetUsage)

配信されたアセット。

AssetUsage

アセットの使用状況に関する情報が含まれます。

JSON 表現 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
フィールド
asset

string

アセットのリソース名。
servedAssetFieldType

enum (ServedAssetFieldType)

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

ServedAssetFieldType

使用可能なアセット フィールド タイプ。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
HEADLINE_1 アセットは見出し 1 で使用されています。
HEADLINE_2 アセットは見出し 2 で使用されています。
HEADLINE_3 このアセットは見出し 3 で使用されます。
DESCRIPTION_1 アセットは説明 1 で使用されています。
DESCRIPTION_2 このアセットは説明 2 で使用されます。
HEADLINE アセットが見出しで使用されました。広告の見出しが 1 つしかない場合にのみ使用します。それ以外の場合は、HEADLINE_1、HEADLINE_2、HEADLINE_3 の列挙型を使用します。
HEADLINE_IN_PORTRAIT アセットは縦向き画像の広告見出しとして使用されました。
LONG_HEADLINE アセットが長い見出し（MultiAssetResponsiveAd で使用）で使用されました。
DESCRIPTION アセットが説明で使用されました。広告に説明が 1 つしかない場合にのみ使用します。それ以外の場合は、DESCRIPTION_1 または DESCRIPTION_@ 列挙型を使用します。
DESCRIPTION_IN_PORTRAIT アセットは縦向き画像の説明として使用されました。
BUSINESS_NAME_IN_PORTRAIT アセットは縦向きのビジネス名として使用されました。
BUSINESS_NAME アセットがビジネス名として使用されました。
MARKETING_IMAGE アセットがマーケティング画像として使用された。
MARKETING_IMAGE_IN_PORTRAIT アセットが縦向きのマーケティング画像として使用されました。
SQUARE_MARKETING_IMAGE アセットは正方形のマーケティング画像として使用されました。
PORTRAIT_MARKETING_IMAGE アセットは縦向きのマーケティング画像として使用されました。
CALL_TO_ACTION アセットは行動を促すフレーズとして使用されました。
YOU_TUBE_VIDEO アセットが YouTube 動画として使用された。
CALL このアセットは通話として使用されます。
MOBILE_APP このアセットはモバイルアプリとして使用されます。
CALLOUT このアセットはコールアウトとして使用されます。
STRUCTURED_SNIPPET このアセットは構造化スニペットとして使用されます。
PRICE このアセットは価格として使用されます。
PROMOTION このアセットはプロモーションとして使用されます。
AD_IMAGE このアセットは画像として使用されます。
LEAD_FORM アセットがリードフォームとして使用されます。
DESCRIPTION_PREFIX アセットは説明の接頭辞として使用されます。

AssetGroup

アセット グループ。AssetGroupAsset は、アセットをアセット グループにリンクするために使用されます。AssetGroupSignal は、シグナルをアセット グループに関連付けるために使用されます。

JSON 表現 
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
フィールド
resourceName

string

アセット グループのリソース名。アセット グループのリソース名の形式は次のとおりです。

customers/{customerId}/assetGroups/{asset_group_id}
id

string (int64 format)

アセット グループの ID。
campaign

string

このアセット グループが関連付けられているキャンペーン。アセット グループにリンクされているアセット。
name

string

必須。アセット グループの名前。必須。長さは 1 ～ 128 文字にする必要があります。キャンペーン内で一意である必要があります。
finalUrls[]

string

すべてのクロスドメイン リダイレクト後の最終ページ URL のリスト。P-MAX では、オプトアウトしない限り、URL はデフォルトで拡張の対象となります。
finalMobileUrls[]

string

すべてのクロスドメイン リダイレクト後のモバイルの最終ページ URL のリスト。P-MAX では、オプトアウトしない限り、URL はデフォルトで拡張の対象となります。
status

enum (AssetGroupStatus)

アセット グループのステータス。
path1

string

広告に表示される URL に表示されるテキストの最初の部分です。
path2

string

広告に表示される URL に表示されるテキストの 2 番目の部分です。このフィールドは、path1 が設定されている場合にのみ設定できます。
adStrength

enum (AdStrength)

このアセット グループの広告の有効性全体。

AssetGroupStatus

アセット グループのステータス。

列挙型
UNSPECIFIED ステータスが指定されていません。
UNKNOWN このバージョンでは受信した値が不明です。
ENABLED アセット グループが有効になっている。
PAUSED アセット グループが一時停止されています。
REMOVED アセット グループが削除されます。

AdStrength

広告アセットの充実度として可能な値を列挙した列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
PENDING 広告アセットの充実度は現在保留中です。
NO_ADS 広告を生成できませんでした。
POOR 有効性が低い。
AVERAGE 平均的な強さ。
GOOD 良い強さです。
EXCELLENT 優れた強度。

AssetSetAsset

AssetSetAsset は、アセットとアセットセット間のリンクです。AssetSetAsset を追加すると、アセットがアセットセットにリンクされます。

JSON 表現 
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
フィールド
resourceName

string

アセット セット アセットのリソース名。アセット セットのアセット リソース名の形式は次のとおりです。

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}
assetSet

string

このアセットセットのアセットがリンクしているアセットセット。
asset

string

このアセットセットのアセットがリンクしているアセット。
status

enum (AssetSetAssetStatus)

アセットセットのアセットのステータス。読み取り専用です。

AssetSetAssetStatus

アセットセットのアセットのステータス。

列挙型
UNSPECIFIED ステータスが指定されていません。
UNKNOWN このバージョンでは、受信した値が不明です。これはレスポンス専用の値です。
ENABLED アセットセットのアセットが有効になっている。
REMOVED アセットセットのアセットが削除されます。

AssetSet

アセットのコレクションを表すアセットセット。AssetSetAsset を使用して、アセットをアセットセットにリンクします。

JSON 表現 
{
  "id": string,
  "resourceName": string
}
フィールド
id

string (int64 format)

アセットセットの ID。
resourceName

string

アセットセットのリソース名。アセット セットのリソース名は次の形式になります。

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

入札戦略。

JSON 表現 
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
フィールド
resourceName

string

入札戦略のリソース名。入札戦略のリソース名の形式は次のとおりです。

customers/{customerId}/biddingStrategies/{bidding_strategy_id}
status

enum (BiddingStrategyStatus)

入札戦略のステータス。

このフィールドは読み取り専用です。
type

enum (BiddingStrategyType)

入札戦略のタイプ。入札スキームを設定して入札戦略を作成します。

このフィールドは読み取り専用です。
currencyCode

string

入札戦略で使用される通貨（ISO 4217 の 3 文字のコード）。

クライアント センター（MCC）アカウントの入札戦略では、この通貨は作成時に設定でき、デフォルトではクライアント センター（MCC）アカウントの通貨が使用されます。通常アカウントの場合、このフィールドは設定できません。通常アカウントのすべての戦略では、通常アカウントの通貨が暗黙的に使用されます。いずれの場合も、effectiveCurrencyCode フィールドは戦略で使用される通貨を返します。
id

string (int64 format)

入札戦略の ID。
name

string

入札戦略の名前。アカウント内のすべての入札戦略は、それぞれ別の名前にする必要があります。

この文字列の長さは UTF-8 バイトで 1～255 の値にする必要があります（切り詰められます）。
effectiveCurrencyCode

string

入札戦略で使用される通貨（ISO 4217 の 3 文字のコード）。

クライアント センター（MCC）アカウントの入札戦略の場合、これは広告主が戦略を作成する際に設定した通貨です。顧客にサービスを提供する場合、これは顧客の currencyCode です。

入札戦略指標は、この通貨でレポートされます。

このフィールドは読み取り専用です。
campaignCount

string (int64 format)

この入札戦略に関連付けられたキャンペーンの数。

このフィールドは読み取り専用です。
nonRemovedCampaignCount

string (int64 format)

この入札戦略に関連付けられているキャンペーンのうち、削除されていないキャンペーンの数。

このフィールドは読み取り専用です。

共用体フィールド scheme。入札スキーム。

設定できるのは 1 つだけです。scheme は次のいずれかになります。
enhancedCpc

object (EnhancedCpc)

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

object (MaximizeConversionValue)

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

object (MaximizeConversions)

予算を消化しながらキャンペーンで最大限のコンバージョン数が得られるようにする自動入札戦略。
targetCpa

object (TargetCpa)

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

object (TargetImpressionShare)

選択したインプレッションの割合に向けて自動的に最適化する入札戦略。
targetOutrankShare

object (TargetOutrankShare)

特定の競合他社よりも上位に表示されるべきオークションの目標割合に基づいて入札単価を設定する入札戦略。このフィールドのサポートは終了しています。このフィールドを使用して新しい入札戦略を作成したり、このフィールドを使用して入札戦略をキャンペーンに適用したりすることはできません。このスキームがすでに設定されている戦略への変更は許可されます。
targetRoas

object (TargetRoas)

特定の目標広告費用対効果（ROAS）の平均値を達成しながら、収益の最大化を図る入札戦略。
targetSpend

object (TargetSpend)

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

BiddingStrategyStatus

BiddingStrategy のステータス。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
ENABLED 入札戦略が有効になっている。
REMOVED 入札戦略が削除されます。

BiddingStrategyType

使用可能な入札戦略タイプを説明する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
COMMISSION コミッションは、広告主様がコンバージョン値の一定の割合を支払う自動入札戦略です。
ENHANCED_CPC 拡張クリック単価は、コンバージョンにつながる可能性が高いクリックに対して入札単価を引き上げ、可能性が低いクリックに対しては引き下げる入札戦略です。
INVALID 戻り値にのみ使用されます。キャンペーンに入札戦略が設定されていないことを示します。この原因によりキャンペーンを配信できません。たとえば、キャンペーンが MCC 入札戦略にリンクされていて、その後、広告配信アカウントが MCC アカウントからリンク解除された場合などです。この場合、キャンペーンはアクセスできなくなったクライアント センターの入札戦略から自動的に切り離され、無効な入札戦略タイプに移行します。
MANUAL_CPA 広告主が指定したアクションごとに広告主が入札単価を設定できる個別単価設定の入札戦略。
MANUAL_CPC クリックに基づく個別の入札単価。クリック 1 回ごとに支払います。
MANUAL_CPM ユーザーが 1,000 回のインプレッションごとに料金を支払う、インプレッションに基づく手動入札。
MANUAL_CPV 動画視聴 1 回あたりに設定可能な金額を支払う入札戦略。
MAXIMIZE_CONVERSIONS 1 日の予算内でコンバージョン数を自動的に最大化する入札戦略。
MAXIMIZE_CONVERSION_VALUE 自動入札戦略の一種で、指定した予算内で収益を最大化できるように入札単価を自動的に調整します。
PAGE_ONE_PROMOTED Page-One Promoted 入札戦略。google.com の 1 ページ目または 1 ページ目のプロモーション枠のインプレッションをターゲットに上限クリック単価を設定します。この列挙値は非推奨です。
PERCENT_CPC 「クリック単価の割合」は、入札単価が商品やサービスの広告掲載価格の割合となる入札戦略です。
TARGET_CPA 目標コンバージョン単価は自動入札戦略のひとつであり、設定した目標値の水準にコンバージョン単価を維持しつつ、コンバージョン数を最大化できるよう、入札単価を自動的に調整します。
TARGET_CPM 目標インプレッション単価は自動入札戦略のひとつであり、設定した目標値の水準にインプレッション単価を維持しつつ、インプレッション数を最大化できるよう、入札単価を自動的に調整します。
TARGET_IMPRESSION_SHARE 検索広告の一定の割合が 1 ページ目の上部（または他の目標掲載位置）に表示されるように、入札単価を設定する自動入札戦略。
TARGET_OUTRANK_SHARE 目標上位表示率は、特定の競合他社よりも上位に広告を表示するオークションの目標割合に基づいて入札単価を設定する自動入札戦略です。この列挙値は非推奨です。
TARGET_ROAS 目標広告費用対効果は、特定の目標広告費用対効果の平均値を達成しながら、収益の最大化を図る自動入札戦略です。
TARGET_SPEND 「目標費用」は、予算内でクリック数を最大化できるように入札単価を自動的に調整する自動入札戦略です。

EnhancedCpc

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

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

この入札戦略は非推奨になったため、作成できなくなりました。同等の機能については、enhancedCpcEnabled を true に設定した ManualCpc を使用してください。

MaximizeConversionValue

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

JSON 表現 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
フィールド
cpcBidCeilingMicros

string (int64 format)

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

string (int64 format)

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

number

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

MaximizeConversions

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

JSON 表現 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
フィールド
cpcBidCeilingMicros

string (int64 format)

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

string (int64 format)

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

string (int64 format)

目標コンバージョン単価（CPA）オプション。これは、入札戦略の通貨のマイクロ単位で指定されたコンバージョン アクション 1 件あたりに支払う金額の平均値です。設定されている場合、この入札戦略では、目標コンバージョン単価以下でコンバージョンを最大限に獲得できるように入札単価が設定されます。目標アクション単価が設定されていない場合、入札戦略では予算に対して可能な限り低いアクション単価を達成することを目指します。

TargetCpa

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

JSON 表現 
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
フィールド
targetCpaMicros

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

TargetImpressionShare

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

JSON 表現 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
フィールド
location

enum (TargetImpressionShareLocation)

検索結果ページで目標とする掲載位置。
locationFractionMicros

string (int64 format)

ターゲット地域に表示する広告の割合（マイクロ単位）。たとえば、1% は 10,000 に相当します。
cpcBidCeilingMicros

string (int64 format)

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

TargetImpressionShareLocation

可能な目標を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ANYWHERE_ON_PAGE ウェブページの任意の場所。
TOP_OF_PAGE 広告のトップボックス。
ABSOLUTE_TOP_OF_PAGE 広告のトップボックス内のトップスロット。

TargetOutrankShare

特定の競合他社よりも上位に広告を表示するオークションの目標割合に基づいて入札単価を設定する自動入札戦略。この戦略はサポートを終了しました。

JSON 表現 
{
  "cpcBidCeilingMicros": string
}
フィールド
cpcBidCeilingMicros

string (Int64Value format)

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

TargetRoas

特定の目標広告費用対効果（ROAS）の平均値を達成しながら、収益の最大化を図る自動入札戦略。

JSON 表現 
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
フィールド
targetRoas

number

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

string (int64 format)

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

string (int64 format)

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

TargetSpend

自動入札戦略の一種で、予算内でクリック数を最大化できるように入札単価を自動的に調整します。

JSON 表現 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
フィールド
targetSpendMicros
(deprecated)

string (int64 format)

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

string (int64 format)

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

CampaignBudget

キャンペーンの予算。

JSON 表現 
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
フィールド
resourceName

string

キャンペーン予算のリソース名。キャンペーン予算のリソース名の形式は次のとおりです。

customers/{customerId}/campaignBudgets/{campaign_budget_id}
deliveryMethod

enum (BudgetDeliveryMethod)

キャンペーン予算が消費される割合を決定する配信方法。

作成オペレーションで指定しない場合のデフォルトは STANDARD です。
period

enum (BudgetPeriod)

予算を消化する期間です。指定しない場合のデフォルトは DAILY です。
amountMicros

string (int64 format)

アカウントに対する現地通貨での予算額。金額はマイクロ秒単位で指定します。ここで、100 万が 1 通貨単位に相当します。1 か月の費用の上限はこの金額の 30.4 倍です。

BudgetDeliveryMethod

予算の配分方法。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
STANDARD 予算サーバーは、期間全体で均等に配信を調整します。
ACCELERATED 予算サーバーは配信を調整せず、広告は可能な限り速く配信されます。

BudgetPeriod

予算の期間。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
DAILY 1 日の予算。
FIXED_DAILY 1 日の固定予算。
CUSTOM_PERIOD カスタム予算は total_amount と組み合わせて使用し、生涯予算の上限を指定できます。

キャンペーン

キャンペーン。

JSON 表現 
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
フィールド
resourceName

string

キャンペーンのリソース名。キャンペーン リソース名の形式は次のとおりです。

customers/{customerId}/campaigns/{campaign_id}
status

enum (CampaignStatus)

キャンペーンのステータス。

新しいキャンペーンを追加すると、ステータスはデフォルトで ENABLED に設定されます。
servingStatus

enum (CampaignServingStatus)

キャンペーンの広告配信ステータス。
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

キャンペーンの入札戦略のシステム ステータス。
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

キャンペーンの広告配信の最適化ステータス。
advertisingChannelType

enum (AdvertisingChannelType)

キャンペーン内の広告のメインの配信ターゲット。ターゲティング オプションは networkSettings で絞り込むことができます。

新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。

キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。
advertisingChannelSubType

enum (AdvertisingChannelSubType)

（省略可）advertisingChannelType の絞り込み。親チャネルタイプの有効なサブタイプを指定してください。

キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。
urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate、finalUrls、mobile_final_urls でカスタム パラメータ タグを置き換えるために使用されるマッピングのリスト。
realTimeBiddingSetting

object (RealTimeBiddingSetting)

リアルタイム ビッダーの設定。この機能は、Ad Exchange ネットワークをターゲットとするキャンペーンでのみ利用できます。
networkSettings

object (NetworkSettings)

キャンペーンのネットワーク設定。
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

動的検索広告（DSA）を制御するための設定。
shoppingSetting

object (ShoppingSetting)

ショッピング キャンペーンを制御するための設定。
geoTargetTypeSetting

object (GeoTargetTypeSetting)

広告の地域ターゲティングの設定。
effectiveLabels[]

string

このキャンペーンに適用されている有効なラベルのリソース名。有効なラベルは、このキャンペーンに継承または直接割り当てられたラベルです。
labels[]

string

このキャンペーンに適用されたラベルのリソース名。
biddingStrategyType

enum (BiddingStrategyType)

入札戦略のタイプ。

入札戦略を作成するには、標準入札戦略を作成する入札スキームを設定するか、ポートフォリオ入札戦略を作成する biddingStrategy フィールドを設定します。

このフィールドは読み取り専用です。
accessibleBiddingStrategy

string

AccessibleBiddingStrategy のリソース名。これは、'biddingStrategy' で識別される、関連付けられたポートフォリオ入札戦略の制限のない属性の読み取り専用ビューです。キャンペーンでポートフォリオ戦略を使用していない場合は空。制限なしの戦略属性は、戦略が共有されているすべてのお客様が利用でき、AccessibleBiddingStrategy リソースから読み取られます。一方、制限付き属性は、戦略の所有者であるお客様とその管理者のみが利用できます。制限付き属性は、BiddingStrategy リソースからのみ読み取ることができます。
frequencyCaps[]

object (FrequencyCapEntry)

各ユーザーにこのキャンペーンの広告を表示する頻度を制限するリスト。
selectiveOptimization

object (SelectiveOptimization)

このキャンペーンの選択的な最適化設定。このキャンペーンの最適化で重視するコンバージョン アクションのセットが含まれます。この機能は、AdvertisingChannelType に MULTI_CHANNEL、AdvertisingChannelSubType に APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用するアプリ キャンペーンにのみ適用されます。
optimizationGoalSetting

object (OptimizationGoalSetting)

このキャンペーンの最適化目標の設定。最適化目標のタイプが含まれます。
trackingSetting

object (TrackingSetting)

トラッキング情報に関するキャンペーン単位の設定。
engineId

string

外部エンジン アカウントのキャンペーンの ID。このフィールドは、Google 広告アカウント以外のアカウントにのみ使用できます（Yahoo! Japan、Microsoft、Baidu など）。Google 広告エンティティの場合は、代わりに「campaign.id」を使用します。
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

このキャンペーンから除外するアセット フィールドのタイプ。これらのフィールド タイプのアセットリンクは、このキャンペーンに上位レベルから継承されません。
createTime

string

このキャンペーンが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。createTime は v1 で非推奨になります。代わりに creationTime を使用してください。
creationTime

string

このキャンペーンが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。
lastModifiedTime

string

このキャンペーンが最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。
feedTypes[]

enum (AssetSetType)

このキャンペーンに直接添付されているフィードのタイプ。
id

string (int64 format)

キャンペーンの ID です。
name

string

キャンペーンの名前です。

新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。

null（コードポイント 0x0）、NL ラインフィード（コードポイント 0xA）、改行（コードポイント 0xD）の文字を含めることはできません。
trackingUrlTemplate

string

トラッキング URL を作成するための URL テンプレート。
campaignBudget

string

キャンペーンのキャンペーン予算のリソース名。
startDate

string

お客様のタイムゾーンでキャンペーンが配信を開始した日付（YYYY-MM-DD 形式）。
endDate

string

ユーザーのタイムゾーンで配信されるキャンペーンの最終日（YYYY-MM-DD 形式）。作成時にはデフォルトで 2037-12-30 に設定され、キャンペーンは無期限に実行されます。既存のキャンペーンを無期限で行うように設定するには、このフィールドを 2037-12-30 に設定します。
finalUrlSuffix

string

並行トラッキングで配信されるランディング ページにクエリ パラメータを追加するために使用される接尾辞。
urlExpansionOptOut

boolean

よりターゲットを絞った URL への URL 拡張をオプトアウトするかどうかを表します。オプトアウトした場合（true）、アセット グループ内の最終ページ URL、または広告主の Google Merchant Center またはビジネスデータ フィードで指定された URL のみがターゲットになります。オプトイン（false）の場合、ドメイン全体がターゲットになります。このフィールドは P-MAX キャンペーンでのみ設定できます。デフォルト値は false です。

共用体フィールド campaign_bidding_strategy。キャンペーンの入札戦略。

ポートフォリオ（BiddingStrategy サービスで作成）または標準（キャンペーンに埋め込み）のいずれかである必要があります。campaign_bidding_strategy は次のいずれかになります。
biddingStrategy

string

キャンペーンで使用されるポートフォリオ入札戦略のリソース名。
manualCpa

object (ManualCpa)

標準の個別アクション単価制入札戦略。広告主が指定したアクションごとに広告主が入札単価を設定できる個別単価設定の入札戦略。ローカル サービス キャンペーンでのみサポートされます。
manualCpc

object (ManualCpc)

標準の個別クリック単価制の入札戦略。ユーザーがクリックごとに支払うクリックベースの手動入札。
manualCpm

object (ManualCpm)

標準の個別インプレッション単価制入札戦略。ユーザーが 1,000 インプレッションごとに支払うインプレッション ベースの手動入札。
maximizeConversions

object (MaximizeConversions)

「コンバージョン数の最大化」の標準入札戦略。予算を消化しつつコンバージョン数を最大化します。
maximizeConversionValue

object (MaximizeConversionValue)

予算を消化しつつ収益を最大化できるよう入札単価が自動的に設定される、標準の「コンバージョン値の最大化」入札戦略。
targetCpa

object (TargetCpa)

指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が自動的に設定される、標準の目標コンバージョン単価制入札戦略。
targetImpressionShare

object (TargetImpressionShare)

目標インプレッション シェア入札戦略。選択したインプレッションの割合を達成するように入札単価を設定する自動入札戦略。
targetRoas

object (TargetRoas)

特定の目標広告費用対効果（ROAS）の平均値を達成しながら、収益を自動的に最大化する標準の目標広告費用対効果入札戦略。
targetSpend

object (TargetSpend)

予算内でクリック数を最大化できるように入札単価を自動的に調整する、標準の目標費用入札戦略です。
percentCpc

object (PercentCpc)

入札単価が一部の商品やサービスの広告掲載価格の割合となる標準の割合クリック単価入札戦略。
targetCpm

object (TargetCpm)

インプレッション単価を自動的に最適化する入札戦略。

CampaignStatus

キャンペーンのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED キャンペーンは有効で、広告を表示できます。
PAUSED キャンペーンはユーザーによって一時停止されています。
REMOVED キャンペーンは削除されました。

CampaignServingStatus

キャンペーンの配信ステータスの候補。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
SERVING サービング。
NONE なし。
ENDED 終了しました。
PENDING Pending.
SUSPENDED 停止中。

BiddingStrategySystemStatus

BiddingStrategy のシステム ステータス。

列挙型
UNSPECIFIED 予期しないエラーが発生したことを示すシグナル（入札戦略タイプが見つからなかった、ステータス情報が見つからなかったなど）。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED この入札戦略は有効になっており、特に問題も見つかっていません。
LEARNING_NEW 入札戦略が最近作成されたか、最近再度有効になったため、入札戦略は学習中です。
LEARNING_SETTING_CHANGE 最近設定が変更されたため、入札戦略は学習中です。
LEARNING_BUDGET_CHANGE 最近予算が変更されたため、入札戦略は学習中です。
LEARNING_COMPOSITION_CHANGE 最近、入札戦略に割り当てられているキャンペーン、広告グループ、キーワードの数が変更されたため、入札戦略は学習中です。
LEARNING_CONVERSION_TYPE_CHANGE 入札戦略はコンバージョン レポートに依存しており、お客様が最近、入札戦略に関連するコンバージョンの種類を変更した。
LEARNING_CONVERSION_SETTING_CHANGE 入札戦略はコンバージョン レポートに依存しており、お客様が最近コンバージョン設定を変更しました。
LIMITED_BY_CPC_BID_CEILING 入札戦略は入札単価の上限により制限されています。
LIMITED_BY_CPC_BID_FLOOR 入札戦略は入札フロア価格によって制限されています。
LIMITED_BY_DATA 過去数週間のコンバージョン トラフィックが十分でなかったため、入札戦略が制限されています。
LIMITED_BY_BUDGET この入札戦略のキーワードの多くは、予算による制限を受けています。
LIMITED_BY_LOW_PRIORITY_SPEND 費用が優先順位付けされていないため、入札戦略で目標費用を達成できません。
LIMITED_BY_LOW_QUALITY この入札戦略のキーワードの多くで品質スコアが低くなっています。
LIMITED_BY_INVENTORY ターゲティングが絞り込まれているため、入札戦略で予算を使い切ることができません。
MISCONFIGURED_ZERO_ELIGIBILITY SSC のコンバージョン トラッキング（ping が存在しない）またはリマーケティング リストがない。
MISCONFIGURED_CONVERSION_TYPES 入札戦略はコンバージョン レポートに依存していますが、この戦略に対してレポートされる可能性のあるコンバージョン タイプが不足しています。
MISCONFIGURED_CONVERSION_SETTINGS 入札戦略がコンバージョン レポートに依存しており、お客様のコンバージョン設定が正しく構成されていません。
MISCONFIGURED_SHARED_BUDGET 入札戦略に含まれていないキャンペーンが、戦略に含まれているキャンペーンと予算を共有しています。
MISCONFIGURED_STRATEGY_TYPE キャンペーンの戦略タイプが無効で、配信されていません。
PAUSED 入札戦略が無効です。入札戦略が設定された有効なキャンペーン、広告グループ、キーワードが存在しない。または、入札戦略にリンクされている有効な予算がない。
UNAVAILABLE この入札戦略は現在、ステータス レポートに対応していません。
MULTIPLE_LEARNING この入札戦略では、問題の期間中に複数の LEARNING_* システム ステータスが設定されていました。
MULTIPLE_LIMITED この入札戦略では、問題の期間中に複数の LIMITED_* システム ステータスが発生しました。
MULTIPLE_MISCONFIGURED この入札戦略では、問題の期間中に MISCONFIGURED_* システム ステータスが複数回発生しました。
MULTIPLE この入札戦略のシステム ステータスは、問題の期間中に複数回変更されています。

AdServingOptimizationStatus

配信ステータスを表す列挙型。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
OPTIMIZE 広告配信は、キャンペーンのクリック率に基づいて最適化されます。
CONVERSION_OPTIMIZE 広告配信は、キャンペーンのクリック率とコンバージョンに基づいて最適化されます。キャンペーンにコンバージョン オプティマイザーの入札戦略が設定されていない場合は、デフォルトで「最適化」が選択されます。
ROTATE すべての広告が 90 日間均等にローテーションされ、その後クリック重視で最適化されます。
ROTATE_INDEFINITELY パフォーマンスの低い広告と高い広告を均等に表示し、最適化は行いません。
UNAVAILABLE 広告配信の最適化ステータスは利用できません。

AdvertisingChannelType

さまざまな広告チャネル タイプを説明する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SEARCH 検索ネットワーク。ディスプレイ バンドル キャンペーンと検索プラス キャンペーンが含まれます。
DISPLAY Google ディスプレイ ネットワークのみ。
SHOPPING ショッピング キャンペーンは、ショッピング プロパティと google.com の検索結果に掲載されます。
HOTEL ホテル広告キャンペーン。
VIDEO 動画キャンペーン。
MULTI_CHANNEL 複数のチャネルで実施されるアプリ キャンペーンとアプリ エンゲージメント キャンペーン。
LOCAL ローカル広告キャンペーン。
SMART スマート アシスト キャンペーン。
PERFORMANCE_MAX P-MAX キャンペーン。
LOCAL_SERVICES ローカル サービス キャンペーン。
DISCOVERY ファインド キャンペーン。
TRAVEL 旅行キャンペーン。
SOCIAL ソーシャル キャンペーン。

AdvertisingChannelSubType

さまざまなチャンネル サブタイプを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値としてのみ使用されます。このバージョンで不明な値を表します。
SEARCH_MOBILE_APP 検索向けのモバイルアプリ キャンペーン。
DISPLAY_MOBILE_APP ディスプレイ向けのモバイルアプリ キャンペーン。
SEARCH_EXPRESS 検索用の AdWords Express キャンペーン。
DISPLAY_EXPRESS ディスプレイ向けの AdWords Express キャンペーン。
SHOPPING_SMART_ADS スマート ショッピング キャンペーン。
DISPLAY_GMAIL_AD Gmail 広告キャンペーン。
DISPLAY_SMART_CAMPAIGN スマート ディスプレイ キャンペーン: このサブタイプの新しいキャンペーンは作成できません。
VIDEO_OUTSTREAM 動画アウトストリーム キャンペーン。
VIDEO_ACTION 動画 TrueView アクション キャンペーン。
VIDEO_NON_SKIPPABLE スキップ不可の動画広告を含む動画キャンペーン。
APP_CAMPAIGN Google 検索、Google Play、YouTube、Google ディスプレイ ネットワークなど、Google の主要なサービスを横断して、Android アプリや iOS アプリを簡単に宣伝できるアプリ キャンペーン。
APP_CAMPAIGN_FOR_ENGAGEMENT エンゲージメントを目的としたアプリ キャンペーン。Google 検索、YouTube、Google ディスプレイ ネットワークなど、Google の主要なサービスを横断してアプリの再エンゲージメントを促進することに重点を置いています。
LOCAL_CAMPAIGN ローカル広告に特化したキャンペーン。
SHOPPING_COMPARISON_LISTING_ADS ショッピング比較キャンペーン。
SMART_CAMPAIGN 標準のスマート アシスト キャンペーン。
VIDEO_SEQUENCE シーケンス動画広告を含む動画キャンペーン。
APP_CAMPAIGN_FOR_PRE_REGISTRATION アプリの事前登録を宣伝することに特化したアプリ キャンペーン。Google Play、YouTube、ディスプレイ ネットワークの複数の広告チャネルをターゲットに設定できます。
VIDEO_REACH_TARGET_FREQUENCY 「フリークエンシー目標」入札戦略を使用した動画リーチ キャンペーン。
TRAVEL_ACTIVITIES 旅行アクティビティ キャンペーン。
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook はソーシャル キャンペーンのみをトラッキングします。

RealTimeBiddingSetting

リアルタイム ビッダーの設定。この機能は、Ad Exchange ネットワークをターゲットとするキャンペーンでのみ利用できます。

JSON 表現 
{
  "optIn": boolean
}
フィールド
optIn

boolean

キャンペーンがリアルタイム ビッディングにオプトインしているかどうか。

NetworkSettings

キャンペーンのネットワーク設定。

JSON 表現 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
フィールド
targetSearchNetwork

boolean

Google 検索ネットワークのパートナー サイトに広告を配信するかどうか（targetGoogleSearch も true にする必要があります）。
targetContentNetwork

boolean

Google ディスプレイ ネットワークの指定したプレースメントに広告を配信するかどうか。プレースメントは、プレースメント条件で指定します。
targetPartnerSearchNetwork

boolean

Google パートナー ネットワークで広告を配信するかどうか。この機能は、一部の Google パートナー アカウントでのみご利用いただけます。

DynamicSearchAdsSetting

動的検索広告（DSA）を制御するための設定。

JSON 表現 
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
フィールド
domainName

string

必須。この設定が表すインターネット ドメイン名（「google.com」や「www.google.com」など）。
languageCode

string

必須。ドメインの言語を指定する言語コード（例: 「en」）。
useSuppliedUrlsOnly

boolean

キャンペーンで広告主が提供した URL のみを使用するかどうか。

ShoppingSetting

ショッピング キャンペーンの設定。キャンペーンで宣伝できる商品の範囲と、このキャンペーンが他のショッピング キャンペーンとどのように連携するかを定義します。

JSON 表現 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
フィールド
feedLabel

string

キャンペーンに含める商品のフィードラベル。feedLabel または salesCountry のいずれか 1 つのみを設定できます。salesCountry の代わりに使用する場合、feedLabel フィールドは同じ形式の国コード（例: XX）を受け入れます。それ以外の場合は、Google Merchant Center でフィードラベルに使用される任意の文字列を指定できます。
useVehicleInventory

boolean

車両リスティングの広告枠をターゲットに設定するかどうか。
merchantId

string (int64 format)

Merchant Center アカウントの ID。このフィールドは作成オペレーションに必須です。このフィールドはショッピング キャンペーンでは変更できません。
salesCountry

string

キャンペーンに含める商品の販売国。
campaignPriority

integer

キャンペーンの優先順位。優先度の数値が高いキャンペーンは、優先度の低いキャンペーンよりも優先されます。このフィールドはショッピング キャンペーンで必須であり、0 ～ 2 の値を指定します。スマート ショッピング キャンペーンでは省略可能ですが、設定する場合は 3 に設定する必要があります。
enableLocal

boolean

ローカル商品を含めるかどうか。

GeoTargetTypeSetting

広告の地域ターゲティングに関連する設定のコレクションを表します。

JSON 表現 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
フィールド
positiveGeoTargetType

enum (PositiveGeoTargetType)

この特定のキャンペーンでポジティブ ジオターゲティングに使用される設定。
negativeGeoTargetType

enum (NegativeGeoTargetType)

この特定のキャンペーンで除外地域ターゲティングに使用される設定。

PositiveGeoTargetType

指定可能なポジティブな地域ターゲティングのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
PRESENCE_OR_INTEREST ユーザーが広告主のターゲット地域にいる場合、またはターゲット地域に関心を示している場合に広告がトリガーされることを指定します。
SEARCH_INTEREST ユーザーが広告主様のターゲット地域を検索した場合に広告がトリガーされることを指定します。この機能は、検索キャンペーンと通常のショッピング キャンペーンでのみ使用できます。
PRESENCE ユーザーが広告主様のターゲット地域にいる場合、または定期的にターゲット地域にいる場合に広告がトリガーされることを指定します。

NegativeGeoTargetType

除外地域ターゲティングのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
PRESENCE_OR_INTEREST 広告主様の除外地域にいるユーザーや、除外地域に関心を示しているユーザーに広告を表示しないように指定します。
PRESENCE 広告主の除外地域にいるユーザーには広告が表示されないように指定します。

FrequencyCapEntry

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

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

SelectiveOptimization

このキャンペーンの選択的な最適化設定。このキャンペーンの最適化で重視するコンバージョン アクションのセットが含まれます。この機能は、AdvertisingChannelType に MULTI_CHANNEL、AdvertisingChannelSubType に APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用するアプリ キャンペーンにのみ適用されます。

JSON 表現 
{
  "conversionActions": [
    string
  ]
}
フィールド
conversionActions[]

string

このキャンペーンの最適化に使用するコンバージョン アクションのリソース名のセット。

OptimizationGoalSetting

このキャンペーンの最適化目標の設定。最適化目標のタイプが含まれます。

JSON 表現 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
フィールド
optimizationGoalTypes[]

enum (OptimizationGoalType)

最適化目標タイプのリスト。

OptimizationGoalType

最適化目標のタイプ

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値としてのみ使用されます。このバージョンで不明な値を表します。
CALL_CLICKS 通話クリックを重視して最適化します。通話クリック コンバージョンとは、ユーザーが広告を見た後に [発信] を選択して店舗に電話した回数です。
DRIVING_DIRECTIONS ルート検索を重視して最適化します。ルート検索コンバージョンは、ユーザーが広告を見た後に [ルートを検索] を選択して店舗へのルートを確認した回数です。
APP_PRE_REGISTRATION 事前登録向けに最適化します。事前登録コンバージョンは、アプリのリリース時に通知を受け取るための事前登録の登録数です。

TrackingSetting

トラッキング情報に関するキャンペーン単位の設定。

JSON 表現 
{
  "trackingUrl": string
}
フィールド
trackingUrl

string

動的トラッキングに使用される URL。

AssetSetType

アセット セットのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
PAGE_FEED ページ アセットセット。
DYNAMIC_EDUCATION 動的な教育アセット セット。
MERCHANT_CENTER_FEED Google Merchant Center アセット セット。
DYNAMIC_REAL_ESTATE 不動産（動的アセット）のアセット セット。
DYNAMIC_CUSTOM 動的なカスタム アセット セット。
DYNAMIC_HOTELS_AND_RENTALS ホテルと民泊施設（動的アセット セット）。
DYNAMIC_FLIGHTS 動的なフライトのアセット セット。
DYNAMIC_TRAVEL 動的な旅行アセット セット。
DYNAMIC_LOCAL 動的なローカルのアセット セット。
DYNAMIC_JOBS 動的なジョブのアセット セット。
LOCATION_SYNC 住所同期レベルのアセットが設定されました。
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP ビジネス プロフィールの地域グループのアセット セット。
CHAIN_DYNAMIC_LOCATION_GROUP 自社店舗とアフィリエイト店舗の両方に使用できるチェーン店舗グループ アセット セット。
STATIC_LOCATION_GROUP 所有ビジネスとアフィリエイト ビジネスの両方で使用できる静的地域グループ アセット セット。
HOTEL_PROPERTY ホテル物件フィードを旅行関連の目標達成のための P-MAX キャンペーンにリンクするために使用されるホテル物件アセット セット。
TRAVEL_FEED 旅行フィードのアセットセット タイプ。ホテルフィードまたは観光スポット（アクティビティ）フィードのいずれかを表すことができます。

ManualCpa

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

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

ManualCpc

ユーザーがクリックごとに支払うクリックベースの手動入札。

JSON 表現 
{
  "enhancedCpcEnabled": boolean
}
フィールド
enhancedCpcEnabled

boolean

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

ManualCpm

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

ユーザーが 1,000 インプレッションごとに支払うインプレッション ベースの手動入札。

PercentCpc

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

JSON 表現 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
フィールド
cpcBidCeilingMicros

string (int64 format)

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

boolean

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

TargetCpm

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

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

CampaignAsset

キャンペーンとアセット間のリンク。

JSON 表現 
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
フィールド
resourceName

string

キャンペーン アセットのリソース名。CampaignAsset リソース名の形式は次のとおりです。

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}
status

enum (AssetLinkStatus)

キャンペーン アセットのステータス。
campaign

string

アセットがリンクされているキャンペーン。
asset

string

キャンペーンにリンクされているアセット。

CampaignAssetSet

CampaignAssetSet は、キャンペーンとアセットセット間のリンクです。CampaignAssetSet を追加すると、アセットセットがキャンペーンにリンクされます。

JSON 表現 
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
フィールド
resourceName

string

キャンペーン アセットセットのリソース名。アセット セットのアセット リソース名の形式は次のとおりです。

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign

string

このアセットセットがリンクされているキャンペーン。
assetSet

string

キャンペーンにリンクされているアセットセット。
status

enum (AssetSetLinkStatus)

キャンペーン アセットセットのアセットのステータス。読み取り専用です。

CampaignAudienceView

キャンペーンのオーディエンス ビュー。ディスプレイ ネットワークと YouTube ネットワークの広告のインタレスト カテゴリとリマーケティング リスト、および検索広告向けリマーケティング リスト（RLSA）のパフォーマンス データが含まれます。これらのデータは、キャンペーンとオーディエンス条件で集計されます。このビューには、キャンペーン単位で関連付けられたオーディエンスのみが表示されます。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

キャンペーン オーディエンス ビューのリソース名。キャンペーン オーディエンス ビューのリソース名の形式は次のとおりです。

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

キャンペーン条件。

JSON 表現 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
フィールド
resourceName

string

キャンペーン条件のリソース名。キャンペーン条件のリソース名の形式は次のとおりです。

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}
displayName

string

条件の表示名。

このフィールドはミューテーションの場合は無視されます。
type

enum (CriterionType)

条件のタイプ。
status

enum (CampaignCriterionStatus)

条件のステータス。
lastModifiedTime

string

このキャンペーン条件が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。
criterionId

string (int64 format)

条件の ID。

このフィールドはミューテーション時に無視されます。
bidModifier

number

条件が一致した場合の入札の修飾子。修飾子は 0.1 ～ 10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。デバイスタイプをオプトアウトするには、0 を使用します。
negative

boolean

条件を絞り込むか（false）、除外するか（true）を指定します。

共用体フィールド criterion。キャンペーン条件。

必ず 1 つ設定する必要があります。criterion は次のいずれかになります。
keyword

object (KeywordInfo)

キーワード。
location

object (LocationInfo)

位置情報] をタップします。
device

object (DeviceInfo)

デバイス] など）を選択します。
ageRange

object (AgeRangeInfo)

年齢層。
gender

object (GenderInfo)

性別。
userList

object (UserListInfo)

ユーザーリスト。
language

object (LanguageInfo)

学びました。
webpage

object (WebpageInfo)

ウェブページ。
locationGroup

object (LocationGroupInfo)

地域グループ

CampaignCriterionStatus

CampaignCriterion のステータス。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
ENABLED キャンペーン条件が有効になっている。
PAUSED キャンペーン クライテリアが一時停止されています。
REMOVED キャンペーン条件が削除されます。

LanguageInfo

言語条件。

JSON 表現 
{
  "languageConstant": string
}
フィールド
languageConstant

string

言語定数のリソース名。

LocationGroupInfo

フィードで指定されたビジネス拠点のリストを中心とした半径。

JSON 表現 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
フィールド
geoTargetConstants[]

string

フィード内の地域範囲を制限する地域ターゲティング定数。現在、許可されている地域ターゲティング定数は 1 つのみです。
radiusUnits

enum (LocationGroupRadiusUnits)

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

string

FeedItem がターゲットに設定されている FeedItemSet。複数の ID が指定されている場合は、少なくとも 1 つのセットに含まれるすべてのアイテムがターゲットになります。このフィールドは geoTargetConstants と組み合わせて使用できません。これは省略可能で、CREATE オペレーションでのみ設定できます。
radius

string (int64 format)

ターゲット地域周辺の半径を指定する単位での距離。これは必須であり、CREATE オペレーションで設定する必要があります。

LocationGroupRadiusUnits

地域グループの半径距離の単位（例: MILES）

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
METERS メートル
MILES マイル
MILLI_MILES Milli Miles

CampaignEffectiveLabel

キャンペーンと有効なラベルの関係を表します。有効なラベルは、このキャンペーンに継承または直接割り当てられたラベルです。

JSON 表現 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
フィールド
resourceName

string

リソースの名前です。CampaignEffectivelabel リソース名の形式は customers/{ownerCustomerId}/campaignEffectiveLabels/{campaign_id}~{label_id} です。
campaign

string

有効なラベルが添付されているキャンペーン。
label

string

キャンペーンに割り当てられた有効なラベル。
ownerCustomerId

string (int64 format)

有効なラベルを所有するお客様の ID。

CampaignLabel

キャンペーンとラベルの関係を表します。

JSON 表現 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
フィールド
resourceName

string

リソースの名前です。キャンペーン ラベルのリソース名の形式は customers/{ownerCustomerId}/campaignLabels/{campaign_id}~{label_id} です。
campaign

string

ラベルが添付されるキャンペーン。
label

string

キャンペーンに割り当てられるラベル。
ownerCustomerId

string (int64 format)

ラベルを所有するお客様の ID。

CartDataSalesView

カートデータの販売ビュー。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

カートデータ販売ビューのリソース名。カートデータ販売ビューのリソース名の形式は customers/{customerId}/cartDataSalesView です。

オーディエンス

オーディエンスは、さまざまな属性を組み合わせてオーディエンスを定義する効果的なターゲット設定です。詳しいユーザー属性やアフィニティなどを指定して、ターゲット ユーザーのセグメントを表すオーディエンスを作成します。

JSON 表現 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
フィールド
resourceName

string

オーディエンスのリソース名。オーディエンス名の形式は次のとおりです。

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

オーディエンスの ID。
name

string

必須。オーディエンスの名前。すべてのユーザーで一意である必要があります。長さは 1 ～ 255 文字にする必要があります。
description

string

このオーディエンスの説明。

ConversionAction

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

JSON 表現 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
フィールド
resourceName

string

コンバージョン アクションのリソース名。コンバージョン アクションのリソース名の形式は次のとおりです。

customers/{customerId}/conversionActions/{conversion_action_id}
creationTime

string

Floodlight アクティビティの作成時点のタイムスタンプ（ISO 8601 形式）。
status

enum (ConversionActionStatus)

コンバージョン イベントの発生に関するこのコンバージョン アクションのステータス。
type

enum (ConversionActionType)

このコンバージョン アクションのタイプ。
category

enum (ConversionActionCategory)

このコンバージョン アクションでレポートされるコンバージョンのカテゴリ。
valueSettings

object (ValueSettings)

このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関する設定。
attributionModelSettings

object (AttributionModelSettings)

このコンバージョン アクションのアトリビューション モデルに関連する設定。
floodlightSettings

object (FloodlightSettings)

Floodlight コンバージョン タイプの Floodlight 設定。
id

string (int64 format)

コンバージョン アクションの ID。
name

string

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

新しいコンバージョン アクションを作成する場合は、このフィールドは必須です。空にすることはできません。
primaryForGoal

boolean

コンバージョン アクションの primaryForGoal ビットが false の場合、顧客のコンバージョン目標やキャンペーンのコンバージョン目標に関係なく、すべてのキャンペーンでそのコンバージョン アクションは入札対象外になります。ただし、カスタム コンバージョン目標では primaryForGoal が考慮されないため、キャンペーンに primaryForGoal = false のコンバージョン アクションで構成されたカスタム コンバージョン目標が設定されている場合、そのコンバージョン アクションは引き続き入札対象となります。設定しない場合、デフォルトで primaryForGoal は true になります。V9 では、primaryForGoal はオプションとして宣言されていないため、作成後に「更新」オペレーションで false に設定することしかできません。
ownerCustomer

string

コンバージョン アクションの所有者のお客様のリソース名。システム定義のコンバージョン アクションの場合は null。
includeInClientAccountConversionsMetric

boolean

このコンバージョン アクションを clientAccountConversions 指標に含めるかどうか。
includeInConversionsMetric

boolean

このコンバージョン アクションを [コンバージョン] 指標に含めるかどうか。
clickThroughLookbackWindowDays

string (int64 format)

インタラクション（クリックなど）からコンバージョン イベントまでの最大日数。
appId

string

アプリ コンバージョン アクションのアプリ ID。

ConversionActionStatus

コンバージョン アクションのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED コンバージョンが記録されます。
REMOVED コンバージョンは記録されません。
HIDDEN コンバージョンは記録されず、コンバージョン アクションは管理画面に表示されません。

ConversionActionType

コンバージョン アクションの可能なタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AD_CALL ユーザーが広告の電話番号リンクをクリックしたときに発生するコンバージョン。
CLICK_TO_CALL モバイル デバイスのユーザーが電話番号をクリックしたときに発生するコンバージョン。
GOOGLE_PLAY_DOWNLOAD ユーザーが Google Play ストアからモバイルアプリをダウンロードしたときに発生するコンバージョン。
GOOGLE_PLAY_IN_APP_PURCHASE ユーザーが Android 決済を通じてアプリ内で購入したときに発生するコンバージョン。
UPLOAD_CALLS 広告主様がトラッキングしてアップロードした通話コンバージョン。
UPLOAD_CLICKS 広告主様がトラッキングし、クリックの貢献度とともにアップロードしたコンバージョン。
WEBPAGE ウェブページで発生したコンバージョン。
WEBSITE_CALL ユーザーが広告主のウェブサイトから動的に生成された電話番号に電話をかけたときに発生するコンバージョン。
STORE_SALES_DIRECT_UPLOAD ファーストパーティまたはサードパーティの販売者データのアップロードに基づく店舗販売コンバージョン。店舗売り上げの直接アップロード タイプを使用できるのは、許可リストに登録されているお客様のみです。
STORE_SALES ファーストパーティまたはサードパーティの販売者データのアップロード、および/または決済ネットワークのカードを使用した店舗での購入に基づく店舗販売コンバージョン。店舗の販売タイプを使用できるのは、許可リストに登録されているお客様のみです。読み取り専用。
FIREBASE_ANDROID_FIRST_OPEN Firebase を通じてトラッキングされた Android アプリの初回起動のコンバージョン。
FIREBASE_ANDROID_IN_APP_PURCHASE Firebase を通じてトラッキングされた Android アプリのアプリ内購入コンバージョン。
FIREBASE_ANDROID_CUSTOM Firebase を通じてトラッキングされる Android アプリのカスタム コンバージョン。
FIREBASE_IOS_FIRST_OPEN Firebase を通じてトラッキングされた iOS アプリの初回起動コンバージョン。
FIREBASE_IOS_IN_APP_PURCHASE Firebase を通じてトラッキングされた iOS アプリのアプリ内購入コンバージョン。
FIREBASE_IOS_CUSTOM Firebase を通じてトラッキングされる iOS アプリのカスタム コンバージョン。
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN サードパーティのアプリ解析でトラッキングされた Android アプリの初回起動のコンバージョン。
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE サードパーティのアプリ解析でトラッキングされた Android アプリのアプリ内購入コンバージョン。
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM サードパーティのアプリ分析でトラッキングされた Android アプリのカスタム コンバージョン。
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN サードパーティのアプリ解析でトラッキングされた iOS アプリの初回起動コンバージョン。
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE サードパーティのアプリ解析でトラッキングされた iOS アプリのアプリ内購入コンバージョン。
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM サードパーティのアプリ解析でトラッキングされた iOS アプリのカスタム コンバージョン。
ANDROID_APP_PRE_REGISTRATION ユーザーが Google Play ストアからモバイルアプリを事前登録したときに発生するコンバージョン。読み取り専用。
ANDROID_INSTALLS_ALL_OTHER_APPS アプリ固有のタイプでトラッキングされない Google Play のすべてのダウンロードをトラッキングするコンバージョン。読み取り専用。
FLOODLIGHT_ACTION 広告主の広告を見た、またはクリックしたユーザーが特定のウェブページにアクセスした回数をカウントする Floodlight アクティビティ。読み取り専用。
FLOODLIGHT_TRANSACTION 販売が成立した回数や購入された商品アイテムの数をトラッキングする Floodlight アクティビティ。販売ごとの合計金額も取得できます。読み取り専用。
GOOGLE_HOSTED 広告を操作した後に Google のプロダクトやサービスからローカル アクションをトラッキングするコンバージョン。読み取り専用。
LEAD_FORM_SUBMIT ユーザーがリードフォームを送信したときにレポートされるコンバージョン。読み取り専用。
SALESFORCE

非推奨: Salesforce との統合が廃止され、Salesforce からのコンバージョンのインポート方法が改善されます。- https://support.google.com/google-ads/answer/14728349 を参照してください
SEARCH_ADS_360 検索広告 360 の Floodlight データからインポートされたコンバージョン。読み取り専用。
SMART_CAMPAIGN_AD_CLICKS_TO_CALL スマート アシスト キャンペーンのカスタム条件を使用して、通話トラッキングが設定されていないスマート アシスト キャンペーンの広告で発生した通話コンバージョン。読み取り専用。
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL ユーザーが Google マップ内の通話要素をクリックします。スマート アシスト キャンペーンのみ。読み取り専用。
SMART_CAMPAIGN_MAP_DIRECTIONS ユーザーが Google マップでビジネスの所在地までのルートをリクエストします。スマート アシスト キャンペーンのみ。読み取り専用。
SMART_CAMPAIGN_TRACKED_CALLS スマート キャンペーンのカスタム条件を使用して、通話トラッキングが設定されたスマート キャンペーンの広告で発生した通話コンバージョン。読み取り専用。
STORE_VISITS ユーザーが広告主の小売店に来店したときに発生するコンバージョン。読み取り専用。
WEBPAGE_CODELESS 個別にコード化されたイベント スニペットを使用しない、ウェブサイト イベント（フォームの送信やページの読み込みなど）から作成されたコンバージョン。読み取り専用。
UNIVERSAL_ANALYTICS_GOAL リンクされたユニバーサル アナリティクスの目標から発生したコンバージョン。
UNIVERSAL_ANALYTICS_TRANSACTION リンクされたユニバーサル アナリティクスのトランザクションから発生したコンバージョン。
GOOGLE_ANALYTICS_4_CUSTOM リンクされた Google アナリティクス 4 のカスタム イベント コンバージョンから発生したコンバージョン。
GOOGLE_ANALYTICS_4_PURCHASE リンクされた Google アナリティクス 4 の購入コンバージョンから発生したコンバージョン。

ConversionActionCategory

ConversionAction に関連付けられているコンバージョンのカテゴリ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
DEFAULT デフォルトのカテゴリ。
PAGE_VIEW ユーザーがページにアクセスした。
PURCHASE 購入、販売、または「注文完了」イベント。
SIGNUP ユーザー登録アクション。
LEAD 見込み顧客の発掘アクション。
DOWNLOAD ソフトウェア ダウンロード アクション（アプリの場合と同様）。
ADD_TO_CART 広告主サイトのショッピング カートへの商品の追加。
BEGIN_CHECKOUT ユーザーが広告主様のサイトで購入手続きに入ったとき。
SUBSCRIBE_PAID 商品やサービスの有料定期購入の開始。
PHONE_CALL_LEAD 広告主の提案に関心があることを示す電話。
IMPORTED_LEAD 外部ソースから Google 広告にインポートされた見込み顧客のコンバージョン。
SUBMIT_LEAD_FORM 広告主のサイトでビジネスへの関心を示すフォームが送信された場合。
BOOK_APPOINTMENT 広告主のビジネスとの予約。
REQUEST_QUOTE 見積もりまたは価格の見積もりリクエスト。
GET_DIRECTIONS 広告主様のビジネス拠点を訪問する目的で検索したユーザー。
OUTBOUND_CLICK 広告主のパートナー サイトへのクリック。
CONTACT 広告主への電話、SMS、メール、チャットなどの問い合わせ。
ENGAGEMENT ウェブサイトのエンゲージメント イベント（サイト滞在時間が長いなど）や Google アナリティクス（GA）のスマートゴール。Google アナリティクス、Firebase、Google アナリティクス ゴールドの目標のインポートに使用することを想定しています。
STORE_VISIT 実店舗への来店。
STORE_SALE 実店舗での販売。
QUALIFIED_LEAD 外部ソースから Google 広告にインポートされ、広告主（マーケティング チームまたは営業チーム）によって有望と判断された見込み顧客のコンバージョン。見込み顧客から販売に至るまでのプロセスでは、広告主は見込み顧客を獲得し、その見込み顧客にアプローチして行動を促します。見込み顧客が興味を持ち、最終的に商品を購入する可能性がある場合、広告主はこのようなリードを「見込み顧客」としてマークします。
CONVERTED_LEAD 外部ソースから Google 広告にインポートされた見込み顧客のコンバージョンで、見込み顧客獲得広告主様が定義した選択されたステージを完了しているもの。

ValueSettings

このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関する設定。

JSON 表現 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
フィールド
defaultValue

number

このコンバージョン アクションのコンバージョン イベントが無効な値、許可されていない値、または値なしで送信された場合、またはこのコンバージョン アクションが常にデフォルト値を使用するように設定されている場合に使用する値。
defaultCurrencyCode

string

このコンバージョン アクションのコンバージョン イベントが無効な通貨コードまたは通貨コードなしで送信された場合、またはこのコンバージョン アクションが常にデフォルト値を使用するように設定されている場合に使用する通貨コード。
alwaysUseDefaultValue

boolean

このコンバージョン アクションのコンバージョン イベントで指定された値と通貨コードの代わりに、デフォルト値とデフォルトの通貨コードを使用するかどうかを制御します。

AttributionModelSettings

このコンバージョン アクションのアトリビューション モデルに関連する設定。

JSON 表現 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
フィールド
attributionModel

enum (AttributionModel)

このコンバージョン アクションのアトリビューション モデルのタイプ。
dataDrivenModelStatus

enum (DataDrivenModelStatus)

コンバージョン アクションのデータドリブン アトリビューション モデルのステータス。

AttributionModel

特定のコンバージョンのクレジットを、それ以前の複数の接点にどのように配分するかを記述するアトリビューション モデル。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
EXTERNAL 外部のアトリビューションを使用します。
GOOGLE_ADS_LAST_CLICK コンバージョンのすべての貢献度をラストクリックに割り当てます。
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Google 検索アトリビューションを使用して、コンバージョンに対する貢献度をすべて最初のクリックに割り当てます。
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Google 検索アトリビューションを使用して、コンバージョンの貢献度をすべてのクリックに均等に割り当てます。
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Google 検索アトリビューションを使用して、コンバージョンのクレジットをより最近のクリックに指数関数的に割り当てます（半減期は 1 週間）。
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED コンバージョンの貢献度の 40% が最初と最後のクリックに割り当てられます。残りの 20% は、他のすべてのクリックに均等に配分されます。この場合、Google 検索のアトリビューションが使用されます。
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Google 検索アトリビューションを使用して、クリック間の貢献度の適切な配分を機械学習で決定する柔軟なモデル。

DataDrivenModelStatus

データドリブン モデルのステータスを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AVAILABLE データドリブン モデルが利用可能です。
STALE データドリブン モデルが最新ではない。7 日以上更新されていません。現在も使用されていますが、30 日間更新されないと期限切れになります。
EXPIRED データドリブン モデルの有効期限が切れました。30 日以上更新されておらず、使用できません。多くの場合、これは過去 30 日間に必要な数のイベントが発生していないことが原因です。
NEVER_GENERATED データドリブン モデルが生成されたことがない。最も一般的な原因は、30 日間の期間に要件を満たすイベントが一度も発生していないことです。

FloodlightSettings

Floodlight コンバージョン アクションに関連する設定。

JSON 表現 
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
フィールド
activityGroupTag

string

コンバージョンのレポート時に Floodlight アクティビティ グループの識別に使用される文字列。
activityTag

string

コンバージョンのレポート時に Floodlight アクティビティを識別するために使用される文字列。
activityId

string (int64 format)

DoubleClick Campaign Manager（DCM）の Floodlight アクティビティの ID。

ConversionCustomVariable

コンバージョン カスタム変数。https://support.google.com/sa360/answer/13567857 の「検索広告 360 リニューアル版のカスタム Floodlight 指標およびディメンションについて」を参照してください。

JSON 表現 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
フィールド
resourceName

string

コンバージョン カスタム変数のリソース名。コンバージョン カスタム変数リソース名の形式は次のとおりです。

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}
id

string (int64 format)

コンバージョン カスタム変数の ID。
name

string

必須。コンバージョン カスタム変数の名前。名前は一意である必要があります。名前の最大長は 100 文字です。前後に余分なスペースがないようにしてください。
tag

string

必須。コンバージョン カスタム変数のタグ。タグは一意で、"u" の直後に 100 以下の数字が続く必要があります。例: 「u4」。
status

enum (ConversionCustomVariableStatus)

コンバージョン イベントの発生に関するコンバージョン カスタム変数のステータス。
ownerCustomer

string

コンバージョン カスタム変数を所有する顧客のリソース名。
family

enum (ConversionCustomVariableFamily)

コンバージョン カスタム変数のファミリ。
cardinality

enum (ConversionCustomVariableCardinality)

コンバージョン カスタム変数のカーディナリティ。
floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

検索広告 360 の Floodlight コンバージョン カスタム変数のフィールド。
customColumnIds[]

string (int64 format)

このコンバージョン カスタム変数を使用するカスタム列の ID。

ConversionCustomVariableStatus

コンバージョン カスタム変数のステータスとして考えられるもの。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ACTIVATION_NEEDED

コンバージョン カスタム変数は有効化待ちであり、ENABLED に設定されるまで統計情報は蓄積されません。

このステータスは、CREATE リクエストと UPDATE リクエストでは使用できません。
ENABLED コンバージョン カスタム変数が有効になり、統計情報が蓄積されます。
PAUSED コンバージョン カスタム変数は一時停止され、再度 ENABLED に設定されるまで統計情報は蓄積されません。

ConversionCustomVariableFamily

コンバージョン カスタム変数のファミリ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
STANDARD 標準コンバージョン カスタム変数。ご利用前に有効化していただく必要があります。
FLOODLIGHT カスタム Floodlight 変数からインポートされたコンバージョン カスタム変数。

ConversionCustomVariableCardinality

コンバージョン カスタム変数のカーディナリティ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BELOW_ALL_LIMITS コンバージョン カスタム変数の基数は、すべての制限を下回っています。変数はセグメンテーションに使用でき、変数が有効になっている場合は、新しい値の統計情報が蓄積されます。
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT コンバージョン カスタム変数の基数がセグメンテーションの上限を超えているが、統計情報の上限は超えていない。セグメンテーションは無効になりますが、変数が有効になっている場合は、新しい値の統計情報を収集できます。
APPROACHES_STATS_LIMIT コンバージョン カスタム変数がセグメンテーションの上限を超え、統計情報の上限に近づいています（90% 超）。セグメンテーションは無効になりますが、変数が有効になっている場合は、新しい値の統計情報を収集できます。
EXCEEDS_STATS_LIMIT コンバージョン カスタム変数が、セグメンテーションの上限と統計情報の上限の両方を超えています。セグメンテーションは無効になり、有効な変数の統計情報は、既存の値によって変数のカーディナリティがさらに増加しない場合にのみ蓄積されます。

FloodlightConversionCustomVariableInfo

検索広告 360 の Floodlight コンバージョン カスタム変数に関する情報。

JSON 表現 
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
フィールド
floodlightVariableType

enum (FloodlightVariableType)

検索広告 360 で定義された Floodlight 変数のタイプ。
floodlightVariableDataType

enum (FloodlightVariableDataType)

検索広告 360 で定義された Floodlight 変数のデータタイプ。

FloodlightVariableType

検索広告 360 で定義されている Floodlight 変数のタイプ。詳しくは、https://support.google.com/searchads/answer/4397154?hl=en をご覧ください。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
DIMENSION ディメンション Floodlight 変数のタイプ。
METRIC 指標 Floodlight 変数のタイプ。
UNSET Floodlight 変数のタイプが設定されていません。

FloodlightVariableDataType

検索広告 360 で定義されている Floodlight 変数のデータタイプ。詳しくは、https://support.google.com/searchads/answer/4397154?hl=en をご覧ください。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
NUMBER 「数値」タイプの Floodlight 変数を表します。この変数は、DIMENSION 型または METRIC 型の Floodlight 変数に割り当てることができます。
STRING 「String」型の Floodlight 変数を表します。この変数は、DIMENSION 型の Floodlight 変数に割り当てることができます。

お客様

お客様。

JSON 表現 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
フィールド
resourceName

string

顧客のリソース名。顧客のリソース名の形式は次のとおりです。

customers/{customerId}
conversionTrackingSetting

object (ConversionTrackingSetting)

お客様のコンバージョン トラッキングの設定。
accountType

enum (AccountType)

エンジン アカウント タイプ（Google 広告、Microsoft Advertising、Yahoo! JAPAN、Baidu、Facebook、エンジン トラッキングなど）
doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

クライアント センター（MCC）アカウントの DoubleClick Campaign Manager（DCM）の設定。
accountStatus

enum (AccountStatus)

アカウントのステータス（有効、一時停止、削除など）。
lastModifiedTime

string

この顧客が最後に変更された日時。日時は、顧客のタイムゾーンの「yyyy-MM-dd HH:mm:ss.ssssss」形式です。
engineId

string

外部エンジン アカウントのアカウント ID。
status

enum (CustomerStatus)

顧客のステータス。
creationTime

string

この顧客が作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。
managerId

string (int64 format)

マネージャーのお客様 ID。値 0 は、顧客に検索広告 360 マネージャーがいないことを示します。
managerDescriptiveName

string

マネージャーのわかりやすい名前。
subManagerId

string (int64 format)

サブ マネージャーのお客様 ID。値 0 は、顧客にサブ検索広告 360 マネージャーがないことを示します。
subManagerDescriptiveName

string

サブ マネージャーのわかりやすい名前。
associateManagerId

string (int64 format)

アソシエイト マネージャーのお客様 ID。値 0 は、顧客に検索広告 360 の関連付けられたマネージャーがいないことを示します。
associateManagerDescriptiveName

string

アソシエイト マネージャーのわかりやすい名前。
accountLevel

enum (AccountLevelType)

お客様のアカウント レベル（マネージャー、サブマネージャー、アソシエイト マネージャー、サービス アカウント）。
id

string (int64 format)

顧客の ID。
descriptiveName

string

顧客の一意でないわかりやすい名前（省略可）。
currencyCode

string

アカウントが運用されている通貨。ISO 4217 標準の通貨コードのサブセットがサポートされています。
timeZone

string

顧客のローカル タイムゾーン ID。
trackingUrlTemplate

string

パラメータからトラッキング URL を作成するための URL テンプレート。
finalUrlSuffix

string

パラメータを最終ページ URL に追加するための URL テンプレート。
autoTaggingEnabled

boolean

お客様に対して自動タグ設定が有効になっているかどうか。
manager

boolean

お客様が管理者であるかどうか。

ConversionTrackingSetting

検索広告 360 のコンバージョン トラッキングに関連する顧客全体の設定のコレクション。

JSON 表現 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
フィールド
acceptedCustomerDataTerms

boolean

顧客が顧客データに関する規約に同意したかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値はクライアント センター（MCC）アカウントから継承されます。このフィールドは読み取り専用です。詳しくは、https://support.google.com/adspolicy/answer/7475709 をご覧ください。
conversionTrackingStatus

enum (ConversionTrackingStatus)

コンバージョン トラッキングのステータス。お客様がコンバージョン トラッキングを使用しているかどうか、また、このお客様のコンバージョン トラッキングの所有者が誰であるかを示します。このお客様がクロスアカウント コンバージョン トラッキングを使用している場合、返される値はリクエストの login-customer-id によって異なります。
enhancedConversionsForLeadsEnabled

boolean

お客様がリードの拡張コンバージョンを有効にしているかどうか。クロスアカウント コンバージョン トラッキングを使用している場合、この値はクライアント センター（MCC）アカウントから継承されます。このフィールドは読み取り専用です。
googleAdsConversionCustomer

string

コンバージョンが作成および管理される顧客のリソース名。このフィールドは読み取り専用です。
conversionTrackingId

string (int64 format)

このアカウントで使用されるコンバージョン トラッキング ID。この ID は、お客様がコンバージョン トラッキングを使用しているかどうかを示しません（conversionTrackingStatus が示します）。このフィールドは読み取り専用です。
googleAdsCrossAccountConversionTrackingId

string (int64 format)

お客様のマネージャーのコンバージョン トラッキング ID。これは、ユーザーがコンバージョン トラッキングを有効にしている場合に設定され、conversionTrackingId をオーバーライドします。このフィールドは Google 広告の UI でのみ管理できます。このフィールドは読み取り専用です。
crossAccountConversionTrackingId

string (int64 format)

お客様のマネージャーのコンバージョン トラッキング ID。これは、ユーザーがクロスアカウント コンバージョン トラッキングを有効にしている場合に設定され、conversionTrackingId をオーバーライドします。

ConversionTrackingStatus

お客様のコンバージョン トラッキングのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
NOT_CONVERSION_TRACKED お客様がコンバージョン トラッキングを使用していない。
CONVERSION_TRACKING_MANAGED_BY_SELF コンバージョン アクションは、このお客様が作成して管理します。
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER コンバージョン アクションは、リクエストの login-customer-id で指定されたマネージャーによって作成および管理されます。
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER コンバージョン アクションは、リクエストの login-customer-id で指定された顧客または MCC とは異なる MCC によって作成および管理されます。

AccountType

エンジン アカウントのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BAIDU Baidu アカウント。
ENGINE_TRACK エンジン トラッキング アカウント。
FACEBOOK Facebook アカウント。
FACEBOOK_GATEWAY ゲートウェイを通じて管理される Facebook アカウント。
GOOGLE_ADS Google 広告アカウント。
MICROSOFT Microsoft Advertising アカウント。
SEARCH_ADS_360 検索広告 360 の MCC アカウント。
YAHOO_JAPAN Yahoo! JAPAN アカウント。

DoubleClickCampaignManagerSetting

クライアント センター（MCC）アカウントの DoubleClick Campaign Manager（DCM）の設定。

JSON 表現 
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
フィールド
advertiserId

string (int64 format)

このお客様に関連付けられているキャンペーン マネージャーの広告主の ID。
networkId

string (int64 format)

このお客様に関連付けられているキャンペーン マネージャー ネットワークの ID。
timeZone

string

このクライアントに関連付けられているキャンペーン マネージャー ネットワークのタイムゾーン（IANA タイムゾーン データベース形式、例: America/New_York）。

AccountStatus

アカウントのステータス。

列挙型
UNSPECIFIED デフォルト値。
UNKNOWN 不明な値です。
ENABLED アカウントで広告を配信できます。
PAUSED アカウントがユーザーによって無効にされています。
SUSPENDED アカウントは内部プロセスによって無効化されます。
REMOVED アカウントは完全に無効化されます。
DRAFT アカウントはまだ設定中で、有効になっていません。

CustomerStatus

顧客のステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED 広告を配信できる有効なアカウントであることを示します。
CANCELED 広告を配信できないキャンセル済みのアカウントを示します。管理者ユーザーが再有効化できます。
SUSPENDED 広告を配信できない停止中のアカウントを示します。Google サポートのみが有効にできます。
CLOSED 広告を配信できない閉鎖済みのアカウントを示します。テストアカウントも [CLOSED] ステータスになります。ステータスは永続的であり、再度開くことはできません。

AccountLevelType

可能なアカウント レベルを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
CLIENT_ACCOUNT_FACEBOOK クライアント アカウント（Facebook）
CLIENT_ACCOUNT_GOOGLE_ADS クライアント アカウント（Google 広告）
CLIENT_ACCOUNT_MICROSOFT クライアント アカウント（Microsoft）
CLIENT_ACCOUNT_YAHOO_JAPAN クライアント アカウント（Yahoo Japan）
CLIENT_ACCOUNT_ENGINE_TRACK クライアント アカウント（エンジン トラッキング）
MANAGER 最上位のマネージャー。
SUB_MANAGER サブマネージャー。
ASSOCIATE_MANAGER アソシエイト マネージャー。

CustomerAsset

顧客とアセット間のリンク。

JSON 表現 
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
フィールド
resourceName

string

顧客アセットのリソース名。CustomerAsset リソース名の形式は次のとおりです。

customers/{customerId}/customerAssets/{assetId}~{fieldType}
asset

string

必須。顧客に関連付けられているアセット。
status

enum (AssetLinkStatus)

顧客アセットのステータス。

CustomerAssetSet

CustomerAssetSet は、顧客とアセットセット間のリンクです。CustomerAssetSet を追加すると、アセットセットが顧客に関連付けられます。

JSON 表現 
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
フィールド
resourceName

string

顧客アセット セットのリソース名。アセット セットのアセット リソース名の形式は次のとおりです。

customers/{customerId}/customerAssetSets/{asset_set_id}
assetSet

string

顧客に関連付けられているアセットセット。
customer

string

このアセットセットがリンクされている顧客。
status

enum (AssetSetLinkStatus)

顧客アセットセットのアセットのステータス。読み取り専用です。

AccessibleBiddingStrategy

お客様が所有し、共有している入札戦略のビューを表します。

BiddingStrategy とは対照的に、このリソースには、このお客様が所有する戦略に加えて、お客様のマネージャーが所有し、このお客様と共有している戦略が含まれます。このリソースは指標を提供せず、BiddingStrategy 属性の限定されたサブセットのみを公開します。

JSON 表現 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
フィールド
resourceName

string

アクセス可能な入札戦略のリソース名。AccessibleBiddingStrategy リソース名の形式は次のとおりです。

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}
id

string (int64 format)

入札戦略の ID。
name

string

入札戦略の名前。
type

enum (BiddingStrategyType)

入札戦略のタイプ。
ownerCustomerId

string (int64 format)

入札戦略を所有するお客様の ID。
ownerDescriptiveName

string

入札戦略を所有するお客様の descriptiveName。

共用体フィールド scheme。入札スキーム。

設定できるのは 1 つだけです。scheme は次のいずれかになります。
maximizeConversionValue

object (MaximizeConversionValue)

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

object (MaximizeConversions)

予算を消化しながらキャンペーンで最大限のコンバージョン数が得られるようにする自動入札戦略。
targetCpa

object (TargetCpa)

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

object (TargetImpressionShare)

選択したインプレッションの割合に向けて自動的に最適化する入札戦略。
targetRoas

object (TargetRoas)

特定の目標広告費用対効果（ROAS）の平均値を達成しながら、収益の最大化を図る入札戦略。
targetSpend

object (TargetSpend)

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

MaximizeConversionValue

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

JSON 表現 
{
  "targetRoas": number
}
フィールド
targetRoas

number

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

MaximizeConversions

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

JSON 表現 
{
  "targetCpa": string,
  "targetCpaMicros": string
}
フィールド
targetCpa

string (int64 format)

目標コンバージョン単価（CPA）オプション。これは、1 件の獲得あたりに費やしたい平均額です。
targetCpaMicros

string (int64 format)

目標コンバージョン単価（CPA）オプション。これは、1 件の獲得あたりに費やしたい平均額です。

TargetCpa

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

JSON 表現 
{
  "targetCpaMicros": string
}
フィールド
targetCpaMicros

string (int64 format)

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

TargetImpressionShare

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

JSON 表現 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
フィールド
location

enum (TargetImpressionShareLocation)

検索結果ページで目標とする掲載位置。
locationFractionMicros

string (int64 format)

ターゲット地域に表示する広告の割合（マイクロ単位）。たとえば、1% は 10,000 に相当します。
cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

特定の目標広告費用対効果（ROAS）の平均値を達成しながら、収益の最大化を図る自動入札戦略。

JSON 表現 
{
  "targetRoas": number
}
フィールド
targetRoas

number

費用単価の選択された収益（コンバージョン データに基づく）。

TargetSpend

自動入札戦略の一種で、予算内でクリック数を最大化できるように入札単価を自動的に調整します。

JSON 表現 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
フィールド
targetSpendMicros
(deprecated)

string (int64 format)

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

string (int64 format)

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

ManagerLinkStatus

リンクのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ACTIVE 現在有効な関係を示す
INACTIVE 終了した関係を示す
PENDING 関係がクライアントによってリクエストされたが、まだ承認されていないことを示します。
REFUSED MCC がリンクをリクエストしましたが、クライアントが拒否しました。
CANCELED MCC が関係をリクエストしたが、MCC がキャンセルしたことを示します。

CustomerClient

指定されたお客様とクライアントのお客様間のリンク。CustomerClient は、クライアント センター（MCC）アカウントのお客様にのみ存在します。直接クライアントと間接クライアントのすべてのお客様と、マネージャー自体が含まれます。

JSON 表現 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
フィールド
resourceName

string

顧客クライアントのリソース名。CustomerClient リソース名の形式は customers/{customerId}/customerClients/{client_customer_id} です。
appliedLabels[]

string

クライアント顧客に適用される、リクエスト元の顧客が所有するラベルのリソース名。ラベルのリソース名の形式は次のとおりです。

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

クライアント顧客のステータス。読み取り専用。
clientCustomer

string

指定された顧客に関連付けられているクライアント顧客のリソース名。読み取り専用。
hidden

boolean

非表示アカウントかどうかを指定します。

読み取り専用。
level

string (int64 format)

指定された顧客とクライアント間の距離。セルフリンクの場合、レベル値は 0 になります。読み取り専用。
timeZone

string

クライアントのタイムゾーンの Common Locale Data Repository（CLDR）文字列表現（例: America/Los_Angeles）。読み取り専用。
testAccount

boolean

クライアントがテスト アカウントかどうかを識別します。読み取り専用。
manager

boolean

クライアントがマネージャーかどうかを識別します。読み取り専用。
descriptiveName

string

クライアントのわかりやすい名前。読み取り専用。
currencyCode

string

クライアントの通貨コード（例: 「USD」、「EUR」）。読み取り専用。
id

string (int64 format)

クライアントのお客様の ID。読み取り専用。

DynamicSearchAdsSearchTermView

動的検索広告の検索語句ビュー。

JSON 表現 
{
  "resourceName": string,
  "landingPage": string
}
フィールド
resourceName

string

動的検索広告の検索語句ビューのリソース名。動的検索広告の検索語句ビューのリソース名の形式は次のとおりです。

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landingPage

string

インプレッションの動的に選択されたランディング ページ URL。

このフィールドは読み取り専用です。

GenderView

性別のビュー。genderView リソースには、追加された条件ではなく、有効な配信状態が反映されます。デフォルトでは、性別の条件のない広告グループはすべての性別に表示されるため、すべての性別が統計情報とともに genderView に表示されます。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

性別ビューのリソース名。性別ビューのリソース名の形式は次のとおりです。

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

地域ターゲティング定数。

JSON 表現 
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
フィールド
resourceName

string

地域ターゲティング定数のリソース名。地域ターゲティング定数のリソース名の形式は次のとおりです。

geoTargetConstants/{geo_target_constant_id}
status

enum (GeoTargetConstantStatus)

地域ターゲティング定数のステータス。
id

string (int64 format)

地域ターゲティング定数の ID。
name

string

地域ターゲティング定数の英語名。
countryCode

string

ターゲット地域に関連付けられる国コード（ISO-3166-1 alpha-2）です。
targetType

string

地域ターゲティング定数のターゲット タイプ。
canonicalName

string

ターゲット地域の名前と、その地域が属する親地域と国の名前がすべて正規の英語名で含まれます。
parentGeoTarget

string

親地域ターゲティング定数のリソース名。地域ターゲティング定数のリソース名の形式は次のとおりです。

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

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

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN

このバージョンでは受信した値が不明です。

これはレスポンス専用の値です。
ENABLED 地域ターゲティング定数が有効です。
REMOVAL_PLANNED 地域ターゲティングの定数は廃止され、削除されます。

KeywordView

キーワード ビュー。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

キーワード ビューのリソース名。キーワード ビューのリソース名の形式は次のとおりです。

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

ラベル

ラベル。

JSON 表現 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
フィールド
resourceName

string

リソースの名前です。ラベルのリソース名の形式は customers/{ownerCustomerId}/labels/{label_id} です。
status

enum (LabelStatus)

ラベルのステータス。読み取り専用。
textLabel

object (TextLabel)

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

string (int64 format)

ラベルの ID。読み取り専用。
name

string

ラベルの名前。

このフィールドは必須で、新しいラベルを作成するときに空にすることはできません。

この文字列の長さは 1～80 で指定します。

LabelStatus

ラベルのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED ラベルが有効になっています。
REMOVED ラベルが削除されます。

TextLabel

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

JSON 表現 
{
  "backgroundColor": string,
  "description": string
}
フィールド
backgroundColor

string

ラベルの背景色（16 進数形式）。この文字列は、正規表現「^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$」に一致する必要があります。注: 管理者アカウントでは背景色が非表示になる場合があります。
description

string

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

LanguageConstant

言語。

JSON 表現 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
フィールド
resourceName

string

言語定数のリソース名。言語定数のリソース名の形式は次のとおりです。

languageConstants/{criterionId}
id

string (int64 format)

言語定数の ID。
code

string

言語コード（例: 「en_US」、「en_AU」、「es」、「fr」など）。
name

string

言語の正式名（英語）。例: 「英語（米国）」、「スペイン語」など。
targetable

boolean

言語がターゲットに設定可能かどうか。

LocationView

地域ビューでは、地域条件別にキャンペーンのパフォーマンスがまとめられます。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

ロケーション ビューのリソース名。地域ビューのリソース名の形式は次のとおりです。

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

商品入札カテゴリ。

JSON 表現 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
フィールド
resourceName

string

商品入札カテゴリのリソース名。商品入札カテゴリのリソース名の形式は次のとおりです。

productBiddingCategoryConstants/{countryCode}~{level}~{id}
level

enum (ProductBiddingCategoryLevel)

商品の入札カテゴリのレベル。
status

enum (ProductBiddingCategoryStatus)

商品の入札カテゴリのステータス。
id

string (int64 format)

商品の入札カテゴリの ID。

この ID は、この記事（https://support.google.com/merchants/answer/6324436）で説明されている google_product_category ID と同等です。
countryCode

string

商品の入札カテゴリの 2 文字の大文字の国コード。
productBiddingCategoryConstantParent

string

親の商品入札カテゴリのリソース名。
languageCode

string

商品の入札カテゴリの言語コード。
localizedName

string

languageCode に従ってローカライズされた商品入札カテゴリの表示値。

ProductBiddingCategoryLevel

商品の入札カテゴリのレベルを表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
LEVEL1 レベル 1。
LEVEL2 レベル 2。
LEVEL3 レベル 3。
LEVEL4 レベル 4。
LEVEL5 レベル 5。

ProductBiddingCategoryStatus

商品の入札カテゴリのステータスを表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ACTIVE カテゴリは有効で、入札に使用できます。
OBSOLETE カテゴリは廃止されました。レポート作成の目的でのみ使用されます。

ProductGroupView

商品グループビュー。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

商品グループビューのリソース名。商品グループビューのリソース名の形式は次のとおりです。

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

ショッピングの掲載結果ビュー。複数の商品ディメンション レベルで集計されたショッピング キャンペーンの統計情報を提供します。Merchant Center の商品ディメンションの値（ブランド、カテゴリ、カスタム属性、商品の状態、商品カテゴリなど）は、対応するイベントが記録された日時における各ディメンションの状態を反映します。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

ショッピングの掲載結果ビューのリソース名。ショッピング パフォーマンス ビューのリソース名の形式は customers/{customerId}/shoppingPerformanceView です。

UserList

ユーザーリスト。これは、顧客がターゲットにできるユーザーのリストです。

JSON 表現 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
フィールド
resourceName

string

ユーザーリストのリソース名。ユーザーリストのリソース名の形式は次のとおりです。

customers/{customerId}/userLists/{user_list_id}
type

enum (UserListType)

このリストのタイプ。

このフィールドは読み取り専用です。
id

string (int64 format)

ユーザーリストの ID。
name

string

このユーザーリストの名前。access_reason によっては、ユーザー リスト名が一意でない場合があります（access_reason=SHARED の場合など）。

UserListType

有効なユーザーリストのタイプを含む列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
REMARKETING コンバージョンの種類のコレクションとして表される UserList。
LOGICAL 他のユーザーリスト / 興味 / 関心の組み合わせとして表される UserList。
EXTERNAL_REMARKETING Google アド マネージャー プラットフォームで作成されたユーザーリスト。
RULE_BASED ルールに関連付けられた UserList。
SIMILAR 別の UserList のユーザーに類似するユーザーを含む UserList。
CRM_BASED 広告主がメールなどの形式で提供する自社 CRM データのユーザーリスト。

UserLocationView

ユーザーの所在地ビュー。

[User Location View] には、国単位で集計されたすべての指標が、国ごとに 1 行で表示されます。対象地域と非対象地域別に、ユーザーの実際の所在地における指標が表示されます。他のセグメント フィールドを使用すると、国ごとに複数の行が返されることがあります。

JSON 表現 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
フィールド
resourceName

string

ユーザーの所在地ビューのリソース名。UserLocation ビューのリソース名の形式は次のとおりです。

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

国の条件 ID。
targetingLocation

boolean

ビジネスがターゲットに設定されたかどうかを示します。

WebpageView

ウェブページ ビュー。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

ウェブページ ビューのリソース名。ウェブページ ビューのリソース名の形式は次のとおりです。

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

アクセス

訪問。

JSON 表現 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
フィールド
resourceName

string

訪問のリソース名。訪問リソース名の形式は次のとおりです。

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}
id

string (int64 format)

訪問の ID。
criterionId

string (int64 format)

Search Ads 360 キーワード ID。値 0 は、キーワードが関連付けられていないことを示します。
merchantId

string (int64 format)

クリックされた商品を含む検索広告 360 在庫アカウント ID。検索広告 360 内で在庫アカウントをリンクすると、検索広告 360 でこの ID が生成されます。
adId

string (int64 format)

広告 ID。値 0 は、広告が関連付けられていないことを示します。
clickId

string

クリック ID URL パラメータとしてランディング ページに渡される、訪問ごとの一意の文字列。
visitDateTime

string

訪問イベントのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「yyyy-MM-dd HH:mm:ss」形式で指定します。
productId

string

クリックされた商品の ID。
productChannel

enum (ProductChannel)

クリックされた商品の販売チャネル: オンラインまたはローカル。
productLanguageCode

string

商品に関するデータを含む Merchant Center フィードに設定されている言語（ISO-639-1）。
productStoreId

string

クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。
productCountryCode

string

クリックされた商品を含む在庫フィードに登録されている国（ISO-3166 形式）。
assetId

string (int64 format)

アクセス イベント中に操作されたアセットの ID。
assetFieldType

enum (AssetFieldType)

アクセス イベントのアセット フィールド タイプ。

ProductChannel

商品提案の地域性を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ONLINE アイテムがオンラインで販売されている。
LOCAL この商品は実店舗で販売されています。

コンバージョン

コンバージョン。

JSON 表現 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
フィールド
resourceName

string

コンバージョンのリソース名。コンバージョン リソース名の形式は次のとおりです。

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}
id

string (int64 format)

コンバージョンの ID
criterionId

string (int64 format)

検索広告 360 の条件 ID。値 0 は、その条件が関連付けられていないことを示します。
merchantId

string (int64 format)

クリックされた商品を含む検索広告 360 在庫アカウント ID。検索広告 360 内で在庫アカウントをリンクすると、検索広告 360 でこの ID が生成されます。
adId

string (int64 format)

広告 ID。値 0 は、広告が関連付けられていないことを示します。
clickId

string

コンバージョンが関連付けられている訪問の一意の文字列で、click id という URL パラメータとしてランディング ページに渡されます。
visitId

string (int64 format)

コンバージョンが関連付けられた検索広告 360 の訪問 ID。
advertiserConversionId

string

オフライン コンバージョンの場合は、広告主が提供する ID です。このような ID が広告主から指定されていない場合、検索広告 360 によって生成されます。オンライン コンバージョンの場合は、広告主の Floodlight 処理に応じて、id 列または floodlightOrderId 列と同じになります。
productId

string

クリックされた商品の ID。
productChannel

enum (ProductChannel)

クリックされた商品の販売チャネル: オンラインまたはローカル。
productLanguageCode

string

商品に関するデータを含む Merchant Center フィードに設定されている言語（ISO-639-1）。
productStoreId

string

クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。
productCountryCode

string

クリックされた商品を含む在庫フィードに登録されている国（ISO-3166 形式）。
attributionType

enum (AttributionType)

コンバージョンが関連付けられた要素: 「訪問」または「キーワード + 広告」。
conversionDateTime

string

コンバージョン イベントのタイムスタンプ。
conversionLastModifiedDateTime

string

コンバージョンが最後に変更された時刻のタイムスタンプ。
conversionVisitDateTime

string

コンバージョンが関連付けられた訪問のタイムスタンプ。
conversionQuantity

string (int64 format)

コンバージョンで記録されたアイテムの数量で、qty という URL パラメータによって特定されます。広告主がパラメータ（コンバージョンで販売されたアイテム数など）を動的に入力する必要がありますが、入力しない場合、デフォルトで 1 になります。
conversionRevenueMicros

string (int64 format)

コンバージョン イベントの調整された収益（マイクロ秒単位）。これは常に広告配信中アカウントの通貨で表示されます。
floodlightOriginalRevenue

string (int64 format)

Floodlight 通貨指示の変更前の、Floodlight イベントに関連付けられた、変更されていない元の収益（現在のレポートの通貨）。
floodlightOrderId

string

コンバージョンに関して広告主から提供された Floodlight オーダー ID。
status

enum (ConversionStatus)

コンバージョンのステータス（ENABLED または REMOVED）。
assetId

string (int64 format)

コンバージョン イベント中に操作されたアセットの ID。
assetFieldType

enum (AssetFieldType)

コンバージョン イベントのアセット フィールド タイプ。

AttributionType

検索広告 360 のコンバージョン アトリビューション タイプ

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
VISIT コンバージョンは訪問に分類されます。
CRITERION_AD コンバージョンは条件と広告のペアに関連付けられます。

ConversionStatus

コンバージョンのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED コンバージョンが有効になっている。
REMOVED コンバージョンが削除されました。

指標

指標データ。

JSON 表現 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
フィールド
allConversionsValueByConversionDate

number

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

number

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

object (Value)

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

number

コンバージョンの日付別の入札可能なコンバージョン値の合計。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。
conversionsByConversionDate

number

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

enum (QualityScoreBucket)

クリエイティブの品質スコア（履歴）。
historicalLandingPageQualityScore

enum (QualityScoreBucket)

ランディング ページの利便性（履歴）の品質。
historicalSearchPredictedCtr

enum (QualityScoreBucket)

検索の推定クリック率（CTR）の履歴。
interactionEventTypes[]

enum (InteractionEventType)

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

object (Value)

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

number

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

number

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

number

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

number

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

number

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

number

ユーザーが広告をクリックした後に、[発信] ボタンを押して店舗に電話した回数を示します。通話時間と、電話がつながったかどうかは考慮されません。

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

number

ユーザーが広告をクリックした後に、[ルートを検索] ボタンをクリックして広告主様の店舗へのルートを確認した回数を示します。

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

number

インタラクションからのすべてのコンバージョン値を、インタラクションの総数で割った値。
allConversionsFromMenu

number

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

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

number

ユーザーが広告をクリックした後に、広告主様の店舗で行った注文の数を示します。

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

number

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

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

number

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

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

number

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

number

ユーザーが広告をクリックした後で、広告主様の店舗の URL に誘導された回数を示します。

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

number

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

number

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

number

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

string (int64 format)

クリック数です。
contentBudgetLostImpressionShare

number

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

number

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

number

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

number

コンバージョン対象のインタラクション 1 回あたりの、入札可能なコンバージョン（インタラクションから）の平均数。広告に対するユーザーの操作が平均してどれくらいの頻度で入札可能なコンバージョンにつながっているかを表す指標です。
clientAccountConversionsValue

number

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

number

入札可能なコンバージョンの値を、コンバージョン対象のインタラクションの合計費用で割った値。
conversionsFromInteractionsValuePerInteraction

number

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

number

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

string (int64 format)

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

平均品質スコア。
historicalQualityScore

string (int64 format)

品質スコア（履歴）。
impressions

string (int64 format)

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

number

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

string (int64 format)

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

number

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

string (int64 format)

Google が無効と判断し、料金を請求しないクリック数。
generalInvalidClickRate

number

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

string (int64 format)

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

number

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

number

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

number

予算が少ないことが原因で、検索結果の上位の広告の 1 番目に広告が表示されなかった回数の推定数。注: 検索予算の検索広告の最上部インプレッション シェア損失率は、0 ～ 0.9 の範囲で報告されます。0.9 を超える値はすべて 0.9001 として報告されます。
searchBudgetLostImpressionShare

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

number

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

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

number

上位のオーガニック検索結果のすぐ近くに表示される広告のインプレッションの割合。
valuePerAllConversions

number

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

number

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

number

入札可能なコンバージョンの値を、入札可能なコンバージョン数で割った値。入札可能なコンバージョン 1 件あたりの平均価値が表示されます。
valuePerConversionsByConversionDate

number

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

number

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

number

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

number

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

number

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

string (int64 format)

リクエストされた期間に広告を視聴したユニーク ユーザーの数。この指標は集計できず、92 日以内の期間についてのみリクエストできます。この指標は、ディスプレイ、動画、ファインド、アプリの各キャンペーン タイプで使用できます。
averageImpressionFrequencyPerUser

number

リクエストされた期間に 1 人のユーザーが広告を見た平均回数です。この指標は集計できず、92 日以内の期間についてのみリクエストできます。この指標は、ディスプレイ、動画、ファインド、アプリの各キャンペーン タイプで使用できます。

値

汎用データ コンテナ。

JSON 表現 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
フィールド
共用体フィールド value。値。value は次のいずれかになります。
booleanValue

boolean

ブール値。
int64Value

string (int64 format)

int64。
floatValue

number

浮動小数点数。
doubleValue

number

double。
stringValue

string

文字列。

QualityScoreBucket

品質スコアのバケットの候補を列挙する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
BELOW_AVERAGE クリエイティブの品質が平均を下回っています。
AVERAGE クリエイティブの品質は平均的です。
ABOVE_AVERAGE クリエイティブの品質が平均を上回っている。

InteractionEventType

支払い対象のインタラクションと無料インタラクションの可能なタイプを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
CLICK クリックしてサイトにアクセスします。ほとんどの場合、このインタラクションは外部の場所（通常は広告主のランディング ページ）に移動します。これは、クリック イベントのデフォルトの InteractionEventType でもあります。
ENGAGEMENT ユーザーが広告をインプレースで操作する意向を表明したかどうか。
VIDEO_VIEW ユーザーが動画広告を視聴しました。
NONE 広告コンバージョン イベントのデフォルトの InteractionEventType。これは、広告コンバージョン行で、無料のインタラクション（広告コンバージョンなど）を「プロモーション」してコア指標の一部としてレポートする必要がないことを示す場合に使用されます。これらは単に他の（広告）コンバージョンです。

セグメント

セグメントのみのフィールド。

JSON 表現 
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
フィールド
adNetworkType

enum (AdNetworkType)

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

enum (ConversionActionCategory)

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

object (Value)

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

enum (DayOfWeek)

曜日（MONDAY など）。
device

enum (Device)

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

object (Keyword)

キーワード条件。
productChannel

enum (ProductChannel)

商品のチャネル。
productChannelExclusivity

enum (ProductChannelExclusivity)

商品のチャネル独占性。
productCondition

enum (ProductCondition)

商品の状態。
productSoldCondition

enum (ProductCondition)

販売した商品の状態。
rawEventConversionDimensions[]

object (Value)

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

integer

時間帯（0 ～ 23 の数値）。
month

string

月の初日の日付で表される月。yyyy-MM-dd 形式で指定します。
productBiddingCategoryLevel1

string

商品の入札カテゴリ（レベル 1）。
productBiddingCategoryLevel2

string

商品の入札カテゴリ（レベル 2）。
productBiddingCategoryLevel3

string

商品の入札カテゴリ（レベル 3）。
productBiddingCategoryLevel4

string

商品の入札カテゴリ（レベル 4）。
productBiddingCategoryLevel5

string

商品の入札カテゴリ（レベル 5）。
productBrand

string

商品のブランド。
productCountry

string

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

string

商品のカスタム属性 0。
productCustomAttribute1

string

商品のカスタム属性 1。
productCustomAttribute2

string

商品のカスタム属性 2。
productCustomAttribute3

string

商品のカスタム属性 3。
productCustomAttribute4

string

商品のカスタム属性 4。
productItemId

string

商品の商品アイテム ID。
productLanguage

string

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

string

販売した商品の入札カテゴリ（レベル 1）。
productSoldBiddingCategoryLevel2

string

販売した商品の入札カテゴリ（レベル 2）。
productSoldBiddingCategoryLevel3

string

販売した商品の入札カテゴリ（レベル 3）。
productSoldBiddingCategoryLevel4

string

販売した商品の入札カテゴリ（レベル 4）。
productSoldBiddingCategoryLevel5

string

販売した商品の入札カテゴリ（レベル 5）。
productSoldBrand

string

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

string

販売した商品のカスタム属性 0。
productSoldCustomAttribute1

string

販売した商品のカスタム属性 1。
productSoldCustomAttribute2

string

販売した商品のカスタム属性 2。
productSoldCustomAttribute3

string

販売した商品のカスタム属性 3。
productSoldCustomAttribute4

string

販売した商品のカスタム属性 4。
productSoldItemId

string

販売した商品の商品アイテム ID。
productSoldTitle

string

販売した商品のタイトル。
productSoldTypeL1

string

販売した商品のタイプ（レベル 1）。
productSoldTypeL2

string

販売した商品のタイプ（レベル 2）。
productSoldTypeL3

string

販売した商品のタイプ（レベル 3）。
productSoldTypeL4

string

販売した商品のタイプ（レベル 4）。
productSoldTypeL5

string

販売した商品のタイプ（レベル 5）。
productStoreId

string

商品のストア ID。
productTitle

string

商品のタイトル。
productTypeL1

string

商品のタイプ（レベル 1）。
productTypeL2

string

商品のタイプ（レベル 2）。
productTypeL3

string

商品のタイプ（レベル 3）。
productTypeL4

string

商品のタイプ（レベル 4）。
productTypeL5

string

商品のタイプ（レベル 5）。
quarter

string

四半期。四半期の初日の日付で表されます。四半期に暦年を使用します。たとえば、2018 年の第 2 四半期は 2018 年 4 月 1 日に開始されます。yyyy-MM-dd 形式で指定します。
week

string

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

integer

年（yyyy 形式）。
assetInteractionTarget

object (AssetInteractionTarget)

CustomerAsset、CampaignAsset、AdGroupAsset の指標でのみ使用されます。インタラクション指標がアセット自体で発生したか、別のアセットまたは広告ユニットで発生したかを示します。インタラクション（クリックなど）は、配信された広告のすべての部分（広告自体やサイトリンクなどの他のコンポーネントなど）で同時に発生した場合にカウントされます。interactionOnThisAsset が true の場合、操作はこの特定のアセットに対して行われたことを意味します。interactionOnThisAsset が false の場合、操作はこの特定のアセットではなく、このアセットとともに配信された広告の他の部分に対して行われたことを意味します。

AdNetworkType

Google 広告のネットワーク タイプを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
SEARCH Google 検索。
SEARCH_PARTNERS 検索パートナー。
CONTENT ディスプレイ ネットワークです。
YOUTUBE_WATCH YouTube 動画
MIXED クロスネットワーク。

キーワード

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

JSON 表現 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
フィールド
info

object (KeywordInfo)

キーワード情報。
adGroupCriterion

string

AdGroupCriterion リソース名。

ProductChannelExclusivity

商品提案の在庫状況を表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SINGLE_CHANNEL 商品アイテムは、ProductChannel で指定されているように、ローカル店舗またはオンラインのいずれか 1 つのチャネルでのみ販売されます。
MULTI_CHANNEL 商品アイテムがオンラインまたは実店舗の対応商品と照合され、両方の ShoppingProductChannel で購入可能であることが示されます。

ProductCondition

商品アイテムの状態を表す列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
OLD 商品の状態が中古である。
NEW 商品の状態が新品である。
REFURBISHED 商品の状態が再生品である。
USED 商品の状態は中古です。

AssetInteractionTarget

AssetInteractionTarget セグメント。

JSON 表現 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
フィールド
asset

string

アセットのリソース名。
interactionOnThisAsset

boolean

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