Magento 통합

통합 개요

Magento는 기업이 제품, 고객, 주문을 대규모로 관리할 수 있도록 돕는 선도적인 전자상거래 플랫폼입니다. Magento 와 Pushwoosh 를 통합하면 고객, 주문, 버려진 장바구니를 자동으로 동기화하여 실시간 메시징, 타겟 세분화, 교차 채널 마케팅 자동화를 활성화할 수 있습니다. 이를 통해 스토어 활동에서 직접 사용자의 참여를 유도하고 전환율을 높일 수 있습니다.

통합 유형

대상: 이 통합은 Magento 스토어의 데이터를 Pushwoosh 로 푸시합니다.

전제 조건

진행하기 전에 다음 사항을 확인하세요:

Magento 관리자 패널에 대한 접근 권한
유효한 Pushwoosh 계정
Pushwoosh API 접근 토큰 및 앱 코드
Magento 서버에 Composer 설치
시스템 요구 사항 충족:
- PHP 7.4 / 8.x
- Magento 2.3 / 2.4
- Elasticsearch 7
- RabbitMQ

용어집

엔티티 이름이 다른 경우 매핑:

Magento	Pushwoosh
고객	사용자

동기화된 엔티티 목록:

고객
주문
버려진 장바구니

사용 사례

주문 생성 및 장바구니 포기 이벤트에 기반한 푸시 알림 전송.
속성(예: 위치, 생일)에 따라 고객을 세분화하고 타겟 캠페인 전송.
브라우저 기반 프로모션 알림 전송.

통합 설정

설치

Magento 프로젝트의 루트에서 다음 Composer 명령을 실행하세요:

composer require pushwoosh/magento2-integration

패키지가 설치되면 Magento 설정을 실행하여 모듈을 설치하세요:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

설치 후 구성

설치를 완료한 후:

Magento 관리자 패널에 로그인합니다.
Stores > Configuration > Pushwoosh > Configuration으로 이동합니다.

Magento 관리자 패널의 Pushwoosh 구성

일반 설정

General 섹션에서 다음 필드를 구성합니다:

Status: 통합을 활성화하려면 이 값을 Enable로 설정합니다.
API URL: Pushwoosh API 엔드포인트를 입력합니다: https://api.pushwoosh.com/
API Key: 요청을 인증하는 데 필요한 Pushwoosh API 키를 붙여넣습니다. Pushwoosh API 접근 키에 대해 자세히 알아보기
App Code: 모바일 또는 웹 애플리케이션에 해당하는 Pushwoosh 앱 코드를 입력합니다.

아래는 고객, 주문, 버려진 장바구니 동기화를 위한 구성 옵션입니다.

주문 동기화 구성

Magento 스토어와 Pushwoosh 간에 주문 데이터가 동기화되는 방식을 정의합니다.

다음 필드를 채웁니다:


Order Sync Enable	자동 주문 동기화를 활성화하려면 Yes로 설정합니다. 활성화되면 정의된 cron 일정에 따라 프로세스가 진행됩니다. 자동 동기화를 비활성화하려면 No로 설정합니다.
Cron Settings	주문 동기화가 활성화된 경우에만 사용할 수 있습니다. 다음 필드를 사용하여 cron 작업이 실행되어야 하는 시점을 정의합니다: `Minute`, `Hour`, `Day`, `Month`, `Weekday`. Cron은 지정된 간격으로 작업을 자동으로 실행하는 데 사용되는 시간 기반 스케줄러입니다.
Order Sync Numbers	각 동기화 실행 중에 처리할 주문 수를 지정합니다.
Order Sync in Real Time	주문이 접수되는 즉시 동기화하려면 Yes로 설정합니다.

주문 동기화 구성 설정

여기에서 주문 동기화 상태도 볼 수 있습니다:

Total Orders: 동기화를 위해 평가된 총 주문 수를 표시합니다.
Synced Orders: Pushwoosh 와 성공적으로 동기화된 주문 수.
Not Synced Orders: 아직 동기화되지 않은 주문.
Fail Synced Orders: 동기화 시도가 실패한 주문.

버려진 장바구니 동기화 구성

Magento 스토어와 Pushwoosh 간에 버려진 장바구니 데이터의 동기화를 구성합니다.

다음 필드를 채웁니다:


Abandoned Cart Syncing	버려진 장바구니 데이터의 자동 동기화를 활성화하려면 Yes로 설정합니다. 활성화되면 정의된 cron 일정에 따라 동기화가 실행됩니다.
Cron Schedule Configuration	다음 필드를 사용하여 동기화가 실행되어야 하는 시점을 정의합니다: `Minute`, `Hour`, `Day`, `Month`, `Weekday`. Cron은 지정된 간격으로 작업을 자동으로 실행하는 시간 기반 작업 스케줄러입니다.
Number of Abandoned Cart	각 동기화 실행 중에 처리될 버려진 장바구니 수를 지정합니다.
Minimum Inactivity Time	장바구니가 버려진 것으로 간주되기 위한 최소 비활성 시간(분)을 설정합니다. 예를 들어, `60`은 60분 이상 비활성 상태인 장바구니가 동기화 대상이 됨을 의미합니다.

버려진 장바구니 동기화 구성 설정

여기에서 동기화 활동에 대한 실시간 메트릭도 볼 수 있습니다:

Total Abandoned Carts: 버려진 것으로 식별된 총 장바구니 수.
Synced Abandoned Carts: Pushwoosh 와 성공적으로 동기화된 장바구니 수.
Not Synced Abandoned Carts: 아직 동기화되지 않은 장바구니 수.
Fail Synced Abandoned Carts: 동기화에 실패한 장바구니 수.

고객 동기화 구성

Magento 스토어에서 Pushwoosh 로 고객 데이터를 동기화하여 고객 속성에 기반한 잠재고객 세분화 및 개인화된 메시징을 활성화하도록 구성합니다.

다음 필드를 채웁니다:


Customer Syncing	기존 및 신규 고객 기록의 동기화를 활성화하려면 Yes로 설정합니다. 동기화는 정의된 cron 일정을 따르고 지정된 속성 매핑을 사용합니다.
Cron Schedule Configuration	다음 필드를 사용하여 동기화가 실행되어야 하는 시점을 정의합니다: `Minute`, `Hour`, `Day`, `Month`, `Weekday`. Cron은 지정된 간격으로 작업을 자동으로 실행하는 시간 기반 작업 스케줄러입니다.
Mapping Customer Custom Fields	정확한 데이터 전송을 위해 Magento 고객 속성을 Pushwoosh 사용자 정의 필드에 매핑합니다. 예: `Date of Birth → Birthday`, `First Name → firstName`
Number of Customers	cron 실행당 동기화할 최대 고객 수를 설정합니다.

고객 동기화 구성 설정

여기에서 동기화 통계도 볼 수 있습니다:

Total Customer: 동기화를 위해 식별된 총 고객 기록 수.
Synced Customer: Pushwoosh 와 성공적으로 동기화된 고객 수.
Not Synced Customer: 동기화 대기 중인 고객.
Fail Synced Customer: 오류로 인해 동기화에 실패한 고객.

웹 알림 구성

스토어 방문자를 위한 웹 푸시 알림을 활성화하려면 Yes로 설정합니다. 이 기능을 비활성화하려면 No로 설정합니다.

활성화되면 Magento 스토어는 브라우저를 통해 사용자에게 실시간 메시지를 보낼 수 있습니다. 알림은 프로모션 제안, 주문 상태 업데이트, 버려진 장바구니 알림 및 기타 마케팅 커뮤니케이션에 사용될 수 있습니다.

Magento의 웹 알림 구성

구성 저장

필요한 모든 필드를 완료한 후 오른쪽 상단에 있는 Save Config 버튼을 클릭합니다. 변경 사항을 적용하라는 메시지가 표시되면 Magento 캐시를 지웁니다.

Magento 관리자 패널의 Save Config 버튼

수동 동기화 옵션

선택한 고객을 Pushwoosh 로 동기화

모든 고객을 자동으로 동기화하지 않으려면 개별 또는 선택한 고객을 수동으로 동기화할 수 있습니다.

Magento 관리자 패널에서 Customers > All Customers로 이동합니다.
동기화하려는 고객을 찾아 선택합니다.
고객 목록 위의 Actions 드롭다운에서 Sync to Pushwoosh를 선택합니다.

고객에 대한 Sync to Pushwoosh 작업

동기화가 완료되면 고객 데이터가 Pushwoosh 계정의 User Explorer 섹션에 나타나며 Magento 에서 전송된 모든 관련 정보가 표시됩니다.

선택한 주문을 Pushwoosh 로 동기화

모든 주문을 자동으로 동기화하지 않으려면 특정 주문을 수동으로 동기화할 수 있습니다. 이를 위해:

Magento 관리자 패널에서 Sales > Orders로 이동합니다.
목록에서 하나 이상의 주문을 선택합니다.
Actions 드롭다운에서 Sync to Pushwoosh를 선택합니다.

주문에 대한 Sync to Pushwoosh 작업

동기화 후 주문은 Pushwoosh User Explorer의 사용자 프로필의 Events 섹션에 PW_OrderCreated 또는 PW_OrderUpdated 이벤트(주문 상태가 변경된 경우)로 나타나며 자세한 주문 정보가 포함됩니다.

선택한 버려진 장바구니 동기화

선택한 버려진 장바구니를 수동으로 동기화하려면:

Magento 관리자 패널에서 Abandoned Carts 섹션으로 이동합니다.
동기화하려는 장바구니를 선택합니다.
Actions 드롭다운에서 Sync to Pushwoosh를 선택합니다.

참고: 장바구니가 버려진 것으로 간주되는 시점을 결정하려면 Abandoned Cart Sync 설정에서 필요한 비활성 기간을 구성했는지 확인하세요.

버려진 장바구니에 대한 Sync to Pushwoosh 작업

동기화 후 버려진 장바구니 데이터는 Pushwoosh User Explorer의 사용자 프로필의 Events 섹션에 자세한 정보와 함께 PW_AbandonedCart 이벤트로 나타납니다.

또한 사용자 프로필에 두 개의 태그가 설정됩니다:

Abandoned Cart Date → PW_AbandonedCartDate
Abandoned Cart ID → PW_AbandonedCartID

이 태그는 이메일 템플릿에서 연결된 콘텐츠를 사용하여 버려진 장바구니 알림을 보내는 데 사용할 수 있습니다. 자세히 알아보기

통합이 작동하는지 확인

통합이 올바르게 작동하는지 확인하려면:

Magento 에서 테스트 고객을 생성합니다.
고객을 Pushwoosh 로 수동 동기화합니다.
Pushwoosh 대시보드에서 User Explorer를 열고 고객을 찾습니다.

고객이 User Explorer에 나타나면 동기화가 성공했음을 나타냅니다.