---json
{
    "canonical": ":automatic:in-article:ad",
    "page_id": "i2hsw74p8wz4jh985iui5"
}
---

====== ComboStrap Ads - Automatic In-Article Ads ======


===== About =====
''In-article Ads'' are ads that will show up in the page content.


<note>
This is an automatic placement which means that they follows a set of rule that:
  * spread the ''ads'' roughly to have one ''ad'' on the screen.
  * does not break the reading experience by placing them before a heading and not between paragraph.
This placement conforms to most of the Ads network rules.
</note>
===== How to enable automatic in-article ads ? =====

==== Enable  ====


By default, in-article ads are not enabled.

You need to set the ''combo-conf-007'' [[:docs:app:configuration|configuration]] to on.




==== Exclude the ads page from the index ====

Because the ''ads'' are stored as page, they are by default added to the index.

You need to set a configuration to prevent it.

See [[conf]]

==== Create your ads ====
At this point, no ads is shown because no ''ads'' have been created.

To show ''in-article ads'', you need to create [[page|Ads pages]] that follow this naming convention.
<code>
inarticleX
</code>
where X is the Ads number in the page and starts at 1.

For instance:
  * the [[page|ad page]] ''inarticle1'' will contain the first ''in-article ad''.
  * the [[page|ad page]] ''inarticle2'' will contain the second ''in-article ad''.

===== Configuration =====



==== AdsInArticleShowPlaceholder ====
''AdsInArticleShowPlaceholder '' is a [[docs:app:configuration|configuration]] that will show a placeholder when a ''in-article'' [[page|ads page]] is not found.

This is a debugging configuration and is therefore by default ''off''.