설명서CampaignCampaign Classic v7 설명서

Android용 구성 단계

Last update: Tue Sep 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 사용자
  • 개발자

패키지가 설치되면 Adobe Campaign Classic에서 Android 앱 설정을 정의할 수 있습니다.

주요 단계:

  1. Android 외부 계정 구성
  2. Android 서비스 구성
  3. Campaign에서 모바일 앱 만들기
  4. 추가 데이터로 앱 스키마 확장

그런 다음 Android 리치 알림을 만듭니다.

IMPORTANT
Android FCM(Firebase Cloud Messaging) 서비스에 대한 몇 가지 중요한 변경 사항은 2024년에 릴리스될 예정이며 Adobe Campaign 구현에 영향을 미칠 수 있습니다. 이 변경 사항을 지원하려면 Android 푸시 메시지에 대한 구독 서비스 구성을 업데이트해야 할 수 있습니다. 이미 확인하고 조치를 취할 수 있습니다. 이 Adobe Campaign v8 기술 정보에서 자세히 알아보세요.

Android 외부 계정 구성 configuring-external-account-android

Android의 경우 두 개의 커넥터를 사용할 수 있습니다.

  • MTA 하위 항목당 하나의 연결을 허용하는 V1 커넥터입니다.
  • 처리량을 개선하기 위해 FCM 서버에 동시에 연결할 수 있는 V2 커넥터입니다.

사용할 커넥터를 선택하려면 다음 단계를 수행하십시오.

  1. Administration > Platform > External accounts(으)로 이동합니다.

  2. Android routing 외부 계정을 선택하십시오.

  3. Connector 탭에서 JavaScript used in the connector 필드를 채웁니다.

    Android V2의 경우: https://localhost:8080/nms/jsp/androidPushConnectorV2.js

    note note
    NOTE
    https://localhost:8080/nms/jsp/androidPushConnector.js에 따라 구성할 수도 있지만 커넥터 버전 2를 사용하는 것이 좋습니다.

  4. Android V2의 경우 Adobe 서버 구성 파일(serverConf.xml)에서 한 개의 추가 매개 변수를 사용할 수 있습니다.

    • maxGCMConnectPerChild: 각 하위 서버에서 시작된 FCM에 대한 병렬 HTTP 요청의 최대 제한(기본적으로 8개).

Android 서비스 구성 configuring-android-service

비디오에서 Android 서비스를 구성하는 방법을 알아봅니다.

  1. Profiles and Targets > Services and subscriptions 노드로 이동하여 New ​을(를) 클릭합니다.

  2. Label 및 Internal name ​을(를) 정의합니다.

  3. Type 필드로 이동하여 Mobile application ​을(를) 선택합니다.

    note note
    NOTE
    기본 Subscriber applications (nms:appSubscriptionRcp) 대상 매핑이 받는 사람 테이블에 연결되어 있습니다. 다른 대상 매핑을 사용하려면 새 대상 매핑을 만들고 서비스의 Target mapping 필드에 입력해야 합니다. 대상 매핑 만들기에 대한 자세한 내용은 이 섹션을 참조하세요.

  4. 그런 다음 Add 단추를 클릭하여 응용 프로그램 유형을 선택합니다.

  5. Android 애플리케이션을 만듭니다. 이 작업에 대한 자세한 정보는 이 섹션을 참조하십시오.

Android 모바일 애플리케이션 만들기 creating-android-app

서비스를 만든 후 이제 Android 애플리케이션을 만들어야 합니다.

  1. 새로 만든 서비스에서 Add 단추를 클릭하여 응용 프로그램 유형을 선택합니다.

  2. Create an Android application ​을(를) 선택하고 Label ​을(를) 입력하십시오.

  3. SDK를 통해 Adobe Campaign 및 응용 프로그램 코드에 동일한 Integration key ​이(가) 정의되어 있는지 확인하십시오.

    note note
    NOTE
    Integration key ​은(는) 문자열 값으로 완전히 사용자 지정할 수 있지만 SDK에 지정된 값과 정확히 동일해야 합니다.

  4. API version: HTTP v1 또는 HTTP(레거시)를 선택하십시오. 이러한 구성은 이 섹션에 자세히 설명되어 있습니다.

  5. Firebase Cloud Messaging the Android connection settings 필드를 채웁니다.

  6. Finish ​을(를) 클릭한 다음 Save ​을(를) 클릭합니다. 이제 Android 애플리케이션을 Campaign Classic에서 사용할 준비가 되었습니다.

기본적으로 Adobe Campaign은 Subscriber applications (nms:appSubscriptionRcp) 테이블의 User identifier(@userKey) 필드에 키를 저장합니다. 이 키를 사용하면 구독을 수신자에게 연결할 수 있습니다. 추가 데이터(예: 복잡한 조정 키)를 수집하려면 다음 구성을 적용해야 합니다.

API 버전 구성 select-api-version

IMPORTANT
Android FCM(Firebase Cloud Messaging) 서비스에 대한 몇 가지 중요한 변경 사항은 2024년에 릴리스될 예정이며 Adobe Campaign 구현에 영향을 미칠 수 있습니다. 서비스 개선을 위한 Google의 지속적인 노력의 일환으로 레거시 FCM API는 2024년 6월 20일 ​에 중단됩니다. 이 Adobe Campaign v8 기술 정보에서 자세히 알아보세요.

서비스 및 새 모바일 애플리케이션을 만든 후에는 모바일 애플리케이션을 구성해야 합니다. HTTP(기존) API는 Google에서 더 이상 사용되지 않으므로 선택하면 안 됩니다.

HTTP v1 API 버전을 구성하려면 아래 단계를 수행합니다.

  1. Mobile application creation wizard 창의 API version 드롭다운에서 HTTPV1 ​을(를) 선택합니다.

  2. JSON 키 파일을 직접 로드하려면 Load project json file to extract project details… ​을(를) 클릭하십시오. JSON 파일을 추출하는 방법에 대한 자세한 내용은 이 페이지를 참조하세요.

    다음 세부 정보를 수동으로 입력할 수도 있습니다.

    • Project Id
    • Private Key
    • Client Email

  3. 구성이 올바르고 마케팅 서버가 FCM에 액세스할 수 있는지 확인하려면 Test the connection ​을(를) 클릭하십시오.

    note caution
    CAUTION
    중간 소싱 배포의 경우 Test connection 단추는 MID 서버에서 FCM 서버에 액세스할 수 있는지 여부를 확인하지 않습니다.

  4. 필요한 경우 Application variables ​을(를) 사용하여 푸시 메시지 콘텐츠를 보강할 수 있습니다. 이는 완전히 맞춤화가 가능하며 모바일 디바이스로 전송되는 메시지 페이로드의 일부입니다.

  5. Finish ​을(를) 클릭한 다음 Save ​을(를) 클릭합니다. 이제 Android 애플리케이션을 Campaign Classic에서 사용할 준비가 되었습니다.

다음은 푸시 알림을 추가로 개인화할 FCM 페이로드 이름입니다.

메시지 유형
구성 가능한 메시지 요소(FCM 페이로드 이름)
구성 가능한 옵션(FCM 페이로드 이름)
데이터 메시지
N/A
validate_only
알림 메시지
제목, 본문, android_channel_id, 아이콘, 사운드, 태그, 색상, click_action, 이미지, 티커, 고정, 가시성, notification_priority, notification_count
validate_only

appsubscriptionRcp 스키마 확장 extend-subscription-schema

비디오에서 appsubscriptionRcp 스키마를 확장하는 방법을 알아봅니다

앱의 매개 변수를 Campaign 데이터베이스에 저장하려면 appsubscriptionRcp ​을(를) 확장하여 새 추가 필드를 정의해야 합니다. 이러한 필드는 예를 들어 개인화에 사용됩니다. 방법은 다음과 같습니다.

  1. Subscriber applications (nms:appsubscriptionRcp) 스키마의 확장을 만들고 새 필드를 정의합니다. 이 페이지에서 스키마 확장에 대해 자세히 알아보기

  2. Subscription parameters 탭에서 매핑을 정의합니다.

    note caution
    CAUTION
    Subscription parameters 탭의 구성 이름이 모바일 애플리케이션 코드의 구성 이름과 같은지 확인하십시오.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1