キャンペーン データ オブジェクト - キャンペーン管理
キャンペーンを定義します。
注:
動的検索広告のみをサポートするキャンペーンを追加、更新、または取得することはできなくなります。 既存のキャンペーンのキャンペーンの種類が "DynamicSearchAds" から "検索" に更新されました。 広告グループは現在、"動的" 広告グループと見なされますが、構造的な変更はありません。つまり、以前と同じ自動ターゲットと動的検索広告が含まれています。
注:
2021 年 4 月の時点で、手動の CPC 入札戦略はオーディエンス キャンペーンと宿泊キャンペーンでのみ使用できます。 他のキャンペーンタイプに対して手動のクリック単価を設定しようとすると、リクエストはエラーなしで無視され、入札戦略は拡張 CPC に設定されます。
2021 年 4 月の時点で、広告グループやキーワードに対して入札戦略を設定することはできません。 入札戦略はキャンペーン レベルでのみ設定できます。 広告グループまたはキーワードの入札戦略を設定しようとすると、要求はエラーなしで無視されます。 広告グループとキーワードは、キャンペーンの入札戦略を継承します。
構文
<xs:complexType name="Campaign" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<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="BudgetType" nillable="true" type="tns:BudgetLimitType" />
<xs:element minOccurs="0" name="DailyBudget" nillable="true" type="xs:double" />
<xs:element xmlns:q9="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="DealIds" nillable="true" type="q9:ArrayOflong">
<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="ExperimentId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
<xs:element xmlns:q10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q10:ArrayOfKeyValuePairOfstringstring" />
<xs:element xmlns:q11="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="GoalIds" nillable="true" type="q11:ArrayOflong">
<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="IsDealCampaign" 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="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="Status" nillable="true" type="tns:CampaignStatus" />
<xs:element minOccurs="0" name="SubType" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="TimeZone" nillable="true" type="xs:string" />
<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="CampaignType" nillable="true" type="tns:CampaignType" />
<xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
<xs:element minOccurs="0" name="BudgetId" nillable="true" type="xs:long" />
<xs:element xmlns:q12="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Languages" nillable="true" type="q12:ArrayOfstring" />
<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="BidStrategyId" nillable="true" type="xs:long">
<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>
要素
Campaign オブジェクトには、AdScheduleUseSearcherTimeZone、AudienceAdsBidAdjustment、BidScheme、BidStrategyId、BudgetId、BudgetType、CampaignType、DailyBudget、DealIds、ExperimentId、FinalUrlSuffix、ForwardCompatibilityMap、GoalIds、Id、IsDealCampaign、Languages、 MultimediaAdsBidAdjustment、Name、Settings、Status、SubType、TimeZone、TrackingUrlTemplate、UrlCustomParameters。
要素 | 説明 | データ型 |
---|---|---|
AdScheduleUseSearcherTimeZone | 広告を配信できる検索ユーザーのアカウント タイム ゾーンとタイム ゾーンのどちらを使用するかを指定します。 検索ユーザーのタイム ゾーンに広告を表示する場合は、このプロパティを true に設定し、それ以外の場合は false に設定 します。 この要素は既定では返されません。 この要素を取得するには、 GetCampaignsByAccountId および GetCampaignsByIds サービス操作を呼び出すときに、ReturnAdditionalFields 要素に AdScheduleUseSearcherTimeZone 値を含めます。 足す: 随意。 この要素を指定しない場合、または空のままにした場合は、既定値 の false が設定され、アカウントのタイム ゾーンが使用されます。 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
boolean |
AudienceAdsBidAdjustment | ベース広告グループまたはキーワード (keyword)の入札単価を上回るまたは下回るオーディエンス広告の入札単価を調整する割合です。 このプロパティは、顧客が Microsoft Audience Network に対して有効になっている場合、検索キャンペーンで使用できます。 このプロパティは 、スマート ショッピング キャンペーンでは使用できません。 サポートされる値は、負の 100 (-100) から正の 900 (900) です。 入札単価調整を -100 に設定すると、このキャンペーンの対象ユーザー広告が表示されなくなります。 対象ユーザー広告の入札単価調整を指定する代わりに、ベース広告グループまたはキーワード (keyword)入札を使用する場合は、この要素を 0 に設定します。 ベスト プラクティスとして、常に入札単価調整値を指定する必要があります。 この要素を null に設定すると、システムの既定の入札単価調整が使用されます。 システムの既定の入札単価調整は現在 0 (0) であり、変更される可能性があります。 足す: 随意 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
int |
BiddingScheme | 入札を管理する方法の入札戦略の種類。 キャンペーンの種類ごとにサポートされている入札戦略の詳細については、「 予算と入札戦略」を参照してください。 大事な: 一部の入札戦略の種類では、入札単価と広告ローテーションの設定は無視され、コンバージョントラッキング ( ユニバーサル イベント トラッキング タグとコンバージョン目標を使用) が必要です。 サポートされている場所などの詳細については、「 Microsoft Advertising で入札戦略を使用して入札を管理できるようにする」を参照してください。 キャンペーンで MaxConversionValueBiddingScheme または TargetImpressionShareBiddingScheme 入札戦略を使用する場合、この要素は既定で nil または空になります。 MaxConversionValueBiddingScheme オブジェクトまたは TargetImpressionShareBiddingScheme オブジェクトを取得するには、GetCampaignsByAccountId および GetCampaignsByIds サービス操作を呼び出すときに ReturnAdditionalFields 要素に、それぞれの MaxConversionValueBiddingScheme 値と TargetImpressionShareBiddingScheme 値を含めます。 足す: 随意。 Search キャンペーンと DynamicSearchAds キャンペーンの既定の入札戦略の種類は EnhancedCpcBiddingScheme です。 ほとんどのショッピング キャンペーンの既定の入札戦略の種類は EnhancedCpcBiddingScheme です。ただし、 スマート ショッピング キャンペーン でサポートされている入札戦略の種類は 、MaxConversionsBiddingScheme と MaxConversionValueBiddingScheme のみです。 対象ユーザーキャンペーンでサポートされている入札戦略の種類は 、EnhancedCpcBiddingScheme、 ManualCpcBiddingScheme、 ManualCpmBiddingScheme、 TargetCpaBiddingScheme です。 宿泊キャンペーンでサポートされている入札戦略の種類は 、CommissionBiddingScheme、 ManualCpcBiddingScheme、 PercentCpcBiddingScheme です。 パフォーマンス Max キャンペーンでサポートされている入札戦略は 、MaxConversionsBiddingScheme (オプションの TCPA) と MaxConversionValueBiddingScheme (省略可能な TROAS) です。 新しいビデオ キャンペーンでサポートされている入札戦略は 、ManualCpmBiddingScheme と ManualCpvBiddingScheme です。 手記: 2024 年 5 月の時点で、対象ユーザーのネイティブ キャンペーンに対して手動の CPC 入札戦略を使用できなくなります。 手動クリック単価は、対象ユーザーの表示と動画のキャンペーンと、宿泊キャンペーンにのみ使用できます。 既存の手動 CPC オーディエンス ネイティブ キャンペーンは、拡張 CPC に自動的に変換されます。 他のキャンペーンタイプに対して手動のクリック単価を設定しようとすると、リクエストはエラーなしで無視され、入札戦略は拡張 CPC に設定されます。 2021 年 4 月の時点で、広告グループやキーワードに対して入札戦略を設定することはできません。 入札戦略はキャンペーン レベルでのみ設定できます。 広告グループまたはキーワードの入札戦略を設定しようとすると、要求はエラーなしで無視されます。 広告グループとキーワードは、キャンペーンの入札戦略を継承します。 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
BiddingScheme |
BidStrategyId | このキャンペーンがアカウント内の他のキャンペーンと共有する BidStrategy のシステム生成識別子。 フィールドが空の場合、キャンペーンはポートフォリオ入札戦略を使用していません。 フィールドが空ではなく、値が 0 より大きい場合、キャンペーンではポートフォリオ入札戦略が使用されます。 キャンペーンでポートフォリオ入札戦略を使用していて、独自の入札戦略を使用する場合は、このフィールドを "0" (ゼロ) に設定します。 手記: ポートフォリオの入札戦略は、 スマート ショッピング キャンペーン やパフォーマンス 上限キャンペーンではサポートされていません。 足す: 随意 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
long |
BudgetId | このキャンペーンがアカウント内の他のキャンペーンと共有する 予算 の一意の Microsoft 広告識別子。 値が null ではなく、0 より大きい場合、キャンペーンでは共有予算が使用されます。 値が null の場合、キャンペーンは共有予算を使用していません。 キャンペーンで共有予算を使用していて、 DailyBudget 金額などの独自の予算を使用する場合は、この要素を '0' (ゼロ) に設定し、 DailyBudget を有効な予算金額に設定します。 手記: 共有予算は、 スマート ショッピング キャンペーン や Performance Max キャンペーンではサポートされていません。 スマート ショッピング キャンペーンでは、DailyBudget の金額を設定する必要があります。 足す: 随意 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
long |
BudgetType | 予算の種類によって、予算の使い方が決まります。 指定できる値は、DailyBudgetAccelerated と DailyBudgetStandard です。 DailyBudgetAccelerated の予算タイプは、共有されていないキャンペーン レベルの予算を使用する対象ユーザー キャンペーンでのみ使用できます。 共有予算のコンテキストでは、予算タイプは、キャンペーンが共有予算を使用するかどうかに関係なく、常に返される読み取り専用プロパティです。 キャンペーンで共有予算が使用されているかどうかを判断するには、上記のように BudgetId 要素の値をチェックします。 実験キャンペーンでは、 予算、 BudgetType、または 状態を設定することはできません。 実験キャンペーンの予算と状態は、常に基本キャンペーン設定から継承されます。 足す:BudgetId が設定されていない場合は必須です。 キャンペーンで共有予算が使用されている場合は、読み取り専用です。 更新:BudgetId が設定されていない場合は省略可能です。 更新プログラムに値が設定されていない場合、この設定は変更されません。 キャンペーンで共有予算を使用する場合は許可されません。 共有予算を持つキャンペーンの予算の種類を更新しようとすると、 サービスから CampaignServiceCannotUpdateSharedBudget エラー コードが返されます。 |
BudgetLimitType |
CampaignType | キャンペーンの種類によって、キャンペーンが対象ユーザー、動的検索広告、検索、ショッピング キャンペーン、ホテル広告、またはパフォーマンス最大値のいずれであるかが決まります。 足す: 随意。 指定しない場合は、 Search の既定値が使用されます。 更新: 禁じられた。 |
CampaignType |
DailyBudget | キャンペーンに 1 日に費やす金額。 BudgetId が設定されていない場合は、日単位の予算金額を設定する必要があります。 予算はターゲットです。実際の支出が多いか低いかも知れません。 バリエーションは、さまざまな曜日のトラフィック量や、クリックから数時間以内にキャンペーンに返金できる詐欺クリックの自動検出と払い戻しなど、さまざまな要因によって発生します。 Microsoft Advertising は変動を予測して自動的に補正し、通常は 1 日の上限を 100% 未満に過大支出し続けます。 また、Microsoft Advertising では、キャンペーン予算を広告グループとキーワード (keyword)入札額よりも高くする必要はありません。 つまり、広告グループとキーワード (keyword)の入札は、キャンペーン予算とは無関係に検証されます。 共有予算のコンテキストでは、予算金額は、キャンペーンが共有予算を使用するかどうかに関係なく、常に返される読み取り専用プロパティです。 キャンペーンが共有予算に関連付けられている場合、返される金額は共有予算の金額になります。 キャンペーンで共有予算が使用されているかどうかを判断するには、上記のように BudgetId 要素の値をチェックします。 実験キャンペーンでは、 予算、 BudgetType、または 状態を設定することはできません。 実験キャンペーンの予算と状態は、常に基本キャンペーン設定から継承されます。 足す:BudgetId が設定されていない場合は必須です。 キャンペーンで共有予算が使用されている場合は、読み取り専用です。 更新:BudgetId が設定されていない場合は省略可能です。 更新プログラムに値が設定されていない場合、この設定は変更されません。 キャンペーンで共有予算を使用する場合は許可されません。 共有予算を持つキャンペーンの予算金額を更新しようとすると、Service は CampaignServiceCannotUpdateSharedBudget エラー コードを返します。 |
複 |
DealIds | 追加された取引に対応する一意のシステム識別子の一覧。 識別子の一覧は、要求内の取引の一覧に直接対応します。 リストの項目は null として返される場合があります。 取引が追加されなかったリスト インデックスごとに、対応する要素は null になります。 |
long 配列 |
ExperimentId |
実験のシステム生成識別子。 この要素は、実験キャンペーン、つまり、別の検索キャンペーンに基づいて A/B テスト用に作成されたキャンペーンにのみ設定されます。 基本キャンペーンには実験 ID は含まれません。 同様に、実験が独立したキャンペーンに 終了した 後は、キャンペーンが以前に実験キャンペーンであった場合でも、この要素は空になります。 実験キャンペーンでは、 予算、 BudgetType、または 状態を設定することはできません。 実験キャンペーンの予算と状態は、常に基本キャンペーン設定から継承されます。 実験の予算を変更する場合は、基本キャンペーンの予算を変更する必要があります。 値の変更は、実験 TrafficSplitPercent 設定に基づいて分割されます。 足す: 読み取り専用 更新: 読み取り専用 |
long |
FinalUrlSuffix | 最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。 足す: 随意 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。 |
string |
ForwardCompatibilityMap | 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、このオブジェクトの前方互換性の変更はありません。 |
KeyValuePairOfstring 配列 |
GoalIds | 目標 ID の一覧。 | long 配列 |
身分証明書 | キャンペーンの一意の Microsoft Advertising 識別子。 足す: 読み取り専用 更新: 必須 |
long |
IsDealCampaign | このキャンペーンは、true の場合は取引キャンペーン です。 | boolean |
言語 |
広告の言語設定は、広告を作成するときに使用する言語を決定し、顧客の言語にする必要があります。 大事な: 言語が広告グループレベルとキャンペーンレベルの両方で設定されている場合、広告グループレベルの言語はキャンペーンレベルの言語よりも優先されます。 一覧で複数の言語を個別に指定することも、すべての言語を対象とする場合は 1 つのリスト アイテムのみを [すべて] に設定することもできます。 検索およびショッピング キャンペーンでサポートされている言語文字列は、アルバニア語、ブルガリア語、クロアチア語、チェコ語、デンマーク語、オランダ語、英語、エストニア語、フィンランド語、フランス語、ドイツ語、ハンガリー語、イタリア語、日本語、ラトビア語、リトアニア語、マルタ語、ノルウェー語、ポーランド語、ポルトガル語、ルーマニア語、スロバキア語、スロベニア語、スペイン語、スウェーデン語、および TraditionalChinese です。 手記: ブルガリア語、クロアチア語、チェコ語、エストニア語、ギリシャ語、ハンガリー語、日本語、ラトビア語、リトアニア語、マルタ語、ポーランド語、ルーマニア語、スロバキア語、スロベニア語の各言語はまだ使用できません。 対象ユーザー キャンペーンでは、すべての言語を含める必要があります。つまり、この要素を [すべて] に設定します。 動的検索広告キャンペーンの場合、キャンペーンと広告グループレベルの言語設定は、ウェブサイトドメイン の言語を優先して無視されます。 キャンペーンの言語を [すべて] に設定し、広告グループ レベルの 言語 は空のままにする必要があります。 足す: 対象ユーザー キャンペーンに必要です。それ以外の場合は、この要素は省略可能です。 キャンペーンの言語が設定されていない場合は、キャンペーン内の各広告グループの言語が必要です。 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 キャンペーンの言語を設定すると、その言語をすべて削除することはできません。 更新中に指定した言語の一覧は、以前の設定に置き換えられます。つまり、既存の言語セットには追加されません。 |
string 配列 |
MultimediaAdsBidAdjustment | ベース広告グループまたはキーワード (keyword)の入札額を上回るマルチメディア広告の入札単価を調整する割合 | int |
名前 | キャンペーンの名前。 この名前は、アカウント内のすべてのアクティブなキャンペーンまたは一時停止中のキャンペーンで一意である必要があります。 名前には最大 128 文字を使用することができます。 サービスは、名前を既存のキャンペーン名と比較するときに、大文字と小文字を区別しない比較を実行します。 足す: 必須 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
string |
設定 | キャンペーンの種類によって異なるサポートされる設定。 注: VerifiedTrackingSetting は現在使用できません。 設定の一覧には、設定の種類ごとに最大 1 つのオブジェクト ( TargetSetting など) を含めることができます。 CampaignType が Search に設定されていて、ExperimentId 要素が設定されていない場合、このリストには必要に応じて DynamicSearchAdsSetting オブジェクトを含めることができます。 実験キャンペーンと実験の基本キャンペーンには、動的検索広告の設定を含めることはできません。 このキャンペーンを実験に使用する場合は、動的検索広告の設定は含めないでください。 既存の実験がこのキャンペーンに基づいている場合、動的検索広告設定を含むようにキャンペーンを更新することはできません。 CampaignType が [ショッピング] に設定されている場合、このリストには ShoppingSetting オブジェクトが含まれている必要があります。 CampaignType が [対象ユーザー] に設定されている場合、対象ユーザー キャンペーンが製品広告をサポートしているかどうかに応じて、このリストに ShoppingSetting オブジェクトが含まれている場合と含まれていない場合があります。 CampaignType が DynamicSearchAds に設定されている場合、このリストには DynamicSearchAdsSetting オブジェクトが含まれている必要があります。 CampaignType が Hotel に設定されている場合、このリストには HotelSetting オブジェクトが含まれている必要があります。 CampaignType が PerformanceMax に設定されている場合、このリストには PerformanceMaxSetting オブジェクトが含まれている必要があります。 Performance Max キャンペーンがストアに関連付ける場合は、 ShoppingSetting もサポートされます。 TargetSetting は、Performace Max を除く任意のキャンペーン タイプで使用でき、このキャンペーンに関連付けられている対象ユーザーの条件で [ターゲットと入札] オプションと [入札のみ] ターゲット オプションのどちらを使用するかを決定します。 TargetSetting 内では、1 つの TargetSettingDetail オブジェクト (つまり、サポートされている CriterionTypeGroup ごとに 1 つ) を使用できます。 キャンペーン レベルのターゲット設定で現在サポートされている条件の種類の値は、"対象ユーザー" のみです。 TargetSetting オブジェクトは、既定では返されません。 このオブジェクトを取得するには、GetCampaignsByAccountId および GetCampaignsByIds サービス操作を呼び出すときに、ReturnAdditionalFields 要素に TargetSetting 値を含めます。 足す:CampaignType が DynamicSearchAds または Shopping に設定されている場合は必須で、それ以外の場合はこの要素は省略可能です。 この要素に TargetSetting オブジェクトが含まれていない場合、すべての条件タイプ グループの既定の入札オプションは実質的に "入札のみ" です。 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 DynamicSearchAdsSetting オブジェクトと ShoppingSetting オブジェクトは、更新中に削除できません。 |
配列の設定 |
Status | キャンペーンの状態。 有効な値は [アクティブ] と [一時停止] です。 予算が枯渇した場合、サービスはキャンペーンを自動的に一時停止します。 実験キャンペーンでは、[ 予算]、[ BudgetType]、[ 状態] [予算] を設定することはできません。また、実験キャンペーンの状態は常に基本キャンペーンの設定から継承されます。 足す: 随意。 既定値は Paused です。 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
CampaignStatus |
SubType | キャンペーンのサブタイプ。 サブタイプが設定されていない場合、キャンペーンはキャンペーンタイプに従って作成されます。 サブタイプが AudienceVideoAds に設定され、キャンペーンの種類が [対象ユーザー] の場合、キャンペーンはビデオ対象ユーザー キャンペーンです。 サブタイプが ShoppingSmartAds に設定されている場合、キャンペーンは Microsoft スマート ショッピング キャンペーンです。 サブタイプが ShoppingSponsoredProductAd に設定されている場合、キャンペーンは ブランド向けの Microsoft ショッピング キャンペーンです。 足す: オプションで、ほとんどのキャンペーンタイプには適用されません。 Microsoft スマート ショッピング キャンペーンの場合は、 サブタイプを ShoppingSmartAds に設定する必要があります。 ブランドの Microsoft ショッピング キャンペーンの場合は、サブタイプを ShoppingSponsoredProductAd に設定する必要があります。 更新: 読み取り専用 |
string |
TimeZone |
この列は非推奨です。 キャンペーンが動作するタイム ゾーン。 タイム ゾーンは、広告グループの開始日と終了日をレポートして適用するために使用されます。 使用可能な値については、「 タイム ゾーン」を参照してください。 実験キャンペーンでは、 予算、 BudgetType、 Status、または TimeZone を設定することはできません。 実験キャンペーンの予算、状態、タイム ゾーンは、常に基本キャンペーン設定から継承されます。 足す: 必須 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 キャンペーンに [アクティブ ] または [ 一時停止 ] 状態の広告グループが含まれている場合、または広告グループが含まれている場合、タイム ゾーンを更新することはできません。 |
string |
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 |
要件
サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13
使用ページ
AddCampaigns
GetCampaignsByAccountId
GetCampaignsByIds
UpdateCampaigns