Audience Activation

다음 Audience Activation 확장을 사용하면 Adobe Commerce에서 Real-Time CDP 대상을 활성화하여 장바구니에서 고유한 오퍼를 만들 수 있습니다. 이러한 오퍼와 인센티브에는 다음과 같은 일반적인 전자 상거래 머천다이징 기술이 포함됩니다. 2개 구입 1개 무료, 영웅 배너는 해당 고객에 맞게 조정되었으며 다양한 오퍼를 통해 제품 가격을 수정했습니다. Real-Time CDP에 구축된 대상은 ERP(전사적 자원 관리), CRM(고객 관계 관리), POS(판매 지점), 마케팅 시스템과 같은 다양한 엔터프라이즈 시스템의 데이터를 기반으로 합니다. 고객 세그먼트 정보는 지속적으로 새로 고쳐지기 때문에 고객은 스토어에서 쇼핑할 때 세그먼트와 연결 및 연결 해제될 수 있습니다.

Luma 상점 첫 화면에서 대상자를 활성화하거나 headless 가게 앞이야 Luma 상점 첫 화면에서 대상 정보(세그먼트 멤버십)는 Commerce 측의 쿠키에 저장됩니다. 헤드리스 상점 첫 화면에서 대상 정보는 GraphQL API 헤더에 이라는 매개 변수로 전달됩니다. aep-segments-membership.

릴리스 정보

이 섹션에는 Audience Activation 확장 업데이트에 대한 정보가 포함되어 있으며 다음 내용이 포함됩니다.

신규 - 새로운 기능
수정 - 수정 사항 및 향상된 기능
버그 - 알려진 문제

다음을 참조하십시오 예정된 릴리스 릴리스 일정 및 지원에 대해 알아봅니다.

개발자 설명서 를 참조하여 다음을 수행합니다 제품 호환성에 대해 알아보기.

지원되는 서비스 업데이트

이러한 릴리스 노트는 Audience Activation에서 사용하는 확장과 관련된 기능 변경 사항 및 수정 사항에 대해 설명합니다.

지원되는 서비스 업데이트

2023년 8월 15일

수정 - 을(를) 업데이트함 Real-Time CDP 대상 대시보드 필터링을 단순화합니다.

2023년 6월 27일

수정 - 의 PHP 8.2에 대한 지원을 추가했습니다. magento/module-data-services-graphql 패키지.

2023년 5월 30일

신규 - 을(를) 업데이트함 Real-Time CDP 대상 대시보드 Adobe Commerce 인스턴스 내에서 활성 대상을 정렬, 검색 및 필터링할 수 있는 기능을 포함합니다.

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".
신규 - (베타) 만드는 기능이 추가되었습니다. 관련 제품 규칙 대상자가 정보를 제공합니다.

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일

신규 - 다음을 수행하는 경우 OAuth 2.0에 대한 지원이 추가됨: 구성 Audience Activation 확장.
수정 - 안정성 향상.

1.2.0

[호환성]{class="badge informative" title="호환성"}

2023년 8월 15일

수정 - UI 구성 요소 버전을 업데이트했습니다.

1.1.0

2023년 5월 30일

[호환성]{class="badge informative" title="호환성"}

신규 - 다음에 대한 지원이 추가되었습니다. 동적 블록 헤드리스 상점 앞에서요.

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에서 대상을 활성화하려면 다음을 수행해야 합니다.

  • Adobe Commerce 버전 2.4.4 이상 설치
  • 활성화 Real-Time CDP에서 대상으로서의 Adobe Commerce
  • 설치 다음 Audience Activation 관리자의 확장
  • 구성 다음 Audience Activation 관리자의 확장

확장 설치

설치 Audience Activation 에서 확장명 마켓플레이스또는 다음 명령을 실행합니다.

composer require magento/audiences

확장 구성

를 설치한 후 Audience Activation 확장을 사용하려면 Commerce 관리자에 로그인하고 다음을 완료해야 합니다.

  1. 다음에서 관리자 사이드바, 이동 System > Services>Commerce Services Connector.

  2. 로그인 을 Adobe 계정에 추가하고 조직 ID를 선택합니다.

  3. 다음에서 관리자 사이드바, 이동 System > Services>Data Connection.

  4. 다음에서 Datastream ID 필드에 생성 시 생성한 데이터 스트림의 ID를 붙여넣습니다. 활성화됨 Real-Time CDP의 대상으로서의 Adobe Commerce.

    이 데이터 스트림은 Commerce 웹 사이트의 데이터를 Real-Time CDP으로 전송하여 쇼핑객이 대상자에 속하는지 확인합니다. 데이터 스트림을 아직 만들지 않은 경우 만들기 1명 Experience Platform, 추가 Real-Time CDP의 Commerce 대상 및 Data Connection 관리자 확장명.

    note note
    NOTE
    데이터 스트림 ID를 지정할 때 특정 웹 사이트에 연결 다음에서 Data Connection 확장명. Commerce 스토어에 여러 웹 사이트가 있는 경우 대상 만들기 Real-Time CDP의 각 웹 사이트에 대해 서로 다른 데이터 스트림 ID를 사용하십시오.
  5. 다음에서 관리자 사이드바, 이동 Stores > Settings>Configuration.

  6. 확장 Services 및 선택 Data Connection.

  7. 추가 서비스 계정 및 자격 증명 세부 정보.

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

포함 Audience Activation 확장을 활성화하면 다음과 같은 작업을 수행할 수 있습니다.

TIP
내보내는 방법에 대한 완전한 엔드 투 엔드 사용 사례 Commerce 데이터를 Real-Time CDP에 업로드하고 대상을 작성한 다음 해당 대상을 활성화하여 Commerce, 참조 다음을 사용하여 Real-Time CDP에서 대상 만들기 Commerce 이벤트 데이터.

Real-Time CDP 대상 대시보드

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

에 액세스하려면 Real-Time CDP 대상 대시보드에서 로 이동합니다. 관리자 사이드바, 다음으로 이동 Customers > Real-time CDP Audience.

Real-Time CDP 대상 대시보드

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

설명
Hide filters
대시보드에 적용할 수 있는 필터를 표시하거나 숨길 수 있습니다. 현재 적용할 수 있는 유일한 필터는 다음과 같습니다. Last updated. 이 필터를 사용하면 대상이 마지막으로 업데이트된 시간을 기준으로 대상의 날짜 범위를 선택할 수 있습니다.
Search
Commerce 인스턴스에서 활성 대상을 검색할 수 있도록 해 줍니다.
Name
Real-Time CDP에서 대상에게 지정된 이름입니다.
Origin
대상이 어디에서 왔는지를 나타냅니다. 예: Experience Platform.
Websites
대상을 사용하도록 구성된 웹 사이트를 나타냅니다.
Dynamic Blocks
대상을 사용하도록 구성된 동적 블록을 나타냅니다.
Cart Price Rules
대상자를 사용하도록 구성된 장바구니 가격 규칙을 나타냅니다.
Related Product Rules
대상을 사용하도록 구성된 관련 제품 규칙을 나타냅니다.
Last updated
Real-Time CDP에서 대상이 수정된 시기를 나타냅니다.
Sync now
Real-Time CDP에서 새 대상자 또는 업데이트된 대상자를 검색합니다.
Customize table
다음을 표시하거나 숨길 수 있습니다. Origin, Websites, Dynamic Blocks, Cart Price Rules, 및 Last updated 열.

헤드리스 지원

AEM 및 PWA과 같은 Headless Adobe Commerce 인스턴스에서 대상을 활성화하여 장바구니 가격 규칙, 관련 제품 규칙 또는 대상을 기반으로 하는 동적 블록을 표시할 수 있습니다.

장바구니 가격 규칙 및 관련 제품 규칙

장바구니 가격 규칙 및 관련 제품 규칙의 경우, 헤드리스 매장은 다음을 통해 Experience Platform과 커뮤니케이션합니다. Commerce integration framework(CIF). 프레임워크는 GraphQL을 사용하여 구현된 서버측 API를 제공합니다. 쇼핑객 세그먼트와 같은 대상 정보는 라는 GraphQL 헤더 매개 변수를 통해 Commerce으로 전달됩니다. aep-segments-membership.

전반적인 아키텍처는 다음과 같습니다.

Headless Storefront에서 백엔드로 데이터 보내기

이후 설치구성 확장 기능인 Experience Platform 웹 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 입력 속성입니다. 하나 이상을 지정하는 경우 audience_id 의 값 dynamicBlocks query를 반환하면 해당 대상자에게 할당된 동적 블록 목록이 반환됩니다.

사용 예

다음 쿼리는 여러 대상 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 대상을 검색할 수 있습니다.

IMPORTANT
iOS용 Adobe Experience Platform Mobile SDK는 iOS 11 이상을 지원합니다.

구성을 완료한 후 모바일 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에 표시되지 않는 이유는 다음과 같습니다.

  • 에서 잘못된 인증 유형이 선택됨 데이터 연결 구성 페이지
  • 생성된 토큰에 대한 권한이 충분하지 않음

다음 두 섹션에서는 두 경우 중 하나의 문제를 해결하는 방법을 설명합니다.

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

  1. Commerce 인스턴스를 엽니다.
  2. 다음에서 관리자 사이드바, 이동 Stores > Settings>Configuration.
  3. 확장 Services 및 선택 Data Connection.
  4. 에 지정한 서버 간 인증 방법을 확인합니다. Authentication Type 필드가 올바릅니다. Adobe은 다음을 권장합니다. OAuth. JWT는 더 이상 사용되지 않습니다. 자세히 알아보기.

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

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

  1. 조직의 Adobe Experience Platform 시스템 관리자를 식별합니다.
  2. 사용할 프로젝트 및 자격 증명을 찾습니다.
  3. 기술 계정 이메일을 확인합니다. 예를 들면 다음과 같습니다. fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com.
  4. 시스템 관리자가 Adobe Experience Platform을 시작하고 로 이동하도록 합니다. Permissions -> Users -> API credentials.
  5. 위의 기술 계정 이메일을 사용하여 수정할 자격 증명을 검색합니다.
  6. 자격 증명을 연 다음 를 선택합니다 Roles -> Add roles.
  7. 다음을 포함하는 역할 추가 Manage destinations 권한.
  8. 클릭 Save.
  9. 재생성 콘솔의 액세스 토큰입니다.
  10. 토큰이 다음을 사용하여 유효한 응답을 제공하는지 확인 Target 연결 API.
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c