Mettez à niveau votre intégration Magento

Aperçu

Affirm propose désormais les fonctionnalités suivantes en utilisant le nouvel attribut de type page de données dans le message promotionnel Affirm :

• De nouveaux composants de messagerie promotionnelle qui répondent de manière dynamique à vos programmes de financement uniques, comme des termes plus longs (conditions de repaiement de 18, 24 et 36 mois) et des promotions à 0% TAEG, avec des messages personnalisables pour personnaliser le parcours du consommateur
• Notre flux de préqualification au sein des composants de messagerie promotionnelle pour débloquer le potentiel d'achat tout en minimisant le travail de développement supplémentaire pour vos équipes
• Notre bibliothèque Affirm.js mise à jour, qui comprend des analyses améliorées qui fournissent des informations sur les consommateurs et permettent des tests A/B pour garder votre site optimisé

Ce guide s'adresse aux commerçants qui utilisent Magento qui souhaitent profiter des fonctionnalités ci-dessus sans mettre à niveau leur extension Magento (version 3.5.6 et supérieure).

1. Connectez-vous à notre sandbox

Effectuez cette mise à niveau dans votre environnement de développement connecté à notre sandbox. Pour connecter votre environnement de développement à notre sandbox, procédez comme suit :

1. Obtenez vos clés API publiques et privées sandbox à https://sandbox.affirm.com/dashboard/#/apikeys
2. Connectez-vous à votre portail d’administration Magento
3. Accédez à Configuration du système > Ventes > Modes de paiement > Affirm
4. Gardez le mode défini sur Sandbox
5. Saisissez la clé API publique et la clé secrète (clé privée) que vous avez récupérées à partir du tableau de bord commerçant sandbox Affirm.

2. Ajouter Affirm.js

Ajoutez le code d'intégration Affirm.js à la tête de votre modèle de page globale en procédant comme suit :

1. Open MAGENTO_ROOT/app/design/frontend/base/default/layout/affirm/affirm.xml
2. Ajouter Affirm.js Initialisation de la configuration Affirm dans l'en-tête global

<layout>
    <default>
        <reference name="head">
            <action method="addItem">
                <type>skin_js</type>
                <name>js/affirm/promos.js</name>
            </action>
            <block type="core/text" name="affirm.cdn.javascript">
                <action method="setText">
                    <text helper="affirm/getAffirmJs" />
                </action>
            </block>
        </reference>
    </default>

3. Ouvrir MAGENTO_ROOT/app/code/community/Affirm/Affirm/Helper/Data.php
4. Ajouter la fonction suivante

/**
 * Get affirm js url
 *
 * @return string
 */
public function getAffirmJsUrl()
{
    $apiUrl = $this->getApiUrl();
    $parsedUrl = Mage::getModel('core/url')->parseUrl($apiUrl);
    $domain = $parsedUrl->getHost();
    $domain = str_ireplace('www.', '', $domain);
    $domain = str_ireplace('api.', '', $domain);
    $prefix = 'cdn1.';
    if (strpos($domain, 'sandbox') === 0) {
        $prefix = 'cdn1-';
    }
    return 'https://' . $prefix . '' . $domain . '/js/v2/affirm.js';
}
/**
 * Get affirm js text
 *
 * @return string
 */
public function getAffirmJs()
{
    $affirmJs = '<script type="text/javascript">
    if (!AFFIRM_AFFIRM.promos.getIsInitialized()) {
        AFFIRM_AFFIRM.promos.initialize("'.  $this->getApiKey() .'","'. $this->getAffirmJsUrl() .'");
    }
    if (!AFFIRM_AFFIRM.promos.getIsScriptLoaded()) {
        AFFIRM_AFFIRM.promos.loadScript();
    }
    </script>';
    return $affirmJs;
}

Voir les liens GitHub suivants :

• affirm.xml
• Données.php

3. Mise à jour de la messagerie promotionnelle d'Affirm

L'attribut HTML data-page-type de la messagerie promotionnelle Affirm vous permet de personnaliser les messages à l'avenir sans travail de développement. Par défaut, la pré-admissibilité est activée pour la messagerie promotionnelle sur les pages de produits, mais vous pouvez collaborer avec votre responsable de réussite client pour la modifier et configurer des personnalisations supplémentaires.

L'ajout de l'attribut data-page-type dépend de la version de l'extension que vous utilisez et si vous y avez ajouté un travail personnalisé. La meilleure façon d'ajouter l'attribut est de rechercher et de localiser les fichiers de modèles Magento qui utilisent affirm-as-low-as, affirm-product-modal, et affirm-site-modal pour afficher des messages promotionnels. Ajoutez l'attribut data-page-type correspondant au fichier modèle dans lequel le composant de messagerie promotionnelle est placé :

Les messages mensuels de paiement (affirm-as-low-as) affichent généralement des renseignements spécifiques au prix (nécessite un data-amount) et sont généralement utilisés avec les types de pages de données suivants :

• Catégorie
• Produit
• panier
• paiement

Puisque les modaux de site (affirm-site-modal) n'affichent pas des informations spécifiques au prix, ils sont généralement utilisés avec les types de pages de données suivants :

• page d'accueil
• bannière
• atterrissage
• Recherche

Si vous ne transmettez pas le data-page-type, le composant utilisera un paramètre par défaut.

4. Ajoutez la fonction Page de confirmation

Lorsqu'un client effectue son achat, vous pouvez envoyer ses renseignements de commande et de produit à Affirm pour les tests A/B, ce qui vous aidera à optimiser votre site. Envoyez ces informations en ajoutant la fonction Page de confirmation à votre page de confirmation de paiement. Nous avons seulement besoin de orderId, total, productId, et quantity pour les tests A/B.

1. Ouvrir MAGENTO_ROOT/app/design/frontend/base/default/layout/affirm/affirm.xml
2. Ajouter l'extrait en bas

<checkout_onepage_success> <!-- To add pixel for enhanced analytics -->
    <reference name="head" before="-">
        <block type="affirm/promo_pixel_confirm" name="affirm_pixel_javascript" template="affirm/promo/pixel/confirm.phtml"/>
    </reference>
</checkout_onepage_success>
<checkout_multishipping_success translate="label"> <!-- To add pixel for enhanced analytics -->
    <reference name="head" before="-">
        <block type="affirm/promo_pixel_confirm" name="affirm_pixel_javascript" template="affirm/promo/pixel/confirm.phtml"/>
    </reference>
</checkout_multishipping_success>

3. Ajouter https://github.com/Affirm/Magento_Af.../confirm.phtml à votre code

Voir les liens GitHub suivants :

• affirm.xml
• Notes d'engagement

5. Testez et mettez en direct

Testez votre développement de mise à niveau dans notre sandbox et assurez-vous que tous vos composants de messagerie promotionnelle Affirm s'affichent comme prévu. Veillez également à conserver une copie de votre magasin et de votre base de données Magento, afin de pouvoir revenir à la version précédente en cas de problème. Après les tests, connectez-vous à notre site en ligne :

1. Connectez-vous à votre tableau de bord commerçant en direct sur https://affirm.com/dashboard
2. Récupérez vos clés publiques et privées
3. Dans le panneau d'administration de Magento, allez à System > Configuration > Ventes > Modes de paiement > Affirm
4. Définissez Mode sur Production
5. Saisissez la clé API publique et la clé secrète (clé privée) que vous venez de récupérer sur le tableau de bord commerçant d'Affirm.

Après vous être connecté à notre environnement en direct, vous êtes prêt à être déployé dans votre environnement de production.