広告グループの否定的な顧客リストの関連付けレコード - 一括

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

一括ファイルでアップロードおよびダウンロードできる広告グループの否定的な顧客リストの関連付けを定義します。

対象ユーザーのターゲットをキャンペーンと広告グループの両方のレベルに設定することはできません。入札可能なキャンペーンレベルのオーディエンス条件を設定した場合、入札可能な広告グループレベルのオーディエンス条件を設定することはできません。対象ユーザーの除外は、キャンペーンレベルと広告グループレベルの両方で設定できます。 Microsoft Advertising では、キャンペーンと広告グループレベルの両方の除外の和集合が適用されます。

ヒント

対象ユーザーの概要と詳細については、対象ユーザー API のテクニカルガイドを参照してください。

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

次の一括 CSV の例では、有効な親 ID 値が指定されている場合、新しい Ad Group Negative Customer List Association を追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Ad Group Negative Customer List Association,Paused,,-1111,,,ClientIdGoesHere,,,,CustomerListIdHere,My Customer List

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

広告グループ
対象ユーザー
対象ユーザー ID
キャンペーン
クライアント ID
Id
変更時刻
Parent Id
状態

広告グループ

顧客リストに関連付けられている広告グループの名前。

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

注:

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

対象ユーザー

顧客リストの名前。

この一括フィールドは、顧客リストレコードの [対象ユーザー] フィールドにマップされます。

追加： 一部のユースケースでは、読み取り専用と必須。 [ 対象ユーザー ] フィールドまたは [ 対象ユーザー ID ] フィールドを指定する必要があります。同じ一括ファイルに新しい顧客リストを含む新しい広告グループの否定的な顧客リストの関連付けを追加し、[対象ユーザー ID] フィールドを設定しない場合は、この対象ユーザーフィールドを顧客リストレコードの [対象ユーザー] フィールドと同じ値に論理キーとして設定する必要があります。詳細については、「一括ファイルスキーマ参照キー」を参照してください。
更新： 読み取り専用
削除： 読み取り専用

対象ユーザー ID

広告グループに関連付けられている顧客リストの Microsoft Advertising 識別子。

この一括フィールドは、顧客リストレコードの Id フィールドにマップされます。

追加： 一部のユースケースでは、読み取り専用と必須。 [ 対象ユーザー ] フィールドまたは [ 対象ユーザー ID ] フィールドを指定する必要があります。 [対象ユーザー ID] フィールドを設定する場合は、既存の顧客リスト識別子を指定するか、親顧客リストレコードの Id フィールドと等しい負の識別子を指定する必要があります。対象ユーザー ID フィールドが設定されていない場合は、[対象ユーザー] フィールドを論理キーとして [顧客リスト] レコードの [対象ユーザー] フィールドと同じ値に設定する必要があります。同じ一括ファイルに新しい顧客リストを含む新しい広告グループの否定的な顧客リストの関連付けを追加する場合は、これらのオプションのいずれかをお勧めします。詳細については、「一括ファイルスキーマ参照キー」を参照してください。
更新： 読み取り専用
削除： 読み取り専用

キャンペーン

広告グループを含むキャンペーンの名前。

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

クライアント ID

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

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

Id

広告グループと顧客リストの間の関連付けのシステム生成識別子。

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

変更時刻

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

注:

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

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

Parent Id

顧客リストに関連付けられている広告グループのシステム生成識別子。

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

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

注: