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,
  "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 または Maximize コンバージョン数の最大化（targetCpa フィールドを設定している場合）である場合、このフィールドはキャンペーンの入札戦略で指定された目標コンバージョン単価をオーバーライドします。それ以外の場合、この値は無視されます。
cpvBidMicros

string (int64 format)

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

string (int64 format)

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

number

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

string (int64 format)

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