DocumentatieAnalyticsImplementatiehandleiding

producten

Last update: Tue Apr 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Admin
  • Developer

De products met variabele tracks kunt u producten en eigenschappen bijhouden die aan deze producten zijn gekoppeld. Deze variabele wordt doorgaans ingesteld op afzonderlijke productpagina's, winkelwagenpagina's en pagina's met aankoopbevestiging. Dit is een variabele met meerdere waarden. Dit betekent dat u meerdere producten in dezelfde hit kunt verzenden en dat de Adobe de waarde parseert in verschillende dimensieitems.

NOTE
Als deze variabele wordt ingesteld in een hit zonder de opdracht events variabele, de Productweergaven metrische stappen met 1. Zorg ervoor dat u de juiste gebeurtenissen instelt voor elke hit met de knop products variabele.

Producten die SDK van het Web gebruiken

Als u de XDM-object, worden de producten aan de volgende variabelen toegewezen:

  • Categorie is toegewezen aan xdm.productListItems[].productCategories[].categoryID. Het gebruikt het eerste item in de productCategories[] array. lineItemId worden ook correct toegewezen, maar de Adobe beveelt aan categoryID omdat het standaard XDM is. Als beide XDM-velden aanwezig zijn, lineItemId heeft voorrang.
  • Product is toegewezen aan xdm.productListItems[].SKU of xdm.productListItems[].name. Als beide XDM-velden aanwezig zijn, xdm.productListItems[].SKU wordt gebruikt.
  • Aantal is toegewezen aan xdm.productListItems[].quantity.
  • Prijs is toegewezen aan xdm.productListItems[].priceTotal.
  • Merchandising eVars worden toegewezen aan xdm.productListItems._experience.analytics.customDimensions.eVars.eVar1 tot xdm.productListItems._experience.analytics.customDimensions.eVars.eVar250, afhankelijk van welke eVar u aan een product wilt binden.
  • Merchandising-gebeurtenissen worden toegewezen aan xdm.productListItems[]._experience.analytics.event1to100.event1.value tot xdm.productListItems._experience.analytics.event901to1000.event1000.value, afhankelijk van welke gebeurtenis u aan een product wilt binden. Als u een gebeurtenis instelt in een van deze velden, wordt deze automatisch opgenomen in het dialoogvenster event tekenreeks verzonden naar Adobe Analytics.
{
  "xdm": {
    "productListItems": [{
      "productCategories": [{
        "categoryID": "Men's"
      }],
      "name": "Hiking boot",
      "quantity": 1,
      "priceTotal": 49.99
    },
    {
      "productCategories": [{
        "categoryID": "Camping"
      }],
      "name": "Hunting blind",
      "quantity": 3,
      "priceTotal": 699.69
    }]
  }
}

Als u de gegevensobject, de productvariabele data.__adobe.analytics.products volgende AppMeasurement syntaxis. Als u dit veld instelt, worden alle producten die in het XDM-object zijn ingesteld, overschreven en niet verzonden naar Adobe Analytics.

{
  "data": {
    "__adobe": {
      "analytics": {
        "products": "Archery;Fletched arrow;12;159.99"
      }
    }
  }
}

Producten die de extensie Adobe Analytics gebruiken

Er is geen specifiek veld in de gegevensverzameling van Adobe Experience Platform om deze variabele in te stellen. Er zijn echter meerdere extensies van derden voor hulp.

  1. Aanmelden bij Adobe Experience Platform-gegevensverzameling met uw Adobe-id-referenties.
  2. Klik op de gewenste tageigenschap.
  3. Ga naar de Extensions tab, en klik vervolgens op Catalog om alle beschikbare extensies weer te geven.
  4. Zoek naar de term "product", die verscheidene uitbreidingen beschikbaar om te helpen plaatsen deze variabele openbaart.

U kunt een van deze extensies gebruiken, maar u kunt ook de aangepaste code-editor gebruiken die volgt op de syntaxis van het AppMeasurement hieronder.

s.products in AppMeasurement en de de coderedacteur van de de uitbreidingsuitbreiding van de Analyse

De s.products variabele is een tekenreeks die meerdere gescheiden velden per product bevat. Elk veld scheiden met een puntkomma (;) in de tekenreeks.

  • Categorie (facultatief): de productcategorie. De maximumlengte voor dit veld is 100 bytes.
  • Productnaam (vereist): de naam van het product. De maximumlengte voor dit veld is 100 bytes.
  • Aantal (facultatief): hoeveel van dit product in de kar is. Dit veld is alleen van toepassing op hits met de koopgebeurtenis.
  • Prijs (facultatief): de totale prijs van het product als decimaal. Indien meer dan één hoeveelheid is, de totale prijs en niet de individuele productprijs. De valuta van deze waarde aanpassen aan de currencyCode variabele. Plaats het valutasymbool niet in dit veld. Dit veld is alleen van toepassing op hits met de koopgebeurtenis.
  • Gebeurtenissen (optioneel): Gebeurtenissen die aan het product zijn gekoppeld. Meerdere gebeurtenissen scheiden met een pipe (|). Zie gebeurtenissen voor meer informatie .
  • eVars (facultatief): aan het product gekoppelde handelsmerken. Meerdere handelsmerken scheiden met een pipe (|). Zie merchandising Vars voor meer informatie .
// 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";

Deze variabele ondersteunt meerdere producten in dezelfde hit. Het is waardevol voor winkelwagentjes en aankopen die meerdere producten bevatten. De maximumlengte voor de gehele products tekenreeks is 64k bytes. Elk product scheiden met een komma (,) in de tekenreeks.

// 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
Hiermee kunt u alle puntkomma's, komma's en pijpen van productnamen, categorieën en waarden voor eVar voor handelsdoeleinden verwijderen. Als een productnaam een komma bevat, wordt deze door AppMeasurement geparseerd als het begin van een nieuw product. Door deze onjuiste parsering wordt de rest van de productreeks verwijderd, waardoor onjuiste gegevens in afmetingen en rapporten ontstaan.

Voorbeelden

De products variabele is flexibel wanneer velden worden weggelaten en meerdere producten worden opgenomen. Dankzij deze flexibiliteit kunt u gemakkelijk een scheidingsteken missen, waardoor uw implementatie onjuiste gegevens naar de Adobe stuurt.

// 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";

Als u de digitalData gegevenslaag, kunt u door digitalData.product objectarray:

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