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)
    }
  ],
  "primaryStatusReasons": [
    enum (AdGroupCriterionPrimaryStatusReason)
  ],
  "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,
  "primaryStatus": enum (AdGroupCriterionPrimaryStatus),

  // 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 でカスタム パラメータ タグの置換に使用するマッピングのリスト。
primaryStatusReasons[]

enum (AdGroupCriterionPrimaryStatusReason)

出力専用。広告グループの条件の主なステータスの理由。
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)

出力専用。有効広告視聴単価。
effectivePercentCpcBidMicros

string (int64 format)

出力専用。有効なクリック単価の割合の金額。
finalUrlSuffix

string

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

string

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

enum (AdGroupCriterionPrimaryStatus)

出力専用。広告グループの条件のメイン ステータス。

共用体フィールド 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 週間あたりの費用がどのように変化するかを予測します。

AdGroupCriterionPrimaryStatus

広告グループの条件のメイン ステータスを表す列挙型です。広告グループの条件が配信されない、または適切に配信されない理由を確認できます。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ELIGIBLE 広告グループの条件は配信可能です。
PAUSED 広告グループの条件は一時停止されています。
REMOVED 広告グループの条件が削除されました。
PENDING 広告グループの条件は保留中です。
NOT_ELIGIBLE この広告グループの条件は配信できません。

AdGroupCriterionPrimaryStatusReason

広告グループの条件のメイン ステータスの理由を表す列挙型です。広告グループの条件が配信されない、または適切に配信されない理由を確認できます。これらの理由は集計され、広告グループの条件の全体的なメイン ステータスが決定されます。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンの不明な値を表します。
CAMPAIGN_PENDING ユーザーが指定した、このキャンペーンの開始時刻が将来の時刻である。AdGroupCriterionPrimaryStatus.PENDING に影響します。
CAMPAIGN_CRITERION_NEGATIVE 広告グループの条件が除外キャンペーンの条件でオーバーライドされています。AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE に影響します。
CAMPAIGN_PAUSED ユーザーが指定したキャンペーンのステータスが一時停止になっています。AdGroupCriterionPrimaryStatus.PAUSED に影響します。
CAMPAIGN_REMOVED ユーザーが指定したキャンペーンのステータスが削除されます。AdGroupCriterionPrimaryStatus.REMOVED に影響します。
CAMPAIGN_ENDED ユーザーが指定したこのキャンペーンの終了時間が過ぎています。AdGroupCriterionPrimaryStatus.ENDED に貢献します。
AD_GROUP_PAUSED ユーザー指定の広告グループのステータスは一時停止されています。AdGroupCriterionPrimaryStatus.PAUSED に影響します。
AD_GROUP_REMOVED ユーザー指定の広告グループのステータスが削除されます。AdGroupCriterionPrimaryStatus.REMOVED に影響します。
AD_GROUP_CRITERION_DISAPPROVED 広告グループの条件が広告の承認システムで不承認となった。AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE に影響します。
AD_GROUP_CRITERION_RARELY_SERVED 広告グループの条件がほとんど配信されていません。AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE に影響します。
AD_GROUP_CRITERION_LOW_QUALITY 広告グループの条件で品質スコアが低い。AdGroupCriterionPrimaryStatus.LIMITED に使用します。
AD_GROUP_CRITERION_UNDER_REVIEW 広告グループの条件は審査中です。AdGroupCriterionPrimaryStatus.PENDING に影響します。
AD_GROUP_CRITERION_PENDING_REVIEW 広告グループの条件は審査待ちです。AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE に影響します。
AD_GROUP_CRITERION_BELOW_FIRST_PAGE_BID 広告グループの条件の入札単価が、最初のページでの配信に必要な値を下回っています。AdGroupCriterionPrimaryStatus.LIMITED に使用します。
AD_GROUP_CRITERION_NEGATIVE 広告グループの条件が除外されています。AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE に影響します。
AD_GROUP_CRITERION_RESTRICTED この広告グループの条件は制限されています。AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE に影響します。
AD_GROUP_CRITERION_PAUSED ユーザー指定の広告グループの条件のステータスは一時停止されています。AdGroupCriterionPrimaryStatus.PAUSED に影響します。
AD_GROUP_CRITERION_PAUSED_DUE_TO_LOW_ACTIVITY 広告の配信アクティビティが少ない状態が長引くため、広告グループの条件が一時停止されました。AdGroupCriterionPrimaryStatus.PAUSED に影響します。
AD_GROUP_CRITERION_REMOVED ユーザー指定の広告グループの条件のステータスが削除されます。AdGroupCriterionPrimaryStatus.REMOVED に影響します。

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 リソース名。