Usando Pesquisa de Aquisição

Configuração e Uso

Depois que a extensão Pesquisa de Aquisição for instalada e ativada, 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 do 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?

Exigir Resposta da Pesquisa: 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”, então, se esta for selecionada no Checkout, um novo campo de texto será exibido onde o usuário poderá 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 com ‘inativo’) que foram registrados com um pagamento:

Informações do Desenvolvedor

Pesquisa de Aquisição 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

// 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 );