products

products 변수는 제품과 제품에 연결된 속성을 추적하는데 일반적으로 개별 제품 페이지, 장바구니 페이지 및 구매 확인 페이지에서 설정됩니다. 이 변수는 여러 값을 갖는 변수입니다. 이것은 동일한 히트에서 여러 제품을 보낼 수 있고 Adobe가 값을 별도의 차원 항목으로 구문 분석함을 의미합니다.

NOTE
히트에서 이 변수가 events 변수 없이 설정되면 제품 보기 지표가 1만큼 증가합니다. products 변수가 있는 각 히트에 대해 적합한 이벤트를 설정해야 합니다.

웹 SDK를 사용한 제품

제품: Adobe Analytics에 대해 매핑됨 여러 XDM 필드 아래에서:

  • 범주가 다음에 매핑됨 productListItems[].productCategories[].categoryID. 에서 첫 번째 항목을 사용합니다. productCategories[] 배열입니다. lineItemId 또한 올바르게 매핑되지만 다음을 권장합니다. categoryID 표준 XDM이므로. 두 XDM 필드가 모두 있는 경우 lineItemId 을 우선으로 합니다.
  • 제품이 매핑된 대상 productListItems[].SKU 또는 productListItems[].name. 두 XDM 필드가 모두 있는 경우 productListItems[].SKU 를 사용합니다.
  • 수량이 매핑됨 productListItems[].quantity.
  • 가격이 매핑됩니다. productListItems[].priceTotal.
  • 머천다이징 eVar는에 매핑됩니다. productListItems._experience.analytics.customDimensions.eVars.eVar1productListItems._experience.analytics.customDimensions.eVars.eVar250제품에 바인딩할 eVar에 따라 다릅니다.
  • 머천다이징 이벤트가에 매핑됩니다. productListItems[]._experience.analytics.event1to100.event1.valueproductListItems._experience.analytics.event901to1000.event1000.value제품에 바인딩할 이벤트에 따라 다릅니다. 이러한 필드 중 하나에서 이벤트를 설정하면 자동으로 이벤트 문자열이 Adobe Analytics으로 전송되었습니다.
NOTE
lineItemId 아직 표준 Analytics 이벤트 스키마에 포함되어 있지 않으므로 사용자 지정 필드로 추가해야 합니다. Adobe은 향후 전용 '범주' 필드를 추가할 계획입니다.

Adobe Analytics 확장을 사용하는 제품

Adobe Experience Platform 데이터 수집에는 이 변수를 설정할 전용 필드가 없습니다. 그러나 도움이 되는 타사 확장이 여러 개 있습니다.

  1. AdobeID 자격 증명을 사용하여 Adobe Experience Platform 데이터 수집에 로그인합니다.
  2. 원하는 태그 속성을 클릭합니다.
  3. 확장 탭으로 이동한 다음, 카탈로그를 클릭하여 사용 가능한 모든 확장을 확인합니다.
  4. product라는 용어를 검색하면 이 변수를 설정하는 데 도움이 되는 사용 가능한 몇 가지 확장이 표시됩니다.

이 확장 중 하나를 사용하거나 아래의 AppMeasurement 구문에 따라 사용자 지정 코드 편집기를 사용할 수 있습니다.

AppMeasurement 및 Analytics 확장 사용자 지정 코드 편집기의 s.products

s.products 변수는 제품당 여러 개의 구분된 필드를 포함하는 문자열입니다. 각 필드는 문자열에서 세미콜론 (;)으로 구분하십시오.

  • 범주 (선택 사항): 제품 범주. 이 필드의 최대 길이는 100바이트입니다.
  • 제품 이름 (필수): 제품의 이름입니다. 이 필드의 최대 길이는 100바이트입니다.
  • 수량 (선택 사항): 장바구니에 들어 있는 제품의 수. 이 필드는 구매 이벤트가 있는 히트에만 적용됩니다.
  • 가격 (선택 사항): 제품의 총 가격 (소수). 수량이 두 개 이상인 경우 개별 제품 가격이 아니라 합계로 가격을 설정합니다. 이 값의 통화를 currencyCode 변수와 일치하도록 맞춥니다. 이 필드에 통화 기호를 포함하지는 마십시오. 이 필드는 구매 이벤트가 있는 히트에만 적용됩니다.
  • 이벤트 (선택 사항): 제품에 연결된 이벤트. 여러 이벤트는 파이프(|)를 사용하여 구분하십시오. 자세한 내용은 이벤트를 참조하십시오.
  • eVar (선택 사항): 제품에 연결된 머천다이징 eVar. 여러 머천다이징 eVar는 파이프(|)를 사용하여 구분하십시오. 자세한 내용은 머천다이징 eVar를 참조하십시오.
// Set a single product using all available fields
s.products = "Example category;Example product;1;3.50;event1=4.99|event2=5.99;eVar1=Example merchandising value 1|eVar2=Example merchandising value 2";

이 변수는 동일한 히트에서 여러 제품을 지원합니다. 여러 제품이 포함된 장바구니 및 구매 시 유용합니다. 전체에 대한 최대 길이 products 문자열은 64k 바이트입니다. 문자열에서 각 제품은 쉼표 (,)로 구분하십시오.

// Set multiple products - useful for when a visitor views their shopping cart
s.products = "Example category 1;Example product 1;1;3.50,Example category 2;Example product 2;1;5.99";
WARNING
제품 이름, 카테고리 및 머천다이징 eVar 값에서 모든 세미콜론, 쉼표 및 파이프를 제거하십시오. 제품 이름에 쉼표가 포함되어 있으면 AppMeasurement가 해당 쉼표를 새 제품의 시작으로 구문 분석합니다. 이렇게 잘못된 구문 분석이 제품 문자열의 나머지 부분에서 발생하면 차원 및 보고서에서 잘못된 데이터가 생성됩니다.

products 변수는 필드를 생략하고 여러 제품을 포함할 때 유연합니다. 이러한 유연성으로 인해 구분 기호가 쉽게 누락될 수 있고, 이렇게 되면 구현에서 잘못된 데이터를 Adobe에 보내게 됩니다.

// Include only product and category. Common on individual product pages
s.products = "Example category;Example product";

// Include only product name
s.products = ";Example product";

// One product has a category, the other does not. Note the comma and adjacent semicolon to omit category
s.products = "Example category;Example product 1,;Example product 2";

// A visitor purchases a single product; record quantity and price
s.events = "purchase";
s.products = ";Example product;1;6.99";

// A visitor purchases multiple products with different quantities
s.events = "purchase";
s.products = ";Example product 1;9;26.91,Example category;Example product 2;4;9.96";

// Attribute currency event1 only to product 2 and not product 1
s.events = "event1";
s.products = ";Example product 1;1;1.99,Example category 2;Example product 2;1;2.69;event1=1.29";

// Use multiple numeric events in the product string
s.events = "event1,event2";
s.products = ";Example product;1;4.20;event1=2.3|event2=5";

// Use merchandising eVars without any events. Note the adjacent semicolons to skip events
s.products = ";Example product;1;6.69;;eVar1=Merchandising value";

// Use merchandising eVars without category, quantity, price, or events
s.products = ";Example product;;;;eVar1=Merchandising value";

// Multiple products using multiple different events and multiple different merchandising eVars
s.events = "event1,event2,event3,event4,purchase";
s.products = "Example category 1;Example product 1;3;12.60;event1=1.4|event2=9;eVar1=Merchandising value|eVar2=Another merchandising value,Example category 2;Example product 2;1;59.99;event3=6.99|event4=1;eVar3=Merchandising value 3|eVar4=Example value four";

digitalData 데이터 레이어를 사용하는 경우 digitalData.product 객체 배열을 반복할 수 있습니다.

for(var i = 0; i < digitalData.product.length; i++) {
    // Add individual product info to the product string
    s.products += digitalData.product[i].category.primaryCategory + ";" + digitalData.product[i].productInfo.productName;
    // If there are more products, add a comma
    if(i != digitalData.product.length - 1) {
        s.products += ",";
    }
}
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690