인앱 메시징

임의의 분석 데이터 또는 이벤트에서 트리거되는 인앱 메시지를 제공할 수 있습니다. 구현 후 메시지는 앱에 동적으로 전달되므로 코드를 업데이트할 필요가 없습니다.

새로운 Adobe Experience Cloud SDK 릴리스

Adobe Experience Platform Mobile SDK와 관련된 정보 및 설명서를 찾고 계십니까? 여기를 클릭하여 최신 설명서를 확인하십시오.

중요

2018년 9월 일자로 SDK의 새로운 주요 버전을 릴리스하였습니다. 이러한 새로운 Adobe Experience Platform Mobile SDK는 Experience Platform Launch를 통해 구성할 수 있습니다.

중요

Adobe Experience Platform Mobile SDK와 Adobe Launch를 함께 사용 중인 경우, Adobe Mobile Services 기능(예: 인앱 메시지, 푸시 알림 또는 획득 링크)을 사용하려면 Adobe Analytics Mobile Services 확장 프로그램을 설치​해야 합니다. 자세한 내용은 Adobe Analytics - Mobile Services를 참조하십시오. Experience Cloud SDK와 함께 푸시 메시지 및 인앱 메시지를 사용하는 방법에 대한 자세한 내용은 푸시 메시지 설정인앱 메시지 설정을 참조하십시오.

중요

인앱 메시지를 사용하려면 반드시 SDK 버전 4.2 이상이 있어야 합니다.

Adobe Mobile Services에서 메시지가 표시되는 시기를 정의하는 메시지와 규칙을 만들 수 있습니다. 자세한 내용은 인앱 메시지 만들기를 참조하십시오. 인앱 메시지를 표시하려면 SDK를 업데이트해야 합니다. 메시지를 아직 정의하지 않았더라도 이러한 단계를 완료할 수 있습니다. 메시지를 정의하면 앱스토어를 업데이트하지 않아도 메시지가 앱에 동적으로 전달되어 표시됩니다.

인앱 메시지 사용

  1. 프로젝트에 라이브러리를 추가하고 라이프사이클을 구현합니다.

    자세한 내용은 핵심 구현 및 라이프사이클에서 IntelliJ IDEA 또는 Eclipse 프로젝트에 SDK 및 구성 파일 추가​를 참조하십시오.

  2. AndroidManifest.xml 파일을 업데이트하여 전체 화면 활동을 선언하고 메시지 알림 핸들러를 사용하도록 설정합니다.

    <activity  
    android:name="com.adobe.mobile.MessageFullScreenActivity"  
    android:theme="@android:style/Theme.Translucent.NoTitleBar" /> 
    <receiver android:name="com.adobe.mobile.MessageNotificationHandler" />
    

    양식 레이아웃을 선택한 경우 메시지에 대해 다음 테마 중 하나를 선택하십시오.

    • Theme.Translucent.NoTitleBar.Fullscreen
    • Theme.Translucent.NoTitleBar
    • Theme.Translucent

    예:

    <activity 
    android:name="com.adobe.mobile.MessageFullScreenActivity" 
    android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" 
    android:windowSoftInputMode="adjustUnspecified|stateHidden" /> 
    <receiver android:name="com.adobe.mobile.MessageNotificationHandler" />
    
  3. 라이브러리를 가져옵니다:

    import com.adobe.mobile.*;
    
  4. collectLifecycleData 호출에서 this를 전달하여 현재 활동에 대한 참조를 제공합니다.

    @Override 
    public void onResume() { 
        Config.collectLifecycleData(this); 
    }
    
  5. ADBMobileConfig.json 파일에 인앱 메시지에 대한 필수 설정이 포함되어 있는지 확인합니다.

    중요

    messages 또는 remotes는 필수입니다.

    시작 시 인앱 메시지를 동적으로 업데이트하려면 remotes 개체가 존재하고 올바르게 구성되어 있어야 합니다.

    “messages”: [ 
        { 
            “messageId”: “de45c43c-37bf-441f-8cbd-cc3ba3469ebe”, 
            “template”: “fullscreen”, 
            “showOffline”: false, 
            “showRule”: “always”, 
            “endDate”: 2524730400, 
            “startDate”: 0, 
            “audiences”: [], 
            “triggers”: [], 
            “payload”: { // contents change depending on template 
                “html”: “<html>html code goes here</html>” 
            }, 
        }, 
        … 
    ] 
    “remotes” : { 
        “analytics.poi”: “https://assets.adobedtm.com/…/yourfile.json”, 
        “messages”: “https://assets.adobedtm.com/…/yourfile.json” 
    }
    

    이 개체가 구성되어 있지 않으면 Adobe Mobile Services에서 업데이트된 ADBMobileConfig.json 파일을 다운로드하십시오. 자세한 내용은 시작하기 전에를 참조하십시오.

인앱 메시지 추적

Android Mobile SDK는 인앱 메시지에 대해 다음 지표를 추적합니다.

  • 전체 화면 및 경고 스타일의 인앱 메시지:

    • 노출 횟수: 사용자가 인앱 메시지를 트리거할 때입니다.
    • 클릭스루: 사용자가 클릭스루​를 누를 때입니다.
    • 취소: 사용자가 취소​를 누를 때입니다.
  • 사용자 지정 전체 화면 in-app 메시지의 경우 메시지에서 HTML 컨텐츠에 다음 단추에 대한 SDK 추적을 알리는 올바른 코드를 포함해야 합니다.

    • ****​클릭스루(리디렉션) 예 추적:

      adbinapp://confirm/?url=https://www.yoursite.com

    • 취소(닫기) 예 추적:

      adbinapp://cancel

로컬 대체 이미지

전체 화면 메시지를 만들 때 선택적으로 대체 이미지를 지정할 수 있습니다. 메시지에서 웹으로부터 의도한 이미지를 검색할 수 없는 경우 SDK는 애플리케이션의 자산 폴더에서 동일한 이름으로 이미지를 로드합니다. 따라서 사용자가 오프라인 상태이거나 미리 결정된 이미지에 연결할 수 없는 경우에도 메시지를 원래 양식으로 표시할 수 있습니다.

중요

대체 이미지 자산 이름은 Adobe Mobile Services에서 메시지를 구성할 때 지정됩니다. 지정된 리소스가 사용 가능한지 확인해야 합니다.

알림 아이콘 구성

다음 방법을 사용하면 알림 영역에 나타나는 크고 작은 아이콘과 알림 창에 알림이 표시될 때 나타나는 큰 아이콘을 구성할 수 있습니다.

  • Config.setSmallIconResourceId(int resourceId)

    SDK로 만든 알림에 사용할 작은 아이콘을 설정합니다. 이 아이콘은 상태 표시줄에 표시되며, 사용자가 알림 센터에서 전체 알림을 볼 때 표시되는 보조 이미지가 됩니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void setSmallIconResourceId(final int resourceId); 
      
    • 다음은 이 메서드의 코드 예입니다.

      Config.setSmallIconResourceId(R.drawable.appIcon);
      
  • Config.setLargeIconResourceId(int resourceId)

    SDK로 만든 알림에 사용할 큰 아이콘을 설정합니다. 이 아이콘이 사용자가 알림 센터에서 전체 알림을 볼 때 표시되는 기본 이미지입니다.

    • 다음은 이 메서드에 대한 구문입니다.

      public static void setLargeIconResourceId(final int resourceId); 
      
    • 다음은 이 메서드의 코드 샘플입니다.

      Config.setLargeIconResourceId(R.drawable.appIcon); 
      

이 페이지에서는