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

  • [アーティクル]

指定した広告グループに適用する入札可能な条件を定義します。

構文

<xs:complexType name="BiddableAdGroupCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdGroupCriterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="CriterionBid" nillable="true" type="tns:CriterionBid" />
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdGroupCriterionEditorialStatus" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q81="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q81:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q82="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q82:ArrayOfstring" />
        <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="CriterionCashback" nillable="true" type="tns:CriterionCashback">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

BiddableAdGroupCriterion オブジェクトには、CriterionBid、CriterionCashback、DestinationUrl、EditorialStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、TrackingUrlTemplate、UrlCustomParameters という要素があります。

要素 説明 データ型
CriterionBid オークションで使用する入札。

継承された 条件 が Web ページ の条件である場合は、 FixedBid を使用する必要があります。 継承された条件が ProductPartition の場合、スポンサー製品 BidOption が BidBoost に設定されていない限り、FixedBid を使用する必要があります (詳細については、以下の ProductPartition Usage を参照してください)。 他のすべての入札可能な広告グループの条件には、 BidMultiplier を使用します。 正しい種類のオブジェクトを使用しない場合、要求された入札は無視されます。入札が必要な場合、操作は失敗します。入札が省略可能な場合は、既定の入札が使用されます。

足す： 要件は、継承された 条件 の種類によって異なります。 入札は省略可能で、AgeCriterion、DayTimeCriterion、DeviceCriterion、GenderCriterion、LocationCriterion、ProfileCriterion、RadiusCriterion、AudienceCriterion、Web ページの各基準に含まれていない場合は、既定値の 0 に設定されます。 この入札は LocationIntentCriterion には適用されません (このサービスではエラーは返されず、入札は含めても無視されます)。 ApplyProductPartitionActions 操作を使用して ProductPartition を追加する場合、製品パーティションの種類が [サブディビジョン] でない限り、入札は必須です。この場合、入札は許可されません。
更新： 要件は、継承された 条件 の種類によって異なります。 入札は、 AgeCriterion、 DayTimeCriterion、 DeviceCriterion、 GenderCriterion、 LocationCriterion、 ProfileCriterion、 RadiusCriterion に必要です。 この入札は LocationIntentCriterion には適用されません (このサービスではエラーは返されず、入札は含めても無視されます)。 AudienceCriterion と Web ページの条件の場合、入札は省略可能であり、更新プログラムに値が設定されていない場合、この設定は変更されません。 ApplyProductPartitionActions 操作を使用して ProductPartition を更新する場合、入札は省略可能であり、更新に値が設定されていない場合、この設定は変更されません。		 CriterionBid
CriterionCashback CriterionCashback データ オブジェクトを定義します。 CriterionCashback
DestinationUrl ユーザーが広告をクリックしたときに取得される Web ページの URL。

この要素は、継承された 条件 が ProductPartition 条件である場合にのみ使用されます。 詳細については、以下 の「ProductPartition Usage」を参照 してください。		 string
EditorialStatus 将来の使用のために。 AdGroupCriterionEditorialStatus
FinalAppUrls 将来の使用のために。 AppUrl 配列
FinalMobileUrls 将来の使用のために。 string 配列
FinalUrls 将来の使用のために。 string 配列
FinalUrlSuffix 最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。

この要素は、継承された 条件 が ProductPartition または Web ページ の条件である場合にのみ使用されます。 詳細については、以下 の「ProductPartition Usage andWeb ページの使用状況」を参照 してください。		 string
TrackingUrlTemplate 追跡テンプレートでは、最終的な URL またはランディング ページと組み合わせて使用される URL 追跡パラメーターを指定できます。

追跡テンプレートはアカウント レベルで追加し、キャンペーン、広告グループ、広告などの下位レベルのエンティティのすべての URL に適用することをお勧めします。 詳細については、Microsoft Advertising のヘルプ記事 「アップグレードされた URL を使用した URL トラッキング」を参照してください。

この要素は、継承された 条件 が ProductPartition または Web ページ の条件である場合にのみ使用されます。 詳細については、以下 の「ProductPartition Usage andWeb ページの使用状況」を参照 してください。		 string
UrlCustomParameters URL 追跡用のキーパラメーターと値パラメーターのカスタム コレクション。

この要素は、継承された 条件 が ProductPartition または Web ページ の条件である場合にのみ使用されます。 詳細については、以下 の「ProductPartition Usage andWeb ページの使用状況」を参照 してください。		 CustomParameters

BiddableAdGroupCriterion オブジェクトには継承された要素があります。

継承された要素

AdGroupCriterion から継承された要素

BiddableAdGroupCriterion オブジェクトは AdGroupCriterion オブジェクトから派生し、AdGroupId、Criterion、Id、Status、Type の各要素を継承します。 以下の説明は BiddableAdGroupCriterion に固有であり、 AdGroupCriterion オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。

要素 説明 データ型
AdGroupId 条件を適用する広告グループの識別子。

足す： 必須
更新： 必須		 long
基準 広告グループに適用する条件。 この条件は、広告グループ内の広告が配信されるかどうかを判断するのに役立ちます。

使用可能な条件の種類の一覧については、「 AdGroupCriterionType」を参照してください。

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 Criterion
身分証明書 広告グループの条件の一意の Microsoft Advertising 識別子。

足す： 読み取り専用
更新： 必須		 long
Status 条件が広告グループに適用されるかどうかを決定する状態値。

ほとんどの入札可能な広告グループの条件では、サポートされている状態の値は [アクティブ] のみです。 例外については、以下の 「Web ページの使用状況 」を参照してください。

足す： 読み取り専用
更新： 読み取り専用		 AdGroupCriterionStatus
型 広告グループの条件の種類。 この値は、入札可能な広告グループの条件を取得するときの BiddableAdGroupCriterion です。 広告グループの条件の種類の詳細については、「 AdGroupCriterion データ オブジェクトの備考」を参照してください。

足す： 読み取り専用
更新： 読み取り専用		 string

解説

ProductPartition Usage

継承された 条件 が ProductPartition 条件の場合は、 BiddableAdGroupCriterion プロパティの次の使用法に注意してください。

CriterionBid

既定では、オークションでは製品グループに FixedBid が使用されます。 スポンサー製品 BidOption が BidBoost に設定されていない限り、FixedBid を使用する必要があります。 スポンサー製品 BidOption が BidBoost に設定されている場合、 BidMultiplier は、パートナーの入札を増幅するために使用される割合 (ゼロより大きい) を表します。

たとえば、パートナーが製品グループで $5 USD を入札したとします (CriterionBid 経由で FixedBid)。 入札単価調整 (BidMultiplier via CriterionBid) が 20 (パーセント) に設定されていて、広告グループの BidMaxValue が 0.50 (50 セント) の場合、共有額は 50 セントであり、1 米ドルではありません。

DestinationUrl

現在宛先 URL を使用している場合は、最終的に追跡テンプレートに置き換える必要があります。 詳細については、「 アップグレードされた URL を使用した URL 追跡」を参照してください。

URL には、{MatchType} などの動的パラメーターを含めることができます。 サポートされているパラメーターの一覧については、Microsoft Advertising のヘルプ記事「 どのような追跡パラメーターまたは URL パラメーターを使用できますか?」を参照してください。

URL には、最大 1,024 文字を含めることができます。 URL でプロトコルが指定されていない場合、ユーザーが広告をクリックすると、システムは HTTP プロトコルを使用します。 広告を追加するときに URL で HTTP プロトコルが指定されている場合、サービスは http:// プロトコル文字列を削除します (HTTP プロトコル文字列は 1,024 文字の制限に対してカウントされません)。ただし、サービスは URL から HTTPS プロトコル文字列 (https://) を削除しません。

宛先 URL が指定されている場合は使用されます。それ以外の場合、宛先 URL は、Microsoft Merchant Center カタログの製品オファーに対して指定した 'リンク' の対応する値によって決まります。

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。

FinalUrlSuffix

最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。

TrackingUrlTemplate

追跡テンプレートは、 Content API を介して送信した製品オファーの [リンク] フィールドに指定された URL と組み合わせて使用できます。 フィード URL と追跡テンプレートを組み合わせることで、ランディング ページ URL が組み立てられます。この URL は、広告をクリックした後にユーザーが誘導されます。 TrackingUrlTemplate 要素を使用して、フィード URL で URL パラメーターを更新するのではなく、URL パラメーターを更新する場合、フィード URL は編集レビューを行う必要がないため、広告は中断なく配信されます。 たとえば、カタログ フィードの製品オファー URL が である場合は https://contoso.com/、次の追跡テンプレート {lpurl}?matchtype={matchtype}&device={device}を指定できます。

追跡テンプレートには、次の検証規則が適用されます。 サポートされているテンプレートとパラメーターの詳細については、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 は同じになります。

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。

UrlCustomParameters

URL 追跡用のキーパラメーターと値パラメーターのカスタム コレクション。

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

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 既存のカスタム パラメーターを保持するには、 UrlCustomParameters 要素を null または空に設定します。 すべてのカスタム パラメーターを削除するには、CustomParameters オブジェクトの Parameters 要素を null または空に設定します。 カスタム パラメーターのサブセットを削除するには、CustomParameters オブジェクトの Parameters 要素に保持するカスタム パラメーターを指定します。

Web ページの使用状況

継承された 条件 が Web ページ の条件である場合は、 BiddableAdGroupCriterion プロパティの次の使用法に注意してください。

FinalUrlSuffix

最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。

状態

条件が広告グループに適用されるかどうかを決定する状態値。

状態を [アクティブ] または [ 一時停止] に設定できます。 状態を [削除済み] に設定することはできません。

足す： 随意。
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。

TrackingUrlTemplate

[Web ページの基準] の場合、トラッキング テンプレートは、動的検索広告キャンペーン用に指定したドメインから動的に生成されるランディング ページ URL と組み合わせて使用できます。 ドメインとトラッキング テンプレートを組み合わせることにより、ランディング ページ URL が組み立てられます。この URL は、広告をクリックした後にユーザーに指示されます。 追跡テンプレートの例を次に示します。 {lpurl}?matchtype={matchtype}&device={device}。

追跡テンプレートには、次の検証規則が適用されます。 サポートされているテンプレートとパラメーターの詳細については、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 は同じになります。

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。

UrlCustomParameters

URL 追跡用のキーパラメーターと値パラメーターのカスタム コレクション。

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

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 既存のカスタム パラメーターを保持するには、 UrlCustomParameters 要素を null または空に設定します。 すべてのカスタム パラメーターを削除するには、CustomParameters オブジェクトの Parameters 要素を null または空に設定します。 カスタム パラメーターのサブセットを削除するには、CustomParameters オブジェクトの Parameters 要素に保持するカスタム パラメーターを指定します。

要件

サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13