次の方法で共有

動的検索広告レコード - 一括

  • [アーティクル]

一括ファイルでダウンロードおよびアップロードできる動的検索広告を定義します。

動的検索広告では、ターゲットとする Web サイトのドメインと言語に基づいて、見出しと表示 URL が自動的に生成されます。 Path1、Path2、Text 要素の組み合わせにより、動的検索広告が一意になります。 必要に応じて、 ページ フィードを使用して静的な見出しを指定できます。

注:

この機能は現在、アルバニア (AL)、アンドラ (AD)、アルゼンチン (AR)、アルバ、オーストラリア (AU)、オーストリア (AT)、バハマ (BS)、バングラデシュ(BD)、ベルギー (BE)、ボリビア(BO)、ボスニア・ヘルツェゴビナ (BA)、ブラジル (BR)、ブルネイ(BN)、ブルガリア (BG)、カナダ (CA)、ケイマン諸島(KY)、チリ(CL)、コスタリカ(CR)、クロアチア(HR)、キプロス (CY)、チェコ共和国 (CZ)、 デンマーク (DK)、ドミニカ(DM)、ドミニカ共和国(DO)、エクアドル(EC)、エルサルバドル(SV)、エストニア (EE)、フィジー (FJ)、フィンランド (FI)、フランス (FR)、フランス領ギアナ(GF)、フランス領ポリネシア (PF)、ドイツ (DE)、ギリシャ (GR)、 グアム (GU)、グアテマラ (GT)、ガイアナ (GY)、ハイチ (HT)、ホンジュラス (HN)、ハンガリー (HU)、アイスランド (IS)、インド (IN)、インドネシア (ID)、アイルランド (IE)、イタリア (IT)、ラトビア (LV)、リヒテンシュタイン (LI)、 リトアニア (LT)、ルクセンブルク (LU)、マレーシア (MY)、モルディブ (MV)、マルタ (MT)、マルティニーク (MQ)、メキシコ (MX)、モナコ (MC)、モンゴル (MN)、モンテネグロ (ME)、モントセラト (MS)、ネパール (NP)、オランダ (NL)、New Caledonia (NC)、ニュージーランド (NZ)、北マケドニア共和国 (MK)、ノルウェー (NO)、パナマ (PA)、パラグアイ (PY)、パプアニューギニア (PG)、ペルー (PE)、フィリピン (PH)、ポーランド (PO)、ポルトガル (PT)、プエルトリコ、 ルーマニア (RO)、サンマリノ (SM)、セルビア (RS)、シンガポール(SG)、スロバキア (SK)、スロベニア (SI)、スペイン (ES)、スペイン(ES)、スリランカ(LK)、スウェーデン(SE)、スイス (CH)、タイ(TH)、トリニダード・トバゴ(TT)、Türkiye (TR)、バチカン市国 (VA)、ベトナム(VN)、英国 (英国)、米国 (US)、ウルグアイ(UY)、ベネズエラ(VE)

動的検索広告レコードは、有効な動的検索広告設定を持つ検索キャンペーン内でのみ作成できます ( [ドメイン言語]、[ 動的説明が有効]、[ ページ フィード ID]、[ ソース]、および [Web サイト ] フィールドで構成されます)。 キャンペーンの 実験 ID を 設定し、 広告グループの種類 を "SearchDynamic" に設定する必要があります。

注:

動的検索広告のみをサポートするキャンペーンを追加、更新、または取得することはできなくなります。 既存のキャンペーンのキャンペーンの種類が "DynamicSearchAds" から "検索" に更新されました。 広告グループは現在、"動的" 広告グループと見なされますが、構造的な変更はありません。つまり、以前と同じ自動ターゲットと動的検索広告が含まれています。

DownloadCampaignsByAccountIds またはDownloadCampaignsByCampaignIds サービス要求に DynamicSearchAds の 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,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,,
Dynamic Search Ad,Active,,-1113,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,,,,,,,,,,,,{_promoCode}=PROMO1; {_season}=summer,,,seattle,shoe sale

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkDynamicSearchAd
var bulkDynamicSearchAd = new BulkDynamicSearchAd
{
    // '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 
    // DynamicSearchAd object of the Campaign Management service.
    DynamicSearchAd = new DynamicSearchAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // '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,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // '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(bulkDynamicSearchAd);

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

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

動的検索広告レコードの場合は、一括ファイル スキーマで次の属性フィールドを使用できます。 パス 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 キーワードは、前の設定を削除します。 カスタム パラメーターのサブセットを削除するには、保持するカスタム パラメーターを指定し、保持しないパラメーターを省略します。 カスタム パラメーターの新しいセットは、以前のカスタム パラメーター セットに置き換えられます。
削除： 読み 取り 専用

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

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

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

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

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

編集場所

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

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

編集理由コード

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

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

編集状態

広告の編集状態。

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

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

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

編集用語

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

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

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

最終 URL サフィックス

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

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

Id

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

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

変更時刻

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

注:

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

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

Parent Id

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

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

追加： 読み取り専用と必須。 既存の広告グループ識別子を指定するか、親広告グループ レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイル内の新しい広告グループに新しい広告を追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み 取り 専用
削除： 読み 取り 専用

注:

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

パス 1

表示 URL のドメイン部分に追加される省略可能なパスの最初の部分。 www.contoso.com などの表示 URL は、 表示 URL のドメインから生成されます。 パス 1 の値を指定した場合は、表示 URL に追加されます。 パス 2 の値も指定している場合は、パス 1 の後の表示 URL にも追加されます。 たとえば、ドメインが contoso.com されている場合、 パス 1 は サブディレクトリ 1 に設定され、 パス 2 は サブディレクトリ 2 に設定されている場合、表示される URL は www.contoso.com/subdirectory1/subdirectory2。

パスの最大入力長は 15 文字です。 二重幅文字を持つ言語 (繁体字中国語など) の場合、パスの最大入力長は 7 文字であることに注意してください。

パスには 、IF 関数と カウントダウン 関数を含めることができます。 無置換のすべてのカウントダウン パラメーターの全長に関係なく、最終的に表示されるカウントダウンでは、使用可能な合計文字のうち常に 8 文字が使用されます。 詳細については、「 カウントダウン カスタマイザー」を参照してください。

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

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

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

パス 2

表示 URL のドメイン部分に追加される省略可能なパスの 2 番目の部分。 表示 URL (例: www.contoso.com ) は、動的検索広告のキャンペーン レベル設定のドメインから生成されます。 パス 1 の値を指定した場合は、表示 URL に追加されます。 パス 2 の値も指定している場合は、パス 1 の後の表示 URL にも追加されます。 たとえば、ドメインが contoso.com されている場合、 パス 1 は サブディレクトリ 1 に設定され、 パス 2 は サブディレクトリ 2 に設定されている場合、表示される URL は www.contoso.com/subdirectory1/subdirectory2。

パス 1 も設定されている場合にのみ、パス 2 を指定できます。

パスの最大入力長は 15 文字です。 二重幅文字を持つ言語 (繁体字中国語など) の場合、パスの最大入力長は 7 文字であることに注意してください。

パスには 、IF 関数と カウントダウン 関数を含めることができます。 無置換のすべてのカウントダウン パラメーターの全長に関係なく、最終的に表示されるカウントダウンでは、使用可能な合計文字のうち常に 8 文字が使用されます。 詳細については、「 カウントダウン カスタマイザー」を参照してください。

パスにスラッシュ (/) 文字または改行 (\n) 文字を含めることはできません。 パスにスペースが含まれている場合、広告が表示されるときにアンダースコア (_) に置き換えられます。

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

発行元の国

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

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

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

状態

広告の状態。

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

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

テキスト

広告の説明の最初の部分。

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

コピーの最大入力長は 90 文字です。 繁体字中国語を使用する広告グループの場合、コピーの最大入力長は 45 文字であることに注意してください。

テキストには 、IF 関数と カウントダウン 関数を含めることができます。 無置換のすべてのカウントダウン パラメーターの全長に関係なく、最終的に表示されるカウントダウンでは、使用可能な合計文字のうち常に 8 文字が使用されます。 詳細については、「 カウントダウン カスタマイザー」を参照してください。

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

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

テキスト パート 2

広告の説明の 2 番目の部分。

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

コピーの最大入力長は 90 文字です。 繁体字中国語を使用する広告グループの場合、コピーの最大入力長は 45 文字であることに注意してください。

テキストには 、IF 関数と カウントダウン 関数を含めることができます。 無置換のすべてのカウントダウン パラメーターの全長に関係なく、最終的に表示されるカウントダウンでは、使用可能な合計文字のうち常に 8 文字が使用されます。 詳細については、「 カウントダウン カスタマイザー」を参照してください。

テキストに改行 (\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 は同じになります。

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