Client Management
      Back to home
      1. Phonexa Support Center
      2. LMS Sync & Call Logic
      3. Client Management

      Buyer Disposition

      Learn how to review and control the quality of leads and optimize the return process with the help of the Buyer Disposition function.

      The Buyer Disposition feature allows Buyers to ping the dispositions back to the system to review and control lead quality and optimize the lead return process.

      Buyer Disposition Ping Back feature

      Buyer Real Time Dispositions Report

      Buyer Real Time Dispositions: Lead Search Tab

      Buyer Real Time Dispositions: Disposition Import Tab

      Buyer Disposition Ping Back feature

      The “Disposition Ping Back” feature allows Buyers to set and update the lead disposition via API.

      Use Case:

      A Buyer has purchased a lead from Phonexa and pings the Disposition for purchased leads back to the system. Based on the Disposition, additional checks and verification could be performed, e.g., checking the quality of the lead by verifying the lead data and contacting the lead. Lead QC Disposition and comment can be added by system users in addition to the Disposition sent by Buyer. Read more about QC Dispositions in this Knowledge Base article.

      To enable the Disposition Ping Back feature, go to the Client Management > Buyer List section, select the Buyer, and click the “Settings” button in the “Action” column. On the Buyer’s Setup page, select the “Integrations” tab and turn “ON” the “Disposition Ping Back” toggle.

      The API ID and API Key are automatically generated by the system.

      To view the Buyer Disposition API documentation, click the “Doc” button in the “Action” column, and then select the option from the drop-down list in the “Product” field. Note: API settings are different for each Product.

      To view the current API Key, click the “Show” button in the “API Key” column. Click the “Yes” button in the “Show API Key” pop-up window to confirm the action.

      To change the current API Key, click the “Change API Key” button in the “Action” column. Click the “Yes” button in the “Change API Key” pop-up window to confirm the action.

      The “Add Do/Do Not Present Lists” feature allows you to add lead data to the Do or Do Not Present Lists based on the buyer lead disposition. Read more about this feature in the Knowledge Base article.

      To manage the available disposition statuses on the Product level, go to the System Management > Products section, select the Product, click the “Settings” button in the “Actions” column, and select the Disposition Statuses > Buyer Real Time Disposition Statuses subtab.

      The list of Buyer Disposition statuses contains the following information:

      • Name: The name of the Buyer Disposition status.

      • Status: The current status of the Buyer Disposition.

      • Scenario: The type of the Buyer Disposition case (the disposition was qualified as positive, negative, or neutral).

      • Visible in API: The visibility of the field in the API Doc.

      To change the current status of the Buyer Disposition, click the “Edit” button in the “Action” column. Change the information in the following fields from the “Edit” pop-up window:

      • Name: Enter the name of the Buyer Disposition.

      • Status: Select the current status of the Buyer Disposition.

      • Case: Select the corresponding scenario for the Buyer Disposition.

      • Visible in API: Select the visibility of the field in the API Doc.

      Click the “Save” button to complete the changes.

      Note: The edit option is allowed only for the custom disposition statuses. Pre-set system disposition statuses can not be edited.

      To set the visibility of the disposition statuses in the Publisher’s Lead Details report for users with the Publisher, Publisher Agent, or Publisher Senior Agent system roles, click the “Buyer Disposition Visibility for Publisher” button and select the option in the “Publisher related roles can see Buyer Disposition” field of the “Buyer Disposition Visibility for Publishers” pop-up window:

      • Not visible: The status of the Buyer Disposition will be hidden.

      • Sold leads only: The status of the Buyer Disposition will be displayed only for leads with the “Sold” status. For leads with the set Buyer Disposition but another status of the lead, the “Not Set” status will be displayed.

      • All leads: The status of the Buyer Disposition will be displayed for all leads.

      Click the “Save” button to complete the action.

      Buyer Real Time Dispositions Report

      The Buyer Real Time Dispositions report allows you to import the disposition data into the system manually, view the detailed information about the dispositions posted by buyers via the Disposition Ping Back feature, and search leads to add disposition manually.

      To view the report, go to the Analytics and Optimization > Dispositions >Buyer Real Time Disposition section.

      On the “Buyer Real Time Disposition” tab, you can review leads with assigned Buyer Disposition, as well as QC disposition and comment. Note: This report will only present leads with the Dispositions added. The report will present the “No records found” message if there are no leads with disposition added matching the selected filters.

      You can narrow down the search results by using the following filters:

      • Date: Select the date range of the report.

      • Email: Enter an email or a list of email addresses of the Leads. (LMS Only)

      • Phone Number: Enter a phone number or a list of phone numbers of the Leads. (Call Logic Only)

      • Buyer Agent: Select the Buyer Agent.

      • Buyer: Select the Buyer.

      • Buyer Campaign: Select the Buyer Campaign.

      • Campaign Tag: Select the Campaign Tag.

      • Status: Select the status of the Lead.

      • Product: Select the Product.

      • Publisher: Select the Publisher.

      • QC Disposition: Select the QC Disposition status.

      • Buyer Disposition: Select the Buyer Disposition status.

      Click the “Search” button to generate the report.

      The report contains the following information:

      • Lead ID: The unique identification number of the Lead. To open the Lead Info section of the particular Lead, click the “Lead ID” button.

      • Date: The date and time when the Lead has entered the system.

      • Buyer: The name of the Buyer.

      • Campaign: The name of the Campaign.

      • Publisher: The name of the Publisher.

      • Email: An email address of the Lead.

      • First Name: The first name from the Lead data.

      • Last Name: The last name from the Lead data.

      • Home#: The home phone number from the Lead data.

      • Work#: The work (business) phone number from the Lead data.

      • Cell#: The mobile phone number from the Lead data.

      • Pub: The earnings of the Publisher.

      • TTL: The total revenue of the system.

      To set up the QC (Quality Control) Disposition for the Lead, click the “Edit Disposition” button in the “QC Disposition” column, select the “Disposition” option from the drop-down list in the pop-up window, and click the “Save” button to complete the action.

      To add a comment to the QC(Quality Control) Disposition status, click the “Edit QC Comment” button in the “QC Comment” column, enter the text in the “Comment” field of the pop-up window, and click the “Save” button to complete the action.

      To edit or delete an existing comment, click the “Edit System Comment” button in the “QC Comment” column, edit an existing comment in the “Comment” field of the pop-up window, and click the “Save” button to complete the action.

      To set the status of the Buyer’s Disposition, click the “Edit Buyer Disposition” button in the “Buyer Disposition” column, select the option from the “Disposition” drop-down list in the pop-up window, and click the “Save” button to complete the action.

      To add, edit, or delete a comment to the Buyer’s Disposition status, click the “Edit Buyer Comment” button in the “Buyer Comment” column, enter the text in the “Comment” field in the pop-up window, and click the “Save” button to complete the action.

      To import the data from the CSV file, click the “Import CSV” button and fill the information in the following fields of the “Import CSV” pop-up window:

      • Product: Select the Product.

      • Get Buyer and Campaign from CSV file: Check the box to import the data to the “Buyer” and the “Campaign” fields from the CSV file. If the checkbox is marked, the corresponding fields will be inactive for selection.

      • Buyer: Select the Buyer.

      • Campaign: Select the Campaign.

      • Time Zone: Select the timezone.

      • CSV File: Select the file with the data you would like to upload. Please, follow the requirements for the CSV file format:

        • It is required to follow the specified column order - Date, Lead Id, Email, Buyer Disposition, Buyer Comment. If the “Get Buyer and Campaign from CSV file” checkbox is marked, the column order will be: Buyer, Campaign, Date, Lead Id, Email, Buyer Disposition, Buyer Comment.

        • You need to remove the headers from your table; the import data should start from the first row.

        • Otherwise, the system will answer with the “Error” status. You can view the error logs in the “Disposition” tab of the current section.

      Click the “Import” button to start the data import to the system.

      To download a sample of the CSV file with the appropriate format, click the “Download a sample file” button.

      Buyer Real Time Dispositions: Lead Search Tab

      The “Lead Search” tab allows you to find Leads in the system according to the selected filters and manually set up the Buyer’s and QC Disposition, which will be available for review in the “Buyer Real Time Disposition” tab.

      You can search for leads by using the following filters:

      • Date: Select the date range of the report.

      • Email: Enter an email or a list of email addresses of the Leads. (LMS Only)

      • Phone Number: Enter a phone number or a list of phone numbers of the Leads. (Call Logic Only)

      • Buyer Agent: Select the Buyer Agent.

      • Buyer: Select the Buyer.

      • Buyer Campaign: Select the Buyer Campaign.

      • Status: Select the status of the Lead.

      • Product: Select the Product.

      • Publisher: Select the Publisher.

      • QC Disposition: Select the QC Disposition status.

      • Buyer Disposition: Select the Buyer Disposition status.

      Click the “Search” button to generate the report.

      Buyer Real Time Dispositions: Disposition Import Tab

      The “Disposition Import” tab allows you to import CSV files with the Leads disposition data to the system and review the status of the imported files.

      To import the data from the CSV file, click the “Import CSV” button and fill the information in the following fields of the “Import CSV” pop-up window:

      • Product: Select the Product.

      • Get Buyer and Campaign from CSV file: Check the box to import the data to the “Buyer” and the “Campaign” fields from the CSV file. If the checkbox is marked, the corresponding fields will be inactive for selection.

      • Buyer: Select the Buyer.

      • Campaign: Select the Campaign.

      • Time Zone: Select the timezone.

      • CSV File: Select the file with the data you would like to upload. Please, follow the requirements for the CSV file format:

        • It is required to follow the specified column order - Date, Lead Id, Email, Buyer Disposition, Buyer Comment. If the “Get Buyer and Campaign from CSV file” checkbox is marked, the column order will be: Buyer, Campaign, Date, Lead Id, Email, Buyer Disposition, Buyer Comment.

        • You need to remove the headers from your table; the import data should start from the first row.

        • Otherwise, the system will answer with the “Error” status. You can view the error logs in the “Disposition” tab of the current section.

      Click the “Import” button to start the data import to the system.

      The list of the import tasks contains the following information:

      • ID: The unique identification number of the record.

      • File: The name of the file.

      • Creation Time: The date and time of the import task creation.

      • Execution Time: The date and time of the import task finalization.

      • Requested by User: The name of the user that has processed the import operation.

      • Product: The name of the Product.

      • Buyer: The name of the Buyer.

      • Campaign: The name of the Campaign.

      • Time Zone: The time zone that has been selected upon the import.

      • Status: The current status of the import task.

      To check the error logs in case of an unsuccessful import operation, click the “Error Log” button in the “Action” column, and you will be redirected to the “Error Log” section.

      The logs records contain the following information:

      • Creation Time: The date and time of the log record creation.

      • Row Number: The number of the row with the wrong data format.

      • Row Content: The fragment of the data with the wrong format.

      • Error Message: The type of error.

      To cancel the import task operation that is currently processing (the current value in the “Status” column is “Pending”), click the “Abort” button in the “Action” column.

      Enter the “Yes” word in the “Type “Yes” to abort the export task” field of the “Abort” pop-up window, and click the “Abort” button to complete the action.

      The import task will be logged in the report with the “Aborted” status in the “Status” column.

      You can narrow down the search results by using the following filters:

      • ID: Enter the unique identification number of the record.

      • File: Enter the name of the file.

      • Creation Time: Select the date range of the report.

      • Requested by User: Select the name of the user that has imported the file.

      • Buyer: Select the Buyer.

      • Campaign: Select the Campaign.

      • Status: Select the current status of the import task operation (Aborted, Error, Pending, Processing, Success).

      Click the “Search” button to generate the report.