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,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
フィールド
resourceName

string

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

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

enum (AdGroupStatus)

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

enum (AdGroupType)

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

enum (AdGroupAdRotationMode)

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

string

この広告グループが作成されたときのタイムスタンプ。このタイムスタンプは、顧客のタイムゾーンを「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）の文字を含めることはできません。
cpcBidMicros

string (int64 format)

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

enum (AdGroupEngineStatus)

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

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

このターゲティング ディメンションで選択した条件にのみ広告を表示するか、このターゲティング ディメンションのすべての値をターゲットに設定し、他のターゲティング ディメンションでのターゲティングに基づいて広告を表示するかを指定します。値が 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 広告グループの広告が削除されます。

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/{customerId}/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/{customerId}/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
  ],
  "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 のリスト。
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 バイドゥ: バイドゥで審査中です。Gemini: 審査中の条件。
AD_GROUP_CRITERION_NOT_REVIEWED バイドゥ: 審査対象の条件。
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 アカウントが一時停止されているため、条件が一時停止されています。

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/{customerId}/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/{customerId}/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/{customerId}/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/{customerId}/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
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": 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 のリスト。
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 テンプレート。
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

次の ID = 11

列挙型
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 MIME タイプは image/jpeg。
IMAGE_GIF 画像/gif の MIME タイプ。
IMAGE_PNG MIME タイプは image/png。
FLASH MIME タイプは application/x-shockwave-flash です。
TEXT_HTML MIME タイプは text/html。
PDF MIME タイプは application/pdf です。
MSWORD MIME タイプは application/msword です。
MSEXCEL MIME タイプは application/vnd.ms-excel です。
RTF MIME タイプは application/rtf です。
AUDIO_WAV MIME タイプは audio/wav です。
AUDIO_MP3 MIME タイプは audio/mp3 です。
HTML5_AD_ZIP MIME タイプは application/x-html5-ad-zip です。

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

AdScheduleInfo

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

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 は当日を意味します。このフィールドは 0 ～ 24 の範囲で指定してください。

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

MinuteOfHour

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

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
ZERO 正時 0 分。
FIFTEEN 15 分経過した時刻。
THIRTY 30 分経過後。
FORTY_FIVE 午後 4 時 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 Advertising に適用されます。
mobilePreferred

boolean

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

UnifiedPageFeedAsset

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

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

string

広告主がターゲットに設定するウェブページ。
labels[]

string

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

MobileAppAsset

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

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

string

必須。モバイルアプリを一意に識別する文字列。プラットフォーム固有の ID（Android の場合は「com.android.ebay」、iOS の場合は「12345689」など）のみを含める必要があります。
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 Advertising に適用されます。
callTrackingEnabled

boolean

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

boolean

検索ユーザーのタイムゾーンで通話エクステンションを表示するかどうか。Microsoft Advertising に適用されます。
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 とアセットタイプに対して一意です。Place 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 キャンペーンでホテル物件として使用されている。

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

アセット グループのトップ コンビネーション ビューのリソース名。AssetGroup のトップ コンビネーション ビューのリソース名の形式は、「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 アセットがリードフォームとして使用されている。

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 文字の通貨コード）。

マネージャー アカウントの入札戦略の場合、この通貨は作成時に設定できます。デフォルトでは、マネージャー アカウントの通貨が使用されます。サービング カスタマーの場合、このフィールドは設定できません。サービング カスタマーのすべての戦略では、サービング カスタマーの通貨が暗黙的に使用されます。いずれの場合も、effectiveCurrencyCode フィールドは戦略で使用されている通貨を返します。
id

string (int64 format)

入札戦略の ID。
name

string

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

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

string

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

マネージャー クライアントの入札戦略の場合、これは広告主が戦略を作成する際に設定した通貨です。お客様へのサービス提供の場合、これはお客様の 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 動画視聴ごとに設定可能な金額を支払う入札戦略。
MAXIMIZE_CONVERSIONS 1 日の予算内でコンバージョン数を自動的に最大化する入札戦略。
MAXIMIZE_CONVERSION_VALUE 予算内で収益を最大化できるように入札単価を自動的に調整する自動入札戦略。
PAGE_ONE_PROMOTED ページ 1 のスポンサー掲載入札戦略。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）オプション。コンバージョン アクションごとに支払う金額の平均です。入札戦略の通貨のマイクロ単位で指定します。目標コンバージョン単価を設定すると、その目標単価以下でコンバージョンを最大限に獲得できるように入札単価が設定されます。目標コンバージョン単価が設定されていない場合、入札戦略では予算を考慮して可能な限り低いコンバージョン単価を達成することを目指します。

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,
  "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)

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

新しいキャンペーンを追加すると、ステータスはデフォルトで [有効] になります。
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」形式です。
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)

1,000 インプレッションあたりの費用を自動的に最適化する入札戦略。

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 スマート ショッピング キャンペーンのコンバージョン トラッキング（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 Hotel Ads キャンペーン。
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 トラッキングのみのソーシャル キャンペーン。

CustomParameter

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

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

string

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

string

置換する値。

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。

ManualCpa

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

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

ManualCpc

ユーザーがクリック単価で支払う、クリック単価の個別設定。

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

boolean

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

ManualCpm

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

インプレッション単価の個別設定。ユーザーは 1,000 インプレッションごとに支払います。

PercentCpc

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

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

string (int64 format)

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

boolean

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

TargetCpm

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

目標インプレッション単価（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

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

string (int64 format)

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

LocationGroupRadiusUnits

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

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

CampaignEffectiveLabel

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

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

string

リソースの名前。CampaignEffectivelabel リソース名の形式は customers/{customerId}/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/{customerId}/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 は省略可能として宣言されていないため、作成後に「update」オペレーションで 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

コンバージョン カスタム変数は有効化待ちです。[有効] に設定されるまで、統計情報は蓄積されません。

このステータスは、CREATE リクエストと UPDATE リクエストでは使用できません。
ENABLED コンバージョン カスタム変数が有効になり、統計情報が蓄積されます。
PAUSED コンバージョン カスタム変数は一時停止され、再度 [有効] に設定されるまで統計情報は蓄積されません。

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 変数を表します。この変数は、ディメンション型または指標型の 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)

マネージャーのお客様の 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 広告の管理画面でのみ管理できます。このフィールドは読み取り専用です。
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 で指定されたお客様または管理者とは異なる管理者が、コンバージョン アクションを作成して管理している。

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

マネージャーのお客様の 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

お客様が所有し、お客様と共有している BiddingStrategies のビューを表します。

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 マネージャーが関係をリクエストしたが、クライアントが拒否した。
CANCELED マネージャーが関係をリクエストしたが、マネージャーがキャンセルしたことを示します。

CustomerClient

特定のお客様とクライアント カスタマー間のリンク。CustomerClient は、マネージャー ユーザーにのみ存在します。直接および間接のすべてのクライアント カスタマーと、マネージャー自体が含まれます。

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/{customerId}/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 データの UserList。

UserLocationView

ユーザーの位置情報のビュー。

ユーザーの位置情報ビューには、国レベルで集計されたすべての指標が国ごとに 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
}
フィールド
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

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

number

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

コンバージョンに貢献したインタラクションあたりの平均入札対象コンバージョン数（インタラクションから）。広告インタラクションが入札単価設定可能なコンバージョンにつながる平均頻度を示します。
clientAccountConversionsValue

number

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

number

入札単価設定可能なコンバージョンの値を、コンバージョンに至ったインタラクションの総費用で割った値。
conversionsFromInteractionsValuePerInteraction

number

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

number

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

string (int64 format)

指定された期間における、クリック単価（CPC）による費用とインプレッション単価（CPM）による費用の総額。この指標は金額であり、デフォルトではお客様の通貨で返されます。metrics_currency パラメータについては、https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause をご覧ください。
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

上位の広告として実際に表示された広告のインプレッション数を、上位の広告として表示が見込めた広告のインプレッション数で割った値です。注: 検索の検索広告のページ上部インプレッション シェアは、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

入札対象コンバージョンの値を入札対象コンバージョン数で割った値。入札単価を設定した各コンバージョンの平均価値が表示されます。
valuePerConversionsByConversionDate

number

コンバージョンの日付別の入札対象コンバージョン値を、コンバージョンの日付別の入札対象コンバージョンで割った値。入札単価を設定した各コンバージョンの価値の平均（コンバージョンの日付別）が表示されます。この列が日付とともに選択されている場合、日付列の値はコンバージョンの日付を表します。
clientAccountViewThroughConversions

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

number

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

number

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

number

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

number

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

値

汎用データ コンテナ。

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 商品アイテムがオンライン ショップまたは実店舗の対応する商品アイテムと一致しており、両方の ShoppingProductChannels で購入できることを示します。

ProductCondition

商品の状態を記述する列挙型。

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

AssetInteractionTarget

AssetInteractionTarget セグメント。

JSON 表現 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
フィールド
asset

string

アセット リソース名。
interactionOnThisAsset

boolean

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