Configuring advertising permissions
Note
This topic is for administrators and developers with administration access rights in Salesforce.
The Salesforce add-on supports the administration of advertising permissions for the marketing channels of print, email and text message in your Salesforce Org. It is also possible to import double opt-ins from Optimizely Campaign.
The configuration of advertising permissions consists of the following steps:
- Create Boolean reference fields (true/false) for the marketing channels you use (email, text message, print) for your leads, contacts, and personal account. The reference fields will later be displayed in the personal information of your leads, contacts, and personal accounts as check boxes (Advertising permission present or Advertising permission not present).
- In Salesforce, configure your Optimizely Campaign clients.
- Assign the created reference fields to an advertising permission with the corresponding marketing channel.
- Enable automatic import to import completed double opt-ins from Optimizely Campaign.
- Alternatively, you can assign double opt-ins manually.
configuring-advertising-permissions.mdxCreating reference fields
- Go to the Setup area in Salesforce.
- In the left menu bar, click Objects and Fields > Object Manager.
- In the Object Manager window, select the entity that you want to create a new reference field for, such as Contact.
- In the Object Manager window of the selected entity, click Fields & Relationships.
- Click New.
- In the New Custom field window, select the Checkbox option under Data Type.
- Click Next.
- Enter a name for the new field in the Field Label field, for example Newsletter.
- Under Default value, leave the option on Unchecked.
- The selected field name will automatically be added in the Field name field. Optionally, enter another field name.
- Optional: Enter a description in the Description field.
- Optional: Enter a help text in the Help Text field.
- Click Next.
- Configure the field level security according to your requirements.
- Click Next.
- Add the page layouts according to your requirements or remove unneeded page layouts.
- Click Save.
Repeat the steps for the other marketing channels you use and for the corresponding entities (leads, contacts, personal accounts).
Tip
Create identical fields for leads, contacts, and personal accounts. In this way, advertising permissions will be automatically transferred if a lead becomes a contact, for example. If you create different fields, you need to use Rules to transfer the advertising permission (such as from a lead that has become a contact).
configuring-advertising-permissions.mdxStoring client IDs and SOAP API user data
Note
If you do not have a SOAP API user account, contact customer support.
- Log in to Salesforce CRM.
- Open the Mandators (Episerver Campaign) tab.
- Click New to create an Optimizely Campaign client in Salesforce.
Tip
If you would like to change the settings of a previously created client, click the respective client and then Edit. The list views in Salesforce may hide clients. If necessary, click All in the list views.
- In the Optimizely Campaign Client window, specify the following fields:
- Name. Name of the client (as it should be displayed in Salesforce). You can chose the name freely. For greater clarity, use the same name as in Optimizely Campaign.
- Client ID. Client ID. To see the client ID, open the Optimizely Campaign menu and select Administration > API Overview > REST API.
- API User. Your SOAP API user name.
- Password. Your SOAP API password.
- Active. Select the check box.
- Click Save.
Repeat these steps for additional clients to connect to Salesforce CRM.
configuring-advertising-permissions.mdxAssigning reference fields
- Open the Opt-Ins (Episerver Campaign) tab.
- In the Opt-Ins (Episerver Campaign) window, click New.
- In the Configure advertising permission window, specify the following fields:
- Name. Name for the advertising permission (for example Product newsletter).
- Mandator. Optimizely Campaign client to which the advertising permission is to be assigned.
- Opt-In Type. In the drop-down list, select the marketing channel for which the advertising permission applies (for example Email).
- Reference field. In the drop-down list, select the reference field that you want to assign the advertising permission to (the Boolean field that you have created the advertising permission for, see Creating reference fields).
- Click Save.
configuring-advertising-permissions.mdxImporting opt-ins from Optimizely Campaign
- Select the check box Episerver Campaign Synchronization.
- In the DOI list Id field, enter the ID of the recipient list containing the double opt-ins. To see the recipient list ID, open the Optimizely Campaign menu and select Administration > API overview > Recipient lists.
- In the DOI process Id field, enter the ID of the opt-in process. To see the opt-in ID, open the Optimizely Campaign menu and select Administration > API overview > Opt-in processes.
- Click Save.
configuring-advertising-permissions.mdxManual assignment of double opt-ins
If a double opt-in advertising permission via Optimizely Campaign has not been assigned – because it has multiple contacts or leads for the same email address, for example – you need to assign it manually. Perform the following steps:
- Open the DOI Stage Objects (Episerver Campaign) tab.
The DOI Stage Objects (Episerver Campaign) window shows you the advertising permissions that were unable to be assigned automatically.
- To see detailed information about an advertising permission, click the unassigned advertising permission.
- To assign the advertising permission, click the downward-pointing triangle on the upper right.
- Select Assign DOI manually in the drop-down list.
- Under Select Contact or Lead, search for the person to whom you want to assign the double opt-in advertising permission.
- Click Assign DOI.
Repeat the steps for every advertising permission that has not been assigned.
Tip
Check regularly whether marketing permissions are unable to be assigned and then assign them manually. This keeps your database updated at all times.