レスポンシブ広告レコード - 一括

[アーティクル]
07/27/2024

一括ファイルでダウンロードおよびアップロードできるレスポンシブ広告を定義します。

レスポンシブ広告は、オーディエンス広告フォーマットのサイズと形状に合わせて自動的に調整されます。これらの広告は、行動を呼び出すのではなく、有益なテキストで最適に機能します。

注:

この機能は現在、米国、カナダ、英国、オーストラリアで利用できます。米国、カナダ、英国、オーストラリアで広告を掲載し、オーディエンス広告をオプトインする場合は、サポートにお問い合わせください。

注:

重複するレスポンシブ広告は、同じ広告グループで許可されます。

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

次の一括 CSV の例では、有効な親 ID 値が指定されている場合に、新しいレスポンシブ広告を追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Sync Time,Client Id,Modified Time,Tracking Template,Final Url Suffix,Custom Parameter,Final Url,Mobile Final Url,Text,Business Name,Device Preference,Ad Format Preference,Name,Call To Action,Headline,Long Headline,Images
Format Version,,,,,,,,,,,,,,,,,,6.0,,,,
Responsive Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,Contoso,,,,,Short Headline Here,Long Headline Here,"[{""id"":1234567890000,""subType"":""LandscapeImageMedia""}]"

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkResponsiveAd
var bulkResponsiveAd = new BulkResponsiveAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ResponsiveAd object of the Campaign Management service.
    ResponsiveAd = new ResponsiveAd
    {
        // 'Call To Action' column header in the Bulk file
        CallToAction = CallToAction.AddToCart,
        // '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"
        },
        // '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"
        },
        // 'Headline' column header in the Bulk file
        Headline = "Short Headline Here",
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Images' column header in the Bulk file
        Images = new[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new ImageAsset
                {
                    CropHeight = null,
                    CropWidth = null,
                    CropX = null,
                    CropY = null,
                    Id = landscapeImageMediaId,
                    SubType = "LandscapeImageMedia"
                },
            },
        },
        // 'Long Headline' column header in the Bulk file
        LongHeadlineString = "Long Headline Here",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // '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"
                },
            }
        },
    },
};

uploadEntities.Add(bulkResponsiveAd);

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

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

レスポンシブ広告レコードの場合、一括ファイルスキーマでは、次の属性フィールドを使用できます。

広告グループ
ビジネス名
アクションの呼び出し
アクションへの呼び出し言語
Campaign
クライアント ID
カスタムパラメーター
説明
編集上の申し立てステータス
編集場所
編集理由コード
編集状態
編集用語
最終 URL
見出し
見出し
最終 URL サフィックス
Id
Images
インプレッショントラッキング URL
横長画像メディア ID
横向きロゴメディア ID
長い見出し
長い見出し
長い見出し文字列
モバイルの最終 URL
変更時刻
Parent Id
発行元の国
状態
Square Image Media Id
Square ロゴメディア ID
テキスト
追跡テンプレート

広告グループ

広告を含む広告グループの名前。

足す： 読み取り専用と必須
更新： 読み取り専用と必須
削除： 読み取り専用と必須

注:

追加、更新、削除を行うには、[ 親 ID ] フィールドまたは [ 広告グループ ] フィールドを指定する必要があります。

ビジネス名

ビジネスの名前。

対象ユーザーの広告の配置によっては、ビジネス名が広告に表示される場合があります。

文字列の長さは 25 文字に制限されています。

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

アクションの呼び出し

顧客が今すぐ広告をクリックする簡単でパンチの効く理由。

検索マルチメディア広告で使用できるアクションの呼び出しを次に示します。

実施すべき内容
今すぐ行動する
今すぐ適用
今すぐベットする
今すぐ入札
車を予約する
ホテル予約
今すぐ予約
今すぐビルド
今すぐ購入
今すぐチャットする
比較
お問い合わせ
ディーラー
経路
寄付する
ダウンロード
今すぐメールを送信する
今すぐ登録
ファイルを今すぐ開く
ジョブの検索
ストアの検索
無料プレイ
無料見積もり
無料試用版
クーポンを取得する
取引を取得する
デモを入手する
今すぐ入手
オファーを取得する
見積もりを取得する
デモに移動
今すぐ登録
さらに詳しくは
今すぐ聞く
ログイン
今すぐ注文
ゲームをプレイする
今すぐプレイ
ジョブのポスト
登録
今すぐ更新
レンタカーを借りる
今すぐレンタル
並べ替える
予約する
今すぐ保存
Schedule
デモを参照する
メニューを表示する
モデルを参照する
オファーを表示する
オファーを表示する
販売を見る
今すぐ販売
今すぐ購入
Showtimes
サインイン
サインアップ
今すぐ開始します
Subscribe
体験版
今すぐ試す
車を表示する
デモを表示する
プランを表示する
ストアにアクセスする
今すぐ投票
視聴する
詳細を見る
今すぐ見る

足す： 対象ユーザー広告には適用されません。
更新： 読み取り専用
削除： 読み取り専用

Call To Action Langauge

アクションの呼び出しが提供される言語。

アクションの呼び出しは、キャンペーンの言語設定に関係なく、常にこの言語で配信されます。

検索マルチメディア広告で利用できる行動喚起言語を次に示します。

実施すべき内容
Language.アルバニア語
Language.アラビア語
Language.ボスニア語
Language.ブルガリア語
Language.Croatian
Language.Czech
Language.デンマーク語
Language.Dutch
Language.English
Language.エストニア語
Language.Finnish
Language.French
Language.Germany
Language.Greek
Language.ヘブライ語
Language.ハンガリー語
Language.アイスランド語
Language.Italian
Language.Japanese
Language.ラトビア語
Language.リトアニア語
Language.マケドニア語
Language.マルタ語
Language.ノルウェー語
Language.Polish
Language.Portuguese
Language.ルーマニア語
Language.Russian
Language.セルビア語
Language.Slovak
Language.スロベニア語
Language.Spanish
Language.Swedish
Language.TraditionalChinese
Language.トルコ語

足す： 対象ユーザー広告には適用されません。マルチメディア広告には必須です。
更新： 随意。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

キャンペーン

広告グループと広告を含むキャンペーンの名前。

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

クライアント ID

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

足す： 随意
更新： 随意
削除： 読み取り専用

カスタムパラメーター

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

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

各カスタムパラメーターペアを Key=Value (例: {_promoCode}=PROMO1) として書式設定します。
Microsoft Advertising は、含める最初の 8 つのカスタムパラメーターキーと値のペアを受け入れ、8 つ以上のカスタムパラメーターを含める場合はエラーが返されます。各キーと値のペアは、セミコロンとスペース ("; ") で区切られます (例: {_promoCode}=PROMO1;{_season}=summer.
Key にはセミコロンを含めることはできません。 Value にセミコロンが含まれている場合は、'\;' としてエスケープする必要があります。さらに、Value に円記号が含まれている場合は、'\' としてもエスケープする必要があります。
キーは 16 UTF-8 バイトを超えることはできません。値は 250 UTF-8 バイトを超えることはできません。キーは必須であり、値は省略可能です。 Key の最大サイズには、中かっことアンダースコア ('{'、'_'、'}' は含まれません。

注:

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

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

説明

対象ユーザーの広告の配置に応じて、このテキストは広告の長い見出しまたは短い見出しの下または隣に表示されます。

広告テキストでは、見出しよりも多くの文字領域を使用できます。そのため、画像と見出しが潜在的な顧客の注意を引いたら、広告テキストでクリックするよう誘導する必要があります。製品またはサービスの違いは何ですか?

テキストには、少なくとも 1 つの単語が含まれている必要があります。

説明の上限は 5 です。文字列の長さは 90 文字に制限されています。見出しのデータ形式は、次の JSON の例に含まれています。

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

足す： 対象ユーザー広告とマルチメディア広告に必要です。動画広告には適用されません。 更新： 随意。更新プログラムに値が設定されていない場合、この設定は変更されません。 削除： 読み取り専用

編集上の申し立てステータス

編集レビューで見つかった問題に異議を申し立てることができるかどうかを判断します。

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

値	説明
上訴可能	編集上の問題は申し立て可能です。
異議申し立て中	編集上の問題は控訴可能であり、控訴が提出されました。
NotAppealable	編集上の問題は不服として申し立てられない。

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

編集場所

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

編集理由コード

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

編集状態

広告の編集状態。

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

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

編集用語

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

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

最終 URL

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

パス 1 およびパス 2 の文字列と組み合わせた URL のドメイン部分は、67 文字を超えることはできません。

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

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

また、[ 追跡テンプレート ] フィールドまたは [カスタムパラメーター] フィールドが設定されている場合は、少なくとも 1 つの最終 URL が必要であることに注意してください。

注:

この URL は、キーワードで最終 URL が指定されていない場合にのみ使用されます。

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

最終 URL サフィックス

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

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

見出し

これは、動画広告に表示される可能性のある 2 つの見出しのうちの 1 つです。

動画広告は応答性が高いため、さまざまなパブリッシャーやプレースメントで柔軟に配信できるように、複数の見出しが必要です。

文字列の長さは 30 文字に制限されています。

足す： 動画広告には必須です。マルチメディア広告やオーディエンス広告には適用されません。 更新： 随意。マルチメディア広告とオーディエンス広告では非推奨になりました。代わりに見出しを使用します。
削除： 読み取り専用

見出し

オーディエンス広告は応答性が高いため、さまざまなパブリッシャーやプレースメントで柔軟に配信できるように、複数の見出しが必要です。

見出しの上限は 15 です。また、各見出しの長さは 30 文字に制限されています。見出しのデータ形式は、次の JSON の例に含まれています。

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

足す： マルチメディア広告とオーディエンス広告には必須です。動画広告には適用されません。 更新： 随意。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

Id

広告のシステム生成識別子。

足す： 随意。このフィールドは空のままにするか、負の識別子を指定する必要があります。その後、広告の負の識別子セットは、レスポンシブ広告ラベルなどの依存レコードタイプの [親 ID] フィールドで参照できます。これは、同じ Bulk ファイルに新しい広告と新しい依存レコードを追加する場合に推奨されます。詳細については、「一括ファイルスキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

画像

オーディエンス広告は応答性が高いため、サイズや縦横比が異なる複数の画像アセットを作成して、さまざまなパブリッシャーやプレースメントに柔軟に表示できます。

注:

現時点では、SubType OriginalImage は、対象ユーザーキャンペーンのレスポンシブアドの既定のイメージとしての LandscapeImageMedia の役割に置き換えられます。

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

注:

このフィールドが (空ではない) 設定されている場合、横長画像メディア ID と正方形のイメージメディア ID はどちらも無視されます。

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

[{
	"id": 1234567890000,
	"subType": "OriginalImage"
},
{
	"id": 1234567890000,
	"subType": "LandscapeLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 512,
	"cropHeight": 128
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 128,
	"cropHeight": 128
},
{
	"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"":"OriginalImage""},{""id"":1234567890000,"subType":""LandscapeLogoMedia"として書き込まれます ",""cropX"":0,""cropY":0,""cropWidth"":512,""cropHeight"":128},{"id""":1234567890000,""subType":""SquareLogoMedia",""cropX":0,"cropY"":0,"cropWidth"":128,""cropHeight"":128},{"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":6288},{""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 は、同じ広告にリンクされている画像アセットの中で一意である必要はありません。
この例の広告は OriginalImage イメージアセットのサブタイプのトリミング設定なしで作成されたため、OriginalImage に関連付けられているイメージを除くすべての画像アセットがトリミングされます。
OriginalImage に独自のトリミング設定があるかどうかに関係なく、Microsoft Advertising では、既定のすべてのトリミング設定に OriginalImage に関連付けられているイメージの真の高さが使用されます。この例では、システムで生成されたすべてのイメージアセットのトリミングの高さは 628 で、縦横比が 1.91:1 の OriginalImage (OriginalImage サブタイプ) の幅と高さが 1200x628 であると推測できます。 OriginalImage アセットリンクがトリミング設定 (703x368 など) で作成されていた場合でも、自動生成されたイメージアセットのトリミング設定は、OriginalImage の完全なサイズ (この例では 1200x628) に基づきます。
Bing Ads API バージョン 12 では、横長画像メディア ID と Square Image Media Id を使用できますが、これらのフィールドは非推奨となり、今後のバージョンでは削除される予定です。 [ イメージ ] フィールドを使用すると、トリミングされた画像の柔軟性と制御が向上します。

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 になります。

画像が広告に "LandscapeLogoMedia" または "SquareLogoMedia" として関連付けられている場合は、サブタイプを "ロゴ" に設定する必要があります。

指定できるサブ型の値には、OriginalImage、LandscapeLogoMedia、SquareLogoMedia、LandscapeImageMedia、SquareImageMedia、ImageMedia4x1、ImageMedia1x2、ImageMedia169X100、ImageMedia201X100、ImageMedia120X100、ImageMedia124X100、ImageMedia153X100 などがあります。新しいサブタイプは将来追加される可能性があるため、固定値セットに依存しないようにしてください。

Sub Type	縦横比	最小サイズ (ピクセル単位)
OriginalImage	該当なし	幅 703 x 高さ 368
LandscapeLogoMedia	4:1	幅 512 x 高さ 128
SquareLogoMedia	1:1	幅 128 x 高さ 128
LandscapeImageMedia	1.91:1	幅 300 x 高さ 157
SquareImageMedia	1:1	幅 114 x 高さ 114
ImageMedia4x1	4:1	幅 608 x 高さ 152
ImageMedia1x2	1:2	幅 470 x 高さ 940
ImageMedia201X100	2.01:1	幅 612 x 高さ 304
ImageMedia120X100	1.2:1	幅 300 x 高さ 250
ImageMedia200X100	2:1	幅 200 x 高さ 100
ImageMedia169X100	1.69:1	幅 628 x 高さ 372
ImageMedia124X100	1.24:1	幅 104 x 高さ 84
ImageMedia153X100	1.53:1	幅 306 x 高さ 200

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

インプレッショントラッキング URL

1x1 インプレッショントラッキングピクセルの URL。各ピクセルは、Microsoft Audience Network のインプレッションをサードパーティの広告レポートツールに報告します。

レスポンシブ広告ごとに最大 2 つのインプレッショントラッキング URL を含めることができます。各 URL は、セミコロンとスペース ("; ") で区切られます。

各 URL にアクセスできる必要があります。 URL の長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。

Microsoft Audience Network インプレッションごとに、Microsoft は URL に ping を実行して、サードパーティの広告レポートツールでインプレッショントラッキングを有効にします。 Cookie や IP アドレスに基づくコンバージョンの追跡や追跡など、高度なユーザー追跡はサポートされていません。

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

横長画像メディア ID

1.91:1 アスペクト比の横長画像に使用される画像アセットの識別子で、オーディエンス広告に表示される可能性があります。

保存された画像メディアの縦横比は、画像アセットのトリミング設定によってこのフィールドの縦横比がサポートされている限り、異なる場合があります。トリミング設定で有効な縦横比を確認するには、[ 画像 ] フィールドを使用します。

注:

Bing Ads API バージョン 12 では、横長画像メディア ID と SquareImageMediaId を使用できますが、これらのフィールドは非推奨となり、今後のバージョンで削除される予定です。 [ イメージ ] フィールドを使用すると、トリミングされた画像の柔軟性と制御が向上します。

足す：イメージが設定されていない場合は必須です。 Images が設定されている場合、このフィールドは無視されます。
更新： 随意。 Images が設定されている場合、このフィールドは無視されます。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

横向きロゴメディア ID

このフィールドは内部使用のために予約されており、Bing Ads API の将来のバージョンから削除されます。

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

長い見出し

これは、オーディエンス広告に表示される可能性のある 2 つの見出しのうちの 1 つです。

オーディエンス広告は応答性が高いため、さまざまなパブリッシャーやプレースメントで柔軟に配信できるように、複数の見出しが必要です。

文字列の長さは 90 文字に制限されています。

足す： 必須
更新： 廃止。代わりに長い見出しを使用します。
削除： 読み取り専用

長い見出し

オーディエンス広告は応答性が高いため、さまざまなパブリッシャーやプレースメントで柔軟に配信できるように、複数の見出しが必要です。

長い見出しの上限は 5 です。また、各見出しの長さは 90 文字に制限されています。長い見出しのデータ形式は、次の JSON の例に含まれています。

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

長い見出し文字列

見出しは広告に表示される最も目立つテキストであるため、使用可能な文字を最大限に活用する必要があります。オーディエンス広告は応答性が高いため、さまざまなパブリッシャーやプレースメントで柔軟に配信できるように、複数の見出しが必要です。

各見出しの長さは 90 文字に制限されています。長い見出しのデータ形式は、次の JSON の例に含まれています。

[{
	"text": "Contoso",
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

足す： オーディエンス広告と動画広告には必須です。マルチメディア広告には適用されません。 更新： 随意。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

モバイルの最終 URL

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

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

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

注:

この URL は、キーワードで Mobile Final URL が指定されていない場合にのみ使用されます。

変更時刻

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

注:

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

Parent Id

広告を含む広告グループのシステム生成識別子。

この一括フィールドは、広告グループレコードの Id フィールドにマップされます。

足す： 読み取り専用と必須。既存の広告グループ識別子を指定するか、親広告グループレコードの Id フィールドと等しい負の識別子を指定する必要があります。これは、同じ Bulk ファイル内の新しい広告グループに新しい広告を追加する場合に推奨されます。詳細については、「一括ファイルスキーマ参照キー」を参照してください。
更新： 読み取り専用
削除： 読み取り専用

注:

追加、更新、削除を行うには、[ 親 ID ] フィールドまたは [ 広告グループ ] フィールドを指定する必要があります。

発行元の国

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

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

状態

広告の状態。

使用可能な値は、 アクティブ、 一時停止、または 削除です。

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

Square Image Media Id

オーディエンス広告に表示される可能性がある縦横比が 1:1 の正方形の画像に使用される画像アセットの識別子。

注:

足す： 随意。 Images が設定されている場合、このフィールドは無視され、Microsoft Advertising は LandscapeImageMedia イメージアセットをトリミングすることで新しい正方形の画像アセットを自動的に作成します。 Images が設定されていない場合、このフィールドを設定しない場合、Microsoft Advertising は、横長画像メディア ID をトリミングすることで、新しい正方形の画像アセットを自動的に作成します。
更新： 随意。 Images が設定されている場合、このフィールドは無視され、Microsoft Advertising は LandscapeImageMedia イメージアセットをトリミングすることで新しい正方形の画像アセットを自動的に作成します。 Images が設定されていない場合、このフィールドを設定しない場合、Microsoft Advertising は、横長画像メディア ID をトリミングすることで、新しい正方形の画像アセットを自動的に作成します。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

Square ロゴメディア ID

このフィールドは内部使用のために予約されており、Bing Ads API の将来のバージョンから削除されます。

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

テキスト

動画広告の配置に応じて、このテキストは広告の長い見出しまたは短い見出しの下または隣に表示されます。

テキストには、少なくとも 1 つの単語が含まれている必要があります。

文字列の長さは 90 文字に制限されています。

テキストに改行 (\n) 文字を含めることはできません。

足す： 動画広告には必須です。対象ユーザー広告やマルチメディア広告には適用されません。 更新： ビデオ広告の場合は省略可能です。代わりに、対象ユーザー広告またはマルチメディア広告に説明を使用します (非推奨)。
削除： 読み取り専用

追跡テンプレート

FinalUrls で指定された 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 は同じになります。

次の方法で共有

レスポンシブ広告レコード - 一括

広告グループ

ビジネス名

アクションの呼び出し

Call To Action Langauge

キャンペーン

クライアント ID

カスタム パラメーター

説明

編集上の申し立てステータス

編集場所

編集理由コード

編集状態

編集用語

最終 URL

最終 URL サフィックス

見出し

見出し

Id

画像

cropHeight

cropWidth

cropX

cropY

id

サブタイプ

インプレッション トラッキング URL

横長画像メディア ID

横向きロゴ メディア ID

長い見出し

長い見出し

長い見出し文字列

モバイルの最終 URL

変更時刻

Parent Id

発行元の国

状態

Square Image Media Id

Square ロゴ メディア ID

テキスト

追跡テンプレート

フィードバック

その他のリソース

カスタムパラメーター

インプレッショントラッキング URL

横向きロゴメディア ID

Square ロゴメディア ID