次の方法で共有

製品広告レコード - 一括

  • [アーティクル]

一括ファイルでダウンロードおよびアップロードできる製品広告を定義します。

製品広告は、配信された広告コピーに直接使用されません。 代わりに、配信エンジンは、顧客の Microsoft Merchant Center ストア カタログで見つけた製品の詳細から製品広告を生成します。

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

次の一括 CSV の例では、有効な 親 ID 値が指定されている場合に新しい製品広告を追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Product Ad,Active,,-1112,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,,,Find New Customers & Increase Sales!,,,,,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkProductAd
var bulkProductAd = new BulkProductAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ProductAd object of the Campaign Management service.
    ProductAd = new ProductAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Promotion' column header in the Bulk file
        PromotionalText = "Find New Customers & Increase Sales!",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
    },
};

uploadEntities.Add(bulkProductAd);

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

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

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

広告グループ

広告を含む広告グループの名前。

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

注:

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

キャンペーン

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

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

クライアント ID

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

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

編集上の申し立てステータス

編集レビューで見つかった問題に異議を申し立てることができるかどうかを判断します。

使用可能な値については、次の表を参照してください。

値 説明
上訴可能 編集上の問題は申し立て可能です。
異議申し立て中 編集上の問題は控訴可能であり、控訴が提出されました。
NotAppealable 編集上の問題は不服として申し立てられない。

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

編集場所

編集レビューに失敗した広告のコンポーネントまたはプロパティ。

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

編集理由コード

エラーの理由を識別するコード。 考えられる理由コードの一覧については、「 編集理由コード」を参照してください。

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

編集状態

広告の編集状態。

使用可能な値については、次の表を参照してください。

値 説明
能動 広告は編集レビューに合格しました。
ActiveLimited 広告は 1 つ以上の市場で編集レビューに合格し、広告の 1 つ以上の要素が別の市場で編集レビューを受けています。 たとえば、広告はカナダの編集レビューに合格し、米国のレビューがまだ保留中です。
不承認 広告の編集レビューに失敗しました。
非アクティブ 広告の 1 つ以上の要素が編集レビュー中です。

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

編集用語

編集レビューに失敗した用語。

用語の組み合わせによってエラーが発生した場合、またはポリシー違反に基づいて失敗した場合、このフィールドは設定されません。

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

Id

広告のシステム生成識別子。

足す： 随意。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 その後、広告の負の識別子セットは、製品広告ラベルなどの依存レコードタイプの [親 ID] フィールドで参照できます。 これは、同じ Bulk ファイルに新しい広告と新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

変更時刻

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

注:

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

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

Parent Id

広告を含む広告グループのシステム生成識別子。

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

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

注:

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

発行元の国

編集ガイドラインで指定した 用語が許可されていない発行元の国または地域の一覧。

一括ファイルでは、発行元の国またはリージョンの一覧はセミコロン (;)で区切られます。

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

状態

広告の状態。

注:

2024 年 12 月 3 日の時点で、製品広告レコードの Bulk API では削除操作がサポートされなくなります。 これは、製品広告エンティティがシステム生成されるためです。

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

足す： 随意。 既定値は [アクティブ] です。
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。