Skip to content

companies_overview.rst

Latest commit

 

History

History
222 lines (128 loc) · 7.66 KB

companies_overview.rst

File metadata and controls

222 lines (128 loc) · 7.66 KB
Raw

Companies

Companies are a way to group Contacts based on association with organizations.

Mautic Company Overview

Engagements/Points chart

Engagements shown on the chart include any tracked action the Contacts made. Some examples might include page hits, Form submissions, Email opens and so on. The engagements line chart displays how active the Contacts of the Company were in the past 6 months. The chart displays also the sum of Points the Contacts received.

List of Contacts assigned

You can find a table with the list of the assigned Contacts displaying the date of their last activity, preceding the information of the Company which includes the Company name, address, and all the custom Company fields, and the engagement chart. This is good way to have a view of the recent activity of the Contacts you know in this Company.

Company duplicates

The Company name field is a unique identifier by default. You can choose any other Company field as unique identifier in the Custom Fields section.

In Configuration > Company Settings you can choose the operator used when merging Companies with multiple identifiers - either AND or OR.

Setup operator for find duplications algorithm

These settings allow Mautic to find and merge duplicate Companies during the import, using the Integrations Framework and in other parts of Mautic.

Company actions

Merging Companies

When editing a Company, you can merge this Company into another existing Company by using the Merge button.

Search for the Company you wish to merge into, then click to start the merge. Contacts associated with the merged Companies now become associated with the remaining Company.

After completion of the merge process, Mautic redirects you to the remaining Company, as the old Company no longer exists.

Company Custom Fields

By default, a set of fields exist for Companies, but you can customize these fields to meet your needs.

  1. Go to Custom Fields and create a new field
  2. Change the dropdown select box from Contact to Company objects
  3. Save the Custom Field

Company Segments

Company Segments let you group Companies based on shared attributes or criteria for targeted Account-Based Marketing - ABM. Use Company Segments to organize Companies for Campaign targeting, reporting, and bulk operations.

For detailed information on creating and managing Company Segments, see :doc:`Company Segments</companies/company_segments>`.

Contact Segments based on Company fields

You can also create Contact Segments based on Company data. Select any Company field to filter with and the matching criteria for it, and Mautic lists any Contacts that match the selected fields in the Segment. This groups Contacts by their associated Company attributes.

Identifying Companies

Mautic identifies Companies strictly through a matching criteria based on Company Name, City, Country or State. If a city or a country isn't delivered as an identifying fields to identify a Contact, the Company won't match.

Company actions in Campaigns

It's possible to add a Contact to a new Company based on a Campaign action.

Creating and managing Companies

To create or manage Companies, go to the Companies menu identified by the building icon in the left hand navigation. In this area you can create, edit, or delete Companies.

Deleting Companies

Deleting a Company updates the Contact-Company relationships for all Contacts associated with that Company:

  • If a Contact has multiple Companies, Mautic assigns the most recently attached Company as the new primary Company.
  • If a Contact has only that Company, the Contact no longer has any Company association.

A confirmation dialog explains this behavior before you delete a Company or multiple Companies.

Renaming a Company

When you rename a Company, Mautic updates the displayed Company name on every Contact that has it as their primary Company. Contacts that have the Company assigned but not as their primary Company keep their existing displayed Company name, since that name comes from their own primary Company.

Processing Company updates in the background

By default, Mautic applies Company renames and deletions to the related Contacts immediately, within the same request. On instances with a large number of Contact-Company relationships, this can slow down editing or deleting a Company.

To run this work in the background instead, add the following option to your config/local.php file:

'update_company_mapping_data_in_background' => true,

When you turn on this option, Mautic no longer updates the related Contacts during the request. Instead, you run two commands - typically as Cron jobs - to apply the changes:

  • mautic:company:update_lead_company updates the Company name on Contacts after you rename a Company.
  • mautic:company:delete_company_leads reassigns the primary Company and removes the Company references on Contacts after you delete a Company.

Each command processes all pending Companies by default. To limit a run to a single Company, pass its ID with the --company-id option.

Assigning Companies to Contacts

There are different ways to assign a Company to a Contact as explained below:

Contact profile

You can assign a Contact to Companies in the Contact's profile, while creating or editing an existing Contact. Mautic considers the latest Company assigned as the primary Company for the Contact.

Contacts list view

You can batch assign Companies to selected Contacts in the Contact's list view.

Via a Campaign

You can assign a Company to identify Contacts through a Campaign by selecting the Assign Contact to Company action.

Through a Form

When identifying a Contact through a Form, you can also associate an existing Company or create a new one if:

  • The Form includes Company name as a Form Field - mandatory for Company matching/creation,
  • The Form includes City as a Form Field - mandatory for Company matching/creation,
  • The Form includes Country as a Form Field - mandatory for Company matching/creation,
  • The Form includes State as a Form Field - optional for Company matching/creation.

Company scoring

It's possible to change the Company score through a Campaign action or a Form action. When using these actions, it's necessary to identify the Contact first, and then alter the score of the Companies assigned to that Contact.

  1. Select the Change Company score action in either a Form or a Campaign
  2. Once submitted or triggered, Mautic identifies Companies in the Campaign or Form to change their score.

Setting the primary Company

You can set the primary Company through the Contact details interface.

Screenshot showing setting the primary Company