Singular Integration
Step 1: Integrate RZR as a partner
To add RZR as a partner in your Singular dashboard, follow these steps:
Go to your Singular dashboard.
Click ATTRIBUTION > Partner Configuration.
Select Add a Partner.
Choose RZR from the list.
Step 2: Setting up an App/site
To add the app and site (app version) for your campaign, follow these steps:
On the Partner Configuration page, click +Add App Site.
In the App drop-down, select the app you want to run the campaign for.
In the Site drop-down, select the latest version of the app.
Mark the Include View-Through Attributions box if it is not already selected. This option enables the attribution of impressions.
Mark the Enable Fraud Postbacks box if it is not selected by default.
Mark the Send Postbacks to RZR on All Installs box. This option helps optimize RZR's machine-learning models for precise targeting by sharing unattributed data.
Keep the Click-Through Attribution Lookback Window at the default value (7 days). This is an industry-standard value, and changing it may result in inaccurate reporting.
For re-engagement, please ensure the re-engagement inactivity window is defined the default value is of 7 days.
In the Send In-App Events to RZR drop-down, select On. This option enables the attribution of all events that occur throughout the campaign.
Step 3: Configure Postbacks
For In-App Postback Events, select the starting point and set up the postback window duration.
If the client sets the conversion flag to 0 during the in-app postback event setup, both RZR-attributed (install claim) and non-attributed events can be included in the postbacks for that specific event.
Note:
Setting Conversion Flag = 1 indicates that only RZR attributed Postbacks will be sent.
To receive all events (including non-attributed ones), the “Send All” option needs to be enabled. In that case, even events with Conversion Flag = 0 would be sent via postbacks when “Send All” is enabled.
Note: To avoid discrepancies in ad revenue data, please ensure that the {RAW_AMOUNT} macro is passed in the purchase_revenue parameter of the postback URL, instead of {AMOUNT}. This helps prevent values less than 0 from being rounded off to 0, which can lead to inaccurate reporting.
To validate this, the client can navigate to the In-App Event Postbacks section and select the highlighted option (as shown in the screenshot) to view the configured postback URL.
Step 4: Cost Integration
For RZR, we have a data connection with Singular, which enables us to share cost data using an S3 bucket.
For more details on the fields shared, please refer to the link below: Singular RZR Data Connector
Note: If cost data is missing, please be aware that Singular retrieves data daily for the last seven days. If the issue date falls within this seven-day timeframe, the data issue should be resolved automatically.
Step 5: Audience Integration
Navigate to Audiences > Distributions: This section lists all available audience partners for distribution.
Click on the Desired Ad Network: Select the ad network (e.g., RZR) where you want to distribute your audience segment.
Enter the Provided Token: In the Network Configuration dialog that appears, input the token in the designated field.
Configure Segment Settings: Under the Segment Configuration section, you'll see a list of your audience segments.
Enable the Segment: Toggle the switch to enable the segment you wish to distribute.
Save the Configuration: After configuring the necessary settings, click Save to finalize the distribution setup
Conversion flag difference b/w 0 and 1 and send all : Ensure for each event the conversion flag is set to 0 and not 1.
Define the process to add the s3 bucket folder on singular UI
Once your partner is ready to deliver reports via s3, you will need to setup a Data Connector in Singular to enable data processing.
Go to Settings > Data Connectors in your Singular account.
Click Add a New Data Connector and enter the partner's name.
In the New Connector window, fill in the Folder Name--this should match the folder your partner created within the s3 bucket to deliver your reports. (Ask RZR account manager to provide the folder name)
Click Save.
This document outlines the complete setup details required to configure your Singular account. Please review each section carefully and follow the outlined steps to ensure accurate tracking, attribution, and reporting.
If you need any help with the configuration document, feel free to reach out to your RZR Account Manager/Account Coordinator for assistance.
Last updated