Magento 연동

연동 개요

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

연동 유형

Destination: 이 연동은 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 관리자 패널에 로그인합니다.
스토어 > 구성 > Pushwoosh > 구성으로 이동합니다.

Magento 관리자 패널의 Pushwoosh 구성

일반 설정

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

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

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

주문 동기화 구성

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

다음 필드를 입력합니다:


주문 동기화 활성화	자동 주문 동기화를 활성화하려면 예로 설정합니다. 활성화하면 정의된 cron 일정에 따라 프로세스가 진행됩니다. 자동 동기화를 비활성화하려면 아니요로 설정합니다.
Cron 설정	주문 동기화가 활성화된 경우에만 사용할 수 있습니다. `분`, `시`, `일`, `월`, `요일` 필드를 사용하여 cron 작업이 실행되어야 하는 시점을 정의합니다. Cron은 지정된 간격으로 작업을 자동으로 실행하는 데 사용되는 시간 기반 스케줄러입니다.
주문 동기화 수	각 동기화 실행 중에 처리할 주문 수를 지정합니다.
실시간 주문 동기화	주문이 접수되는 즉시 동기화하려면 예로 설정합니다.

주문 동기화 구성 설정

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

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

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

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

다음 필드를 입력합니다:


버려진 장바구니 동기화	버려진 장바구니 데이터의 자동 동기화를 활성화하려면 예로 설정합니다. 활성화하면 정의된 cron 일정에 따라 동기화가 실행됩니다.
Cron 일정 구성	`분`, `시`, `일`, `월`, `요일` 필드를 사용하여 동기화가 실행되어야 하는 시점을 정의합니다. Cron은 지정된 간격으로 작업을 자동으로 실행하는 시간 기반 작업 스케줄러입니다.
버려진 장바구니 수	각 동기화 실행 중에 처리할 버려진 장바구니 수를 지정합니다.
최소 비활성 시간	장바구니가 버려진 것으로 간주되기 위한 최소 비활성 시간(분)을 설정합니다. 예를 들어, `60`은 최소 60분 동안 비활성 상태인 장바구니가 동기화 대상이 됨을 의미합니다.

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

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

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

고객 동기화 구성

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

다음 필드를 입력합니다:


고객 동기화	기존 및 신규 고객 기록의 동기화를 활성화하려면 예로 설정합니다. 동기화는 정의된 cron 일정에 따라 지정된 속성 매핑을 사용합니다.
Cron 일정 구성	`분`, `시`, `일`, `월`, `요일` 필드를 사용하여 동기화가 실행되어야 하는 시점을 정의합니다. Cron은 지정된 간격으로 작업을 자동으로 실행하는 시간 기반 작업 스케줄러입니다.
고객 사용자 정의 필드 매핑	정확한 데이터 전송을 위해 Magento 고객 속성을 Pushwoosh 사용자 정의 필드에 매핑합니다. 예: `생년월일 → Birthday`, `이름 → firstName`
고객 수	cron 실행당 동기화할 최대 고객 수를 설정합니다.

고객 동기화 구성 설정

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

총 고객 수: 동기화를 위해 식별된 총 고객 기록 수입니다.
동기화된 고객 수: Pushwoosh와 성공적으로 동기화된 고객 수입니다.
동기화되지 않은 고객 수: 동기화 대기 중인 고객입니다.
동기화 실패한 고객 수: 오류로 인해 동기화에 실패한 고객입니다.

웹 알림 구성

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

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

Magento의 웹 알림 구성

구성 저장

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

Magento 관리자 패널의 구성 저장 버튼

수동 동기화 옵션

선택한 고객을 Pushwoosh로 동기화

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

Magento 관리자 패널에서 고객 > 모든 고객으로 이동합니다.
동기화하려는 고객을 찾아 선택합니다.
고객 목록 위의 작업 드롭다운에서 Pushwoosh로 동기화를 선택합니다.

고객에 대한 Pushwoosh로 동기화 작업

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

선택한 주문을 Pushwoosh로 동기화

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

Magento 관리자 패널에서 판매 > 주문으로 이동합니다.
목록에서 하나 이상의 주문을 선택합니다.
작업 드롭다운에서 Pushwoosh로 동기화를 선택합니다.

주문에 대한 Pushwoosh로 동기화 작업

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

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

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

Magento 관리자 패널에서 버려진 장바구니 섹션으로 이동합니다.
동기화하려는 장바구니를 선택합니다.
작업 드롭다운에서 Pushwoosh로 동기화를 선택합니다.

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

버려진 장바구니에 대한 Pushwoosh로 동기화 작업

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

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

버려진 장바구니 날짜 → PW_AbandonedCartDate
버려진 장바구니 ID → PW_AbandonedCartID

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

연동 작동 확인

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

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

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