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에서 사용하는 확장과 관련된 기능 변경 사항 및 수정 사항에 대해 설명합니다.

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 관리자에 로그인하여 다음을 완료해야 합니다.

Commerce에서 Real-Time CDP 대상을 사용하는 위치

Audience Activation 확장을 사용하면 다음 작업을 수행할 수 있습니다.

Real-Time CDP 대상 대시보드

Real-Time CDP 대상 대시보드를 사용하여 Adobe Commerce 인스턴스 내에서 개인화할 수 있는 모든 활성 대상을 볼 수 있습니다.

Real-Time CDP 대상 대시보드에 액세스하려면 관리자 사이드바로 이동한 다음 Customers > Real-time CDP Audience(으)로 이동하십시오.

대시보드에는 다음 필드가 포함되어 있습니다.

헤드리스 지원

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>&nbsp;</p>"
          }
        },
        {
          "uid": "Mg==",
          "audience_id": [
            "cd29a789-9be8-40ad-a1ef-640c33b3742e",
            "92c3e14d-c72b-40d0-96b7-b96801dcc135"
          ],
          "content": {
            "html": "<p><img src=\"{{media url=&quot;wysiwyg/save20.png&quot;}}\" 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 대상을 검색할 수 있습니다.

구성을 완료한 후 모바일 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          |

구성에서 잘못된 인증 유형 선택됨

생성된 토큰에 대한 권한이 충분하지 않음

이 문제는 생성된 토큰에 대한 API 권한이 충분하지 않기 때문에 발생할 수 있습니다. 토큰에 올바른 권한이 있는지 확인하려면 다음을 수행하십시오.