キャンペーンの除外動的検索広告のターゲットレコード - 一括

[アーティクル]
10/04/2023

一括ファイルでアップロードおよびダウンロードできるキャンペーンネガティブダイナミック検索広告ターゲットを定義します。

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

アカウント内のすべての Campaign Negative Dynamic Search Ad Target レコードをダウンロードするには、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に CampaignNegativeDynamicSearchAdTargets の DownloadEntity 値を含めます。さらに、ダウンロード要求には 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,,,,,,,,
Campaign Negative Dynamic Search Ad Target,Active,,-114,,,ClientIdGoesHere,,,Bulk Campaign Dynamic Search Ad Target,,,Url,Category,PageContent,contoso.com,US/CA/SFO,flowers

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignNegativeDynamicSearchAdTarget
var bulkCampaignNegativeDynamicSearchAdTarget = new BulkCampaignNegativeDynamicSearchAdTarget
{
    // Map properties in the Bulk file to the 
    // NegativeCampaignCriterion object of the Campaign Management service.
    NegativeCampaignCriterion = new NegativeCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new Webpage
        {
            Parameter = new WebpageParameter
            {
                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 Campaign Negative Dynamic Search Ad Target"
            }
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignNegativeDynamicSearchAdTarget);

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

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

キャンペーンの負の動的検索広告ターゲット レコードの場合は、一括ファイルスキーマで次の属性フィールドを使用できます。

キャンペーン
クライアント ID
動的広告ターゲット条件 1
動的広告ターゲット条件 2
動的広告ターゲット条件 3
動的広告ターゲット値 1
動的広告ターゲット値 2
動的広告ターゲット値 3
Id
変更時刻
名前
Parent Id
状態

キャンペーン

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

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

注:

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

クライアント ID

一括アップロードファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。最大 100 の長さの任意の有効な文字列を指定できます。

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

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

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

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

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

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

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

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

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

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

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

動的広告ターゲット値 1

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

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

動的広告ターゲット値 2

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

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

動的広告ターゲット値 3

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

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

Id

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

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

変更時刻

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

注:

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

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

名前

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

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

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

Parent Id

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

この一括フィールドは、キャンペーンレコードの Id フィールドにマップされます。

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

注:

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

状態

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

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

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

次の方法で共有

キャンペーンの除外動的検索広告のターゲットレコード - 一括

キャンペーン

クライアント ID

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

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

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

動的広告ターゲット値 1

動的広告ターゲット値 2

動的広告ターゲット値 3

Id

変更時刻

名前

Parent Id

状態

フィードバック

その他のリソース

次の方法で共有

キャンペーンの除外動的検索広告のターゲット レコード - 一括

キャンペーン

クライアント ID

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

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

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

動的広告ターゲット値 1

動的広告ターゲット値 2

動的広告ターゲット値 3

Id

変更時刻

名前

Parent Id

状態

フィードバック

その他のリソース

キャンペーンの除外動的検索広告のターゲットレコード - 一括