> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/ja/billing-api/wallet.md).

# ウォレット

## 概要

ウォレット API を使用すると、広告主はキャンペーンの予算編成や支出管理に使用されるデジタルウォレットを管理できます。各ウォレットは単一の通貨とチームに紐付けられており、日次予算や資金管理などの機能をサポートしています。

広告主は複数のウォレットを維持でき、それぞれに独自の与信残高と支出管理が設定されています。これらの API を使用すると、以下のことが可能です。

* ウォレット名の管理
* ウォレット ID の表示
* 通貨コードへのアクセス
* 日次予算の設定
* 現在の残高の確認
* 利用可能残高の表示
* アーカイブ状態の制御
* 資金の管理 (リテールメディア事業者のみ) など

### ウォレットの基本機能

#### 目的

ウォレットは、広告主がキャンペーン予算を管理、制御、およびレポートするために不可欠なツールです。地域、商品、チームごとに詳細なトラッキングが可能で、特定通貨での予算設定や支出管理をサポートします。

マーケティングチームが 3 つの地域 (米国、欧州、アジア太平洋) でキャンペーンを実行する必要があり、それぞれに独自の予算と通貨がある場合を考えてみましょう。3 つのウォレットを作成します。

* **米国ウォレット (USD)**: $20,000、日次上限 $2,000。
* **欧州ウォレット (EUR)**: €15,000、日次上限 €1,500。
* **アジア太平洋ウォレット (AUD)**: A$10,000、日次上限 A$1,000。

各キャンペーンは対応する地域のウォレットにリンクされます。米国ウォレットの残高が少なくなった場合、米国のキャンペーンのみが一時停止します。欧州とアジア太平洋は影響を受けずに継続します。ウォレットごとに支出、ROI、ペース配分をレポートでき、財務チームは各ウォレットを個別に照合できます。

{% hint style="info" %}
広告主は、同じ通貨をサポートしているリテールメディア事業者のカタログでのみウォレットを使用できます。
{% endhint %}

#### 複数のウォレット

広告主は、運用モデルに基づいて複数のウォレットを作成できます。各キャンペーンは一度に 1 つのウォレットにしかリンクできないため、明確な予算分離と支出トラッキングが確保されます。複数のウォレットを作成しない場合は、デフォルトのウォレットを自由に使用できます。

#### ウォレット間での予算管理

ウォレットは、通貨と目的に基づいて資金を整理することで、企業が広告予算を管理するのに役立ちます。例えば、大企業では部門やキャンペーンごとに個別のウォレットを作成できます。この設定により、各グループは他に影響を与えることなく自身の日次支出を管理できます。

各ウォレットは指定された通貨で与信残高を維持するため、複数の通貨にわたる予算管理が容易になります。広告主は複数のウォレットを作成でき、それぞれに独自の与信残高と固有のウォレット ID が付与されます。この ID は、ウォレットを個別に識別して管理するために使用されます。

{% hint style="info" %}
キャンペーンを実行するには、ウォレットに十分な資金が必要です。ウォレットが設定された予算に達すると、広告の配信が停止します。
{% endhint %}

各キャンペーンは一度に 1 つのウォレットにしかリンクできないため、中断のないキャンペーン配信にはウォレット残高を効果的に管理することが非常に重要です。

#### カタログとの通貨互換性

ウォレットの作成や編集などの一部のウォレット機能は、リテールメディア事業者の設定によっては、すべての広告主が利用できるとは限りません。リテールメディア事業者に制限がある場合は関連するエラーメッセージが表示され、特定の一部のウォレット関連機能が UI 上で非表示になることがあります。

キャンペーンを作成してカタログを選択する際、各カタログは特定の通貨に関連付けられています。カタログの通貨と一致するウォレットを選択する必要があります。例えば、カタログが AUD (オーストラリアドル) を使用している場合、GBP (英ポンド) のウォレットを選択することはできません。キャンペーン作成時に、不一致な通貨を選択できないようシステムが防ぎます。

### ウォレットの機能

ウォレットは、以下のようなキャンペーン全体の予算と支出の管理に役立ちます。

* **マルチウォレットのサポート**: チーム、キャンペーン、または部門ごとに予算を分離できます。
* **特定通貨向けウォレット**: 単一の通貨で運用されます。
* **アーカイブされたウォレット**: アクティブなキャンペーンに影響を与えることなく履歴を保持します。

### ウォレットの要素

各ウォレットには以下の主要要素が含まれます。

| 名前       | 説明                                                                                          |
| -------- | ------------------------------------------------------------------------------------------- |
| ウォレット名   | ウォレットに割り当てられた名前。                                                                            |
| ウォレット ID | キャンペーンに対して正しいウォレットに請求するために使用される固有の識別子。                                                      |
| 通貨       | ウォレットが運用される通貨。                                                                              |
| 現在の残高    | 与信限度額を除くウォレットの残高。                                                                           |
| 利用可能残高   | 与信限度額を含む、支出可能な総額。                                                                           |
| 与信限度額    | <p>毎月リセットされる超過支出許容量。<br><strong>注</strong>: これはレガシー機能であり、ほとんどのリテールメディア事業者ではサポートされていません。</p> |
| アーカイブ状態  | ウォレットがアクティブではなくなったものの、記録のために保持されていることを示します。                                                 |

チームのウォレットは \*\*ウォレット \*\*セクションで確認できます。リテールメディア事業者の設定によっては、特定のウォレット設定を表示または変更できる場合があります。

#### 例

会社 A は、広告予算を 3 つの商品タイプに割り当てることを計画しています。商品 A に $10,000、商品 B に $5,000、商品 C に $1,200 です。これを管理するために、会社は 3 つの個別のウォレットを作成し、それぞれの商品タイプに対応する金額を設定します。

キャンペーンをセットアップする際、各キャンペーンはそれぞれの商品に割り当てられたウォレットにリンクされます。この設定により、チームは商品タイプごとに広告支出を独立して管理および監視でき、予算が意図した通りに使用されるようになります。

#### 外部 ID とは何ですか？

**外部 ID** は、注文書 (PO)、Salesforce ID、Placement IO 番号などのカスタム参照番号を保存できるオプションのフィールドです。パートナーがウォレットを追跡し、自社のシステムにリンクするのに役立ちます。

> **注:** このフィールドは、リテールメディア事業者が機能フラグを有効にしている場合にのみ表示されます。

### 予算上限とペース配分

広告主が日次広告支出を効果的に管理できるように、ウォレットは以下の管理機能をサポートしています。

#### 日次上限 / 日次支出

ウォレットが 1 日に支出できる最大金額。この上限により、キャンペーンがあらかじめ定義された日次予算を超えないようにします。

#### 予算のペース配分

ある日に日次上限の全額が消費されなかった場合、未消費の金額は翌日に繰り越されます。これにより、複数日にわたる予算の柔軟なペース配分が可能になります。

#### 残りの日次上限

前日から未消費のまま残っている日次上限の割合。この金額は翌日の日次上限に追加され、累積的な支出の柔軟性が有効になります。

> **注:** 日次予算上限の利用可否は、リテールメディア事業者が機能フラグを有効にしているかどうかによって異なります。

### 利用可能なエンドポイント

| エンドポイント                                                                                       | 説明                                                       |
| --------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| [ウォレットを作成する](/retail-media-interface/partner/ja/billing-api/wallet/createwallet.md)           | ネームスペース、チーム、名前、通貨、日別予算、およびオプションの外部IDを使用して新しいウォレットを構成します。 |
| [ウォレットを更新する](/retail-media-interface/partner/ja/billing-api/wallet/updatewallet-1.md)         | ウォレット名、通貨、日別予算、信用限度額、または外部IDを修正します。                      |
| [IDによるウォレットの取得](/retail-media-interface/partner/ja/billing-api/wallet/getwallet-1.md)         | 一意の識別子を使用してウォレットの詳細を取得します。                               |
| [すべてのウォレットを一覧表示する](/retail-media-interface/partner/ja/billing-api/wallet/listwallets.md)      | チームに関連付けられているすべてのウォレットのリストを取得します。                        |
| [特定のウォレットの残高を取得する](/retail-media-interface/partner/ja/billing-api/wallet/getwalletbalance.md) | 一意の識別子を使用して、現在の残高と利用可能な残高を確認します。                         |
| [特定のウォレットへの資金を管理する](/retail-media-interface/partner/ja/billing-api/wallet/managefunds.md)     | ウォレットに資金を追加して、キャンペーンの支出に使用できる残高を増やします。                   |

### ウォレットAPIのフィールド定義

以下は、APIのリクエストとレスポンスでよく使用される主要なウォレットフィールドです。

| フィールド            | 説明                                                                                    |
| ---------------- | ------------------------------------------------------------------------------------- |
| walletId         | ウォレットの一意の識別子。                                                                         |
| currency         | 通貨コード（例：USD、EUR）。                                                                     |
| creditLimit      | <p>月間の超過支出許容量。<br><strong>注</strong>: これはレガシー機能であり、ほとんどのリテールメディア事業者ではサポートされていません。</p> |
| dailyBudget      | 日別支出上限。                                                                               |
| availableBalance | クレジットを含む消費可能額。                                                                        |
| currentBalance   | クレジットを除く実際のウォレット残高。                                                                   |
| externalId       | 発注書番号、Salesforce IDなどのオプションフィールド。                                                     |
| archived         | ウォレットがアーカイブされているかどうかを示すブール値フラグ。                                                       |

よくある質問やトラブルシューティングについては、次を参照してください： [よくある質問](/retail-media-interface/partner/ja/partner-api-overview/frequently-asked-questions.md#wallet).


---

# 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://help.citrusad.com/retail-media-interface/partner/ja/billing-api/wallet.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.