v7 v8

簡訊連接器通訊協定及設定

注意

透過本檔案,所有對通訊協定、欄位名稱和值詳細資訊的參考均參考 SMPP 3.4規格.

概覽

SMS可能僅限於傳送無格式的短文字訊息,但其簡易性使其成為有價值的通訊頻道。

傳送SMS有兩個主要方式:

  • 手動透過電話傳送,這是人們之間直接通訊的常用方式。
  • 從網際網路傳送,就像Adobe Campaign傳送訊息一樣。 為此,您需要一個SMS服務提供者,將網際網路連線到行動網路。
    Adobe Campaign使用SMPP通訊協定將SMS傳送給服務提供者。

本檔案將引導您完成Adobe Campaign與SMPP提供者之間的連線設定。

SMPP提供者有時可能不符合官方規格,但Adobe Campaign中的SMS聯結器提供許多選項來調整其行為,使其與大多數提供者相容。

重要

設定與新提供者的連線可能需要一些技術技能、TCP知識、二進位、十六進位表示和文字編碼。 它還需要與提供者積極合作。

簡訊型別

透過SMS提供者傳送大量簡訊時,您會遇到三種不同的SMS:

  • 簡訊MT (行動裝置已終止):Adobe Campaign透過SMPP提供者向行動電話發出的SMS。

  • SMS MO (行動裝置原始):行動裝置透過SMPP提供者傳送至Adobe Campaign的SMS。

  • SMS SR (狀態報表)或DR或DLR (交貨收貨):行動裝置透過SMPP提供者傳送給Adobe Campaign的回條,表示已成功收到簡訊。 Adobe Campaign也可能收到指出訊息無法傳送的SR,通常附有錯誤說明。

您需要區分確認(RESP PDU,SMPP通訊協定的一部分)和SR: SR是一種透過網路端對端傳送的SMS,而確認僅是確認一次傳送已成功。

確認和SR都可能觸發錯誤,區分這兩者將有助於疑難排解。

簡訊所攜帶的資訊

簡訊包含的資訊多於文字。 以下是您可在SMS中找到的專案清單:

  • 文字,限製為140個位元組,根據編碼方式,這表示70到160個字元之間。 另請參閱 SMS文字編碼 詳細資訊和限制,請參閱下文。

  • 收件者地址,有時稱為 ADCMSISDN. 這是將會接收簡訊的行動裝置號碼。

  • 可呼叫的寄件者地址 oADC 或有時會 sender id. 這可以是日常使用的電話號碼、透過提供者傳送的簡短代碼或名稱。 名稱是選用功能,在此情況下,您無法回覆SMS。

  • 指出訊息是否為快閃訊息的旗標。 快閃訊息是未儲存在記憶體中的快顯視窗。

  • 指出是否需要SR的旗標。

  • 有效日期,之後不允許任何網路裝置重試。

  • A data_coding 欄位,表示文字的編碼。

smpp通訊協定

Adobe Campaign Classic支援SMPP通訊協定版本3.4。這是廣泛的通訊協定,允許傳送SMS給提供者(SMSC)並接收SMS以及回條。 如需詳細資訊,請參閱 SMPP檔案.

SMS服務提供者端的網路裝置通常稱為SMSC。

smpp連線

Adobe Campaign透過TCP連線至SMS服務提供者的網路裝置。 SMPP通訊協定會設定從Adobe Campaign到提供者的永久TCP連線。 TCP連線一律由Adobe Campaign起始,即使是接收訊息亦然。
SMPP會根據其模式開啟1或2個TCP連線。 所有連線一律由Adobe Campaign起始。

SMPP通訊協定可以在兩種模式中運作:

  • 傳送器+接收器(或TX+RX):兩個獨立的TCP連線用於傳送及接收訊息。
  • 收發器(或TRX):單一TCP連線用於傳送及接收訊息。
注意

Adobe Campaign Classic僅支援TX+RX模式。 這項限制是由於其技術架構所造成。

SMPP PDU

SMPP傳輸單位(「封包」)稱為PDU。 A PDU 包含命令、狀態、序號和資料。

每個PDU都必須由 SMPP RESP PDU (同步回應)。 請求可以管道化:傳送者可以傳送許多命令,而不需要等候 RESP,可隨時管道處理的請求數稱為視窗。 RESP PDU 可能會以任何順序到達,與相應的啟動器PDU的順序無關。

分隔符號 傳送器+接收器 模式,所使用的連線取決於傳送的訊息型別。 傳送器連線用於MT,而接收器連線用於MO和SR。 每一種訊息的要求和回應都會透過相同的TCP連線傳送。

例如,傳送MT時,會使用傳送器連線,而 RESP 會確認MT也透過傳送器通道傳送。 當您收到MO (或SR)時,會使用接收器連線來接收MO並傳送 RESP 以確認MO。

在Adobe Campaign Classic中,若要將SR與其對應的MT連結,SMSC會傳回ID並附上 SUBMIT_SM_RESPDELIVER_SM 步驟。 識別碼會儲存在 providerId 的欄位 nms::providerMsgId 表格和已連結至 broadLogIddeliveryId. 此比對操作由SMS程式在寫入資料庫時完成。

成功 SUBMIT_SM_RESP PDU 成功時觸發傳送記錄檔中的「已傳送」訊息狀態 DELIVER_SM (SR) PDU 觸發「已接收」訊息狀態。

安全性方面

通訊協定本身並未加密。 大部分提供者在允許清單上實作IP的變體,因此必須向提供者宣告Adobe Campaign伺服器IP位址。

Adobe Campaign支援在繫結階段傳遞登入和密碼。 它也支援SMPP over TLS。 需要注意的是,需要憑證才能確保適當的安全性。 雖然SMPP聯結器允許略過憑證檢查,但只應將其用於測試,因為沒有憑證的TLS提供顯著較低的安全性等級。

聯結器使用系統提供的預設憑證 openssl 資料庫。 通常由 /etc/ssl/certs Debian目錄。 此目錄預設由「ca-certificates」套件提供,但可以自訂。

各種PDU中的資訊

每種PDU都有不同的欄位,其中包含不同的資訊片段。 這些PDU的詳細資訊請參閱 SMPP 3.4規格.

以下各節說明PDU及其同步回應(*_RESP PDU)。 所有PDU都必須由對應的 RESP,這是規格的必要部分。

PDU可以有可選欄位。 此處僅說明最常見的欄位。 請參閱 SMPP 3.4規格 以取得詳細資訊。

BIND_TRANSMITTER / BIND_RECEIVER / BIND_TRANSCEIVER

此PDU用於啟動與SMSC的連線。 傳送器接收者收發器 模式只會變更允許透過此連線傳輸的SMS型別,尤其是:

模式 允許的SMS型別
傳送器 MT
接收者 MO + SR
收發器 MT + MO + SR

中的重要欄位 BIND_* PDU

  • system_id:用於驗證的登入。 在外部帳戶中設定。

  • 密碼:用於驗證的密碼。 在外部帳戶中設定。

  • system_type:某些提供者必須設定為特定值。 在外部帳戶中設定,適用於所有版本。 通常會區分不同型別的合約、管道、國家/地區等。

  • addr_tonaddr_npi:某些提供者需要。 設定者 Bind TONBind NPI 外部帳戶中的設定。

  • address_range:某些提供者需要。 大多數情況下,這是此連線允許的短程式碼清單。 在外部帳戶中設定。

BIND_*_RESP 沒有特定欄位,其會確認連線是否成功。

解除繫結

此PDU必須在中斷連線之前由系統傳送。 必須等待相符專案 UNBIND_RESP 關閉連線之前的PDU。

符合規範的SMSC不得關閉連線,TCP連線由Adobe Campaign聯結器控制。

SUBMIT_SM

此PDU會將MT傳送至SMSC。 其回應PDU會提供MT的ID。

中的重要欄位 SUBMIT_SM PDU:

  • service_type:某些提供者會要求使用。 在傳遞屬性中設定。

  • source_addr_tonsource_addr_npi:指出傳輸的來源位址型別。 這些欄位的含義是標準化的,但由於某些提供者使用它的方式不同,您應該要求提供者提供正確的值。 在外部帳戶中設定。

  • source_addr:MT的來源位址/ oADC。 它將顯示在行動電話上。 在外部帳戶和傳遞中設定,傳遞中的值優先於外部帳戶的值。

  • dest_addr_tondest_addr_npi:指出要傳輸的目的地位址型別(例如本機或國際格式)。 這些欄位的含義是標準化的,但由於某些提供者使用它的方式不同,您應該要求提供者提供正確的值。 在外部帳戶中設定。

  • destination_addr:收件者地址、電話號碼或MSISDN。

  • esm_class:用於判斷文字欄位中是否使用UDH。 如果符合以下條件,則聯結器會自動針對分割SMS啟用 message_payload 未使用模式。

  • priority_flag:此訊息的優先順序高於其他訊息。 這會與傳遞本身的優先順序繫結。

  • validity_period:時間戳記,之後不應嘗試重試。 在傳遞本身中設定。

  • registered_delivery:指出是否要求SR。 除了自動回覆之外,Adobe Campaign一律會設定此標幟。 對於多部分訊息,僅針對第一部分設定標籤。 所有版本都有相同的行為。

  • data_coding:表示文字欄位中使用的編碼。 請參閱 SMS文字編碼 區段以取得詳細資訊。

  • short_message:訊息的文字。 若使用UDH,這也會包含UHD標頭。

Adobe Campaign支援下列選用欄位:

  • dest_addr_subunit:用於指定SMS的目標:快閃、行動或SIM卡。 在傳遞屬性中設定。

  • message_payload:在外部帳戶中啟用時,長訊息將在單一PDU中傳送,文字將在此欄位中傳輸,而不是 short_message 欄位。

SUBMIT_SM_RESP

此PDU將包含MT的ID。 這對於匹配傳入的SR很有用。

重要

許多提供者會以十六進位傳送MT ID。 請務必將 MT確認中的ID格式 在外部帳戶中正確設定。

有些提供者會傳送 SUBMIT_SM_RESP 傳送SR之後。 為了說明該行為,Adobe Campaign會等待30秒再回覆 無效的訊息識別碼 至具有未知ID的SR。

DELIVER_SM

此PDU會由SMSC傳送至Adobe Campaign。 它包含MO或SR。

大多數欄位的意義與其相同 SUBMIT_SM 相對應專案。 以下是實用欄位清單:

  • source_addr:MO/SR的來源位址。 這通常是電話號碼。

  • destination_addr:收到MO或SR的簡短代碼。

  • esm_class:用於判斷PDU是MO還是SR。

  • short_message:訊息的文字。 對於SR,這包含SMPP通訊協定規格附錄B中說明的資料。 另請參閱 sr錯誤管理 以取得更多詳細資料。

Adobe Campaign可讀取以下位置的訊息ID: receipted_message_id 具有某些設定的選用欄位。

DELIVER_SM_RESP

此PDU由Adobe Campaign傳送,以認可SR和MO。

Adobe Campaign Classic會在SR和MO插入資料庫後確認它們。 即使成功,也可能會發生一些處理錯誤 DELIVER_SM_RESP PDU已傳送。 此限制是由Adobe Campaign Classic的軟體架構所造成。

此PDU僅用於檢查連線是否使用中。 應根據提供者的需求設定其頻率。

預設的60秒應該符合外部帳戶中設定的大多數設定。

此PDU會確認連線為使用中。

多部分SMS (長SMS)

重要

Adobe Campaign僅支援傳送多部分SMS或長SMS。 UDH和 message_payload 傳入的SMS (MO)不支援,這表示MO限製為160個字元。

多部分SMS或長SMS是以多個部分傳送的SMS。 由於行動網路通訊協定中的技術限制,SMS不能大於140位元組,否則需要分割。 請參閱 SMS文字編碼 區段以瞭解更多有關可放入簡訊的字元數。

長訊息的每個部分是個別的SMS。 這些零件在網路上獨立運作,並由接收端的行動電話組裝。 為了處理重試和連線問題,Adobe Campaign會以相反順序傳送這些部分,並僅在訊息的第一部分(最後傳送的部分)請求SR。 由於行動電話只會在收到其第一部分時顯示訊息,因此對其他部分的重試不會在行動電話上產生重複專案。

可以使用設定每個傳送的每則訊息簡訊數上限 每則訊息的簡訊數量上限 在中設定 傳遞範本. 在傳送期間,超過此限制的訊息將會失敗,並且SMS失敗原因太長。

傳送SMS長訊的方式有兩種:

  • UDH:傳送長訊息的預設與建議方式。 在此模式中,聯結器會將訊息分割為多個 SUBMIT_SM PDU內含UDH資訊。 此通訊協定是行動電話本身使用的通訊協定。 這表示Adobe Campaign對訊息產生擁有最大的控制權,能確切計算傳送了多少部分及如何分割。

  • message_payload:以單一傳送整個長訊息的方式 SUBMIT_SM PDU. 提供者必須加以分割,這表示Adobe Campaign無法得知已傳送的確切數量。 某些提供者需要此模式,但建議您僅在他們不支援UDH時才使用它。

請參閱「 」的說明 esm_classshort_messagemessage_payload 的欄位 SUBMIT_SM PDU 以取得有關通訊協定和格式的詳細資訊。

輸送量上限與視窗

大多數提供者需要每個SMPP連線的輸送量限制。 這可透過在外部帳戶中設定多個SMS來達成。 請注意,輸送量節流是發生在每個連線上,總有效輸送量是每個連線的限制乘以連線總數。 這在 同時連線 區段。

若要達到最大可能的輸送量,您需要微調最大傳送視窗。 傳送視窗為 SUBMIT_SM PDU可傳送而不等候 SUBMIT_SM_RESP. 請參閱 傳送視窗設定 區段以取得更多詳細資料。

SR和錯誤管理(「附錄B」)

SMPP通訊協定會定義中的標準同步錯誤 RESP PDUs,但不會定義SR的錯誤代碼。 每個提供者都使用各自的錯誤碼及其含義。

建議載於的附錄B區段 SMPP通訊協定規格 (第167頁),但這不會列出實際的錯誤代碼,亦不會列出其含義。

為了適應錯誤管理,已運用Adobe Campaign的broadlog訊息系統來適當地布建錯誤及其嚴重性(硬、軟等)。

如上所述,有兩種不同型別的錯誤:

  • 中的同步回覆 SUBMIT_SM_RESP 在訊息傳送至SMSC後立即發生
  • 行動裝置收到訊息或訊息逾時時,稍後可能會收到回條。 在此情況下,可在SR中找到錯誤。

收到SR時,可在其中找到狀態和錯誤 short_message 欄位(例如符合實施的附錄B)。 此 short_message PDU的欄位通常稱為 文字欄位 因為它包含MT文字。 若是SR,則包含技術資訊以及名為的子欄位 文字. 這2個欄位不相同,而且 short_message 實際包含 文字 欄位和其他資訊。

Adobe Campaign Classic聯結器(擴充式SMPP除外)會根據選取的提供者,使用硬式編碼行為。 通用SMPP只會區分成功和錯誤,不會提供詳細資訊。 傳遞記錄可能包含一些無法保證的資訊。

SR文字欄位格式

該規格建議對SR文字欄位使用此格式。 這是子欄位的清單,以冒號分隔,以區隔欄位名稱及其值。 欄位名稱不區分大小寫。

符合附錄B建議的SR文字欄位範例:

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

ID欄位是中收到的ID SUBMIT_SM_RESP PDU,確認MT。

subdlvrd 應該計算傳遞的零件和傳遞的訊息數量,但Adobe Campaign不使用此功能,因為broadlog系統提供更好、更整合的資訊。

submit datedone date 欄位代表MT的傳送時間與行動裝置傳送SR的時間戳記。 預期時區會出現一些問題,甚至是日期集不正確的行動裝置所給出的錯誤時間戳記。

stat欄位非常重要,因為它可告知訊息的狀態。 唯一重要的狀態為 DELIVRDUNDELIVREJECTD. 此 DELIVRD status表示成功,其他兩個表示錯誤。 也可以使用其他值,但通常是中繼通知,例如MT到達行動電信業者,但不是行動電話。 Adobe Campaign會忽略這些中繼通知。

錯誤欄位包含提供者特定的錯誤代碼。 提供者必須提供一份可能的錯誤代碼表及其含義,才能解譯此值。

最後,文字欄位通常包含MT文字的開頭。 Adobe Campaign會忽略此專案,而有些提供者不會傳輸此專案,以避免PII洩漏和網路頻寬消耗。 在疑難排解期間,您可以閱讀此欄位,更輕鬆地找出符合測試MT的SR。

Adobe Campaign Classic Extended generic SMPP中的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 extraction 規則運算式會套用以擷取ID,並將其與對應的MT進行調解。

然後 status extraction 規則運算式和 error code extraction 規則運算式會套用以擷取這些欄位,並附加至字串。

broadlog訊息是以此資訊建構,並且會附加原始未變更的字串以供參考:

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

然後會標準化訊息,移除MESSAGE部分,以便能夠將多個訊息與相同的狀態和錯誤碼進行比對。

SR ExampleProvider DELIVRD 000|#MESSAGE#

如果訊息尚未布建在broadlog訊息表格中,則會建立新專案,將整個訊息用作 第一文字 和標準化訊息。 然後,聯結器會使用成功和 error regex來判斷成功或失敗:

  • 如果它符合 success regex,則會視為成功。

  • 如果它符合 error regex,則訊息會限定為錯誤。

  • 如果這兩個規則運算式都不相符,則會忽略SR。 這可能是不由Adobe Campaign處理的中繼通知。

依預設,所有錯誤都會布建為軟錯誤。 這表示硬錯誤必須手動布建。

SMS文字編碼

您應該 如果出現編碼問題,請務必與SMSC提供者聯絡. 只有SMSC提供者知道他們支援的編碼,以及由於其技術平台的限制而可能適用的特殊規則。

SMS訊息使用特殊的7位元編碼,通常稱為GSM7編碼。

在SMPP通訊協定中,會將GSM7文字展開為每個字元8位元,以方便疑難排解。 SMSC會先將其封裝為每個字元7位元,再傳送給行動裝置。 這表示 short_message SMS的欄位在SMPP框架中可能長達160位元組,而在行動網路上傳送時限製為140位元組。

如果出現編碼問題,請檢查以下重要事項:

  • 請確定您知道哪些字元屬於哪種編碼。 GSM7不完全支援變音標籤或重音符號。 尤其是在法文中,é和è是GSM7的一部分,但ê、â或ï卻不是。 這同樣適用於西班牙文。

  • 含cedilla ©的C在GSM7字母表中僅以大寫形式出現,但有些手機以小寫或「智慧」型大小寫呈現。 一般建議是完全避免此情況,並移除cedilla或切換至UCS-2。

  • 請勿在簡訊中使用ASCII 除非SMSC提供者明確要求。 此編碼會浪費空間,因為它有8位元字元且覆蓋範圍比GSM7小。 北美洲使用的CDMA網路可能需要此編碼。

  • 不一定會支援Latin-1。 在嘗試使用Latin-1之前,請檢查與您的SMSC提供者的相容性。

  • Adobe Campaign聯結器不支援國家語言轉換表。 您必須使用UCS-2或其他 data_coding 而非。

  • UCS-2和UTF-16經常被手機混合使用。 使用emoji和UCS-2中不存在的其他字元時,會出現此問題。

  • 大多數電話沒有所有UCS-2字元的字型字元。 智慧型手機通常能夠輕鬆顯示罕見字元,但功能型手機通常只支援購買國母語有用的功能。 如果您想要使用emoji或ASCII-art,請在傳送前於多種手機上測試。 Adobe Campaign預覽不會模擬遺失的字元,且會顯示網頁瀏覽器上可用的符號。

data_coding 欄位會說明使用哪種編碼。 一個主要問題是,值0表示規格中的預設SMSC編碼,這通常指的是GSM7。 與編碼相關聯的SMSC合作夥伴確認 data_coding = 0 (Adobe Campaign僅支援)。 其他 data_coding 值通常遵循規格,但唯一能確定的方法是向SMSC提供者確認。

訊息的大小上限取決於其編碼。 下表總結了所有相關資訊:

編碼 常用資料編碼 訊息大小(字元) 多部分SMS的部分大小 可用字元
GSM 7 0 160 152 GSM7基本字元集+擴充功能(擴充字元佔2個字元)
Latin-1 3 140 134 ISO-8859-1
UCS-2
UTF-16
8 70 67 Unicode (因手機而異)

SMPP外部帳戶引數

SMPP通訊協定的每個實作都有許多變化。 為了提高相容性和適應性,有許多設定可用來變更SMPP聯結器的行為。 本節說明每個引數及其對聯結器的影響。

一般引數和製程

限制此帳戶的MTA執行個體

您可以設定允許連線至SMPP提供者的MTA執行個體數目限制。 如果勾選,您可以指定最多可以使用多少MTA。

此選項可讓您更精確地控制連線數目,請參閱 同時連線.

如果您設定的值高於正在執行的MTA數目,則所有MTA都會正常執行:此選項只是一個限制,不會產生其他MTA。

如果您需要精確控制連線數量(例如提供者需求),建議一律設定此選項,即使目前部署的執行中MTA數量正確。 如果之後新增其他MTA,仍會遵守連線限制。

連線設定

SMSC 實作名稱

設定SMSC實作的名稱。 應將其設定為您的提供者的名稱。 請聯絡管理員或傳遞團隊,以瞭解要在此欄位中新增什麼。 此欄位的角色在 sr錯誤管理 區段。

伺服器

要連線之伺服器的DNS名稱或IP位址。

連接埠

要連線的TCP連線埠。

帳戶

連線的登入。 傳遞於 system_id 繫結PDU的欄位。

密碼

SMPP連線的密碼。 在BIND PDU的密碼欄位中傳遞。

系統類型

傳入的值 system_id 繫結PDU的欄位。 有些提供者在這裡需要特定值。

MTA 子連線的數量

在Adobe Campaign Classic中,它會定義每個MTA子項的連線數量。

Adobe Campaign Classic Extended SMPP聯結器可以控制每個MTA子項的連線數量。 若要控制連線的全域限制,您必須限制MTA子處理序的數量,這通常表示要有SMS專用的中間來源平台。

對於Adobe Campaign Classic,接收器和傳送器連線數可能有所不同:

  • 傳送器連線= MTA子連線數目 MTA子處理序數目 MTA數目
    (若已設定自動回覆) + MTA子連線數目**

如上所述,如果啟用自動回覆,Adobe Campaign Classic SMS程式會開啟更多傳送器連線。 這些額外的連線可用來傳送自動回覆。

  • 接收器連線= MTA子連線的數量

如果您設定自動回覆,SMS程式會開啟傳送器/接收器配對,增加傳送器連線的數量。 如果您未設定任何自動回覆,則只會開啟接收者連線。

透過 SMPP 啟用 TLS

使用TLS連線到提供者。 連線將會加密。 TLS連線由OpenSSL程式庫管理,任何適用於OpenSSL的內容都將適用於此連線。

在記錄檔中啟用詳細的 SMPP 追蹤

此設定會傾印記錄檔中的所有SMPP流量。 在初始設定期間,通常需要調整引數。 疑難排解聯結器時必須啟用此功能,並與提供者看到的流量進行比較。

在Adobe Campaign Classic中,記錄輸出位於MT相關流量的MTA記錄中,以及MO和SR相關流量的SMS記錄中。

接收器連線設定

此區段只會以分隔顯示 傳送器+接收器 模式。

為接收方使用不同的參數

取消核取此方塊時,傳送器和接收器會使用相同的設定。

核取該方塊時,設定位於 連線設定 區段將套用至中的傳送器和設定 接收方連線 設定將套用至接收器。

接收方伺服器、連線埠、帳戶、密碼、系統型別

這些設定適用於處於傳送器+接收器模式的接收器。 它們的運作方式與傳送器部分類似,請參閱上方以瞭解更多詳細資訊。

SMPP頻道設定

允許字母音譯

音譯是尋找與遺失字元相等的字元的過程。 例如,GSM編碼中缺少法文「e」(帶有抑揚號)字元,但可將其取代為「e」,而不會影響可讀性。

取消核取此方塊時,如果文字編碼無法完全依照原樣編碼字串,則會失敗。

核取此方塊時,文字編碼會嘗試將字串轉換為近似版本,而非失敗。 如果某些字元在目標編碼中沒有對等字元,文字編碼將會失敗。

請參閱 定義編碼設定的特定對應 以取得編碼程式的一般說明。

在資料庫中儲存傳入的MO

啟用後,傳入的MO將儲存在資料庫的inSMS表格中。 可使用任何工作流程的查詢活動來查詢此表格。

Adobe Campaign Classic一律會將所有MO儲存在inSMS資料庫中,因此此選項無法使用。

在SR處理期間啟用即時KPI更新

啟用後,在收到錯誤SR時,KPI將在主要傳遞頁面上即時更新。

缺點可能是效能低,因為它會產生資料庫爭用。 如果停用,統計資料會更新為 syncfromexec 工作流程,每20分鐘執行一次。

Adobe Campaign Classic的KPI機制完全不同,因此此選項無法使用。

來源編號

定義訊息的預設來源位址。 此設定僅適用於傳送中來源編號為空白的情況。

依預設,來源編號欄位不會傳遞,因此提供者會將其取代為短程式碼。

這會啟用寄件者地址/oADC覆寫功能。

簡短代碼

表示帳戶的主要簡短代碼。 如果此帳戶使用多個短代碼,或短代碼未知,請將此欄位留空。

指定短程式碼對兩個功能很有幫助:

  • 如果未提供原始碼,預覽會顯示簡短代碼。 它會反映行動電話上的真實行為。

  • 自動回覆功能的封鎖清單設定只會針對特定的短程式碼傳送給隔離使用者。

來源TON/NPI、目的地TON/NPI

TON (編號型別)和NPI (編號計畫指示器)在 SMPP 3.4規格 (第117頁)。 這些值應該設定為提供者的需求。

它們會依原樣在中傳輸 source_addr_tonsource_addr_npidest_addr_tondest_addr_npi 的欄位 SUBMIT_SM PDU.

服務類型

此欄位會依原樣在中傳輸 service_type 的欄位 SUBMIT_SM PDU. 將此設定為提供者的需求。

輸送量和逾時

這些設定會控制SMPP頻道的所有計時方面。 有些提供者需要非常精確的訊息速率、視窗和重試計時控制。 這些設定應設定為符合提供者容量與其合約中所指示條件的值。

傳送窗口

視窗為 SUBMIT_SM PDU可傳送而不需要等候相符專案 SUBMIT_SM_RESP.

最大視窗為4的傳輸範例:

當網路連結具有高延遲時,此視窗有助於提高輸送量。 視窗的值必須至少是SMS數乘以連結延遲秒數,這樣聯結器就不會等待 SUBMIT_SM_RESP 再傳送下一個訊息。
如果視窗太大,您可以在連線發生問題時傳送更多重複的訊息。 此外,大多數提供者對視窗有非常嚴格的限制,並拒絕超過限制的訊息。

如何計算最佳傳送時段公式:

  • 測量兩者之間的最大延遲時間 SUBMIT_SMSUBMIT_SM_RESP.

  • 以秒為單位將此值乘以最大MT輸送量。 這會提供最佳傳送視窗值。

範例:如果您在最大MT輸送量中設定了300個SMS/s,而且兩者之間有100毫秒的延遲 SUBMIT_SMSUBMIT_SM_RESP 平均而言,最佳值為 300×0.1 = 30.

最大 MT 輸送量

每秒和每個連線的MT數目上限。 此設定會嚴格執行,MTA絕不會推送訊息的速度超過此限制。 對於需要精確節流功能的提供者來說,這個變數非常有用。

若要知道總輸送量限制,請用上述公式中詳述的連線總數乘以該數值。

0表示沒有限制,MTA會儘快傳送MT。

通常建議將此設定保持在1000以下,因為除非在最終架構上正確設定基準並特別要求SMPP提供者,否則無法保證超過此數字的精確輸送量。 最好將連線數目增加至1000 MT/s以上。

重新連線前的時間

當TCP連線中斷時,聯結器會等待這個秒數,再嘗試建立連線。

MT 的有效期

逾時介於 SUBMIT_SM 及其相符專案 SUBMIT_SM_RESP. 如果 RESP 未及時收到,則訊息會視為失敗,並套用MTA的全域重試原則。

繫結逾時

TCP連線嘗試與 BIND_*_RESP 回覆。 逾時時,Adobe Campaign聯結器會關閉連線,而且會等待一段時間再重新連線,然後重試。

enquire_link 是一種特殊型別的PDU,會傳送以保持連線運作。 此期間以秒為單位。 行銷活動聯結器只會傳送 enquire_link 當連線閒置以節省頻寬時。 如果在此期間後兩次未收到任何RESP,則會將連線視為無法使用,並觸發重新連線程式。

SMSC 細節

這些設定是進階設定,可讓Adobe Campaign聯結器適應大多數SMPP實作特性。

定義編碼的特定對應

請參閱 SMS文字編碼 區段,以瞭解有關文字編碼的詳細資訊。

此設定可讓您定義與規格不同的自訂編碼對應。 您將能夠宣告編碼清單,以及其 data_coding 值。

MTA將嘗試使用清單中的第一個編碼進行編碼。 如果失敗,則會嘗試使用清單上的下一個編碼等。 如果無法使用編碼來編碼訊息,則會發生錯誤。 找到編碼後,MTA將建立 SUBMIT_SM PDU 包含編碼文字和 data_coding 以表格中指定的值設定的欄位。

表格中的專案順序很重要:編碼是從上到下的嘗試。 您應該將最便宜或最建議的編碼放在清單的最上方,然後是越來越昂貴的編碼。

請注意,UCS-2永遠不會失敗,因為它可以編碼Adobe Campaign支援的所有字元,並且UCS-2 SMS的長度上限小得多:僅限70個字元。

您也可以使用此設定,透過在對應表格中僅宣告1行,強制一律使用特定編碼。

未勾選核取方塊時使用的預設對應,等同於下表:

data_coding 編碼
0 GSM
9 UCS-2

這表示MTA會嘗試在GSM中編碼訊息。 如果成功,它將傳送它 data_coding 設為0。

如果訊息無法以GSM編碼,則會以UCS-2編碼,並設定 data_coding 至8。

啟用message_payload

取消勾選後,MTA會分割長簡訊,並以多個形式傳送 SUBMIT_SM PDU與UDH搭配使用。 此訊息將由行動電話根據UDH資料重新撰寫。

檢查完畢後,長簡訊會傳送至一個SUBMIT_SM PDU,並將文字放入message_payload選用欄位中。 請參閱 SMPP規格 以取得相關詳細資訊。

如果啟用此功能,Adobe Campaign將無法個別計算SMS部分:所有訊息都會計為只傳送一個部分。

傳送完整的電話號碼

如果未核取此核取方塊,則只會傳送電話號碼的數字給提供者(destination_addr 的欄位 SUBMIT_SM 欄位)。 這是預設行為,因為國際數字指標(通常是+前置詞)會由SMPP中的TON和NPI欄位取代。

核取核取方塊後,電話號碼會依原樣傳送,不會預先處理及可能的空格、+前置詞或井字型大小/雜湊/星號。

此功能也會對自動回覆封鎖清單功能的行為產生影響:如果未核取此核取方塊,則會將+首碼新增至插入隔離表格的電話號碼,以補償SMPP通訊協定本身從電話號碼移除的+首碼。

略過TLS憑證檢查

啟用TLS時,會略過所有憑證檢查。

檢查完畢後,連線不再安全,生產環境不應啟用連線。

此變數可用於偵錯或測試。

您可以在三種不同的憑證驗證值之間進行選擇:

  • 完整的認證檢查(包括主機名稱),預設。
  • 略過主機名稱驗證.
  • 略過憑證驗證.

繫結TON/NPI

TON (編號型別)和NPI (編號計畫指示器),詳見 SMPP 3.4規格 (第117頁)。 這些值應該設定為提供者所需的任何值。

它們會依原樣在中傳輸 addr_tonaddr_npi 繫結PDU的欄位。

地址範圍

在BIND PDU的address_range欄位中依原樣傳送。 此值應設定為提供者所需的任何值。

無效 ID 確認計數

限制 訊息識別碼無效 DELIVER_SM_RESP 可為單一SR傳送。

此變數僅能用於疑難排解目的,作為因應措施 並在正常情況下設為0。

Fox範例,設定為2時:

  • 提供者傳送SR (DELIVER_SM),ID為「1234」。

  • 在資料庫中找不到ID "1234"。

  • 聯結器計數為1 無效的ID 該ID發生錯誤,因此會傳送 DELIVER_SM_RESP 「訊息ID無效」的錯誤碼(正常行為)。

  • 提供者會重試ID為「1234」的同一SR。

  • 在資料庫中仍然找不到ID "1234"。

  • 聯結器計數為2 無效的ID 該ID發生錯誤,因此會傳送 DELIVER_SM_RESP "OK",即使未正確處理亦然。

  • 此功能旨在當無效的SR區塊合法表示無法處理訊息時,清除提供者端的SR緩衝區。

將此欄位設為0會停用以下機制: 訊息識別碼無效 一律會傳回,這是正常行為。

將此欄位設為1,即使ID無效,聯結器一律會回應「確定」。 只有在監督下,才應將這個值設為1,以進行疑難排解,並設定為最短時間,例如,從提供者端的問題中復原。

SR 中 ID 的擷取規則運算式

SMPP通訊協定規格並未嚴格執行SR格式。 這僅是中說明的建議 附錄B (第167頁)。 有些SMPP實作人員格式化此欄位的方式不同,因此Adobe Campaign需要一種方法來擷取正確的欄位。

依預設,它會在之後擷取最多10個英數字元 id:.

規則運算式必須正好有一個擷取群組,其部分包含在括弧中。 括弧必須圍繞ID部分。 規則運算式格式為PCRE。

調整此設定時,請務必儘可能加入更多內容,以避免誤觸發。 如果有特定的首碼,例如 id: 在標準中,將它們包含在規則運算式中。 請儘量使用文字分隔符號(\b),以避免在文字中間擷取文字。

在規則運算式中加入的上下文不夠可能會引入一個小的安全性缺陷:消息的實際內容可以包含在SR中。 如果您只比對沒有內容的特定ID格式(例如UUID),則可能是剖析實際的文字內容(例如,內嵌在文字欄位中的UUID),而不是ID。

用於確定成功/錯誤狀態所套用的規則運算式

遇到具有未知stat/err欄位組合的訊息時,這些規則運算式會套用在stat欄位上,以判斷SR是成功還是錯誤。 含有不符合任何這些規則運算式的stat值的SR會被忽略。

依預設,以開頭的統計值 DELIV,例如 DELIVRD附錄B,將被視為已成功傳遞,且所有符合錯誤的stat值,例如 REJECTEDUNDELIV視為錯誤。

MT確認中的ID格式

這表示ID傳回的格式 message_id 的欄位 SUBMIT_SM_RESP PDU.

  • 不要修改:ID會依原樣儲存在資料庫中,作為ASCII編碼文字。 不會進行預先處理或篩選。

  • 十進位數字:ID應為ASCII格式的小數。 使用此設定時,會移除開頭和結尾空格以及開頭的零。

  • 十六進位數字:ID應為ASCII格式的十六進位數字,開頭不能為0x,結尾不能為h。然後,ID會先轉換為十進位數字,再儲存至資料庫中。

  • 十六進位字串:ID應為ASCII編碼的文字,其本身即為以十六進位編碼的位元組字串。 例如,在PDU中,您會找到 0x34 0x31 0x34 0x32 0x34 0x33,會轉換為ASCII「414243」。 然後,此字串會解碼為位元組的十六進位字串,因此您會取得「ABC」:您會將ID「ABC」儲存在資料庫中。

SR中的ID格式

這表示擷取的ID格式 Extraction SR中ID的regex。 值與上述MT格式具有相同的含義和相同的行為。

選擇性欄位中的 SR ID 或錯誤代碼

注意

僅適用於Adobe Campaign Classic Extended SMPP聯結器。

如果勾選,則選用欄位的內容將會附加至上述規則運算式處理的文字中。 文字將具有格式 0xTAG:VALUE0xTAG 大寫標籤的4位十六進位值,例如。 0x002E.

例如,您可能想要擷取 receipted_message_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)值的選用欄位。 具體而言,目前的規則運算式系統無法可靠地擷取二進位欄位。

文字欄位中的 SR ID 或錯誤代碼

若勾選, 文字 在處理SR的狀態文字期間將保留欄位。

如果提供者將重要資料放在此欄位中(例如ID或狀態),這會很有用。 此欄位通常可以安全地捨棄,因為它可能包含具有非ASCII編碼的文字,並中斷規則運算式處理。

啟用此選項可能會引入非常小的安全性缺陷,如果 Extraction SR欄位中ID的規則運算式不夠具體。 的內容 文字 欄位可能會剖析為ID,而攻擊者可能會用它來插入偽造的ID,這可能會導致部分拒絕服務情況。

服務ID標籤

允許新增自訂TLV。 此欄位會設定標籤部分。 值可在的每次傳遞中自訂 服務或方案ID 傳遞的進階引數中的值。

此設定僅允許每則訊息新增一個TLV選項。

自動回覆傳送至 MO

重要

在Adobe Campaign Classic和混合式架構中,對延伸的SMPP聯結器套用自動回覆時,需要為mid運運算元在 外部帳戶 資料夾。

此功能可讓您快速回覆MO文字,並處理傳送到封鎖清單的每短程式碼。

關鍵字簡短程式碼 欄會定義觸發自動回覆的條件。 如果兩個欄位相符,會傳送MO並觸發其他動作。 若要指定萬用字元,應將此欄位留空。 關鍵字與MO文字中的第一個英數字元字詞相符,忽略標點符號和前導空格。 這表示 關鍵字 欄位不可包含空格,且必須為單一單字。

關鍵字 設定是首碼。 例如,如果您指定「AD」,則會比對「AD」、「ADAPT」和「ADOBE」。 如果您有多個具有相同首碼的關鍵字,則需注意順序,因為關鍵字是從上到下處理。

回覆 欄是要回覆的文字。 此欄位中沒有可用的個人化。 如果您將此欄位留空,將不會回覆任何訊息,但仍將觸發其他動作。

其他動作 欄提供當兩者皆有時的額外動作 關鍵字簡短程式碼 相符,空白短代碼符合所有短代碼。 您可以傳送到隔離區或從隔離區中移除,值none回覆文字。 如果您指定 其他動作 但請將 回覆 欄位留空時,將會執行動作但不會傳送任何回覆。 隔離僅適用於指定的短程式碼,如果欄位留空,則所有短程式碼都會套用。

重要

「傳送完整電話號碼」設定會影響自動回覆隔離機制的行為:如果未勾選「傳送完整電話號碼」,則加入隔離的電話號碼會加上加號(「+」),使其與國際電話號碼格式相容。

表格中的所有專案都會以指定的順序處理,直到符合一個規則為止。 如果有多個規則符合MO,則只會套用最上層的規則。

簡訊傳遞範本引數

某些引數可依傳遞範本設定。

從欄位

此欄位為選用。 它允許覆寫寄件者地址(oADC)。 此欄位的內容放在 source_addr 的欄位 SUBMIT_SM PDU.

根據SMPP規格,該欄位限製為21個字元,但某些提供者可能允許較長的值。 另請注意,某些國家/地區可能會套用非常嚴格的限制,例如長度、內容、允許的字元。

傳送參數

每則訊息的簡訊數量上限

此設定僅適用於 訊息裝載 設定已停用。 如果訊息需要的SMS數量超過此值,則會觸發錯誤。

SMS通訊協定將SMS限製為255個部分,但有些行動電話無法拼合長度超過10個部分的長訊息,此限制取決於確切的模型。 我們建議您不要每則訊息超過5個部分。

由於個人化訊息在Adobe Campaign中的運作方式,訊息的大小可能會有所不同。 大量長訊息可能會增加傳送成本。

傳輸模式

此欄位會指出您要傳輸的SMS型別:一般或快閃訊息,儲存在行動裝置或SIM卡上。

此設定會傳輸至 dest_addr_subunit 中的選用欄位 SUBMIT_SM PDU.

  • 未指定 在PDU中未傳送任何選用欄位。

  • Flash 將值設為1。 它會傳送一則快閃訊息,該訊息會在行動裝置上彈出,且不會儲存在記憶體中。

  • 一般 將值設為0。 它會傳送正常訊息。

  • 儲存在行動裝置上 將值設為2。 它會告訴手機將簡訊儲存在內部記憶體中。

  • 儲存在終端機上 將值設為3。 它會告訴手機將簡訊儲存在SIM卡中。

有效期限

有效期間會傳輸至 validity_period 的欄位 SUBMIT_SM PDU. 日期一律會格式化為絕對UTC時間格式,日期欄位將以「00+」結尾。

擴充通用SMPP聯結器

箭頭代表資料流程。

傳送傳遞部分時,MTA會產生MTA子項。 MTA子處理序的數目是動態的,且取決於serverConf.xml中的設定。 每個MTA子系都會例項化聯結器 CSmppConnectorWorker 會連線至SMPP提供者。 只要MTA子項保持連線(也可以在serverConf.xml中設定),連線就會保持連線。

SMS程式只會處理SR,它會連線到提供者並保持連線開啟。 程式每10分鐘會重新連線以重新載入新設定,這是正常操作。

比對MT、SR和broadlog專案

中繼表格 nmsProviderMsgId 用於在非同步提交至broadlog之前暫時儲存MT和SR資料。

nmsProviderMsgId 表格有3組欄:

  • 在傳送及確認MT時更新的欄: iBroadLogIdiDeliveryId

  • 收到SR時更新的欄: iMsgIdiStatus

  • 一律更新的欄: tsCreatedsProviderId

當MT和SR都完成處理時,您應該有完整的行,其中包含broadlog資訊和狀態資訊。

此處, iMsgId 已連結至 nmsBroadLogMsg 表格,指出完整狀態/錯誤訊息。

SMS程式每分鐘會檢查一次完整的行,然後以非同步方式處理它們:

  • 會讀取完整行。
  • SMS程式會根據傳遞對應來計算broadlog表格的名稱。
  • SMS程式會使用訊息ID和狀態來更新broadlog表格。

輸送量和平行連線

每個MTA子系會建立可設定的連線數量,因此限制MTA子系的數量將限制連線數量。 由於MTA子處理程式與流量之間的關聯是相關的,這可以在一定程度上控制,但仍有些不可預測。

上線之前

此檢查清單提供您上線前應檢查的事項清單。 不完整的設定可能會導致許多問題。

檢查外部帳戶衝突

檢查您是否沒有舊的SMS外部帳戶。 如果您停用測試帳戶,則會在生產系統上重新啟用該帳戶並產生潛在衝突的風險。

如果您在同一Adobe Campaign執行個體上擁有多個帳戶,且這些帳戶已連線至相同的提供者,請連絡提供者,以確定他們確實能區分這些帳戶之間的連線。 若有多個帳戶具有相同登入,則需要額外設定。

在檢查期間啟用詳細的SMPP追蹤

檢查期間應一律啟用詳細的SMPP追蹤。
即使您無法自行檢查記錄,也可以更輕鬆地 Adobe客戶服務 協助您。

測試您的簡訊

  • 傳送包含各種字元的簡訊
    如果您需要傳送包含非GSM或非ASCII字元的SMS,請嘗試傳送一些包含儘可能多不同字元的訊息。 如果您設定自訂字元對應表,請儘量傳送至少一個SMS
    data_coding values.

  • 檢查SR是否已正確處理
    SMS應在傳送記錄檔中標示為已接收。 傳遞記錄應該會成功,並且看起來像這樣:檢查您是否已變更傳遞提供者名稱。 傳遞記錄不應包含 SR yourProvider stat=DELIVRD err=000|#MESSAGE
    檢查您是否已變更傳遞提供者名稱。 傳遞記錄不應包含 SR一般 在生產環境中。

  • 檢查是否已處理MO
    如果您需要處理MO (自動回覆、將MO儲存在資料庫等), 嘗試進行一些測試。 為所有自動回覆關鍵字傳送一些簡訊,並檢查回覆是否足夠快,不超過幾秒。
    在記錄中籤入Adobe Campaign成功回覆的記錄
    DELIVER_SM_RESP (command_status=0)。

檢查PDU

即使訊息看起來成功,請務必檢查PDU的格式是否正確。

在連線到之前未連線到Adobe Campaign的提供者時,此步驟是必要的。

繫結

檢查 BIND_* PDUs 正確傳送。 最重要的檢查專案是提供者一律會成功傳回 BIND_*_RESP PDUs (command_status = 0)。

檢查數量是否較少 BIND_* PDUs.如果數量太多,可能表示連線不穩定。 請參閱 不穩定的連線問題 區段以取得詳細資訊。

檢查 ENQUIRE_LINK PDU當連線閒置時,會定期交換。

SUBMIT_SM / DELIVER_SM

傳送訊息,然後在記錄中搜尋其對應的訊息 SUBMIT_SMSUBMIT_SM_RESPDELIVER_SMDELIVER_SM_RESP PDUs.

使用 SUBMIT_SM PDU

  • 檢查 data_coding 正確,預設為0。
  • 檢查 short_message 已正確編碼。 請嘗試使用支援多重編碼的十六進位轉換器來解碼。

使用 SUBMIT_SM_RESP PDU

  • 檢查是否成功,command_status = 0。
  • 檢查其內文是否包含正確格式化的ID,及其後面的「0」位元組。

使用 DELIVER_SM PDU

  • 將十六進位解碼 short_message 欄位。
  • 使用規則運算式檢查工具檢查中定義的規則運算式 Extraction SR中ID的regex只會傳回一個擷取群組,且會擷取訊息中的整個ID。
  • 檢查擷取的ID是否與中的相符 SUBMIT_SM_RESP.
  • 檢查中定義的規則運算式 Extraction SR中狀態的regex會傳回stat欄位的內容。
  • 檢查中定義的規則運算式 Extraction SR中錯誤的規則運算式會傳回錯誤欄位的內容。

使用 DELIVER_SM_RESP PDU

  • 檢查它是否在收到 DELIVER_SM PDU,通常少於1秒。
  • 檢查是否成功,command_status = 0。

向您的提供者查詢

即使您的SMS成功,請聯絡提供者以檢視是否一切正常。

停用詳細的SMPP追蹤

完成所有檢查後,最後一件事就是 停用詳細的SMPP追蹤 不產生太多記錄。 您甚至可以在生產系統上重新啟用這些功能,以進行疑難排解。

本頁內容