マーケットオーディエンスレコード - 一括

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

一括ファイルでダウンロードできる市場内対象ユーザーを定義します。

注:

この機能は、AD、AR、AT、 AU、AW、BD、BE、BG、BN、BO、BR、BS、CA、CH、CL、CO、CR、CY、CZ、DE、DK、DM、DO、EC、EE、ES、FI、FJ、FR、GF、GR、GT、GU、GY、HN、HR、HT、HU、ID、IE、IN、IT、KY、LI、LK、LT、LU、LV、LV、MN、MQ、MQ MS、MT、MV、MX、MY、NC、NL、NO、NP、NZ、PA、PE、PF、PG、PH、PL、PR、PT、PY、RO、SE、SG、SI、SK、SM、SV、TH、TT、UK、US、UY、VA、VE、VN。

注:

一括アップロードはサポートされていません。 Bing広告 API を使用して、市場内オーディエンスを追加、更新、または削除することはできません。とはいえ、市場内の対象ユーザーの関連付けと除外を追加および削除できます。 Bing広告 API は、現在アクティブな市場内のすべての対象ユーザーを常に返します。サービスは、削除された市場の対象ユーザーや、変更された内容を確認するための差分ダウンロードを返しません。 Bing広告 API を介して返される市場内オーディエンスは、AU、CA、DE、FR、英国、米国など、すべての市場で利用可能なすべての市場内オーディエンスの和集合です。対象ユーザーネットワークサイズと対象ユーザー検索サイズは、対応するネットワーク内の特定の市場の対象ユーザーに対してサポートされているすべての市場のリストサイズの合計です。 Bing Ads API では、市場ごとのリストサイズの詳細は提供されません。たとえば、Bing広告 API を使用して、検索ネットワーク内の "広告とマーケティング" の市場内オーディエンスサイズが17070879 (17.1M) として返される場合があります。 Microsoft Advertising Web アプリケーションに表示される市場ごとの内訳は、米国では 2.88M です。AU では 474K。英国では 13.7M。
サンドボックスの市場の対象ユーザーに依存関係を持ち込むべきではありません。市場内の一部の対象ユーザーはサンドボックスで利用できますが、運用環境では使用できません。また、市場内の対象ユーザーのプロパティ値は、サンドボックスと運用環境 (対象ユーザーの名前とサイズなど) によっても異なる場合があります。

ヒント

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

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

市場の対象ユーザー向けの一括 CSV のダウンロード例を次に示します。

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
In Market Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,In Market Audience Description,30,Account,In Market Audience,Search;DynamicSearchAds;Shopping;Audience

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

// Map properties in the Bulk file to the BulkInMarketAudience
var bulkInMarketAudience = new BulkInMarketAudience
{
    // Map properties in the Bulk file to the 
    // InMarketAudience object of the Campaign Management service.
    InMarketAudience = new InMarketAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "In Market Audience Description",
        // 'Id' column header in the Bulk file
        Id = InMarketAudienceIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "In Market Audience",
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

In Market Audience レコードの場合、一括ファイルスキーマでは次の属性フィールドを使用できます。

対象ユーザー
対象ユーザーのネットワークサイズ
対象ユーザーの検索サイズ
説明
Id
メンバーシップ期間
変更時刻
Parent Id
スコープ
状態
サポートされているキャンペーンの種類