Campaign

キャンペーン。

JSON 表現
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "demandGenCampaignSettings": {
    object (DemandGenCampaignSettings)
  },
  "videoCampaignSettings": {
    object (VideoCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "assetAutomationSettings": [
    {
      object (AssetAutomationSetting)
    }
  ],
  "keywordMatchType": enum (CampaignKeywordMatchType),
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "commission": {
    object (Commission)
  },
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "manualCpv": {
    object (ManualCpv)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  },
  "fixedCpm": {
    object (FixedCpm)
  },
  "targetCpv": {
    object (TargetCpv)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
フィールド
resourceName

string

変更不可。キャンペーンのリソース名。キャンペーン リソース名の形式は次のとおりです。

customers/{customerId}/campaigns/{campaignId}

primaryStatus

enum (CampaignPrimaryStatus)

出力専用。キャンペーンのメイン ステータス。

キャンペーンで広告が配信されていない、または適切に配信されていない理由を把握できます。キャンペーンとその関連エンティティに対する変更がこのステータスに反映されるまで、しばらく時間がかかることがあります。

primaryStatusReasons[]

enum (CampaignPrimaryStatusReason)

出力専用。キャンペーンのステータスの主な理由。

キャンペーンで広告が配信されていない、または適切に配信されていない理由を把握できます。これらの理由が集計され、全体的な CampaignPrimaryStatus が決まります。

status

enum (CampaignStatus)

キャンペーンのステータス。

新しいキャンペーンを追加すると、ステータスはデフォルトで [有効] になります。

servingStatus

enum (CampaignServingStatus)

出力専用。キャンペーンの広告配信ステータス。

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

出力専用。キャンペーンの入札戦略のシステム ステータス。

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

キャンペーンの広告配信の最適化ステータス。

advertisingChannelType

enum (AdvertisingChannelType)

変更不可。キャンペーン内の広告のメインの配信ターゲット。ターゲティング オプションは networkSettings で絞り込むことができます。

新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。

キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。

advertisingChannelSubType

enum (AdvertisingChannelSubType)

変更不可。advertisingChannelType の絞り込み(省略可)。親チャネルタイプの有効なサブタイプを指定してください。

キャンペーンの作成時にのみ設定できます。キャンペーンを作成した後は変更できません。

urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplatefinalUrlsmobile_final_urls でカスタム パラメータ タグを置き換えるために使用されるマッピングのリスト。

localServicesCampaignSettings

object (LocalServicesCampaignSettings)

ローカル サービス キャンペーン関連の設定。

travelCampaignSettings

object (TravelCampaignSettings)

旅行キャンペーンの設定。

demandGenCampaignSettings

object (DemandGenCampaignSettings)

デマンド ジェネレーション キャンペーンの設定。

videoCampaignSettings

object (VideoCampaignSettings)

動画キャンペーンの設定。

realTimeBiddingSetting

object (RealTimeBiddingSetting)

リアルタイム入札の設定。この機能は、Ad Exchange ネットワークをターゲットとするキャンペーンでのみご利用いただけます。

networkSettings

object (NetworkSettings)

キャンペーンのネットワーク設定。

hotelSetting

object (HotelSettingInfo)

変更不可。キャンペーンのホテル設定。

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

動的検索広告(DSA)を管理するための設定。

shoppingSetting

object (ShoppingSetting)

ショッピング キャンペーンを管理するための設定。

targetingSetting

object (TargetingSetting)

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

geoTargetTypeSetting

object (GeoTargetTypeSetting)

広告の地理ターゲティングの設定。

localCampaignSetting

object (LocalCampaignSetting)

ローカル キャンペーンの設定。

appCampaignSetting

object (AppCampaignSetting)

アプリ キャンペーンに関連する設定。

labels[]

string

出力専用。このキャンペーンに適用されたラベルのリソース名。

experimentType

enum (CampaignExperimentType)

出力専用。キャンペーンの種類(通常、下書き、テスト)。

biddingStrategyType

enum (BiddingStrategyType)

出力専用。入札戦略のタイプ。

入札戦略を作成するには、標準入札戦略を作成する入札スキームを設定するか、ポートフォリオ入札戦略を作成する biddingStrategy フィールドを設定します。

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

accessibleBiddingStrategy

string

出力専用。AccessibleBiddingStrategy のリソース名。これは、接続されたポートフォリオ入札戦略の制限なしの属性の読み取り専用ビューで、「biddingStrategy」で識別されます。キャンペーンでポートフォリオ戦略を使用していない場合、空白です。制限なしの戦略属性は、戦略を共有しているすべてのお客様が使用でき、AccessibleBiddingStrategy リソースから読み取られます。一方、制限付き属性は、戦略のオーナー カスタマーとそのマネージャーのみが使用できます。制限付きの属性は、BiddingStrategy リソースからのみ読み取ることができます。

frequencyCaps[]

object (FrequencyCapEntry)

各ユーザーにこのキャンペーンの広告を表示する回数を制限するリスト。

videoBrandSafetySuitability

enum (BrandSafetySuitability)

個々のキャンペーン単位でのブランド保護設定。広告枠のタイプを選択して、ブランドに適したコンテンツに広告を表示できます。https://support.google.com/google-ads/answer/7515513 をご覧ください。

vanityPharma

object (VanityPharma)

ブランドの表記がない医薬品広告の表示方法について説明します。

selectiveOptimization

object (SelectiveOptimization)

このキャンペーンの選択的な最適化設定。このキャンペーンで最適化するコンバージョン アクションのセットが含まれます。この機能は、AdvertisingChannelType として MULTI_CHANNEL、AdvertisingChannelSubType として APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用するアプリ キャンペーンにのみ適用されます。

optimizationGoalSetting

object (OptimizationGoalSetting)

このキャンペーンの最適化の目標設定。これには、一連の最適化の目標タイプが含まれます。

trackingSetting

object (TrackingSetting)

出力専用。トラッキング情報のキャンペーン単位の設定。

paymentMode

enum (PaymentMode)

キャンペーンのお支払いモード。

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 のみです。

performanceMaxUpgrade

object (PerformanceMaxUpgrade)

出力専用。P-MAX にアップグレードされるキャンペーンに関する情報。

assetAutomationSettings[]

object (AssetAutomationSetting)

各 AssetAutomationType のオプトイン/オプトアウト ステータスを含みます。デフォルトのオプトイン/オプトアウトの動作については、各アセット自動化タイプの列挙型のドキュメントをご覧ください。

keywordMatchType

enum (CampaignKeywordMatchType)

キャンペーンのキーワードのマッチタイプ。キャンペーン内のすべてのキーワードに部分一致を設定するには、[BROAD] に設定します。

id

string (int64 format)

出力専用。キャンペーンの ID です。

name

string

キャンペーンの名前です。

新しいキャンペーンを作成する場合、このフィールドは必須です。空にすることはできません。

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

trackingUrlTemplate

string

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

audienceSetting

object (AudienceSetting)

変更不可。視聴者関連機能の設定。

baseCampaign

string

出力専用。下書きまたはテスト キャンペーンの基本のキャンペーンのリソース名。基本のキャンペーンの場合、これは resourceName と同じです。

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

campaignBudget

string

キャンペーンのキャンペーン予算のリソース名。

startDate

string

お客様のタイムゾーンでキャンペーンが配信を開始した日付(YYYY-MM-DD 形式)。

campaignGroup

string

このキャンペーンが属するキャンペーン グループのリソース名。

endDate

string

ユーザーのタイムゾーンで配信されるキャンペーンの最終日(YYYY-MM-DD 形式)。作成時にはデフォルトで 2037-12-30 に設定され、キャンペーンは無期限に実行されます。既存のキャンペーンを無期限で行うように設定するには、このフィールドを 2037-12-30 に設定します。

finalUrlSuffix

string

パラレル トラッキングで配信されるランディング ページにクエリ パラメータを追加するために使用される接尾辞。

optimizationScore

number

出力専用。キャンペーンの最適化スコア。

最適化スコアとは、キャンペーンの設定がどの程度最適化されているかを示す推定値です。0%(0.0)~ 100%(1.0)の範囲で示され、100% はキャンペーンが最大限のパフォーマンスを発揮できていることを意味します。スコアリングされていないキャンペーンの場合、このフィールドは null です。

詳しくは、https://support.google.com/google-ads/answer/9061546 の「最適化スコアについて」をご覧ください。

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

urlExpansionOptOut

boolean

よりターゲティングされた URL への URL 拡張をオプトアウトすることを表します。オプトアウトした場合(true)、アセット グループ内の最終ページ URL または広告主様の Google Merchant Center またはビジネスデータ フィードで指定された URL のみがターゲティングされます。オプトインした場合(false)、ドメイン全体がターゲットになります。このフィールドは P-MAX キャンペーンでのみ設定できます。デフォルト値は false です。

hotelPropertyAssetSet

string

変更不可。旅行関連の目標達成のための P-MAX キャンペーンのホテル物件セットのリソース名。

listingType

enum (ListingType)

変更不可。このキャンペーンで配信された広告のリスティング タイプ。このフィールドは、P-MAX キャンペーンでの使用が制限されています。

共用体フィールド campaign_bidding_strategy。キャンペーンの入札戦略。

ポートフォリオ(BiddingStrategy サービスで作成)または標準(キャンペーンに埋め込まれている)のいずれかである必要があります。campaign_bidding_strategy は次のいずれかになります。

biddingStrategy

string

キャンペーンで使用されるポートフォリオ入札戦略のリソース名。

commission

object (Commission)

コミッションは、広告主様がコンバージョン値の特定の割合を支払う自動入札戦略です。

manualCpa

object (ManualCpa)

標準の「目標コンバージョン単価」個別入札戦略。広告主が指定したアクションごとに入札単価を設定できる個別単価設定の入札戦略。ローカル サービス キャンペーンでのみサポートされます。

manualCpc

object (ManualCpc)

標準の個別クリック単価入札戦略。ユーザーがクリック単価で支払う、クリック単価の個別設定。

manualCpm

object (ManualCpm)

標準の個別インプレッション単価入札戦略。インプレッション単価の個別設定。ユーザーは 1,000 インプレッションごとに支払います。

manualCpv

object (ManualCpv)

動画視聴ごとに設定可能な金額を支払う入札戦略。

maximizeConversions

object (MaximizeConversions)

予算を消化しつつコンバージョン数を自動的に最大化する、標準の「コンバージョン数の最大化」入札戦略。

maximizeConversionValue

object (MaximizeConversionValue)

標準のコンバージョン値の最大化入札戦略では、予算を消化しつつ収益を最大化できるように入札単価が自動的に設定されます。

targetCpa

object (TargetCpa)

指定した目標コンバージョン単価でコンバージョンを最大限に獲得できるように入札単価が自動的に設定される標準の目標コンバージョン単価入札戦略です。

targetImpressionShare

object (TargetImpressionShare)

目標インプレッション シェア入札戦略。選択したインプレッション率を達成するように入札単価を設定する自動入札戦略。

targetRoas

object (TargetRoas)

特定の目標広告費用対効果(ROAS)の平均値を達成しながら、収益を自動的に最大化する標準の目標広告費用対効果入札戦略。

targetSpend

object (TargetSpend)

標準の目標予算入札戦略。予算内でクリック数を最大化できるように入札単価が自動的に調整されます。

percentCpc

object (PercentCpc)

商品やサービスの広告掲載価格の一部を入札単価とする、標準の割合クリック単価入札戦略。

targetCpm

object (TargetCpm)

1,000 インプレッションあたりの費用を自動的に最適化する入札戦略。

fixedCpm

object (FixedCpm)

固定インプレッション単価の個別入札戦略。

targetCpv

object (TargetCpv)

指定した目標コンバージョン単価に基づいてパフォーマンスを最適化するように入札単価が設定される自動入札戦略です。

CampaignPrimaryStatus

キャンペーンのプライマリ ステータスとして想定されるステータスを記述する列挙型。キャンペーンで広告が配信されていない、または適切に配信されていない理由を把握できます。キャンペーンとその関連エンティティに対する変更がこのステータスに反映されるまで、しばらく時間がかかることがあります。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
ELIGIBLE キャンペーンは配信可能です。
PAUSED ユーザーがキャンペーンのステータスを一時停止に設定しています。
REMOVED ユーザーが指定したキャンペーンのステータスが削除されます。
ENDED ユーザーが設定したキャンペーンの終了時間を過ぎています。
PENDING キャンペーンは今後配信される可能性があります。
MISCONFIGURED キャンペーンまたは関連するエンティティに、ユーザーの設定が不適切な項目があります。
LIMITED キャンペーンまたは関連するエンティティに、ユーザーの設定によって制限されている項目があります。
LEARNING キャンペーンまたは関連するエンティティにユーザーが変更を加えたため、自動入札システムで調整中です。
NOT_ELIGIBLE キャンペーンは配信対象外です。

CampaignPrimaryStatusReason

キャンペーンのプライマリ ステータスの理由として考えられる値を列挙した型。キャンペーンで広告が配信されていない、または最適に配信されていない理由に関する分析情報を提供します。これらの理由が集計され、キャンペーンの全体的なプライマリ ステータスが決まります。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
CAMPAIGN_REMOVED ユーザーが指定したキャンペーンのステータスが削除されます。
CAMPAIGN_PAUSED ユーザーがキャンペーンのステータスを一時停止に設定しています。
CAMPAIGN_PENDING ユーザーが設定したキャンペーンの開始時間が将来の日付になっています。
CAMPAIGN_ENDED ユーザーが設定したキャンペーンの終了時間を過ぎています。
CAMPAIGN_DRAFT キャンペーンが下書きである。
BIDDING_STRATEGY_MISCONFIGURED 入札戦略に、ユーザーが指定した不適切な設定があります。
BIDDING_STRATEGY_LIMITED 入札戦略が、データ不足などのユーザー指定の設定によって制限されている。
BIDDING_STRATEGY_LEARNING 自動入札システムは、入札戦略にユーザーが指定した変更に合わせて調整しています。
BIDDING_STRATEGY_CONSTRAINED キャンペーンの目標コンバージョン単価または広告費用対効果を調整することで、コンバージョン値を高めることができます。
BUDGET_CONSTRAINED 予算によってキャンペーンの広告配信が制限されています。
BUDGET_MISCONFIGURED 予算に、ユーザーが指定した不適切な設定があります。
SEARCH_VOLUME_LIMITED キャンペーンで、関連するすべての検索語句がターゲットに設定されていません。
AD_GROUPS_PAUSED ユーザーが指定した広告グループのステータスはすべて一時停止中です。
NO_AD_GROUPS このキャンペーンには、対象となる広告グループがありません。
KEYWORDS_PAUSED ユーザーが指定したキーワードのステータスがすべて一時停止されています。
NO_KEYWORDS このキャンペーンには対象となるキーワードがありません。
AD_GROUP_ADS_PAUSED ユーザーが指定した広告グループの広告ステータスはすべて一時停止中です。
NO_AD_GROUP_ADS このキャンペーンには、対象となる広告グループの広告がありません。
HAS_ADS_LIMITED_BY_POLICY このキャンペーンの少なくとも 1 つの広告がポリシーの制限を受けています。
HAS_ADS_DISAPPROVED このキャンペーンの広告が 1 つ以上不承認になっています。
MOST_ADS_UNDER_REVIEW このキャンペーンのほとんどの広告が審査中です。
MISSING_LEAD_FORM_EXTENSION キャンペーンにはリードフォームの目標が設定されていますが、リードフォーム表示オプションがありません。
MISSING_CALL_EXTENSION キャンペーンには通話の目標が設定されていますが、電話番号表示オプションがありません。
LEAD_FORM_EXTENSION_UNDER_REVIEW リードフォーム表示オプションは審査中です。
LEAD_FORM_EXTENSION_DISAPPROVED リードフォーム表示オプションが不承認です。
CALL_EXTENSION_UNDER_REVIEW 電話番号表示オプションは審査中です。
CALL_EXTENSION_DISAPPROVED 電話番号表示オプションが不承認です。
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA このキャンペーンには、対象となるモバイルアプリの広告グループの条件がありません。
CAMPAIGN_GROUP_PAUSED ユーザーがキャンペーン グループのステータスを一時停止に設定しています。
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED 親キャンペーン グループに関連付けられているすべてのグループ予算のユーザー指定時間が経過している。
APP_NOT_RELEASED この ACi キャンペーンに関連付けられているアプリが、キャンペーンの対象国でリリースされていません。
APP_PARTIALLY_RELEASED この ACi キャンペーンに関連付けられているアプリは、キャンペーンの対象国で一部リリースされています。
HAS_ASSET_GROUPS_DISAPPROVED このキャンペーンの 1 つ以上のアセット グループが不承認になっています。
HAS_ASSET_GROUPS_LIMITED_BY_POLICY このキャンペーンの 1 つ以上のアセット グループはポリシーの制約を受けています。
MOST_ASSET_GROUPS_UNDER_REVIEW このキャンペーンのほとんどのアセット グループは審査中です。
NO_ASSET_GROUPS このキャンペーンには、対象となるアセット グループがありません。
ASSET_GROUPS_PAUSED このキャンペーンのすべてのアセット グループが一時停止されています。

CampaignStatus

キャンペーンのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
ENABLED キャンペーンは有効で、広告を表示できます。
PAUSED キャンペーンがユーザーによって一時停止されている。
REMOVED キャンペーンは削除されました。

CampaignServingStatus

キャンペーンの配信ステータス。

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

このバージョンでは、受信した値は不明です。

これはレスポンス専用の値です。

SERVING サービング。
NONE なし。
ENDED 終了。
PENDING Pending.
SUSPENDED 停止中。

BiddingStrategySystemStatus

BiddingStrategy のシステム ステータス。

列挙型
UNSPECIFIED 予期しないエラーが発生したことを示します(入札戦略の種類が見つからない場合や、ステータス情報が見つからない場合など)。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
ENABLED この入札戦略は有効になっており、特に問題も見つかっていません。
LEARNING_NEW 入札戦略が最近作成されたか、最近再度有効になったため、入札戦略は学習中です。
LEARNING_SETTING_CHANGE 最近設定が変更されたため、入札戦略は学習中です。
LEARNING_BUDGET_CHANGE 最近予算が変更されたため、入札戦略は学習中です。
LEARNING_COMPOSITION_CHANGE 入札戦略が設定されたキャンペーン、広告グループ、キーワードの数に最近変更が加えられたため、入札戦略は学習中です。
LEARNING_CONVERSION_TYPE_CHANGE 入札戦略は、コンバージョン レポートと、入札戦略に関連するコンバージョン タイプについてお客様が最近行った変更に基づいて決定されます。
LEARNING_CONVERSION_SETTING_CHANGE 入札戦略はコンバージョン レポートに依存しており、お客様が最近コンバージョン設定を変更した。
LIMITED_BY_CPC_BID_CEILING 入札戦略が入札単価の上限により制限されている。
LIMITED_BY_CPC_BID_FLOOR 入札戦略が入札単価の下限により制限されている。
LIMITED_BY_DATA 過去数週間のコンバージョン トラフィックが十分でないため、入札戦略が制限されています。
LIMITED_BY_BUDGET この入札戦略のキーワードの多くは、予算の制約を受けています。
LIMITED_BY_LOW_PRIORITY_SPEND 入札戦略の優先度が下げられているため、目標予算に達することができません。
LIMITED_BY_LOW_QUALITY この入札戦略のキーワードの多くは品質スコアが低くなっています。
LIMITED_BY_INVENTORY ターゲティングが狭いため、入札戦略で予算をすべて使用できません。
MISCONFIGURED_ZERO_ELIGIBILITY スマート ショッピング キャンペーンのコンバージョン トラッキング(ping なし)またはリマーケティング リストがない。
MISCONFIGURED_CONVERSION_TYPES 入札戦略がコンバージョン レポートに依存しており、この戦略でレポートされるコンバージョン タイプがお客様のアカウントに設定されていない。
MISCONFIGURED_CONVERSION_SETTINGS 入札戦略がコンバージョン レポートに依存しており、お客様のコンバージョン設定が正しく構成されていない。
MISCONFIGURED_SHARED_BUDGET 入札戦略に含まれていないキャンペーンが、入札戦略に含まれているキャンペーンと予算を共有しています。
MISCONFIGURED_STRATEGY_TYPE キャンペーンの戦略タイプが無効で、配信されていません。
PAUSED 入札戦略が無効です。入札戦略に適用されている有効なキャンペーン、広告グループ、キーワードがない。または、入札戦略に接続されている有効な予算がない。
UNAVAILABLE 現在、この入札戦略ではステータス レポートはサポートされていません。
MULTIPLE_LEARNING 問題の期間中、この入札戦略のシステム ステータスが LEARNING_* に複数回変化しました。
MULTIPLE_LIMITED 問題の期間中、この入札戦略のシステム ステータスは LIMITED_* が複数回ありました。
MULTIPLE_MISCONFIGURED 問題の期間中、この入札戦略のシステム ステータスが MISCONFIGURED_* に複数回なりました。
MULTIPLE 問題の期間中、この入札戦略のシステム ステータスは複数回変わりました。

AdServingOptimizationStatus

配信ステータスの可能性を記述する列挙型。

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

このバージョンでは、受信した値は不明です。

これはレスポンス専用の値です。

OPTIMIZE 広告配信は、キャンペーンのクリック率に基づいて最適化されます。
CONVERSION_OPTIMIZE 広告配信は、キャンペーンのクリック率 × コンバージョンに基づいて最適化されます。キャンペーンにコンバージョン オプティマイザーの入札戦略が適用されていない場合、デフォルトで [最適化済み] になります。
ROTATE 90 日間均等に広告がローテーションされ、その後クリック重視で最適化されます。
ROTATE_INDEFINITELY 掲載結果の低い広告を掲載結果の高い広告と均等に表示し、最適化は行いません。
UNAVAILABLE 広告配信の最適化のステータスは利用できません。

LocalServicesCampaignSettings

LocalServicesCampaign サブリソースの設定。

JSON 表現
{
  "categoryBids": [
    {
      object (CategoryBid)
    }
  ]
}
フィールド
categoryBids[]

object (CategoryBid)

「MANUAL_CPA」入札戦略に関連付けられているカテゴリ単位の入札単価。

CategoryBid

LocalServicesReportingCampaignSettings の [カテゴリ入札単価]。

JSON 表現
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
フィールド
categoryId

string

入札単価が関連付けられるカテゴリ。たとえば、xcat:service_area_business_plumber などです。

manualCpaBidMicros

string (int64 format)

カテゴリに対する個別コンバージョン単価。入札単価は、そのカテゴリに関連付けられている予約価格より高くする必要があります。値はマイクロ単位で、広告主の通貨で表されます。

TravelCampaignSettings

旅行キャンペーンの設定。

JSON 表現
{
  "travelAccountId": string
}
フィールド
travelAccountId

string (int64 format)

変更不可。旅行キャンペーンに関連付けられている旅行アカウント ID。

DemandGenCampaignSettings

デマンド ジェネレーション キャンペーンの設定。

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

boolean

変更不可。このキャンペーンでアップグレードされたターゲティング オプションを使用するかどうかを指定します。このフィールドを true に設定すると、標準のキャンペーン単位のターゲティングではなく、広告グループ単位で地域とターゲット言語のターゲティングを使用できます。このフィールドのデフォルトは false で、キャンペーンの作成時にのみ設定できます。

VideoCampaignSettings

動画キャンペーンの設定。

JSON 表現
{
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
フィールド
videoAdInventoryControl

object (VideoAdInventoryControl)

リーチ キャンペーンのレスポンシブ広告コンテナの広告在庫管理

VideoAdInventoryControl

レスポンシブ広告コンテナを使用するキャンペーンでは、広告を表示できる広告枠は広告枠コントロールによって決まります。これは、入札戦略が TARGET_CPM または FIXED_CPM のキャンペーンにのみ適用されます。

JSON 表現
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
フィールド
allowInStream

boolean

インストリーム動画広告に VideoResponsiveAds を使用できるかどうかを判断します。

allowInFeed

boolean

インフィード動画広告に VideoResponsiveAds を使用できるかどうかを判断します。

allowShorts

boolean

VideoResponsiveAds をショート動画フォーマットとして使用できるかどうかを判断します。

RealTimeBiddingSetting

リアルタイム入札の設定。この機能は、Ad Exchange ネットワークをターゲットとするキャンペーンでのみご利用いただけます。

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

boolean

キャンペーンでリアルタイム入札が有効になっているかどうか。

NetworkSettings

キャンペーンのネットワーク設定。

JSON 表現
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean,
  "targetYoutube": boolean,
  "targetGoogleTvNetwork": boolean
}
フィールド
targetSearchNetwork

boolean

Google 検索ネットワークのパートナー サイトに広告を配信するかどうか(targetGoogleSearchtrue にする必要があります)。

targetContentNetwork

boolean

Google ディスプレイ ネットワークの指定したプレースメントに広告を配信するかどうか。プレースメントは、プレースメント条件で指定します。

targetPartnerSearchNetwork

boolean

Google パートナー ネットワークで広告を配信するかどうか。この機能は、一部の Google パートナー アカウントでのみご利用いただけます。

targetYoutube

boolean

YouTube に広告を配信するかどうか。

targetGoogleTvNetwork

boolean

Google TV ネットワークに広告を配信するかどうか。

HotelSettingInfo

ホテル広告のキャンペーン単位の設定。

JSON 表現
{
  "hotelCenterId": string
}
フィールド
hotelCenterId

string (int64 format)

変更不可。リンクされている Hotel Center アカウント。

DynamicSearchAdsSetting

動的検索広告(DSA)を管理するための設定。

JSON 表現
{
  "domainName": string,
  "languageCode": string,
  "feeds": [
    string
  ],
  "useSuppliedUrlsOnly": boolean
}
フィールド
domainName

string

必須。この設定が表すインターネット ドメイン名(例: google.com、www.google.com)。

languageCode

string

必須。ドメインの言語を指定する言語コード(例: 「en」)。

feeds[]

string

キャンペーンに関連付けられているページフィード アセットのリソース名のリスト。

useSuppliedUrlsOnly

boolean

キャンペーンで広告主様指定の URL のみを使用するかどうか。

ShoppingSetting

ショッピング キャンペーンの設定。キャンペーンで宣伝できる商品の範囲と、このキャンペーンと他のショッピング キャンペーンとの連携方法を定義します。

JSON 表現
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "advertisingPartnerIds": [
    string
  ],
  "merchantId": string,
  "campaignPriority": integer,
  "enableLocal": boolean,
  "disableProductFeed": boolean
}
フィールド
feedLabel

string

キャンペーンに含める商品のフィードラベル。feedLabel または sales_country のいずれか 1 つのみ設定できます。sales_country の代わりに使用する場合、feedLabel フィールドには同じ形式の国コード(例: 'XX')を使用できます。それ以外の場合は、Google Merchant Center でフィードラベルに使用されている任意の文字列にすることができます。

useVehicleInventory

boolean

変更不可。車両リスティングの広告枠をターゲットに設定するかどうか。このフィールドはスマート ショッピング キャンペーンでのみサポートされています。P-MAX キャンペーンで車両リスティング広告枠を設定する場合は、代わりに listingType を使用してください。

advertisingPartnerIds[]

string (int64 format)

変更不可。キャンペーン内で連携する広告パートナーの広告アカウント ID。

merchantId

string (int64 format)

Merchant Center アカウントの ID。このフィールドは、作成オペレーションで必須です。このフィールドはショッピング キャンペーンでは変更できません。

campaignPriority

integer

キャンペーンの優先度。優先度の数値が高いキャンペーンは、優先度の低いキャンペーンよりも優先されます。このフィールドはショッピング キャンペーンで必須です。値は 0 ~ 2 の範囲で指定します。スマート ショッピング キャンペーンでは省略可能ですが、設定する場合は 3 に設定する必要があります。

enableLocal

boolean

ローカル商品を含めるかどうか。

disableProductFeed

boolean

オプションの商品フィードを無効にします。現在、このフィールドはデマンド ジェネレーション キャンペーンでのみサポートされています。この機能について詳しくは、https://support.google.com/google-ads/answer/13721750 をご覧ください。

AudienceSetting

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

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

boolean

変更不可。true の場合、このキャンペーンではオーディエンス ターゲティングにオーディエンス リソースが使用されます。false の場合、このキャンペーンではオーディエンス セグメントの条件が代わりに使用されることがあります。

GeoTargetTypeSetting

広告の地理ターゲティングに関連する設定のコレクションを表します。

JSON 表現
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
フィールド
positiveGeoTargetType

enum (PositiveGeoTargetType)

この特定のキャンペーンでポジティブな地域ターゲティングに使用される設定。

negativeGeoTargetType

enum (NegativeGeoTargetType)

この特定のキャンペーンで除外地域ターゲティングに使用されている設定。

PositiveGeoTargetType

使用可能なポジティブな地域ターゲット タイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
PRESENCE_OR_INTEREST ユーザーが広告主のターゲット地域にいる場合、またはターゲット地域に関心を示している場合に、広告がトリガーされることを指定します。
SEARCH_INTEREST ユーザーが広告主がターゲットとする地域を検索した場合に広告がトリガーされることを指定します。使用できるのは、検索キャンペーンと通常のショッピング キャンペーンのみです。
PRESENCE 広告は、ユーザーが広告主様のターゲット地域にいる場合、または定期的にターゲット地域にいる場合にトリガーされます。

NegativeGeoTargetType

使用できる除外地域ターゲット タイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN このバージョンでは値は不明です。
PRESENCE_OR_INTEREST 広告主様の除外地域にいるユーザーや、除外地域に関心を示しているユーザーに広告が表示されないように指定します。
PRESENCE 広告主様の除外地域にユーザーがいる場合、そのユーザーには広告が表示されないように指定します。

LocalCampaignSetting

ローカル キャンペーンのキャンペーン設定。

JSON 表現
{
  "locationSourceType": enum (LocationSourceType)
}
フィールド
locationSourceType

enum (LocationSourceType)

このローカル キャンペーンの場所情報タイプ。

LocationSourceType

場所情報の種類。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
GOOGLE_MY_BUSINESS お客様がリンクしたビジネス プロフィールに関連付けられている店舗拠点。
AFFILIATE アフィリエイト(チェーン)の店舗所在地。たとえば、Best Buy の店舗の場所などです。

AppCampaignSetting

アプリ キャンペーンのキャンペーン単位の設定。

JSON 表現
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
フィールド
biddingStrategyGoalType

enum (AppCampaignBiddingStrategyGoalType)

このアプリ キャンペーンの入札戦略で最適化すべき目標を表します。

appStore

enum (AppCampaignAppStore)

変更不可。この特定のアプリを配信しているアプリストア。

appId

string

変更不可。モバイル アプリケーションを一意に識別する文字列。

AppCampaignBiddingStrategyGoalType

アプリ キャンペーンの入札戦略の目標タイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST アプリのインストール数を最大化することを目標にします。cpa 入札単価は目標インストール単価です。
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST アプリ インストールから選択したアプリ内コンバージョンの長期的な数を最大化することを目標とします。cpa 入札単価は目標インストール単価です。
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST アプリ インストールから選択したアプリ内コンバージョンの長期的な数を最大化することを目標とします。cpa 入札単価は、アプリ内コンバージョンの目標コンバージョン単価です。なお、長期的なコンバージョンはまだ発生していないため、最初のうちは実際の CPA が目標 CPA よりも高く見えることがあります。
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND 目標広告費用対効果を達成または上回りつつ、インストールや選択したアプリ内コンバージョンなど、すべてのコンバージョン値を最大化することを目標とします。
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME アプリの事前登録を最大化することを目標にします。
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST 目標インストール単価を設定せずに、アプリのインストール数を最大化することを目的としています。

AppCampaignAppStore

アプリ キャンペーンのアプリストアを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
APPLE_APP_STORE Apple App Store
GOOGLE_APP_STORE Google Play。

CampaignExperimentType

このキャンペーンが通常のキャンペーン、下書きキャンペーン、テスト キャンペーンのいずれであるかを示します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
BASE これは標準キャンペーンです。
DRAFT これはキャンペーンの下書き版です。基本のキャンペーンから一部変更されていますが、指標の配信や蓄積は行われません。
EXPERIMENT これはキャンペーンの試験運用版です。基本のキャンペーンから変更が加えられていて、トラフィックの一部が基本のキャンペーンからこのテスト キャンペーンに誘導されています。

FrequencyCapEntry

特定の期間中にユーザーに表示できる広告(または広告セット)の最大回数を指定するルール。

JSON 表現
{
  "key": {
    object (FrequencyCapKey)
  },
  "cap": integer
}
フィールド
key

object (FrequencyCapKey)

特定のフリークエンシー キャップのキー。同じキーを持つフリークエンシー キャップは 1 つだけにする必要があります。

cap

integer

この上限によって、期間中に許可されるイベントの最大数。

FrequencyCapKey

フリークエンシー キャップのキーとして使用されるフィールドのグループ。同じキーを持つフリークエンシー キャップは 1 つだけにする必要があります。

JSON 表現
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
フィールド
level

enum (FrequencyCapLevel)

上限を適用するレベル(広告グループの広告、広告グループなど)。この上限は、このレベルのすべてのエンティティに適用されます。

eventType

enum (FrequencyCapEventType)

上限が適用されるイベントのタイプ(インプレッションなど)。

timeUnit

enum (FrequencyCapTimeUnit)

フリークエンシー キャップが定義される時間単位(日、週など)。

timeLength

integer

キャップの有効期間の単位時間数。

FrequencyCapLevel

上限を適用するレベル(広告グループ、広告など)。上限は、このレベルのすべてのリソースに適用されます。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
AD_GROUP_AD 上限は広告グループの広告単位で適用されます。
AD_GROUP 上限は広告グループ単位で適用されます。
CAMPAIGN 上限はキャンペーン単位で適用されます。

FrequencyCapEventType

上限が適用されるイベントのタイプ(インプレッションなど)。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
IMPRESSION 上限は広告インプレッションに適用されます。
VIDEO_VIEW 上限は動画広告の視聴回数に適用されます。

VanityPharma

ブランドの表記がない医薬品広告の表示方法について説明します。

JSON 表現
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
フィールド
vanityPharmaDisplayUrlMode

enum (VanityPharmaDisplayUrlMode)

バニティ ファーマ URL の表示モード。

vanityPharmaText

enum (VanityPharmaText)

バニティ ファーマ URL の表示モードとしてウェブサイトの説明が選択されている場合に、テキスト広告の表示 URL に表示されるテキスト。

VanityPharmaDisplayUrlMode

バニティ ファーマ URL の表示モードを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
MANUFACTURER_WEBSITE_URL バニティ ファーマの URL をメーカーのウェブサイトの URL に置き換えます。
WEBSITE_DESCRIPTION バニティ ファーマの URL は、ウェブサイトの説明に置き換えてください。

VanityPharmaText

使用可能なテキストを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
PRESCRIPTION_TREATMENT_WEBSITE_EN 医師の指導が必要な治療に関するウェブサイト(ウェブサイトのコンテンツは英語)。
PRESCRIPTION_TREATMENT_WEBSITE_ES 医師の指導が必要な治療に関するウェブサイト(スペイン語)(Sitio de tratamientos con receta)。
PRESCRIPTION_DEVICE_WEBSITE_EN 医師の指導が必要な医療機器に関するウェブサイト(ウェブサイトのコンテンツは英語)。
PRESCRIPTION_DEVICE_WEBSITE_ES 医師の指導が必要な医療機器に関するウェブサイト(スペイン語(Sitio de dispositivos con receta))
MEDICAL_DEVICE_WEBSITE_EN 医療機器に関するウェブサイト(ウェブサイトのコンテンツは英語)。
MEDICAL_DEVICE_WEBSITE_ES ウェブサイトのコンテンツがスペイン語(Sitio de dispositivos médicos)の医療機器に関するウェブサイト。
PREVENTATIVE_TREATMENT_WEBSITE_EN 予防的治療に関するウェブサイト(ウェブサイトのコンテンツは英語)。
PREVENTATIVE_TREATMENT_WEBSITE_ES 予防的治療に関するウェブサイト(スペイン語のウェブサイト コンテンツ(Sitio de tratamientos preventivos))。
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN 医師の指導が必要な避妊法に関するウェブサイト(ウェブサイトのコンテンツは英語)。
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES 医師の指導が必要な避妊法に関するウェブサイト(スペイン語のウェブサイト コンテンツ(Sitio de anticonceptivos con receta))。
PRESCRIPTION_VACCINE_WEBSITE_EN 医師の処方が必要なワクチンに関するウェブサイト(英語)。
PRESCRIPTION_VACCINE_WEBSITE_ES 医師の処方が必要なワクチンに関するウェブサイト(スペイン語のウェブサイト コンテンツ)(Sitio de vacunas con receta)。

SelectiveOptimization

このキャンペーンの選択的な最適化設定。このキャンペーンで最適化するコンバージョン アクションのセットが含まれます。この機能は、AdvertisingChannelType として MULTI_CHANNEL、AdvertisingChannelSubType として APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT を使用するアプリ キャンペーンにのみ適用されます。

JSON 表現
{
  "conversionActions": [
    string
  ]
}
フィールド
conversionActions[]

string

このキャンペーンの最適化に使用するコンバージョン アクションのリソース名のセット。

OptimizationGoalSetting

このキャンペーンの最適化の目標設定。これには、一連の最適化の目標タイプが含まれます。

JSON 表現
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
フィールド
optimizationGoalTypes[]

enum (OptimizationGoalType)

最適化目標の種類のリスト。

OptimizationGoalType

最適化目標のタイプ

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値としてのみ使用されます。このバージョンでは不明な値を表します。
CALL_CLICKS 通話クリックを重視して最適化します。通話クリックによるコンバージョンとは、ユーザーが広告を見た後に [電話] を選択して店舗に連絡した回数です。
DRIVING_DIRECTIONS ルート検索を重視した最適化。ルート検索コンバージョンとは、ユーザーが広告を見た後に [ルートを検索] を選択して店舗へのルートを検索した回数です。
APP_PRE_REGISTRATION 事前登録を重視して最適化します。事前登録コンバージョンとは、アプリのリリース時に通知を受け取る目的で事前登録したユーザーの数です。

TrackingSetting

トラッキング情報のキャンペーン単位の設定。

JSON 表現
{
  "trackingUrl": string
}
フィールド
trackingUrl

string

出力専用。動的トラッキングに使用される URL。

PaymentMode

利用可能な支払いモードを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
CLICKS インタラクション単位の課金。
CONVERSION_VALUE コンバージョン値に基づく課金このモードは、AdvertisingChannelType.HOTEL、BiddingStrategyType.COMMISSION、BudgetType.STANDARD のキャンペーンでのみサポートされています。
CONVERSIONS コンバージョン課金型。このモードは、AdvertisingChannelType.DISPLAY(AdvertisingChannelSubType.DISPLAY_GMAIL を除く)、BiddingStrategyType.TARGET_CPA、BudgetType.FIXED_CPA のキャンペーンでのみサポートされます。また、お客様がこのモードの利用資格を満たしている必要があります。詳細については、Customer.eligibility_failure_reasons をご覧ください。
GUEST_STAY ゲスト宿泊 1 回あたりの支払い額。このモードは、AdvertisingChannelType.HOTEL、BiddingStrategyType.COMMISSION、BudgetType.STANDARD のキャンペーンでのみサポートされています。

PerformanceMaxUpgrade

P-MAX にアップグレードされるキャンペーンに関する情報。

JSON 表現
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
フィールド
performanceMaxCampaign

string

出力専用。キャンペーンがアップグレードされる P-MAX キャンペーンのリソース名。

preUpgradeCampaign

string

出力専用。P-MAX にアップグレードされた従来のキャンペーンのリソース名。

status

enum (PerformanceMaxUpgradeStatus)

出力専用。P-MAX へのアップグレードをリクエストしたキャンペーンのアップグレード ステータス。

PerformanceMaxUpgradeStatus

キャンペーンの P-MAX アップグレード ステータスの列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
UPGRADE_IN_PROGRESS P-MAX キャンペーンへのアップグレードが進行中です。
UPGRADE_COMPLETE P-MAX キャンペーンへのアップグレードが完了しました。
UPGRADE_FAILED P-MAX キャンペーンへのアップグレードが失敗しました。キャンペーンは、アップグレードが試行される前と同じように配信されます。
UPGRADE_ELIGIBLE キャンペーンが P-MAX キャンペーンへのアップグレードの対象である。

ListingType

使用できるリスティング タイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
VEHICLES このキャンペーンでは車両広告が配信されます。

AssetAutomationSetting

アセットの自動化設定には、AssetAutomationType とアセットの自動化のオプトイン/オプトアウトのステータスのペアが含まれています。

JSON 表現
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
フィールド
assetAutomationType

enum (AssetAutomationType)

広告主が有効化/無効化を希望するアセット自動作成の種類。

assetAutomationStatus

enum (AssetAutomationStatus)

アセットの自動生成タイプのオプトイン/オプトアウト ステータス。

AssetAutomationType

アセットの自動化の種類。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値としてのみ使用されます。このバージョンでは不明な値を表します。
TEXT_ASSET_AUTOMATION テキスト アセットの自動化には、広告見出しと説明文が含まれます。デフォルトでは、P-MAX は有効で、検索は無効になっています。

AssetAutomationStatus

アセットの自動化のステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値としてのみ使用されます。このバージョンでは不明な値を表します。
OPTED_IN 有効にすると、アセット自動化タイプの生成と配信が可能になります。
OPTED_OUT オプトアウトすると、アセットの自動生成と配信が停止します。

CampaignKeywordMatchType

キャンペーンのキーワードのマッチタイプを記述する列挙型。

列挙型
UNSPECIFIED 値が指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
BROAD キャンペーン単位のインテント マッチ。

コミッション

コミッションは、広告主様がコンバージョン値の特定の割合を支払う自動入札戦略です。

JSON 表現
{
  "commissionRateMicros": string
}
フィールド
commissionRateMicros

string (int64 format)

コミッション率は、広告主様に請求されるコンバージョン値の割合を定義します。手数料率 x は、(x * 1,000,000) としてこのフィールドに渡す必要があります。たとえば、106,000 はコミッション率 0.106(10.6%)を表します。

ManualCpa

この型にはフィールドがありません。

広告主が指定したアクションごとに入札単価を設定できる個別単価設定の入札戦略。

ManualCpc

ユーザーがクリック単価で支払う、クリック単価の個別設定。

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

boolean

コンバージョン オプティマイザーのデータに基づいて入札単価を拡張するかどうか。

ManualCpm

この型にはフィールドがありません。

インプレッション単価の個別設定。ユーザーは 1,000 インプレッションごとに支払います。

ManualCpv

この型にはフィールドがありません。

動画の視聴回数に応じてユーザーが支払う視聴ベースの入札。

PercentCpc

商品やサービスの広告掲載価格の一部を入札単価とする入札戦略。

JSON 表現
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
フィールド
cpcBidCeilingMicros

string (int64 format)

入札戦略で設定可能な入札単価の上限。これは広告主が入力するオプションのフィールドで、ローカルのマイクロ秒単位で指定します。注: 0 値は、bid_ceiling が未定義の場合と同じように解釈されます。

enhancedCpcEnabled

boolean

コンバージョンの可能性に応じて、各オークションの入札単価を調整します。個別単価は cpcBidCeilingMicros を超えることもありますが、キャンペーンの平均入札額を超えないようにする必要があります。

TargetCpm

目標インプレッション単価(CPM)は、設定した目標インプレッション単価に基づいてパフォーマンスを最適化するように入札単価を設定する自動入札戦略です。

JSON 表現
{

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
フィールド
共用体フィールド goal。入札目標に関連する追加情報。goal は次のいずれかになります。
targetFrequencyGoal

object (TargetCpmTargetFrequencyGoal)

フリークエンシー目標に基づく入札戦略の詳細。

TargetCpmTargetFrequencyGoal

フリークエンシー目標に基づく入札戦略の詳細。

JSON 表現
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
フィールド
targetCount

string (int64 format)

フリークエンシー目標設定: 1 人のユーザーにリーチする回数を表します。

timeUnit

enum (TargetFrequencyTimeUnit)

指定した targetCount に到達する期間を表す期間。

固定のインプレッション単価

固定インプレッション単価(CPM)入札戦略。固定インプレッション単価の個別入札戦略。

JSON 表現
{
  "goal": enum (FixedCpmGoal),

  // Union field goal_info can be only one of the following:
  "targetFrequencyInfo": {
    object (FixedCpmTargetFrequencyGoalInfo)
  }
  // End of list of possible types for union field goal_info.
}
フィールド
goal

enum (FixedCpmGoal)

固定インプレッション単価入札の目標。正確な入札単価の最適化パラメータを決定します。

共用体フィールド goal_info。入札目標に関連する追加情報。goal_info は次のいずれかになります。
targetFrequencyInfo

object (FixedCpmTargetFrequencyGoalInfo)

フリークエンシー目標入札の目標の詳細。

FixedCpmGoal

「固定インプレッション単価」入札戦略の目標を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
REACH リーチ(このキャンペーンの広告を見たユーザー数)を最大化します。
TARGET_FREQUENCY フリークエンシー目標設定の CPM 入札戦略。指定したフリークエンシーで 1 人のユーザーにリーチするように入札を最適化します。

FixedCpmTargetFrequencyGoalInfo

「固定インプレッション単価」入札戦略のフリークエンシー目標設定の詳細。入札戦略の目標が TARGET_FREQUENCY の場合にのみ関連します。

JSON 表現
{
  "targetCount": string,
  "timeUnit": enum (FixedCpmTargetFrequencyTimeUnit)
}
フィールド
targetCount

string (int64 format)

ターゲット フリークエンシー数は、広告主様が 1 人のユーザーに広告を表示する回数を表します。

timeUnit

enum (FixedCpmTargetFrequencyTimeUnit)

指定した targetCount に到達する期間を表す期間。

FixedCpmTargetFrequencyTimeUnit

「固定インプレッション単価」入札戦略を使用する際、フリークエンシー目標設定を達成するために入札が最適化される期間を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
MONTHLY 30 日以内に目標フリークエンシーに到達するように入札を最適化します。

TargetCpv

この型にはフィールドがありません。

目標広告視聴単価(CPV)入札戦略。指定した目標クリック単価に基づいてパフォーマンスを最適化するように入札単価が設定される自動入札戦略です。