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

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

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

バージョン

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

特別なアクセスルール

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

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

項目

項目名	項目の型	説明
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 以降で使用可能)
isDefaultAudience	boolean	利用者がデフォルトの利用者か (`true`)、否か (`false`) を示します。この項目は API バージョン 48.0 で使用可能であり、必須の項目です。API バージョン 49.0 以降の場合、この項目は省略可能です。デフォルトの利用者のフィル名は、`Default_Network Name.audience` の形式です。
targets	PersonalizationTargetInfos	利用者の対象。この項目は、API バージョン 47.0 以降で使用できます。

AudienceCriteria

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

項目名	項目の型	説明
criterion	AudienceCriterion[]	利用者の条件のリスト。利用者には最大 100 個の条件を追加できます。

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 以降で使用可能) `Audience` (API バージョン 53.0 以降で使用可能) AudienceCriterion の各 type 項目値で使用可能な AudienceCriteriaValue 項目のリストについては、この表を参照してください。

AudienceCriteriaValue

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

項目名	項目の型	説明
audienceDeveloperName	string	利用者の API 参照名。この項目は、API バージョン 53.0 以降で使用できます。この項目は、AudienceCriterion の type 項目の値が `Audience` の場合にのみ使用できます。
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
`Audience`	audienceDeveloperName

PersonalizationTargetInfos

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

利用者をリリースする場合は、エクスペリエンスバリエーション対象をサポートするために、ExperienceBundle をパッケージに含める必要があります。

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

PersonalizationTargetInfo

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

項目名	項目の型	説明
groupName	string	必須。対象のグループ名。グループによって、関連する対象と利用者のペアがまとめられます。グループを 2,000 件まで、グループごとに対象を 500 件まで含めることができます。対象のグループ名を決定するには、『Experience Cloud 開発者ガイド』の「パーソナライズ対象の API 参照名とグループ名」を参照してください。
priority	int	対象の優先度。グループ内で、優先度によって、ユーザが複数の利用者に一致する場合にどの対象が返されるかが決まります。
targetType	string	必須。対象の種別。対象となるデータの性質を示します。サポートされる値は次のとおりです。 `ExperienceVariation` (API バージョン 47.0 以降) `NavigationLinkSet` (API バージョン 49.0 以降) `Report` (API バージョン 49.0 以降) `Dashboard` (API バージョン 49.0 以降) `ExperienceVariation` の対象を 2,500 件まで、レコードの対象を 25,000 件まで含めることができます。 `ExperienceVariation` 対象種別についての詳細は、ExperienceBundle を参照してください。
targetValue	string	必須。対象の値。環境のバリエーションの開発者名です。たとえば、ページバリエーションの場合は `ContactSupport_ContactSupportForCalifornia_Page` となります。対象の開発者名を判別するには、『Experience Cloud 開発者ガイド』の「パーソナライズ対象の API 参照名とグループ名」を参照してください。

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

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        <criterion>
72            <criteriaNumber>8</criteriaNumber>
73            <criterionValue>
74                <audienceDeveloperName>Audience1</audienceDeveloperName>
75            </criterionValue>
76            <operator>Equal</operator>
77            <type>Audience</type>
78        </criterion>
79    </criteria>
80    <formula>1 AND (2 OR 3 OR 4 OR 5 OR 6 OR 7) AND 8</formula>
81    <formulaFilterType>CustomLogicMatches</formulaFilterType>
82    <isDefaultAudience>false</isDefaultAudience>
83    <targets>
84        <target>
85            <groupName>c194d79c-5c6b-4c6a-8d14-0e7042564355$#$Branding</groupName>
86            <priority>1</priority>
87            <targetType>ExperienceVariation</targetType>
88            <targetValue>Customer_Service_testBrandingSet_Branding</targetValue>
89        </target>
90    </targets>
91</Audience>

使用方法

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

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

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

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

メモ

利用者のターゲティングを使用したパーソナライズでは、ブラウザでユーザに表示する内容を変えることができますが、データは保護されません。ユーザが機密データにアクセスするのを防ぐには、共有ルールや権限セットなどの Salesforce の標準セキュリティ機能を使用してください。

重要

対象の削除

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    <isDefaultAudience>false</isDefaultAudience>
19    <targets>
20    </targets>
21</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    <isDefaultAudience>false</isDefaultAudience>
19</Audience>

対象の作成

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

対象の優先度の更新

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

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

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

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

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

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