次の方法で共有

資産グループ レコード - 一括

  • [アーティクル]

一括ファイルでダウンロードおよびアップロードできる資産グループを定義します。

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

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

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

資産グループ

資産グループの名前。

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

ビジネス名

ビジネスの名前。

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

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

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

アクションの呼び出し

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

指定できる値は、ActNow、AddToCart、ApplyNow、Automated、BetNow、BidNow、BookACar、BookHotel、BookNow、BookTravel、Browse、BuildNow、BuyNow、ChatNow、 比較、ContactUs、Coupon、Dealers、Default、Directions、Donate、Download、EmailNow、RegisterNow、Explore、FileNow、FindJob、FindStore、FreePlay、FreeQuote、FreeTrial、GetDeals、GetDemo、GetNow、GetOffer、GetQuote、GoToDemo、Install、JoinNow、LearnMore、ListenNow、LogIn、Message、NewCars、NoButton、OpenLink、OrderNow、PlayGame、PlayNow、PlayNow PostJob、Register、RegisterNow、RenewNow、RentACar、RentNow、 並べ替え、予約、販売、SaveNow、Schedule、SeeDemo、SeeMenu、SeeModels、SeeMore、SeeOffer、SeeOffer、SeeOffer、SellNow、ShopNow、Showtimes、SignIn、SignUp、StartFree、StartNow、Subscribe、TestDrive、TryNow、Unknown、UsedCars、ViewDemo、ViewNow、ViewNow、ViewPlans、VisitSite、Visit、Store、VoteNow、Watch、WatchMore、WatchNow。

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

キャンペーン

資産グループを含むキャンペーンの名前。

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

注:

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

クライアント ID

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

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

説明

広告レイアウトの最適化Bing使用できる説明の一覧。

すべての広告フォーマットでインプレッションを最大化するために、広告に説明が常に表示されるとは限りません。

データ モデルの観点からは、説明はテキスト資産として格納されます。 同じアセットを複数の広告で使用できます。 たとえば、"シームレスインテグレーション" がテキストアセットの場合、同じ Microsoft Advertising アカウント内のすべての広告で同じアセット識別子が設定されます。

2 から 5 の説明を設定する必要があります。 説明は、一括ファイルで JSON 文字列として表されます。 以下の JSON の例には 2 つの説明が含まれており、最初の説明は特定の位置にピン留めされています。 と idtext はアセットのプロパティですが、 editorialStatus と assetPerformanceLabel はアセット リンクのプロパティです。つまり、アセットと広告の関係です。 詳細については、 assetPerformanceLabel、 editorialStatus、 id、および以下の テキスト を参照してください。

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

注:

コンマ区切りの一括ファイルでは、資産リンク、各属性キー、および各属性文字列値の一覧を二重引用符の追加セットで囲む必要があります。たとえば、上記の JSON 文字列は "[{"text":""Find New Customers & Sales!""},{"text":"Start Advertising on Contoso Today.""}" として書き込まれます。

一括ダウンロードの例を次に示します。ここでは、 id 読み取り専用の属性 (例: と editorialStatus) も取得します。

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

追加： 親キャンペーンがストアに関連付けられない場合は必須です。親キャンペーンがストアに関連付ける場合は省略可能です。 親キャンペーンがストアに関連付け、説明を指定する場合は、見出し、LongHeadlines、および画像も指定する必要があります。 テキストのみが受け入れられます。 資産がアカウントに既に存在する場合でも、 ID、 assetPerformanceLabel、 および editorialStatus は、含める場合は無視されます。
更新： オプション。 既存のすべての資産リンクを保持するには、このフィールドを空のままにします。 このフィールドを設定すると、以前にこの広告にリンクされていた説明が置き換えられます。 このフィールドを指定する場合は、2 から 5 の説明の一覧が必要です。 テキストのみが受け入れられます。 資産がアカウントに既に存在する場合でも、 ID、 assetPerformanceLabel、 および editorialStatus は、含める場合は無視されます。
削除： 読み 取り 専用

assetPerformanceLabel

これにより、資産のパフォーマンスを把握できます。

この assetPerformanceLabel 属性は、レスポンシブ検索広告をダウンロードした場合に読み取り専用になります。 使用可能な値については、次の表を参照してください。

値 説明
低 このアセットのパフォーマンスは低く、広告のパフォーマンスを向上させるには、このアセットを置き換えることをお勧めします。
Good この資産のパフォーマンスは良好です。 広告のパフォーマンスを向上させるには、このアセットを保持し、さらにアセットを追加することをお勧めします。
高 この資産のパフォーマンスは最高の資産の 1 つであり、同様の資産をさらに追加することをお勧めします。
未評価 この資産のパフォーマンス評価はありません。 これは、資産が非アクティブであること、そのパフォーマンスを判断するのに十分な情報がない、またはそれと比較するのに十分な類似の資産がない場合が原因である可能性があります。
Learning (学習) 資産のパフォーマンスは積極的に評価されています。 評価が完了すると、資産評価は低、良好、ベスト、または未評価になります。

editorialStatus

この editorialStatus 属性は、レスポンシブ検索広告をダウンロードした場合に読み取り専用になります。 使用可能な値については、次の表を参照してください。

値 説明
アクティブ アセットが編集レビューに合格しました。
ActiveLimited アセットは 1 つ以上の市場で編集レビューに合格し、資産の 1 つ以上の要素が別の市場で編集レビューを受けています。 たとえば、アセットはカナダの編集レビューに合格し、米国でレビューを保留中です。
不承認 アセットの編集レビューに失敗しました。
非アクティブ アセットの 1 つ以上の要素が編集レビュー中です。
不明 将来使用するために予約されています。

id

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

同じアセットを複数の広告で使用できます。 たとえば、"シームレスインテグレーション" がテキストアセットの場合、同じ Microsoft Advertising アカウント内のすべての広告で同じアセット識別子が設定されます。 テキストアセットをアップロードすると、アセットが新規であるか、アカウントのアセットライブラリに既に存在しているかに関係なく、 ""id:""123結果ファイルにアセット識別子 (例: ) が含まれます。

テキスト

各説明の text 属性には、少なくとも 1 つの単語が含まれている必要があります。 各説明 text の属性の最大入力長は 90 文字です。 二重幅文字を持つ言語 (繁体字中国語など) の場合、最大入力長は 45 文字です。 二重幅の文字は、キャンペーンまたは広告グループの言語設定の文字セットではなく、使用する文字によって決まります。 二重幅の文字には、韓国語、日本語、中国語の文字と絵文字が含まれます。

属性に text 改行 (\n) 文字を含めることはできません。

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

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

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

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

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

編集場所

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

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

編集理由コード

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

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

編集状態

資産グループの編集状態。

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

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

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

編集用語

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

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

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

終了日

資産グループの有効期限が切れる日付。

終了日を指定しない場合、資産グループの有効期限は切れなくなります。 終了日を延長して、資産グループの有効期限が切れた後でも、資産グループを配信の対象にすることができます。

終了日は包括的です。 たとえば、 終了日 を 2020 年 12 月 31 日に設定した場合、資産グループの有効期限は 2020 年 12 月 31 日午後 11 時 59 分です。 時間は、キャンペーン レベルで指定したタイム ゾーンに基づいています。

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

最終 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 も指定する必要があります。

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

見出し

広告レイアウトの最適化に使用できるBing見出しの一覧。

すべての広告フォーマットでパフォーマンスを最大化するために、広告に見出しが常に表示されるとは限りません。

データ モデルの観点からは、見出しはテキスト資産として格納されます。 同じアセットを複数の広告で使用できます。 たとえば、"シームレスインテグレーション" がテキストアセットの場合、同じ Microsoft Advertising アカウント内のすべての広告で同じアセット識別子が設定されます。

見出しは 3 から 15 の間で設定する必要があります。 見出しは、一括ファイルで JSON 文字列として表されます。 次の JSON の例には、2 つの見出しが含まれています。 と idtext はアセットのプロパティですが、 editorialStatus と assetPerformanceLabel はアセット リンクのプロパティです。つまり、アセットと広告の関係です。 詳細については、 assetPerformanceLabel、 editorialStatus、 id、および以下の テキスト を参照してください。

[{
	"text": "Contoso",
},
{
	"text": "Seamless Integration"
}]

注:

コンマ区切りの一括ファイルでは、資産リンク、各属性キー、および各属性値の一覧を二重引用符の追加セットで囲む必要があります(例: 上記の JSON 文字列は "{""text":"Contoso""},{"text":""シームレス統合""}" として書き込まれます。

一括ダウンロードの例を次に示します。ここでは、 id 読み取り専用の属性 (例: と editorialStatus) も取得します。

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

追加： 親キャンペーンがストアに関連付けられない場合は必須です。親キャンペーンがストアに関連付ける場合は省略可能です。 親キャンペーンがストアに関連付け、見出しを指定する場合は、LongHeadlines、説明、および画像も指定する必要があります。 テキストのみが受け入れられます。 資産がアカウントに既に存在する場合でも、 ID、 assetPerformanceLabel、 および editorialStatus は、含める場合は無視されます。
更新： オプション。 既存のすべての資産リンクを保持するには、このフィールドを空のままにします。 このフィールドを設定すると、以前にこの広告にリンクされていた見出しが置き換えられます。 このフィールドを指定する場合は、3 から 15 の見出しの一覧が必要です。 テキストのみが受け入れられます。 資産がアカウントに既に存在する場合でも、 ID、 assetPerformanceLabel、 および editorialStatus は、含める場合は無視されます。
削除： 読み 取り 専用

assetPerformanceLabel

これにより、資産のパフォーマンスを把握できます。

この assetPerformanceLabel 属性は、レスポンシブ検索広告をダウンロードした場合に読み取り専用になります。 使用可能な値については、次の表を参照してください。

値 説明
低 このアセットのパフォーマンスは低く、広告のパフォーマンスを向上させるには、このアセットを置き換えることをお勧めします。
Good この資産のパフォーマンスは良好です。 広告のパフォーマンスを向上させるには、このアセットを保持し、さらにアセットを追加することをお勧めします。
高 この資産のパフォーマンスは最高の資産の 1 つであり、同様の資産をさらに追加することをお勧めします。
未評価 この資産のパフォーマンス評価はありません。 これは、資産が非アクティブであること、そのパフォーマンスを判断するのに十分な情報がない、またはそれと比較するのに十分な類似の資産がない場合が原因である可能性があります。
Learning (学習) 資産のパフォーマンスは積極的に評価されています。 評価が完了すると、資産評価は低、良好、ベスト、または未評価になります。

editorialStatus

属性は editorialStatus 、レスポンシブ検索広告をダウンロードするときの読み取り専用文字列です。 使用可能な値については、次の表を参照してください。

値 説明
アクティブ アセットが編集レビューに合格しました。
ActiveLimited アセットは 1 つ以上の市場で編集レビューに合格し、資産の 1 つ以上の要素が別の市場で編集レビューを受けています。 たとえば、アセットはカナダの編集レビューに合格し、米国でレビューを保留中です。
不承認 アセットの編集レビューに失敗しました。
非アクティブ アセットの 1 つ以上の要素が編集レビュー中です。
不明 将来使用するために予約されています。

id

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

同じアセットを複数の広告で使用できます。 たとえば、"シームレスインテグレーション" がテキストアセットの場合、同じ Microsoft Advertising アカウント内のすべての広告で同じアセット識別子が設定されます。 テキストアセットをアップロードすると、アセットが新規であるか、アカウントのアセットライブラリに既に存在しているかに関係なく、 ""id:""123結果ファイルにアセット識別子 (例: ) が含まれます。

テキスト

各見出しの text 属性には、少なくとも 1 つの単語が含まれている必要があります。 各見出し text の属性の最大入力長は 30 文字です。 二重幅文字を持つ言語の場合 (繁体字中国語など)、最大入力長は 15 文字です。 二重幅の文字は、キャンペーンまたは広告グループの言語設定の文字セットではなく、使用する文字によって決まります。 二重幅の文字には、韓国語、日本語、中国語の文字と絵文字が含まれます。

属性に text 改行 (\n) 文字を含めることはできません。

Id

資産グループのシステム生成識別子。

追加： オプション。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

画像

サイズや縦横比が異なる複数の画像アセットを作成して、さまざまなパブリッシャーや配置に柔軟に表示できるようにします。

少なくとも 1 つの LandscapeImageMedia と 1 つの SquareImageMedia を提供する必要があります。 最大 20 個の画像と最大 5 つのロゴの合計を保存できます。

イメージ資産は、一括ファイルで JSON 文字列として表されます。 次の例の JSON には 9 つの画像が含まれており、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": "LandscapeLogoMedia",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 200,
	"cropHeight": 50
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 120,
	"cropHeight": 120
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"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": "ImageMedia1x2",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 500,
	"cropHeight": 1000
},
{
	"id": 1234567890000,
	"subType": "ImageMedia4x1",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1000,
	"cropHeight": 250
}]

注:

コンマ区切りの一括ファイルでは、アセット リンク、各属性キー、および各属性文字列値の一覧を、追加の二重引用符 (例: ) で囲む必要があります。 上記の JSON 文字列は "[{"id"":1234567890000,""subType":""LandscapeImageMedia""},{""id"":1234567890000,"subType":"SquareImageMedia"" として書き込まれます,""cropX"":286,""cropY":0,""cropWidth"":628,""cropHeight"":628},{""id""":1234567890000,""subType":""LandscapeLogoMedia",""cropX":70,""cropY":0,""cropWidth"":200,""cropHeight":50},{"id":1234567890000,,""subType":""SquareLogoMedia",""cropX":308,""cropY":0,""cropWidth"":120,"cropHeight"":120},{""id"":1234567890000,""subType"":"ImageMedia15X10"","cropX"":129,"cropY"":0,""cropWidth":942,"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"":"ImageMedia1X2"","cropX""::41,""cropY"":0,""cropWidth":500,""cropHeight"":1000},{""id"":1234567890000,"subType"":"""ImageMedia4X1"","cropX"":60,"cropY"":0,""cropWidth"":1000,""cropHeight":250}"。

追加： 親キャンペーンがストアに関連付けられない場合は必須です。親キャンペーンがストアに関連付ける場合は省略可能です。 親キャンペーンがストアに関連付け、画像を指定する場合は、見出し、LongHeadlines、およびディスクリプションも指定する必要があります。 各資産リンクには 、ID と subType のみが必要です。
更新： オプション。 既存のすべての資産リンクを保持するには、このフィールドを空のままにします。 このフィールドを設定すると、以前にこの広告にリンクされていた画像が置き換えられます。 このフィールドを設定する場合は、各資産リンクに id と subType のみが必要です。
削除： 読み 取り 専用

cropHeight

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

cropWidth

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

cropX

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

cropY

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

id

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

同じ画像アセット識別子は、異なる縦横比で同じ広告で複数回使用でき、同じ Microsoft Advertising アカウント内の複数の広告で使用することもできます。 画像の一括記録を使用して、レスポンシブ広告用の 画像 を作成できます。 その後、返されたメディア識別子をイメージ資産 ID として使用できます。 追加したイメージの縦横比は、イメージ アセット subType でサポートされている必要があります。

サブタイプ

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

アカウント レベルのメディア ライブラリに格納されている Image の真の縦横比は、結果として得られるサイズがサブタイプごとに予想される縦横比になる限り、異なる場合があります。

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

Sub Type 縦横比 最小サイズ (ピクセル単位)
LandscapeImageMedia 1.91:1 幅 703 x 高さ 368
SquareImageMedia 1:1 幅 300 x 高さ 300
LandscapeLogoMedia 4:1 幅 160 x 高さ 40
SquareLogoMedia 1:1 幅 40 x 高さ 40
ImageMedia15x10 1.5:1 幅 300 x 高さ 200
ImageMedia133x100 1.33:1 幅 100 x 高さ 75
ImageMedia178x100 1.78:1 幅 624 x 高さ 350
ImageMedia1x2 1:2 幅 470 x 高さ 940
ImageMedia4x1 4:1 幅 608 x 高さ 152

長い見出し

広告レイアウトの最適化に使用Bing長い見出しの一覧。

すべての広告フォーマットでパフォーマンスを最大化するために、広告に長い見出しが常に表示されるとは限りません。

データ モデルの観点から見ると、長い見出しはテキスト資産として格納されます。 同じアセットを複数の広告で使用できます。 たとえば、"シームレスインテグレーション" がテキストアセットの場合、同じ Microsoft Advertising アカウント内のすべての広告で同じアセット識別子が設定されます。

長い見出しを 1 ~ 5 個設定する必要があります。 長い見出しは、一括ファイルで JSON 文字列として表されます。 次の JSON の例には、2 つの長い見出しが含まれています。 と idtext はアセットのプロパティですが、 editorialStatus と assetPerformanceLabel はアセット リンクのプロパティです。つまり、アセットと広告の関係です。 詳細については、 assetPerformanceLabel、 editorialStatus、 id、および以下の テキスト を参照してください。

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

注:

コンマ区切りの一括ファイルでは、資産リンク、各属性キー、および各属性文字列値の一覧を二重引用符の追加セットで囲む必要があります。たとえば、上記の JSON 文字列は "[{"text":""Find New Customers & Sales!""},{"text":"Start Advertising on Contoso Today.""}" として書き込まれます。

一括ダウンロードの例を次に示します。ここでは、 id 読み取り専用の属性 (例: と editorialStatus) も取得します。

[{
	"id": 1,
	"text": "Find New Customers & Increase Sales!",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Start Advertising on Contoso Today",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

追加： 親キャンペーンがストアに関連付けられない場合は必須です。親キャンペーンがストアに関連付ける場合は省略可能です。 親キャンペーンがストアに関連付け、LongHeadlines を指定する場合は、見出し、説明、および画像も指定する必要があります。 テキストのみが受け入れられます。 資産がアカウントに既に存在する場合でも、 ID、 assetPerformanceLabel、 および editorialStatus は、含める場合は無視されます。
更新： オプション。 既存のすべての資産リンクを保持するには、このフィールドを空のままにします。 このフィールドを設定すると、以前にこの広告にリンクされていた見出しが置き換えられます。 このフィールドを指定する場合は、1 から 5 の見出しの一覧が必要です。 テキストのみが受け入れられます。 資産がアカウントに既に存在する場合でも、 ID、 assetPerformanceLabel、 および editorialStatus は、含める場合は無視されます。
削除： 読み 取り 専用

assetPerformanceLabel

これにより、資産のパフォーマンスを把握できます。

この assetPerformanceLabel 属性は、レスポンシブ検索広告をダウンロードした場合に読み取り専用になります。 使用可能な値については、次の表を参照してください。

値 説明
低 このアセットのパフォーマンスは低く、広告のパフォーマンスを向上させるには、このアセットを置き換えることをお勧めします。
Good この資産のパフォーマンスは良好です。 広告のパフォーマンスを向上させるには、このアセットを保持し、さらにアセットを追加することをお勧めします。
高 この資産のパフォーマンスは最高の資産の 1 つであり、同様の資産をさらに追加することをお勧めします。
未評価 この資産のパフォーマンス評価はありません。 これは、資産が非アクティブであること、そのパフォーマンスを判断するのに十分な情報がない、またはそれと比較するのに十分な類似の資産がない場合が原因である可能性があります。
Learning (学習) 資産のパフォーマンスは積極的に評価されています。 評価が完了すると、資産評価は低、良好、ベスト、または未評価になります。

editorialStatus

属性は editorialStatus 、レスポンシブ検索広告をダウンロードするときの読み取り専用文字列です。 使用可能な値については、次の表を参照してください。

値 説明
アクティブ アセットが編集レビューに合格しました。
ActiveLimited アセットは 1 つ以上の市場で編集レビューに合格し、資産の 1 つ以上の要素が別の市場で編集レビューを受けています。 たとえば、アセットはカナダの編集レビューに合格し、米国でレビューを保留中です。
不承認 アセットの編集レビューに失敗しました。
非アクティブ アセットの 1 つ以上の要素が編集レビュー中です。
不明 将来使用するために予約されています。

id

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

同じアセットを複数の広告で使用できます。 たとえば、"シームレスインテグレーション" がテキストアセットの場合、同じ Microsoft Advertising アカウント内のすべての広告で同じアセット識別子が設定されます。 テキストアセットをアップロードすると、アセットが新規であるか、アカウントのアセットライブラリに既に存在しているかに関係なく、 ""id:""123結果ファイルにアセット識別子 (例: ) が含まれます。

テキスト

各長い見出しの text 属性には、少なくとも 1 つの単語が含まれている必要があります。 各ヘッドライン text の属性の最大入力長は 90 文字です。 二重幅文字を持つ言語 (繁体字中国語など) の場合、最大入力長は 45 文字です。 二重幅の文字は、キャンペーンまたは広告グループの言語設定の文字セットではなく、使用する文字によって決まります。 二重幅の文字には、韓国語、日本語、中国語の文字と絵文字が含まれます。

属性に text 改行 (\n) 文字を含めることはできません。

モバイルの最終 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 も指定する必要があります。

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

変更時刻

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

注:

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

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

Parent Id

資産グループを含むキャンペーンのシステム生成識別子。

この一括フィールドは、キャンペーン レコードの Id フィールドにマップされます。

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

注:

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

パス 1

表示 URL のドメイン部分に追加される省略可能なパスの最初の部分。 表示 URL のドメイン部分 (たとえば、最終 URL フィールド) のドメインから生成されます。 https://www.contoso.com パス 1 の値を指定した場合は、表示 URL に追加されます。 パス 2 の値も指定している場合は、パス 1 の後の表示 URL にも追加されます。 たとえば、 最終 URL に が含まれている https://www.contoso.com場合、 パス 1 が サブディレクトリ 1 に設定され、 Path 2 が サブディレクトリ 2 に設定されている場合、表示される URL は になります https://www.contoso.com/subdirectory1/subdirectory2。

パスには、{MatchType} などの動的パラメーターを含めることができます。 サポートされているパラメーターの一覧については、Microsoft Advertising のヘルプ記事「 どのような追跡パラメーターまたは URL パラメーターを使用できますか?」を参照してください。

動的テキスト文字列を含める場合、最大入力長は 1,000 文字です。 入力できる最終的な (ダイナミック テキストではない) 文字は 15 文字以下です。 広告の表示に失敗するか、最終的な URL ドメインの長さと組み合わされたパスが 67 文字を超える場合は 、既定のテキスト が使用されます。

二重幅文字を持つ言語 (繁体字中国語など) の場合、動的テキスト文字列を含める場合、最大入力長は 1,000 文字です。 入力できる最終 (ダイナミック テキストではない) 文字は 7 文字以下です。 広告が表示されないか、最終的な URL ドメインの長さと組み合わされたパスが 33 文字を超える場合は 、既定のテキスト が使用されます。 二重幅の文字は、キャンペーンまたはアセット グループの言語設定の文字セットの代わりに使用する文字によって決まります。 二重幅の文字には、韓国語、日本語、中国語の文字と絵文字が含まれます。

パスにスラッシュ (/) 文字または改行 (\n) 文字を含めることはできません。

パスにスペースが含まれている場合、広告が表示されるときにアンダースコア (_) に置き換えられます。

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

パス 2

表示 URL のドメイン部分に追加される省略可能なパスの 2 番目の部分。 表示 URL のドメイン部分 (たとえば、最終 URL フィールド) のドメインから生成されます。 https://www.contoso.com パス 1 の値を指定した場合は、表示 URL に追加されます。 パス 2 の値も指定している場合は、パス 1 の後の表示 URL にも追加されます。 たとえば、 最終 URL に が含まれている https://www.contoso.com場合、 パス 1 が サブディレクトリ 1 に設定され、 Path 2 が サブディレクトリ 2 に設定されている場合、表示される URL は になります https://www.contoso.com/subdirectory1/subdirectory2。

パス 1 も設定されている場合にのみ、パス 2 を指定できます。

パスには、{MatchType} などの動的パラメーターを含めることができます。 サポートされているパラメーターの一覧については、Microsoft Advertising のヘルプ記事「 どのような追跡パラメーターまたは URL パラメーターを使用できますか?」を参照してください。

動的テキスト文字列を含める場合、最大入力長は 1,000 文字です。 入力できる最終的な (ダイナミック テキストではない) 文字は 15 文字以下です。 広告の表示に失敗するか、最終的な URL ドメインの長さと組み合わされたパスが 67 文字を超える場合は 、既定のテキスト が使用されます。

二重幅文字を持つ言語 (繁体字中国語など) の場合、動的テキスト文字列を含める場合、最大入力長は 1,000 文字です。 入力できる最終 (ダイナミック テキストではない) 文字は 7 文字以下です。 広告が表示されないか、最終的な URL ドメインの長さと組み合わされたパスが 33 文字を超える場合は 、既定のテキスト が使用されます。 二重幅の文字は、キャンペーンまたはアセット グループの言語設定の文字セットの代わりに使用する文字によって決まります。 二重幅の文字には、韓国語、日本語、中国語の文字と絵文字が含まれます。

パスにスラッシュ (/) 文字または改行 (\n) 文字を含めることはできません。

パスにスペースが含まれている場合、広告が表示されるときにアンダースコア (_) に置き換えられます。

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

状態

資産グループの状態。

使用可能な値は、 アクティブ、 削除、 期限切れ、または 一時停止です。 期限切れの状態は読み取り専用です。

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

開始日

資産グループが提供を開始できる日付。それ以外の場合、サービスは資産グループがアクティブになった日に資産グループの提供を開始できます。

開始日は包括的です。 たとえば、 開始日 を 2020 年 5 月 5 日に設定した場合、資産グループは 2020 年 5 月 5 日の午前 12 時 00 分に開始されます。 時間は、キャンペーン レベルで指定したタイム ゾーンに基づいています。

追加： オプション。 このフィールドを設定しない場合、または送信した日付が今日の日付より前の場合は、今日の日付が設定され、資産グループの状態がアクティブになるとすぐにサービスが資産グループの提供を開始できます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 開始日は、資産グループが送信された後、つまり開始日が到着した後は更新できません。
削除： 読み 取り 専用