Audience Activation
Audience Activation 확장을 사용하면 Adobe Commerce에서 Real-Time CDP 대상을 활성화하여 장바구니에서 고유한 오퍼를 만들 수 있습니다. 이러한 오퍼 및 인센티브에는 2개 구매 무료 와 같은 일반적인 전자 상거래 머천다이징 기술, 해당 고객에 맞게 구성된 영웅 배너 및 다양한 오퍼를 통한 수정된 제품 가격이 포함됩니다. Real-Time CDP에 구축된 대상은 ERP(전사적 자원 관리), CRM(고객 관계 관리), POS(판매 지점), 마케팅 시스템과 같은 다양한 엔터프라이즈 시스템의 데이터를 기반으로 합니다. 고객 세그먼트 정보는 지속적으로 새로 고쳐지기 때문에 고객은 스토어에서 쇼핑할 때 세그먼트와 연결 및 연결 해제될 수 있습니다.
Luma 상점 첫 화면 또는 headless 상점 첫 화면에서 대상을 활성화할 수 있습니다. Luma 상점 첫 화면에서 대상 정보(세그먼트 멤버십)는 Commerce 측의 쿠키에 저장됩니다. Headless 상점 앞에서는 대상 정보가 GraphQL API 헤더에 aep-segments-membership
매개 변수로 전달됩니다.
릴리스 정보
이 섹션에는 Audience Activation 확장 업데이트에 대한 정보가 포함되어 있으며 다음 내용이 포함됩니다.
- 새로운 기능
- 수정 사항 및 개선 사항
- 알려진 문제
릴리스 일정 및 지원에 대한 자세한 내용은 예정된 릴리스를 참조하세요.
개발자 설명서를 참조하여 제품 호환성에 대해 알아보세요.
지원되는 서비스 업데이트
이러한 릴리스 노트는 Audience Activation에서 사용하는 확장과 관련된 기능 변경 사항 및 수정 사항에 대해 설명합니다.
2023년 8월 15일
- 필터링을 간소화하기 위해 Real-Time CDP 대상 대시보드를 업데이트했습니다.
2023년 6월 27일
- magento/module-data-services-graphql
패키지에서 PHP 8.2에 대한 지원을 추가했습니다.
2023년 5월 30일
- Adobe Commerce 인스턴스 내에서 활성 대상을 정렬, 검색 및 필터링하는 기능을 포함하도록 Real-Time CDP 대상 대시보드를 업데이트했습니다.
2.3.0
[호환성]{class="badge informative" title="호환성"}
2024년 7월 29일
- 명령줄 구문을 추가했으므로 자격 증명을 테스트하여 Adobe Experience Platform에서 대상 데이터를 가져오기 위해 자격 증명을 업데이트해야 하는지 확인할 수 있습니다.
2.2.0
[호환성]{class="badge informative" title="호환성"}
2024년 6월 12일
- 대상자가 제공한 관련 제품 규칙에 대한 GA 릴리스
2.1.1
[호환성]{class="badge informative" title="호환성"}
2024년 4월 4일
- PHP 8.3에 대한 지원을 추가했습니다.
2.2.0-Beta1
[호환성]{class="badge informative" title="호환성"}
2024년 2월 16일
- Beta에 참여하는 경우 composer.json
파일의 루트 수준이 "minimum-stability": "beta"
인지 확인하세요.
- (Beta) 대상자가 제공한 관련 제품 규칙을(를) 만드는 기능이 추가되었습니다.
2.1.0
[호환성]{class="badge informative" title="호환성"}
2024년 1월 24일
- 대상이 포함된 웹 사이트를 포함하고 해당 대상을 사용하도록 구성된 동적 블록 및 장바구니 가격 규칙을 지정하도록 Real-Time CDP 대상 대시보드를 업데이트했습니다.
2.0.1
[호환성]{class="badge informative" title="호환성"}
2023년 11월 16일
- 안정성이 개선되었습니다.
2.0.0
[호환성]{class="badge informative" title="호환성"}
2023년 10월 10일
- Audience Activation 확장을 구성할 때 OAuth 2.0에 대한 지원이 추가되었습니다.
- 안정성이 개선되었습니다.
1.2.0
[호환성]{class="badge informative" title="호환성"}
2023년 8월 15일
- UI 구성 요소 버전을 업데이트했습니다.
1.1.0
2023년 5월 30일
[호환성]{class="badge informative" title="호환성"}
- Headless 상점 첫 화면에서 동적 블록에 대한 지원이 추가되었습니다.
1.0.1
2023년 5월 11일
[호환성]{class="badge informative" title="호환성"}
- 동적 블록 또는 장바구니 가격 규칙이 상점 앞에 적용되지 않는 문제를 해결했습니다.
- 판매자가 동적 블록을 만들거나 업데이트하려고 할 때 Audience Activation 확장의 구성되지 않은 설치로 인해 오류가 발생하는 문제를 해결했습니다.
1.0.0
2023년 3월 31일
[호환성]{class="badge informative" title="호환성"}
- 일반 가용성 릴리스
구현
다음 작업은 Luma 및 헤드리스 상점 구현 모두에 적용됩니다. Adobe Commerce에서 대상을 활성화하려면 다음을 수행해야 합니다.
확장 설치
marketplace에서 Audience Activation 확장을 설치하거나 다음 명령을 실행하십시오.
composer require magento/audiences
확장 구성
Audience Activation 확장을 설치한 후 Commerce 관리자에 로그인하여 다음을 완료해야 합니다.
-
관리자 사이드바에서 System > Services>Commerce Services Connector(으)로 이동합니다.
-
Adobe 계정에 로그인하고 조직 ID를 선택하세요.
-
관리자 사이드바에서 System > Services>Data Connection(으)로 이동합니다.
-
Datastream ID 필드에 Adobe Commerce을 Real-Time CDP의 대상으로 활성화할 때 만든 데이터 스트림의 ID를 붙여넣습니다.
이 데이터 스트림은 Commerce 웹 사이트의 데이터를 Real-Time CDP으로 전송하여 쇼핑객이 대상자에 속하는지 확인합니다. 데이터 스트림을 아직 만들지 않은 경우 Experience Platform에서 만들기하고, Real-Time CDP의 Commerce 대상과 관리자의 Data Connection 확장에 추가합니다.
note note NOTE 데이터 스트림 ID를 지정할 때 Data Connection 확장에서 특정 웹 사이트에 연결합니다. Commerce 스토어에 여러 개의 웹 사이트가 있는 경우 Real-Time CDP의 각 웹 사이트에 대해 대상을 만들고 각각에 대해 다른 데이터 스트림 ID를 사용하십시오. -
관리자 사이드바에서 Stores > Settings>Configuration(으)로 이동합니다.
-
Services 을(를) 확장하고 Data Connection 을(를) 선택합니다.
Commerce에서 Real-Time CDP 대상을 사용하는 위치
Audience Activation 확장을 사용하면 다음 작업을 수행할 수 있습니다.
- 대상자가 제공한 장바구니 가격 규칙 만들기
- 대상자가 제공한 동적 블록 만들기
- 대상자가 제공한 관련 제품 규칙 만들기
Real-Time CDP 대상 대시보드
Real-Time CDP 대상 대시보드를 사용하여 Adobe Commerce 인스턴스 내에서 개인화할 수 있는 모든 활성 대상을 볼 수 있습니다.
Real-Time CDP 대상 대시보드에 액세스하려면 관리자 사이드바로 이동한 다음 Customers > Real-time CDP Audience(으)로 이동하십시오.
대시보드에는 다음 필드가 포함되어 있습니다.
Hide filters
Last updated
뿐입니다. 이 필터를 사용하면 대상이 마지막으로 업데이트된 시간을 기준으로 대상의 날짜 범위를 선택할 수 있습니다.Search
Name
Origin
Experience Platform
)를 나타냅니다.Websites
Dynamic Blocks
Cart Price Rules
Related Product Rules
Last updated
Sync now
Customize table
Origin
, Websites
, Dynamic Blocks
, Cart Price Rules
및 Last updated
열을 표시하거나 숨길 수 있습니다.헤드리스 지원
AEM 및 PWA과 같은 Headless Adobe Commerce 인스턴스에서 대상을 활성화하여 장바구니 가격 규칙, 관련 제품 규칙 또는 대상을 기반으로 하는 동적 블록을 표시할 수 있습니다.
장바구니 가격 규칙 및 관련 제품 규칙
장바구니 가격 규칙 및 관련 제품 규칙의 경우, Headless 상점 첫 화면은 Commerce integration framework(CIF)을 통해 Experience Platform과 통신합니다. 프레임워크는 GraphQL을 사용하여 구현된 서버측 API를 제공합니다. 쇼핑객 세그먼트와 같은 대상 정보는 이름이 aep-segments-membership
인 GraphQL 헤더 매개 변수를 통해 Commerce으로 전달됩니다.
전반적인 아키텍처는 다음과 같습니다.
확장을 설치하고 구성하면 Experience Platform Web SDK에 세그먼트 멤버십 형식으로 대상 정보가 포함됩니다.
SDK에서 이러한 세그먼트 멤버십을 캡처하려면 이 코드 조각을 참조하십시오.
검색되면 해당 세그먼트를 GraphQL 헤더 내에서 Commerce에 전달할 수 있습니다. For example:
curl 'http://magento.config/graphql' -H 'Authorization: Bearer abc123' -H 'aep-segments-membership: urlencoded_list_of_segments' -H 'Content-Type: application/json' --data-binary '{"query":"query {\ncustomer {\nfirstname\nlastname\nemail\n}\n}"}'
동적 블록
동적 블록의 경우 GraphQL dynamicBlocks
쿼리에 audience_id
입력 특성이 포함될 수 있습니다. dynamicBlocks
쿼리에 하나 이상의 audience_id
값을 지정하면 해당 대상에 할당된 동적 블록의 목록이 반환됩니다.
사용 예
다음 쿼리는 여러 대상 ID와 연결된 모든 동적 블록을 반환합니다.
요청:
{
dynamicBlocks(input:
{
type: SPECIFIED
audience_id: {
in: [
"cd29a789-9be8-40ad-a1ef-640c33b3742e"
"92c3e14d-c72b-40d0-96b7-b96801dcc135"
]
}
})
{
items {
uid
audience_id
content {
html
}
}
page_info {
current_page
page_size
total_pages
}
total_count
}
}
응답:
{
"data": {
"dynamicBlocks": {
"items": [
{
"uid": "MQ==",
"audience_id": [
"cd29a789-9be8-40ad-a1ef-640c33b3742e"
],
"content": {
"html": "<h2><strong>SAVE 20%</strong></h2>\r\n<p>(some restrictions apply)</p>\r\n<p> </p>"
}
},
{
"uid": "Mg==",
"audience_id": [
"cd29a789-9be8-40ad-a1ef-640c33b3742e",
"92c3e14d-c72b-40d0-96b7-b96801dcc135"
],
"content": {
"html": "<p><img src=\"{{media url="wysiwyg/save20.png"}}\" alt=\"save 20% red\"></p>"
}
}
],
"page_info": {
"current_page": 1,
"page_size": 20,
"total_pages": 1
},
"total_count": 2
}
}
}
개발자 설명서에서 dynamicBlocks
GraphQL 쿼리에 대해 자세히 알아보세요.
Adobe Experience Platform Mobile SDK를 사용하여 대상자 검색
Adobe Experience Platform Mobile SDK를 사용하여 Real-Time CDP 대상을 검색할 수 있습니다.
- Audience Activation 확장을 설치합니다.
- 모바일 Commerce 사이트에 SDK를 설치하고 구성합니다.
구성을 완료한 후 모바일 SDK 작업을 사용하여 대상 데이터를 검색합니다. For example:
Edge.sendEvent(experienceEvent: experienceEvent) { (handles: [EdgeEventHandle]) in
for handle in handles {
if handle.type == "activation:pull" {
let payloadItems = handle.payload ?? []
for payloadItem in payloadItems {
if let segments = payloadItem["segments"] as? any Sequence {
var segmentsArr = [Any]()
for segment in segments {
let response = segment as AnyObject?
segmentsArr.append(response?.object(forKey: "id")! ?? "")
}
print("Saving segments -> \(segments)")
storage.set(segmentsArr, forKey: "segments")
print("End saving segments")
}
// Show segments
let rSegments = storage.object(forKey: "segments") ?? nil;
print("Retrieving segments -> \(rSegments)")
}
}
}
}
데이터를 검색한 후 이를 사용하여 Commerce 앱에서 대상자에게 제공되는 장바구니 가격 규칙, 동적 블록 및 관련 제품 규칙을 만들 수 있습니다.
대상이 Commerce에 표시되지 않음
Real-Time CDP 대상이 Commerce에 표시되지 않는 이유는 다음과 같습니다.
- 잘못된 연결
- 데이터 연결 구성 페이지에서 잘못된 인증 유형을 선택했습니다.
- 생성된 토큰에 대한 권한이 충분하지 않음
다음 섹션에서는 이러한 문제를 해결하는 방법을 설명합니다.
연결 유효성 검사
자격 증명과 Adobe Experience Platform의 응답을 확인하려면 다음 명령을 실행합니다.
bin/magento audiences:config:status
이 명령은 연결 상태를 반환합니다. 자세한 정보를 제공하려면 -v
플래그를 추가하십시오.
./bin/magento audiences:config:status -v
For example:
+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| Client ID | Client secret | Technical account ID | Technical account email | Sandbox name |
+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| 1234bd57fac8497d8933327c535347d8 | ***** | 12341E116638D6B00A495C80@techacct.adobe.com | 12345-b95b-4894-a41c-a4130d26bd80@techacct.adobe.com | dev |
구성에서 잘못된 인증 유형 선택됨
- Commerce 인스턴스를 엽니다.
- 관리자 사이드바에서 Stores > Settings>Configuration(으)로 이동합니다.
- Services 을(를) 확장하고 Data Connection 을(를) 선택합니다.
- Authentication Type 필드에 지정한 서버 간 인증 방법이 올바른지 확인하십시오. Adobe은 OAuth 사용을 권장합니다. JWT는 더 이상 사용되지 않습니다. 자세히 알아보기.
생성된 토큰에 대한 권한이 충분하지 않음
이 문제는 생성된 토큰에 대한 API 권한이 충분하지 않기 때문에 발생할 수 있습니다. 토큰에 올바른 권한이 있는지 확인하려면 다음을 수행하십시오.
- 조직의 Adobe Experience Platform 시스템 관리자를 식별합니다.
- 사용할 프로젝트 및 자격 증명을 찾습니다.
- 기술 계정 전자 메일을 식별합니다(예:
fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com
). - 시스템 관리자가 Adobe Experience Platform을 시작하고 Permissions -> Users -> API credentials(으)로 이동합니다.
- 위의 기술 계정 이메일을 사용하여 수정할 자격 증명을 검색합니다.
- 자격 증명을 연 다음 Roles -> Add roles 을(를) 선택합니다.
- Manage destinations 권한이 포함된 역할을 추가하십시오.
- Save 을(를) 클릭합니다.
- 콘솔에서 액세스 토큰을 다시 생성합니다.
- 토큰이 Target 연결 API를 사용하여 올바른 응답을 제공하는지 확인하십시오.