このドキュメントでは、SMS プロトコルについて説明し、外部アカウント設定がプロトコルまたはコネクタの動作に与える影響について説明します。

このドキュメントでは、プロトコル、フィールド名および値に関する詳細は、SMPP 3.4 仕様を参照します。

特に指定されていない場合、このドキュメントは Adobe Campaign Standard および Adobe Campaign Classic (拡張汎用 SMPP) に適用されます。オプションが古い v6 コネクタ (汎用 SMPP) でも使用できる場合、動作方法が示されます。

このドキュメントで Adobe Campaign Classic に言及する場合、Campaign v6 と v7 も SMS で同じように動作するため、これらのバージョンも含まれます。

SMPP プロトコルの説明

Adobe Campaign Classic および Adobe Campaign Standard の両方が、SMPP 3.4 プロトコルバージョン 3.4 に対応しています。このプロトコルは、SMS をプロバイダに送ったり (SMSC)、SMS や受領書を受け取ったりすることができる一般的なプロトコルです。

3 種類の SMS

SMS プロバイダ経由で大量の SMS を送信する場合、次の 3 種類の SMS を利用できます。

  • SMS MT(モバイルで受信):Campaign により携帯電話に送られる SMS。
  • SMS MO (モバイルから発信):携帯電話から Campaign に送られる SMS。
  • SMS SR(ステータスレポート)または DR または DLR(配信レポート):SMS が正常に受信されたことを示す受信確認がモバイルから Campaign に送られます。Campaign は、メッセージを配信できなかったことを示す SR をエラーの詳細と共に受け取ることもできます。

受信確認と SR を区別してください。SR は、ネットワークエンドツーエンドで送られる SMS の一種ですが、受信確認は 1 つの送信が通常通り行われたことのみを伝える確認メールです。

受信確認と SR の両方でエラーが発生する可能性があり、この 2 つの違いを理解していると問題の解決に役立ちます。

SMS に含まれる情報

SMS ではテキストよりも多くの情報を送れます。SMS に含まれると予想される情報を次に一覧にします。

  • 140 バイトに制限されているテキスト。つまり、エンコーディングに応じて、70~160 文字のテキスト。詳細と制限については、以下の SMS テキストエンコードを参照してください。
  • 受信者のアドレス(ADC または MSISDN とも呼ばれます)。SMS を受信するモバイルの数。
  • oADC または送信者 ID と呼ばれることがある送信者アドレス。送信者アドレスは、電話番号(普段使用)、ショートコード(プロバイダー経由で送信される場合)、または名前(オプション機能。この場合、SMS に応答できません)となります。
  • メッセージが Flash メッセージであるかどうかを示すフラグ。フラッシュメッセージは、メモリに格納されていないポップアップです。
  • SR が送られるかどうかを示すフラグです。
  • 有効期限です。これ以降は、ネットワーク機器を再試行できません(必ず有効期限があるわけでも、遵守されるわけでもありません)。
  • テキストのエンコードを示す data_coding フィールドです。

SMPP プロトコルのネットワークアスペクト

SMPP プロトコルは、Campaign から SMSC への永続的な TCP 接続を確立します。TCP 接続は、メッセージを受信するためでさえ、常に Campaign によって開始されます。

SMPP はそのモードに応じて、1 つまたは 2 つの TCP 接続を開きます。すべての接続は、必ず Campaign によって開始されます。

SMPP プロトコルは次の 2 つのモードで動作します。

  • 送信機 + レシーバー(通常、短縮送信 + 受信):メッセージの送受信には、2 つの別の TCP 接続が使用されます。
  • 送信機(短縮送信):1 つの TCP 接続が、メッセージの送受信に使用されます。

注意:

Adobe Campaign Classic(旧バージョンおよび拡張 SMPP コネクターの両方)と以前のバージョンの Campaign のみが別の送受信モードをサポートしています。この制限は、技術アーキテクチャによって異なります。

SMPP プロトコルが標準プロトコルであるため、その説明は Campaign のすべてのバージョンに適用されます。

SMPP 送信単位(「パケット」)は PDU と呼ばれます。PDU には、コマンド、ステータス、シーケンス番号およびデータが含まれています。

各 PDU は、SMPP RESP PDU(同期応答)によって応答する必要があります。リクエストはパイプライン化される可能性があります。送信者は、RESP を待たずに多数のコマンドを送信することができ、いつでもパイプライン化されうるリクエストの数は、ウィンドウと呼ばれます。RESP PDU は、対応するイニシエーターの順序に関係なく、任意の順序で届くことがあります。

各送信機とレシーバーモードでは、使用される接続は、送信されるメッセージの種類によって異なります。送信機の接続は MT に使用され、受信者の接続は MO および SR に使用されます。各種類のメッセージの要求と応答は、同じ TCP 接続を介して送信されます。

例えば、MT を送信する場合、送信機の接続が使用され、MT を通知する RESP は送信機のチャンネルからも送信されます。MO(または SR)を受信すると、受信者接続を使用して MO の受信と、MO に通知する RESP の送信が行われます。

smpp_transmitterreceiver

Adobe Campaign Classic では、対応する MT と SR をリンク付けるために、SUBMIT_SM_RESP および DELIVER_SM ステップのある SMSC を使用して ID が返されます。識別子は、nms::providerMsgId テーブルの providerId フィールドに保存されます。これは、broadLogId と deliveryId にリンク付けされます。この照合操作は、データベースへの書き込み時に SMS プロセスによって実行されます。

Adobe Campaign Standard では、MT と SR の紐付けは MTA 固有であるため、余分な SMS プロセスはありません。

セキュリティ面

唯一の一般的な認証メカニズムは、バインド段階で渡されるログイン/パスワードフィールドです。

プロトコル自体は暗号化されません。IP ホワイトリスト、VPN、および IPsec は、最も使用されているセキュリティ対策です。これは通常、ホスティングサービスまたは外部ネットワークコンポーネントによって処理されます。

ACS では、TLS 経由の SMPP がサポートされるようになりましたが、その実装は、基礎となるフレームワークの制約により、完全に TLS に準拠していません。TLS をデプロイする前に、大規模なテストフェーズとストレスを ACS とプロバイダーの間で行う必要があります。

 

各種 PDU の情報

各種類の PDU には、それぞれ異なる情報を持つ個別のフィールドがあります。これらの PDU は、SMPP 3.4 の仕様に記載されています。しかし、この文書には、最もよく使われている PDU の便利なフィールドの概要が記載されています。

以下の各セクションには、PDU とその同期応答(*_RESP PDU)の両方が説明されています。すべての PDU は対応する RESP によって応答する必要があり、これは仕様の必須部分です。

PDU はオプションのフィールドを指定できます。ここでは、最も一般的なフィールドのみを記載します。詳しくは、SMPP の仕様とプロバイダーのマニュアルを参照してください。

BIND_TRANSMITTER/BIND_RECEIVER/BIND_TRANSCEIVER

この PDU は、SMSC への接続を開始するために使用されます。送信機モード、レシーバーモード、およびトランシーバーモードでは、この接続を使用して転送可能な SMS の種類のみ変更します。具体的には、以下の通りです。

モード 許可されている SMS の種類
送信機 MT
レシーバー MO + ST
トランシーバー MT + MO + SR

BIND_* PDU の注目フィールド:

  • system_id:認証に使用するログインです。すべてのバージョンで使用可能な外部アカウントで設定します。
  • パスワード:認証に使用するパスワードです。すべてのバージョンで使用可能な外部アカウントで設定します。
  • system_type:一部のプロバイダの特定の値に設定する必要があります。すべてのバージョンで使用可能な外部アカウントで設定します。多くの場合、異なるタイプの契約/チャンネル/国/などを区別します。
  • addr_ton および addr_npi:一部のプロバイダで要求されます。外部アカウントの「TON をバインド」および「NPI をバインド」設定で設定します(Adobe Campaign Classic Extended SMPP および Adobe Campaign Standard のみ)。
  • address_range:一部のプロバイダで要求されます。その意味は異なる場合があります。ほとんどの場合、この接続で許可されるショートコードのリストです。外部アカウントで設定します(Adobe Campaign Classic Extended SMPP および Adobe Campaign Standard のみ)。

BIND_*_RESP には特定のフィールドがないため、接続が成功したかどうかを確認できません。

UNBIND

切断する前に、システムからこの PDU を送信する必要があります。接続を閉じる前に、一致する UNBIND_RESP PDU を待機する必要があります。

SMSC の確認で接続を閉じてはなりません。TCP 接続は Campaign コネクタによって制御されます。

SUBMIT_SM

この PDU は MT を SMSC に送信します。その応答 PDU は、MT の ID を提供します。

SUBMIT_SM PDU の注目フィールド:

  • service_type:一部のプロバイダで要求されます。その意味が変わることがあります。配信プロパティ(すべてのバージョン)で設定します。
  • source_addr_ton および source_addr_npi:どのようなソースアドレスが送信されるかを示します。これらのフィールドの意味は標準化されています。しかし、一部のプロバイダーではこの使用が異なるため、プロバイダーに正しい値を尋ねる必要があります。外部カウント(すべてのバージョン)で設定します。
  • source_addr:MT のソースアドレス/oADC。携帯電話に表示されます。外部アカウントおよび配信で設定されます。配信の値は、外部アカウントの値よりも優先されます(すべてのバージョン)。
  • dest_addr_ton および dest_addr_npi:どのような宛先アドレスが送信されるかを示します(例えば、ローカルまたは国際形式)。これらのフィールドの意味は標準化されています。しかし、一部のプロバイダーではこの使用が異なるため、プロバイダーに正しい値を尋ねる必要があります。外部カウント(すべてのバージョン)で設定します。
  • destination_addr:受信者のアドレス(電話番号や MSISDN)。
  • esm_class:UDH がテキストフィールドで使用されているかいないかを示すために使用します。message_payload が使用されていない場合、分割 SMS のためにコネクタによって自動的に有効にされます。すべてのバージョンで使用できます。
  • priority_flag:このメッセージが他のメッセージより優先されます。これは、Campaign(すべてのバージョン)の配信自体の優先度と関連付けられます。
  • validity_period:タイムスタンプ。タイムスタンプが付与された後、再試行されないようにする必要があります。Campaign の配信(すべてのバージョン)で設定します。
  • registered_delivery:SR が必要かどうかを判断できます。Campaign は常にこのフラグを設定しますが、自動返信は行われません。マルチパートメッセージの場合、フラグは最初の部分にのみ設定されます。すべてのバージョンが同じ振る舞いをします。
  • data_coding:テキストフィールドで使用されているエンコーディングが表示されます。詳細については、このドキュメントの SMS テキストエンコードセクションを参照してください(バージョンに応じて異なります)。
  • short_message:メッセージのテキストです。UDH を使用する場合は、ヘッダも含まれます。

Campaign では、次のオプションフィールドがサポートされています。

  • dest_addr_subunit:SMS のターゲット(Flash、Mobile または SIM カード)を指定するために使用します。配信プロパティ(すべてのバージョン)で設定します。
  • message_payload:外部アカウントで有効になっているときに、長いメッセージが単一の PDU に送信され、テキストは short_message フィールドではなく、このフィールドで送信されます(Adobe Campaign Classic Extended SMPP および Adobe Campaign Standard のみ)。

SUBMIT_SM_RESP

この PDU には、MT の ID が含まれます。これは、受信 SR と一致すると便利です。

警告:

多くのプロバイダは、MT ID を 16 進数で送信します。外部アカウントで「MT 受信確認の ID フォーマット」設定が正しく設定されていることを確認します。

 

DELIVER_SM

この PDU は、SMSC から Campaign に送信されます。MO または SR のいずれかを含みます。

ほとんどのフィールドは、対応する SUBMIT_SM と同じ意味を持ちます。以下に、役立つフィールドのリストを示します。

  • source_addr:MO/SR のソースアドレス。通常これは電話番号です。
  • destination_addr:MO か SR を受信するショートコードです。
  • esm_class:PDU が MO または SR かどうかを伝えるために使用します。
  • short_message:メッセージのテキストです。SR の場合、SMPP プロトコル仕様の付録 B に記載されているデータが含まれます。詳細は、SMPP エラー管理:付録 B を参照してください。

Campaign は、設定を変更して、receipted_message_id オプションフィールドでメッセージ ID を読み込めます(Adobe Campaign Classic Extended SMPP および Adobe Campaign Standard のみ)。

DELIVER_SM_RESP

この PDU では、受信確認または SR と MO 以外、重要な情報は得られません。

この PDU は、接続が有効であることを確認するためにのみ使用されます。その周波数はプロバイダーのニーズに従って設定する必要があります。

デフォルトの 60 秒は、バックポートと Adobe Campaign Standard コネクタの外部アカウントの大半の設定と一致している必要があります。古い v6 コネクタは serverConf で設定され、デフォルトは 25 秒です。

ENQUIRE_LINK_RESP

この PDU は、接続が有効であることを確認します。

SMPP 外部アカウントパラメータ

SMPP プロトコルの各実装には、多くのバリエーションがあります。互換性と適応性を向上させるために、SMPP コネクタの動作を変更するための多くの設定を使用できます。このセクションでは、コネクタのパラメーターとその効果について説明します。

 

接続設定

SMPP 接続モード

トランシーバーモードまたは別の送信機 + レシーバーモードで接続を設定します。別の送信機 + レシーバーモードに切り替えると、SMPP 接続モードセクションの設定が送信機に適用され、レシーバー接続設定の設定がレシーバー接続に適用されます(レシーバーに別のパラメーターを使用するにチェックを入れている場合のみ)。

Adobe Campaign Standard にのみ適用されます。Adobe Campaign Classic コネクタは、アーキテクチャの制限により、送信機 + レシーバーのみをサポートしています。

SMSC 実装名

SMSC 実装の名前を設定します。プロバイダーの名前に設定する必要があります。このフィールドに何を配置するかについては、管理者または配信品質チームにお問い合わせください。このフィールドの役割は、以下の SMPP エラー管理セクションに記載されています。

Adobe Campaign Classic Extended SMPP および Adobe Campaign Standard に適用されます。

サーバー

接続先のサーバーの DNS 名または IP アドレス。

古い v6 コネクタでは、IP のカンマ区切りリストを追加し、複数のサーバーに並列に接続できます。

Adobe Campaign Standard と v6 バックポートのみが 1 つのアドレスを許可します。これは将来、変更される可能性があります。

ポート

接続先の TCP ポートです。

すべてのバージョンに適用されます。

アカウント

接続のログインです。BIND PDU の system_id フィールドで渡されます。

すべてのバージョンに適用されます。

パスワード

SMPP 接続のパスワードです。BIND PDU の password フィールドで渡されます。

すべてのバージョンに適用されます。

システムタイプ

BIND PDU の system_type フィールドで渡される値です。一部のプロバイダーでは、ここに特定の値が必要です。

すべてのバージョンに適用されます。

同時接続

1 つの SMS スレッドおよび MTA プロセスあたりの接続数。

警告:

Adobe Campaign Classic Generic SMPP コネクタは、同時接続の数を制御しません。接続は、多くの非制御パラメーターに基づいて作成されます。

 

MTA プロセスの数は、テクニカルオペレーション(TechOps)のデプロイメントによって決まります(通常 2 つの MTA と 1 つのスレッドがあります)。スレッドの数は、config-instance.xml ファイルで変更できます。

Adobe Campaign Classic Extended SMPP コネクタでは、1 つの MTA の子あたりの接続数を制御できます。接続のグローバル制限を制御するには、MTA 子プロセスの数を制限する必要があります。このプロセスは、SMS 用の専用ミッドソーシングプラットフォームを意味します。

Adobe Campaign Standard の合計接続の式:

  • 合計接続数 = 同時接続 * スレッド数 * MTA の数

Adobe Campaign Classic Extended SMPP コネクタの合計接続の式:

  • 合計接続数 = 同時接続 * MTA の子プロセスの数 * MTA の数

Adobe Campaign Classic では、SMS プロセスも接続を開きます。この関数は 1 つの処理/スレッドのみで生成されます。インスタンスごとに 1 個の SMS プロセスのみを使用できるので、同時接続設定は、SMS プロセスで直接開いた接続の数を表します。

注意:

自動返信を設定すると、SMS プロセスによって送信機/レシーバーペアが開き、送信機接続の数が増加しますが、自動返信を設定しなかった場合は、受信者接続のみが開きます。

 

TLS over SMPP の有効化

TLS を使用してプロバイダーに接続します。接続が暗号化されます。

18.6 以降の Adobe Campaign Standard でのみ利用できます。

ログファイルの詳細 SMPP トレースを有効にする

この設定では、すべての SMPP トラフィックがログファイルにダンプされます。通常は、初期設定時にパラメーターを調整する必要があります。コネクタのトラブルシューティングを行う場合にこれを有効にする必要があります。また、これは、プロバイダーが捉えたトラフィックと比較されなければなりません。

Adobe Campaign Classic では、ログ出力は MT 関連の MTA ログに記録され、MO と SR 関連のトラフィックでは SMS ログに記録されます。

受信者接続の設定

このセクションは、別の送信機 + レシーバーモードでのみ表示されます(上記を参照)。Adobe Campaign Classic Extended SMPP コネクターおよび Adobe Campaign Standard コネクターでのみ使用できます。

レシーバーに異なるパラメーターを使用する

このチェックボックスの選択を解除すると、送信機とレシーバーに同じ設定が使用されます。

ボックスがオンになっている場合、接続設定セクションの設定が送信機に適用され、レシーバー接続設定の設定がレシーバーに適用されます。

受信者サーバー、ポート、アカウント、パスワード、システムタイプ

これらの設定は、送信機 + レシーバーモードのレシーバーに適用されます。これらは送信機のように動作します。詳細は、上記を参照してください。

SMPP チャンネル設定

文字の表記変換を許可する

表記変換は、見つからない文字を検索する処理です。例えば、フランス語の「ê」(曲折アクセント付き)文字は GSM エンコードにありませんが、読みやすさをあまり損なわれない程度に「e」で置き換えられます。

このボックスをオフにすると、文字列を正確にエンコードできない場合は、テキストのエンコードが失敗します。

このチェックボックスをオンにすると、テキストのエンコードは、失敗するのではなく、文字列を適切なバージョンに変換することを試みます。

エンコード処理の一般的な説明については、エンコーディング設定の特定のマッピング定義を参照してください。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard で利用できます。

Adobe Campaign Classic Generic SMPP コネクターは常に文字 transliteration を提供します。

受信 MO をデータベースに保存する

有効にすると、受信 MO はデータベースの inSMS テーブルに保存されます。この表は任意のワークフローのアクティビティを使用して照会できます。

バージョン18.1 以降の Adobe Campaign Standard で利用できます。

Adobe Campaign Classic は、常に inSMS データベースにすべての MO を格納するため、このオプションは使用できません。

SR 処理中のリアルタイム KPI 更新を有効にする

有効にすると、エラー SR を受信するときに、メインの配信ページで KPI がリアルタイムで更新されます。

データベースの競合によって生成されるので、欠点は低いことがあります。無効になっている場合、数値は通常 20 分おきに実行され、syncfromexec ワークフローで更新されます。

バージョン 18.2 以降の Adobe Campaign Standard で利用できます。

Adobe Campaign Classic には KPI 用の完全なメカニズムがあるため、このオプションは使用できません。

ソース番号

メッセージのデフォルトのソースアドレスを定義します。この設定は、ソース番号が配信で空の場合にのみ適用されます。

デフォルトでは、ソース番号フィールドは渡されないので、プロバイダーはショートコードに置き換えます。

これにより、送信者アドレス/oADC の上書き機能が有効になります。

すべてのバージョンに適用されます。

ショートコード

アカウントのメインのショートコードを示します。このアカウントに複数のショートコードが使用されている場合、またはショートコードが不明な場合は、このフィールドを空白のままにします。

ショートコードの指定は、次の 2 つの機能で便利です。

  • ソース番号が指定されていない場合、プレビューにはショートコードが表示されます。携帯電話で実際の動作を反映します。
  • 自動応答機能のブラックリスト設定(後述)では、特定のショートコードのユーザーのみブラックリストに加えます。これは、この機能が開発された米国およびフランスの現在の法律に遵守するためです。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ使用できます。

送信元 TON/NPI、宛先 TON/NPI

TON(文字の種類)および NPI(プランインジケーターの番号)は、SMPP 3.4 仕様のセクション 5.2.5 に記載されています。これらの値はプロバイダーの必要に応じて設定します。

これらの値は、SUBMIT_SM PDU の source_addr_tonsource_addr_npidest_addr_ton および dest_addr_npi フィールドにそのまま転送されます。

すべてのバージョンに適用されます。

サービスタイプ

このフィールドは、SUBMIT_SM PDU の service_type フィールドにそのまま転送されます。プロバイダーのニーズに合わせて設定します。

すべてのバージョンに適用されます。

スループットとタイムアウト

これらの設定によって、SMPP チャンネルのすべてのタイミングが制御されます。一部のプロバイダでは、メッセージ頻度、ウィンドウ、および再試行のタイミングを正確に制御する必要があります。これらの設定は、プロバイダーの容量と契約に示される条件に一致する値に設定する必要があります。

このセクションの設定は、Adobe Campaign Classic Generic SMPP コネクタには適用されません。常にすぐに送信されます。

ウィンドウの送信

ウィンドウは、一致する SUBMIT_SM_RESP を待たずに送信できる SUBMIT_SM PDU の数です。

最大 4 窓ある送信の例:

smpp_window

ネットワークリンクの待ち時間が長い場合、ウィンドウはスループットを向上させます。

ウィンドウが大きすぎる場合は、接続問題が発生した場合に重複メッセージを送信することができます(稀なケース)。また、ほとんどのプロバイダーは、ウィンドウに非常に厳格な制限を設けており、制限を超えたメッセージを拒否します。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard に適用されます。古い Adobe Campaign Classic Generic SMPP コネクタは、そのウィンドウを制御しません。

最大 MT スループット

1 秒あたりの最大 MT 数です。この設定は厳密に実施されるため、MTA はこの制限よりも速くメッセージをプッシュすることはありません。これは、正確なスロットルを必要とするプロバイダーに便利です。

0 は、制限がなく、MTA ができるだけ早く MT を送信することを意味します。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard に適用されます。古い Adobe Campaign Classic Generic SMPP コネクタでは、スループットは制御されません。

再接続までの時間

TCP 接続が失われると、コネクタは接続を確立するためにこの秒数待機します。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard に適用されます。

MT の有効期限

これは、SUBMIT_SM とそれに一致する SUBMIT_SM_RESP の間のタイムアウトです。時間通りに RESP が受け取られない場合、メッセージは失敗し、MTA のグローバル再試行ポリシーが適用されます。

ACC Extended SMPP コネクタおよび Adobe Campaign Standard に適用されます。

バインドのタイムアウト

TCP 接続試行と BIND_*_RESP 応答の間のタイムアウト。タイムアウトすると、接続は Campaign コネクタで終了され、再試行されるまで再接続までの時間待ちます。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard に適用されます。

enquire_link 時間

enquire_link は、接続を維持させるために送られる特殊な種類の PDU です。この時間は秒単位です。帯域幅を節約するために接続がアイドル状態になっている場合、キャンペーンコネクタは enquire_link のみを送信します。この時間が 2 回経過しても RESP を受け取っていない場合は、接続が切れていると見なされ、再接続プロセスがトリガーされます。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard に適用されます。

古い Adobe Campaign Classic Generic SMPP コネクタは、serverConf ファイル設定で設定できます。

SMSC の詳細

これらの設定は、Campaign コネクタをほとんどの SMPP 実装特性に適合させるための詳細設定です。

エンコーディングの特定のマッピングを定義する

テキストのエンコードに関する詳細は、以下の SMS テキストのエンコードセクション を参照してください。

この設定により、仕様とは異なるカスタムエンコードマッピングを定義できます。data_coding の値と共に、エンコードのリストを宣言できます。

MTA はリスト内の最初のエンコードを使用してエンコードを試みます。失敗した場合は、リストの次のエンコードを使用します。メッセージのエンコードにエンコードを使用できない場合は、エラーが発生します。エンコーディングが見つかると、MTA は、エンコードされたテキストで SUBMIT_SM PDU を作成し、テーブルで指定されている値で設定された data_coding フィールドを作成します。

テーブル内のアイテムの順序は重要です。エンコードは上から下へ試行されます。リストの一番上に最も費用の安いまたは最も推奨するエンコードを配置してから、より高価な(またはあまり望ましくない)エンコードを追加する必要があります。

UCS-2 は Campaign でサポートされているすべての文字をエンコードできるため UCS-2 は決して失敗しないこと、および UCS-2 SMS の最大長はかなり小さくなってしまう(70 文字のみ)ことに注意してください。

また、マッピングテーブルで 1 行だけを指定して、常に使用される特定のエンコードを強制するためにこの設定を使用することもできます。

チェックボックスがオフの場合に使用されるデフォルトマッピングは、次の表と同じです。

data_coding エンコーディング
0 GSM
9 UCS-2

これは、MTA が GSM でメッセージをエンコードしようとすることを意味します。成功した場合は、0 に設定される data_coding で送信します。

メッセージが GSM でエンコードできない場合は、UCS-2 でエンコードされ、data_coding が 8 に設定されます。

この動的マッピングは、Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ使用できます。

古い Adobe Campaign Classic Generic SMPP コネクタでは、次の固定マッピングを使用します。

data_coding エンコーディング
0 GSM
1 ASCII
3 ISO-8859-1
6 ISO-8859-5
7 ISO-8859-8
8 UTF-16BE

message_payload を有効にする

オフにすると、長い SMS は MTA によって分割され、UDH のある複数の SUBMIT_SM PDU で送信されます。UDH データの後でこのメッセージが携帯電話で再構成されます。

オンにした場合は、長い SMS が 1 つの SUBMIT_SM PDU に送信され、message_payload オプションフィールドにテキストを挿入します(この詳細は、SMPP の仕様を参照してください)。

この機能を有効にすると、Campaign は個別に SMS パーツをカウントできなくなります。すべてのメッセージは 1 つのパートとしてカウントされます。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ選択可能です。

古い v6 コネクタはプロバイダーによって両方のメソッドが使用されます。以前の「汎用 SMPP」の設定では、UDH(message_payload なし)が使用されます。

完全な電話番号の送信

このチェックボックスがオフの場合は、電話番号の数字のみがプロバイダーに送信されます(SUBMIT_SMdestination_addr フィールド)。国際番号インジケーター(通常は + プレフィックス)は、SMPP の TON と NPI フィールドに置き換えられるため、これがデフォルトの動作です。

チェックボックスがオンになっている場合、前処理(および、可能なスペース、+ 接頭辞、またはポンド/ハッシュ/星の記号)なしに電話番号がそのまま送信されます。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard に適用されます。

古い Adobe Campaign Classic Generic SMPP コネクタは、プレフィックスとスペースを自動的に削除します。

TLS 証明書の確認をスキップする

TLS が有効な場合、すべての証明書のチェックを省略します。オンにすると、接続はセキュアではないため、実稼働で有効にすることはできません。

これはデバッグやテストの目的で役立ちます。

TON/NPI をバインドする

TON(文字数)および NPI(電話番号計画識別子)(SMPP 3.4 仕様のセクション 5.2.5に記載されています)。これらの値は、プロバイダーが必要とするものに設定する必要があります。

これらの値は、BIND PDU の addr_ton および addr_npi フィールドにそのまま送られます。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ使用できます。

アドレスの範囲

BIND PDU の address_range フィールドにそのまま送られます。この値は、プロバイダーが必要とするものに設定する必要があります。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ使用できます。

SR に含まれている ID の抽出用正規表現

SR 形式には、SMPP プロトコルの仕様が厳密に適用されません。仕様の付録 B に記載される推奨事項にすぎません。そのため、一部の SMPP はこのフィールドを別の形式にするため、Campaign は正しいフィールドを抽出する方法を必要とします。

デフォルトでは、「id:」の後、最大 10 個の英数字をキャプチャします。

正規表現では、正確に 1 つのキャプチャする括弧が必要です。正規表現の形式は PCRE です。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ使用できます。

正規表現は、成功またはエラーの状態を決定するために適用されます。

不明な stat/err フィールドの組み合わせがあるメッセージが検出された場合、これらの正規表現が stat フィールドに適用され、SR が成功したかエラーかを判断できます。stat 値がこれらの正規表現のいずれにも一致しない SR は無視されます。

デフォルトでは、DELIV 付録 B の DELIVRD などで始まる stat 値は通常通り配信されたものと見なされ、エラーと一致するすべての stat 値(REJECTED、UNDELIV など)がエラーと見なされます。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ使用できます。

MT 受信確認での ID 形式

これは、SUBMIT_SM_RESP PDU の message_id フィールドで ID の形式で返されることを示します。

  • 変更しない:この ID は、ASCII エンコードされたテキストとしてデータベースにそのまま保管されます。事前処理もフィルタリングも実施されせん。
  • 10 進数:ID は、ASCII 形式の 10 進数になると考えられます。この設定が使用されると、先頭と末尾のスペースおよび先頭のゼロが削除されます。
  • 16 進数:ID には、先頭に 0x または末尾に h を含めない、ASCII 形式の 16 進数になると考えられます。次に、ID はデータベースに保存される前に小数に変換されます。
  • 16 進数文字列:ID は、ASCII でエンコードされたテキストとなると考えられます。このテキストは、16 進数としてエンコードされるバイトの文字列です。例えば、PDU には、ASCII「414243」に変換される 0x34、0x31、0x34、0x32、0x34、0x33があります。この文字列は、バイト単位の 16 進数の文字列としてデコードされ、結果として「ABC」が表示されます。ID「ABC」をデータベースに保存します。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ使用できます。

SR の ID 形式

これは、SR の ID の抽出正規表現用で取得した ID 形式を示しています。値の意味は同じで、上記の MT の形式と同じ動作です。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ使用できます。

オプションフィールドの SR ID またはエラーコード

このオプションをオンにすると、オプションフィールドの内容が、上記の正規表現に変換されたテキストに追加されます。テキストは「0xTAG:VALUE」形式になり、0xTAG は大文字のタグの 4 桁の 16 進数値となります(0x002E など)。

例えば、receipted_message_id フィールドの ID を取得する必要があるとします。そのために、このチェックボックスをオンにすると、次のテキストがステータスに追加されます。

0x001E:05e3299e-8d37-49d0-97c6-8e4fe60c7739

この例では、0x001E は任意選択フィールドのタグであり、UUID はそのフィールドの値です。

この値を取得するために、SR に含まれている ID の抽出正規表現フィールドで、次の正規表現用を設定できるようになります。

\b0x001E:([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\b

警告:

テキスト(ASCII/UTF-8)の値を持つ任意フィールドのみをキャプチャできます。具体的には、バイナリフィールドは現在の正規表現システムで確実に取得できません。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ使用できます。

テキストフィールドの SR ID またはエラーコード

オンにすると、Text: フィールドが、SR のステータステキストの処理中に保持されます。

これは、プロバイダが ID やステータスなどのフィールドに重要なデータを配置する場合に便利です。このフィールドには非 ASCII エンコードのテキストが含まれている場合があり、正規表現への変換を中断する場合があるため、通常、このフィールドは安全に破棄されます。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ使用できます。

サービス ID タグ

カスタム TLV を追加できます。このフィールドはタグの部分を設定します。値は、配信の詳細パラメーターの「サービスまたはプログラム ID」値で配信ごとにカスタマイズできます。

この設定では、メッセージごとに 1 つの TLV オプションのみ追加できます。

Adobe Campaign Classic Extended SMPP コネクタおよび Adobe Campaign Standard でのみ使用できます。

MO に送信される自動返信

この機能を使用すると、テキストを MO にすばやく返信し、各ショートコードのブラックリストを処理することができます。

キーワードショートコードの列は、自動返信をトリガーする条件を定義します。両方のフィールドが一致する場合は、MO が送信され、追加アクションがトリガーされます。ワイルドカードを指定するには、フィールドを空白のままにしておく必要があります。キーワードは MO テキストの最初の英数字と照合され、句読点や先頭のスペースは無視されます。

回答列は、返信するテキスト用です。このフィールドをパーソナライズすることはできません。このフィールドを空白のままにすると、メッセージは返信されませんが、追加のアクションはトリガーされます。

追加アクション列は、キーワードショートコードが一致する場合、追加アクションを提供します。現在、受信者をブラックリストまたは非ブラックリストに加えることができます。なしはテキストのみ返信します。答えを指定しない場合でもアクションがトリガーされます。ブラックリストへの登録は、指定されたショートコードに対してのみ発生します。プロファイル全体(ほとんどの国の最小要件)ではありません。

1 つのルールが一致するまで、指定した順序でテーブル内のすべてのエントリが処理されます。複数のルールが 1 つの MO に一致する場合は、一番上のルールのみが適用されます。

警告:

ACC のハイブリッドアーキテクチャで新しい拡張 SMPP コネクタの自動返信を適用するには、外部アカウントフォルダーに対する中間オペレーターの書き込みアクセスを追加する必要があります。

古い Adobe Campaign Classic Generic SMPP コネクタには自動返信機能がありますが、ブラックリストはありません。機能の動作は異なります。詳しくは、Campaign Classic ドキュメントを参照してください。

SMS 配信テンプレートのパラメーター

配信テンプレートごとに一部のパラメーターを設定できます。

フィールドから

このフィールドはオプションです。これにより、送信者アドレス(oADC)を上書きできます。このフィールドのコンテンツは、SUBMIT_SM PDU の source_addr フィールドに配置されます。

このフィールドは、SMPP の仕様により 21 文字に制限されますが、一部のプロバイダーでは、これよりも大きい値が可能です。また、非常に厳密な制限が一部の国(長さ、コンテンツ、許容文字など)に適用される場合があります。

配信パラメーター

メッセージあたりの SMS の最大数

この設定は、メッセージペイロード設定が無効の場合のみ機能します(詳細については、外部アカウント設定を参照してください)。メッセージにこの値よりも多くの SMS が必要な場合は、エラーが発生します。

SMS プロトコルは SMS を 255 分割に制限しますが、一部の携帯電話では 10 個以上の長いメッセージを組み合わせると問題が生じます(この制限は、正確なモデルにより異なります)。1 つのメッセージのフラグメントの数が 5 つを超えないようにすることを推奨します。

Adobe Campaign Classic(すべてのバージョン、すべてのコネクタ)にも適用されます。

送信モード

このフィールドは、転送する SMS の種類(通常またはフラッシュメッセージ、モバイルまたは SIM カードに保存)を示します。

この設定は、SUBMIT_SM PDU の dest_addr_subunit オプションフィールドに送信されます。

  • 未指定:PDU のオプションフィールドを送信しません。
  • Flash:値を 1 に設定します。モバイル上にポップアップ表示され、メモリに格納されていないフラッシュメッセージを送信します。
  • 通常:値を 0 に設定します。通常のメッセージが送信されます。
  • モバイル上に保存は、値を 2 に設定します。SMS を内部メモリに保存するように電話に指示します。
  • ターミナル上に保存は、値を 3 に設定します。SMS を SIM カードに保存するように電話に指示します。

ACC では、値は異なります。ドキュメントを確認してください。

有効期間

有効期間は、SUBMIT_SM PDU の validity_period フィールドに転送されます。日付は、絶対 UTC 時間形式で必ずフォーマットされます(日付フィールドの末尾は「00+」となります)。

有効期間は、Adobe Campaign Classic(すべてのバージョン、すべてのコネクタ)にも適用できます。

SMS テキストエンコード

エンコードで問題がある場合は、必ず SMSC プロバイダーに問い合わせなければなりません。SMSC プロバイダーには、サポートされているエンコーディングの正確な知識と、技術プラットフォームの制限により適用される可能性のある特別なルールがあります。送信した内容と返信された内容を確認することは、正常で安定した相互接続への唯一のパスです。

SMS メッセージは特別な 7 ビットエンコード(GSM7 エンコードとよく呼ばれます)を使用します。

SMPP プロトコルでは、トラブルシューティングが容易になるように、GSM7 のテキストは文字ごとに 8 ビット拡張されます。SMSC は、1 文字に 7 ビットを割り当ててからモバイルに送信されます。これにより、SMS の short_message は、SMPP フレームに最大 160 バイトとなりますが、モバイルネットワークに送られるときは、140 バイトに制限されます(最上位ビットは破棄されます)。

エンコード問題の場合は、次の点に注意してください。

  • まず、どの文字がエンコーディングに属すかを確認してください。GSM7 は付加記号(アクセント)を十分にサポートしていません。特にフランス語では、éè は GSM7 の一部ですが、êâ または ï は GSM7 の一部ではありません。これはスペイン語にもあてはまります。
  • セディーユの C(ç)は、GSM7 アルファベットの大文字にのみ存在しますが、一部の携帯電話では、小文字または「スマート」の場合にレンダーリングします。一般的には、それを避け、セディーユを削除するか、UCS-2 に切り替えることが推奨されています。
  • SMSC プロバイダーによって明示的に要求されていない限り、SMS では ASCII を使用しないでください。このエンコードは、8 ビット文字で、GSM7 より少ないため、スペースを無駄にします。
  • Latin-1 は常にサポートされていません。SMSC との互換性を確認してから Latin-1 を使用します。
  • 国語シフトテーブルは、Adobe Campaign コネクタではサポートされていません。UCS-2 または他の data_coding を代わりに使用しなければなりません。
  • UCS-2 と UTF-16 はよく電話で組み合わされています。これは、絵文字を送信する人や UCS-2 に存在しないその他のほとんど使用されない文字を送信する人にとって問題です。
  • ほとんどの携帯電話には、すべての UCS-2 文字のフォント字形がありません。スマートフォンは、かなり容易に特殊文字を表示する傾向にありますが、一般的に、フィーチャーフォンでは、購入した国の母語に役立つ機能のサポートは制限されています。絵文字または ASCII-art などを使用する場合は、送信前にさまざまな携帯電話でテストしてください。Campaign プレビューでは、見つからない字形がシミュレートされず、プレビューを表示する Web ブラウザーで使用できる記号がすべて表示されます。

data_coding フィールドでは、どのエンコードが使用されているかが示されます。大きな問題は、値 0 が仕様のデフォルト SMSC エンコードを意味することです。一般的にこの値は GSM7 を意味しますが、例外もあります。SMSC パートナーに、どのエンコードが data_coding = 0(Adobe Campaign のみ、data_coding = 0 の場合に GSM7 をサポート)に関連付けられているかを確認します。他の data_coding 値は仕様に従う傾向にありますが、唯一の確かな方法は、SMSC プロバイダーに確認することです。

メッセージの最大サイズは、エンコードによって異なります。次の表に、すべての関連情報をまとめます。

エンコーディング 通常の data_coding メッセージサイズ(文字) マルチパート SMS のパーツサイズ 使用可能な文字

GSM7

0

160

152

GSM7 基本文字セット + 拡張
(拡張文字は 2 つの文字を引き継ぎます)。

Latin-1

3

140

134

ISO-8859-1


UCS-2
UTF-16


8

70

67

Unicode(電話により異なります)

SMPP エラー管理:付録 B

SMPP プロトコルは RESP PDU で標準的な同期エラーを定義しますが、SR のエラーコードは定義しません。各プロバイダは、独自のエラーコードをそれぞれの意味で使用します。

SMPP プロトコル仕様の付録 B セクションに推奨事項が記載されていますが、実際のエラーコードリストとその意味は記載されていません。

エラー管理に準拠するために、Campaign の広範なログメッセージシステムが、エラーとその重大度(ハード、ソフトなど)を適切にプロビジョニングするために利用されます。

前述のように、エラーには次の 2 種類があります。それは、メッセージが SMSC に送信された直後に行われる SUBMIT_SM_RESP での同期返信、およびモバイルがメッセージを受信してからまたはメッセージがタイムアウトしてからかなり後に届く受領書です。この場合、エラーは SR にあります。

SR を受信すると、ステータスとエラーは short_message フィールドで見つけることができます(「付録 B」の例で実装を確認)。MT にテキストが含まれるため、PDU の short_message フィールドは、よくテキストフィールドと呼ばれます。SR の場合、技術情報とテキストという名前のサブフィールドが含まれます(一部のトラブルシューティングを除き、これは実際には役に立たない BTW です)。これらの 2 つのフィールドは異なります。また、short_message には実際にテキストフィールドとその他の情報が含まれます。

古い Adobe Campaign Classic コネクタ(拡張 SMPP 以外のすべて)は、選択したプロバイダーに依存するハードコードされた動作を使用します。一般的な SMPP は成功とエラーを区別しますが、詳細は区別しません。配信ログには、保証されていない情報が含まれる場合があります。

付録 B で説明されている SR の形式

仕様は、SR テキストフィールドの形式を使用することを推奨しています。フィールド名とその値を隔てるコロンで区切られたサブフィールドのリストです。フィールド名では大文字と小文字が区別されません。

「付録 B」の推奨と完全に一致する SR テキストフィールドの例:

id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world

仕様は、SR テキストフィールドでこの形式を使用することを推奨しています。フィールド名とその値を隔てるコロンで区切られたサブフィールドのリストです。フィールド名では大文字と小文字が区別されません。

「付録 B」の推奨と完全に一致する SR テキストフィールドの例:

id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world

id フィールドは、SUBMIT_SM_RESP PDU で受信した ID です(MT の受信確認)。

subdlvrd は、指定されたコンポーネントの数と配信されたメッセージの数をカウントすることが想定されます。しかし、広範なログシステムの方が優れており、より最適で統合された情報を提供するため、このカウントが機能するのは稀で、Campaign では使用されません。

送信日終了日のフィールドは、MT が送信され、SR がモバイルから送信された日を示すタイムスタンプです。タイムゾーンに問題があるか、正しくない日付が設定されているモバイルの不適切なタイムスタンプの問題を予測します。

stat フィールドは重要です。このフィールドでは、メッセージのステータスが示されます。唯一の重要なステータスは DELIVRDUNDELIV および REJECTD です。DELIVRD は成功を示し、残り 2 つはエラーを示します。その他の値は可能ですが、通常は中間的な通知です(例えば、MT は携帯電話会社に届きますが、携帯電話には届きません)。これらの中間通知は Campaign で無視されます。

err フィールドには、プロバイダー固有のエラーコードが含まれます。プロバイダーは、この値を解釈できるように、使用可能なエラーコードをその意味と共に指定する必要があります。

最後に、テキストフィールドには、通常、MT のテキストの先頭が含まれます。テキストの先頭は Campaign では無視されます。また、一部のプロバイダーは、PII が漏れたり、ネットワーク帯域幅が無駄に消費されたりしないように、テキストの先頭を無視します。トラブルシューティング中にのみ有効です。このフィールドを読むと、テスト MT に適合する SR 照合を簡単にコミットできます。

Adobe Campaign Standard での SR の処理例

これは、MTA が SR を処理する方法の具体的な例を示します。次の例では、付録 B の推奨事項、外部アカウントのデフォルト値、および正常な SMS MT に厳密に従った実装の例を示しています。

id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world

まず、ID 抽出正規表現が ID の抽出に適用され、対応する MT と一致するよう調整されます。

次に、これらのフィールドを抽出するために、ステータス抽出正規表現とエラーコード抽出正規表現が適用され、文字列に追加されます。

広範なログメッセージがこの情報を使用して作成され、元の変更されていない文字列が参照用に追加されます。

SR ExampleProvider DELIVRD 000|MESSAGE=id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world

次に、メッセージが正規化され、同じ stat と err コードを持つ複数のメッセージに一致するように MESSAGE パートが削除されます。

SR ExampleProvider DELIVRD 000|#MESSAGE#

メッセージがまだ広範なログメッセージテーブルでプロビジョニングされていない場合、メッセージ全体を「firstText」として使用し、正規化されたメッセージを使用して新しいエントリが作成されます。次に、コネクタは成功とエラー正規表現を使用して、成功または失敗の有無を判断します。

  • 成功の正規表現と一致した場合は、成功と見なされます。
  • エラーの正規表現と一致した場合、メッセージはエラーと見なされます。
  • この 2 つの正規表現のどちらにも一致しない場合、SR は無視されます(これは、Campaign によって処理されない中間通知である可能性があります)。

デフォルトでは、すべてのエラーがハードエラーとしてプロビジョニングされます。つまり、再試行を有効にするには、ソフトエラーを手作業でプロビジョニングする必要があります。

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー