次の方法で共有

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

  • [アーティクル]

検索ネットワーク内のテキスト広告のレスポンシブ広告形式。

注:

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

レスポンシブ検索広告を使用すると、1 つの広告内で 3 ~ 15 個の一意の広告見出し (タイトル) と 2 - 4 個の広告の説明を設定できます。 そこから、Bingは、指定されたクエリとそれに対応する検索ユーザーごとに、最も関連性の高い見出しと説明の組み合わせを選択します。 Bing AI が各クエリの最も関連性の高い見出しと説明を選択できるようにすることで、考えられるすべての意図シグナルにわたって、潜在的な顧客ごとに適切なメッセージが適切なタイミングで送信されるようにします。

ユーザーに表示されるレスポンシブ広告は、拡張テキスト広告と同じように表示されます。つまり、最大 3 つの見出し (拡張テキスト広告によるタイトル パーツ) と 2 つの説明 (拡張テキスト広告によるテキスト パーツ) が表示されます。 すべての広告フォーマットでインプレッションを最大化するために、広告に説明が常に表示されるとは限りません。

レスポンシブ検索広告を作成すると、 説明 リストと 見出し リストは、アカウント内の任意のレスポンシブ検索広告で共有できるテキストアセットとして保存されます。 たとえば、"シームレスインテグレーション" がテキストアセットの場合、同じ Microsoft Advertising アカウントの "シームレスインテグレーション" にリンクするすべての広告で同じアセット識別子を持っていることになります。 資産識別子は、 AddAds 応答または UpdateAds 応答には含まれません。 キャンペーン管理サービスを使用すると、アセット識別子を取得する唯一の方法は、作成した広告を取得することです。 説明と見出しの資産識別子を取得するには、 GetAdsByAdGroupId などの後続のサービス呼び出しで広告を取得します。 Bulk サービスでは、資産識別子が一括アップロード結果ファイルに含まれます。

注:

レスポンシブ検索広告は、 AdGroupType が "SearchStandard" に設定されている検索キャンペーンでのみ作成できます。 AdGroupType が "SearchDynamic" に設定されている場合、広告グループはレスポンシブ検索広告をサポートしていません。

構文

<xs:complexType name="ResponsiveSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Domain" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

ResponsiveSearchAd オブジェクトには、説明、ドメイン、見出し、Path1、Path2 という要素があります。

要素 説明 データ型
説明 広告レイアウトの最適化Bing使用できる説明の一覧。

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

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

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

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

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

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

テキストには IF 関数 を 含めることができます。

追加： 必須
更新： オプション。 既存のすべてのアセット リンクを保持するには、この要素を nil のままにします。 この要素を設定すると、以前にこの広告にリンクされていた説明が置き換えられます。		 AssetLink 配列
ドメイン 最終的な URL の代わりに表示される URL。 ランディング ページ URL には、最終的な URL が引き続き使用されます。

医薬品のお客様など、限られたパイロット使用のために予約されています。

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

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。		 string
見出し 広告レイアウトの最適化Bing使用できる広告タイトルの一覧。

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

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

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

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

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

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

テキストには IF 関数 を 含めることができます。

追加： 必須
更新： オプション。 既存のすべてのアセット リンクを保持するには、この要素を nil のままにします。 この要素を設定すると、以前にこの広告にリンクされていた見出しが置き換えられます。		 AssetLink 配列
Path1 表示 URL のドメイン部分に追加される省略可能なパスの最初の部分。 たとえば、表示 URL のドメイン部分は、Final URL (FinalUrls 要素) のドメインから生成されます。 https://www.contoso.com Path1 の値を指定した場合は、表示 URL に追加されます。 Path2 の値も指定している場合は、Path1 の後の表示 URL にも追加されます。 たとえば、 FinalUrls に が含まれている https://www.contoso.com場合、 Path1 が サブディレクトリ 1 に設定され、 Path2 が サブディレクトリ 2 に設定されている場合、表示される URL は になります https://www.contoso.com/subdirectory1/subdirectory2。

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

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

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

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

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

パスには IF 関数を含めることができます。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。		 string
Path2 表示 URL のドメイン部分に追加される省略可能なパスの 2 番目の部分。 たとえば、表示 URL のドメイン部分は、Final URL (FinalUrls 要素) のドメインから生成されます。 https://www.contoso.com Path1 の値を指定した場合は、表示 URL に追加されます。 Path2 の値も指定している場合は、Path1 の後の表示 URL にも追加されます。 たとえば、 FinalUrls に が含まれている https://www.contoso.com場合、 Path1 が サブディレクトリ 1 に設定され、 Path2 が サブディレクトリ 2 に設定されている場合、表示される URL は になります https://www.contoso.com/subdirectory1/subdirectory2。

Path1 も設定されている場合にのみ Path2 を指定できます。

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

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

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

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

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

パスには IF 関数を含めることができます。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。		 string

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

継承された要素

Ad から継承された要素

ResponsiveSearchAd オブジェクトは Ad オブジェクトから派生し、AdFormatPreference、DevicePreference、EditorialStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、Status、TrackingUrlTemplate、Type、UrlCustomParameters の各要素を継承します。 以下の説明は 、ResponsiveSearchAd に固有のものであり、 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 は、キーワードで最終的なモバイル 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 は、キーワードで最終 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} 、キャンペーン、広告グループ、条件、キーワード、または広告レベルで {_season} または {_promocode} が 定義されていない場合、ランディング ページの URL は同じになります。

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

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

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

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

要件

サービス: CampaignManagementService.svc v13
名前 空間： https://bingads.microsoft.com/CampaignManagement/v13