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

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

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

• 少なくとも、製品パーティション グループ ツリー構造のルート ノードを少なくとも指定する必要があります。 製品パーティション グループのルート ノードには、 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 のみを指定する必要があります。

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

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

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 レコードの場合、一括ファイル スキーマでは次の属性フィールドを使用できます。

• 広告グループ
• Bid
• 入札単価調整
• Campaign
• クライアント ID
• カスタム パラメーター
• 宛先 URL
• 最終 URL サフィックス
• Id
• 除外されます
• 変更時刻
• 親基準 ID
• Parent Id
• 製品条件 1
• 製品価値 1
• 状態
• Sub Type
• 追跡テンプレート

広告グループ

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

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

Bid

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

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

入札単価調整

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

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

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

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

足す： 随意。 含まれていない場合、入札単価調整は既定値の 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://) を削除しません。

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

最終 URL サフィックス

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

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

Id

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

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

除外されます

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

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

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

変更時刻

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

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

親基準 ID

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

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

Parent Id

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

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

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

製品条件 1

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

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

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

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

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

製品価値 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 文字列に設定すると、前の設定は削除されます。
削除： 読み取り専用