purchase

Evenimentul pentru finalizarea unei comenzi

Definiție: Un eveniment "purchase" este înregistrat atunci când un utilizator finalizează o achiziție pe un site de comerț electronic, indicând o tranzacție reușită.

Utilizare: Acest eveniment este utilizat frecvent în configurațiile de urmărire pentru comerțul electronic pentru a monitoriza tranzacțiile finalizate. Când un utilizator finalizează procesul de checkout și efectuează o achiziție, un eveniment "purchase" trebuie declanșat.

Sintaxa comună: Evenimentul este însoțit de un obiect ecommerce care conține informații despre articolul/articolele achiziționate și de un obiect user_data care conține informații despre cumpărător. Obiectul ecommerce trebuie să conțină următoarele proprietăți:
  • - transaction_id (obligatoriu): Identificatorul unic al tranzacției, numarul comenzii.
  • - currency (obligatoriu): Moneda în care este exprimată valoarea articolului (exemplu: RON).
  • - value (obligatoriu): Valoarea totală a comenzii, inclusiv costurile de livrare. (Folosește punctul ca separator zecimal.)
  • - tax (obligatoriu): Valoarea totală a taxelor (tva) asociate cu tranzactia. (Folosește punctul ca separator zecimal.)
  • - shipping (obligatoriu): Costul de livrare asociat cu tranzactia. (Folosește punctul ca separator zecimal.)
  • - shipping_tier (optional): Numele curierului sau modalitatea de livrare asociat cu tranzactia.
  • - payment_type (optional): Numele procesatorului de plata sau modalitatea de plata asociata cu tranzactia.
  • - coupon (optional): Numele cuponului aplicat si asociat comenzii.
  • - items (obligatoriu): Un array ce conține detalii despre articolul/articolele vizualizate. Fiecare detaliu despre articol este un obiect cu o structură standardizată.
Pentru mai multe informații despre obiectul user_data, te rugăm să consulți pagina de Date ale Utilizatorului.

<script>
window.dataLayer = window.dataLayer || [];
dataLayer.push({
    ecommerce: null /* Clear the previous ecommerce object. */
}, {
    event: "purchase",
    ecommerce: {
        currency: "ISO_CURRENCY_CODE", /* Exemplu: "RON" */
        value: 30.03, /* Suma rezultată din prețul fiecărui produs înmulțit cu cantitatea acestuia. */
        transaction_id: "UNIQUE_TRANSACTION_ID",
        tax: 10.99, /* Tax cost associated with a transaction */
        shipping: 2.59, /* Shipping cost associated with a transaction */
        shipping_tier: "SHIPPING_METHOD_NAME",
        payment_type: "PAYMENT_METHOD_NAME",
        coupon: "ORDER_SCOPED_COUPON_NAME",
        items: [{
            item_id: "PRODUCT_OR_VARIANT_ID", /*  Exemplu: id_12345-red */
            item_group_id: "PRODUCT_MASTER_ID", /*  Exemplu: id_12345 */
            item_sku: "PRODUCT_OR_VARIANT_SKU", /*  Exemplu: SKU_12345 */
            item_name: "PRODUCT_NAME",
            item_brand: "PRODUCT_BRAND_NAME", 
            item_category: "PRODUCT_FIRST_CATEGORY",
            item_category2: "PRODUCT_SECOND_CATEGORY",
            item_category3: "PRODUCT_THIRD_CATEGORY",
            item_category4: "PRODUCT_FOURTH_CATEGORY",
            item_category5: "PRODUCT_FIFTH_CATEGORY",
            item_variant: "VARIANT_NAME",
            price: 10.01, /*  Pretul de vanzare final */
            discount: 2.22, /*  Diferenta dintre pretul intreg si pretul de vanzare final */
            coupon: "PRODUCT_SCOPED_COUPON_NAME",
            item_tax_percent: 19,
            currency: "RON",
            quantity: 3,
            item_stock_status: "in stock"
        }
        /* .... restul de produse (daca exista) */
        ]
    },
    user_data: {
        /* Doar o singură proprietate este necesară pentru cheia care reprezintă emailul, fie sha256, fie plaintext. */
        email: "[email protected]",
        sha256_email_address: "3e1ufd1rdnh8l1rfz6xlreyw2yryd4zrf8zsk1pxh2x8wbsp2mw1g93rs5nx68dq", 
        /* Doar o singură proprietate este necesară pentru cheia care reprezintă numarul de telefon, fie sha256, fie plaintext. */
        phone_number: "+40744444444",
        sha256_phone_number: "unw5r66oikql4n4tlg2c54bkd2npephsbwwhxuoxreu6ph8uv6k424y9x15opy9y",
        address: {
            /* Doar o singură proprietate este necesară pentru cheia care reprezintă prenumele, fie sha256, fie plaintext. */
            first_name: "JOHN",
            sha256_first_name: "xrt2645ctp2xn781a237cp2wkk1opisg9j23hub2zqk1ndpnwyky4zm58ysslf7b",
            /* Doar o singură proprietate este necesară pentru cheia care reprezintă numele, fie sha256, fie plaintext. */
            last_name: "DOE",
            sha256_last_name: "xxuwrjdzber6q6u1vqet42mnt43ve4kyqggv694pvjd80gp89bxe3qdhihs4c4fg",
            country: "COUNTRY_NAME_OR_ISO_CODE",
            region: "REGION_NAME",
            city: "CITY_NAME",
            street: "STREET_NAME",
            postal_code: "12346",
        },
        customer_lifetime_value: 1234.59,
        customer_lifetime_orders: 7
    }
});
</script>