AdGroup

広告グループ。

JSON 表現 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "fixedCpmMicros": string,
  "targetCpvMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}
フィールド
resourceName

string

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

customers/{customerId}/adGroups/{adGroupId}
status

enum (AdGroupStatus)

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

enum (AdGroupType)

変更不可。広告グループのタイプ。
adRotationMode

enum (AdGroupAdRotationMode)

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

object (CustomParameter)

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

boolean

最適化されたターゲティングが有効な場合は「true」になります。最適化されたターゲティングは、オーディエンス拡張に代わるものです。
displayCustomBidDimension

enum (TargetingDimension)

広告主は、絶対入札を配置するターゲティング ディメンションを指定できます。検索を対象とせず、ディスプレイ ネットワークのみを対象とするキャンペーンにのみ適用できます。
targetingSetting

object (TargetingSetting)

ターゲティング関連の機能の設定です。
audienceSetting

object (AudienceSetting)

変更不可。オーディエンス関連の機能の設定です。
effectiveTargetCpaSource

enum (BiddingSource)

出力専用。有効目標 CPA 単価のソース。このフィールドは読み取り専用です。
effectiveTargetRoasSource

enum (BiddingSource)

出力専用。有効目標広告費用対効果のソース。このフィールドは読み取り専用です。
labels[]

string

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

enum (AssetFieldType)

この広告グループから除外するアセット フィールド タイプ。これらのフィールド タイプのアセットリンクは、この広告グループで上位レベルから継承されません。
excludedParentAssetSetTypes[]

enum (AssetSetType)

この広告グループから除外するアセットセットのタイプ。これらのタイプのアセットセットのリンクは、この広告グループに上位レベルから継承されません。ビジネス グループ タイプ（GMB_DYNAMIC_LOCATION_GROUP、CHAIN_DYNAMIC_LOCATION_GROUP、STATIC_LOCATION_GROUP）は、LOCATION_SYNC の子タイプです。そのため、このフィールドに LOCATION_SYNC が設定されている場合、地域グループのすべてのアセットセットをこの広告グループにリンクすることができず、住所表示オプション（LE）とアフィリエイト住所表示オプション（ALE）のすべてがこの広告グループで配信されなくなります。現在サポートされているのは LOCATION_SYNC のみです。
primaryStatus

enum (AdGroupPrimaryStatus)

出力専用。広告グループで広告が配信されない、または適切に配信されない理由を包括的に確認できます。
primaryStatusReasons[]

enum (AdGroupPrimaryStatusReason)

出力専用。広告グループが配信されない、または適切に配信されない理由を確認できます。
id

string (int64 format)

出力専用。広告グループの ID です。
name

string

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

新しい広告グループを作成する場合は、このフィールドは必須です。空にすることはできません。

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

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

string

出力専用。下書きまたはテストの広告グループの場合、このフィールドは、この広告グループが作成された基本の広告グループのリソース名です。下書き広告グループまたはテスト広告グループに基本広告グループがない場合、このフィールドは null です。

基本広告グループの場合、このフィールドは広告グループのリソース名と同じです。

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

string

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

string

変更不可。広告グループが属するキャンペーンです。
cpcBidMicros

string (int64 format)

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

string (int64 format)

出力専用。入札戦略が個別クリック単価、拡張クリック単価、1 ページ目のプロモーション、目標優位表示シェアのいずれかである場合、値は CPC（クリック単価）入札単価と同じになります。それ以外の場合は null になります。
cpmBidMicros

string (int64 format)

最大 CPM（視認範囲のインプレッション単価）。
targetCpaMicros

string (int64 format)

目標コンバージョン単価（CPA）。広告グループのキャンペーンの入札戦略が TargetCpa または MaximizeConversions（targetCpa フィールドが設定された）の場合、このフィールドはキャンペーンの入札戦略で指定された目標コンバージョン単価よりも優先されます。それ以外の場合、この値は無視されます。
cpvBidMicros

string (int64 format)

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

string (int64 format)

広告が 1,000 回表示されるごとに広告主が支払う意思のある金額の平均額（マイクロ秒単位）。
targetRoas

number

目標広告費用対効果のオーバーライド。広告グループのキャンペーンの入札戦略が TargetRoas または MaximizeConversionValue の場合（targetRoas フィールドが設定されている場合）、このフィールドはキャンペーンの入札戦略で指定された目標広告費用対効果をオーバーライドします。それ以外の場合、この値は無視されます。
percentCpcBidMicros

string (int64 format)

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

string (int64 format)

広告の 1,000 インプレッションごとに広告主が支払う固定額（マイクロ秒単位）。
targetCpvMicros

string (int64 format)

広告主が 1 回の広告視聴に対して支払う意思のある平均金額（マイクロ秒単位）。
finalUrlSuffix

string

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

string (int64 format)

出力専用。有効目標 CPA 単価（コンバージョン単価）。このフィールドは読み取り専用です。
effectiveTargetRoas

number

出力専用。有効目標広告費用対効果（広告費用対効果）。このフィールドは読み取り専用です。

AdGroupStatus

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

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

受け取った値は、このバージョンでは不明です。

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

AdGroupAdRotationMode

広告グループで使用できる広告のローテーション モード。

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

受け取った値は、このバージョンでは不明です。

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

AudienceSetting

オーディエンス ターゲティングの設定。

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

boolean

変更不可。true の場合、この広告グループではオーディエンス ターゲティングにオーディエンス リソースが使用されます。false の場合、この広告グループでは代わりにオーディエンス セグメントの条件を使用できます。

AdGroupPrimaryStatus

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

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

AdGroupPrimaryStatusReason

広告グループのステータスに関して考えられる理由です。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
CAMPAIGN_REMOVED ユーザーが指定したキャンペーンのステータスが削除されます。AdGroupPrimaryStatus.NOT_ELIGIBLE に影響します。
CAMPAIGN_PAUSED ユーザーが指定したキャンペーンのステータスが一時停止になっています。AdGroupPrimaryStatus.NOT_ELIGIBLE に影響します。
CAMPAIGN_PENDING ユーザーが指定した、このキャンペーンの開始時刻が将来の時刻である。AdGroupPrimaryStatus.NOT_ELIGIBLE に寄与します。
CAMPAIGN_ENDED ユーザーが指定したこのキャンペーンの終了時間が過ぎています。AdGroupPrimaryStatus.NOT_ELIGIBLE に影響します。
AD_GROUP_PAUSED ユーザー指定の広告グループのステータスは一時停止されています。AdGroupPrimaryStatus.PAUSED に影響します。
AD_GROUP_REMOVED ユーザー指定の広告グループのステータスが削除されます。AdGroupPrimaryStatus.REMOVED に影響します。
AD_GROUP_INCOMPLETE この広告グループの作成はまだ完了していません。AdGroupPrimaryStatus.NOT_ELIGIBLE に影響します。
KEYWORDS_PAUSED この広告グループのユーザー指定のキーワードのステータスはすべて一時停止中です。AdGroupPrimaryStatus.NOT_ELIGIBLE に影響します。
NO_KEYWORDS この広告グループには有効なキーワードがありません。AdGroupPrimaryStatus.NOT_ELIGIBLE に影響します。
AD_GROUP_ADS_PAUSED この広告グループのユーザー指定の広告グループの広告ステータスはすべて一時停止中です。AdGroupPrimaryStatus.NOT_ELIGIBLE に影響します。
NO_AD_GROUP_ADS この広告グループには、対象となる広告グループの広告がありません。AdGroupPrimaryStatus.NOT_ELIGIBLE に影響します。
HAS_ADS_DISAPPROVED 1 つ以上の広告が不承認となった場合のポリシー ステータスの理由。複数の AdGroupPrimaryStatus に貢献します。
HAS_ADS_LIMITED_BY_POLICY 1 つ以上の広告がポリシーによって制限されている場合のポリシー ステータスの理由です。複数の AdGroupPrimaryStatus に貢献します。
MOST_ADS_UNDER_REVIEW ほとんどの広告が審査待ちの場合のポリシー ステータスの理由です。AdGroupPrimaryStatus.PENDING に影響します。
CAMPAIGN_DRAFT この広告グループは下書きキャンペーンに属しています。AdGroupPrimaryStatus.NOT_ELIGIBLE に影響します。
AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY 広告掲載アクティビティが少ない状態が長引くため、広告グループは一時停止されました。AdGroupPrimaryStatus.PAUSED に影響します。