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)
  ],
  "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 のみです。
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)

目標コンバージョン単価。広告グループのキャンペーンの入札戦略が「TargetCpa」または「コンバージョン数の最大化」で、その 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 広告グループが削除された。

AdGroupType

広告グループの種類を列挙します。

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

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

これはレスポンス専用の値です。
SEARCH_STANDARD 検索キャンペーンのデフォルトの広告グループタイプ。
DISPLAY_STANDARD ディスプレイ キャンペーンのデフォルトの広告グループタイプ。
SHOPPING_PRODUCT_ADS 標準の商品広告を配信するショッピング キャンペーンの広告グループタイプ。
HOTEL_ADS ホテル キャンペーンのデフォルトの広告グループタイプ。
SHOPPING_SMART_ADS スマート ショッピング キャンペーンの広告グループのタイプ。
VIDEO_BUMPER スキップ不可の短いインストリーム動画広告です。
VIDEO_TRUE_VIEW_IN_STREAM TrueView（スキップ可能）インストリーム動画広告。
VIDEO_TRUE_VIEW_IN_DISPLAY TrueView インディスプレイ動画広告
VIDEO_NON_SKIPPABLE_IN_STREAM スキップ不可のインストリーム動画広告。
VIDEO_OUTSTREAM アウトストリーム動画広告
SEARCH_DYNAMIC_ADS 動的検索広告の広告グループのタイプ。
SHOPPING_COMPARISON_LISTING_ADS ショッピング比較キャンペーンの広告グループのタイプ。
PROMOTED_HOTEL_ADS プロモーション対象ホテルの広告グループの広告グループタイプ。
VIDEO_RESPONSIVE 動画レスポンシブ広告グループ
VIDEO_EFFICIENT_REACH 動画による効率的なアプローチの広告グループ。
SMART_CAMPAIGN_ADS スマート アシスト キャンペーンの広告グループタイプ。
TRAVEL_ADS 旅行キャンペーンの広告グループの種類です。

AdGroupAdRotationMode

広告グループの広告のローテーション モードです。

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

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

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

AudienceSetting

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

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

boolean

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