プロモーション広告拡張機能レコード - 一括

一括ファイルでダウンロードおよびアップロードできるプロモーション広告拡張機能を定義します。

注:

プロモーション拡張機能は、AU、CA、DE、FR、米国、英国のお客様が利用できます。

プロモーション広告拡張機能をアカウントに関連付けるか、アカウント内のキャンペーンや広告グループに関連付けることができます。 各エンティティ (アカウント、キャンペーン、または広告グループ) は、最大 20 個のプロモーション広告表示オプションに関連付けることができます。 プロモーション広告拡張機能の関連付けを管理するには、 アカウントプロモーション広告拡張機能、 広告グループプロモーション広告拡張機能、 キャンペーンプロモーション広告拡張機能 のレコードを使用します。

アカウント内のすべてのプロモーション広告拡張機能レコードをダウンロードできます。これには、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に PromotionAdExtensions の DownloadEntity 値を含めることができます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。

次の一括 CSV の例では、新しいプロモーション広告拡張機能をアカウントの共有ライブラリに追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Language,Start Date,End Date,Name,Version,Ad Schedule,Use Searcher Time Zone,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Promotion Target,Discount Modifier,Percent Off,Money Amount Off,Promotion Code,Orders Over Amount,Occasion,Promotion Start,Promotion End,Currency Code
Format Version,,,,,,,,,,,6,,,,,,,,,,,,,,,,,
Promotion Ad Extension,Active,-25,0,,,ClientIdGoesHere,,English,,12/31/2021,,,(Monday[09:00-21:00]),FALSE,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,shoes,None,20000000,,SAVE20,,WomensDay,,12/31/2021,USD

.NET、Java、または Python 用 の Bing Ads SDK を 使用している場合は、 BulkServiceManager を使用して BulkPromotionAdExtension オブジェクトをアップロードしてダウンロードする時間を節約できます。サービス操作を直接呼び出し、カスタム コードを記述してバルク ファイル内の各フィールドを解析する代わりにします。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkPromotionAdExtension
var bulkPromotionAdExtension = new BulkPromotionAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // PromotionAdExtension object of the Campaign Management service.
    PromotionAdExtension = new PromotionAdExtension
    {
        // 'Id' column header in the Bulk file
        Id = promotionAdExtensionIdKey,
        // 'Currency Code' column header in the Bulk file
        CurrencyCode = "USD",
        // 'Discount Modifier' column header in the Bulk file
        DiscountModifier = PromotionDiscountModifier.None,
        // 'Language' column header in the Bulk file
        Language = "English",
        // 'Money Amount Off' column header in the Bulk file
        MoneyAmountOff = null,
        // 'Orders Over Amount' column header in the Bulk file
        OrdersOverAmount = null,
        // 'Percent Off' column header in the Bulk file
        PercentOff = 20000000,
        // 'Promotion Code' column header in the Bulk file
        PromotionCode = "SAVE20",
        // 'Promotion Target' column header in the Bulk file
        PromotionItem = "shoes",
        // 'Occasion' column header in the Bulk file
        PromotionOccasion = PromotionOccasion.WomensDay,
        // 'Promotion End' column header in the Bulk file
        PromotionEndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
        {
            Month = 12,
            Day = 31,
            Year = DateTime.UtcNow.Year + 1
        },
        // 'Promotion Start' column header in the Bulk file
        PromotionStartDate = null,
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/womenshoesale"
        },
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/womenshoesale"
        },
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
                    
        // 'Ad Schedule' column header in the Bulk file
        Scheduling = new Schedule
        {
            // Each day and time range is delimited by a semicolon (;) in the Bulk file
            DayTimeRanges = new[]
            {
                // Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
                new DayTime
                {
                    Day = Day.Monday,
                    StartHour = 9,
                    StartMinute = Minute.Zero,
                    EndHour = 21,
                    EndMinute = Minute.Zero,
                },
            },
            // 'End Date' column header in the Bulk file
            EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
            {
                Month = 12,
                Day = 31,
                Year = DateTime.UtcNow.Year + 1
            },
            // 'Start Date' column header in the Bulk file
            StartDate = null,
            // 'Use Searcher Time Zone' column header in the Bulk file
            UseSearcherTimeZone = false,
        },

        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkPromotionAdExtension);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

プロモーション広告拡張機能レコードの場合は、一括ファイル スキーマで次の属性フィールドを使用できます。

• 広告スケジュール
• クライアント ID
• 通貨コード
• カスタム パラメーター
• 割引修飾子
• 編集場所
• 編集理由コード
• 編集状態
• 編集用語
• 終了日
• 最終 URL
• 最終 URL サフィックス
• Id
• Language
• モバイルの最終 URL
• 変更時刻
• 金額オフ
• 機会
• 金額を超える注文
• Parent Id
• 発行元の国
• プロモーション コード
• プロモーション終了
• プロモーションの開始
• プロモーション ターゲット
• 開始日
• 状態
• 追跡テンプレート
• Searcher タイム ゾーンを使用する
• バージョン

広告スケジュール

広告拡張機能を広告と共に表示する曜日と時間の範囲の一覧。 各曜日と時間範囲には、スケジュールされた曜日、開始時刻/終了時間、開始/終了分が含まれます。 各日と時刻の範囲は左と右のかっこで囲み、他の日と時刻の範囲からセミコロン (;)区切り記号で区切られます。 日付と時刻の範囲内の形式は 、Day[StartHour:StartMinue-EndHour:EndMinute] です。

StartHour の値の範囲は 00 から 23 です。00 は午前 12:00 に相当し、12 は午後 12 時です。

EndHour の値の範囲は 00 から 24 です。00 は午前 12:00 に相当し、12 は午後 12:00 です。

StartMinute と EndMinute の使用可能な値の範囲は 00 から 60 です。

次の例では、平日の午前 9:00 から午後 9:00 までの曜日と時間の範囲を示します 。(月曜日[09:00-21:00]);(火曜日[09:00-21:00]);(水曜日[09:00-21:00]);(木曜日[09:00-21:00]);(金曜日[09:00-21:00])

追加： オプション。 このフィールドを設定しない場合、広告表示オプションはカレンダーの 開始日 と 終了日 の間にいつでもスケジュールを設定できます。
更新： オプション。 個々の日と時刻の範囲を更新することはできません。 前のセットを置き換える必要がある新しいセットを送信することで、日と時刻の範囲を効果的に更新できます。 [広告スケジュール]、[終了日]、[開始日]、[検索者のタイム ゾーンを使用する] フィールドは互いに依存し、まとめて更新されます。 更新中にこれらのフィールドをすべて空のままにした場合、更新されません。 これらのフィールドのいずれかに値を含める場合、これらのすべてのフィールドの以前の値が削除または置換されます。 以前のすべてのスケジュール設定を削除するには、これらの各フィールドを delete_valueに設定します。
削除： 読み 取り 専用

クライアント ID

一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。

追加： オプション
更新： オプション
削除： 読み 取り 専用

通貨コード

プロモーション価格または割引の通貨コード。

このフィールドは、[ 金額 オフ] または [ 金額超過注文] を設定した場合にのみ適用されます。

サポートされている通貨コードは、ARS、AUD、BRL、CAD、CHF、CLP、CNY、COP、DKK、EUR、GBP、HKD、INR、MXN、NZD、PEN、PHP、PLN、SEK、SGD、USD、TWD、VEF です。

追加：金額オフまたは注文超過金額が設定されている場合は必須です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 パーセントオフまたはプロモーションコードを設定した場合、この設定は適用されなくなり、削除されます。
削除： 読み 取り 専用

カスタム パラメーター

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

一括ファイルでは、カスタム パラメーターの一覧は次のように書式設定されます。

• 各カスタム パラメーター ペアを Key=Value (例: {_promoCode}=PROMO1) として書式設定します。

• Microsoft Advertising は、含める最初の 3 つのカスタム パラメーター キーと値のペアを受け入れ、追加のカスタム パラメーターは無視されます。 カスタム パラメーターの制限の引き上げフェーズ 3 パイロット (GetCustomerPilotFeatures は 635 を返します) のお客様の場合、Microsoft Advertising は、含める最初の 8 つのカスタム パラメーター キーと値のペアを受け入れ、8 つ以上のカスタム パラメーターを含む場合はエラーが返されます。

• 各キーと値のペアは、セミコロンとスペース ("; ") で区切られます (例: {_promoCode}=PROMO1;{_season}=summer.

• Key にはセミコロンを含めることはできません。 Value にセミコロンが含まれている場合は、'\;' としてエスケープする必要があります。 さらに、Value に円記号が含まれている場合は、'\' としてもエスケープする必要があります。

• キーは 16 UTF-8 バイトを超えることはできません。値は 200 UTF-8 バイトを超えることはできません。 カスタム パラメーターの上限引き上げフェーズ 3 パイロット (GetCustomerPilotFeatures が 635 を返す) のお客様の場合、値の制限は 250 UTF-8 バイトに増加します。 キーは必須であり、値は省略可能です。 Key の最大サイズには、中かっことアンダースコア ('{'、'_'、'}' は含まれません。

  注:

  Bulk サービスでは、Key は周囲の中かっこと先頭のアンダースコアで書式設定する必要があります。たとえば、Key が promoCode の場合は、{_promoCode} として書式設定する必要があります。 キャンペーン管理サービスでは、周囲の中かっことアンダースコアを指定できません。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 すべてのカスタム パラメーターを削除するには、このフィールドを delete_value に設定します。 delete_value キーワードは、前の設定を削除します。 カスタム パラメーターのサブセットを削除するには、保持するカスタム パラメーターを指定し、保持しないパラメーターを省略します。 カスタム パラメーターの新しいセットは、以前のカスタム パラメーター セットに置き換えられます。
削除： 読み 取り 専用

割引修飾子

プロモーション割引修飾子。

このフィールドに使用できる値は None と UpTo です。

• なし: プロモーション割引は変更されません。
• UpTo: プロモーション割引は、"Up to" 文字列プレフィックスで変更されます。 たとえば、変更されていないプロモーション割引が "$20 off 靴" の場合、変更されたプロモーションは "靴から最大 20 ドル" になります。

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合は、既定値の None が設定されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

編集場所

編集レビューに失敗した広告拡張機能のコンポーネントまたはプロパティ。

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用

編集理由コード

エラーの理由を識別するコード。 考えられる理由コードの一覧については、「 編集理由コード」を参照してください。

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用

編集状態

広告拡張機能の編集状態。

使用可能な値については、次の表を参照してください。

値	説明
アクティブ	広告拡張機能が編集レビューに合格しました。
ActiveLimited	広告拡張機能は 1 つ以上の市場で編集レビューに合格し、広告拡張機能の 1 つ以上のフィールドが別の市場で編集レビューを受けています。 たとえば、広告拡張機能はカナダの編集レビューに合格し、米国でのレビューがまだ保留中です。
不承認	広告拡張機能が編集レビューに失敗しました。
非アクティブ	広告拡張機能の 1 つ以上のフィールドが編集レビュー中です。

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用

編集用語

編集レビューに失敗した用語。

用語の組み合わせによってエラーが発生した場合、またはポリシー違反に基づいて失敗した場合、このフィールドは設定されません。

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用

終了日

MM/DD/YYYY として書式設定された広告拡張機能のスケジュールされた終了日文字列。

終了日は包括的です。 たとえば、このフィールドを 2020 年 12 月 31 日に設定した場合、広告表示オプションは 2020 年 12 月 31 日午後 11 時 59 分に表示されなくなります。

追加： オプション。 終了日を指定しない場合、関連するキャンペーン、広告グループ、または広告を一時停止しない限り、広告表示オプションは引き続き配信されます。
更新： オプション。 開始日が null であるか、新しい終了日より前に発生する限り、終了日は短縮または延長できます。 このフィールドを delete_value 文字列に設定すると、実質的に終了日が削除されます。 [広告スケジュール]、[終了日]、[開始日]、[検索者のタイム ゾーンを使用する] フィールドは互いに依存し、まとめて更新されます。 更新中にこれらのフィールドをすべて空のままにした場合、更新されません。 これらのフィールドのいずれかに値を含める場合、これらのすべてのフィールドの以前の値が削除または置換されます。 以前のすべてのスケジュール設定を削除するには、これらの各フィールドを delete_valueに設定します。
削除： 読み 取り 専用

最終 URL

ランディング ページの URL。

次の検証規則は、最終 URL と最終モバイル URL に適用されます。

• URL の長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。
• 最終 URL とモバイル最終 URL の両方に最大 10 個のリスト 項目を指定できます。ただし、各一覧の最初の項目のみが配信に使用されます。 このサービスでは、前方互換性の可能性があるリスト アイテムを最大 10 個まで許可します。
• 各 URL は、セミコロンとスペース ("; ") で区切られます。
• '{' と '}' の使用は、 {lpurl} などのタグのみを示すために許可されます。
• 最終的な URL はそれぞれ、http:// または https:// で始まる整形式の URL である必要があります。
• Mobile Final Url を指定する場合は、Final Url も指定する必要があります。

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

最終 URL サフィックス

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

注:

この機能は、最終 URL サフィックス フェーズ 3 パイロット (GetCustomerPilotFeatures が 636 を返す) のお客様にのみ使用できます。 パイロットにいない場合、このプロパティは無視され、エラーは返されません。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用

Id

広告拡張機能のシステム生成識別子。

追加： オプション。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 広告拡張機能の負の識別子セットは、広告グループプロモーション広告拡張機能やキャンペーンプロモーション広告拡張機能などの依存レコードタイプの [ID] フィールドで参照できます。 これは、同じ Bulk ファイルに新しい広告表示オプションと新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

言語

広告拡張機能が配信される言語。

この拡張機能は、キャンペーンや広告グループの言語設定に関係なく、常にこの言語で提供されます。

サポートされている言語文字列は、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、イタリア語、ノルウェー語、ポルトガル語、スペイン語、スウェーデン語、および TraditionalChinese です。

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

モバイルの最終 URL

モバイル デバイスのランディング ページ URL。

次の検証規則は、最終 URL と最終モバイル URL に適用されます。

• URL の長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。
• 最終 URL とモバイル最終 URL の両方に最大 10 個のリスト 項目を指定できます。ただし、各一覧の最初の項目のみが配信に使用されます。 このサービスでは、前方互換性の可能性があるリスト アイテムを最大 10 個まで許可します。
• 各 URL は、セミコロンとスペース ("; ") で区切られます。
• '{' と '}' の使用は、 {lpurl} などのタグのみを示すために許可されます。
• 最終的な URL はそれぞれ、http:// または https:// で始まる整形式の URL である必要があります。
• Mobile Final Url を指定する場合は、Final Url も指定する必要があります。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用

変更時刻

エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。

注:

日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用

金額オフ

プロモーションの価値をオフにお金。

たとえば、"$20 off shoes - 100 ドルを超える注文" を宣伝するには、 プロモーションターゲット を "靴" に設定し、 通貨コード を "USD" に設定し、[ 金額オフ] を 20 に設定し、[ Orders Over Amount]\(金額超過注文 \) を 100 に設定します。

追加： 必須。 [金額のオフ] または [パーセントオフ] を設定する必要がありますが、両方を設定することはできません。
更新： オプション。 [金額のオフ] または [パーセントオフ] を設定できますが、両方を設定することはできません。
削除： 読み 取り 専用

機会

プロモーションの機会。

プロモーション の機会 とスケジュール ([広告のスケジュール]、[ 終了日]、[ 開始日]、[ 検索者のタイムゾーンの使用 ] フィールドの両方で、広告にプロモーションを表示できるタイミングが決まります。

プロモーション ・オケージョン は、毎年2月15日から3月31日までの WomensDay などの期間または季節性を決定します。 プロモーションは、設定した機会に対応する日付内でのみ実行されます。 各機会の定義された日付範囲の詳細については、次の表を参照してください。

スケジュール設定では、2 月 20 日から 3 月 8 日までのプロモーションの実行を制限するなど、機会の日付範囲内の短い時間枠にプロモーションを制限できます。 スケジュールを使用して、同じプロモーションを複数年実行することもできます。たとえば、2 月 15 日から 3 月 31 日まで、毎年 WomensDay プロモーションを実行します。

オケージョン値	説明
BackToSchool	"学校に戻る" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
BlackFriday	"ブラックフライデー" プロモーションは、10 月 15 日から 12 月 15 日まで実行できます。
BoxingDay	"ボクシングの日" プロモーションは、12 月 15 日から 1 月 15 日まで実行できます。
カーニバル	"カーニバル" プロモーションは、2 月 1 日から 3 月 31 日まで実行できます。
ChineseNewYear	「旧正月」プロモーションは、1 月 15 日から 3 月 1 日まで実施できます。
クリスマス	"クリスマス" プロモーションは、11 月 1 日から 1 月 15 日まで実行できます。
CyberMonday	"サイバーマンデー" プロモーションは、10 月 15 日から 12 月 15 日まで実行できます。
ディワリ	"Diwali" プロモーションは、9 月 1 日から 12 月 1 日まで実行できます。
イースター	"イースター" プロモーションは、3 月 1 日から 4 月 30 日まで実行できます。
EidAlAdha	"Eid al-Adha" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
EidAlFitr	"Eid al-Fitr" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
EndOfSeason	"シーズンの終わり" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
エピファニー	"Epiphany" プロモーションは、12 月 15 日から 1 月 31 日まで実行できます。
FallSale	"Fall Sale" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
FathersDay	"父の日" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
ハロウィーン	「ハロウィン」プロモーションは、10月1日から11月15日まで実施できます。
ハヌカ	"Hanukkah" プロモーションは、11 月 15 日から 1 月 31 日まで実行できます。
ホーリー	"Holi" プロモーションは、2 月 1 日から 3 月 31 日まで実行できます。
IndependenceDay	"独立記念日" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
LaborDay	「労働の日」のプロモーションは、4 月 15 日から 9 月 15 日まで実行できます。
MothersDay	"母の日" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
NationalDay	広告拡張機能のスケジュールに従って、"National Day" プロモーションをいつでも実行できます。
Navratri	「ナブラトリ」プロモーションは9月15日から10月31日まで実施できます。
NewYears	"新年" プロモーションは、12 月 1 日から 2 月 28 日まで実行できます。
なし	広告拡張機能のスケジュールに従って、プロモーションをいつでも実行できます。
ParentsDay	"親の日" プロモーションは、4 月 15 日から 8 月 1 日まで実行できます。
過 越	"過越" プロモーションは、2 月 15 日から 5 月 1 日まで実行できます。
ラマダン	"ラマダン" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
RoshHashanah	"Rosh Hashanah" プロモーションは、8 月 15 日から 11 月 1 日まで実行できます。
SinglesDay	10 月 15 日から 11 月 30 日まで、"単一の日" プロモーションを実行できます。
ソンクラーン	"Songkran" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
SpringSale	"Spring Sale" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
StNicholasDay	11月1日から12月31日まで「聖ニコラスの日」プロモーションが開催されます。
SummerSale	"サマーセール" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
不明	将来使用するために予約されています。
バレンタインデー	「バレンタインデー」プロモーションは、1月15日から2月28日まで実施できます。
WinterSale	"Winter Sale" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。
WomensDay	「女性の日」プロモーションは2月15日から3月31日まで実施できます。
YearEndGift	"Year-End Gift" プロモーションは、広告拡張機能のスケジュールに従っていつでも実行できます。

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合は、既定値の None が設定されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを設定した場合は、前の設定を保持または更新するために、[ 昇格の開始 ] と [ 昇格の終了 ] も設定する必要があります。
削除： 読み 取り 専用

金額を超える注文

プロモーション ターゲットに追加された金額を超える注文。

たとえば、"$20 off shoes - 100 ドルを超える注文" を宣伝するには、 プロモーションターゲット を "靴" に設定し、 通貨コード を "USD" に設定し、[ 金額オフ] を 20 に設定し、[ Orders Over Amount]\(金額超過注文 \) を 100 に設定します。

追加： オプション。 金額超過注文とプロモーションコードの両方を設定することはできません。
更新： オプション。 金額超過注文とプロモーションコードの両方を設定することはできません。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを '0' (ゼロ) に設定すると、前の設定が削除されます。
削除： 読み 取り 専用

Parent Id

広告拡張機能を含むアカウントのシステム生成識別子。

この一括フィールドは、取引先企業レコードの Id フィールドにマップされます。

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用

発行元の国

編集ガイドラインで指定した 用語が許可されていない発行元の国または地域の一覧。

一括ファイルでは、発行元の国またはリージョンの一覧はセミコロン (;)で区切られます。

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用

パーセントオフ

昇格値が 2 倍の割合です。

たとえば、10.0 は 10% の割引を表します。

追加： 必須。 [金額のオフ] または [パーセントオフ] を設定する必要がありますが、両方を設定することはできません。
更新： オプション。 [金額のオフ] または [パーセントオフ] を設定できますが、両方を設定することはできません。 このフィールドを設定した場合、[ 通貨コード ] 設定は適用されなくなり、以前に設定されていた場合は削除されます。
削除： 読み 取り 専用

プロモーション コード

プロモーション ターゲットに追加されたプロモーション コード。

たとえば、"$20 off shoes - Promocode SAVE20" を昇格するには、 プロモーション ターゲット を "靴" に設定し、 通貨コード を "USD" に設定し、[ 金額のオフ ] を 20 に設定し、[ プロモーション コード] を [SAVE20] に設定します。

文字列には、最大 15 文字を含めることができます。

追加： オプション。 金額超過注文とプロモーションコードの両方を設定することはできません。
更新： オプション。 金額超過注文とプロモーションコードの両方を設定することはできません。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定が削除されます。 このフィールドを設定した場合、[ 通貨コード ] 設定は適用されなくなり、以前に設定されていた場合は削除されます。 削除： 読み 取り 専用

プロモーション終了

終了日は、広告に表示されるプロモーションの日付または日付を通知するのに役立ちます。

たとえば、プロモーションの 開始日 と プロモーション終了日 の両方が 2 月 14 日に設定されている場合は、表示されるプロモーションに "Valid Feb 14" というテキストを含めることができます。

プロモーション開始日は、プロモーション終了日より前かそれ以上である必要があります。

このプロパティは、プロモーションの固有の配信範囲をオーバーライドしません。 プロモーションの 機会 とスケジュール (広告のスケジュール、 終了日、 開始日、 および検索者のタイムゾーンの使用) フィールドの両方によって、プロモーションが広告に表示される資格が決まります。

現在の年の終了日が既に経過している場合は、翌年の日付に対して各開始日と終了日を設定する必要があります。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 現在の終了日を削除し、実質的に終了日を設定しない場合は、このフィールドを delete_value 文字列に設定します。 次回プロモーション広告拡張機能を取得する場合、このフィールドは設定されません。
削除： 読み 取り 専用

プロモーションの開始

開始日は、広告に表示されるプロモーション日または日付を通知するのに役立ちます。

たとえば、プロモーションの 開始日 と プロモーション終了日 の両方が 2 月 14 日に設定されている場合は、表示されるプロモーションに "Valid Feb 14" というテキストを含めることができます。

プロモーション開始日は、プロモーション終了日より前かそれ以上である必要があります。

このプロパティは、プロモーションの固有の配信範囲をオーバーライドしません。 プロモーションの 機会 とスケジュール (広告のスケジュール、 終了日、 開始日、 および検索者のタイムゾーンの使用) フィールドの両方によって、プロモーションが広告に表示される資格が決まります。

現在の年の終了日が既に経過している場合は、翌年の日付に対して各開始日と終了日を設定する必要があります。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 現在の終了日を削除し、実質的に終了日を設定しない場合は、このフィールドを delete_value 文字列に設定します。 次回プロモーション広告拡張機能を取得する場合、このフィールドは設定されません。
削除： 読み 取り 専用

プロモーション ターゲット

プロモーションターゲットまたはアイテム。

たとえば、$20 または 20% の割引で "靴" のプロモーションを実行できます。 "最大 $20 off 靴" のプロモーションを実行するには、 プロモーション ターゲット を "靴" に設定し、 割引修飾子 を "UpTo" に設定し、 通貨コード を "USD" に設定し、 金額を 20 に設定します。

文字列には、最大 20 文字を含めることができます。

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

開始日

MM/DD/YYYY として書式設定された広告拡張機能のスケジュールされた開始日文字列。

開始日は包括的です。 たとえば、 StartDate を 2020 年 5 月 5 日に設定した場合、広告表示オプションは 2020 年 5 月 5 日午前 12 時に表示されるようになります。

追加： オプション。 開始日を指定しない場合は、広告表示オプションをすぐに スケジュールできます。
更新： オプション。 終了日が null であるか、新しい開始日の後に発生する限り、開始日は短縮または延長できます。 このフィールドを delete_value 文字列に設定すると、実質的に開始日が削除され、広告拡張機能がすぐに スケジュールされる資格があります。 [広告スケジュール]、[終了日]、[開始日]、[検索者のタイム ゾーンを使用する] フィールドは互いに依存し、まとめて更新されます。 更新中にこれらのフィールドをすべて空のままにした場合、更新されません。 これらのフィールドのいずれかに値を含める場合、これらのすべてのフィールドの以前の値が削除または置換されます。 以前のすべてのスケジュール設定を削除するには、これらの各フィールドを delete_valueに設定します。
削除： 読み 取り 専用

状態

広告拡張機能の状態。

使用可能な値は [アクティブ] または [削除済み] です。

追加： オプション。 既定値は [アクティブ] です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。

追跡テンプレート

プロモーション 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}、キャンペーン、広告グループ、条件、キーワード、または広告レベルで {_season} または {_promocode} が 定義されていない場合、ランディング ページの URL は同じになります。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用

Searcher タイム ゾーンを使用する

広告を配信できる検索ユーザーのアカウント タイム ゾーンとタイム ゾーンのどちらを使用するかを指定します。

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

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合は、既定値の FALSE が設定され、アカウントのタイム ゾーンが使用されます。
更新： オプション。 このフィールドを delete_value 文字列に設定すると、実質的に FALSE の既定値にリセットされます。 [広告スケジュール]、[終了日]、[開始日]、[検索者のタイム ゾーンを使用する] フィールドは互いに依存し、まとめて更新されます。 更新中にこれらのフィールドをすべて空のままにした場合、更新されません。 これらのフィールドのいずれかに値を含める場合、これらのすべてのフィールドの以前の値が削除または置換されます。 以前のすべてのスケジュール設定を削除するには、これらの各フィールドを delete_valueに設定します。
削除： 読み 取り 専用

バージョン

広告拡張機能の内容が更新された回数。 拡張機能を追加すると、バージョンは 1 に設定され、変更されるたびにインクリメントされます。

追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用