広告グループ動的検索広告ターゲット レコード - 一括

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

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

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

次の一括 CSV の例では、有効な 親 ID 値が指定されている場合に、新しい広告グループ動的検索広告ターゲットを追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Tracking Template,Custom Parameter,Dynamic Ad Target Condition 1,Dynamic Ad Target Condition 2,Dynamic Ad Target Condition 3,Dynamic Ad Target Value 1,Dynamic Ad Target Value 2,Dynamic Ad Target Value 3
Format Version,,,,,,,,,6.0,,,,,,,,
Ad Group Dynamic Search Ad Target,Paused,,-1113,,,ClientIdGoesHere,,0.5,Bulk Ad Group Dynamic Search Ad Target,,{_promoCode}=PROMO1; {_season}=summer,Url,Category,PageContent,contoso.com,US/CA/SFO,flowers

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupDynamicSearchAdTarget
var bulkAdGroupDynamicSearchAdTarget = new BulkAdGroupDynamicSearchAdTarget
{
    // Map properties in the Bulk file to the 
    // BiddableAdGroupCriterion object of the Campaign Management service.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new Webpage
        {
            Parameter = new WebpageParameter
            {
                // Set Conditions null if you want to target all webpages
                Conditions = new []
                {
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 1' column header in the Bulk file
                        Argument = "contoso.com",
                        // 'Dynamic Ad Target Condition 1' column header in the Bulk file
                        Operand = WebpageConditionOperand.Url
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 2' column header in the Bulk file
                        Argument = "US/CA/SFO",
                        // 'Dynamic Ad Target Condition 2' column header in the Bulk file
                        Operand = WebpageConditionOperand.Category
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 3' column header in the Bulk file
                        Argument = "flowers",
                        // 'Dynamic Ad Target Condition 3' column header in the Bulk file
                        Operand = WebpageConditionOperand.PageContent
                    },
                },
                // 'Name' column header in the Bulk file
                CriterionName = "Bulk Ad Group Dynamic Search Ad Target"
            }
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file
            Amount = 0.50
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // '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"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupDynamicSearchAdTarget);

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

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

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

• 広告グループ
• 入札
• キャンペーン
• クライアント ID
• カスタム パラメーター
• 動的広告ターゲット条件 1
• 動的広告ターゲット条件 2
• 動的広告ターゲット条件 3
• 動的広告ターゲット オペレーター 1
• 動的広告ターゲット オペレーター 2
• 動的広告ターゲット オペレーター 3
• 動的広告ターゲット値 1
• 動的広告ターゲット値 2
• 動的広告ターゲット値 3
• 最終 URL サフィックス
• Id
• 変更時刻
• 名前
• Parent Id
• 状態
• 追跡テンプレート

広告グループ

動的広告ターゲットを含む広告グループの名前 (Web ページの条件)。

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

注:

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

入札

オークションで入札する金額。

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

キャンペーン

広告グループと動的広告ターゲットを含むキャンペーンの名前 (Web ページの条件)。

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

クライアント 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 キーワードは、前の設定を削除します。 カスタム パラメーターのサブセットを削除するには、保持するカスタム パラメーターを指定し、保持しないパラメーターを省略します。 カスタム パラメーターの新しいセットは、以前のカスタム パラメーター セットに置き換えられます。
削除： 読み 取り 専用

注:

動的広告のターゲット条件、演算子、または値フィールドを設定しない場合は、実質的にすべての Web ページをターゲットにします。

動的広告ターゲット条件 1

最大 3 つの Web ページ条件オペランドの最初。 このフィールドによって参照される Web ページ プロパティに 動的広告ターゲット値 1 の値が含まれているか等しい場合、条件が満たされます。

使用できる値は、 Category、 CustomLabel、 PageContent、 PageTitle、 Url です。

追加： オプション。 動的な広告ターゲット条件または値フィールドを設定しない場合は、実質的にすべての Web ページをターゲットにします。 すべての Web ページに対して、広告グループごとに 1 つの動的広告ターゲットのみを設定できます。
更新： 許可されていません。 動的広告ターゲット条件または値フィールドを更新することはできません。 Web ページの条件を更新するには、動的広告ターゲットを削除し、新しい広告ターゲットを追加する必要があります。
削除： 読み 取り 専用

動的広告ターゲット条件 2

最大 3 つの Web ページ条件オペランドの 2 番目。 このフィールドによって参照される Web ページ プロパティに 動的広告ターゲット値 2 の値が含まれているか等しい場合、条件が満たされます。

使用できる値は、 Category、 CustomLabel、 PageContent、 PageTitle、 Url です。

追加： オプション。 動的な広告ターゲット条件または値フィールドを設定しない場合は、実質的にすべての Web ページをターゲットにします。 すべての Web ページに対して、広告グループごとに 1 つの動的広告ターゲットのみを設定できます。
更新： 許可されていません。 動的広告ターゲット条件または値フィールドを更新することはできません。 Web ページの条件を更新するには、動的広告ターゲットを削除し、新しい広告ターゲットを追加する必要があります。
削除： 読み 取り 専用

動的広告ターゲット条件 3

最大 3 つの Web ページ条件オペランドの 3 番目。 このフィールドによって参照される Web ページ プロパティに 動的広告ターゲット値 1 の値が含まれているか等しい場合、条件が満たされます。

使用できる値は、 Category、 CustomLabel、 PageContent、 PageTitle、 Url です。

追加： オプション。 動的な広告ターゲット条件または値フィールドを設定しない場合は、実質的にすべての Web ページをターゲットにします。 すべての Web ページに対して、広告グループごとに 1 つの動的広告ターゲットのみを設定できます。
更新： 許可されていません。 動的広告ターゲット条件または値フィールドを更新することはできません。 Web ページの条件を更新するには、動的広告ターゲットを削除し、新しい広告ターゲットを追加する必要があります。
削除： 読み 取り 専用

動的広告ターゲット オペレーター 1

最大 3 つの Web ページ条件演算子の最初。 このフィールドによって参照される Web ページ プロパティに 動的広告ターゲット値 1 の値が含まれているか等しい場合、条件が満たされます。

指定できる値には 、Contains と Equals が含まれます。

追加： オプション。 動的広告のターゲット条件、演算子、または値フィールドを設定しない場合は、実質的にすべての Web ページをターゲットにします。 動的広告ターゲット条件 1 を設定し、動的広告ターゲット 演算子 1 を設定しない場合は、選択したオペランドに既定の演算子が使用されます。 URL Equals を作成する場合は、演算子を渡す必要があります。 更新： 許可されていません。 動的広告ターゲット演算子または値フィールドを更新することはできません。 Web ページの条件を更新するには、動的広告ターゲットを削除し、新しい広告ターゲットを追加する必要があります。
削除： 読み 取り 専用

動的広告ターゲット オペレーター 2

最大 3 つの Web ページ条件演算子の 2 番目。 このフィールドによって参照される Web ページ プロパティに 動的広告ターゲット値 2 の値が含まれているか等しい場合、条件が満たされます。

指定できる値には 、Contains と Equals が含まれます。

追加： オプション。 動的広告のターゲット条件、演算子、または値フィールドを設定しない場合は、実質的にすべての Web ページをターゲットにします。 動的広告ターゲット条件 21 を設定し、動的広告ターゲット 演算子 2 を設定しない場合は、選択したオペランドに既定の演算子が使用されます。 URL Equals を作成する場合は、演算子を渡す必要があります。 更新： 許可されていません。 動的広告ターゲット演算子または値フィールドを更新することはできません。 Web ページの条件を更新するには、動的広告ターゲットを削除し、新しい広告ターゲットを追加する必要があります。
削除： 読み 取り 専用

動的広告ターゲット オペレーター 3

最大 3 つの Web ページ条件演算子の 3 番目。 このフィールドによって参照される Web ページ プロパティに 動的広告ターゲット値 3 の値が含まれているか等しい場合、条件が満たされます。

指定できる値には 、Contains と Equals が含まれます。

追加： オプション。 動的広告のターゲット条件、演算子、または値フィールドを設定しない場合は、実質的にすべての Web ページをターゲットにします。 動的広告ターゲット条件 3 を設定し、動的広告ターゲット 演算子 3 を設定しない場合は、選択したオペランドに既定の演算子が使用されます。 URL Equals を作成する場合は、演算子を渡す必要があります。 更新： 許可されていません。 動的広告ターゲット演算子または値フィールドを更新することはできません。 Web ページの条件を更新するには、動的広告ターゲットを削除し、新しい広告ターゲットを追加する必要があります。
削除： 読み 取り 専用

動的広告ターゲット値 1

最大 3 つの Web ページ条件または条件引数の最初。

この文字列は、サイトの URL、カテゴリ、ページ タイトル、またはページ コンテンツに設定できます。 たとえば、[ 動的広告ターゲット条件 1 ] フィールドが [Url] に設定されている場合は、このフィールドを contoso.com/flowers に設定できます。

追加： オプション。 動的な広告ターゲット条件または値フィールドを設定しない場合は、実質的にすべての Web ページをターゲットにします。 すべての Web ページに対して、広告グループごとに 1 つの動的広告ターゲットのみを設定できます。
更新： 許可されていません。 動的広告ターゲット条件または値フィールドを更新することはできません。 Web ページの条件を更新するには、動的広告ターゲットを削除し、新しい広告ターゲットを追加する必要があります。
削除： 読み 取り 専用

動的広告ターゲット値 2

最大 3 つの Web ページ条件または条件引数の 2 番目。

この文字列は、サイトの URL、カテゴリ、ページ タイトル、またはページ コンテンツに設定できます。 たとえば、[ 動的広告ターゲット条件 2 ] フィールドが [Url] に設定されている場合は、このフィールドを contoso.com/flowers に設定できます。

追加： オプション。 動的な広告ターゲット条件または値フィールドを設定しない場合は、実質的にすべての Web ページをターゲットにします。 すべての Web ページに対して、広告グループごとに 1 つの動的広告ターゲットのみを設定できます。
更新： 許可されていません。 動的広告ターゲット条件または値フィールドを更新することはできません。 Web ページの条件を更新するには、動的広告ターゲットを削除し、新しい広告ターゲットを追加する必要があります。
削除： 読み 取り 専用

動的広告ターゲット値 3

最大 3 つの Web ページ条件または条件引数の 3 番目。

この文字列は、サイトの URL、カテゴリ、ページ タイトル、またはページ コンテンツに設定できます。 たとえば、[ 動的広告ターゲット条件 3 ] フィールドが [Url] に設定されている場合は、このフィールドを contoso.com/flowers に設定できます。

追加： オプション。 動的な広告ターゲット条件または値フィールドを設定しない場合は、実質的にすべての Web ページをターゲットにします。 すべての Web ページに対して、広告グループごとに 1 つの動的広告ターゲットのみを設定できます。
更新： 許可されていません。 動的広告ターゲット条件または値フィールドを更新することはできません。 Web ページの条件を更新するには、動的広告ターゲットを削除し、新しい広告ターゲットを追加する必要があります。
削除： 読み 取り 専用

Id

動的広告ターゲットのシステム生成識別子 (Web ページ条件)。

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

最終 URL サフィックス

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

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

変更時刻

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

注:

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

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

名前

条件を識別するために使用できる条件名 。たとえば、アルファベット順にフィルター処理または並べ替えることができます。

条件名の長さは、1 から 2048 までの範囲である必要があります。

追加： オプション。 名前を指定しない場合、既定では、名前は連結された条件の一覧に設定されます。 各条件は 、 キーワードと キーワードで区切られます。 たとえば、条件が a) Url に花が含まれている 場合、b) Url に書籍が含まれている 場合、c) PageContent にシアトルが含まれている場合、既定の条件名は Url に花が含まれており、Url には書籍が含まれており、PageContent にはシアトルが含まれます。 すべての条件フィールドと値フィールドが空の場合、実質的にすべての Web ページを対象としており、名前は [すべての Web ページ] に設定されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 delete_value キーワードを指定すると、条件名が既定値 (つまり、すべての Web ページまたは連結された条件の一覧) に更新されます。
削除： 読み 取り 専用

Parent Id

動的広告ターゲット (Web ページの条件) を含む広告グループのシステム生成識別子。

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

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

注:

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

状態

動的広告ターゲットの状態 (Web ページの条件)。

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

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

追跡テンプレート

トラッキング テンプレートは、動的検索広告キャンペーンで指定したドメインから動的に生成されるランディング ページ URL と組み合わせて使用できます。 ドメインとトラッキング テンプレートを組み合わせることにより、ランディング ページ URL が組み立てられます。この 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 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用