> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/advertisers/ja/kyanpn/macros.md).

# 動的トークン

これらは **動的トークン** キャンペーンURLと広告主のトラッキングシステムを通じて興味深いデータを追跡するために使用されます：

* **{actual\_cost}**：各インプレッション／クリックごとに実際に支払われたCPM / CPC。

{% hint style="info" %}
**注:** 一部のサードパーティのトラッキングソリューションでは、トラッキングURLで渡される非常に小さい小数値が四捨五入または切り捨てされます。インプレッションベースのキャンペーンが非常に小さいコスト値（たとえば 0.00002）を送信すると、一部のトラッカーは数値を丸めたり、先頭のゼロを削除したりすることがあります。その結果、有効な値が送信されていても、トラッカー内ではコストが0または大幅に低く表示されることがあります。この動作はトラッカーの精度に依存し、トラッキングの問題ではありません。
{% endhint %}

* **{campaign\_id}**：キャンペーンのID。
* **{category\_id}**：検出されたカテゴリのID。
* **{conversions\_tracking}**：顧客が広告をクリックしたときに生成される一意のID。
* **{cost}**：クリックまたはインプレッションのコスト。
* **{country}**：訪問者の3文字の国コード。
* **{email\_encoded}**：このトークンを使用すると、すべての形式のランディングページURLにログイン済みユーザーのメールアドレスを挿入できます。&#x20;

{% hint style="info" %}
**注**：{email\_encoded}はリクエスト時のみ利用できます。有効化するにはアカウントマネージャーにお問い合わせください。
{% endhint %}

* **{format}**：バナーサイズ。例：300×250。
* **{keyword}**：特定のキーワードを対象とするキャンペーンで一致したキーワード。一致がない場合は空になります。
* **{language}**：訪問者の言語。
* **{pricing\_model}**：キャンペーンの価格モデル（1 = CPC、2 = CPM、4 = Smart CPM、5 = CPV、7 = Smart CPC）。
* **{site\_id}**：広告が表示されるサイトのID番号。
* **{src\_hostname}**：パブリッシャーが広告表示用に提出したサイト名。先頭のHTTPプロトコルは含みません（例：examplesite.com）。
* **{sub}**：パブリッシャーのSub ID。
* **{tags}**：その広告インプレッションで識別されたキーワードの一覧。
* **{time}**：キャッシュバスターとして使用されるタイムスタンプ。
* **{url}**：パブリッシャーが広告表示のために管理パネルへ送信したサイトの完全なURL。HTTPプロトコルを含みます（例：）。&#x20;

{% hint style="info" %}
**注**：このトークンは、広告がユーザーに表示されたURLではなく、当社プラットフォームに登録されているURLのみを表示します。
{% endhint %}

* **{variation\_id}**：バリエーション（バナーまたはランディングページ）のID。
* **{zone\_id}**：広告が表示される広告ゾーンのID。

## ネイティブ広告とプッシュ通知で動的トークンを使用する

ステップ2でネイティブ広告またはプッシュ通知を使用してキャンペーンを作成する場合、次のような動的トークンを追加できます **表示する** **ローカライズされた** **テキスト** 訪問者の情報に基づいて表示し、広告をより効果的にターゲティングできます。

<figure><img src="/files/6647104ccddfced82b4393ef02f57e2a68cde36d" alt=""><figcaption></figcaption></figure>

これらのトークンは次の項目で利用できます： **タイトル** と **説明** フィールド。トークンを追加するには、次の **「+トークンを追加」** ボタンをクリックし、ラジオボタンでトークンの大文字・小文字の設定を選択してください。この機能で使用できるトークンは次のとおりです：&#x20;

* **{country\_name}**：訪問者のローカライズされた国名。例：España。
* **{region}**：訪問者のローカライズされた地域名。例：Cataluña。
* **{city}**：訪問者のローカライズされた都市名。例：Barcelona。
* **{language\_name}**：訪問者のローカライズされた言語。例：Español
* {**日}：** 訪問者がサイトを閲覧しているローカライズされた曜日。例：Lunes、Martes、Miércoles。
* **{operating\_system}：** 訪問者のオペレーティングシステム。例：Windows 10。
* **{device}：** 訪問者が使用しているデバイス。例：iPhone。
* **{carrier}：** 訪問者がサイトにアクセスするために使用している通信事業者。例：Vodafone。
* **{browser}：** 訪問者が使用しているブラウザ。

これらの動的トークンは、キャンペーンで設定した言語で表示されます。次の項目の言語は **バリエーションテキスト言語** の横にあるドロップダウンメニューで **配信アルゴリズム**を選択します。デフォルト言語は英語です。

<figure><img src="/files/f992a6a5031581e4cc126a6515dc70cabcdcaeac" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**注:** キャンペーン内のすべてのバリエーションに対して選択できる言語は1つだけです。異なる言語の広告については、言語ごとに別々のキャンペーンを作成してください。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/advertisers/ja/kyanpn/macros.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
