Microsoft Ads (formerly Bing Ads)

To connect Microsoft Ads to Polytomic On Premises, you must register an application and get a developer token.

1. Register an application with Microsoft Entra ID. Add a web redirect URI of {POLYTOMIC_URL}/connect/msads. For example, if you access Polytomic at https://polytomic.internal.acmecorp.com, use https://polytomic.internal.acmecorp.com/connect/msads.

   Your choice of Supported account types determines whether you need a tenant ID in step 4:

   • Any Entra ID Tenant + Personal Microsoft accounts (multitenant): Microsoft recommends this option, and you don't need a tenant ID. Choose it if a personal Microsoft account owns the Microsoft Ads account you're connecting.
   • The option for your own directory only (single tenant): You must set MSADS_TENANT_ID in step 4. Sign-in fails without it.

   For a single-tenant application, you can find the Directory (tenant) ID on the application's Overview page in the Azure portal, or under Microsoft Entra ID > Overview. Your tenant's verified domain name, for example acmecorp.onmicrosoft.com, works in its place.

2. Create a client secret under Certificates & secrets, and copy its value.

3. Get a Microsoft Ads developer token.

4. Set these credentials in your Polytomic deployment:

   • MSADS_CLIENT_ID: the application (client) ID from step 1.
   • MSADS_CLIENT_SECRET: the client secret from step 2.
   • MSADS_DEVELOPER_TOKEN: the developer token from step 3.
   • MSADS_TENANT_ID: the directory (tenant) ID, for a single-tenant application only.

5. Follow the Microsoft Ads instructions to create a Connection.

Sign in with Google

Microsoft Ads also lets users sign in with a Google account. By default, Polytomic uses your Google sign-in OAuth client for this flow. That client's authorized redirect URIs must include {POLYTOMIC_URL}/connect/msads.

To use a separate Google OAuth client, set MSADS_GOOGLE_CLIENT_ID and MSADS_GOOGLE_CLIENT_SECRET.

Troubleshooting

AADSTS50194: application is not configured as a multi-tenant application

Your application registration is single tenant, but Polytomic is signing in with Microsoft's shared endpoint. Set MSADS_TENANT_ID to your directory (tenant) ID, or change the registration's Supported account types to multitenant.