EXMの設定

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がメールクラウドに送信し、その後受信者に送信する前にEXMの抑制リストを確認したい場合は、trueに設定してください。

メールキャンペーンに含まれるすべての受信者に対して最初の抑制リストチェックをEmail Cloudに行わせたい場合は、falseに設定してください。

この設定の値に関わらず、Email Cloud抑制リストに表示された連絡先はEXMからのメールを受け取ることはありません。この設定の詳細については、「 抑制リストの管理」をご覧ください。

EXM.DispatchBatchSize

100

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

EXM.EmailTestDefinitionPath

/sitecore/system/マーケティング

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

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

EXM.TasksPath

/sitecore/system/設定/

メール/タスク

EXMタスクをどこに配置したいかのパスを指定します。

MaxGenerationThreads

8

個別の受信者にメールを生成・送信するために同時に実行すべき最大ディスパッチタスク数を指定します。

この値を下げると、ディスパッチ中のサーバー負荷を軽減できます。例えば、 NumberThreads 設定と MaxGenerationThreads 設定の両方で16を指定すると、同時に16のディスパッチタスクが処理されます。 MaxGenerationThreads 設定に8、 NumberThreads 設定に16を指定すると、同時に処理されるのは8つのディスパッチタスクだけです。残りの8つのタスクはブロックされ、処理を待っています。

その値は NumberThreads 設定で指定された値と同じかそれ以下でなければなりません。より高い値を指定しても影響はありません。

> [!注]
> NumberThreads 設定と MaxGenerationThreads 設定の両方で高い値を指定すると、メールキャンペーンの送信速度は上がりますが、その分CPU負荷も増加します。

MtaEmulation.Active

偽り

MTAエミュレーションモードを有効にするためにtrueに設定してください。

MtaEmulation.MinSendTime

200

単一のメール送信をエミュレートするのにかかる最小時間(ミリ秒単位)を指定します。これを MtaEmulation.MaxSendTime と組み合わせて、MTA往復時間へのSitecore XPの動作を模倣します。

MtaEmulation.MaxSendTime

400

単一のメール送信をエミュレートするのにかかる最大時間(ミリ秒単位)を指定します。

MtaEmulation.FailProbability

0.01

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

NumberThreads

16

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

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

ResetTimeout

3600

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

StandardMessages.DefaultGlobalOptOutList

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

新しいマネージャールートに使うべきデフォルトのグローバルオプトアウト連絡先リストの経路を指定します。

StandardMessages. SubscriptionConfirmation

メーリングリストに登録した後、連絡先が受け取るべきメッセージへの経路を指定します。このメッセージには購読確認リンクが含まれています。

StandardMessages. SubscriptionNotification

購読確認メッセージの確認リンクをクリックした後に、連絡先が受け取るべきメッセージへの経路を指定します。

StandardMessages. UnsubscribeNotification

メーリングリストからオプトアウトした後、連絡先が受け取るべきメッセージへの経路を指定します。

StandardMessages.UnsubscribeFromAllNotification

すべてのメーリングリストからオプトアウトした後、連絡先が受け取るべきメッセージへの経路を指定してください。

StandardMessages.DispatchCompleted

ディス パッチ プロセス終了時に指定されたメールアドレスに送信すべきメッセージの経路を指定します。

StandardMessages.TriggeredNotification

自動メッセージのアクティベーションステータスメッセージへのパスを指定します。

Sitecore。EmailExperience.ContentDelivery.config

Sitecore.EmailExperience.ContentDelivery.configファイルには以下の設定が含まれています:

舞台設定

例

概要

EXM.OpenAndClickCache

1MB

重複開封やクリックを追跡するために使うキャッシュサイズを指定します。

TrackerXConnectFacetsFacetName

XConnectFacets

Trackerのファセットの名前を使うこと。

Sitecore。EmailExperience.Core.config

Sitecore.EmailExperience.Core.configファイルには以下の設定が含まれています:

舞台設定

例

概要

CampaignClassification.Channel

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

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

DispatchUserAgent

ECM通信

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

EXM.DefaultEventSiteName

EXM

Experience Analyticsで「メッセージ送信済み」や「メッセージ未配信」などのメールイベントに関連付けられるべきウェブサイト名を指定します。

EXM.DuplicateProtectionInterval

300

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

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

EXM.Enabled

確かに

EXMを無効にするためにfalseに設定してください。

EXM.IncludePIIinLogFiles

偽り

EXMで個人情報の機密データを記録したい場合は、値をtrueに変更してください。

EXM.OpenHandlerPath

/sitecore%20modules/Web/EXM/

RegisterEmailOpened.ashx

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

EXM.EmailValidationRegex

有効な正則表現は何でも

メール検証に作成し使いたい正規表現の検証クラスを指定します。

EXM.RendererUrl

有効なURLです

メールメッセージをプレビューしたり受信者に送信したりする際に、メッセージソースをダウンロードするために使用するホスト名を指定してください。

この値を指定しない場合、 RendererUrl はEXMが最初のリクエストを送信する際にサーバーURLで埋めSitecoreします。値自体はデフォルトで空です。

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

5MB

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

QueryStringKey.OnlineVersionQueryStringKey

sc_pd_view

メールのオンライン版に使用するキーを指定してください。

QueryStringKey.RedirectUrl

ec_url

リダイレクトリクエストでターゲットURLを特定するキーを指定します。

EXM.UrlValidationRegex

有効な正則表現は何でも

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

EXM.UseContextContentLanguage

偽り

値をtrueに変更し、マーケティングオペレーション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.リトライアー

最大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
• OAUTH

startTls

認証やメール送信前に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サーバーをリクエストします。

useOAuth

OAuthを使いたい場合は true に設定してください。

receiversCollection

settings

POP3の設定コレクションを指定してください。

bounceInspector

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

environmentIdentifier

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

Scheduling

agent

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

method

実行すべきエージェントクラスのメソッド名を指定します。

interval

エージェントを実行すべき間隔をTimeSpanとして指定します。

receiversCollection

複数のPop3アカウントを提供して、バウンス回収のために受信機のコレクションを指定します。

Sitecore。EDS。Providers.CustomSMTP.OAuth.config

Sitecore.EDS.Providers.CustomSMTP.OAuth.configファイルには以下の設定が含まれています:

要素

舞台設定

概要

oauthSettings

appCallbackURL

リダイレクトURIは、認証応答の送受信が可能なものです。

https://yourinstancename/sitecore/api/ssc/EXM/OAuthに設定しているはずです。

authUrl

認証エンドポイントです。

accessTokenUrl

トークンエンドポイント。

クライアントID

アプリケーション(クライアント)のID。

クライアントシークレット

アプリケーションの秘密。

範囲

空間分離されたスコープのリスト。

州

ランダムに生成される一意値。