建立和傳送應用程式內訊息
瞭解如何使用Experience Platform Mobile SDK和Journey Optimizer為行動應用程式建立應用程式內訊息。
Journey Optimizer可讓您建立行銷活動,以傳送應用程式內訊息給目標對象。 Journey Optimizer中的行銷活動是用來透過各種管道,將一次性內容傳送給特定對象。 透過行銷活動,可同時執行動作(立即執行或根據指定排程執行)。 使用歷程時(請參閱Journey Optimizer推播通知課程),動作會依序執行。
在使用Journey Optimizer傳送應用程式內訊息之前,您必須確保有適當的設定和整合。 若要瞭解Journey Optimizer中的應用程式內傳訊資料流程,請參閱檔案。
先決條件
- 成功建立並執行應用程式,且已安裝並設定SDK。
- 為Adobe Experience Platform設定應用程式。
- 存取Journey Optimizer以及推送通知的足夠許可權。 此外,您需要足夠的許可權才能使用下列Journey Optimizer功能。
- 管理行銷活動。
- 實體iOS裝置或模擬器以進行測試。
學習目標
在本課程中,您將學習
- 在Journey Optimizer中建立管道設定。
- 安裝並設定Journey Optimizer標籤擴充功能。
- 更新您的應用程式以註冊Journey Optimizer標籤擴充功能。
- 驗證Assurance中的設定。
- 在Journey Optimizer中定義您自己的促銷活動和應用程式內訊息體驗。
- 從應用程式內傳送您自己的應用程式內訊息。
設定
建立管道設定
若要開始,您必須建立通道設定,才能從Journey Optimizer傳送應用程式訊息通知。
-
在Journey Optimizer介面中,開啟頻道 > 一般設定 > 頻道設定功能表,然後選取建立頻道設定。
-
輸入設定的名稱和說明(選擇性)。 例如,
LumaInAppMessaging和Channel for in-app messaging。note note NOTE 名稱必須以字母(A-Z)開頭。 它只能包含英數字元。 您也可以使用底線 _、點.和連字號-字元。 -
若要將自訂或核心資料使用標籤指派給組態,您可以選取管理存取權。 進一步瞭解物件層級存取控制(OLAC)。
-
選取 應用程式內傳訊 頻道。
-
選取行銷動作,以使用此設定來關聯同意原則與訊息。 所有與行銷動作相關的同意政策都會被用來尊重客戶的偏好設定。 進一步瞭解行銷動作。 例如:推送目標定位。
-
選取您要定義設定的平台。 此設定可讓您為每個平台指定目標應用程式,並確保跨多個平台的一致內容傳遞。
note note NOTE 對於iOS和Android平台,傳送完全以應用程式ID為基礎。 如果兩個應用程式共用相同的應用程式ID,則會將內容傳送給兩者,無論在 頻道設定 中選取的平台為何。 -
輸入您要支援之平台的應用程式ID。
{modal="regular"}
-
選取 提交 以儲存您的變更。
更新資料流設定
為確保將從您的行動應用程式傳送至Edge Network的資料轉送至Journey Optimizer,請更新您的Experience Edge設定。
-
在資料收集UI中,選取資料串流,然後選取您的資料串流,例如Luma Mobile App。
-
選取
的更多,並從內容功能表選取 編輯。 -
在資料串流 >
> Adobe Experience Platform畫面中,確定已選取Adobe Journey Optimizer。 如需詳細資訊,請參閱Adobe Experience Platform設定。 -
若要儲存您的資料流組態,請選取儲存。
{modal="regular"}
安裝Journey Optimizer標籤擴充功能
若要讓應用程式與Journey Optimizer搭配使用,您必須更新標籤屬性。
- 導覽至標籤 > 擴充功能 > 目錄。
- 開啟您的屬性,例如Luma Mobile App Tutorial。
- 選取目錄。
- 搜尋 Adobe Journey Optimizer 擴充功能。
- 安裝擴充功能。
當 僅 在您的應用程式中使用應用程式內訊息時,在 安裝擴充功能 或 設定擴充功能 中,您不需要設定任何專案。 如果您已按照教學課程中的推播通知課程進行,您會看到針對 開發 環境,已從 事件資料集 清單中選取 AJO推播追蹤體驗事件資料集 資料集。
在應用程式中實作Journey Optimizer
如先前課程所述,安裝行動標籤擴充功能僅會提供設定。 接下來,您必須安裝並註冊傳訊SDK。 如果未清除這些步驟,請檢閱安裝SDK區段。
-
在Xcode中,請確定已將AEP訊息新增至套件相依性中的套件清單中。 請參閱Swift封裝管理員。
-
導覽至Xcode專案導覽器中的Luma > Luma > AppDelegate。
-
請確定
AEPMessaging是匯入清單的一部分。import AEPMessaging -
請確定
Messaging.self是您註冊的擴充功能陣列的一部分。code language-swift let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ]
-
在Android Studio中,確定aepsdk-messaging-android是Android ChevronDown >
中 build.gradle.kts 的相依性的一部分。 請參閱Gradle。 -
在Android Studio專案導覽器中,導覽至Android
app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication。 -
請確定
com.adobe.marketing.mobile.Messaging是匯入清單的一部分。import import com.adobe.marketing.mobile.Messaging -
請確定
Messaging.EXTENSION是您註冊的擴充功能陣列的一部分。code language-kotlin val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION )
使用Assurance驗證設定
-
檢閱設定指示區段,將您的模擬器或裝置連線到Assurance。
-
在Assurance UI中,選取設定。
{modal="regular"}
-
選取
旁的 加號 按鈕。 -
選取「儲存」。
{modal="regular"}
-
從左側導覽中選取應用程式內傳訊。
-
選取 驗證 標籤。 確認您沒有收到任何錯誤。
{modal="regular"}
建立您自己的應用程式內訊息
若要建立您自己的應用程式內訊息,您必須在Journey Optimizer中定義行銷活動,以根據發生的事件觸發應用程式內訊息。 這些事件可以是:
- 資料傳送至Adobe Experience Platform,
- 核心追蹤事件,例如動作,或透過行動核心通用API的PII資料狀態或集合,
- 應用程式生命週期事件,例如,啟動、安裝、升級、關閉或當機。
- 地理位置事件,例如進入或退出地標。
在本教學課程中,您將會使用Mobile Core一般API和獨立於擴充功能的API (請參閱Mobile Core generic API),以方便使用者畫面、動作和PII資料的事件追蹤。 這些API產生的事件會發佈至SDK事件中樞,並可由擴充功能使用。 SDK事件中樞提供與所有Mobile Platform SDK擴充功能繫結的核心資料結構。 事件中心會維護已註冊的擴充功能和內部模組清單、已註冊的事件接聽程式清單,以及共用狀態資料庫。
SDK事件中心會發佈和接收來自已註冊擴充功能的事件資料,以簡化與Adobe和協力廠商解決方案的整合。 例如,安裝「最佳化」擴充功能後,事件中樞會透過Journey Optimizer — 決策管理優惠引擎處理所有請求和互動。
-
在Journey Optimizer UI中,從左側邊欄選取促銷活動。
-
選取建立行銷活動。
-
在 建立您的行銷活動 對話方塊中,選取
已排程 — 行銷,並選取確認。 -
在 行銷活動 — YYYY-MM-DD HHSS UTC+XX:XX 畫面中:
-
在 屬性 索引標籤中:
- 輸入行銷活動的名稱,例如,
Luma Mobile In-App Campaign。 - 選擇性地新增說明。
- 輸入行銷活動的名稱,例如,
-
選取 動作 標籤。
-
在 顯示訊息if 底下,選取
新增動作。 從下拉式功能表中選取應用程式內訊息。 -
從 應用程式內訊息設定 下拉式功能表,選取您的設定。 例如,LumaInAppMessaging。
-
選取
編輯觸發程式。 -
在 應用程式內訊息觸發程式 對話方塊中:
-
選取應用程式啟動,然後從下拉式選單中選取追蹤動作。
-
選取
新增條件。 -
從下拉式功能表中選取 動作 和等於。
-
輸入
in-app。 -
選取
新增條件。 -
從下拉式功能表中選取內容資料,然後輸入
showMessage。 -
從下拉式功能表中選取等於,然後輸入
true。 {modal="regular"}
-
選取完成。
-
-
-
回到主要行銷活動定義畫面,選取 Content 標籤。
-
啟用進階格式。
-
選取 模型 做為傳訊配置。 在 切換配置 對話方塊中,選取變更配置。
-
在 內容 索引標籤中。
- 輸入
https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png媒體URL 的。 - 輸入Header,例如
Welcome to this Luma In-App Message,並輸入Body,例如Triggered by pushing that button in the app...。
{modal="regular"}
- 輸入
-
選取 設定 標籤。
- 選取 訊息 中的自訂大小。
- 停用適合內容。
- 將 高度 設為75%。
{modal="regular"}
-
-
-
選取檢閱以啟動。 若要選擇性地編輯Content、Properties、Actions或以上的任何組態,請選取
。 -
在 檢閱以啟動(行銷活動名稱) 畫面中,選取啟動。
-
一段時間後,您會在 行銷活動 清單中看到狀態為 即時 的行銷活動名稱。
{modal="regular"}
觸發應用程式內訊息
您已具備傳送應用程式內訊息的所有要素。 剩下的是如何在應用程式中觸發此應用程式內訊息。
-
前往Xcode專案導覽器中的Luma > Luma > Utils > MobileSDK。 尋找
func sendTrackAction(action: String, data: [String: Any]?)函式,並新增下列程式碼,此程式碼會根據引數MobileCore.track和呼叫actiondata函式。code language-swift // Send trackAction event MobileCore.track(action: action, data: data) -
前往Xcode專案導覽器中的Luma > Luma > Views > General > ConfigView。 尋找應用程式內訊息按鈕的程式碼,並新增下列程式碼:
code language-swift // Setting parameters and calling function to send in-app message Task { MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"]) }
-
在Android Studio導覽器中,前往Android
> app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK。 尋找fun sendTrackAction(action: String, data: Map<String, String>?)函式,並新增下列程式碼,此程式碼會根據引數MobileCore.track和呼叫actiondata函式。code language-kotlin // Send trackAction event MobileCore.track(action, data) -
在Android Studio導覽器中,移至Android
> app > kotlin+java > com.adobe.luma.tutorial.androi > views > ConfigView.kt。 尋找onInAppMessageClick處理常式按鈕的程式碼,並新增下列程式碼:code language-kotlin // Setting parameters and calling function to send in-app message MobileSDK.shared.sendTrackAction( "in-app", mapOf("showMessage" to "true") )
使用您的應用程式進行驗證
您可以從應用程式本身驗證應用程式內訊息。
-
使用
,在模擬器中或在Xcode的實體裝置上重建並執行應用程式。 -
前往 設定 標籤。
-
點選應用程式內訊息。 您會在應用程式中看到應用程式內訊息。
{width="300"}
-
使用
,在模擬器中或在Android Studio的實體裝置上重建並執行應用程式。 -
前往 設定 標籤。
-
點選應用程式內訊息。 您會在應用程式中看到應用程式內訊息。
{width="300"}
驗證Assurance中的實作
您可以在Assurance UI中驗證應用程式內訊息。
- 檢閱設定指示區段,將您的模擬器或裝置連線到Assurance。
- 選取應用程式內傳訊。
- 選取事件清單。
- 選取 顯示訊息 專案。
- 檢查原始事件,特別是
html,其中包含應用程式內訊息的完整版面配置和內容。
{modal="regular"}
後續步驟
您現在應該擁有所有相關和適用的所有工具,以便開始新增應用程式內訊息。 例如,根據您在應用程式中追蹤的特定互動來促銷產品。
下一個: 建立和顯示優惠方案