次の方法で共有

テキスト広告レコード - 一括

  • [アーティクル]

一括ファイルでダウンロードおよびアップロードできるテキスト広告を定義します。

重要

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

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

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

次の一括 CSV の例では、有効な 親 ID 値が指定されている場合に新しいテキスト広告を追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Text Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,contoso.com,,,All,False,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkTextAd
var bulkTextAd = new BulkTextAd
{
    // '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 
    // TextAd object of the Campaign Management service.
    TextAd = new TextAd
    {
        // 'Ad Format Preference' column header in the Bulk file
        AdFormatPreference = "All",
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Device Preference' column header in the Bulk file
        DevicePreference = 0,
        // 'Display Url' column header in the Bulk file
        DisplayUrl = "contoso.com",
        // '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"
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales!",
        // 'Title' column header in the Bulk file
        Title = "Contoso Quick Setup",
        // '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(bulkTextAd);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

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

広告フォーマットの設定

[広告形式の設定] フィールドは、広告コピーを検索広告または対象ユーザー広告としてユーザーに表示するかどうかを示すために使用されます。 検索広告は行動喚起として書き込まれる傾向があるのに対し、オーディエンス広告は、より多くの情報スタイルで記述する必要があります。 検索テキスト広告を対象ユーザー広告として使用することもできますが、広告を対象ユーザー広告の優先形式として指定すると、ネイティブ配信用にメッセージングを最適化できます。

重要

対象ユーザー広告を優先しない広告グループごとに少なくとも 1 つのテキスト広告を定義する必要があります。それ以外の場合は、すべてのテキスト広告の広告コピーが検索広告と対象ユーザー広告の両方の対象になります。

可能な値は 、対象ユーザー広告 と すべてです。 [すべて] に設定すると、広告は検索広告と対象ユーザーの両方の広告形式の対象になります。 [対象ユーザー広告] に設定されている場合、広告は対象ユーザーの広告形式にのみ適用されます。

追加： サポートされていません
更新： サポートされていません
削除： 読み 取り 専用

広告グループ

広告を含む広告グループの名前。

追加： サポートされていません
更新： 読み取り専用と必須
削除： 読み取り専用と必須

注:

更新と削除を行うには、[ 親 ID ] フィールドまたは [ 広告グループ ] フィールドを指定する必要があります。

キャンペーン

広告グループと広告を含むキャンペーンの名前。

追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用

クライアント 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} として書式設定する必要があります。 キャンペーン管理サービスでは、周囲の中かっことアンダースコアを指定できません。

追加： サポートされていません
更新： サポートされていません
削除： 読み 取り 専用

デバイスの基本設定

このフィールドは、テキスト広告をすべてのデバイスに表示するか、モバイル デバイスにのみ表示するかを決定します。

使用可能な値は All と Mobile で、キャンペーン管理サービスで使用される値とは異なります。

既定値は All です。

一括ダウンロードとアップロードの結果ファイルでは、このフィールドが空になることはありません。 デバイスの基本設定を指定しなかった場合は、 既定値の All が返されます。

重要

モバイル優先ではない広告グループごとに少なくとも 1 つのテキスト広告を定義する必要があります。それ以外の場合は、すべてのテキスト広告の広告コピーがすべてのデバイスに適用されます。

追加： サポートされていません
更新： サポートされていません
削除： 読み 取り 専用

表示 URL

広告に表示する URL。

表示 URL のサブディレクトリには、{keyword}などの動的テキスト文字列を含めることができます。ただし、URL ホスト名に動的テキストを含めることはできません。 詳細については、Microsoft Advertising のヘルプ記事「 動的テキスト パラメーターを使用して広告を自動的にカスタマイズする」を参照してください。

URL の最大入力長は 200 文字で、動的テキスト文字列を含めることができます。 ただし、動的テキスト置換が発生した後、URL が 35 文字を超えると、広告の表示に失敗します。

追加： サポートされていません
更新： サポートされていません
削除： 読み 取り 専用

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

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

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

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

追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用

編集場所

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

追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用

編集理由コード

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

追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用

編集状態

広告の編集状態。

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

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

追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用

編集用語

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

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

追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用

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

また、[ 追跡テンプレート ] フィールドまたは [カスタム パラメーター] フィールドが設定されている場合は、少なくとも 1 つの最終 URL が必要であることに注意してください。

注:

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

追加： サポートされていません
更新： サポートされていません
削除： 読み 取り 専用

Id

広告のシステム生成識別子。

追加： オプション。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 その後、広告の負の識別子セットは、テキスト広告ラベルなどの依存レコードタイプの [親 ID] フィールドで参照できます。 これは、同じ Bulk ファイルに新しい広告と新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

モバイルの最終 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 は、キーワードで Mobile Final URL が指定されていない場合にのみ使用されます。

追加： サポートされていません
更新： サポートされていません
削除： 読み 取り 専用

変更時刻

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

注:

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

追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用

Parent Id

広告を含む広告グループのシステム生成識別子。

この一括フィールドは、広告グループ レコードの Id フィールドにマップされます。

追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用

注:

更新と削除を行うには、[ 親 ID ] フィールドまたは [ 広告グループ ] フィールドを指定する必要があります。

発行元の国

編集ガイドラインで指定した 用語が許可されていない発行元の国または地域の一覧。

一括ファイルでは、発行元の国またはリージョンの一覧はセミコロン (;)で区切られます。

追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用

状態

広告の状態。

使用可能な値は、 アクティブ、 一時停止、または 削除です。

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

テキスト

広告のコピー。

テキストには少なくとも 1 つの単語が含まれている必要があり、{keyword} などの動的テキスト文字列を含めることができます。 詳細については、Microsoft Advertising のヘルプ記事「 動的テキスト パラメーターを使用して広告を自動的にカスタマイズする」を参照してください。

コピーの最大入力長は 300 文字で、動的テキスト文字列を含めることができます。 広告の表示に失敗するか、動的テキスト置換が発生した後に長さが 80 文字を超える場合は 、既定 のテキストが使用されます。 繁体字中国語を使用する広告グループの場合、コピーの最大入力長は 150 文字で、置換後のテキストは 40 文字に制限されることに注意してください。

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

追加： サポートされていません
更新： サポートされていません
削除： 読み 取り 専用

Title

広告のタイトル。

タイトルには、少なくとも 1 つの単語が含まれている必要があります。 広告のコピーとタイトルの組み合わせには、少なくとも 3 つの単語を合計する必要があります。

タイトルには、{keyword} などの動的テキスト文字列を含めることができます。 詳細については、Microsoft Advertising のヘルプ記事「 動的テキスト パラメーターを使用して広告を自動的にカスタマイズする」を参照してください。

タイトルの最大入力長は 80 文字で、動的テキスト文字列を含めることができます。 広告の表示に失敗するか、動的テキスト置換が発生した後に長さが 25 文字を超える場合は 、既定 のテキストが使用されます。 繁体字中国語を使用する広告グループの場合、タイトルは置換後 15 文字に制限されることに注意してください。

タイトルに改行 (\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}、キャンペーン、広告グループ、条件、キーワード、または広告レベルで {_season} または {_promocode} が 定義されていない場合、ランディング ページの URL は同じになります。

追加： サポートされていません
更新： サポートされていません
削除： 読み 取り 専用