利用者 | メタデータ API 開発者ガイド

ファイルのサフィックスおよびディレクトリの場所

Audience コンポーネントのサフィックスは .audience で、audience フォルダに保存されます。

バージョン

Audience コンポーネントは、API バージョン 44.0 以降で使用できます。

特別なアクセスルール

Audience 型へのアクセスには、AudienceMetadata 権限が必要です。この権限は、ネットワークが有効化されている組織ではデフォルトで有効になります。

Audience 型の権限条件へのアクセスには、AudiencePermissionCriteria 権限が必要です。この権限は、API バージョン 45.0 以降で使用でき、ネットワークが有効化されている組織ではデフォルトで有効になります。

利用者対象へのアクセスには、PersonalizationActivity 権限と PersonalizationTargetApi 権限が必要です。これらの権限は、ネットワークが有効化されている組織では API バージョン 47.0 以降で使用できますが、デフォルトでは無効になっています。これらの権限は、パーソナライズのパイロットに参加している組織で有効になります。

パーソナライズは、特定の契約条件への同意が必要なパイロットプログラムを通じて一部のお客様に提供されています。このプログラムに参加する方法については、Salesforce にお問い合わせください。パイロットプログラムは変更される可能性があり、参加は保証されません。パーソナライズは、Salesforce がドキュメント、プレスリリース、または公式声明で正式リリースを発表しない限り、正式リリースされません。特定期間内の正式リリースあるいはリリースの有無は保証できません。正式リリースされた製品および機能に基づいてのみ購入をご決定ください。

メモ

項目

項目名	項目の型	説明
audienceName	string	必須。利用者の名前。
container	string	必須。利用者を含むコミュニティまたは組織の名前。
criteria	AudienceCriteria	必須。利用者の条件。この項目は、API バージョン 47.0 以降で使用できます。
criterion	AudienceCriterion[]	削除済み。利用者の条件のリスト。この項目は、API バージョン 44.0 から 46.0 で使用できます。API バージョン 47.0 以降では、代わりに criteria を使用します。警告
description	string	利用者の説明。
formula	string	利用者を決定するために使用する数式。この項目は、API バージョン 45.0 以降で使用できます。
formulaFilterType	FormulaFilterType(string 型の列挙)	利用者の数式の種類を示します。有効な値は、次のとおりです。 `AllCriteriaMatch` `AnyCriterionMatches` `CustomLogicMatches` (API バージョン 45.0 以降で使用可能)
targets	PersonalizationTargetInfos	利用者の対象。この項目は、API バージョン 47.0 以降で使用できます。

AudienceCriteria

利用者の条件を表します。このサブタイプは、API バージョン 47.0 以降で使用できます。

項目名	項目の型	説明
criterion	AudienceCriterion[]	利用者の条件のリスト。

AudienceCriterion

利用者の条件を表します。

項目名	項目の型	説明
criteriaNumber	int	数式で条件に関連付けられている数値 ((1 AND 2) OR 3 など) です。この項目は、API バージョン 45.0 以降で使用できます。
criterionValue	AudienceCriteriaValue	条件の値。
operator	AudienceCriterionOperator (string 型の列挙)	この条件に関連付けられている演算子。有効な値は、次のとおりです。 `Equal` `NotEqual` `GreaterThan` `GreaterThanOrEqual` `LessThan` `LessThanOrEqual` `Contains` `StartsWith` `Includes` (API バージョン 45.0 以降で使用可能) `NotIncludes` (API バージョン 45.0 以降で使用可能)
type	AudienceCriterionType (string 型の列挙)	有効な値は、次のとおりです。 `GeoLocation` `Domain` `Profile` `FieldBased` `Permission` (API バージョン 45.0 以降で使用可能) `Default` (API バージョン 47.0 以降で使用可能) AudienceCriterion の各 type 項目値で使用可能な AudienceCriteriaValue 項目のリストについては、この表を参照してください。

AudienceCriteriaValue

利用者の条件の値を表します。AudienceCriterion の各 type 項目値で使用可能な AudienceCriteriaValue 項目のリストについては、この表を参照してください。

項目名	項目の型	説明
city	string	ユーザの市区郡。この項目は、AudienceCriterion の type 項目の値が `GeoLocation` の場合にのみ使用できます。
country	string	ユーザの国。この項目は、AudienceCriterion の type 項目の値が `GeoLocation` の場合にのみ使用できます。
domain	string	ユーザのドメイン。この項目は、AudienceCriterion の type 項目の値が `Domain` の場合にのみ使用できます。
entityField	string	オブジェクトの項目。この項目は、AudienceCriterion の type 項目の値が `FieldBased` の場合にのみ使用できます。
entityType	string	オブジェクトの種別。この項目は、AudienceCriterion の type 項目の値が `FieldBased` の場合にのみ使用できます。
fieldValue	string	項目の値。この項目は、AudienceCriterion の type 項目の値が `FieldBased` の場合にのみ使用できます。
isEnabled	string	ユーザに対して権限が有効化されているか (`true`)、否か (`false`) を示します。この項目は、API バージョン 45.0 以降で、AudienceCriterion の type 項目の値が `Permission` の場合にのみ使用できます。
permissionName	string	標準ユーザまたはカスタム権限の有効な API 参照名を示します。この項目は、API バージョン 45.0 以降で、AudienceCriterion の type 項目の値が `Permission` の場合にのみ使用できます。
permissionType	string	権限の種別。有効な値は、`Standard` および `Custom` です。この項目は、API バージョン 45.0 以降で、AudienceCriterion の type 項目の値が `Permission` の場合にのみ使用できます。
profile	string	ユーザのプロファイル。この項目は、AudienceCriterion の type 項目の値が `Profile` の場合にのみ使用できます。
subdivision	string	ユーザの下位区分。この項目は、AudienceCriterion の type 項目の値が `GeoLocation` の場合にのみ使用できます。

次の表では、AudienceCriterion のさまざまな type 項目値で使用可能な AudienceCriteriaValue 項目がまとめられています。

AudienceCriterion の type	AudienceCriteriaValue 項目
`GeoLocation`	city country subdivision
`Domain`	domain
`Profile`	profile
`FieldBased`	entityField entityType fieldValue
`Permission`	isEnabled permissionName permissionType

PersonalizationTargetInfos

利用者の対象を表します。このサブタイプは、API バージョン 47.0 以降で使用できます。

項目名	項目の型	説明
target	PersonalizationTargetInfo[]	利用者の対象のリスト。

PersonalizationTargetInfo

利用者の対象を表します。このサブタイプは、API バージョン 47.0 以降で使用できます。

項目名	項目の型	説明
groupName	string	必須。対象のグループ名。グループによって、関連する対象と利用者のペアがまとめられます。メタデータ API での対象のグループ名の決定は、Chatter REST API と同様に動作します。対象の groupName を決定するには、『Chatter REST API 開発者ガイド』の「パーソナライズ対象グループ名」を参照してください。
priority	int	対象の優先度。グループ内で、優先度によって、ユーザが複数の利用者に一致する場合にどの対象が返されるかが決まります。
targetType	string	必須。対象の種別。対象となるデータの性質を示します。API バージョン 47.0 以降では、`ExperienceVariation` が唯一サポートされている値です。
targetValue	string	必須。対象の値。環境のバリエーションの開発者名です。たとえばページバリエーションの場合は `ContactSupport_ContactSupportForCalifornia_Page` となります。

宣言的なメタデータの定義のサンプル

Audience コンポーネントの例を次に示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<Audience xmlns="http://soap.sforce.com/2006/04/metadata">
3    <audienceName>Audience Metadata</audienceName>
4    <container>Customer</container>
5    <criteria>
6        <criterion>
7            <criteriaNumber>1</criteriaNumber>
8            <criterionValue>
9                <country>United States</country>
10                <subdivision>Nevada</subdivision>
11            </criterionValue>
12            <operator>Equal</operator>
13            <type>GeoLocation</type>
14        </criterion>
15        <criterion>
16            <criteriaNumber>2</criteriaNumber>
17            <criterionValue>
18                <profile>customer community user</profile>
19            </criterionValue>
20            <operator>Equal</operator>
21            <type>Profile</type>
22        </criterion>
23        <criterion>
24            <criteriaNumber>3</criteriaNumber>
25            <criterionValue>
26                <domain>sampledomain.example.com</domain>
27            </criterionValue>
28            <operator>Equal</operator>
29            <type>Domain</type>
30        </criterion>
31        <criterion>
32            <criteriaNumber>4</criteriaNumber>
33            <criterionValue>
34                <entityField>Manager.Profile.CreatedBy.Contact.MailingCountry</entityField>
35                <entityType>User</entityType>
36                <fieldValue>USA</fieldValue>
37            </criterionValue>
38            <operator>StartsWith</operator>
39            <type>FieldBased</type>
40        </criterion>
41        <criterion>
42            <criteriaNumber>5</criteriaNumber>
43            <criterionValue>
44                <entityField>RecordTypeId</entityField>
45                <entityType>CollaborationGroup</entityType>
46                <fieldValue>CollaborationGroup.Group_RT2</fieldValue>
47            </criterionValue>
48            <operator>Equal</operator>
49            <type>FieldBased</type>
50        </criterion>
51        <criterion>
52            <criteriaNumber>6</criteriaNumber>
53            <criterionValue>
54                <isEnabled>true</isEnabled>
55                <permissionName>ManageUsers</permissionName>
56                <permissionType>Standard</permissionType>
57            </criterionValue>
58            <operator>Equal</operator>
59            <type>Permission</type>
60        </criterion>
61        <criterion>
62            <criteriaNumber>7</criteriaNumber>
63            <criterionValue>
64                <isEnabled>false</isEnabled>
65                <permissionName>NamespaceXYZ__CustomPermABC</permissionName>
66                <permissionType>Custom</permissionType>
67            </criterionValue>
68            <operator>Equal</operator>
69            <type>Permission</type>
70        </criterion>
71    </criteria>
72    <formula>1 AND (2 OR 3 OR 4 OR 5 OR 6 OR 7)</formula>
73    <formulaFilterType>CustomLogicMatches</formulaFilterType>
74    <targets>
75        <target>
76            <groupName>c194d79c-5c6b-4c6a-8d14-0e7042564355$#$Branding</groupName>
77            <priority>1</priority>
78            <targetType>ExperienceVariation</targetType>
79            <targetValue>Customer_Service_testBrandingSet_Branding</targetValue>
80        </target>
81    </targets>
82</Audience>

使用方法

メタデータ API を使用して利用者を削除することはできません。

API バージョン 47.0 以降では、条件を使用せずに利用者を作成することはできません。

利用者の入力で提供される対象のリストは、必要な対象割り当ての状態とみなされます。たとえば、対象の削除、作成、更新については次の情報を参照してください。

デフォルトの利用者がない場合、対象を更新すると、UI でデフォルトの利用者に割り当てられた対象が誤って表示される場合があります。API の対象割り当てデータは正しくなります。この UI の問題を回避するには、一時的に別の対象をデフォルトの利用者に割り当て、その後で削除します。

メモ

対象の削除

1 つの対象を利用者から削除するには、利用者のすべての対象のリストから削除する対象を差し引いたリストをリリースします。

利用者からすべての対象を削除するには、空の targets タグを付けて利用者をリリースします。次に例を示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<Audience
3    xmlns="http://soap.sforce.com/2006/04/metadata">
4    <audienceName>testAudience</audienceName>
5    <container>testContainer</container>
6    <criteria>
7        <criterion>
8            <criteriaNumber>1</criteriaNumber>
9            <criterionValue>
10                <country>United States</country>
11                <subdivision>Nevada</subdivision>
12            </criterionValue>
13            <operator>Equal</operator>
14            <type>GeoLocation</type>
15        </criterion>
16    </criteria>
17    <formulaFilterType>AllCriteriaMatch</formulaFilterType>
18    <targets>
19    </targets>
20</Audience>

対象を更新しない利用者の更新

対象を更新せずに利用者を更新するには、targets タグを付けずに利用者をリリースします。次に例を示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<Audience
3    xmlns="http://soap.sforce.com/2006/04/metadata">
4    <audienceName>testAudience</audienceName>
5    <container>testContainer</container>
6    <criteria>
7        <criterion>
8            <criteriaNumber>1</criteriaNumber>
9            <criterionValue>
10                <country>United States</country>
11                <subdivision>Nevada</subdivision>
12            </criterionValue>
13            <operator>Equal</operator>
14            <type>GeoLocation</type>
15        </criterion>
16    </criteria>
17    <formulaFilterType>AllCriteriaMatch</formulaFilterType>
18</Audience>

対象の作成

対象を作成するには、利用者のすべての対象のリストに作成する対象を加えたリストをリリースします。

対象の優先度の更新

利用者内の対象の優先度を変更するには、対象の新しい優先度値を使用して利用者のすべての対象者のリストをリリースします。

別の利用者の優先度に影響を及ぼす対象の優先度を変更するには、対象の新しい優先度値を使用してすべての対象のリストで両方の利用者をリリースします。

利用者の対象割り当ての更新

対象を新しい利用者に再割り当てするには、すべての対象のリストで両方の利用者をリリースします。1 つのリストには削除した対象、もう 1 つのリストには追加した対象が含まれます。

マニフェストファイル内のワイルドカードのサポート

このメタデータ型では、package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) がサポートされます。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。