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

テキスト広告を定義します。

重要

2020 年 4 月以降、スタンダール テキスト広告 (STA) の配信はサポートされていません。

標準テキスト広告は、拡張テキスト広告 (EXTA) を優先して非推奨になりました。 標準テキスト広告 (STA) の追加と更新のサポートは、2017 年 7 月 31 日に終了しました。 これで、広告主は取得および削除できますが、新しい STA を追加したり、既存の標準テキスト広告を更新したりできなくなります。 ルールの例外の 1 つは、STA の状態を引き続き更新できることです ( たとえば、アクティブ から 一時停止)。 そうしないと、STA を追加または更新しようとすると、 CampaignServiceAdTypeInvalid エラーが発生します。

構文

<xs:complexType name="TextAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

TextAd オブジェクトには、DestinationUrl、DisplayUrl、Text、Title の各要素があります。

要素	説明	データ型
DestinationUrl	ユーザーが広告をクリックしたときにアクセスする Web ページの URL。 URL には、{MatchType} などの動的パラメーターを含めることができます。 サポートされているパラメーターの一覧については、Microsoft Advertising のヘルプ記事「 どのような追跡パラメーターまたは URL パラメーターを使用できますか?」を参照してください。 URL には、最大 1,024 文字を含めることができます。 URL でプロトコルが指定されていない場合、ユーザーが広告をクリックすると、システムは HTTP プロトコルを使用します。 広告を追加するときに URL で HTTP プロトコルが指定されている場合、サービスは http:// プロトコル文字列を削除します (HTTP プロトコル文字列は 1,024 文字の制限に対してカウントされません)。ただし、サービスは URL から HTTPS プロトコル文字列 (https://) を削除しません。 大事な： 現在宛先 URL を使用している場合は、最終的な URL に置き換える必要があります。 詳細については、「 アップグレードされた URL を使用した URL 追跡」を参照してください。 この URL は、キーワードで宛先 URL が指定されていない場合にのみ使用されます。 追加： サポートされていません 更新： サポートされていません	string
DisplayUrl	広告に表示する URL。 表示 URL のサブディレクトリには、{keyword}などの動的テキスト文字列を含めることができます。ただし、URL ホスト名に動的テキストを含めることはできません。 詳細については、Microsoft Advertising のヘルプ記事「 動的テキスト パラメーターを使用して広告を自動的にカスタマイズする」を参照してください。 URL の最大入力長は 200 文字で、動的テキスト文字列を含めることができます。 広告の表示に失敗するか、ダイナミック テキストの置換が発生した後に長さが 35 文字を超える場合は 、既定 のテキストが使用されます。 追加： サポートされていません 更新： サポートされていません	string
テキスト	広告のコピー。 コピーには、少なくとも 1 つの単語が含まれている必要があります。 広告のコピーとタイトルの組み合わせには、少なくとも 3 つの単語を合計する必要があります。 テキストには、{keyword} などの動的テキスト文字列を含めることができます。 詳細については、Microsoft Advertising のヘルプ記事「 動的テキスト パラメーターを使用して広告を自動的にカスタマイズする」を参照してください。 コピーの最大入力長は 300 文字で、動的テキスト文字列を含めることができます。 広告の表示に失敗するか、動的テキスト置換が発生した後に長さが 71 文字を超える場合は 、既定 のテキストが使用されます。 繁体字中国語を使用する広告グループの場合、置換後のテキストは 38 文字に制限されることに注意してください。 テキストに改行 (\n) 文字を含めることはできません。 追加： サポートされていません 更新： サポートされていません	string
Title	広告のタイトル。 タイトルには、少なくとも 1 つの単語が含まれている必要があります。 広告のコピーとタイトルの組み合わせには、少なくとも 3 つの単語を合計する必要があります。 タイトルには、{keyword} などの動的テキスト文字列を含めることができます。 詳細については、Microsoft Advertising のヘルプ記事「 動的テキスト パラメーターを使用して広告を自動的にカスタマイズする」を参照してください。 タイトルの最大入力長は 80 文字で、動的テキスト文字列を含めることができます。 広告の表示に失敗するか、動的テキスト置換が発生した後に長さが 25 文字を超える場合は 、既定 のテキストが使用されます。 繁体字中国語を使用する広告グループの場合、タイトルは置換後 15 文字に制限されることに注意してください。 タイトルに改行 (\n) 文字を含めることはできません。 追加： サポートされていません 更新： サポートされていません	string

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

継承された要素

Ad から継承された要素

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

要素	説明	データ型
AdFormatPreference	[広告フォーマットの設定] は、広告コピーを検索広告または対象ユーザー広告としてユーザーに表示するかどうかを示すために使用されます。 検索広告は行動喚起として書き込まれる傾向があるのに対し、オーディエンス広告は、より多くの情報スタイルで記述する必要があります。 検索テキスト広告を対象ユーザー広告として使用することもできますが、広告を対象ユーザー広告の優先形式として指定すると、ネイティブ配信用にメッセージングを最適化できます。 大事な： 対象ユーザー広告を優先しない広告グループごとに少なくとも 1 つのテキスト広告を定義する必要があります。それ以外の場合は、すべてのテキスト広告の広告コピーが検索広告と対象ユーザー広告の両方の対象になります。 可能な値は AudienceAd と All です。 [すべて] に設定すると、広告は検索広告と対象ユーザーの両方の広告形式の対象になります。 AudienceAd に設定されている場合、広告は対象ユーザーの広告形式にのみ適用されます。 追加： サポートされていません 更新： サポートされていません	string
DevicePreference	この要素は、モバイル デバイスまたはすべてのデバイスにテキスト広告を表示するためのユーザー設定を決定します。 モバイル デバイスの基本設定を指定するには、この要素を 30001 に設定します。 すべてのデバイスを指定するには、この要素を 0 (ゼロ) に設定するか、要素 nil のままにします。 既定では、この要素は nil になります。 モバイル優先ではない広告グループごとに少なくとも 1 つのテキスト広告を定義する必要があります。それ以外の場合、広告はすべてのデバイスに適用されます。 追加： サポートされていません 更新： サポートされていません	long
EditorialStatus	広告の編集レビューの状態。これは、広告がレビュー待ちであるか、承認されているか、不承認であるかを示します。 追加： サポートされていません 更新： サポートされていません	AdEditorialStatus
FinalAppUrls	テキスト広告ではサポートされていません。	AppUrl 配列
FinalMobileUrls	モバイル ランディング ページの URL。 この URL は、キーワードで最終的なモバイル URL が指定されていない場合にのみ使用されます。 次の検証規則は、最終 URL と最終モバイル URL に適用されます。 - URL の長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。 - FinalUrls と FinalMobileUrls の両方に最大 10 個の項目を指定できます。ただし、各一覧の最初の項目のみが配信に使用されます。 このサービスでは、前方互換性の可能性がある最大 10 個を許可します。 - '{' と '}' の使用は、 {lpurl} などのタグのみを示すために許可されます。 - 最終的な URL はそれぞれ、http:// または https:// で始まる整形式の URL である必要があります。 - FinalMobileUrls を指定する場合は、 FinalUrls も指定する必要があります。 - デバイスの基本設定がモバイルに設定されている場合、 FinalMobileUrls を指定することはできません。 また、TextAd オブジェクトの場合、DevicePreference が 30001 (mobile) に設定されている場合、FinalMobileUrls を指定しないことがあることに注意してください。 追加： サポートされていません 更新： サポートされていません	string 配列
FinalUrls	ランディング ページの URL。 この URL は、キーワードで最終 URL が指定されていない場合にのみ使用されます。 次の検証規則は、最終 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 が必要であることに注意してください。 追加： サポートされていません 更新： サポートされていません	string 配列
FinalUrlSuffix	テキスト広告ではサポートされていません。	string
ForwardCompatibilityMap	現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、このオブジェクトの前方互換性の変更はありません。	KeyValuePairOfstring 配列
Id	広告の一意の Microsoft Advertising 識別子。 追加： サポートされていません 更新： 必須と読み取り専用	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
型	広告の種類。 この値は、 テキスト 広告を取得するときの Text です。 広告の種類の詳細については、「 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