レスポンシブ検索広告レコード - 一括

[アーティクル]
11/13/2024

一括ファイルでダウンロードおよびアップロードできる検索ネットワーク内のテキスト広告のレスポンシブ検索広告の形式を定義します。

注:

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

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

ユーザーに表示されるレスポンシブ広告は、拡張テキスト広告と同じように表示されます。つまり、最大 3 つの見出し (拡張テキスト広告によるタイトルパーツ) と 2 つの説明 (拡張テキスト広告によるテキストパーツ) が表示されます。ただし、画面サイズによっては、広告が 3 つ目の見出しや 2 つ目の説明なしで表示される場合があります。

レスポンシブ検索広告を作成すると、説明リストと見出しリストは、アカウント内のレスポンシブ検索広告で共有できるテキストアセットとして保存されます。たとえば、"シームレスインテグレーション" がテキストアセットの場合、同じ Microsoft Advertising アカウントの "シームレスインテグレーション" にリンクするすべての広告で同じアセット識別子を持っていることになります。テキストアセットをアップロードすると、アセットが新規であるか、アカウントのアセットライブラリに既に存在しているかに関係なく、 ""id:""123結果ファイルにアセット識別子 (例: ) が含まれます。

注:

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

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

次の一括 CSV の例では、有効な親 ID 値が指定されている場合に、新しいレスポンシブ検索広告を追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Description,Path 1,Path 2,Domain,Headline
Format Version,,,,,,,,,6.0,,,,,,,,,,,,
Responsive Search Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,False,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,,{_promoCode}=PROMO1; {_season}=summer,"[{""text"":""Find New Customers & Increase Sales!"",""pinnedField"":""Description1""},{""text"":""Start Advertising on Contoso Today.""}]",seattle,shoe sale,,"[{""text"":""Contoso"",""pinnedField"":""Headline1""},{""text"":""Quick & Easy Setup""},{""text"":""Seamless Integration""}]"

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkResponsiveSearchAd
var bulkResponsiveSearchAd = new BulkResponsiveSearchAd
{
    // '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 
    // ResponsiveSearchAd object of the Campaign Management service.
    ResponsiveSearchAd = new ResponsiveSearchAd
    {
        // 'Description' column header in the Bulk file
        Descriptions = new AssetLink[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Find New Customers & Increase Sales!"
                },
                PinnedField = "Description1"
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Start Advertising on Contoso Today."
                },
            },
        },
        // '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"
        },
        // 'Headline' column header in the Bulk file
        Headlines = new AssetLink[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Contoso"
                },
                PinnedField = "Headline1"
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Quick & Easy Setup"
                },
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Seamless Integration"
                },
            },
        },
        // 'Id' column header in the Bulk file
        Id = responsiveSearchAdIdKey,
        // 'Path 1' column header in the Bulk file
        Path1 = "seattle",
        // 'Path 2' column header in the Bulk file
        Path2 = "shoe sale",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // '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(bulkResponsiveSearchAd);

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

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

レスポンシブ検索広告レコードの場合、一括ファイルスキーマでは、次の属性フィールドを使用できます。

広告グループ
Campaign
クライアント ID
カスタムパラメーター
説明
ドメイン
編集上の申し立てステータス
編集場所
編集理由コード
編集状態
編集用語
最終 URL
見出し
最終 URL サフィックス
Id
モバイルの最終 URL
変更時刻
Parent Id
パス 1
パス 2
発行元の国
状態
追跡テンプレート

広告グループ

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

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

注:

追加、更新、削除を行うには、[ 親 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} として書式設定する必要があります。キャンペーン管理サービスでは、周囲の中かっことアンダースコアを指定できません。

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

説明

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

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

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

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

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

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

注:

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

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

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

追加： 必須。 2 から 4 の説明の一覧が必要です。固定フィールドとテキストのみが適用されます。資産がアカウントに既に存在する場合でも、 ID、 assetPerformanceLabel、および editorialStatus は、含める場合は無視されます。
更新： オプション。既存のすべての資産リンクを保持するには、このフィールドを空のままにします。このフィールドを設定すると、以前にこの広告にリンクされていた説明が置き換えられます。このフィールドを指定する場合は、2 から 4 の説明の一覧が必要です。固定フィールドとテキストのみが適用されます。資産がアカウントに既に存在する場合でも、 ID、 assetPerformanceLabel、および editorialStatus は、含める場合は無視されます。
削除： 読み取り専用

assetPerformanceLabel

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

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

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

editorialStatus

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

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

id

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

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

pinnedField

資産を特定の説明の位置にピン留めするには、属性を pinnedField "Description1" または "Description2" のいずれかに設定します。テキストアセットに対する特定の要件がない限り、それをピン留めせず、AI でテキストの配置を最適化Bing。

説明の位置ごとに少なくとも 1 つの適格なテキストアセットを使用できる必要があるため、すべてのアセットを同じ位置にピン留めすることはできません。たとえば、レスポンシブ検索広告の説明リストに 1 つ以上のテキストアセットがピン留めされていないか、Description2 にピン留めされている限り、3 つのテキストアセットを Description1 にピン留めできます。

ピン留めされていない資産をダウンロードすると、 pinnedField 属性は返されません。

テキスト

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

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

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

ドメイン

最終的な URL の代わりに表示される URL。ランディングページ URL には、最終的な URL が引き続き使用されます。

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

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

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

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

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

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

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

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

編集場所

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

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

編集理由コード

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

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

編集状態

広告の編集状態。

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

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

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

編集用語

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

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

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

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

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

注:

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

追加： 必須
更新： オプション
削除： 読み取り専用

見出し

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

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

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

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

[{
	"text": "Contoso",
	"pinnedField": "Headline1"
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

注:

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

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

[{
	"id": 3,
	"text": "Contoso",
	"pinnedField": "Headline1",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 4,
	"text": "Quick & Easy Setup",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 5,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

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

assetPerformanceLabel

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

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

editorialStatus

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

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

id

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

pinnedField

アセットを特定の見出し位置にピン留めするには、文字列値を pinnedField "Headline1"、"Headline2"、または "Headline3" のいずれかに設定します。テキストアセットに対する特定の要件がない限り、それをピン留めせず、AI でテキストの配置を最適化Bing。

見出しの位置ごとに少なくとも 1 つの適格なテキストアセットを使用できる必要があるため、すべてのアセットを同じ位置にピン留めすることはできません。たとえば、3 つのテキストアセットを Headline1 にピン留めし、3 つのテキストアセットを Headline2 にピン留めすることができます。レスポンシブ検索広告の見出しリストに 1 つ以上のテキストアセットがピン留めされていないか、 または Headline3 にピン留めされている場合に限ります。

ピン留めされていない資産をダウンロードすると、 pinnedField 属性は返されません。

テキスト

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

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

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

最終 URL サフィックス

最後の URL サフィックスには、ランディングページ 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 フィールドと等しい負の識別子を指定する必要があります。これは、同じ 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) 文字を含めることはできません。

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

パス 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 を指定できます。

パスにスラッシュ (/) 文字または改行 (\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 は同じになります。

次の方法で共有

レスポンシブ検索広告レコード - 一括

広告グループ

キャンペーン

クライアント ID

カスタムパラメーター

説明

assetPerformanceLabel

editorialStatus

id

pinnedField

テキスト

ドメイン

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

編集場所

編集理由コード

編集状態

編集用語

最終 URL

見出し

assetPerformanceLabel

editorialStatus

id

pinnedField

テキスト

最終 URL サフィックス

Id

モバイルの最終 URL

変更時刻

Parent Id

パス 1

パス 2

発行元の国

状態

追跡テンプレート

フィードバック

その他のリソース

次の方法で共有

レスポンシブ検索広告レコード - 一括

広告グループ

キャンペーン

クライアント ID

カスタム パラメーター

説明

assetPerformanceLabel

editorialStatus

id

pinnedField

テキスト

ドメイン

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

編集場所

編集理由コード

編集状態

編集用語

最終 URL

見出し

assetPerformanceLabel

editorialStatus

id

pinnedField

テキスト

最終 URL サフィックス

Id

モバイルの最終 URL

変更時刻

Parent Id

パス 1

パス 2

発行元の国

状態

追跡テンプレート

フィードバック

その他のリソース

カスタムパラメーター