CSJ prime_rit Configuration in TopOn
1. Feature Overview and Prerequisites
The CSJ backend has added an prime_rit layer. Starting September 6, non-GroMore CSJ code slots must be bound to an prime_rit before they can be submitted. For details, contact your CSJ AM, or view the CSJ backend notice or view the official CSJ notice
To support this platform change, TopOn has also upgraded the relevant features. If you use TopOn's CSJ auto-creation, Smart Manager, or OpenAPI code slot creation, follow the guide below to use the upgraded features.
This capability requires the CSJ account to have API auto-creation authorization. Once enabled, TopOn provides the same prime_rit options as the CSJ backend and supports creating and binding placements.
- TopOn's CSJ auto-creation feature provides a CSJ prime_rit (prime_rit) option.
- For CSJ accounts with API auto-creation authorization enabled, historical CSJ ad sources created in TopOn support individual or batch prime_rit binding.
- Smart Manager configuration also provides a CSJ prime_rit option, using the same interaction as auto-creation.
- When creating CSJ code slots through TopOn OpenAPI, pass the new prime_rit field.
- CSJ code slots under GroMore are not affected by this change and continue to follow the existing process.
Important: Once an prime_rit and code slot are bound in the CSJ backend, this binding cannot be modified. Existing valid bindings in TopOn are shown as read-only. Without API auto-creation authorization, configure the relationship in the CSJ backend instead. We recommend enabling CSJ auto-creation for the account.
2. Create New CSJ Code Slots Automatically in TopOn
Go to Mediation Management, click "Add Ad Source", select CSJ, and enable auto-creation. After entering the CSJ account and app, select an prime_rit under "CSJ prime_rit" that matches the CSJ backend. If no suitable placement exists, you can create one directly.
After selecting a placement, complete the remaining ad source fields and submit. TopOn will submit the selected placement prime_rit to CSJ and create the code slot.
If you create the code slot manually in the CSJ backend, select an prime_rit there according to the CSJ workflow, then enter the code slot ID in TopOn. When manually creating a CSJ ad source in TopOn, you do not need to fill in a CSJ prime_rit.
3. Bind prime_rits to Historical CSJ Ad Sources
For CSJ accounts with API auto-creation authorization enabled, you can bind an prime_rit to historical CSJ ad sources in TopOn.
Note: Once API access is enabled, all historical ad sources, including those created manually or automatically, support ad placement binding.
Individual: Open the ad source edit page, select the corresponding prime_rit, and save.
Batch: Open the batch ad source editing page, select multiple existing ad sources, bind them to the same prime_rit, and submit.
Ad sources selected for batch processing must belong to the same CSJ account and the same CSJ app.
Existing valid bindings are shown as read-only; ad sources with no binding or an invalid binding can be rebound.
When you bind an prime_rit in TopOn, the result is synced to the CSJ backend in real time. If the CSJ account linked to the app has auto-creation enabled, TopOn also updates the CSJ code slot configuration stored in TopOn via API every night. If a historical code slot is bound to an prime_rit in the CSJ backend, TopOn will display that binding after the sync; no manual binding in TopOn is required.
4. Configure CSJ prime_rits in Smart Manager
If a historical Smart Manager configuration is missing an prime_rit, it will show "Configuration exception". This does not affect existing ad sources, but the configuration must be completed before Smart Manager can automatically create new CSJ code slots. We recommend completing it promptly.
In Smart Manager's "CSJ and TopOn Ad Source Configuration", select the corresponding prime_rit under "CSJ prime_rit". This setting is used when Smart Manager automatically creates new CSJ code slots.
If a historical configuration is missing an prime_rit, the page shows "Configuration exception". You can open an individual configuration to complete it, or click "Batch Set CSJ prime_rits" to process multiple configurations at once.
5. Create CSJ Code Slots through TopOn OpenAPI
When creating non-GroMore CSJ code slots through TopOn OpenAPI, pass the new prime_rit field in the request. The field must contain a valid prime_rit ID under the current CSJ account and app.
API documentation:
TopOn Ad Source Auto-Creation API
Official CSJ API Documentation
6. Q&A
1. How should a newly created CSJ code slot be configured?
When using TopOn auto-creation, select or create the CSJ prime_rit; TopOn submits prime_rit to CSJ. When using TopOn OpenAPI, pass prime_rit in the request. If you create the code slot directly in the CSJ backend, select the prime_rit there and then enter the code slot ID in TopOn.
2. How should historical CSJ code slots be handled?
Follow the CSJ backend requirements for historical code slots (see the CSJ backend notice in the screenshots below). If you need to bind an prime_rit to a historical code slot, you can do so in TopOn as described in Section 3, or in the CSJ backend.
Whether historical code slots need to be rebound and whether this affects ad fill should be confirmed against the official CSJ notice or with your CSJ AM.
3. When will TopOn show an prime_rit bound in the CSJ backend?
The CSJ account linked to the app must have auto-creation enabled. Once this condition is met, TopOn synchronizes code slot configuration via API every night, and the binding made in the CSJ backend will appear in TopOn after the sync.
4. Why can't an existing prime_rit binding be changed?
After an prime_rit and code slot are bound in the CSJ backend, the binding cannot be changed there. Existing valid bindings in TopOn are also shown as read-only.
5. What should I do if API auto-creation authorization is not enabled?
If the CSJ account does not have API access, or the account has not authorized auto-creation in TopOn, TopOn does not provide the relevant prime_rit configuration capability. Configure the prime_rit and code slot relationship in the CSJ backend instead. We recommend enabling CSJ auto-creation for the account.
6. Do CSJ code slots under GroMore need an prime_rit?
No. CSJ code slots under GroMore are not affected by this change and continue to follow the existing process.
7. What should I do if Smart Manager shows "Configuration exception"?
This means the historical Smart Manager configuration is missing a valid prime_rit prime_rit. Complete it in Smart Manager as described in Section 4. This does not affect existing ad sources, but it will affect automatic creation of new CSJ code slots.
8. Will an prime_rit be deleted if I create it in the auto-creation dialog but do not continue creating the code slot?
No. The creation is also applied to the CSJ backend, and canceling the subsequent code slot creation will not delete the prime_rit. A CSJ app can have up to 50 prime_rits, so create them carefully.
9. How many CSJ prime_rits should one TopOn prime_rit use?
We recommend binding all CSJ code slots under the same TopOn prime_rit to the same CSJ prime_rit for easier management and troubleshooting.
;}.cls-2{fill:%230868f7;}.cls-3{fill:url(%23未命名的渐变_44);}.cls-4{fill:%23333;}%3c/style%3e%3clinearGradient%20id='未命名的渐变_8'%20x1='33.73'%20y1='100.61'%20x2='-0.03'%20y2='-1.06'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%237ae9fb'/%3e%3cstop%20offset='0.67'%20stop-color='%232b90f8'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3clinearGradient%20id='未命名的渐变_44'%20x1='27.86'%20y1='18.67'%20x2='68.36'%20y2='22.22'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%235ac7f2'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3c/defs%3e%3cpath%20class='cls-1'%20d='M29,28.74V81.91l-9.51-3.68v0L8.52,74A7.17,7.17,0,0,1,4,67.32V24.54A3.76,3.76,0,0,1,9.08,21Z'/%3e%3cpath%20class='cls-2'%20d='M68.09,78.07a13.15,13.15,0,0,1-17.9,12.06L29,81.91h0V28.74L50.19,37A13.17,13.17,0,0,0,68.08,25.3h0Z'/%3e%3cpath%20class='cls-3'%20d='M68.08,25.3a13.19,13.19,0,0,1-6.73,10.87A13.09,13.09,0,0,1,50.19,37L29,28.74V6A3.76,3.76,0,0,1,34.1,2.52l25.59,9.91A13.22,13.22,0,0,1,68.08,25.3Z'/%3e%3cpath%20class='cls-4'%20d='M129.06,81.76a4.33,4.33,0,0,1-3.19-1.31,4.4,4.4,0,0,1-1.31-3.24V56.86H97.65V77.21a4.36,4.36,0,0,1-1.35,3.2A4.68,4.68,0,0,1,93,81.76a4.32,4.32,0,0,1-3.19-1.31,4.37,4.37,0,0,1-1.32-3.24V27.27A4.58,4.58,0,0,1,89.83,24a4.59,4.59,0,0,1,7.82,3.27V48.15h26.91V27.27A4.58,4.58,0,0,1,125.91,24a4.59,4.59,0,0,1,7.82,3.27V77.21a4.37,4.37,0,0,1-1.36,3.2A4.65,4.65,0,0,1,129.06,81.76Z'/%3e%3cpath%20class='cls-4'%20d='M163.77,81.66c-6.57,0-11.76-1.92-15.44-5.7s-5.54-9.07-5.54-15.74a26.76,26.76,0,0,1,2.09-10.43,17.72,17.72,0,0,1,6.67-8.06,19.15,19.15,0,0,1,10.68-2.95,19,19,0,0,1,10.46,2.8,18.7,18.7,0,0,1,6.55,7.36,22.53,22.53,0,0,1,2.36,10.28A4.51,4.51,0,0,1,177,63.77H152.23a10.8,10.8,0,0,0,3.49,6.65c2,1.68,4.88,2.52,8.66,2.52a22.25,22.25,0,0,0,7.54-1.21c.74-.3,1.55-.67,2.37-1.07a3.75,3.75,0,0,1,1.84-.4,4.09,4.09,0,0,1,3,1.15,4,4,0,0,1,1.12,3,4.38,4.38,0,0,1-2.58,3.82,32.34,32.34,0,0,1-6.36,2.61A28.67,28.67,0,0,1,163.77,81.66ZM172.4,55.9a9.72,9.72,0,0,0-1.63-4.56A9.9,9.9,0,0,0,167,48a10.38,10.38,0,0,0-4.64-1.14,12,12,0,0,0-4.77,1.06,9.54,9.54,0,0,0-4.89,5.66,11.78,11.78,0,0,0-.51,2.3Z'/%3e%3cpath%20class='cls-4'%20d='M193,81.64a4.49,4.49,0,0,1-4.51-4.55V27.28A4.58,4.58,0,0,1,189.84,24a4.48,4.48,0,0,1,3.28-1.36A4.36,4.36,0,0,1,196.35,24a4.46,4.46,0,0,1,1.31,3.31V77.09a4.34,4.34,0,0,1-1.35,3.2A4.67,4.67,0,0,1,193,81.64Z'/%3e%3cpath%20class='cls-4'%20d='M263.79,81.71a5.7,5.7,0,0,1-4.2-1.74,5.76,5.76,0,0,1-1.73-4.19V27.37a4.58,4.58,0,0,1,1.35-3.27A4.59,4.59,0,0,1,267,27.37V72.53h24a4.58,4.58,0,0,1,3.27,7.82A4.66,4.66,0,0,1,291,81.71Z'/%3e%3cpath%20class='cls-4'%20d='M424.48,81.74a4.71,4.71,0,0,1-2.71-.88,5.43,5.43,0,0,1-1-1l-.07-.09-12.41-17-5.41,5v9.44a4.31,4.31,0,0,1-1.36,3.19,4.66,4.66,0,0,1-3.3,1.36A4.29,4.29,0,0,1,395,80.42a4.36,4.36,0,0,1-1.32-3.23V27.37A4.58,4.58,0,0,1,395,24.1a4.52,4.52,0,0,1,6.58.12,4.54,4.54,0,0,1,1.24,3.15V56.31l17.72-16.38.05,0a4.8,4.8,0,0,1,2.94-1.11,4.4,4.4,0,0,1,3.27,1.2,4.57,4.57,0,0,1,1.2,3.27,4.44,4.44,0,0,1-.77,2.33,7.45,7.45,0,0,1-1.43,1.65l-11,9.64,13.34,17.68a5,5,0,0,1,1,2.71,4.12,4.12,0,0,1-1.36,3.24A4.64,4.64,0,0,1,424.48,81.74Z'/%3e%3cpath%20class='cls-4'%20d='M317.93,81.76a21.5,21.5,0,1,1,21.17-21.5A21.37,21.37,0,0,1,317.93,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,317.93,47.66Z'/%3e%3cpath%20class='cls-4'%20d='M212.18,101.22a4.12,4.12,0,0,1-3.05-1.26,4.17,4.17,0,0,1-1.26-3.1V43.34a4.37,4.37,0,0,1,1.3-3.14,4.26,4.26,0,0,1,3.13-1.3,4.19,4.19,0,0,1,3.1,1.26,4.32,4.32,0,0,1,1.26,3.16,20.77,20.77,0,0,1,13-4.54,21.51,21.51,0,0,1,0,43,20.51,20.51,0,0,1-13-4.57V96.86a4.15,4.15,0,0,1-1.3,3.06A4.5,4.5,0,0,1,212.18,101.22Zm17.43-53.63c-6.23,0-12.93,4.11-12.93,12.72a12.73,12.73,0,0,0,25.46,0A12.71,12.71,0,0,0,229.61,47.59Z'/%3e%3cpath%20class='cls-4'%20d='M365.76,81.76a21.5,21.5,0,1,1,21.18-21.5A21.37,21.37,0,0,1,365.76,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,365.76,47.66Z'/%3e%3c/svg%3e)