AD INSERTER Free Edition does not support the investigation and resolution records of SERIES_GROUP (series categories)

Background

When using the Ad INSERTER free version, I would like to Series Group to display different ad contents. For example, let all the articles under the ‘Blog Operations Practice’ series show exclusive CTA, and other articles show generic CTA.

There are two problems in the actual configuration:

1. Taxonomies dropdown search series_group The results are incomplete.
2. fill in manually series_group:blog-management-practices The rules do not take effect, and the exclusive CTA appears where it should not be.

This article records the complete investigation process and final solution.

1. Phenomenon: drop-down list search series_group Only partial results are returned

In the block settings of the AD INSERTER, click taxonomies Filter box, enter series_group Search, the drop-down list only shows 3 bars:

• go-standard-lib-tour
• go-standard-lib-tour-en
• blog-management-practices-en

Chinese blog-management-practices.

In fact, there are 4 records in the background series category list (including the missing one).

View browser network requests (admin-ajax.php), the response content does only return 3 data.

2. Try: Fill in directly series_group:blog-management-practices

Since the drop-down list cannot be found, I tried to enter the rules manually:

series_group:blog-management-practices

After saving, find the CTA of the block Appeared in articles that do not belong to this series of categories(such as articles in other series), the rules are not effective.

3. Check: The database confirms that the data exists

To confirm blog-management-practices The record is good, executing SQL:

SELECT t.term_id, t.name, t.slug, tt.taxonomy, tt.count
FROM wp_terms t
INNER JOIN wp_term_taxonomy tt ON t.term_id = tt.term_id
WHERE tt.taxonomy = 'series_group' AND t.slug LIKE '%blog-management-practices%';

Returns 2 pieces of data (one in Chinese and English), which is in line with expectations.Database no problem.

I also tried the following, and the problem remains:

• Modify the series category alias (shot 5)

• Re-add the series category after deletion (screenshot 6)

• Reassociate the original 5 series to this category (Screenshot 7)

4. Final discovery: AD INSERTER free version is not supported series_group

Confirm after repeated verification:AD INSERTER free version only supports ordinary series Classification, not supported series_group(Series category).

series_group:xxx This way of writing is not parsed by the plugin, so the rules are invalid.

5. Solution: Use specific series List

Since series categories cannot be used, useWhitelist method, list all series under this category one by one.

There are 5 series under the Blog Operations Practice category:

• wp-perf-notes
• wp-blog-multilingual-guide-en
• blog-seo-log
• explore-blog-business-models
• ad-inserter-usage-notes

Fill in the AD INSERTER rule (whitelist):

series:wp-perf-notes,wp-blog-multilingual-guide-zh,blog-seo-log,exploring-blog-business-models,ad-inserter-usage-notes

Test after saving:All articles under these 5 series correctly display exclusive CTAs, other articles show generic CTA. The rules take effect.

6. Summarize and experience

1. Don’t worry about the incomplete display of the drop-down list
   The drop-down list may be incomplete due to factors such as cache, multi-language plug-in (polylang), but does not affect manual input rules.
2. AD INSERTER free version is not supported series_group
   If you need to use series category filtering, please use the specific series under this category (series:) list. Manual maintenance is a little troublesome, but stable and reliable.
3. Common treatments that do not take effect after manually entering rules

• Confirm that the fields used are truly supported by the plugin (review the official documentation).
• Clear all caches (W3 Total Cache, browser cache, etc.).
• Delete rules are re-save once.

I hope this record can help friends who encounter similar problems to avoid detours.

Attachment: Environmental Information

• WordPress 7.x
• AD Inserter Free Edition 2.8.x
• Polylang multilingual plugin 3.8.x