次の方法で共有

ResponsiveAd データ オブジェクト - キャンペーン管理

  • [アーティクル]

対象ユーザー広告とマルチメディア広告のレスポンシブ広告形式ト。

ResponsiveAd オブジェクトは、検索ネットワーク内の マルチメディア広告 と Microsoft Audience Network の オーディエンス広告 の両方に使用されます。 主要な差別化要因の詳細については、以下の 「解説 」セクションを参照してください。

注:

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

構文

<xs:complexType name="ResponsiveAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
        <xs:element minOccurs="0" name="CallToActionLanguage" nillable="true" type="tns:LanguageName" />
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Headline" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImpressionTrackingUrls" nillable="true" type="q4:ArrayOfstring">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="LongHeadline" nillable="true" type="tns:AssetLink" />
        <xs:element minOccurs="0" name="LongHeadlineString" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="VerifiedTrackingSettings" nillable="true" type="tns:VerifiedTrackingSetting">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Videos" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

ResponsiveAd オブジェクトには、BusinessName、CallToAction、CallToActionLanguage、Descriptions、Headline、Headline、Images、ImpressionTrackingUrls、LongHeadline、LongHeadlines、LongHeadlineString、Text、VerifiedTrackingSettings、Videos という要素があります。

要素 説明 データ型
BusinessName ビジネスの名前。

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

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

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 string
CallToAction 顧客が今すぐ広告をクリックする簡単でパンチの効く理由。

これは、アクションの呼び出しボタンに表示されます。

追加： 対象ユーザー広告には適用されません。マルチメディア広告に必要
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 CallToAction
CallToActionLanguage アクションの呼び出しが提供される言語。

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

追加： 対象ユーザー広告には適用されません。マルチメディア広告に必要
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 LanguageName
説明 広告のパスの下に表示される説明。 すべての広告フォーマットでインプレッションを最大化するために、広告に説明が常に表示されるとは限りません。

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

いずれかの説明を特定の位置に ピン留め しない限り、Bingはユーザーの検索クエリに最適な見出しと説明で広告レイアウトを動的に最適化します。

データ モデルの観点から見ると、デスリプションとヘッドラインはそれぞれテキストアセット (AssetLink ごとに 1 つの TextAsset) として格納されます。 同じアセットを複数の広告で使用できます。 たとえば、"シームレスインテグレーション" がテキストアセットの場合、同じ Microsoft Advertising アカウント内のすべての広告で同じアセット識別子が設定されます。

1 から 5 の説明を設定する必要があります。 各説明の Text には、少なくとも 1 つの単語が含まれている必要があります。 リソースを効率的に使用するために、キーワード (keyword)ごとに新しい広告コピーを作成するのではなく、{キーワード (keyword)} などの動的テキスト文字列を使用することをお勧めします。 詳細については、Microsoft Advertising のヘルプ記事「 動的テキスト パラメーターを使用して広告を自動的にカスタマイズする」を参照してください。

各説明の Text の最大入力長は、ダイナミック テキスト文字列を含む 1,000 文字で、置換後に最後の 90 文字以下の 1,000 文字を使用できます。 広告の表示に失敗するか、動的テキスト置換が発生した後に長さが 90 文字を超える場合は 、既定 のテキストが使用されます。 二重幅文字を持つ言語の場合 (繁体字中国語)、動的テキスト文字列を含む最大入力長は 500 文字で、置換後は 45 文字以内の最終文字が 500 文字以内です。 広告の表示に失敗するか、動的テキスト置換が発生した後に長さが 45 文字を超える場合は 、既定 のテキストが使用されます。 二重幅の文字は、キャンペーンまたは広告グループの言語設定の文字セットではなく、使用する文字によって決まります。 二重幅の文字には、韓国語、日本語、中国語の文字と絵文字が含まれます。

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

追加： マルチメディア広告とオーディエンス広告には必須です。 動画広告には適用されません。
更新： オプション。 既存のすべてのアセット リンクを保持するには、この要素を nil のままにします。 この要素を設定すると、以前にこの広告にリンクされていた説明が置き換えられます。		 AssetLink 配列
見出し 見出しは広告に表示される最も目立つテキストであるため、使用可能な文字を最大限に活用する必要があります。 広告がさまざまなパブリッシャーやプレースメントに柔軟に表示できるように、複数の見出しが必要です。

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

追加： 動画広告には必須です。 マルチメディア広告やオーディエンス広告には適用されません。
更新： オプション。 マルチメディア広告とオーディエンス広告では非推奨になりました。 代わりに見出しを使用します。		 string
見出し 見出しは広告に表示される最も目立つテキストであるため、使用可能な文字を最大限に活用する必要があります。 広告がさまざまなパブリッシャーやプレースメントに柔軟に表示できるように、複数の見出しが必要です。

いずれかの見出しを特定の位置に ピン留 めしない限り、Bingは、ユーザーの検索クエリに最適な見出しと説明で広告レイアウトを動的に最適化します。

データ モデルの観点から見ると、デスリプションとヘッドラインはそれぞれテキストアセット (AssetLink ごとに 1 つの TextAsset) として格納されます。 同じアセットを複数の広告で使用できます。 たとえば、"シームレスインテグレーション" がテキストアセットの場合、同じ Microsoft Advertising アカウント内のすべての広告で同じアセット識別子が設定されます。

見出しは 1 ~ 15 個に設定する必要があります。 各見出しの テキスト には、少なくとも 1 つの単語が含まれている必要があります。 リソースを効率的に使用するために、キーワード (keyword)ごとに新しい広告コピーを作成するのではなく、{キーワード (keyword)} などの動的テキスト文字列を使用することをお勧めします。 詳細については、Microsoft Advertising のヘルプ記事「 動的テキスト パラメーターを使用して広告を自動的にカスタマイズする」を参照してください。

各見出しの テキスト の最大入力長は、動的テキスト文字列を含む 1,000 文字で、置換後に最後の 30 文字以下の 1,000 文字を使用できます。 広告の表示に失敗するか、動的テキスト置換が発生した後に長さが 30 文字を超える場合は 、既定 のテキストが使用されます。

二重幅文字を持つ言語 (繁体字中国語など) の場合、最大入力長は動的テキスト文字列を含む 500 文字で、置換後に 15 文字以内の最終文字を 500 文字以内で使用できます。 動的テキスト置換が行われると、広告の表示が失敗するか、長さが 15 文字を超えると 既定 のテキストが使用されます。 二重幅の文字は、キャンペーンまたは広告グループの言語設定の文字セットではなく、使用する文字によって決まります。 二重幅の文字には、韓国語、日本語、中国語の文字と絵文字が含まれます。

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

追加： マルチメディア広告とオーディエンス広告には必須です。 動画広告には適用されません。
更新： オプション。 既存のすべてのアセット リンクを保持するには、この要素を nil のままにします。 この要素を設定すると、以前にこの広告にリンクされていた見出しが置き換えられます。		 AssetLink 配列
Images さまざまなサイズと縦横比を持つ画像アセットを使用して、さまざまな発行元や配置に対して柔軟に表示できるようにします。

それぞれ SubType とトリミング設定を持つ ImageAsset を含む 1 つ以上の AssetLink オブジェクトを含め、目的の縦横比に一致します。 詳細については、以下の 解説を 参照してください。

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 更新中にイメージを含める場合、以前に設定したイメージはすべて置き換えられます。		 AssetLink 配列
ImpressionTrackingUrls 1x1 インプレッション トラッキング ピクセルの URL。 各ピクセルは、Microsoft Audience Network のインプレッションをサード パーティの広告レポート ツールに報告します。

レスポンシブ広告ごとに最大 2 つのインプレッショントラッキング URL を含めることができます。

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

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

この要素は既定では返されません。 この要素を取得するには、 GetAdsByAdGroupId、 GetAdsByEditorialStatus、および GetAdsByIds サービス操作を呼び出すときに、ReturnAdditionalFields 要素に ImpressionTrackingUrls 値 を 含めます。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 インプレッション トラッキング URL を削除するには、この要素を空の文字列配列に設定します。		 string 配列
LongHeadline オーディエンス キャンペーンの場合、 LongHeadline は、2 つの可能なレスポンシブ広告見出しの長いです。 AssetLink
LongHeadlines 長い見出しを 1 ~ 5 個設定する必要があります。 各見出しのテキストには、少なくとも 1 つの単語が含まれている必要があります。 Text には改行 (\n) 文字を含めることはできません。

親キャンペーンがストアに関連付け、LongHeadlines を指定する場合は、見出し、説明、および画像も指定する必要があります。

追加: 親キャンペーンがストアに関連付ける場合は省略可能。親キャンペーンがストアに関連付けられない場合は必須です。 空の場合は LongHeadlineString を 使用します。
更新: 省略可能。 既存のすべてのアセット リンクを保持するには、この要素を nil のままにします。 この要素の値を設定すると、以前にこの資産グループにリンクされていた見出しが置き換えられます。 親キャンペーンがストアに関連付け、この要素を空のリストに設定すると、前の設定が削除されます。		 AssetLink 配列
LongHeadlineString 見出しは広告に表示される最も目立つテキストであるため、使用可能な文字を最大限に活用する必要があります。 広告がさまざまなパブリッシャーやプレースメントに柔軟に表示できるように、複数の見出しが必要です。

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

追加： オプション。 LongHeadlines が指定されている場合は無視されます。 LongHeadlines が空の場合は、LongHeadlines に LongHeadlineString を入力します。 マルチメディア広告には適用されません。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 string
テキスト このテキストは、広告の配置に応じて、広告の長い見出しまたは短い見出しの下または隣に表示されます。

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

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

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

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

追加： 動画広告には必須です。 マルチメディア広告やオーディエンス広告には適用されません。
更新： ビデオ広告の場合は省略可能です。 代わりに、対象ユーザー広告またはマルチメディア広告に説明を使用します (非推奨)。		 string
VerifiedTrackingSettings VerifiedTrackingSetting は、サード パーティの測定設定を関連付けます。 これにより、 インテグラル広告サイエンスなどのサードパーティの検証プロバイダーを使用して、視認性、ブランドの安全性、および無効なトラフィック メトリックを追跡できます。 この機能は、CPM 入札戦略を使用してネイティブ、ディスプレイ、およびオンラインの動画広告で使用できます。

注: 現在、IAS は唯一サポートされているベンダー (vendorName) ですが、他の検証プロバイダーは近日公開予定です。 次の例は 、IAS に関連しています。

IAS には 3 つのキーと値のペアがあります。
  • "vendorName"
  • "advertiserEntityID" (確認プロバイダーのクライアント ID)
  • "publisherEntityID" (確認プロバイダーのレポート ID)
例 (IAS に必要):
  • vendorName : "IAS"
  • advertiserEntityID : "12345678"
  • publisherEntityID : "12345678"
 VerifiedTrackingSetting
ビデオ さまざまなサイズと縦横比を持つビデオアセットを使用して、さまざまなパブリッシャーやプレースメントに柔軟に表示できるようにします。

それぞれ SubType を持つ VideoAsset を含む 1 つ以上の AssetLink オブジェクトを含めます。

追加： 動画広告には必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 更新中にビデオを含める場合、以前に設定したビデオはすべて置き換えられます。		 AssetLink 配列

ResponsiveAd オブジェクトには継承された要素があります。

継承された要素

Ad から継承された要素

ResponsiveAd オブジェクトは Ad オブジェクトから派生し、AdFormatPreference、DevicePreference、EditorialStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、Status、TrackingUrlTemplate、Type、UrlCustomParameters の各要素を継承します。 以下の説明は 、ResponsiveAd に固有のものであり、 Ad オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。

要素 説明 データ型
AdFormatPreference この広告タイプではサポートされていません。 string
DevicePreference この広告タイプではサポートされていません。 long
EditorialStatus 広告の編集レビューの状態。これは、広告がレビュー待ちであるか、承認されているか、不承認であるかを示します。

追加： 読み 取り 専用
更新： 読み 取り 専用		 AdEditorialStatus
FinalAppUrls この広告タイプではサポートされていません。 AppUrl 配列
FinalMobileUrls モバイル ランディング ページの URL。

次の検証規則は、最終 URL と最終モバイル URL に適用されます。
- URL の長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。
- FinalUrls と FinalMobileUrls の両方に最大 10 個の項目を指定できます。ただし、各一覧の最初の項目のみが配信に使用されます。 このサービスでは、前方互換性の可能性がある最大 10 個を許可します。
- '{' と '}' の使用は、 {lpurl} などのタグのみを示すために許可されます。
- 最終的な URL はそれぞれ、http:// または https:// で始まる整形式の URL である必要があります。
- FinalMobileUrls を指定する場合は、 FinalUrls も指定する必要があります。
- デバイスの基本設定がモバイルに設定されている場合、 FinalMobileUrls を指定することはできません。

この URL は、キーワード (keyword)で最終的なモバイル URL が指定されていない場合にのみ使用されます。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空のリストに設定すると、前の設定が削除されます。		 string 配列
FinalUrls ランディング ページの URL。

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

次の検証規則は、最終 URL と最終モバイル URL に適用されます。
- URL の長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。
- FinalUrls と FinalMobileUrls の両方に最大 10 個の項目を指定できます。ただし、各一覧の最初の項目のみが配信に使用されます。 このサービスでは、前方互換性の可能性がある最大 10 個を許可します。
- '{' と '}' の使用は、 {lpurl} などのタグのみを示すために許可されます。
- 最終的な URL はそれぞれ、http:// または https:// で始まる整形式の URL である必要があります。
- FinalMobileUrls を指定する場合は、 FinalUrls も指定する必要があります。
- デバイスの基本設定がモバイルに設定されている場合、 FinalMobileUrls を指定することはできません。 また、この広告の TrackingUrlTemplate または UrlCustomParameters 要素が設定されている場合は、少なくとも 1 つの最終的な URL が必要であることに注意してください。

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

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

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。		 string
ForwardCompatibilityMap 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。

今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、このオブジェクトの前方互換性の変更はありません。		 KeyValuePairOfstring 配列
Id 広告の一意の Microsoft Advertising 識別子。

追加： 読み 取り 専用
更新： 必須と Read-Only		 long
Status 広告の状態。

広告の状態を [アクティブ] または [一時停止] に設定できます。

追加： オプション
更新： オプション		 AdStatus
TrackingUrlTemplate すべてのランディング ページ 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 は同じになります。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。		 string
型 広告の種類。 この値は、レスポンシブ広告を取得するときの レスポンシブAd です。 広告の種類の詳細については、「 Ad Data Object 解説」を参照してください。

追加： 読み 取り 専用
更新： 読み 取り 専用		 AdType
UrlCustomParameters URL 追跡用のキーパラメーターと値パラメーターのカスタム コレクション。

Microsoft Advertising では、 CustomParameters オブジェクトに含める最初の 8 個の CustomParameter オブジェクトを受け入れ、8 つ以上のカスタム パラメーターを含める場合はエラーが返されます。 各 CustomParameter には、Key 要素と Value 要素が含まれています。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 既存のカスタム パラメーターを保持するには、 UrlCustomParameters 要素を null または空に設定します。 すべてのカスタム パラメーターを削除するには、CustomParameters オブジェクトの Parameters 要素を null または空に設定します。 カスタム パラメーターのサブセットを削除するには、CustomParameters オブジェクトの Parameters 要素に保持するカスタム パラメーターを指定します。		 CustomParameters

注釈

ResponsiveAd オブジェクトは、検索ネットワーク内の マルチメディア広告 と Microsoft Audience Network の オーディエンス広告 に使用されます。

サポートされているほとんどのプロパティは同じですが、主な差別化要因の一部を次に示します。

注:

イメージのデータは、AddMedia 操作を介してプロビジョニングされます。 GIF、JPEG、または PNG MIME の種類を使用できます。 アニメーションを含む画像はサポートされていません。 AddMedia 操作ではアスペクト比が少ないメディアのみを追加できますが、ImageAsset トリミング設定を使用して、各レスポンシブ広告 AssetLink のコンテキストで有効な縦横比を決定できます。 保存されたイメージの縦横比は、アカウント レベルのメディア ライブラリでは変更されません。

最大ファイル サイズは 5 MB です。 ピクセル単位の最大幅と高さは 2592 と 2048 であり、サポートされている縦横比のいずれかを維持する必要があります。 たとえば、サブタイプ LandscapeImageMedia のイメージ アセットの幅が 2592 の場合、高さは 1357 である必要があります。

マルチメディア広告画像

マルチメディア広告の場合は、サイズと縦横比が異なる複数の画像アセットを作成します。 縦横比が 1.91:1、縦横比が 1:1 の画像を少なくとも 1 つ追加する必要があります。

Images 要素には、1 つ以上の AssetLink オブジェクトが含まれます。 各アセット リンクには、SubType が次の表のいずれかの文字列値に設定された ImageAsset が含まれています。

Sub Type 縦横比 最小サイズ (ピクセル単位)
LandscapeImageMedia 1.91:1 幅 703 x 高さ 368
ImageMedia4x1 4:1 幅 608 x 高さ 152
SquareImageMedia 1:1 幅 470 x 高さ 470
ImageMedia1x2 1:2 幅 470 x 高さ 940

マルチメディア広告のロゴ

マルチメディア広告の場合は、サイズ、縦横比、トリミング設定が異なる複数のロゴアセットを作成して、サムネイルリストに柔軟に表示できるようにします。

Sub Type 縦横比 最小サイズ (ピクセル単位)
SquareImageMedia 1:1 幅 128 x 高さ 128
ImageMedia4x1 4:1 幅 512 x 高さ 128

対象ユーザーの広告画像

オーディエンス広告の場合は、サイズ、縦横比、トリミング設定が異なる複数の画像アセットを作成して、さまざまなパブリッシャーやプレースメントに対して柔軟に表示できるようにします。

Images 要素には、1 つ以上の AssetLink オブジェクトが含まれます。 各アセット リンクには、SubType が次の表のいずれかの文字列値に設定された ImageAsset が含まれています。

注:

対象ユーザー広告バージョン 2 の下の表の画像サブタイプと、現在パイロット段階です。

Sub Type 縦横比 最小サイズ (ピクセル単位)
OriginalImage 該当なし 幅 703 x 高さ 368
LandscapeImageMedia 1.91:1 幅 300 x 高さ 157
SquareImageMedia 1:1 幅 114 x 高さ 114
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

注:

次の表の画像のサブタイプは、オーディエンス広告バージョン 1 用です。

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

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

次の GetAdsByAdGroupId 応答の例を考えると、次の点に注意してください。

  • 自動生成されたすべてのイメージアセットのサブタイプには、同じ画像アセット識別子(1234567890000など)が使用されます。 Microsoft Advertising でトリミングされた画像を自動的に生成させるかどうかにかかわらず、 ID は 、同じ広告にリンクされている画像アセットの中で一意である必要はありません。
  • この例の広告は OriginalImage イメージ アセット のサブタイプのトリミング設定なしで作成されたため、OriginalImage に関連付けられているイメージを除くすべての画像アセットがトリミングされます。
  • Microsoft Advertising では、既定のすべてのトリミング設定に OriginalImage のトリミング設定が使用されます。 この例では、システムで生成されたすべてのイメージ アセットのトリミングの高さは 628 で、縦横比が 1.91:1 の OriginalImage (OriginalImage サブタイプ) の幅と高さが 1200x628 であると推測できます。 自動生成されたイメージ アセットのトリミング設定は、OriginalImage アセット リンクのトリミング設定に基づいています。
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Header>
		<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v12">3acf4989-d6a3-405f-9fd1-a2e8dd1b09f8</h:TrackingId>
	</s:Header>
	<s:Body>
		<GetAdsByAdGroupIdResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v12">
			<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
				<Ad i:type="ResponsiveAd">
					<AdFormatPreference i:nil="true"/>
					<DevicePreference>0</DevicePreference>
					<EditorialStatus>Inactive</EditorialStatus>
					<FinalAppUrls i:nil="true"/>
					<FinalMobileUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://mobile.contoso.com/womenshoesale</a:string>
					</FinalMobileUrls>
					<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://www.contoso.com/womenshoesale</a:string>
					</FinalUrls>
					<ForwardCompatibilityMap xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
					<Id>9876543210000</Id>
					<Status>Active</Status>
					<TrackingUrlTemplate i:nil="true"/>
					<Type>ResponsiveAd</Type>
					<UrlCustomParameters i:nil="true"/>
					<BusinessName>Contoso</BusinessName>
					<CallToAction>AddToCart</CallToAction>
					<Headline>Fast &amp; Easy Setup</Headline>
					<Images>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight i:nil="true"/>
								<CropWidth i:nil="true"/>
								<CropX i:nil="true"/>
								<CropY i:nil="true"/>
								<SubType>OriginalImage</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>628</CropWidth>
								<CropX>286</CropX>
								<CropY>0</CropY>
								<SubType>SquareImageMedia</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>942</CropWidth>
								<CropX>129</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia15X10</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>835</CropWidth>
								<CropX>183</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia133X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>1118</CropWidth>
								<CropX>41</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia178X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
					</Images>
					<LandscapeImageMediaId>1234567890000</LandscapeImageMediaId>
					<LandscapeLogoMediaId i:nil="true"/>
					<LongHeadline>Find New Customers &amp; Increase Sales!</LongHeadline>
					<SquareImageMediaId>1234567890000</SquareImageMediaId>
					<SquareLogoMediaId i:nil="true"/>
					<Text>Find New Customers &amp; Increase Sales! Start Advertising on Contoso Today.</Text>
				</Ad>
			</Ads>
		</GetAdsByAdGroupIdResponse>
	</s:Body>
</s:Envelope>

要件

サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13