動的検索広告ラベル レコード - 一括
動的検索広告とラベルの間の関連付けレコードを定義し、一括ファイルでアップロードおよびダウンロードできます。 動的検索広告またはラベルをアップロードまたはダウンロードするには、 動的検索広告 または ラベル レコードを使用します。
動的検索広告ラベル レコードは、有効な動的検索広告設定を持つ検索キャンペーン内でのみ作成できます ( [ドメイン言語]、[ 動的説明が有効]、[ ページ フィード ID]、[ ソース]、および [Web サイト ] フィールドで構成されます)。 キャンペーンの 実験 ID を 設定し、 広告グループの種類 を "SearchDynamic" に設定する必要があります。
DownloadCampaignsByAccountIds またはDownloadCampaignsByCampaignIds サービス要求に DynamicSearchAdLabels の DownloadEntity 値を含めることで、アカウント内のすべての動的検索広告ラベル レコードをダウンロードできます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。
次の一括 CSV の例では、有効な ID と親 ID の値が指定されている場合、動的検索広告にラベル を 適用します。
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Dynamic Search Ad Label,,-22,-11112,,,ClientIdGoesHere,,,,,
.NET、Java、または Python 用 の Bing Ads SDK を 使用している場合は、 BulkServiceManager を使用して、サービス操作を直接呼び出し、カスタム コードを記述してバルク ファイル内の各フィールドを解析する代わりに、 BulkServiceManager を使用して BulkDynamicSearchAdLabel オブジェクトをアップロードしてダウンロードする時間を節約できます。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkDynamicSearchAdLabel
var bulkDynamicSearchAdLabel = new BulkDynamicSearchAdLabel
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// LabelAssociation object of the Campaign Management service.
LabelAssociation = new LabelAssociation
{
// 'Parent Id' column header in the Bulk file
EntityId = dynamicSearchAdIdKey,
// 'Id' column header in the Bulk file
LabelId = labelIdKey
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkDynamicSearchAdLabel);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
動的検索広告ラベル レコードの場合は、一括ファイル スキーマで次の属性フィールドを使用できます。
クライアント ID
一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。
追加： オプション
削除： 読み 取り 専用
Id
動的検索広告に適用または削除されるラベルの識別子。
この一括フィールドは、ラベル レコードの Id フィールドにマップされます。
追加： 読み取り専用と必須。 既存のラベル識別子を指定するか、親 Label レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイル内の動的検索広告に新しいラベルを適用する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
削除： 読み取り専用と必須
変更時刻
エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。
注:
日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
追加： 読み 取り 専用
削除： 読み 取り 専用
Parent Id
このラベルが適用または削除される動的検索広告の識別子。
この一括フィールドは、動的検索広告レコードの Id フィールドにマップされます。
追加： 読み取り専用と必須。 既存の動的検索広告識別子を指定するか、親動的検索広告レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイル内の新しい動的検索広告にラベルを適用する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
削除： 読み取り専用と必須
状態
動的検索広告とラベルの間に適用された状態を表します。
有効な値は [アクティブ] と [削除済み] です。 動的検索広告にラベルが適用されている場合、このフィールドの値は [アクティブ] になります。
追加： 読み 取り 専用
削除： 必須。 [状態] を [削除済み] に設定する必要があります。