Documentatie Experience Platform Gids voor Query Service

Commerciële variabelen uit analysegegevens retourneren en gebruiken

Last update: Thu Nov 02 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:
Queries

Gemaakt voor:

User
Developer

De Dienst van de Vraag van het gebruik om de gegevens te beheren die van Adobe Analytics in Adobe Experience Platform als datasets worden opgenomen. De volgende secties verstrekken steekproefvragen die u kunt gebruiken om tot de het verhandelen variabelen in uw datasets van Analytics toegang te hebben. Zie de documentatie voor meer informatie over Adobe Analytics-gegevens opnemen en toewijzen via de bron Analytics

Merchandisingvariabelen merchandising-variables

De variabelen van de koophandel kunnen één van twee syntaxis volgen:

Productsyntaxis: Koppelt de waarde eVar aan een product.
Conversievariabele syntaxis: Koppelt de eVar alleen aan een product als er een bindingsgebeurtenis plaatsvindt. U kunt de gebeurtenissen selecteren die als bindingsgebeurtenissen fungeren.

Productsyntaxis product-syntax

In Adobe Analytics kunnen aangepaste productgegevens worden verzameld via speciaal geconfigureerde variabelen, de zogenaamde 'merchandising'-variabelen. Deze zijn gebaseerd op een eVar of aangepaste gebeurtenissen. Het verschil tussen deze variabelen en hun typische gebruik is dat zij een afzonderlijke waarde voor elk product vertegenwoordigen dat op de treffer wordt gevonden eerder dan slechts één waarde voor de treffer.

Deze variabelen worden ook wel handelsvariabelen in de productsyntaxis genoemd. Op deze manier kunt u informatie verzamelen, zoals een "kortingsbedrag" per product of informatie over de "locatie op pagina" van het product in de zoekresultaten van de klant.

Meer informatie over het gebruik van de productsyntaxis vindt u in de Adobe Analytics-documentatie op eVars implementeren met productsyntaxis.

In de onderstaande secties worden de XDM-velden beschreven die nodig zijn voor toegang tot de handelsvariabelen in uw Analytics gegevensset:

eVars

productListItems[#]._experience.analytics.customDimensions.evars.evar#

#: De index van de array die u opent.
evar#: De specifieke variabele eVar die u opent.

Aangepaste gebeurtenissen

productListItems[#]._experience.analytics.event1to100.event#.value

#: De index van de array die u opent.
event#: De specifieke aangepaste gebeurtenisvariabele die u opent.

Gebruiksscenario's voor productsyntaxis product-use-cases

De volgende gebruiksgevallen zijn vooral bedoeld voor het retourneren van een eVar voor handelsdoeleinden uit de productListItems array met SQL.

Retourneer een eVar voor handelsdoeleinden en een gebeurtenis

De vraag keert hieronder een koopvaardigende eVar en een gebeurtenis voor het eerste product terug dat in wordt gevonden productListItems array.

SELECT
  productListItems[0]._experience.analytics.customDimensions.evars.eVar1,
  productListItems[0]._experience.analytics.event1to100.event1.value
FROM adobe_analytics_midvalues
WHERE timestamp = to_timestamp('2019-07-23')
  AND productListItems[0].SKU IS NOT NULL
  AND productListItems[0]._experience.analytics.customDimensions.evars.eVar1 IS NOT NULL
  AND productListItems[0]._experience.analytics.event1to100.event1.value IS NOT NULL
LIMIT 10

Explodeer de array productListItems en retourneer de eVar en gebeurtenis voor elk product.

In deze volgende query wordt het dialoogvenster productListItems array en retourneert elke eVar en gebeurtenis die door de handel wordt verwerkt. De _id wordt opgenomen om de relatie met de originele hit te tonen. De _id value is een unieke primaire sleutel voor de dataset.

NOTE

De exploderfunctie scheidt de elementen van een array in meerdere rijen. Null-waarden worden uitgesloten.

SELECT
  _id,
  productItem._experience.analytics.customDimensions.evars.eVar1,
  productItem._experience.analytics.event1to100.event1.value
FROM (
  SELECT
    _id,
    explode(productListItems) as productItem
  FROM adobe_analytics_midvalues
  WHERE TIMESTAMP = to_timestamp('2019-07-23')
  AND productListItems[0].SKU IS NOT NULL
  AND productListItems[0]._experience.analytics.customDimensions.evars.eVar1 IS NOT NULL
  AND productListItems[0]._experience.analytics.event1to100.event1.value IS NOT NULL
)
LIMIT 20

NOTE

Als u probeert om een gebied terug te winnen dat niet in uw huidige dataset bestaat, komt de "Geen zulk struct gebied"fout voor. Evalueer de reden die in het foutenbericht is teruggekeerd om een beschikbaar gebied te identificeren, dan uw vraag bij te werken en het opnieuw uit te voeren.

code language-console
`ERROR: ErrorCode: 08P01 sessionId: XXXX queryId: XXXX Unknown error encountered. Reason: [No such struct field evar1 in eVar10, eVar13, eVar62, eVar88, eVar2;]`

Syntaxis conversievariabele conversion-variable-syntax

Een ander type handelsvariabele dat in Adobe Analytics wordt gevonden, is de syntaxis van de conversievariabele. De syntaxis van de conversievariabele wordt gebruikt wanneer de waarde van eVar niet beschikbaar is om in de productvariabele te worden geplaatst. Dit scenario betekent doorgaans dat de pagina geen context heeft van het kanaal voor handelsdoeleinden of de zoekmethode. In deze gevallen moet u de variabele voor het wijzigen van de handelswaarde instellen voordat de gebruiker bij de productpagina aankomt. De waarde blijft bestaan totdat de gebeurtenis binding plaatsvindt.

Het onderstaande productzoekingsscenario illustreert bijvoorbeeld hoe de vereiste gegevens op een pagina aanwezig kunnen zijn voordat de conversie of gebeurtenis met betrekking tot het product plaatsvindt.

Een gebruiker voert een intern onderzoek naar "winterhoed"uit die de omzettingssyntaxis toegelaten merchandising eVar6 aan "intern onderzoek:winterhoed"plaatst.
De gebruiker klikt op "wafelbeanie" en landt op de pagina met productdetails.
a. De landing hier brandt voor een Product View gebeurtenis voor de "waffle beanie" voor $12,99.
b) sinds Product View wordt gevormd als bindende gebeurtenis, is het product "wafelbeanie"nu gebonden aan de eVar6 waarde van "intern onderzoek:winterhoed". Telkens wanneer het "wafelbeanie"-product wordt verzameld, wordt het gekoppeld aan "interne zoekactie:winterhoed". Dit gebeurt totdat de eVar-instelling voor verlopen is bereikt of er een nieuwe eVar6-waarde is ingesteld en de bindingsgebeurtenis opnieuw met dat product plaatsvindt.
De gebruiker voegt het product aan zijn winkelwagentje toe en ontslaat het Cart Add gebeurtenis.
De gebruiker voert een andere interne zoekopdracht naar "zomershirt" uit, die de omzettingssyntaxis voor merchandising eVar6 instelt op "intern zoeken:zomershirt".
De gebruiker selecteert "sporty t-shirt" en landt op de pagina met productdetails.
a. De landing hier brandt voor een Product View evenement voor "sporty t-shirt voor $19,99.
b. Als de Product View Het evenement is bindend en het product "sporty t-shirt" is nu gebonden aan de eVar6-waarde van "internal search:zomer shirt". Het vorige product "wafelbeanie" is nog steeds gebonden aan een eVar6-waarde van "internal search:waffle beanie".
De gebruiker voegt het product aan zijn winkelwagentje toe en ontslaat het Cart Add gebeurtenis.
De gebruiker checkt beide producten uit.

Bij het rapporteren zijn de bestellingen, opbrengsten, productweergaven en winkelwagentjes rapporteerbaar ten opzichte van eVar6 en zijn ze afgestemd op de activiteit van het gebonden product.

eVar6 (productbepalingsmethode)

omzet

orders

productweergave

cartografische objecten

intern zoeken:zomershirt

19.99

interne zoekopdracht:winterhoed

12.99

Meer informatie over het gebruik van de syntaxis van de conversievariabele vindt u in de Adobe Analytics-documentatie op implementeren van eVars met syntaxis van conversievariabelen.

Hieronder worden de XDM-velden weergegeven die de syntaxis van de conversievariabele in uw Analytics gegevensset:

eVars

_experience.analytics.customDimensions.evars.evar#

evar#: De specifieke variabele eVar die u opent.

Product

productListItems[#].sku

#: De index van de array die u opent.

Gebruiksgevallen van conversievariabele conversion-variable-use-cases

In de onderstaande gebruiksgevallen worden scenario's beschreven waarvoor de syntaxis van conversievariabelen vereist is.

De waarde binden aan het specifieke product en de gebeurteniscombinatie

De query hieronder bindt de waarde aan het specifieke product en gebeurtenispaar. In dit voorbeeld is de waarde gebonden aan de gebeurtenis van de productweergave.

SELECT
  endUserIds._experience.aaid.id AS AAID,
  timestamp,
  CASE WHEN commerce.productViews.value = 1 THEN ATTRIBUTION_LAST_TOUCH(timestamp, 'bindConversionSyntaxMerchVariable_eVar1', _experience.analytics.customDimensions.eVars.eVar1)
  OVER(PARTITION BY endUserIds._experience.aaid.id
       ORDER BY timestamp
       ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW).value
  END AS eVar1Bind,
  EXPLODE(productListItems) AS Product_List,
  commerce.productViews.value AS prodView,
  commerce.purchases.value AS purchase
FROM adobe_analytics_midvalues
WHERE commerce.productViews.value = 1 OR commerce.purchases.value = 1 OR _experience.analytics.customDimensions.eVars.eVar1 IS NOT NULL
LIMIT 100

De gebonden waarde tot volgende exemplaren van het desbetreffende product behouden

De voorbeeldvraag hieronder handhaaft de gebonden waarde aan verdere voorkomen van het respectieve product. De laagste subquery vestigt de relatie van de waarde met het product op de gedeclareerde bindingsgebeurtenis. De volgende subquery voert de toewijzing van die gebonden waarde uit voor volgende interacties met het desbetreffende product. De SELECT op hoofdniveau aggregeert de resultaten om de rapportage te produceren.

SELECT
  Product_List.SKU,
  eVar1101ConversionSyntax,
  SUM(prodView) AS Product_Views,
  SUM(purchase) AS Purchases
FROM
(
  SELECT
    Product_List,
    ATTRIBUTION_LAST_TOUCH(timestamp, 'ConversionSyntax_eVar1', eVar1Bind)
      OVER(PARTITION BY AAID, Product_List.SKU
           ORDER BY timestamp
           ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW).value
    AS eVar1ConversionSyntax,
    prodView,
    purchase
  FROM
  (
    SELECT
      endUserIds._experience.aaid.id AS AAID,
      timestamp,
      CASE WHEN commerce.productViews.value = 1 THEN ATTRIBUTION_LAST_TOUCH(timestamp, 'bindConversionSyntaxMerchVariable_eVar1', _experience.analytics.customDimensions.eVars.eVar1)
      OVER(PARTITION BY endUserIds._experience.aaid.id
           ORDER BY timestamp
           ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW).value
      END AS eVar1Bind,
      EXPLODE(productListItems) AS Product_List,
      commerce.productViews.value AS prodView,
      commerce.purchases.value AS purchase
    FROM adobe_analytics_midvalues
    WHERE commerce.productViews.value = 1 OR commerce.purchases.value = 1 OR _experience.analytics.customDimensions.eVars.eVar1 IS NOT NULL
  )
)
WHERE eVar1ConversionSyntax IS NOT NULL
GROUP BY 1, 2
ORDER BY 3 DESC
LIMIT 100

Volgende stappen

Door dit document te lezen, zou u beter inzicht in moeten hebben hoe te om een koopvaardigende eVar terug te keren gebruikend productsyntaxis en een waarde aan een specifiek product met de syntaxis van de omzettingsvariabele te binden.

Als u dit nog niet hebt gedaan, moet u de Analyseinzichten voor documentatie over web en mobiele interacties volgende. Het verstrekt gemeenschappelijke gebruiksgevallen en toont hoe te om de Dienst van de Vraag te gebruiken om actionable inzichten van Web en mobiele gegevens van Adobe Analytics tot stand te brengen.

recommendation-more-help

ccf2b369-4031-483f-af63-a93b5ae5e3fb