Administration and setup FAQ

Applies to Dynamics 365 (online), version 9.x

Read this topic to find answers to common questions and solutions to known issues that can sometimes occur during the initial setup and ongoing administration of Dynamics 365 for Marketing.

Why is my instance (organization) incompatible with Marketing?

Your tenant might have several different types of instances (also called organizations) installed on it, including some that are full Dynamics 365 instances and others that are, for example, Power Apps instances (also called environments) that include many components of Dynamics 365, but not all of the components required by Marketing.

When you are setting up your Marketing app, the setup wizard asks you to choose an organization on which to install the app, and the organization selector might show both full Dynamics 365 instances and the lighter Power Apps instances if they are present. You must choose an instance that includes a full Dynamics 365 installation. If you see an error telling you that this application isn't compatible with the platform of your selected Dynamics 365 organization, then make sure you have a full Dynamics 365 organization available (where you want to install Marketing) and choose that one instead.

Why can't I install Marketing in my country/region?

Dynamics 365 for Marketing is a relatively new app for the Dynamics 365 platform, so it is not yet supported in all countries/regions where Dynamics 365 is available. If you are located outside of a supported country/region, then the setup wizard will prevent you from setting up the product, even if the Admin center shows that a Marketing app is available on your tenant. The reason you see the unconfigured app on your tenant is probably because you've licensed a Dynamics 365 product or bundle that includes it—you'll be able to set it up as soon as support for the product is extended to your country/region.

These geographical restrictions apply both to trial and production versions of Dynamics 365 for Marketing.

To read the latest list of countries/regions where you can use Dynamics 365 for Marketing, download the Microsoft Dynamics 365 International Availability document (PDF).

Why do I need a new portal, and how can I get one?

Dynamics 365 for Marketing requires a dedicated Dynamics 365 portals solution for running marketing pages and event portals. A free portal app is included with Dynamics 365 for Marketing, so usually this won't be an issue, but you can only have one free portal per Office 365 tenant. Some other Dynamics 365 apps also include a free portal, so you might already have a configure-free portal on your tenant. The Marketing setup wizard will let you know if you need a new portal app.

If you don't have any unconfigured free or paid portals available, you have two options:

  • Recycle an existing portal.
    If you have a portal that you aren't using, you can request to have it reverted to an unconfigured portal and then run the Marketing setup wizard to set it up for use with Marketing. Please contact Microsoft Support Microsoft Support for assistance with recycling your portal.

  • Purchase an additional portal.
    If you are using all your existing portals, then you can purchase a new one for Marketing as described in the following procedure.

To get a new, unconfigured portal app and then use it with Marketing:

  1. Open your Office 365 admin center and go to Billing > Subscriptions.

  2. Choose Buy add-ons in the tile for your Dynamics 365 subscription.

  3. Purchase a new portal using the form provided.

    Important

    Be sure not to configure your new portal because the Marketing setup wizard requires an unconfigured portal to be present on your tenant. The wizard will configure the portal for you as required.

  4. Run the Marketing setup wizard.

Why do I get an authorization-failed message when I try to run the setup wizard?

In some cases, when you sign up for a trial of Dynamics 365 or Office 365, you will receive an organization that is in an unmanaged state, which means (among other things) that you can't get permission to install third-party solutions—including Dynamics 365 for Marketing. As a result, you'll see the following error message when you run the setup wizard for Marketing.

Unmanaged organization error

To fix this, do one of the following:

It looks like Marketing is set up on my instance, but why does it generate so many errors?

If Marketing is visible on your instance, but nothing is working, then you might have just a partial installation. This can happen if you use the Dynamics 365 admin center to set up Marketing as a service (on the Instances tab) rather than as an app (on the Applications tab). As a result, you might have the Marketing service installed, but not its many supporting components.

To fix this, go back to the Dynamics 365 admin center and reinstall from the Applications tab as described in Purchase a production version of Dynamics 365 for Marketing. The setup wizard should fix your installation.

Set up Marketing using the Applications tab, not the Instances tab

How can I rerun the setup wizard?

If your setup fails for some reason, you'll be notified by email and/or by a status message in your web browser (if you keep it open during the installation). Often, part of the solution will be to rerun the setup wizard after waiting for an hour or so. To rerun the setup wizard, do one of the following:

  • If you are setting up a trial, then you should have received a welcome email that included a link to the setup wizard. Find your welcome mail and click that link to launch the wizard.
  • If you are setting up a production instance, then launch the setup wizard from the Applications tab in the Dynamics 365 admin center, as described in Purchase a production version of Dynamics 365 for Marketing.

How can I restart the portal?

Marketing pages and the event portal both run on the Dynamics 365 portals app. Sometimes, you may notice that settings you make in Dynamics 365 for Marketing aren't reflected on the portal right away, such as (for the event portal): updates to banner images, speaker images, or payment gateway assignments. Also, if your portal becomes unresponsive or otherwise unreliable, it can often help to restart it.

To restart your portal:

  1. Open the Dynamics 365 admin center and go to the Applications tab.

  2. Each configured portal app is listed in the Application column using the name of the Dynamics 365 instance it is assigned to (so it probably doesn't have "portal" in its name), and shows a value of Configured in the Status column. Find and select your portal in the list and then select Manage in the side panel.

    Select your portal

  3. The portals manager opens. Select Portal actions in the side panel, and then select the Restart tile to restart the portal.

    Open portal actions and then select restart

  4. You'll be asked to confirm the action. Choose Restart to continue and then allow a few minutes for the process to complete.

How can I fix my portal after changing my instance name?

The Dynamics 365 admin center enables you to change the name of any of your instances at any time. If you do so, then the URL for the affected instance will also change to match and, as a result, your portal will no longer be configured correctly and will stop working. To fix it, you must reconfigure your portal as follows:

  1. Open the Dynamics 365 admin center and go to the Applications tab.

  2. Each configured portal app is listed in the Application column using the name of the Dynamics 365 instance it is assigned to (so it probably doesn't have "portal" in its name), and shows a value of Configured in the Status column. Find and select your portal in the list and then select Manage in the side panel.

    Select your portal

  3. The portals manager opens. Select Portal actions in the side panel, and then select the Update Dynamics 365 URL tile to update the URL.

    Open portal actions and then update the URL

  4. You'll be asked to confirm the action. Choose Update URL to continue and then allow a few minutes for the process to complete.

My surveys aren't working; how can I fix my Voice of the Customer installation?

If you don't see the Survey tile in the Toolbox of your customer journey designer, or if it isn't working properly, then the Dynamics 365 for Marketing setup wizard might have failed to set up the Voice of the Customer app correctly. If this was the only error that occurred during installation, then you might not have received any messages about it. To fix this, do the following:

  1. Open the Dynamics 365 admin center.

  2. Go to the Applications tab, select any Voice of the Customer application in the applications list, and then select the Manage button in the side panel.

    Manage your Voice of the Customer installation

  3. The Set up Voice of the Customer page opens.

    Set up your Voice of the Customer installation

    Do the following:

    • Choose the instance you are having trouble with from the Dynamics 365 Instance drop-down list.
    • Read the license terms and the privacy policy carefully. If you agree with their terms, select the Accept the Dynamics 365 software license terms and privacy statement check box.
  4. Select Install. A message at the bottom of the page announces that the installation has successfully started.

  5. To track the installation progress, go back to your Dynamics 365 admin center and open the Instances tab. Select your instance in the list and then select the Solutions button in the side panel.

    Manage the solutions installed on your instances

  6. The Manage your solutions page opens, showing a list of solutions installed on your selected instance and the status of each of them. Find the Voice of the Customer for Microsoft Dynamics 365 solution and then refresh the page periodically until you can see that the solution is shown as Installed.

    The Manage your solutions page

  7. Still on the Manage your solutions page, find and select the solution called Dynamics 365 for Marketing. (If your list includes more than one Dynamics 365 for Marketing solution, then select the one that shows a Status of either Installed or Upgrade available.) Then select the (more) link in the side panel to see all available information for this solution.

    View details about your Marketing solution

  8. At the end of the solution description, you should now see a tag in square brackets.

    Find this tag at the end of the expanded description

    Do one of the following, depending on which of the following tags you see for your selected solution:

    • [MktVoc] or [MktVocEmail]: Do nothing and continue to the next step.
    • [Mkt]: Find and select another Dynamics 365 for Marketing solution that has the same version, but is tagged with [MktVoc], and then install it.
    • [MktEmail]: Find and select another Dynamics 365 for Marketing solution that has the same version, but is tagged with [MktVocEmail], and then install it.
    • If no tag is shown, continue to the next step.
  9. Open Dynamics 365 for Marketing, go to Settings > Advanced settings > Marketing settings > Customer insights sync, and enable syncing of the Survey (msdyn_survey) entity. More information: Choose entities to sync with the customer-insights services

  10. Confirm that the Survey tile is now visible in the customer journey toolbox, and that your surveys are working correctly.

If your surveys still aren't working after completing these steps, then please contact Microsoft Support for assistance.

Why can't I see my Dynamics 365 for Marketing results in other Dynamics 365 apps?

Dynamics 365 for Marketing is built to run exclusively on the new Unified Interface for Dynamics 365 applications. Many Dynamics 365 applications support both the new Unified Interface and the older web-client interface, but nearly all are moving to the Unified Interface.

Marketing typically shares data with other Dynamics 365 applications running on the same instance, and operates on many of the same database entities, including contacts, leads, accounts, and more. Some Marketing-specific features, such as displays of analytics and insights from marketing initiatives, require the Unified Interface and therefore won't show any data when you view those entities in web-client apps.

Also, some administration and customization features, and some integrated user features, may require you to switch to a web-client app from time to time, but soon all features are expected to be available on the Unified Interface.

More information: About Unified Interface and Find your way around Marketing

How can I contact support if I still need help?

If you’ve already tried to set up the application several times and are still having trouble, please open a support case through your applicable Microsoft Premier channel or MPN partner channel.

For more information about how to contact Microsoft Support directly, and how to find forums, FAQs, and other resources, see the following: