次の方法で共有

広告グループ製品パーティション レコード - 一括

  • [アーティクル]

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

次に説明するように検証規則が満たされている限り、同じ一括ファイル内の複数の広告グループの広告 グループ製品パーティション レコードをアップロードできます。

  • 少なくとも、製品パーティション グループ ツリー構造のルート ノードを少なくとも指定する必要があります。 製品パーティション グループのルート ノードには、 Product Condition 1 フィールドが "All" に設定され、 Product Value 1 が null または空である必要があります。 カタログ内のすべての製品に均等に入札する場合は、[ サブタイプ ] フィールドを [単位] に設定します。 特定の製品条件に基づいて入札をパーティション分割する場合は、[ サブタイプ ] フィールドを [サブディビジョン] に、 親基準 ID を null または空に、 ID を 負の値に設定します。 負の値は、任意の子ノードの 親基準 ID として使用します。

  • ルート ノードはレベル 0 と見なされ、ツリーの深さは最大 7 レベルまで分岐できます。

  • アップロード要求ごとに、広告グループごとに最大 20,000 個の製品パーティション ツリー ノードを含めることができます。 広告グループの製品パーティション ツリー ノードの数全体が 20,000 を超えることはできません。

  • 同じツリー (同じ広告グループ) の製品パーティション ツリー ノードは、ファイル内でグループ化する必要があります。

  • 製品パーティション ノードの順序はダウンロード中に保証されず、親ノードは子ノードの後に提供される場合があります。ただし、同じ広告グループのすべてのノードがファイルにグループ化されます。

  • ツリー構造を作成または変更する場合は、親製品パーティション ツリー ノードを子製品パーティション ツリー ノードの前に並べ替える必要があります。ただし、注文は、入札の更新などの構造以外の変更には関係ありません。 たとえば、ツリー構造を追加、削除、更新せずに入札を更新する場合は、 ID、 親 ID、 入札 フィールドのみをアップロードする必要があります。

  • [Product Condition 1]、[Product Value 1]、[Is Excluded]\(製品条件 1\) フィールドを更新するには、既存の製品パーティション ツリー ノードを削除し、新しい製品パーティション ツリー ノードをアップロードして、新しい識別子を取得する必要があります。

  • いずれかのアクションが失敗した場合、それ以外の場合に成功した可能性がある残りのアクションもすべて失敗します。

  • すべての製品パーティション ノードの追加および削除アクションは、完全なツリー構造になる必要があります。

  • ルート ノードからブランチの末尾までのすべてのパスは、リーフ ノード (Sub Type=Unit) で終了する必要があります。 [除外される] フィールド が TRUE でない限り、すべてのユニットに入札が必要です。これは、ノードが負の広告グループ条件であることを意味します。

  • 各サブディビジョンには、サブディビジョンの条件の残りの部分に入札するリーフ ノードが少なくとも 1 つ必要です。つまり、その兄弟単位と同じオペランドを使用し、 Product Value 1 null または empty を設定します。

  • 親と子の両方がまだ存在しない複数のレベルのパーティションを追加する場合は、負の int 値を参照として使用して親を識別します。 たとえば、親の ID と子の 親基準 ID フィールドの両方を同じ負の値に設定します。 負の ID は、呼び出しの期間中のみ有効です。 正常に追加された広告グループの条件ごとに一意のシステム識別子がアップロード結果ファイルに返されます。

  • [ 入札 ] フィールドと [ 変換先 URL] フィールドは、[ 除外 される] フィールドが FALSE の場合にのみ適用されます。これは、ノードが入札可能な広告グループの条件であることを意味します。 ただし、 サブディビジョン パーティション ノードの場合、これらのフィールドは無視されます。 これらの要素は、 ユニット (リーフ) パーティション ノードにのみ関連します。

  • 製品パーティションを一時停止するには、広告グループの [状態] フィールドを [一時停止] に更新して 、広告グループ 全体を一時停止する必要があります。 キャンペーン全体を一時停止するには、[キャンペーン] の [状態] フィールドを [一時停止] に更新します。

  • 削除済みアクションの場合は、ID と親 ID のみを指定する必要があります。

  • 親製品パーティションを削除すると、そのすべての子と子孫も削除されます。

  • ブランチで重複する製品条件を指定することはできません。

ヒント

Microsoft ショッピング キャンペーンの概要と詳細については、 製品広告 と スマート ショッピング キャンペーン のテクニカル ガイドを参照してください。

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

次の一括 CSV の例では、有効な 親 ID 値が指定されている場合に、新しい広告グループ製品パーティションを追加します。

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Product Condition 1,Product Value 1,Is Excluded,Parent Criterion Id,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,6.0,,,,,,,
Ad Group Product Partition,Paused,,-1112,,,,ClientIdGoesHere,,0.5,,All,,FALSE,,,,{_promoCode}=PROMO1; {_season}=summer

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupProductPartition
var bulkAdGroupProductPartition = new BulkAdGroupProductPartition
{
    // Map properties in the Bulk file to the BiddableAdGroupCriterion or
    // NegativeAdGroupCriterion object of the Campaign Management service.
    // Use the BiddableAdGroupCriterion to set the 'Is Excluded' field in the Bulk file to True,
    // and otherwise use the NegativeAdGroupCriterion to set the 'Is Excluded' field to False.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new ProductPartition { 
            Condition = new ProductCondition
            {
                // 'Product Value 1' column header in the Bulk file
                Attribute = null,
                // 'Product Condition 1' column header in the Bulk file
                Operand = "All",
            },
            // 'Parent Criterion Id' column header in the Bulk file
            ParentCriterionId = null
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
            Amount = 0.50
        },
        // 'Destination Url' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        DestinationUrl = null,
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // 'Tracking Template' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupProductPartition);

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

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

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

広告グループ

製品パーティションを含む広告グループの名前。

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

注:

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

Bid

オークションで入札する金額。

注:

スポンサー製品用に設定されている Microsoft ショッピング キャンペーンの広告グループの場合、広告グループの [Bid Option]\(入札オプション \) が BidBoost に設定されている場合、このフィールドは適用されません。 詳細については、「 入札単価調整 」を参照してください。

追加：Is Excluded が FALSE で、サブタイプが Unit の場合は必須で、それ以外の場合は入札は許可されません。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

入札単価調整

スポンサー製品の入札を柔軟にする割合 (0 より大きい)。

たとえば、パートナーが商品グループで 5 米ドルを入札したとします ( [入札 ] フィールドを使用)。 入札単価調整 (このフィールド) が 20 (パーセント) に設定されていて、広告グループの 最大入札価格 が 0.50 (50 セント) の場合、共有額は 1 米ドルではなく 50 セントになります。

このフィールドは、広告グループの [入札オプション ] が BidBoost に設定されている場合にのみ適用されます。 広告グループの [Bid Option]\(入札オプション \) が BidValue に設定されている場合、オークションでは商品グループの Bid が使用されます。

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

注:

この設定は、スポンサー製品用に設定されている Microsoft ショッピング キャンペーンの広告グループにのみ適用されます。 スポンサー製品は、米国でのみ利用可能であり、現在オープンベータ段階です。

追加： オプション。 含まれていない場合、入札単価調整は既定値の 0 に設定されます。
更新： 必須
削除： 読み 取り 専用

キャンペーン

広告グループと製品パーティションを含むキャンペーンの名前。

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

クライアント ID

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

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

カスタム パラメーター

URL 追跡用のキーパラメーターと値パラメーターのカスタム コレクション。

一括ファイルでは、カスタム パラメーターの一覧は次のように書式設定されます。

  • 各カスタム パラメーター ペアを Key=Value (例: {_promoCode}=PROMO1) として書式設定します。

  • Microsoft Advertising は、含める最初の 8 つのカスタム パラメーター キーと値のペアを受け入れ、8 つ以上のカスタム パラメーターを含める場合はエラーが返されます。

  • 各キーと値のペアは、セミコロンとスペース ("; ") で区切られます (例: {_promoCode}=PROMO1;{_season}=summer.

  • Key にはセミコロンを含めることはできません。 Value にセミコロンが含まれている場合は、'\;' としてエスケープする必要があります。 さらに、Value に円記号が含まれている場合は、'\' としてもエスケープする必要があります。

  • キーは 16 UTF-8 バイトを超えることはできません。値は 250 UTF-8 バイトを超えることはできません。 キーは必須であり、値は省略可能です。 Key の最大サイズには、中かっことアンダースコア ('{'、'_'、'}' は含まれません。

    注:

    Bulk サービスでは、Key は周囲の中かっこと先頭のアンダースコアで書式設定する必要があります。たとえば、Key が promoCode の場合は、{_promoCode} として書式設定する必要があります。 キャンペーン管理サービスでは、周囲の中かっことアンダースコアを指定できません。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 すべてのカスタム パラメーターを削除するには、このフィールドを delete_value に設定します。 delete_value キーワード (keyword)では、前の設定が削除されます。 カスタム パラメーターのサブセットを削除するには、保持するカスタム パラメーターを指定し、保持しないパラメーターを省略します。 カスタム パラメーターの新しいセットは、以前のカスタム パラメーター セットに置き換えられます。
削除： 読み 取り 専用

宛先 URL

ユーザーが広告をクリックしたときに取得される Web ページの URL。

現在宛先 URL を使用している場合は、最終的に追跡テンプレートに置き換える必要があります。 詳細については、「 アップグレードされた URL を使用した URL 追跡」を参照してください。

URL には、{MatchType} などの動的パラメーターを含めることができます。 サポートされているパラメーターの一覧については、Microsoft Advertising のヘルプ記事「 どのような追跡パラメーターまたは URL パラメーターを使用できますか?」を参照してください。

URL には、最大 1,024 文字を含めることができます。 URL でプロトコルが指定されていない場合、ユーザーが広告をクリックすると、システムは HTTP プロトコルを使用します。 広告を追加するときに URL で HTTP プロトコルが指定されている場合、サービスは http:// プロトコル文字列を削除します (HTTP プロトコル文字列は 1,024 文字の制限に対してカウントされません)。ただし、サービスは URL から HTTPS プロトコル文字列 (https://) を削除しません。

注:

この宛先 URL は、指定した場合に使用されます。それ以外の場合、宛先 URL は、Microsoft Merchant Center カタログの製品オファーに対して指定した 'リンク' の対応する値によって決まります。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用

最終 URL サフィックス

最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用

Id

製品パーティションのシステム生成識別子。

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

除外されます

製品パーティションが入札可能な条件と負の条件のどちらを表すかを決定します。

TRUE に設定すると負の条件になり、それ以外の場合は FALSE の場合は入札可能な条件になります。

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

変更時刻

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

注:

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

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

親基準 ID

親製品パーティションの条件識別子。

注:

このフィールドは、親を持たないツリー ルート製品パーティション ノードには適用できません。

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

Parent Id

製品パーティションを含む広告グループのシステム生成識別子。

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

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

注:

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

製品条件 1

条件のオペランド。 オペランドには、equal 演算子が暗黙的に含まれます。 たとえば、「 Brand as Brand=」と読むことができます。

Product Value 1 のオペランドとして Product Condition 1 を使用します。

Microsoft ショッピング キャンペーンと広告グループごとに、複数の製品条件を指定できます。 各条件は、製品の属性値がオペランドの属性値と等しい場合に満たされます。 たとえば、オペランドが Brand に設定され、属性が Contoso に設定されている場合、製品カタログの Brand 属性の値が Contoso と等しい場合、条件が満たされます。

ショッピング キャンペーンでは、製品の条件をキャンペーンレベルと広告グループレベルで設定できます。 次の表では、 キャンペーン製品スコープ レコードと 広告グループ製品パーティション レコードの製品条件 (オペランド) と製品値 (属性) ビジネス ルールについて説明します。

製品条件 (オペランド) 製品値 (属性) 説明 キャンペーン製品のスコープルール 広告グループの製品パーティションルール
すべて null にする必要があります。 該当なし。 広告グループの製品パーティションの場合、ルート ノードにはオペランドを "すべて" に設定し、属性を null または空に設定する必要があります。
ブランド 製品の製造元、ブランド、または発行元。

最大 1,000 文字。		 [ブランド] オペランドは、キャンペーン製品のスコープ フィルターごとに 1 回だけ指定できます。 Brand オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。
CategoryL1-5

CategoryL1、CategoryL2、CategoryL3、CategoryL4、CategoryL5 の 5 つのカテゴリ オペランド値を使用できます。		 Microsoft Merchant Center ストアによって定義された製品カテゴリ。 有効な カテゴリ 値と分類については、Bingカテゴリ分類に関するページを参照してください。

CategoryL0 は最上位のカテゴリで、CategoryL4 は最も低いレベルまたは最も詳細なカテゴリです。

最大 100 文字。		 CategoryL オペランドはそれぞれ、キャンペーン製品スコープ フィルターごとに 1 回使用できます。

オペランドが 1 から 5 の製品カテゴリに設定された製品条件を指定した場合、
これらは昇順で指定する必要があります。 たとえば、前の製品条件に "Animals & Pet Supplies" 属性を持つオペランド "CategoryL1" がある場合、オペランドを "Pet Supplies" 属性で "CategoryL2" に設定できます。		 CategoryL オペランドはそれぞれ複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 たとえば、あるブランチには CategoryL1 と CategoryL2 が含まれる場合がありますが、 CategoryL2 オペランドを持つ別のノードが含まれていない場合があります。

オペランドを 1 から 5 までの製品カテゴリに設定する場合は、昇順で指定する必要があります。 たとえば、上位レベルの製品パーティションに属性 "Animals & Pet Supplies" を持つオペランド "CategoryL1" がある場合、オペランドは属性 "Pet Supplies" で "CategoryL2" に設定できます。

前のレベルの製品カテゴリ オペランドは、直接の親パーティションで指定する必要はありません。 たとえば、親の親が CategoryL1 条件を指定した場合、製品パーティションに CategoryL2 条件を指定できます。
チャネル ローカル インベントリ広告 (LIA) チャネル。

使用可能な値には、"ローカル ストア" と "オンライン" があります。

キャンペーンが ローカル インベントリ広告にオプトインしていない場合、すべてのオファーは既定でオンラインのみ (Channel=Online) と単一チャネル (ChannelExclusivity=単一チャネル) になります。 詳細については、 ローカル インベントリ広告 のヘルプ ページを参照してください。		 Channel オペランドは、キャンペーン製品スコープ フィルターごとに 1 回だけ指定できます。 Channel オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。
ChannelExclusivity ローカル インベントリ広告 (LIA) チャネルの排他性。

指定できる値には、"単一チャネル" と "マルチチャネル" があります。

キャンペーンが ローカル インベントリ広告にオプトインしていない場合、すべてのオファーは既定でオンラインのみ (Channel=Online) と単一チャネル (ChannelExclusivity=単一チャネル) になります。 詳細については、 ローカル インベントリ広告 のヘルプ ページを参照してください。		 ChannelExclusivity オペランドは、キャンペーン製品スコープ フィルターごとに 1 回だけ指定できます。 ChannelExclusivity オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。
条件 製品の条件。

オペランドが Condition に設定されている場合、指定できるサポートされる属性値は New、 Used、および Refurbished です。		 Condition オペランドは、キャンペーン製品のスコープ フィルターごとに 1 回だけ指定できます。 Condition オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。
CustomLabel0-4

CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3、CustomLabel4 など、5 つのカスタム ラベル オペランド値を使用できます。		 マーチャントによって定義されたカスタム ラベル。

CustomLabel0 や CustomLabel4 などのカスタム ラベルは、どの階層にも基づいて検証されません。

最大 100 文字。

このオペランドは スポンサー製品には適用されません。		 各 CustomLabel オペランドは、キャンペーン製品スコープ フィルターごとに 1 回使用できます。 各 CustomLabel オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 たとえば、あるブランチには CustomLabel0 と CustomLabel1 が含まれている場合がありますが、 CustomLabel1 オペランドを持つ別のノードは含まれていない場合があります。
GTIN マーチャントによって定義されたグローバル貿易項目番号。

GTIN フィールドには 50 文字の制限があり、各 GTIN 値は最大 14 桁です。

このオペランドは 、スポンサー製品にのみ適用されます。		 GTIN オペランドは、キャンペーン製品スコープ フィルターごとに 1 回だけ指定できます。 GTIN オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。
Id マーチャントによって定義された製品識別子。

最大 1,000 文字。		 [Id] オペランドは、キャンペーン製品のスコープ フィルターごとに 1 回だけ指定できます。 Id オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。
Mpn マーチャントによって定義されたグローバル貿易項目番号。

最大 70 文字。

このオペランドは 、スポンサー製品にのみ適用されます。		 MPN オペランドは、キャンペーン製品スコープ フィルターごとに 1 回だけ指定できます。 MPN オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。
ProductType1-5

ProductType1、ProductType2、ProductType3、ProductType4、ProductType5 の 5 つの製品型オペランド値を使用できます。		 マーチャントによって定義された製品の種類またはカテゴリ。

ProductType1 は最高レベルの製品タイプで、ProductType5 は最も低いレベルまたは最も細かい製品の種類です。

最大 100 文字。

このオペランドは スポンサー製品には適用されません。		 各製品の種類のオペランドは、キャンペーンの製品スコープ フィルターごとに 1 回使用できます。

オペランドが 1 から 5 の製品タイプに設定された製品条件を指定した場合、
これらは昇順で指定する必要があります。 たとえば、前の製品条件に属性 "Animals & Pet Supplies" を持つオペランド "ProductType1" がある場合は、オペランドを "Pet Supplies" 属性で "ProductType2" に設定できます。		 各 ProductType オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 たとえば、1 つのブランチに ProductType1 と ProductType2 が含まれている場合がありますが、 ProductType2 オペランドを持つ別のノードが含まれていない場合があります。

オペランドを 1 から 5 までの製品の種類に設定する場合は、昇順で指定する必要があります。 たとえば、上位レベルの製品パーティションに属性 "Animals & Pet Supplies" を持つオペランド "ProductType1" がある場合、オペランドは属性 "Pet Supplies" で "ProductType2" に設定できます。

前のレベルの積の種類のオペランドは、直接の親パーティションで指定する必要はありません。 たとえば、親の親が ProductType1 条件を指定した場合、ProductType2 条件を製品パーティションに指定できます。

追加： 必須
更新： 読み 取り 専用。 条件フィールドまたは値フィールドを更新することはできません。 条件を更新するには、製品パーティションを削除し、新しいパーティションを追加する必要があります。
削除： 読み 取り 専用

製品価値 1

条件の属性値。

属性の値は、顧客の Microsoft Merchant Center カタログ ファイルで指定された値と完全に一致している必要があります。

追加： 必須
更新： 読み 取り 専用。 条件フィールドまたは値フィールドを更新することはできません。 条件を更新するには、製品パーティションを削除し、新しいパーティションを追加する必要があります。
削除： 読み 取り 専用

状態

製品パーティションの状態。

使用可能な値は [アクティブ] または [削除済み] です。

追加： オプション。 使用可能な状態は [アクティブ] のみです。 状態を [削除済み] に設定すると無視され、返されたレコードの状態が [アクティブ] に設定されます。
更新： オプション
削除： 必須。 [状態] を [削除済み] に設定する必要があります。

Sub Type

製品パーティションの種類。

可能な値は 、サブディビジョン と ユニットです。

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

追跡テンプレート

追跡テンプレートは、 Content API を介して送信した製品オファーの [リンク] フィールドに指定された URL と組み合わせて使用できます。 フィード URL と追跡テンプレートを組み合わせることで、ランディング ページ URL が組み立てられます。この URL は、広告をクリックした後にユーザーが誘導されます。 [追跡テンプレート] フィールドを使用して、フィード URL で URL パラメーターを更新するのではなく、URL パラメーターを更新する場合、フィード URL は編集レビューを通過する必要がないため、広告は中断なく配信されます。 たとえば、カタログ フィードの製品オファー URL が である場合は https://contoso.com/、次の追跡テンプレート {lpurl}?matchtype={matchtype}&device={device}を指定できます。

追跡テンプレートには、次の検証規則が適用されます。 サポートされているテンプレートとパラメーターの詳細については、Microsoft Advertising のヘルプ記事「 どのような追跡または URL パラメーターを使用できますか?」を参照してください。

  • 広告など、下位レベルのエンティティに対して定義された追跡テンプレートは、キャンペーンなどの上位レベルのエンティティに対する設定をオーバーライドします。 詳細については、「 エンティティの制限」を参照してください。

  • 追跡テンプレートの長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。

  • 追跡テンプレートは、 http://、 https://、 {lpurl}、または {unescapedlpurl} のいずれかで始まる適切な形式の URL である必要があります。

  • Microsoft Advertising では、カスタム パラメーターが存在するかどうかを検証しません。 追跡テンプレートでカスタム パラメーターを使用し、それらが存在しない場合、ランディング ページ URL には、代替なしでカスタム パラメーターのキーと値のプレースホルダーが含まれます。 たとえば、トラッキング テンプレートが でhttps://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}、キャンペーン、広告グループ、条件、キーワード (keyword)、または広告レベルで {_season} または {_promocode} が定義されていない場合、ランディング ページの URL は同じになります。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用