ProductCondition データ オブジェクト - キャンペーン管理
顧客の Microsoft Merchant Center カタログ ファイルから製品を選択するかどうかを決定する条件を定義します。
キャンペーン レベルの制作条件は、ショッピング キャンペーン、フィードベースのオーディエンス キャンペーン、マルチメディア広告を使用した検索キャンペーン 、つまり Microsoft Merchant Center ストア ID を利用するキャンペーンで使用できます。 (注: 誰もがマルチメディア広告を含む検索キャンペーンをまだ持っているわけではありません。そうでない場合は、心配しないでください - それはすぐに来ています!広告グループレベルの商品条件は、ショッピング キャンペーンでのみ使用できます。 アセット グループ レベルの製品条件は、パフォーマンスの最大キャンペーンでのみ使用できます。 製品スコープを使用すると、キャンペーンに含めるカタログのアイテム (ブランドや条件でフィルター処理など) を選択できます。
構文
<xs:complexType name="ProductCondition" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="Attribute" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Operand" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Operator" nillable="true" type="xs:string">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
要素
ProductCondition オブジェクトには、Attribute、Operand、Operator という要素があります。
要素 | 説明 | データ型 |
---|---|---|
属性 | 条件の属性値。 属性の値は、顧客の Microsoft Merchant Center カタログ ファイルで指定された値と完全に一致している必要があります。 使用可能な 属性 と オペランド の値は、キャンペーンの種類によって異なります。 サポートされている属性とオペランドの値については、以下 の「備考 」を参照してください。 追加または適用: 必須 更新: 随意 |
string |
オペランド | 条件のオペランド。 オペランドには、equal 演算子が暗黙的に含まれます。 たとえば、「Brand as Brand=」と読みます。 追加または適用: 必須 更新: 随意 |
string |
オペレーター | ルール項目演算子。 足す: 必須 更新: 必須 |
string |
解説
キャンペーンの種類ごとにサポートされている製品条件 (オペランド) と製品値 (属性) については、次の表を参照してください。
Feed-Based オーディエンス キャンペーンの製品条件
フィードベースのオーディエンス キャンペーンごとに、複数の製品条件を指定できます。 各条件は、製品の属性値がオペランドの属性値と等しい場合に満たされます。 たとえば、オペランドが Brand に設定され、属性が Contoso に設定されている場合、製品カタログの Brand 属性の値が Contoso と等しい場合、条件が満たされます。
製品条件 (オペランド) | 製品値 (属性) 説明 | ビジネス ルール |
---|---|---|
ブランド | 製品の製造元、ブランド、または発行元。 最大 1,000 文字。 |
[ブランド] オペランドは、キャンペーン製品のスコープ フィルターごとに 1 回だけ指定できます。 |
条件 | 製品の条件。 オペランドが Condition に設定されている場合、指定できるサポートされる属性値は New、 Used、および Refurbished です。 |
Condition オペランドは、キャンペーン製品のスコープ フィルターごとに 1 回だけ指定できます。 |
ProductType1-5 ProductType1、ProductType2、ProductType3、ProductType4、ProductType5 の 5 つの製品型オペランド値を使用できます。 |
マーチャントによって定義された製品の種類またはカテゴリ。 ProductType1 は最高レベルの製品タイプで、ProductType5 は最も低いレベルまたは最も細かい製品の種類です。 最大 100 文字。 |
各製品の種類のオペランドは、キャンペーンの製品スコープ フィルターごとに 1 回使用できます。 オペランドを 1 から 5 までの製品の種類に設定する場合は、昇順で指定する必要があります。 たとえば、上位レベルの製品パーティションに属性 "Animals & Pet Supplies" を持つオペランド "ProductType1" がある場合、オペランドは属性 "Pet Supplies" で "ProductType2" に設定できます。 |
CustomLabel0-4 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3、CustomLabel4 など、5 つのカスタム ラベル オペランド値を使用できます。 |
マーチャントによって定義されたカスタム ラベル。 CustomLabel0 や CustomLabel4 などのカスタム ラベルは、どの階層にも基づいて検証されません。 最大 100 文字。 |
各 CustomLabel オペランドは、キャンペーン製品スコープ フィルターごとに 1 回使用できます。 |
ショッピング キャンペーンの商品条件
Microsoft ショッピング キャンペーンと広告グループごとに、複数の製品条件を指定できます。 各条件は、製品の属性値がオペランドの属性値と等しい場合に満たされます。 たとえば、オペランドが Brand に設定され、属性が Contoso に設定されている場合、製品カタログの Brand 属性の値が Contoso と等しい場合、条件が満たされます。
ショッピング キャンペーンでは、製品の条件をキャンペーンレベルと広告グループレベルで設定できます。 次の表では、キャンペーン ProductScope オブジェクトと広告グループ ProductPartition オブジェクトの製品条件 (オペランド) と Product Value (属性) ビジネス ルールについて説明します。
製品条件 (オペランド) | 製品値 (属性) 説明 | キャンペーン製品のスコープルール | 広告グループの製品パーティションルール |
---|---|---|---|
すべて | 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 条件を製品パーティションに指定できます。 |
検索キャンペーンの製品条件
注:
誰もがこの機能をまだ持っているわけではありません。 そうでない場合は、心配しないでください - それはすぐに来ています!
マルチメディア広告を含む Microsoft Search キャンペーンごとに、複数の製品条件を指定できます。 各条件は、製品の属性値がオペランドの属性値と等しい場合に満たされます。 たとえば、オペランドが Brand に設定され、属性が Contoso に設定されている場合、製品カタログの Brand 属性の値が Contoso と等しい場合、条件が満たされます。
検索キャンペーンでは、製品条件をキャンペーン レベルで設定できます。 次の表では、キャンペーン ProductScope オブジェクトの製品条件 (オペランド) と Product Value (属性) ビジネス ルールについて説明します。
製品条件 (オペランド) | 製品値 (属性) 説明 | キャンペーン製品のスコープルール |
---|---|---|
ブランド | 製品の製造元、ブランド、または発行元。 最大 1,000 文字。 |
[ブランド] オペランドは、キャンペーン製品のスコープ フィルターごとに 1 回だけ指定できます。 |
CategoryL1 1 つのカテゴリ オペランド値 (CategoryL1) を使用できます。 |
Microsoft Merchant Center ストアによって定義された製品カテゴリ。 有効な カテゴリ 値と分類については、Bingカテゴリ分類に関するページを参照してください。 最大 100 文字。 |
CategoryL オペランドはそれぞれ、キャンペーン製品スコープ フィルターごとに 1 回使用できます。 |
チャネル | ローカル インベントリ広告 (LIA) チャネル。 使用可能な値には、"ローカル ストア" と "オンライン" があります。 キャンペーンが ローカル インベントリ広告にオプトインしていない場合、すべてのオファーは既定でオンラインのみ (Channel=Online) と単一チャネル (ChannelExclusivity=単一チャネル) になります。 詳細については、 ローカル インベントリ広告 のヘルプ ページを参照してください。 |
Channel オペランドは、キャンペーン製品スコープ フィルターごとに 1 回だけ指定できます。 |
ChannelExclusivity | ローカル インベントリ広告 (LIA) チャネルの排他性。 指定できる値には、"単一チャネル" と "マルチチャネル" があります。 キャンペーンが ローカル インベントリ広告にオプトインしていない場合、すべてのオファーは既定でオンラインのみ (Channel=Online) と単一チャネル (ChannelExclusivity=単一チャネル) になります。 詳細については、 ローカル インベントリ広告 のヘルプ ページを参照してください。 |
ChannelExclusivity オペランドは、キャンペーン製品スコープ フィルターごとに 1 回だけ指定できます。 |
条件 | 製品の条件。 オペランドが Condition に設定されている場合、指定できるサポートされる属性値は New、 Used、および Refurbished です。 |
Condition オペランドは、キャンペーン製品のスコープ フィルターごとに 1 回だけ指定できます。 |
CustomLabel0-4 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3、CustomLabel4 など、5 つのカスタム ラベル オペランド値を使用できます。 |
マーチャントによって定義されたカスタム ラベル。 CustomLabel0 や CustomLabel4 などのカスタム ラベルは、どの階層にも基づいて検証されません。 最大 100 文字。 このオペランドは スポンサー製品には適用されません。 |
各 CustomLabel オペランドは、キャンペーン製品スコープ フィルターごとに 1 回使用できます。 |
Id | マーチャントによって定義された製品識別子。 最大 1,000 文字。 |
[Id] オペランドは、キャンペーン製品のスコープ フィルターごとに 1 回だけ指定できます。 |
ProductType1 1 つの製品の種類のオペランド値 (ProductType1) を使用できます。 |
マーチャントによって定義された製品の種類またはカテゴリ。 ProductType1 は、最上位レベルの製品の種類です。 最大 100 文字。 このオペランドは スポンサー製品には適用されません。 |
各製品の種類のオペランドは、キャンペーンの製品スコープ フィルターごとに 1 回使用できます。 |
パフォーマンス最大キャンペーンの製品条件
Microsoft Performance Max 資産グループごとに、複数の製品条件を指定できます。 各条件は、製品の属性値がオペランドの属性値と等しい場合に満たされます。 たとえば、オペランドが Brand に設定され、属性が Contoso に設定されている場合、製品カタログの Brand 属性の値が Contoso と等しい場合、条件が満たされます。
Performance Max キャンペーンでは、製品条件は資産グループ レベルでのみ設定できます。 次の表では、 資産グループ AssetGroupListingGroup オブジェクトの製品条件 (オペランド) と Product Value (属性) ビジネス ルールについて説明します。
製品条件 (オペランド) | 製品値 (属性) 説明 | 資産グループの製品パーティションルール |
---|---|---|
すべて | null にする必要があります。 | 資産グループの製品パーティションの場合、ルート ノードはオペランドを All に設定し、属性を null または空に設定する必要があります。 |
ブランド | 製品の製造元、ブランド、または発行元。 最大 1,000 文字。 |
資産グループの製品パーティションの場合、ルート ノードはオペランドを All に設定し、属性を null または空に設定する必要があります。 |
CategoryL1-5 CategoryL1、CategoryL2、CategoryL3、CategoryL4、CategoryL5 の 5 つのカテゴリ オペランド値を使用できます。 |
Microsoft Merchant Center ストアによって定義された製品カテゴリ。 有効な カテゴリ 値と分類については、Bingカテゴリ分類に関するページを参照してください。 CategoryL0 は最上位のカテゴリで、CategoryL4 は最も低いレベルまたは最も詳細なカテゴリです。 最大 100 文字。 |
CategoryL オペランドのそれぞれは、複数のブランチで使用できます。 CategoryL オペランドはそれぞれ複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 たとえば、あるブランチには CategoryL1 と CategoryL2 が含まれている場合がありますが、CategoryL2 オペランドを持つ別のノードが含まれていない場合があります。 オペランドを 1 から 5 までの製品カテゴリに設定する場合は、昇順で指定する必要があります。 たとえば、上位レベルの製品パーティションに属性 Animals & Pet Supplies を持つオペランド CategoryL1 がある場合、オペランドは属性 Pet Supplies で CategoryL2 に設定できます。 前のレベルの製品カテゴリ オペランドは、直接の親パーティションで指定する必要はありません。 たとえば、親の親が CategoryL1 条件を指定した場合、製品パーティションに CategoryL2 条件を指定できます。 |
チャネル | ローカル インベントリ広告 (LIA) チャネル。 使用可能な値には、"ローカル ストア" と "オンライン" があります。 キャンペーンが ローカル インベントリ広告にオプトインしていない場合、すべてのオファーは既定でオンラインのみ (Channel=Online) と単一チャネル (ChannelExclusivity=単一チャネル) になります。 詳細については、 ローカル インベントリ広告 のヘルプ ページを参照してください。 |
Channel オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 |
ChannelExclusivity | ローカル インベントリ広告 (LIA) チャネルの排他性。 指定できる値には、"単一チャネル" と "マルチチャネル" があります。 キャンペーンが ローカル インベントリ広告にオプトインしていない場合、すべてのオファーは既定でオンラインのみ (Channel=Online) と単一チャネル (ChannelExclusivity=単一チャネル) になります。 詳細については、 ローカル インベントリ広告 のヘルプ ページを参照してください。 |
ChannelExclusivity オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 |
条件 | 製品の条件。 オペランドが Condition に設定されている場合、指定できるサポートされる属性値は New、 Used、および Refurbished です。 |
Condition オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 |
CustomLabel0-4 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3、CustomLabel4 など、5 つのカスタム ラベル オペランド値を使用できます。 |
マーチャントによって定義されたカスタム ラベル。 CustomLabel0 や CustomLabel4 などのカスタム ラベルは、どの階層にも基づいて検証されません。 最大 100 文字。 |
各 CustomLabel オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 たとえば、あるブランチには CustomLabel0 と CustomLabel1 が含まれている場合がありますが、CustomLabel1 オペランドを持つ別のノードは含まれません。 |
Id | マーチャントによって定義された製品識別子。 最大 1,000 文字。 |
Id オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 |
ProductType1-5 ProductType1、ProductType2、ProductType3、ProductType4、ProductType5 の 5 つの製品型オペランド値を使用できます。 |
マーチャントによって定義された製品の種類またはカテゴリ。 ProductType1 は最高レベルの製品タイプで、ProductType5 は最も低いレベルまたは最も細かい製品の種類です。 最大 100 文字。 |
各 ProductType オペランドは複数のブランチで使用できますが、ブランチごとに 1 回だけ指定できます。 たとえば、1 つのブランチに ProductType1 と ProductType2 が含まれている場合がありますが、 ProductType2 オペランドを持つ別のノードが含まれていない場合があります。 オペランドを 1 から 5 までの製品の種類に設定する場合は、昇順で指定する必要があります。 たとえば、上位レベルの製品パーティションに属性 Animals & Pet Supplies を持つオペランド ProductType1 がある場合は、オペランドを属性 Pet Supplies で ProductType2 に設定できます。 前のレベルの積の種類のオペランドは、直接の親パーティションで指定する必要はありません。 たとえば、親の親が ProductType1 条件を指定した場合、 ProductType2 条件を製品パーティションに指定できます。 |
要件
サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13