キャンペーンインプレッションベースのリマーケティング リストの関連付けレコード - 一括

  • [アーティクル]

一括ファイルでアップロードおよびダウンロードできるキャンペーン インプレッション ベースのリマーケティング リストの関連付けを定義します。

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

ヒント

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

アカウント内のすべてのキャンペーン インプレッション ベースのリマーケティング リスト関連付けレコードをダウンロードするには、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス 要求に CampaignImpressionBasedRemarketingListAssociations の 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 Impression Based Remarketing List Association,Paused,,-1111,,,ClientIdGoesHere,,10,,ImpressionBasedRemarketingListIdHere,My Impression Based Remarketing List

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignImpressionBasedRemarketingListAssociation
var bulkCampaignImpressionBasedRemarketingListAssociation = new BulkCampaignImpressionBasedRemarketingListAssociation
{
    // Map properties in the Bulk file to the 
    // BiddableCampaignCriterion object of the Campaign Management service.
    BiddableCampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new AudienceCriterion
        {
            // 'Audience Id' column header in the Bulk file
            AudienceId = impressionBasedRemarketingListIdKey,
        },
        // 'Bid Adjustment' column header in the Bulk file
        CriterionBid = new BidMultiplier
        {
            Multiplier = 10
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = CampaignCriterionStatus.Paused
    },
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Audience' column header in the Bulk file
    AudienceName = null,
};

uploadEntities.Add(bulkCampaignImpressionBasedRemarketingListAssociation);

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

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

キャンペーンインプレッションベースのリマーケティング リスト関連付けレコードの場合、一括ファイル スキーマでは次の属性フィールドを使用できます。

Audience

インプレッション ベースのリマーケティング リストの名前。

この一括フィールドは、インプレッション ベースのリマーケティング リスト レコードの [対象ユーザー] フィールドにマップされます。

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

対象ユーザー ID

キャンペーンに関連付けられているインプレッション ベースのリマーケティング リストの Microsoft 広告識別子。

この一括フィールドは、インプレッション ベースのリマーケティング リスト レコードの Id フィールドにマップされます。

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

入札単価調整

インプレッション ベースのリマーケティング リストの入札単価を増減する割合。

サポートされる値は、負の 90 (-90.00) から正の 900 (900.00) です。

重要

指定しない場合、既定の入札単価調整値は 0 です。 既定値は変更される可能性があります。

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

キャンペーン

インプレッション ベースのリマーケティング リストに関連付けられているキャンペーンの名前。

足す： 読み取り専用と必須
更新： 読み取り専用と必須
削除： 読み取り専用と必須

注:

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

クライアント ID

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

足す： 随意
更新： 随意
削除： 読み取り専用

Id

キャンペーンとインプレッションベースのリマーケティング リストの関連付けのシステム生成識別子。

足す： 読み取り専用
更新： 読み取り専用と必須
削除： 読み取り専用と必須

変更時刻

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

注:

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

Parent Id

インプレッション ベースのリマーケティング リストに関連付けられているキャンペーンのシステム生成識別子。

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

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

注:

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

状態

関連付けの状態。

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

足す： 随意。 既定の状態値は [アクティブ] です。
更新： 随意
削除： 必須。 [状態] を [削除済み] に設定する必要があります。