1. 一般設定の定義

EXM構成設定

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Email Experience Manager (EXM) を設定し、EXMに付属するデフォルト設定を変更するには、\App_Config\Sitecore\EmailExperience\. にあるContent ManagementおよびContent DeliveryインスタンスでEXM設定ファイルを編集します。すべてのファイルで、設定は <sitecore>/<settings> セクションにあります。

EXMは、メール メッセージをレンダリングするときにexmサイトを使用します。デフォルトでは、exmサイトは シェルWebサイトのすべてのプロパティを継承します。ただし、cacheHtml='true' を除くため、コンポーネントのキャッシュ設定が尊重されます。他のサイトと同じ方法で設定を調整できます。これに関するドキュメントは、Sitecore.configファイルにあります。

Sitecore.EmailExperience.ContentManagement.config (英語)

Sitecore.EmailExperience.ContentManagement.configファイルには、次の設定が含まれています。

設定

既定値

形容

EXM.CheckMtaConnection

真

ディスパッチを開始する前にメッセージ転送エージェント (MTA) 接続をテストする場合は、trueに設定します。

DispatchEnqueueBatchSize

300

ディスパッチ キューに追加される各バッチの受信者の数を指定します。

DispatchEnqueueThreadsNumber

4

受信者バッチをディスパッチキューに追加する必要があるスレッドの数を指定します。

EXM.AttachmentTotalSizeInBytes

7340032

メッセージのすべての添付ファイルの最大サイズをバイト単位で指定します。デフォルト値は7340032です。

EXM.CheckRecipientListsStatus

真

メールキャンペーンがディスパッチされる前に、予想される連絡先の数と実際の連絡先の数が一致するかどうかを確認するには 、trueに設定します。この設定は、リストのロックが無効になっている場合にのみ有効にする必要があります。

EXM.CheckSuppressionList

真

EXMがEメール メッセージをEmail Cloudに送信してから受信者に送信する前にEXM抑制リストを確認する場合は、trueに設定します。

メール・キャンペーンに含まれるすべての受信者に対して最初のサプレッション・リスト・チェックをメール・クラウドで実行する場合は 、falseに設定します。

この設定の値に関係なく、Email Cloudサプレッション リストに表示される連絡先は、EXMからメール メッセージを受信することはありません。この設定の詳細については 、「サプレッション リストの管理」を参照してください。

EXM.DispatchBatchSize

100

各ディスパッチ・スレッドが一度に処理する連絡先の数を指定します。

EXM.EmailTestDefinitionPath

/sitecore/システム/マーケティング

コントロールパネル/テストラボ/メール

メールテスト定義へのパスを指定します。

EXM.TasksPath

/sitecore/システム/設定/

メール/タスク

EXMタスクを配置する場所へのパスを指定します。

MaxGenerationThreads

8

電子メール メッセージを生成して個々の受信者に送信するために同時に実行する必要があるディスパッチ タスクの最大数を指定します。

この値を小さくすると、ディスパッチ中のサーバーの負荷を減らすことができます。たとえば、NumberThreads設定とMaxGenerationThreads設定の両方に16を指定すると、16個のディスパッチタスクが同時に処理されます。 MaxGenerationThreads設定に8、NumberThreads設定に16を指定すると、同時に処理されるのは8つのディスパッチタスクのみです。他の8つのタスクはブロックされ、処理されるのを待っています。

値は、NumberThreads設定に指定された値と同じかそれより小さい必要があります。高い値を指定しても、効果はありません。

メモ

NumberThreads設定とMaxGenerationThreads設定の両方で高い値を指定すると、メールキャンペーンの配信速度は向上しますが、CPU負荷も高くなります。

MtaEmulation.アクティブ

偽

MTAエミュレーションモードを有効にするには 、trueに設定します。

MtaEmulation.MinSendTime

200

1通のメール送信をエミュレートするために費やされる最小時間をミリ秒単位で指定します。これをMtaEmulation.MaxSendTimeと組み合わせて使用すると、Sitecore XPからMTAへの往復時間の動作を模倣できます。

MtaEmulation.MaxSendTime

400

1通のメール送信をエミュレートするために費やされる最大時間をミリ秒単位で指定します。

MtaEmulation.FailProbability

0.01

エミュレーションへの接続に失敗する確率を指定します。

NumberThreads

16

ディスパッチ時に使用するスレッドの数を指定します。各スレッドは、連絡先にメールキャンペーンを送信するディスパッチタスクを作成します。

数値はexm/eds/connectionPoolSettings/maxPoolSize settingと等しくなければなりません。

ResetTimeout

3600

モジュールが自動メッセージを失敗と見なし、再送信を試行するまでの期間を秒単位で指定します。

StandardMessages.DefaultGlobalOptOutList

共通のグローバル オプトアウト リスト。

新しいマネージャー・ルートに使用するデフォルトのグローバル・オプトアウト連絡先リストのパスを指定します。

StandardMessages. SubscriptionConfirmation

item>への<relativeパス

連絡先がメーリングリストに登録した後に受信するメッセージのパスを指定します。このメッセージには、サブスクリプション確認リンクが含まれています。

StandardMessages. SubscriptionNotification

item>への<relativeパス

サブスクリプション確認メッセージの確認リンクをクリックした後に連絡先が受信するメッセージへのパスを指定します。

StandardMessages. UnsubscribeNotification

item>への<relativeパス

メーリングリストをオプトアウトした後に連絡先が受信するメッセージへのパスを指定します。

StandardMessages.UnsubscribeFromAllNotification

item>への<relativeパス

すべてのメーリングリストをオプトアウトした後に連絡先が受信するメッセージへのパスを指定します。

StandardMessages.DispatchCompleted

item>への<relativeパス

ディスパッチ プロセスの終了時に、Dispatch Process Notificationsセクションで指定した電子メール アドレスに送信するメッセージのパスを指定します。

StandardMessages.TriggeredNotification

item>への<relativeパス

自動メッセージのアクティブ化ステータスメッセージへのパスを指定します。

Sitecore.EmailExperience.ContentDelivery.config (英語)

Sitecore.EmailExperience.ContentDelivery.configファイルには、次の設定が含まれています。

設定

例

形容

EXM.OpenAndClickCache

1メガバイト

重複する開封とクリックの追跡に使用するキャッシュ サイズを指定します。

TrackerXConnectFacetsFacetName

XConnectファセット

使用するTrackerファセットの名前。

Sitecore.EmailExperience.Core.config

Sitecore.EmailExperience.Core.configファイルには、次の設定が含まれています。

設定

例

形容

CampaignClassification.Channel

{DDAFB85B-1511-48B8-9374-2A8A1F371645}

新しいメール キャンペーンの作成時にメール キャンペーン項目に追加するチャネルIDを指定します。チャネルIDは、受信者がメッセージ内のリンクをクリックしたときにメール キャンペーンを追跡するために使用されます。

DispatchUserAgent

ECMディスパッチ

ディスパッチ プロセスで電子メール メッセージをレンダリングするための要求ページに使用するUserAgentの名前を指定します。

EXM.DefaultEventSiteName

エクスエム

Experience AnalyticsでMessage sentやMessage undeliveredなどの電子メールイベントを関連付けるWebサイトの名前を指定します。

EXM.DuplicateProtectionInterval

300

同じメッセージと連絡先に関連する2つのEメールイベントの場合、重複イベントと見なされるイベント間の最大間隔 (秒単位) を指定します。この期間内に2つのイベントが発生した場合、最初のメール イベントのみが保存されます。

この値は秒単位で指定します。

EXM.Enabled

真

EXMを無効にするには、falseに設定します。

EXM.IncludePIIinLogFiles

偽

PII機密データをEXMでログに記録する場合は、値をtrueに変更します。

EXM.OpenHandlerPath

/sitecore%20modules/Web/EXM/

RegisterEmailOpened.ashx (英語)

メール開封イベントを処理するハンドラーへのパスを指定します。

EXM.EmailValidationRegex

任意の有効な正規表現

メール検証用に作成して使用する正規表現検証クラスを指定します。

EXM.RendererUrl

有効なURL

電子メール メッセージをプレビューしたり、受信者に送信したりするときに、メッセージ ソースのダウンロードに使用するホスト名を指定します。

この値を指定しない場合、EXMが最初のリクエストをSitecoreに送信するときに、RendererUrlにサーバー URLが入力されます。値はデフォルトでは空です。

IIS.Password

12345

匿名アクセスが無効になっている場合にログインできるパスワードを指定します。

IIS.User

サービスユーザー

匿名アクセスが無効になっている場合にログインできるユーザー名を指定します。

MaxMessageFolderSize

50

EXMが1つのフォルダに作成できるメッセージまたはメッセージ関連のキャンペーン、テストなどの最大数を指定します。この数を超えるメッセージがある場合は、新しいフォルダが作成されます。

PhoneFieldName

電話番号

Sitecoreユーザー プロファイルの連絡先の電話番号を指定します。このプロパティは、Sitecore XPのデフォルトのユーザー プロファイルに対応するフィールドが存在しないため、Sitecore.EmailExperience.Core.configファイルに追加されました。カスタムユーザープロファイルに電話番号フィールドがすでにある場合は、この設定の値を変更する必要があります。

QueryStringKey.AnalyticsContactId

ec_contact_id

モジュールがメッセージを生成するためのクエリ文字列を作成するために使用されます。

QueryStringKey.EcmId

ec_id

QueryStringKey.Recipient

ec_recipient

QueryStringKey.Subscription

ec_subscr

QueryStringKey.MessageId

ec_message_id

QueryStringKey.Campaign

ec_camp

クエリ文字列でメール キャンペーンを識別するためのキーを指定します。

QueryStringKey.ContactIdentifierSource

ex_id_s

クエリ文字列の連絡先識別子ソースのキーを指定します。

QueryStringKey.ContactIdentifierIdentifier

ex_id_i

クエリ文字列の連絡先識別子識別子のキーを指定します。

QueryStringKey.EmailHistoryEntryId

ec_emailid

クエリ文字列でメール履歴エントリIDを識別するためのキーを指定します。

QueryStringKey.ec_lang

ec_lang

クエリ文字列でターゲット言語を識別するためのキーを指定します。

QueryStringKey.ec_tvi

ec_tvi

クエリ文字列内のテスト値インデックスを識別するためのキーを指定します。

QueryStringKey.ExmEncryptedQuery

ec_eq

モジュールのページ要求を識別するためのキーを指定します。

EXM.MessageBodyMaxCacheSize

5メガバイト

メッセージ本文キャッシュのサイズを指定します。

QueryStringKey.OnlineVersionQueryStringKey

sc_pd_view

オンライン バージョンの電子メール メッセージに使用するキーを指定します。

QueryStringKey.RedirectUrl

ec_url

リダイレクト要求でターゲットURLを識別するためのキーを指定します。

EXM.UrlValidationRegex

任意の有効な正規表現

URL検証用に作成して使用する正規表現検証クラスを指定します。

EXM.UseContextContentLanguage

偽

値をtrueに変更して、Marketing Operations APIのContext.ContentLanguage.Name設定を使用します。

Sitecore.ExM.Framework.config

Sitecore.ExM.Framework.configファイルには、次の設定が含まれています。

設定

例

形容

EXMです。デバッグ

偽

これをtrueに設定すると、Sitecoreログ ファイルで詳細ログが有効になります。EXMの問題をトラブルシューティングするために使用します。

Sitecore.EDS.Core.config

Sitecore.EDS.Core.configファイルには、次のEXM固有の設定が含まれています。

設定

デフォルト

形容

EXM.DispatchProvider.MessagesPerConnection

10000

1つの接続で送信できるメッセージの最大数を指定します。

EDSです。Core.Net.Smtp.Send.Retryer

最大10回の試行

EXMは、このエクスポネンシャル バックオフ リトライヤを使用して、SMTP経由でメッセージを送信します。この再試行者を構成する方法の詳細については 、「EXM再試行者の構成」を参照してください。

EDSです。Core.Net.Smtp.ValidateConnection.Retryer

3回の再試行

EXMは、この再試行ツールを使用して、接続プールからSMTP接続を取得して検証します。

Sitecore.EDS.Providers.CustomSmtp.config (英語)

Sitecore.EDS.Providers.CustomSmtp.configファイルには、次の設定が含まれています。

要素

設定

形容

proxySettings

enabled

プロキシサーバー経由でSMTPサーバーを要求するには 、trueに設定します。

hostName

プロキシ サーバーのIPアドレスまたはDNS名を指定します。

authMethod

プロキシサーバーのHTTP認証方法を指定します。有効な値はBasicとNTLMです。

password

プロキシサーバーにログインするときに使用するパスワードを指定します。SOCKS4プロキシ・タイプの場合、この値は無視されます。

username

プロキシ サーバーにログインするときに使用するユーザー名を指定します。

port

プロキシ サーバ ポートを指定します。

connectionType

プロキシ・サーバーのタイプを指定します。有効な値は次のとおりです。

  • 何一つ

  • HTTPの

  • ソックス4

  • ソックス5

smtpSettings

server

SMTPサーバアドレスまたはIPアドレスを指定します。

port

SMTPサーバーのポート番号を指定します。

loginDomain

SMTPサーバーにログインするときに使用するドメインを指定します。

userName

SMTPサーバーにログインするときに使用するユーザー名を指定します。

password

SMTPサーバーにアクセスするためのパスワードを指定します。

authenticationMethod

SMTP認証方法を指定します。有効な値は次のとおりです。

  • 何一つ

  • ログイン

  • 平地

  • CRAMMD5

  • NTLMの

startTls

Eメールを認証して送信する前にSSL/TLS接続を使用できるようにするには、trueに設定します。

proxySetting

プロキシ設定を指定して、プロキシサーバー経由でSMTPサーバーを要求します。

connectionPoolSettings

maxPoolSize

接続プールに作成できる接続の数を指定します。

この数値は、Sitecore.EmailExperience.ContentManagement.configファイル内のNumberThreads設定と等しくなければなりません。

maxConnectionRetries

プールから接続を取得するために許可される最大再試行回数を指定します。

指定された再試行回数内に接続が取得されない場合は、接続タイムアウト例外がログファイルに記録されます。

maxConnectionIdleTime

最後の接続使用から、接続がプールから削除されるまでの時間を指定します。

maxConnectionWaitTime

接続プールが前回の試行で失敗した場合に、特定の接続を取得するために費やす最大時間を指定します。

接続プールが指定された時間を超えると、接続タイムアウト例外がログ・ファイルに記録されます。

delayBetweenConnectionRetries

接続プールが接続の取得を再試行するまでの遅延時間を指定します。

Sitecore.EDS.Providers.CustomSmtp.Sync.config (英語)

Sitecore.EDS.Providers.CustomSmtp.Sync.configファイルには、次の設定が含まれています。

要素

設定

形容

pop3Setting

server

POP3サーバーのIPアドレスまたはDNS名を指定します。

port

POP3サーバポートを指定します。

userName

POP3サーバーにログインするときに使用するユーザー名を指定します。

password

POP3サーバーにログインするときに使用するパスワードを指定します。

useSsl

POP3サーバーでメッセージの転送にSSLを使用する場合は 、trueに設定します。

startTls

バウンスを認証して取得する前にTLS接続を使用するには 、trueに設定します。

proxySettings

プロキシ設定を指定して、プロキシサーバー経由でPOP3サーバーを要求します。

receiversCollection

settings

POP3設定コレクションを指定します。

bounceInspector

メッセージMIMEをバウンスとして検証し、バウンスの種類を決定するインスペクタを指定します。

environmentIdentifier

Sitecoreインスタンスの識別に使用する環境識別子を指定します。

Scheduling

agent

POP3バウンスを同期するエージェントを指定します。

method

エージェント・クラスで実行する必要があるメソッドの名前を指定します。

interval

エージェントを実行する必要がある間隔をTimeSpanとして指定します。

receviersCollection

バウンス コレクションに複数のPop3アカウントを指定して、レシーバー コレクションを指定します。

この記事を改善するための提案がある場合は、 お知らせください!