Configuration et utilisation
Une fois l'extension Acquisition Survey installée et activée, vous pouvez accéder à Téléchargements → Paramètres → Extensions → Acquisition Survey pour ajuster vos paramètres.

Avec ces paramètres, vous pouvez gérer l'étiquette du menu déroulant lors du paiement, si le champ est obligatoire pour le client, et si vous souhaitez afficher/masquer ce formulaire pour les clients existants.
Titre de l'enquête : C'est le titre qui apparaîtra au-dessus de la liste déroulante. Exemple : Comment avez-vous entendu parler de nous ?
Réponse à l'enquête requise : Choisissez si une réponse à la question de l'enquête est obligatoire ou non.
Clients existants : Par défaut, cette option est activée, elle s'affichera donc pour tous les utilisateurs. Si vous désactivez cette option, le formulaire ne s'affichera pas pour un utilisateur connecté sur le site.
Méthodes d'acquisition : La liste est pré-remplie avec certaines des méthodes d'acquisition les plus courantes, mais peut être réorganisée et des éléments peuvent être ajoutés ou supprimés selon vos besoins. Si vous avez l'option « Autre », alors si elle est sélectionnée lors du paiement, un nouveau champ de texte s'affichera où l'utilisateur pourra taper son message manuellement.
Le résultat est un nouvel élément de formulaire dans la section « Informations personnelles » de l'écran de paiement :

Vous pouvez également voir quelle méthode d'acquisition a été enregistrée en consultant les commandes sous Téléchargements > Commandes. Les informations d'acquisition seront disponibles dans la section Informations supplémentaires de la commande de chaque enregistrement de commande.

Rapports
Acquisition Survey ajoute également un nouveau rapport à la section des rapports, vous permettant d'obtenir une répartition des performances de vos sources d'acquisition.
Pour afficher les rapports, accédez à Téléchargements > Rapports et choisissez « Acquisition » parmi les options du côté gauche.
La vue du rapport liste toutes les méthodes actuelles et passées (identifiées comme « inactives ») qui ont été enregistrées avec un paiement :

Informations développeur
Acquisition Survey offre plusieurs fonctions et filtres qui permettent de l'étendre.
Les méthodes d'acquisition enregistrées sont stockées dans les métadonnées de la commande avec la « meta_key »
_edd_payment_acquisition_method.
Vous pouvez récupérer la valeur de la méthode d'acquisition pour une commande avec l'appel :
edd_get_order_meta( $order_id, '_edd_payment_acquisition_method', true );
Si l'utilisateur a choisi la méthode Autre lors du paiement et a saisi un texte personnalisé, les données sont stockées dans les métadonnées de commande _edd_payment_acquisition_method_other.
Filtres
// This filters the array of acquisition methods after they are returned from the database. Methods are in the form of a numerically indexed array.
apply_filters( 'edd_acq_get_methods', get_option( 'edd_acq_methods', array() ) );// Example
array(1) {
array(2) {
'name' => 'Customer Facing Name',
'value' => 'payment-meta-record'
}
}
// Runs just before saving the acquisition method into the order meta.
apply_filters( 'edd_acq_record_acquisition_method', $acquisition_method, $payment_id, $payment_data );
// Runs just before returning the number of sales for a requested acquisition method 'value'.
apply_filters( 'edd_acq_method_sales', (int) $sales, $method );
// Runs just before returning the total earnings for a requested acquisition method 'value'.
apply_filters( 'edd_acq_method_earnings', $earnings, $method );
