レスポンシブ広告レコード - 一括
一括ファイルでダウンロードおよびアップロードできるレスポンシブ広告を定義します。
レスポンシブ広告は、オーディエンス広告フォーマットのサイズと形状に合わせて自動的に調整されます。 これらの広告は、行動を呼び出すのではなく、有益なテキストで最適に機能します。
注:
この機能は現在、米国、カナダ、英国、オーストラリアで利用できます。 米国、カナダ、英国、オーストラリアで広告を掲載し、オーディエンス広告をオプトインする場合は、サポートにお問い合わせください。
注:
重複するレスポンシブ広告は、同じ広告グループで許可されます。
アカウント内のすべてのレスポンシブ広告レコードをダウンロードする場合は、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
- テキスト
- 追跡テンプレート
広告グループ
広告を含む広告グループの名前。
追加: 読み取り専用と必須
更新: 読み取り専用と必須
削除: 読み取り専用と必須
ビジネス名
ビジネスの名前。
対象ユーザーの広告の配置によっては、ビジネス名が広告に表示される場合があります。
文字列の長さは 25 文字に制限されています。
追加: 必須
更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除: 読み 取り 専用
アクションの呼び出し
顧客が今すぐ広告をクリックする簡単でパンチの効く理由。
指定できる値は、AddToCart、ApplyNow、BookTravel、Buy、BuyNow、ContactUs、Download、GetQuote、Install、LearnMore、NoButton、OpenLink、OrderNow、RegisterNow、SeeMore、ShopNow、SignUp、Subscribe、VisitSite です。
追加: 対象ユーザー広告には適用されません。
更新: 読み 取り 専用
削除: 読み 取り 専用
キャンペーン
広告グループと広告を含むキャンペーンの名前。
追加: 読み 取り 専用
更新: 読み 取り 専用
削除: 読み 取り 専用
クライアント 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 キーワード (keyword)では、前の設定が削除されます。 カスタム パラメーターのサブセットを削除するには、保持するカスタム パラメーターを指定し、保持しないパラメーターを省略します。 カスタム パラメーターの新しいセットは、以前のカスタム パラメーター セットに置き換えられます。
削除: 読み 取り 専用
説明
対象ユーザーの広告の配置に応じて、このテキストは広告の長い見出しまたは短い見出しの下または隣に表示されます。
広告テキストでは、見出しよりも多くの文字領域を使用できます。 そのため、画像と見出しが潜在的な顧客の注意を引いたら、広告テキストでクリックするよう誘導する必要があります。 製品またはサービスの違いは何ですか?
テキストには、少なくとも 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 は、キーワード (keyword)で最終 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": "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":"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 は 、同じ広告にリンクされている画像アセットの中で一意である必要はありません。
- この例の広告は 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 になります。
指定できるサブタイプの値には、OriginalImage、LandscapeImageMedia、SquareImageMedia、ImageMedia4x1、ImageMedia1x2、ImageMedia169X100、ImageMedia201X100、ImageMedia120X100、ImageMedia124X100、ImageMedia153X100 などがあります。 新しいサブタイプは将来追加される可能性があるため、固定値セットに依存しないようにしてください。
Sub Type | 縦横比 | 最小サイズ (ピクセル単位) |
---|---|---|
OriginalImage | 該当なし | 幅 703 x 高さ 368 |
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 は、キーワード (keyword)で Mobile Final URL が指定されていない場合にのみ使用されます。
追加: オプション
更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除: 読み 取り 専用
変更時刻
エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。
注:
日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
追加: 読み 取り 専用
更新: 読み 取り 専用
削除: 読み 取り 専用
Parent Id
広告を含む広告グループのシステム生成識別子。
この一括フィールドは、広告グループ レコードの Id フィールドにマップされます。
追加: 読み取り専用と必須。 既存の広告グループ識別子を指定するか、親広告グループ レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイル内の新しい広告グループに新しい広告を追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新: 読み 取り 専用
削除: 読み 取り 専用
発行元の国
編集ガイドラインで指定した 用語が許可されていない発行元の国または地域の一覧。
一括ファイルでは、発行元の国またはリージョンの一覧はセミコロン (;)で区切られます。
追加: 読み 取り 専用
更新: 読み 取り 専用
削除: 読み 取り 専用
状態
広告の状態。
使用可能な値は、 アクティブ、 一時停止、または 削除です。
追加: オプション。 既定値は [アクティブ] です。
更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除: 必須。 [状態] を [削除済み] に設定する必要があります。
Square Image Media Id
オーディエンス広告に表示される可能性がある縦横比が 1:1 の正方形の画像に使用される画像アセットの識別子。
保存された画像メディアの縦横比は、画像アセットのトリミング設定によってこのフィールドの縦横比がサポートされている限り、異なる場合があります。 トリミング設定で有効な縦横比を確認するには、[ 画像 ] フィールドを使用します。
注:
Bing Ads API バージョン 12 では 、横長画像メディア ID と SquareImageMediaId を使用できますが、これらのフィールドは非推奨となり、今後のバージョンで削除される予定です。 [ イメージ ] フィールドを使用すると、トリミングされた画像の柔軟性と制御が向上します。
追加: オプション。 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}
、キャンペーン、広告グループ、条件、キーワード (keyword)、または広告レベルで {_season} または {_promocode} が定義されていない場合、ランディング ページの URL は同じになります。
追加: オプション
更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除: 読み 取り 専用