# Using Acquisition Survey

Setup and Usage
---------------

Once the [Acquisition Survey](https://easydigitaldownloads.com/downloads/acquisition-survey/) extension is [installed and activated](https://easydigitaldownloads.com/docs/how-do-i-install-an-extension/), you can navigate to ***Downloads → Settings → Extensions → Acquisition Survey*** to adjust your settings.

![](https://easydigitaldownloads.com/wp-content/uploads/2022/01/acquisition-survey-settings-800x809.png)With these settings, you can manage the Label for the dropdown on checkout, if the field is required by the customer, and if you want to show/hide this form for existing customers.

**Survey Title:** This is the title that will appear above the dropdown list. *Example: How did you hear about us?*

**Require Survey Response:** Choose whether or not a response to the survey question is required.

**Existing Customers:** By default, this is enabled, so it will show for all users. If you toggle this off, the form will not show for a user who is logged in on the site.

**Acquisition Methods:** The list is pre-populated with some of the more common methods of acquisition, but can be re-ordered and have items added or removed according to your needs. If you have the option &quot;Other&quot; then if this is selected on Checkout, a new text field will be displayed where the user can type in their message manually.

The result is a new form element on the &#039;Personal Info&#039; section of the checkout screen:

![](https://easydigitaldownloads.com/wp-content/uploads/2022/07/6184cce9ac904.png)You can also see which acquisition method was recorded when viewing orders under ***Downloads &gt; Orders***. The acquisition information will be available in the **Order Extra** section of each order record.

![](https://easydigitaldownloads.com/wp-content/uploads/2022/01/acquisition-order-extras.png)Reporting
---------

Acquisition Survey also adds a new report to the reports section, so you can get a breakdown of how your acquisition sources are performing.

To view reports, navigate to ***Downloads &gt; Reports*** and choose &#039;Acquisition&#039; from the left side options.

The report view lists all current and past (identified with &#039;inactive&#039;) methods that have been registered with a payment:

![](https://easydigitaldownloads.com/wp-content/uploads/2022/01/acquisition-reports-800x305.png)Developer Info
--------------

[Acquisition Survey](https://easydigitaldownloads.com/downloads/active-campaign/) offers several functions and filters that allow it to be extended.

Recorded acquisition methods are stored in the order meta with the &#039;meta\_key&#039; of
**\_edd\_payment\_acquisition\_method**.

You can retrieve the acquisition method value for an order with the call:

```
edd_get_order_meta( $order_id, &#039;_edd_payment_acquisition_method&#039;, true );
```

If the user has chosen the Other method during Checkout and typed in a custom text, the data is stored in the **\_edd\_payment\_acquisition\_method\_other** order meta.

#### Filters

```
// This filters the array of acquisition methods after they are returned from the database. Methods are in the form of a numerically indexed array.&lt;br&gt;&lt;/br&gt;apply_filters( &#039;edd_acq_get_methods&#039;, get_option( &#039;edd_acq_methods&#039;, array() ) );&lt;br&gt;&lt;/br&gt;&lt;br&gt;&lt;/br&gt;```
// Example&lt;br&gt;&lt;/br&gt;array(1) {&lt;br&gt;&lt;/br&gt;	array(2) {&lt;br&gt;&lt;/br&gt;		&#039;name&#039;  =&gt; &#039;Customer Facing Name&#039;,&lt;br&gt;&lt;/br&gt;		&#039;value&#039; =&gt; &#039;payment-meta-record&#039;&lt;br&gt;&lt;/br&gt;	}&lt;br&gt;&lt;/br&gt;}&lt;br&gt;&lt;/br&gt;
```&lt;br&gt;&lt;/br&gt;&lt;br&gt;&lt;/br&gt;// Runs just before saving the acquisition method into the order meta.&lt;br&gt;&lt;/br&gt;apply_filters( &#039;edd_acq_record_acquisition_method&#039;, $acquisition_method, $payment_id, $payment_data );&lt;br&gt;&lt;/br&gt;&lt;br&gt;&lt;/br&gt;&lt;br&gt;&lt;/br&gt;// Runs just before returning the number of sales for a requested acquisition method &#039;value&#039;.&lt;br&gt;&lt;/br&gt;apply_filters( &#039;edd_acq_method_sales&#039;, (int) $sales, $method );&lt;br&gt;&lt;/br&gt;&lt;br&gt;&lt;/br&gt;// Runs just before returning the total earnings for a requested acquisition method &#039;value&#039;.&lt;br&gt;&lt;/br&gt;apply_filters( &#039;edd_acq_method_earnings&#039;, $earnings, $method );&lt;br&gt;&lt;/br&gt;
```