Article

C2S – WooCommerce – Manuelle

Découvrez les articles les plus lus

L’intégration manuelle pour WooCommerce remplace le module Affilae : vous posez vous-même le tag de suivi et le code de conversion dans votre thème WordPress. Elle demande deux codes, l’un sur toutes les pages, l’autre dans le fichier functions.php.

Prérequis : le format d’URL de votre programme doit être en Paramètre. Vous pouvez modifier le format d’URL en vous rendant dans la Configuration de votre programme, puis en modifiant les Paramètres généraux. Prévoyez aussi un accès à l’éditeur de thème de votre WordPress.

À noter : si vous pouvez installer le module Affilae, préférez-le. Il fait le même travail sans toucher au code de votre thème. Voir C2S – WooCommerce.

Tracker les clics des partenaires

Ce code se place dans toutes les pages de votre site, dans la balise <body>.

Où installer le code, via le thème

Allez dans WordPress Admin > Apparence > Éditeur de thème.
Sélectionnez header.php ou theme.php.
Ajoutez le code dans la balise <body>.

Code à installer :

<script type="text/javascript">
    var _ae = {
        "pid":"PROGRAM_ID",
    };
    (function() {
        var element = document.createElement('script'); element.type = 'text/javascript'; element.async = true;
        element.src = '//static.affilae.com/ae-v3.5.js';
        var scr = document.getElementsByTagName('script')[0]; scr.parentNode.insertBefore(element, scr);
    })();
</script>

Où trouver votre Program ID ? Admin Affilae > Configuration > onglet Tracking > section Intégration via un module Affilae. Remplacez PROGRAM_ID par cette valeur.

Tracker les ventes

Ce code se place dans le fichier functions.php de votre thème WordPress. Il se déclenche sur la page de remerciement de WooCommerce.

Où installer le code

Allez dans WordPress Admin > Apparence > Éditeur de thème.
Cliquez sur Theme Functions (functions.php).
Ajoutez le code tout en haut, juste après la ligne <?php.

Code à installer :

add_action('woocommerce_thankyou', 'Affilae_conversion_tracking');
function Affilae_conversion_tracking($order_id)
{
    $order = wc_get_order($order_id);
    $order_total = (float) $order->get_total() - $order->get_total_tax() - $order->get_total_shipping(); // Total before shipping cost and discount
    $discount_total = $order->get_discount_total();
    $total = $order_total - $discount_total;
    $order_num = str_replace('#', '', $order->get_order_number());
    // Get coupons code if any
    $coupons_code = "";
    $count = 0;
    foreach ($order->get_used_coupons() as $coupon) {  // since WC 3.7
        $count  ;
        if ($count > 1) {
            $coupons_code .= ';';
        }
        $coupons_code .= $coupon;
    }
    
    $items = $order->get_items();
    
    $product_id = '';
    $items = $order->get_items();
    $productsIdArray = array();

    foreach ($items as $item) {
    	$productsIdArray[] = $item['product_id'];
    }

    if (count($productsIdArray) > 0) {
        $product_id = implode(';', $productsIdArray);
    }
    
    echo '<iframe src="https://lb.affilae.com/?key=YOUR.KEY&id=' . $order_num . '&amount=' . $total . '&payment=online&cv={CUSTOM_VAR}&voucher=' . $coupons_code . '&product=' . $product_id . '" frameborder="0" width="1" height="1"></iframe>';
}

La variable à modifier

Remplacez la clé d’exemple YOUR.KEY par votre clé de conversion.

Où trouver votre clé ? Admin Affilae > Configuration > onglet Tracking > section Intégration via un module Affilae. Sélectionnez la règle concernée, puis copiez sa Clé/Key.

Ce que fait le code de conversion

Il remonte automatiquement les données suivantes, sans que vous ayez à les renseigner.

Le numéro de commande unique.
Le montant HT, hors taxes et frais de port.
Les codes promo utilisés.
Les ID des produits achetés.
Les remises appliquées.

Trois règles de calcul à connaître.

Montant final = prix total, moins les taxes, moins les frais de port, moins les remises.
Produits multiples : liste séparée par un point-virgule.
Codes promo multiples : liste séparée par un point-virgule.

Votre checklist d’installation

Installation

Code de suivi ajouté dans toutes les pages.
Code de conversion ajouté dans functions.php.
Variables remplacées par les vraies valeurs.

Test

Test des clics et des conversions effectué.
Vérification faite dans le tableau de bord Affilae.
Documentation de test suivie.

Astuce : testez avec une vraie commande, pas seulement avec un clic. Le code de conversion ne se déclenche que sur la page de remerciement de WooCommerce, donc un panier abandonné ne prouve rien.

Articles liés

Questions
fréquentes

Vérifiez que le Program ID est correct. Contrôlez ensuite que le code est bien présent dans toutes les pages du site, et pas seulement sur la page d’accueil.

Vérifiez que la clé de conversion est correcte, puis que le code est bien dans functions.php. Testez avec une vraie commande, et vérifiez que WooCommerce est à jour.

Le module fait le même travail sans que vous touchiez au code de votre thème, et il se configure depuis l’administration WordPress. L’intégration manuelle sert quand vous ne pouvez pas installer le module, ou quand votre thème demande une pose sur mesure.

Le montant final envoyé est le prix total de la commande, moins les taxes, moins les frais de port, moins les remises. C’est cette valeur qui sert de base au calcul de la commission.

Sous forme de liste séparée par un point-virgule. Le code de conversion assemble lui-même les ID de produits et les codes promo de la commande.

Dans Affilae, ouvrez la Configuration de votre programme, puis l’onglet Tracking. La section Intégration via un module Affilae affiche le Program ID et, pour chaque règle sélectionnée, sa Clé/Key.