> 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にログイン済みユーザーのメールアドレスを挿入できます。
{% hint style="info" %}
**注**: {email\_encoded} はリクエスト時のみ利用可能です。有効化するにはアカウントマネージャーにお問い合わせください。
{% endhint %}
* **{ex\_av}:** この [年齢確認ステータス](/advertisers/ja/kyanpn/kyanpnno/create-campaign-step3.md#age-verification-status) の値（0 = 年齢確認なし、「未定義」; 1 = 確認済み; 2 = 未確認）は、パブリッシャーがこの値を共有している限り、ユーザーが確認済みかどうかを判定します。もし **パブリッシャーが値を共有しない場合**、0 = 「未定義」に戻ります。
* **{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プロトコルを含みます（例: ）。
{% hint style="info" %}
**注**: このトークンは、広告がユーザーに表示されたURLではなく、当社のプラットフォームに登録されているURLのみを表示します。
{% endhint %}
* **{variation\_id}**: バリエーション（バナーまたはランディングページ）のIDです。
* **{zone\_id}**: 広告が表示される広告ゾーンのIDです。
## ネイティブ広告とプッシュ通知で動的トークンを使用する
ステップ2でネイティブ広告またはプッシュ通知を使用してキャンペーンを作成する場合、次のような動的トークンを追加できます。 **表示する** **ローカライズされた** **テキスト** 訪問者の情報に基づいて表示し、より効果的に広告をターゲティングできます。
これらのトークンは次の項目で使用できます: **タイトル** と **説明** フィールド。トークンを追加するには、次の **「+トークンを追加」** ボタンをクリックし、ラジオボタンを使ってトークンの大文字/小文字の形式を選択します。この機能で利用できるトークンは次のとおりです:
* **{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}:** 訪問者が使用しているブラウザです。
これらの動的トークンは、キャンペーンに設定した言語で表示されます。次の言語は **バリエーションテキスト言語** の横にあるドロップダウンメニューの **配信アルゴリズム**。デフォルト言語は英語です。
{% hint style="info" %}
**注:** 1つのキャンペーン内のすべてのバリエーションには、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=&goal=
```
`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.