Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

License Plan/Edition

AMS

Campaigns

Version

2.151 and higher

Challenge

Defining relevant Contacts per Campaign and display displaying them later on offer and invoice PDFs.

...

Solution

The Contact Wizard helps users to select the right contacts for their campaigns quickly. It shows only the contacts related to the involved accounts. The selected contacts are displayed afterwards at the corresponding media campaign in the related list Campaign Contacts.

...

list of Campaign Contacts.

Table of Contents
minLevel2
maxLevel6
outlinefalse
typelist
printablefalse

Create or Open a Media Campaign

Working with the Contact Wizard expects you to have a Media Campaign created already. If you did are not familiar with Media Campaigns please refer to this Wiki article: 1.1.5 Create a Media Campaign

The Media Campaign contains different Account lookups, that should be used in order to select Contacts in the Contact Wizard.Select a Media Campaign and select all relevant Account lookups:

  1. Navigate to an existing Media Campaign. Otherwise, you have to create one first.

  2. Please select Accounts for the following lookup fields:

    • Account (Advertiser)

    • Agency

    • Beneficiary

    • Debtor (formerly Invoice Recipient)

    • Intermediary

    • Postal Recipient

  3. Click the button Save.

If a lookup is not used, the user can skip that lookup. In this case, the Contact Wizard does not show any contacts, that can be selected.

Open the Contact Wizard

To open the wizard go to the Media Campaign where you would like to assign Campaign Contacts. Open the actions menu and hit the action “Contact Wizard“.

Info

If you can not see the action please contact your administrator to add the right action to the layout.

...

The Campaign Contact Wizard helps users to add new campaign contacts to an existing media campaign. It only displays those contacts assigned to the Media Campaigns Accounts. 

...

You can see a tab at the top of the page for every Account type that was set in the Media Campaign.

...

In addition to that you can select Contacts as Quote Contact or Invoice Contact in the list on the right so that they will be shown on your offer or invoice PDFs. Your system administrator is able to can customize, which contact should be displayed in which order on the PDF document. Further information can be found in the Setup section below.

After setting up all the details you can hit the Save button in the upper right corner.

The Campaign Contacts can be found in the related list “Campaign Contacts“ of your Media Campaign afterwards.

...

Setup

Please add the Contact Wizard action to the page layout of the Media Campaign. You can differentiate between the old and new Wizard by the their name. The Lightning Contact Wizard action has the name “LwcContactWizard“LwcContactWizard.

Customize the Contact Wizard

You can adjust the Contact Wizard to show different information per Contact record in the list on the right left and you can define the list on the right to show additional columns based on the Contact records.

To do so please refer to the following Feature Setting:

Feature Setting Name

ContactSettings

Feature Name

ContactWizardLightning

Value

Default:

{"ContactField":"Department","AdditionalColumns":[]}

Explanation:

  • The Contact Field can be set to any Contact related field and refers to the subheading below each Contact in the list on the

right
  • left.

  • The Additional Columns can also be defined by any Contact field to show additional information in the table on the right of the Wizard. To edit it you can add a comma-separated list of API names.

Example:

{"ContactField":"Department","AdditionalColumns":["Department","Email","Phone"]}

Campaign Contacts on Offer and Invoice documents

To customize which in which order contacts are displayed at the address block (1st page at PDF) or the contact information (2nd Page at PDF) please follow the steps below.

  1. Navigate to App Launcher > Quote Preferences or App Launcher > Invoice Preferences and select the corresponding record.

  2. Edit the settings for Address Block (1st Page) and Contact Information (2nd Page).

    • Default: The default changes all picklists to default.

    • Not selected: This field is not used for the order.

    • Possible Picklist Values: 

      • Quote Preferences: 

        • Address Block (1st Page): Account, Agency, Beneficiary, Intermediary, Debtor, Postal Recipient

        • Contact Information (2nd Page): Account, Agency, Beneficiary, Intermediary / Owner, Debtor, Postal Recipient

      • Invoice Preferences: 

        • Address Block (1st Page): Account, Agency, Beneficiary, Intermediary, Debtor, Postal Recipient

        • Contact Information (2nd Page): Account, Agency, Beneficiary, Intermediary / Sales Representative / Owner, Debtor, Postal Recipient

  3. Click the button Save.

...

Info

Contacts can be mapped using the Mapping BA from Media Campaign to Invoice.

Info

The ADvendio default is:

  • Quote Preferences: 

    • Address Block (1st Page): Postal Recipient, Debtor, Agency, Advertiser

    • Contact Information (2nd Page): Account,  Debtor, Agency, Intermediary / Owner (Quote Preferences)

  • Invoice Preferences: 

    • Address Block (1st Page): Postal Recipient, Debtor, Agency, Advertiser

    • Contact Information (2nd Page): Account, Debtor, Agency, Intermediary / Sales Representative / Owner (Invoice Preferences)

Activating Contact Wizard Lightning

Info

In case you are using Salesforce's Lightning version, but are still seeing the classic view for Contact Wizard, you need to activate the Contact Wizard by adding another Action of Contact Wizard (Action with Name LwcContactWizard) to the page layout setup (steps below).

To activate the Contact Wizard Lightning view, follow these step-by-step instructions:

  1. Go to "Setup" and click on the "Object Manager" tab.

  2. Under the "Object Manager" tab, find and access "Media Campaign."

  3. Within the "Media Campaign" tab, navigate to the "Page Layouts" tab and click on "Media Campaign Layout."

  4. In the "Media Campaign Layout," go to the upper menu and select the "Mobile & Lightning Actions" tab.

  5. In the "Quick Find" search bar, look for the "Contact Wizard" button with the Name:

    Code Block
    ADvendio__MediaCampaign__c.ADvendio__LwcContactWizard
  6. Drag and drop this "Contact Wizard" button under the "Salesforce Mobile and Lightning Experience Actions" section.

  7. In the upper left corner, click "Save" to complete your changes.

...

Contact Wizard Filtering Feature

With 2.169 we have added a new feature that allows you to filter out inactive contacts.

To use this feature, in the Administration Settings tab ensure that you have enabled "Filter for active Records".

Once enabled, the new checkbox field called "Left Company" will be evaluated on the Contact Object. This field is set to "false" by default, but if you want to filter out inactive contacts, simply set it to "true".

If you miss enabling the "Filter for active Records" setting, the feature won't work as expected.

Info

To enable the feature, navigate to Administration Settings > Administration Settings tab > Enable "Filter for active records".

...