画像広告拡張機能レコード - 一括

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

画像広告拡張機能をアカウントに関連付けたり、アカウント内のキャンペーンや広告グループに関連付けたりすることができます。 各アカウントには、最大 250,000 個のキャンペーン 画像拡張機能の関連付けと、最大 250,000 個の広告グループ画像拡張機能の関連付けが含まれる場合があります。 各エンティティ (アカウント、キャンペーン、または広告グループ) は、最大 25 個の画像広告表示オプションに関連付けることができます。 画像広告拡張機能の関連付けを管理するには、 アカウントイメージ広告拡張機能、 広告グループ画像広告拡張機能、 およびキャンペーンイメージ広告拡張機能 のレコードを使用します。

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

次の一括 CSV の例では、新しい Image Ad Extension をアカウントの共有ライブラリに追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Alternative Text,Media Ids,Final Url Suffix
Format Version,,,,,,,,,,,6.0,,,,,
Image Ad Extension,Active,-14,0,,,ClientIdGoesHere,,,,,,,FALSE,ImageAdExtension Alternative Text,ImageMediaIdHere,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkImageAdExtension
var bulkImageAdExtension = new BulkImageAdExtension
{
    // '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 
    // ImageAdExtension object of the Campaign Management service.
    ImageAdExtension = new ImageAdExtension
    {
        // 'Alternative Text' column header in the Bulk file
        AlternativeText = "ImageAdExtension Alternative Text",
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Id' column header in the Bulk file
        Id = imageAdExtensionIdKey,
        // 'Media Ids' column header in the Bulk file
        ImageMediaIds = new long[] { ImageMediaIdHere },
        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkImageAdExtension);

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

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

Image Ad Extension レコードの場合、一括ファイル スキーマでは、次の属性フィールドを使用できます。

• 広告スケジュール
• 代替テキスト
• クライアント ID
• カスタム パラメーター
• 宛先 URL
• テキストの表示
• 編集場所
• 編集理由コード
• 編集状態
• 編集用語
• 終了日
• 最終 URL
• 最終 URL サフィックス
• Id
• Images
• レイアウト
• メディア ID
• モバイルの最終 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に設定します。
削除： 読み 取り 専用

代替テキスト

使いやすさのためのイメージ メディアの別の説明。 画像を表示できない場合は、代わりに代替テキストが使用されます。

このフィールドの最大長は 90 文字です。

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

クライアント ID

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

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

カスタム パラメーター

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 キーワードは、前の設定を削除します。 カスタム パラメーターのサブセットを削除するには、保持するカスタム パラメーターを指定し、保持しないパラメーターを省略します。 カスタム パラメーターの新しいセットは、以前のカスタム パラメーター セットに置き換えられます。
削除： 読み 取り 専用

宛先 URL

ユーザーが画像をクリックしたときにアクセスする Web ページの URL。

URL には、{keyword} などの動的テキスト文字列を含めることができます。 詳細については、「 使用できる追跡パラメーターまたは URL パラメーター」を参照してください。

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

注:

イメージ広告拡張機能に URL が指定されていない場合は、広告の URL が使用されます。

追加： オプション。 メモ： このフィールドは、マルチイメージ広告拡張機能に必要です。 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 メモ： このフィールドは、マルチイメージ広告拡張機能に必要です。
削除： 読み 取り 専用

テキストの表示

画像拡張機能の表示テキスト。

このフィールドの最大長は 35 文字です。

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

編集場所

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

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

編集理由コード

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

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

編集状態

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

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

値	説明
アクティブ	広告拡張機能が編集レビューに合格しました。
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 ファイルに新しい広告表示オプションと新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

画像

さまざまなサイズと縦横比を持つ画像アセットを使用して、さまざまな発行元や配置に対して柔軟に表示できるようにします。

横長画像アセットを指定する必要があります。つまり、このフィールドには 、subType が LandscapeImageMedia に設定された 1 つのイメージ アセットが含まれている必要があります。 LandscapeImageMedia に推奨される寸法は、幅 1200 x 高さ 628 です。 必要に応じて、サポートされているサブタイプごとに 1 つの画像アセットなど、追加のアセット リンクを含めることができます。 明示的に設定しない画像アセットのサブタイプの場合、Microsoft Advertising は、LandscapeImageMedia をトリミングすることで、画像アセット リンクを自動的に作成します。

イメージ資産は、一括ファイルで JSON 文字列として表されます。 次の例の JSON には 7 つのイメージが含まれており、LandscapeImageMedia subType のみがトリミングされません。 idはアセットのプロパティですが、cropHeight、cropWidth、cropXcropYsubTypeはアセット リンクのプロパティです。つまり、アセットと広告の関係です。 詳細については、下 の「cropHeight、 cropWidth、 cropX、 cropY、 id、 subType」を 参照してください。

[{
	"id": 1234567890000,
	"subType": "LandscapeImageMedia"
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia169X100",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 1061,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia93X100",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 584,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia155X100",
	"cropX": 114,
	"cropY": 0,
	"cropWidth": 973,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia133X100",
	"cropX": 183,
	"cropY": 0,
	"cropWidth": 835,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia178X100",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 1118,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia172X100",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1080,
	"cropHeight": 628
}]

注:

コンマ区切りの一括ファイルでは、アセット リンク、各属性キー、および各属性文字列値の一覧を、追加の二重引用符 (例: ) で囲む必要があります。 上記の JSON 文字列は "[{"id"":1234567890000,""subType":""LandscapeImageMedia""},{""id"":1234567890000,"subType":"SquareImageMedia"" として書き込まれます,""cropX"":286,""cropY":0,""cropWidth"":628,""cropHeight"":628},{""id""":1234567890000,""subType":""ImageMedia169X100","cropX"":70,""cropY":0,""cropWidth"":1061,"cropHeight"":628},{"id":1234567890000,""subType"":"ImageMedia93X100"","cropX"":308,"cropY":0,"""cropWidth":584,"cropHeight":628},{"id"":1234567890000,"subType":""ImageMedia15X10"","cropX"":129,""cropY"":0,""cropWidth""":942""cropHeight":628},{""id":1234567890000,"subType":""ImageMedia155X100"",""cropX""":114,""cropY":0,"cropWidth"":973,"cropHeight"":628},{""id"":1234567890000,""subType"":""ImageMedia133X100"",""cropX""":183,"cropY"":0,"cropWidth":835,"cropHeight"":628},{""id":1234567890000,""subType"":""ImageMedia178X100"","cropX""::41,""cropY"":0,""cropWidth":1118,""cropHeight"":628},{""id"":1234567890000,"subType":"ImageMedia172X100"","cropX"":60,"cropY"":0,""cropWidth"":1080,""cropHeight"":628}"" 。

上記のアップロード応答 JSON の例を考えると、次の点に注意してください。

• 自動生成されたすべてのイメージアセットのサブタイプには、同じ画像アセット識別子(1234567890000など)が使用されます。 Microsoft Advertising でトリミングされた画像を自動的に生成させるかどうかにかかわらず、 ID は 、同じ広告にリンクされている画像アセットの中で一意である必要はありません。
• この例の広告は、LandscapeImageMedia イメージ アセット のサブタイプのトリミング設定なしで作成されたため、元の横向き画像を除くすべての画像アセットがトリミングされます。
• 横向き画像に独自のトリミング設定があるかどうかに関係なく、Microsoft Advertising では、すべての既定のトリミング設定で横向き画像の真の高さが使用されます。 この例では、システムによって生成されたすべてのイメージ アセットのトリミングの高さは 628 であり、縦横比が 1.91:1 の横長画像 (LandscapeImageMedia サブタイプ) の幅と高さが 1200x628 であると推測できます。 トリミング設定 (703x368 など) を使用して横向きの画像アセット リンクが作成されていた場合でも、自動生成されたイメージ アセットのトリミング設定は、横向き画像の完全なサイズ (この例では 1200x628) に基づきます。

cropHeight

cropY 位置から開始して上に移動する、イメージ アセット ソースから使用するピクセル数。

cropWidth

cropX 位置から右に移動して、画像アセット ソースから使用するピクセル数。

cropX

画像アセット ソースの左下隅から始まり、cropWidth を適用する前に x 軸の右側にスキップするピクセル数です。

cropY

画像アセット ソースの左下隅から始まり、cropHeight を適用する前に y 軸を上方向にスキップするピクセル数です。

id

属性は id 、Microsoft Advertising アカウント内の資産の一意の Microsoft Advertising 識別子です。

同じ画像アセット識別子は、異なる縦横比で同じ広告で複数回使用でき、同じ Microsoft Advertising アカウント内の複数の広告で使用することもできます。 SubType が LandscapeImageMedia に設定されている画像アセットの識別子は、同じ広告内のすべての自動生成された画像アセット のサブタイプに使用されます。 Microsoft Advertising でトリミングされた画像を自動的に生成させるかどうかにかかわらず、 ID は 、同じ広告にリンクされている画像アセットの中で一意である必要はありません。

イメージの一括レコードを使用して、イメージ広告拡張機能の 画像 を作成できます。 その後、返されたメディア識別子をイメージ資産 ID として使用できます。 追加したイメージの縦横比は、イメージ アセット subType でサポートされている必要があります。

サブタイプ

属性は subType 、この画像アセットの縦横比を表します。

アカウント レベルのメディア ライブラリに格納されている Image の真の縦横比は、結果として得られるサイズがサブタイプごとに予想される縦横比になる限り、異なる場合があります。 トリミング設定を指定しない場合、サービスはイメージの中央から可能な最大領域まで自動的にトリミングされます。 たとえば、1000x1000 ピクセル の画像では、1.91:1 縦横比の場合、自動トリミング設定は cropWidth=1000、 cropHeight=524、 cropX=0、 cropY=238 になります。

可能なサブタイプの値には、LandscapeImageMedia、SquareImageMedia、ImageMedia169X100、ImageMedia93X100、ImageMedia155X100、ImageMedia133X100、ImageMedia178X100、ImageMedia172X100 などがあります。 新しいサブタイプは将来追加される可能性があるため、固定値セットに依存しないようにしてください。

Sub Type	最小サイズ (ピクセル単位)
LandscapeImageMedia	幅 703 x 高さ 368 アスペクトラジオ 1.91:1
SquareImageMedia	幅 300 x 高さ 300 アスペクトラジオ 1:1
ImageMedia169X100	幅 622 x 高さ 368 アスペクトラジオ 1.69:1
ImageMedia93X100	幅 311 x 高さ 333 アスペクトラジオ 0.93:1
ImageMedia15X10	幅 300 x 高さ 200 アスペクトラジオ 1.5:1
ImageMedia155X100	幅 300 x 高さ 194 アスペクトラジオ 1.55:1
ImageMedia133X100	幅 100 x 高さ 75 アスペクトラジオ 1.33:1
ImageMedia178X100	幅 624 x 高さ 350 アスペクトラジオ 1.78:1
ImageMedia172X100	幅 300 x 高さ 174 アスペクトラジオ 1.72:1

追加： 必須。 各資産リンクには 、ID と subType のみが必要です。
更新： オプション。 既存のすべての資産リンクを保持するには、このフィールドを空のままにします。 このフィールドを設定すると、以前にこの広告にリンクされていた画像が置き換えられます。 このフィールドを設定する場合は、各資産リンクに id と subType のみが必要です。
削除： 読み 取り 専用

レイアウト

対象となるイメージ レイアウトの一覧。

サポートされる値は SearchSingle と SearchMultiple です。 今後、新しいレイアウトが追加される可能性があるため、固定の値セットに依存しないようにしてください。

一括ファイルでは、レイアウト文字列の一覧はセミコロン (;)で区切られます。

追加： オプション。 このフィールドを設定しない場合、現在および今後サポートされるすべてのレイアウトが既定で設定されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用

メディア ID

広告に含める画像の識別子。 同じ縦横比の複数の画像にメディア識別子を指定することはできません。 つまり、参照される各イメージの縦横比が異なる必要があります。

最大 4 つの イメージ 識別子を指定できます。 最低限必要なのは 1 つのイメージ メディア ID ですが、すべての広告配置を対象にするには、4 つのイメージ メディア識別子を指定する必要があります。

一括ファイルでは、メディア識別子の一覧はセミコロン (;)で区切られます。

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

モバイルの最終 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 エントリを参照してください。

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

Parent Id

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

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

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

発行元の国

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

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

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

開始日

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 に設定され、変更されるたびにインクリメントされます。

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