eVar (Merchandising)

Auf dieser Hilfeseite wird die Implementierung von Merchandising-eVars beschrieben. Informationen dazu, wie Merchandising-eVars als Dimension funktionieren, finden Sie unter eVar (Merchandising-Dimension) im Komponenten-Benutzerhandbuch.

Merchandising-eVars binden einen Wert an einzelne Produkte, sodass Erfolgsereignisse, die jedes Produkt betreffen, dem an dieses Produkt gebundenen Wert gutgeschrieben werden. Sie haben zwei Möglichkeiten, den Wert festzulegen:

Informationen zur Funktionsweise von Bindung, Zuordnung und Gültigkeit finden Sie unter eVar (Merchandising-Dimension).

Einrichten von eVars in den Report Suite-Einstellungen

Bevor Sie eVars in Ihrer Implementierung verwenden, stellen Sie sicher, dass Sie die eVar in den Report Suite-Einstellungen gemäß der gewünschten Syntax konfigurieren. Weitere Informationen finden Sie im Admin-Handbuch unter Konversionsvariablen.

Syntax auswählen

Verwenden Sie Produktsyntax wenn der Merchandising-Wert zum Zeitpunkt der Festlegung der products verfügbar ist oder wenn Produkte im selben Treffer unterschiedliche Werte benötigen. Verwenden Sie Konversionsvariablensyntax wenn der Wert vor dem Produkt bekannt ist, z. B. der Suchbegriff oder die interne Kampagne, die den Besucher zum Produkt geführt hat. Siehe Funktionsweise von Bindung und Zuordnung für einen vollständigen Vergleich.

Implementieren mit der Produktsyntax

Wenn Produktsyntax aktiviert ist, wird der Merchandising-Wert direkt innerhalb der products festgelegt, sodass keine Binding-Ereignisse verwendet werden. Merchandising-eVars befinden sich im letzten Segment jedes Produkts:

s.products = "[category];[name];[quantity];[revenue];[events];[eVars]";

Trennen Sie mehrere Merchandising-eVars für dasselbe Produkt durch einen senkrechten Strich (|). Die leeren Platzhalter für Menge, Umsatz und Ereignisse sind erforderlich, auch wenn Sie sie nicht verwenden. Ohne sie wird der eVar-Wert ignoriert.

Der Wert ist an das Produkt in diesem Treffer gebunden. Ob ein späterer Wert eine vorhandene Bindung ersetzt, hängt von der Einstellung Zuordnung ab. Siehe Funktionsweise von Bindung und Zuordnung.

// The bare minimum to set a merchandising eVar with product syntax
s.products = ";Example product;;;;eVar1=Example merchandising value";

// An example single product with product syntax
s.products = "Example category;Example product;1;5.99;event1=1;eVar1=Turtles";

// Tie a merchandising eVar to different values on two different products
s.products = "Birds;Scarlet Macaw;1;4200;;eVar1=talking bird,Birds;Turtle dove;2;550;;eVar1=love birds";

Produktsyntax, die das Web SDK verwendet

Wenn Sie das XDM-Objekt verwenden, verwenden Merchandising-Variablen mit Produktsyntax die folgenden XDM-Felder:

Das folgende Beispiel zeigt ein Produkt unter Verwendung mehrerer Merchandising-eVars und -Ereignisse:

"productListItems": [
  {
    "name": "Bahama Shirt",
    "priceTotal": "12.99",
    "quantity": 3,
    "_experience": {
      "analytics": {
        "customDimensions" : {
          "eVars" : {
            "eVar10" : "green",
            "eVar33" : "large"
          }
        },
        "event1to100" : {
          "event4" : {
            "value" : 1
          },
          "event10" : {
            "value" : 2,
            "id" : "abcd"
          }
        }
      }
    }
  }
]

Das obige Beispielobjekt würde wie folgt an Adobe Analytics gesendet werden: ";Bahama Shirt;3;12.99;event4|event10=2:abcd;eVar10=green|eVar33=large".

Bei Verwendung des Datenobjekts werden Merchandising-eVars mit Produktsyntax in data.__adobe.analytics.products festgelegt, wobei dieselbe Syntax wie bei der AppMeasurement-products verwendet wird. Das Datenobjekt-Äquivalent des obigen XDM-Beispiels:

"data": {
  "__adobe": {
    "analytics": {
      "products": ";Bahama Shirt;3;12.99;event4|event10=2:abcd;eVar10=green|eVar33=large"
    }
  }
}

Implementieren mit Syntax der Konversionsvariablen

Verwenden Sie Konversionsvariablensyntax wenn der eVar-Wert nicht verfügbar ist, um ihn in der products-Variablen festzulegen. Dieses Szenario bedeutet in der Regel, dass Ihre Produktseite keinen Kontext des Merchandising-Kanals oder der Suchmethode hat. Legen Sie in diesen Fällen die Merchandising-eVar auf oder vor der Seite fest, auf der das Binding-Ereignis auftritt. Der Wert bleibt erhalten, bis er abläuft, oder wird mit einem neuen Wert überschrieben.

Wenn ein Treffer sowohl die Variable products als auch ein ausgewähltes Merchandising-Binding-Ereignis enthält, wird der aktuelle Wert der eVar an jedes Produkt in diesem Treffer gebunden. Wenn Sie die eVar neben einem Produkt ohne Binding-Ereignis festlegen, wird der Wert nicht gebunden. Ob eine spätere Bindung eine vorhandene ersetzt, hängt von der Einstellung Zuordnung ab. Siehe Funktionsweise von Bindung und Zuordnung.

Ein Beispiel, das mehrere eVars für Produktsuchmethoden gleichzeitig festlegt, finden Sie Best Practice: Produktsuchmethoden.

Im folgenden Beispiel wird eine Merchandising-eVar vor dem Binding-Ereignis festgelegt:

// Place on the same or previous page before the binding event:
s.eVar1 = "Aviary";

// Place on the page where the binding event occurs:
s.events = "prodView";
s.products = ";Canary";

Wenn Produktansichtsereignis ein Binding-Ereignis ist, ist der für eVar1 "Aviary" Wert an die "Canary" gebunden. Nachfolgende Erfolgsereignisse, die dieses Produkt betreffen, werden "Aviary" gutgeschrieben. Der Wert "Aviary" auch an Produkte bei späteren Treffern gebunden, die ein Binding-Ereignis enthalten, bis eine der folgenden Bedingungen erfüllt ist:

Konversionsvariablensyntax, die das Web SDK verwendet

Bei Verwendung des XDM-) funktioniert die Syntax ähnlich wie die Implementierung anderer eVars und Ereignisse. Bei Verwendung des Datenobjekts folgt die Syntax AppMeasurement.

Das XDM-Spiegeln des obigen AppMeasurement-Beispiels würde wie folgt aussehen.

Festlegen der eVar für denselben oder vorherigen Ereignisaufruf:

"_experience": {
  "analytics": {
    "customDimensions": {
      "eVars": {
        "eVar1" : "Aviary"
      }
    }
  }
}

Festlegen des Binding-Ereignisses und der Werte für die Produktzeichenfolge:

"commerce": {
  "productViews" : {
    "value" : 1
  }
},
"productListItems": [
  {
    "name": "Canary"
  }
]

Die Datenobjekte, die das obige AppMeasurement-Beispiel spiegeln, würden wie folgt aussehen.

Festlegen der eVar für denselben oder vorherigen Ereignisaufruf:

"data": {
  "__adobe": {
    "analytics": {
      "eVar1": "Aviary"
    }
  }
}

Festlegen des Binding-Ereignisses und der Werte für die Produktzeichenfolge:

"data": {
  "__adobe": {
    "analytics": {
      "events": "prodView",
      "products": ";Canary"
    }
  }
}