# Usando o Pesquisa de Aquisição Configuração e Uso --------------- Depois que a extensão [Pesquisa de Aquisição](https://easydigitaldownloads.com/downloads/acquisition-survey/) estiver [instalada e ativada](https://easydigitaldownloads.com/docs/how-do-i-install-an-extension/), você pode navegar para ***Downloads → Configurações → Extensões → Pesquisa de Aquisição*** para ajustar suas configurações. Com essas configurações, você pode gerenciar o Rótulo para o menu suspenso no checkout, se o campo é obrigatório para o cliente e se você deseja mostrar/ocultar este formulário para clientes existentes. **Título da Pesquisa:** Este é o título que aparecerá acima da lista suspensa. *Exemplo: Como você nos conheceu?* **Resposta da Pesquisa Obrigatória:** Escolha se uma resposta à pergunta da pesquisa é obrigatória ou não. **Clientes Existentes:** Por padrão, isso está ativado, portanto, será exibido para todos os usuários. Se você desativar isso, o formulário não será exibido para um usuário que esteja logado no site. **Métodos de Aquisição:** A lista é pré-preenchida com alguns dos métodos de aquisição mais comuns, mas pode ser reordenada e ter itens adicionados ou removidos de acordo com suas necessidades. Se você tiver a opção "Outro", se esta for selecionada no Checkout, um novo campo de texto será exibido onde o usuário pode digitar sua mensagem manualmente. O resultado é um novo elemento de formulário na seção 'Informações Pessoais' da tela de checkout: Você também pode ver qual método de aquisição foi registrado ao visualizar pedidos em ***Downloads > Pedidos***. As informações de aquisição estarão disponíveis na seção **Extras do Pedido** de cada registro de pedido. Relatórios --------- A Pesquisa de Aquisição também adiciona um novo relatório à seção de relatórios, para que você possa obter um detalhamento de como suas fontes de aquisição estão performando. Para visualizar relatórios, navegue até ***Downloads > Relatórios*** e escolha 'Aquisição' nas opções do lado esquerdo. A visualização do relatório lista todos os métodos atuais e passados (identificados como 'inativo') que foram registrados com um pagamento: Informações do Desenvolvedor -------------- A [Pesquisa de Aquisição](https://easydigitaldownloads.com/downloads/active-campaign/) oferece várias funções e filtros que permitem sua extensão. Os métodos de aquisição registrados são armazenados nos metadados do pedido com a 'meta\_key' de **\_edd\_payment\_acquisition\_method**. Você pode recuperar o valor do método de aquisição para um pedido com a chamada: ``` edd_get_order_meta( $order_id, '_edd_payment_acquisition_method', true ); ``` Se o usuário escolheu o método Outro durante o Checkout e digitou um texto personalizado, os dados são armazenados nos metadados do pedido **\_edd\_payment\_acquisition\_method\_other**. #### Filtros ``` // Este filtro o array de métodos de aquisição após serem retornados do banco de dados. Os métodos estão na forma de um array indexado numericamente.<br></br>apply_filters( 'edd_acq_get_methods', get_option( 'edd_acq_methods', array() ) );<br></br><br></br>``` // Exemplo<br></br>array(1) {<br></br> array(2) {<br></br> 'name' => 'Nome de Exibição para o Cliente',<br></br> 'value' => 'registro-de-metadados-de-pagamento'<br></br> }<br></br>}<br></br> ```<br></br><br></br>// Executado pouco antes de salvar o método de aquisição nos metadados do pedido.<br></br>apply_filters( 'edd_acq_record_acquisition_method', $acquisition_method, $payment_id, $payment_data );<br></br><br></br><br></br>// Executado pouco antes de retornar o número de vendas para um 'valor' de método de aquisição solicitado.<br></br>apply_filters( 'edd_acq_method_sales', (int) $sales, $method );<br></br><br></br>// Executado pouco antes de retornar os ganhos totais para um 'valor' de método de aquisição solicitado.<br></br>apply_filters( 'edd_acq_method_earnings', $earnings, $method );<br></br> ```