キャンペーンの否定的な顧客リストの関連付けレコード - 一括
一括ファイルでアップロードおよびダウンロードできるキャンペーン否定的な顧客リストの関連付けを定義します。
対象ユーザーのターゲットをキャンペーンと広告グループの両方のレベルに設定することはできません。 入札可能なキャンペーン レベルのオーディエンス条件を設定した場合、入札可能な広告グループレベルのオーディエンス条件を設定することはできません。 対象ユーザーの除外は、キャンペーンレベルと広告グループレベルの両方で設定できます。 Microsoft Advertising では、キャンペーンと広告グループレベルの両方の除外の和集合が適用されます。
ヒント
対象ユーザーの概要と詳細については、 対象ユーザー API の テクニカル ガイドを参照してください。
アカウント内のすべての Campaign Negative Customer List Association レコードをダウンロードするには、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に CampaignNegativeCustomerListAssociations の DownloadEntity 値を含めます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。
次の一括 CSV の例では、有効な 親 ID 値が指定されている場合に、新しいキャンペーンの否定的な顧客リストの関連付けを追加します。
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Campaign Negative Customer List Association,Paused,,-1111,,,ClientIdGoesHere,,,,CustomerListIdHere,My Customer List
Campaign Negative Customer List Association レコードの場合、一括ファイル スキーマでは次の属性フィールドを使用できます。
対象ユーザー
顧客リストの名前。
この一括フィールドは、顧客リスト レコードの [対象ユーザー] フィールドにマップされます。
追加: 一部のユース ケースでは、読み取り専用と必須。 [ 対象ユーザー ] フィールドまたは [ 対象ユーザー ID ] フィールドを指定する必要があります。 同じ一括ファイルに新しい顧客リストを含む新しいキャンペーンの否定的な顧客リストの関連付けを追加する場合、対象ユーザー ID フィールドを設定しない場合、この対象ユーザー フィールドは顧客リスト レコードの対象ユーザー フィールドと同じ値に論理キーとして設定する必要があります。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新: 読み 取り 専用
削除: 読み 取り 専用
対象ユーザー ID
キャンペーンに関連付けられている顧客リストの Microsoft Advertising 識別子。
この一括フィールドは、顧客リスト レコードの Id フィールドにマップされます。
追加: 一部のユース ケースでは、読み取り専用と必須。 [ 対象ユーザー ] フィールドまたは [ 対象ユーザー ID ] フィールドを指定する必要があります。
[対象ユーザー ID] フィールドを設定する場合は、既存の顧客リスト識別子を指定するか、親顧客リスト レコードの Id フィールドと等しい負の識別子を指定する必要があります。
対象ユーザー ID フィールドが設定されていない場合は、[対象ユーザー] フィールドを論理キーとして [顧客リスト] レコードの [対象ユーザー] フィールドと同じ値に設定する必要があります。 同じ一括ファイルに新しい顧客リストを含む新しいキャンペーン否定的な顧客リストの関連付けを追加する場合は、これらのオプションのいずれかをお勧めします。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新: 読み 取り 専用
削除: 読み 取り 専用
キャンペーン
顧客リストに関連付けられているキャンペーンの名前。
追加: 読み取り専用と必須
更新: 読み取り専用と必須
削除: 読み取り専用と必須
クライアント ID
一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。
追加: オプション
更新: オプション
削除: 読み 取り 専用
Id
キャンペーンと顧客リストの間の関連付けのシステム生成識別子。
追加: 読み 取り 専用
更新: 読み取り専用と必須
削除: 読み取り専用と必須
変更時刻
エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。
注:
日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
追加: 読み 取り 専用
更新: 読み 取り 専用
削除: 読み 取り 専用
Parent Id
顧客リストに関連付けられているキャンペーンのシステム生成識別子。
この一括フィールドは、キャンペーン レコードの Id フィールドにマップされます。
追加: 読み取り専用と必須。 既存のキャンペーン識別子を指定するか、親キャンペーン レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、顧客リストを同じ Bulk ファイル内の新しいキャンペーンに関連付ける場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新: 読み取り専用と必須
削除: 読み取り専用と必須
状態
関連付けの状態。
使用可能な値は [アクティブ] または [削除済み] です。
追加: オプション。 既定の状態値は [アクティブ] です。
更新: オプション
削除: 必須。 [状態] を [削除済み] に設定する必要があります。