マーケットオーディエンス協会レコードでのキャンペーン - 一括

[アーティクル]
11/13/2024

一括ファイルでアップロードおよびダウンロードできるキャンペーンインマーケットオーディエンスアソシエーションを定義します。

注:

この機能は、オーストラリア、カナダ、フランス、ドイツ、イギリス、米国で利用できます。

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

ヒント

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

アカウント内のすべてのキャンペーン対象ユーザー関連付けレコードをダウンロードするには、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に CampaignInMarketAudienceAssociations の 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 In Market Audience Association,Paused,,-1111,,,ClientIdGoesHere,,10,,InMarketAudienceIdHere,My In Market Audience

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignInMarketAudienceAssociation
var bulkCampaignInMarketAudienceAssociation = new BulkCampaignInMarketAudienceAssociation
{
    // 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 = inMarketAudienceIdKey,
        },
        // '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(bulkCampaignInMarketAudienceAssociation);

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

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

[キャンペーンの対象ユーザーの関連付け] レコードの場合は、一括ファイルスキーマで次の属性フィールドを使用できます。

対象ユーザー
対象ユーザー ID
入札単価調整
キャンペーン
クライアント ID
Id
変更時刻
Parent Id
状態

対象ユーザー

市場の対象ユーザーの名前。

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

一括 API ダウンロードでは、市場の対象ユーザーがアクティブであるか削除されているかに関係なく、すべての市場内対象ユーザー関連付けが返されます。関連付けが削除された市場内対象ユーザーに対する場合、このフィールドは [対象ユーザー ID ] フィールドと同じ値に設定されます。

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

対象ユーザー ID

キャンペーンに関連付けられている市場内の対象ユーザーの Microsoft Advertising 識別子。

この一括フィールドは、[市場対象ユーザー] レコードの [Id] フィールドにマップされます。

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

入札単価調整

市場の対象ユーザーの入札金額を増減する割合。

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

重要

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

追加： オプション
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

キャンペーン

市場の対象ユーザーに関連付けられているキャンペーンの名前。

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

注:

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

クライアント ID

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

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

Id

キャンペーンと市場内オーディエンスの間の関連付けのシステム生成識別子。

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

変更時刻

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

注:

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

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

Parent Id

市場の対象ユーザーに関連付けられているキャンペーンのシステム生成識別子。

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

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

注: