AdGroupCriterion

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

JSON 表現 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
フィールド
resourceName

string

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

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

出力専用。条件の表示名。

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

enum (AdGroupCriterionStatus)

条件のステータス。

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

object (QualityInfo)

出力専用。基準の品質に関する情報。
type

enum (CriterionType)

出力専用。条件のタイプ。
systemServingStatus

enum (CriterionSystemServingStatus)

出力専用。条件の配信ステータス。
approvalStatus

enum (AdGroupCriterionApprovalStatus)

出力専用。条件の承認ステータス。
disapprovalReasons[]

string

出力専用。条件が不承認になった理由のリストです。

条件を不承認とするさまざまな理由については、https://support.google.com/adspolicy/answer/6008942 をご覧ください。

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

string

出力専用。この広告グループの条件に適用されているラベルのリソース名。
effectiveCpcBidSource

enum (BiddingSource)

出力専用。有効なクリック単価のソース。
effectiveCpmBidSource

enum (BiddingSource)

出力専用。有効インプレッション単価のソース。
effectiveCpvBidSource

enum (BiddingSource)

出力専用。有効な広告視聴単価の参照元です。
effectivePercentCpcBidSource

enum (BiddingSource)

出力専用。有効クリック単価の割合の参照元。
positionEstimates

object (PositionEstimates)

出力専用。さまざまな掲載順位におけるクライテリアの入札単価の見積もりです。
finalUrls[]

string

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

string

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

object (CustomParameter)

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

string (int64 format)

出力専用。条件の ID。

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

string

変更不可。条件が属する広告グループです。
negative

boolean

変更不可。条件をターゲットに設定するか（false）、除外するか（true）を指定します。

このフィールドは変更できません。条件を正から負に変更するには、その条件を削除してから再度追加します。
bidModifier

number

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

string (int64 format)

クリック単価（CPC）。
cpmBidMicros

string (int64 format)

インプレッション単価（CPM）で、
cpvBidMicros

string (int64 format)

CPV（広告視聴単価）入札。
percentCpcBidMicros

string (int64 format)

商品やサービスの広告価格に対する割合で表したクリック単価。分数の有効な範囲は [0,1) で、ここに格納される値は 1,000,000 * [小数] です。
effectiveCpcBidMicros

string (int64 format)

出力専用。有効な CPC（クリック単価）入札。
effectiveCpmBidMicros

string (int64 format)

出力専用。有効 CPM（視認範囲のインプレッション単価）。
effectiveCpvBidMicros

string (int64 format)

出力専用。有効な広告視聴単価（CPV）です。
effectivePercentCpcBidMicros

string (int64 format)

出力専用。有効なクリック単価の割合（%）。
finalUrlSuffix

string

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

string

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

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

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

object (KeywordInfo)

変更不可。キーワード。
placement

object (PlacementInfo)

変更不可。プレースメント。
mobileAppCategory

object (MobileAppCategoryInfo)

変更不可。モバイルアプリのカテゴリです。
mobileApplication

object (MobileApplicationInfo)

変更不可。モバイルアプリ。
listingGroup

object (ListingGroupInfo)

変更不可。リスティング グループ。
ageRange

object (AgeRangeInfo)

変更不可。年齢層。
gender

object (GenderInfo)

変更不可。性別。
incomeRange

object (IncomeRangeInfo)

変更不可。収入の範囲。
parentalStatus

object (ParentalStatusInfo)

変更不可。子供の有無。
userList

object (UserListInfo)

変更不可。ユーザーリスト。
youtubeVideo

object (YouTubeVideoInfo)

変更不可。YouTube 動画。
youtubeChannel

object (YouTubeChannelInfo)

変更不可。YouTube チャンネル。
topic

object (TopicInfo)

変更不可。トピック。
userInterest

object (UserInterestInfo)

変更不可。ユーザーの興味や関心。
webpage

object (WebpageInfo)

変更不可。ウェブページ
appPaymentModel

object (AppPaymentModelInfo)

変更不可。アプリの支払いモデル。
customAffinity

object (CustomAffinityInfo)

変更不可。カスタム アフィニティ。
customIntent

object (CustomIntentInfo)

変更不可。カスタム インテント。
customAudience

object (CustomAudienceInfo)

変更不可。カスタム オーディエンス。
combinedAudience

object (CombinedAudienceInfo)

変更不可。統合オーディエンス
audience

object (AudienceInfo)

変更不可。オーディエンス
location

object (LocationInfo)

変更不可。位置情報] をタップします。
language

object (LanguageInfo)

変更不可。学びました。

AdGroupCriterionStatus

AdGroupCriterion のステータスです。

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

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

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

QualityInfo

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

JSON 表現 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
フィールド
creativeQualityScore

enum (QualityScoreBucket)

出力専用。他の広告主様と比較した広告の掲載結果
postClickQualityScore

enum (QualityScoreBucket)

出力専用。ランディング ページの品質スコア。
searchPredictedCtr

enum (QualityScoreBucket)

出力専用。他の広告主と比較したクリック率。
qualityScore

integer

出力専用。品質スコア。

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

CriterionSystemServingStatus

条件のシステム配信ステータスを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
ELIGIBLE 有効。
RARELY_SERVED 検索ボリュームが少ない。

AdGroupCriterionApprovalStatus

AdGroupCriterion の承認ステータスを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値が不明です。
APPROVED 承認。
DISAPPROVED 不承認。
PENDING_REVIEW 審査待ち。
UNDER_REVIEW 審査中です。

PositionEstimates

さまざまな掲載順位におけるクライテリアの入札単価の見積もりです。

JSON 表現 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
フィールド
firstPageCpcMicros

string (int64 format)

出力専用。検索結果の最初のページに広告を表示するために必要なクリック単価の見積もり。
firstPositionCpcMicros

string (int64 format)

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

string (int64 format)

出力専用。検索結果の最初のページの上部に広告を表示するために必要なクリック単価の見積もり額です。
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

出力専用。キーワードの入札単価を firstPositionCpcMicros の値に変更することで獲得できる 1 週間あたりのクリック数の見積もりです。
estimatedAddCostAtFirstPositionCpc

string (int64 format)

出力専用。キーワードの入札単価を firstPositionCpcMicros の値に変更した場合に、1 週間あたりの費用がどのように変化するかの見積もりです。

ListingGroupInfo

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

JSON 表現 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
フィールド
type

enum (ListingGroupType)

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

object (ListingDimensionInfo)

このリスティング グループが親を絞り込むために使用するディメンション値。ルートグループに対して未定義です。
parentAdGroupCriterion

string

親のリスティング グループの区分である広告グループの条件のリソース名。ルートグループの場合は null。
path

object (ListingDimensionPath)

このリスティング グループを定義する項目のパス。

ListingGroupType

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

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

ListingDimensionPath

リスティング グループを定義する項目のパス。

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

object (ListingDimensionInfo)

リスティング グループの階層内の、ルート（ルート自体を除く）からこのリスティング グループまでのディメンションの完全パス。

AppPaymentModelInfo

アプリの支払いモデルの条件。

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

enum (AppPaymentModelType)

アプリの支払いモデルのタイプ。

AppPaymentModelType

利用可能なアプリの支払いモデルを記述する列挙型。

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

CustomIntentInfo

カスタム インテントの条件。このタイプの条件は、ターゲットに設定することのみ可能です。

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

string

CustomInterest のリソース名。