次の方法で共有

AdGroup データ オブジェクト - キャンペーン管理

  • [アーティクル]

広告キャンペーンの広告グループを定義します。

構文

<xs:complexType name="AdGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdRotation" nillable="true" type="tns:AdRotation" />
    <xs:element minOccurs="0" name="AudienceAdsBidAdjustment" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="CommissionRate" nillable="true" type="tns:RateBid">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="CpcBid" nillable="true" type="tns:Bid" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q20="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q20:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="FrequencyCapSettings" nillable="true" type="tns:ArrayOfFrequencyCapSettings">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="MultimediaAdsBidAdjustment" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Network" nillable="true" type="tns:Network" />
    <xs:element minOccurs="0" name="PercentCpcBid" nillable="true" type="tns:RateBid">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="PrivacyStatus" nillable="true" type="tns:AdGroupPrivacyStatus" />
    <xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdGroupStatus" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
    <xs:element minOccurs="0" name="UseOptimizedTargeting" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="UsePredictiveTargeting" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="AdScheduleUseSearcherTimeZone" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="AdGroupType" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="CpvBid" nillable="true" type="tns:Bid">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="CpmBid" nillable="true" type="tns:Bid">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="McpaBid" nillable="true" type="tns:Bid">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

要素

AdGroup オブジェクトには、AdGroupType、AdRotation、AdScheduleUseSearcherTimeZone、AudienceAdsBidAdjustment、BiddingScheme、CommissionRate、CpcBid、CpmBid、CpvBid、EndDate、FinalUrlSuffix、ForwardCompatibilityMap、FrequencyCapSettings、Id、Language、McpaBid、などの要素があります。MultimediaAdsBidAdjustment, Name, Network, PercentCpcBid, PrivacyStatus, Settings, StartDate, Status, TrackingUrlTemplate, UrlCustomParameters, UseOptimizedTargeting, UsePredictiveTargeting.

要素 説明 データ型
AdGroupType 広告グループの種類。

CampaignType が "Search" で ExperimentId が設定されておらず、設定に有効な DynamicSearchAdsSetting が既に含まれている混合キャンペーンでは、可能な値は "SearchDynamic" と "SearchStandard" です。 それ以外の場合、"検索" キャンペーン内の広告グループの種類は "SearchStandard" にのみ設定できます。 広告グループの種類が "SearchDynamic" の場合は、この広告グループ内にのみ動的検索広告を追加できます。 広告グループの種類が "SearchStandard" の場合は、この広告グループ内に拡張テキスト広告またはレスポンシブ検索広告を追加できます。

"DynamicSearchAds" キャンペーン内の広告グループの種類は、"SearchDynamic" にのみ設定できます。 "DynamicSearchAds" キャンペーンの広告グループの種類を設定する必要はありませんが、広告グループを取得する場合、この要素は "SearchDynamic" に設定されることに注意してください。

このフィールドは、"Hotel" または "検索" キャンペーンの種類に対して HotelAds に設定できます。

この要素は、"対象ユーザー" または "ショッピング" キャンペーンの種類に設定できません。 サポートされていないキャンペーン内で広告グループを取得する場合、この要素は設定されません。

追加： オプション。 "Search" キャンペーンの既定値は "SearchStandard" です。 "DynamicSearchAds" キャンペーンの既定値は "SearchDynamic" です。
更新： 読み 取り 専用。 広告グループの種類を更新することはできません。		 string
AdRotation 広告ローテーションは、広告グループ内に複数の広告がある場合に、配信する広告を Microsoft Advertising が選択する頻度を設定します。 アカウントから一度に表示できる広告は 1 つ以上ないため、広告ローテーションでは、パフォーマンスが向上する可能性が高い統計的に表示される広告が優先されます。

注: 広告ローテーションは製品広告には適用されません。

広告ローテーション の種類 に使用できる値は OptimizeForClicks と RotateAdsEvenly です。

OptimizeForClicks に設定されている場合、Microsoft Advertising は、オークションの特性や要因 (キーワード (keyword)、検索用語、デバイス、場所など) に基づいて、パフォーマンスが最も高い広告グループの広告に優先順位を付けます。 パフォーマンスの向上した広告は表示頻度が高くなり、他の広告は配信頻度が低くなります(まったく表示される場合)。

RotateAdsEvenly に設定すると、Microsoft Advertising は広告間のローテーションのバランスを取ります。 つまり、特定の広告グループ内の広告も、検索者のクエリに応答して表示される可能性が高くなります。 広告の品質が低い場合は、広告の優先順位が低くなります。そのため、表示頻度が低くなる場合や、まったく表示されない場合があります。
- RotateAdsEvenly 設定を使用すると、パフォーマンスの低い広告をパフォーマンスの高い広告と同じ頻度で表示できます。 これは広告グループのパフォーマンスに影響を与える可能性があります。
- 自動入札戦略 (MaxClicks、MaxConversions、TargetCpa、TargetRoas) を使用する場合、これらの入札戦略はパフォーマンスの高い広告を優先するため、RotateAdsEvenly 設定は無視されます。

追加： オプション。 既定値は OptimizeForClicks です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 AdRotation
AdScheduleUseSearcherTimeZone 広告を配信できる検索ユーザーのアカウント タイム ゾーンとタイム ゾーンのどちらを使用するかを指定します。

検索ユーザーのタイム ゾーンに広告を表示する場合は、このプロパティを true に設定し、それ以外の場合は false に設定 します。

この要素は既定では返されません。 この要素を取得するには、GetAdGroupsByCampaignId および GetAdGroupsByIds サービス操作を呼び出すときに、ReturnAdditionalFields 要素に AdScheduleUseSearcherTimeZone 値を含めます。

追加： オプション。 この要素を指定しない場合、または空のままにした場合は、既定値の true が設定され、検索ユーザーのタイム ゾーンが使用されます。 2020 年 9 月 30 日以降、このフィールドを指定しない場合や空のままにした場合は、既定値 の false が設定され、アカウントのタイム ゾーンが使用されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 boolean
AudienceAdsBidAdjustment ベース広告グループまたはキーワード (keyword)の入札単価を上回るまたは下回るオーディエンス広告の入札単価を調整する割合です。

このプロパティは、顧客が Microsoft Audience Network に対して有効になっている場合、検索キャンペーンで使用できます。 このプロパティは 、スマート ショッピング キャンペーンでは使用できません。

サポートされる値は、負の 100 (-100) から正の 900 (900) です。 入札単価調整を -100% に設定すると、この広告グループに対してオーディエンス広告が表示されなくなります。

オーディエンス広告の入札単価調整を行わない場合は、この要素をゼロ (0) に設定します。 この要素が null の場合は、広告グループのキャンペーンの AudienceAdsBidAdjustment 設定を継承 します。

追加： オプション
更新： オプション。 このプロパティは、 UpdateAudienceAdsBidAdjustment 要素も true に設定した場合にのみ更新され、それ以外の場合、このプロパティは無視されます。 広告グループにネイティブの入札単価調整が既にあり、広告グループのキャンペーンの AudienceAdsBidAdjustment 設定を効果的に継承するために広告グループを削除する場合は、この要素を null に設定します。		 int
BiddingScheme 入札を管理する方法の入札戦略の種類。

メモ： 2021 年 4 月の時点で、広告グループやキーワードに対して入札戦略を設定することはできません。 広告グループまたはキーワードの入札戦略を設定しようとすると、要求はエラーなしで無視されます。 広告グループとキーワードは、キャンペーンの入札戦略を継承します。

追加： オプション。 この要素を設定しない場合、 InheritFromParentBiddingScheme が既定で使用されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 BiddingScheme
CommissionRate 予約済み。 RateBid
CpcBid ユーザーのクエリと広告グループのキーワードが一致する場合に、広範、正確、またはフレーズの一致の比較を使用して使用する既定の入札。

最小入札価格と最大入札範囲は、アカウントの通貨によって異なります。 詳細については、「 通貨」を参照してください。

キーワード (keyword)レベルで広い一致単価、正確一致、語句の一致単価を指定すると、対応する一致タイプの広告グループのクリック単価がオーバーライドされます。

追加： オプション。 入札を設定しない場合は、アカウントの通貨に応じて最小値に設定されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 入札
CpmBid 予約済み。

この要素は既定では返されません。 この要素を取得するには、 GetAdGroupsByCampaignId および GetAdGroupsByIds サービス操作を呼び出すときに、ReturnAdditionalFields 要素に CpmBid 値 を 含めます。		 入札
CpvBid 予約済み。

この要素は既定では返されません。 この要素を取得するには、 GetAdGroupsByCampaignId および GetAdGroupsByIds サービス操作を呼び出すときに、ReturnAdditionalFields 要素に Cpv 値 を 含めます。		 入札
EndDate 広告グループ内の広告の有効期限が切れる日付。

終了日を指定しない場合、広告の有効期限は切れなくなります。 終了日を延長すると、広告グループの有効期限が切れた後でも、広告グループの広告を配信の対象にすることができます。

終了日は包括的です。 たとえば、 EndDate を 2020 年 12 月 31 日に設定した場合、広告グループの広告は 2020 年 12 月 31 日午後 11 時 59 分に期限切れになります。 時間は、キャンペーン レベルで指定したタイム ゾーンに基づいています。

追加： オプション。 広告グループを追加するときに終了日を設定しない場合は、この要素を null に設定します。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 既存の終了日設定を削除し、広告グループを更新するときに終了日を効果的に設定しない場合は、終了日を 2050 年 1 月 2 日以降に設定します。 次回広告グループを取得すると、この要素は nil になります。つまり、2050 年 1 月 2 日には設定されません。		 Date
FinalUrlSuffix 最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。		 string
ForwardCompatibilityMap 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。

今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、このオブジェクトの前方互換性の変更はありません。		 KeyValuePairOfstring 配列
FrequencyCapSettings 周波数上限の設定。 FrequencyCapSettings 配列
Id 広告グループのシステム生成識別子。

追加： 許可されていません。
更新： 読み取り専用と必須		 long
言語 広告の言語設定は、広告を作成するときに使用する言語を決定し、顧客の言語にする必要があります。

大事な： 言語が広告グループレベルとキャンペーンレベルの両方で設定されている場合、広告グループレベルの言語はキャンペーンレベルの言語よりも優先されます。

検索およびショッピング キャンペーンでサポートされている言語文字列は、ブルガリア語、クロアチア語、チェコ語、デンマーク語、オランダ語、英語、エストニア語、フィンランド語、フランス語、ドイツ語、ギリシャ語、ハンガリー語、イタリア語、ラトビア語、リトアニア語、マルタ語、ノルウェー語、ポーランド語、ポルトガル語、ルーマニア語、スロバキア語、スロベニア語、スペイン語、スウェーデン語、繁体字中国語です。

メモ： ブルガリア語、クロアチア語、チェコ語、エストニア語、ギリシャ語、ハンガリー語、ラトビア語、リトアニア語、マルタ語、ポーランド語、ルーマニア語、スロバキア語、スロベニア語の各言語はまだ使用できません。

動的検索広告キャンペーンの場合、キャンペーンと広告グループレベルの言語設定は、ウェブサイトドメイン の言語を優先して無視されます。 キャンペーン の言語 を [すべて] に設定し、広告グループ レベルの言語は空のままにする必要があります。

対象ユーザー キャンペーンの広告グループの場合、広告グループ レベルの言語はサポートされていないため、広告グループのキャンペーンの Languages 要素を "すべて" に設定する必要があります。

追加： キャンペーンに 1 つ以上の言語が設定されている場合は省略可能で、それ以外の場合はほとんどのキャンペーンの種類に言語が必要です。 オーディエンス キャンペーンの広告グループに対してこの要素を設定することはできません。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 言語を削除し、キャンペーン レベルの言語に延期するには、この要素を空の文字列値 ("") に設定します。		 string
McpaBid 予約済み。 入札
MultimediaAdsBidAdjustment 予約済み。 int
名前 広告グループの名前。

この名前は、キャンペーン内のすべてのアクティブな広告グループで一意である必要があります。 名前には、最大 256 文字を含めることができます。

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 string
ネットワーク 広告を表示する検索ネットワーク。

ほとんどのキャンペーンタイプの広告グループでサポートされているネットワーク値は、 OwnedAndOperatedAndSyndicatedSearch、 OwnedAndOperatedOnly、 SyndicatedSearchOnly です。

対象ユーザー キャンペーンの広告グループの場合、広告グループ レベルのネットワークはサポートされていません。 広告グループは Microsoft Audience Network にあります。

スマート ショッピング キャンペーンの広告グループの場合、ネットワークを設定することはできません。 サービスは、ネットワークを OwnedAndOperatedAndSyndicatedSearch に設定します。

ブランドのショッピング キャンペーンの広告グループの場合、InHousePromotion ネットワーク (小売業者ネットワークのみ) は、OwnedAndOperatedAndSyndicatedSearch、OwnedAndOperatedOnly、SyndicatedSearchOnly に加えてサポートされます。

配信検索オプションのいずれかを選択した場合は、 SetNegativeSitesToAdGroups または SetNegativeSitesToCampaigns 操作を呼び出して、特定の配信検索 Web サイトに広告が表示されないようにすることができます。

ネットワークと広告配信の詳細については、広告配信に 関する ヘルプ記事を参照してください。

追加： オプション。 既定値は OwnedAndOperatedAndSyndicatedSearch です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 ネットワーク
PercentCpcBid 予約済み。 RateBid
PrivacyStatus 広告グループのターゲット条件 ( 例: ProfileCriterion がオーディエンス キャンペーンの広告グループに対して狭すぎるかどうかを示します。

追加： 読み 取り 専用
更新： 読み 取り 専用		 AdGroupPrivacyStatus
設定 通常、キャンペーンの種類によって異なる広告グループの設定。

設定の一覧には、設定の種類ごとに最大 1 つのオブジェクト ( TargetSetting など) を含めることができます。

TargetSetting は任意のキャンペーンタイプで使用でき、この広告グループに関連付けられている年齢、対象ユーザー、CompanyName、性別、業界、および JobFunction の条件で、[ターゲットと入札] オプションまたは [入札のみ] ターゲット オプションを使用するかどうかを決定します。 TargetSetting 内では、複数の TargetSettingDetail オブジェクト (CriterionTypeGroup ごとに 1 つ) を使用できます。

追加： オプション。 この要素に TargetSetting オブジェクトが含まれていない場合、すべての条件タイプ グループの既定の入札オプションは実質的に "入札のみ" です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 配列の設定
StartDate 広告グループ内の広告の配信を開始できる日付。それ以外の場合は、広告グループがアクティブになった日に広告グループ内の広告の配信を開始できます。

開始日は包括的です。 たとえば、開始日を 2021 年 5 月 5 日に設定した場合、広告グループの広告は 2021 年 5 月 5 日の午前 12 時に開始されます。 時間は、キャンペーン レベルで指定したタイム ゾーンに基づいています。

追加： オプション。 開始日を設定しない場合は、既定で今日の日付になり、広告グループの状態がアクティブになるとすぐに広告グループ内の広告の配信を開始できます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 開始日は、広告グループが送信された後、つまり開始日が到着した後は更新できません。		 Date
Status 広告グループの状態。

使用可能な値は、 アクティブ、 期限切れ、 一時停止です。 期限切れの状態は読み取り専用です。

追加： オプション。 既定値は Paused です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 AdGroupStatus
TrackingUrlTemplate 広告グループ内のすべての URL の既定として使用する追跡テンプレート。

追跡テンプレートには、次の検証規則が適用されます。 サポートされているテンプレートとパラメーターの詳細については、Microsoft Advertising のヘルプ記事「 どのような追跡または URL パラメーターを使用できますか?」を参照してください。
- 低レベルのエンティティに対して定義された追跡テンプレート (広告など) は、キャンペーンなど、上位レベルのエンティティに対して設定されたものをオーバーライドします。 詳細については、「 エンティティの制限」を参照してください。
- 追跡テンプレートの長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。
- 追跡テンプレートは、 http://、 https://、 {lpurl}、または {unescapedlpurl} のいずれかで始まる整形式の URL である必要があります。
- Microsoft Advertising では、カスタム パラメーターが存在するかどうかを検証しません。 追跡テンプレートでカスタム パラメーターを使用し、それらが存在しない場合、ランディング ページ URL には、代替なしでカスタム パラメーターのキーと値のプレースホルダーが含まれます。 たとえば、トラッキング テンプレートがでありhttps://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}、キャンペーン、広告グループ、条件、キーワード (keyword)、または広告レベルで {_season} または {_promocode} が定義されていない場合、ランディング ページの URL は同じになります。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。		 string
UrlCustomParameters URL 追跡用のキーパラメーターと値パラメーターのカスタム コレクション。

Microsoft Advertising では、 CustomParameters オブジェクトに含める最初の 8 個の CustomParameter オブジェクトを受け入れ、8 つ以上のカスタム パラメーターを含める場合はエラーが返されます。 各 CustomParameter には、Key 要素と Value 要素が含まれています。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 既存のカスタム パラメーターを保持するには、 UrlCustomParameters 要素を null または空に設定します。 すべてのカスタム パラメーターを削除するには、CustomParameters オブジェクトの Parameters 要素を null または空に設定します。 カスタム パラメーターのサブセットを削除するには、CustomParameters オブジェクトの Parameters 要素に保持するカスタム パラメーターを指定します。		 CustomParameters
UseOptimizedTargeting これは非推奨になります。 代わりに UsePredictiveTargeting を 使用します。 boolean
UsePredictiveTargeting AdGroup に対して予測ターゲティングが有効になっているかどうかを示します。

注: UsePredictiveTargeting は、対象ユーザー キャンペーンでのみ使用できます。

追加： オプション
更新： オプション。		 boolean

要件

サービス: CampaignManagementService.svc v13
名前 空間： https://bingads.microsoft.com/CampaignManagement/v13

Used By

AddAdGroups
GetAdGroupsByCampaignId
GetAdGroupsByIds
UpdateAdGroups