--- title: "EXMの設定" slug: "the-exm-configuration-settings" abstract: "設定ファイルで利用可能なデフォルトのEXM設定の概要。" --- # EXMの設定 Email Experience Manager(EXM)を設定し、EXMに付属するデフォルト設定を変更するには、Content ManagementのEXM設定ファイルを編集し、\\App\_Config\\Sitecore\\EmailExperience\\. にあるインスタンスContent Delivery編集してください。すべてのファイルでは、設定が / セクションにあります。 EXMメールをレンダリングする際にexmサイトを使用します。デフォルトでは、exmサイトはシェルサイトのすべてのプロパティを継承しますが、コンポーネントのキャッシュ設定が尊重されるように、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がメールクラウドに送信し、その後受信者に送信する前にEXMの抑制リストを確認したい場合は、trueに設定してください。 メールキャンペーンに含まれるすべての受信者に対して最初の抑制リストチェックをEmail Cloudに行わせたい場合は、falseに設定してください。 この設定の値に関わらず、Email Cloud抑制リストに表示された連絡先はEXMからのメールを受け取ることはありません。この設定の詳細については、「 [抑制リストの管理](https://doc.sitecore.com/xp/ja/developers/exm/103/email-experience-manager/managing-the-suppression-list.html)」をご覧ください。 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 有効な正則表現は何でも [メール検証](https://doc.sitecore.com/xp/ja/developers/exm/103/email-experience-manager/the-emailregexvalidator-and-the-urlregexvalidator-settings.html)に作成し使いたい正規表現の検証クラスを指定します。 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リトライャーの設定](https://doc.sitecore.com/xp/ja/developers/exm/103/email-experience-manager/configure-the-exm-retryers.html)」をご覧ください。 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](https://yourinstancename/sitecore/api/ssc/EXM/OAuth)に設定しているはずです。 authUrl 認証エンドポイントです。 accessTokenUrl トークンエンドポイント。 クライアントID アプリケーション(クライアント)のID。 クライアントシークレット アプリケーションの秘密。 範囲 空間分離されたスコープのリスト。 州 ランダムに生成される一意値。