- JSON 表現
- AdGroupCriterionStatus
- QualityInfo
- CriterionSystemServingStatus
- AdGroupCriterionApprovalStatus
- PositionEstimates
- ListingGroupInfo
- ListingGroupType
- ListingDimensionPath
- AppPaymentModelInfo
- AppPaymentModelType
- CustomIntentInfo
広告グループの条件。adGroupCriterion レポートでは、広告グループに明示的に追加された条件のみが返されます。
JSON 表現 |
---|
{ "resourceName": string, "displayName": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
変更不可。広告グループの条件のリソース名。広告グループの条件のリソース名の形式は次のとおりです。
|
displayName |
出力専用。条件の表示名。 このフィールドはミューテーションの場合は無視されます。 |
status |
条件のステータス。 これは、クライアントが設定した広告グループの条件エンティティのステータスです。注: UI レポートには、条件を実行できるかどうかに影響する追加情報が含まれている場合があります。API では「削除済み」である条件でも、管理画面では有効と表示されることがあります。たとえば、除外していない限り、デフォルトですべての年齢層のユーザーにキャンペーンが表示されます。対象の年齢層は広告が表示されるため、UI には「有効」と表示されます。しかし、非除外条件が追加されていないため、AdGroupCriterion.status には「removed」と表示されます。 |
qualityInfo |
出力専用。基準の品質に関する情報。 |
type |
出力専用。条件のタイプ。 |
systemServingStatus |
出力専用。条件の配信ステータス。 |
approvalStatus |
出力専用。条件の承認ステータス。 |
disapprovalReasons[] |
出力専用。条件が不承認になった理由のリストです。 条件を不承認とするさまざまな理由については、https://support.google.com/adspolicy/answer/6008942 をご覧ください。 このフィールドは読み取り専用です。 |
labels[] |
出力専用。この広告グループの条件に適用されているラベルのリソース名。 |
effectiveCpcBidSource |
出力専用。有効なクリック単価のソース。 |
effectiveCpmBidSource |
出力専用。有効インプレッション単価のソース。 |
effectiveCpvBidSource |
出力専用。有効な広告視聴単価の参照元です。 |
effectivePercentCpcBidSource |
出力専用。有効クリック単価の割合の参照元。 |
positionEstimates |
出力専用。さまざまな掲載順位におけるクライテリアの入札単価の見積もりです。 |
finalUrls[] |
広告のすべてのクロスドメイン リダイレクト後の転送先となる可能性のある最終ページ URL のリスト。 |
finalMobileUrls[] |
すべてのクロスドメイン リダイレクトの後に可能性のあるモバイルの最終ページ URL のリスト。 |
urlCustomParameters[] |
|
criterionId |
出力専用。条件の ID。 このフィールドはミューテーションの場合は無視されます。 |
adGroup |
変更不可。条件が属する広告グループです。 |
negative |
変更不可。条件をターゲットに設定するか( このフィールドは変更できません。条件を正から負に変更するには、その条件を削除してから再度追加します。 |
bidModifier |
条件が一致した場合の入札の修飾子。修飾子は 0.1~10.0 の範囲内にする必要があります。対象とする条件タイプのほとんどで、修飾子がサポートされています。 |
cpcBidMicros |
クリック単価(CPC)。 |
cpmBidMicros |
インプレッション単価(CPM)で、 |
cpvBidMicros |
CPV(広告視聴単価)入札。 |
percentCpcBidMicros |
商品やサービスの広告価格に対する割合で表したクリック単価。分数の有効な範囲は [0,1) で、ここに格納される値は 1,000,000 * [小数] です。 |
effectiveCpcBidMicros |
出力専用。有効な CPC(クリック単価)入札。 |
effectiveCpmBidMicros |
出力専用。有効 CPM(視認範囲のインプレッション単価)。 |
effectiveCpvBidMicros |
出力専用。有効な広告視聴単価(CPV)です。 |
effectivePercentCpcBidMicros |
出力専用。有効なクリック単価の割合(%)。 |
finalUrlSuffix |
パラメータを最終ページ URL に追加するための URL テンプレート。 |
trackingUrlTemplate |
トラッキング URL を作成するための URL テンプレート。 |
共用体フィールド 1 つのみ設定する必要があります。 |
|
keyword |
変更不可。キーワード。 |
placement |
変更不可。プレースメント。 |
mobileAppCategory |
変更不可。モバイルアプリのカテゴリです。 |
mobileApplication |
変更不可。モバイルアプリ。 |
listingGroup |
変更不可。リスティング グループ。 |
ageRange |
変更不可。年齢層。 |
gender |
変更不可。性別。 |
incomeRange |
変更不可。収入の範囲。 |
parentalStatus |
変更不可。子供の有無。 |
userList |
変更不可。ユーザーリスト。 |
youtubeVideo |
変更不可。YouTube 動画。 |
youtubeChannel |
変更不可。YouTube チャンネル。 |
topic |
変更不可。トピック。 |
userInterest |
変更不可。ユーザーの興味や関心。 |
webpage |
変更不可。ウェブページ |
appPaymentModel |
変更不可。アプリの支払いモデル。 |
customAffinity |
変更不可。カスタム アフィニティ。 |
customIntent |
変更不可。カスタム インテント。 |
customAudience |
変更不可。カスタム オーディエンス。 |
combinedAudience |
変更不可。統合オーディエンス |
audience |
変更不可。オーディエンス |
location |
変更不可。位置情報] をタップします。 |
language |
変更不可。学びました。 |
AdGroupCriterionStatus
AdGroupCriterion のステータスです。
列挙型 | |
---|---|
UNSPECIFIED |
値が指定されていません。 |
UNKNOWN |
このバージョンでは受信した値が不明です。 これはレスポンス専用の値です。 |
ENABLED |
広告グループの条件が有効になっています。 |
PAUSED |
広告グループの条件は一時停止されています。 |
REMOVED |
広告グループの条件が削除されます。 |
QualityInfo
広告グループの条件の品質情報のコンテナです。
JSON 表現 |
---|
{ "creativeQualityScore": enum ( |
フィールド | |
---|---|
creativeQualityScore |
出力専用。他の広告主様と比較した広告の掲載結果 |
postClickQualityScore |
出力専用。ランディング ページの品質スコア。 |
searchPredictedCtr |
出力専用。他の広告主と比較したクリック率。 |
qualityScore |
出力専用。品質スコア。 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 |
出力専用。検索結果の最初のページに広告を表示するために必要なクリック単価の見積もり。 |
firstPositionCpcMicros |
出力専用。広告が検索結果の最初のページの上部の最初の位置に表示されるために必要なクリック単価の見積もり。 |
topOfPageCpcMicros |
出力専用。検索結果の最初のページの上部に広告を表示するために必要なクリック単価の見積もり額です。 |
estimatedAddClicksAtFirstPositionCpc |
出力専用。キーワードの入札単価を firstPositionCpcMicros の値に変更することで獲得できる 1 週間あたりのクリック数の見積もりです。 |
estimatedAddCostAtFirstPositionCpc |
出力専用。キーワードの入札単価を firstPositionCpcMicros の値に変更した場合に、1 週間あたりの費用がどのように変化するかの見積もりです。 |
ListingGroupInfo
リスティング グループの条件。
JSON 表現 |
---|
{ "type": enum ( |
フィールド | |
---|---|
type |
リスティング グループのタイプ。 |
caseValue |
このリスティング グループが親を絞り込むために使用するディメンション値。ルートグループに対して未定義です。 |
parentAdGroupCriterion |
親のリスティング グループの区分である広告グループの条件のリソース名。ルートグループの場合は null。 |
path |
このリスティング グループを定義する項目のパス。 |
ListingGroupType
リスティング グループのタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
SUBDIVISION |
リスティング ディメンションに沿った商品の区分。これらのノードは、ターゲット リスティング エントリを提供するために使用されるのではなく、ツリーの構造を定義することのみを目的としています。 |
UNIT |
入札単価を定義するリスティング グループのユニット。 |
ListingDimensionPath
リスティング グループを定義する項目のパス。
JSON 表現 |
---|
{
"dimensions": [
{
object ( |
フィールド | |
---|---|
dimensions[] |
リスティング グループの階層内の、ルート(ルート自体を除く)からこのリスティング グループまでのディメンションの完全パス。 |
AppPaymentModelInfo
アプリの支払いモデルの条件。
JSON 表現 |
---|
{
"type": enum ( |
フィールド | |
---|---|
type |
アプリの支払いモデルのタイプ。 |
AppPaymentModelType
利用可能なアプリの支払いモデルを記述する列挙型。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
PAID |
有料アプリを表します。 |
CustomIntentInfo
カスタム インテントの条件。このタイプの条件は、ターゲットに設定することのみ可能です。
JSON 表現 |
---|
{ "customIntent": string } |
フィールド | |
---|---|
customIntent |
CustomInterest のリソース名。 |