Setup
Troubleshooting
Overview
Microsoft Monetize (formerly Xandr, AppNexus) is Microsoft’s ad serving platform that provides publishers with tools to manage, deliver, and optimize advertising campaigns. Our integration with Microsoft Monetize enables you to activate Permutive cohorts for real-time targeting and collect comprehensive ad performance data for insights and optimization. This integration is both a Source and Destination:- Source: Permutive collects ad impression and click events from Microsoft Monetize.
- Destination: Permutive activates your cohorts in Microsoft Monetize using targeting key-value pairs.
- Target your advertising campaigns in real-time with rich Permutive cohorts using Microsoft Monetize’s ad server.
- Track ad impressions and clicks in Permutive for insights, retargeting, or modeling.
- (Advanced) Log-Level Data: Ingest comprehensive ad event data from Microsoft Monetize Log-Level Data Feeds for enhanced reporting and mobile support.
Environment Compatibility
Prerequisites
- Member ID - You must provide your Microsoft Monetize Member ID, which can be found in your Microsoft Monetize dashboard.
- User Credentials - You must create a Microsoft Monetize user account for Permutive with appropriate permissions. We recommend using an account with the following permissions:
- View and edit key-values
- Create and manage targeting keys
- Access to inventory settings
- AppNexus Seller Tag - For Web integration, you must already have the AppNexus Seller Tag installed on your site and configured to serve your advertising campaigns.
Setup
- Primary Setup Steps
- Web
- iOS
- Android
- API Direct
1
Enable in Permutive Dashboard
You must enable the Microsoft Monetize (Ad Server) integration in the Permutive dashboard. In the Permutive dashboard, navigate to your workspace’s integrations page. Click Add Integration and select Microsoft Monetize (Ad Server).You will be asked to provide:
- Your Microsoft Monetize Member ID
- Microsoft Monetize username and password (for API access)
2
Verify Key-Values in Microsoft Monetize
In your Microsoft Monetize dashboard, navigate to Inventory => Key-Values and search for
permutive. You should find that a targeting key has been created for permutive. If you cannot find the targeting key, please reach out to Permutive Support.3
Verify Setup
In the Permutive Dashboard, navigate to one of your cohorts. Check that the Microsoft Monetize (Ad Server) activation sync is visible. You can try toggling this to On. After doing this, in your Microsoft Monetize dashboard you should see a new targeting value created under the permutive targeting key, with the value corresponding to your cohort’s ID. This verifies your integration setup is successful.
Data Types
With your Microsoft Monetize (Ad Server) integration setup, you’ll see the following additional event types collected in Permutive:AppNexusAdImpression
AppNexusAdImpression
Tracks ad impression events from the AppNexus Seller Tag on web. Based on Microsoft Monetize’s ad event callbacks.
AppNexusAdClick
AppNexusAdClick
Tracks ad click events from the AppNexus Seller Tag on web.
Troubleshooting
Unable to enable Microsoft Monetize (Ad Server) integration in Permutive Dashboard
Unable to enable Microsoft Monetize (Ad Server) integration in Permutive Dashboard
If you see an error when enabling the Microsoft Monetize (Ad Server) integration, check that
you have provided valid Microsoft Monetize credentials with the correct permissions. The
user account must have permissions to view and edit key-values and access
inventory settings. Verify your Member ID is correct.
The permutive targeting key was not created
The permutive targeting key was not created
Double check that the Microsoft Monetize user credentials provided to Permutive have the
correct permissions to create and manage targeting keys. The user must have
access to the inventory section and permissions to edit key-values. If you
have reached Microsoft Monetize’s limit of targeting keys, you may need to remove an
old/inactive key first.
Cohorts not appearing as targeting values in Microsoft Monetize
Cohorts not appearing as targeting values in Microsoft Monetize
First, verify the cohort is toggled On for Microsoft Monetize (Ad Server) activation in
the Permutive Dashboard. Then check in your Microsoft Monetize dashboard under
Inventory => Key-Values that the cohort ID appears as a value under the
permutive targeting key. If the value is missing, try toggling the cohort
activation off and on again, and contact Permutive Support if the issue
persists.Log-Level Data events not appearing
Log-Level Data events not appearing
Verify that you have enabled both the standard Microsoft Monetize (Ad Server) integration
(for event collection) and the Log-Level Data integration. Check that your
Microsoft Monetize Log-Level Data Feeds are correctly configured to export to the
Permutive-provided GCS bucket. Allow 24 hours for initial data to appear. If
events still don’t appear, verify your Member ID matches in both the
dashboard configuration and the service account writing to the GCS bucket.
Missing line item IDs in events
Missing line item IDs in events
Line item IDs are only available when using the Log-Level Data integration.
Standard edge SDK events (
AppNexusAdImpression and AppNexusAdClick) do
not include line item IDs due to limitations of the AppNexus Seller Tag API. To
get line item IDs, you must enable the Log-Level Data Feeds integration.Changelog
June 2025
- Enhanced support for activating cohorts via Microsoft Monetize (Ad Server) with improved targeting key management
November 2019
- Initial release of Microsoft Monetize (Ad Server) (formerly Xandr AdServer, AppNexus) integration with cohort activation and event collection
For detailed changelog information, visit our
Changelog.