CSJ prime_rit Configuration in Taku
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, Taku has also upgraded the relevant features. If you use Taku'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, Taku provides the same prime_rit options as the CSJ backend and supports creating and binding placements.
- Taku'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 Taku 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 Taku 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 Taku 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 Taku
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. Taku 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 Taku. When manually creating a CSJ ad source in Taku, 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 Taku.
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 Taku, the result is synced to the CSJ backend in real time. If the CSJ account linked to the app has auto-creation enabled, Taku also updates the CSJ code slot configuration stored in Taku via API every night. If a historical code slot is bound to an prime_rit in the CSJ backend, Taku will display that binding after the sync; no manual binding in Taku 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 Taku 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 Taku OpenAPI
When creating non-GroMore CSJ code slots through Taku 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:
Taku 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 Taku auto-creation, select or create the CSJ prime_rit; Taku submits prime_rit to CSJ. When using Taku 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 Taku.
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 Taku 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 Taku 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, Taku synchronizes code slot configuration via API every night, and the binding made in the CSJ backend will appear in Taku 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 Taku 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 Taku, Taku 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 Taku prime_rit use?
We recommend binding all CSJ code slots under the same Taku 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)