> 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/partner-api-overview/frequently-asked-questions.md). # よくある質問 ## Partner API による一括操作 ### 一括操作とは何ですか？ 一括操作を使用すると、個別にリクエストを実行するのではなく、単一の API リクエストで複数のキャンペーン、ウォレット、またはチームを作成、編集、または承認できます。 ### 一括操作は同期処理ですか、それとも非同期処理ですか？ 非同期処理です。ジョブを送信し、bulk ID を使用して結果をポーリングします。 ### 一括リクエスト内の一部の項目が失敗した場合はどうなりますか？ 各項目は個別に検証されます。特定のエラーメッセージとともに、成功した項目と失敗した項目を示す詳細な結果が返されます。 ## チームとユーザー ### 招待とは何ですか？ 招待とは、ユーザーが以下のチームに参加できるようにするためのものです： Epsilon Retail Media プラットフォーム。招待は通常、チーム管理者が送信し、ユーザーがチームリソースにアクセスできるようになる前に、メールまたはプラットフォーム内で承諾される必要があります。 ### 新しいチームを作成するにはどうすればよいですか？ 以下を使用します： [チームを作成する](/retail-media-interface/partner/ja/team-user-api/team/createteam-1.md) チーム名、会社情報、namespace ID などの必須フィールドを含むエンドポイント。組織内にチームを作成するには、適切な権限が必要です。 ### 複数のチームに所属することはできますか？ はい、ユーザーは同時に複数のチームに所属できます。各チームのメンバーシップごとに、異なる権限レベルやロールを設定できます。 ### リテールチームとサプライヤーチームの違いは何ですか？ リテールチームはキャンペーンを管理および審査し、サプライヤーチーム（広告主）はキャンペーンを作成および管理します。チームのタイプによって、利用可能な機能と権限が決定されます。 ### ユーザー権限を変更するにはどうすればよいですか？ チーム管理者は、Modify user permission エンドポイントを使用してユーザー権限を変更できます。権限のタイプには、リテールおよびサプライヤーの両方のロールに対して、Full access および Report View が含まれます。 ### ユーザーをチームから削除するとどうなりますか？ ユーザーを削除すると、そのチームのリソース、キャンペーン、データへのアクセス権が取り消されます。ユーザーはチームの通知を受信しなくなり、チーム固有のアクションを実行できなくなります。 ### 招待トークンの有効期限はどのくらいですか？ 招待トークンには有効期限があります。招待の有効期限が切れて新しいトークンが必要な場合は、チーム管理者にお問い合わせください。 ### 作成後にチーム情報を更新することはできますか？ はい、Update a team エンドポイントを使用して、名前、会社情報、電話番号、ウェブサイト URL、住所などのチームの詳細を更新できます。 ### ロゴとしてアップロードできるファイル形式は何ですか？ 以下の [ファイルをアップロード](/retail-media-interface/partner/ja/team-user-api/user-1/uploadfile-1.md) エンドポイントは、チームおよびユーザープロファイルのロゴ用の一般的な画像形式をサポートしています。具体的なファイルサイズと形式の要件については、API ドキュメントを確認してください。 ### 参加できるチームを見つけるにはどうすればよいですか？ Lists all teams エンドポイントを使用し、名前や `namespace_id`, or `seller_id` などの適切なフィルターを設定して、組織内で利用可能なチームを検索します。 ## キャンペーンの一覧取得 ### いつ使用すべきですか： `managedOnly`？ 以下の Epsilon Retail Media システムでは、一部のキャンペーンはサプライヤーではなくリテーラーによって管理されます。プロダクト広告の場合、利用可能な唯一の消化タイプは固定掲載です。 `managedOnly` パラメーターを使用して、固定掲載キャンペーンのみを取得します。 ## キャンペーンの作成または更新 ### いつ使用しますか： `managerTeamId`？ 固定掲載キャンペーンを作成または更新する場合は、 `managerTeamId` パラメーターを使用します。 `managerTeamId`を指定する場合は、関連する固定掲載戦略の設定も指定する必要があります。 ### とは何ですか `namespaceId`? その `namespaceId` は、キャンペーンが作成または更新されるネームスペースの固有識別子です。詳細については、「ネームスペース」を参照してください。この値を取得するために、カスタマーインテグレーションエンジニア（CIE）にお問い合わせいただくこともできます。 ### とは何ですか `placementId`? 配置は広告が表示される場所を指定します。システム内の各配置には Epsilon Retail Media と呼ばれる一意の識別子があります。 `placementId`。 を使用します [配置の一覧を返します](/retail-media-interface/partner/ja/global-api/placements/listplacements.md) を取得するためのAPI `placementId`。または、この値を取得するには CIE にお問い合わせください。 ### とは何ですか `walletId`? walletId は広告主のウォレットの識別子です。各広告主は 1 つまたは複数のウォレットを持つことができます。各ウォレットには、使用可能なクレジットの価値があります。walletId を設定することで、キャンペーンに対してどの広告主のウォレットに課金するかを設定します。 ### とは何ですか `templateId`? その `templateId` は Ad Genius の実装で使用されます。一般的にはほとんどのお客様に使用されず、通常は無視して問題ありません。 ### カスタムフィールドとは？ において Epsilon Retail Media プラットフォームでは、一部の小売業者は注文書やバイヤーの詳細など、キャンペーンのカスタム属性を必要とします。以下は例です。
Custom fields.png
連携でこれらが不要な場合は、このフィールドを無視できます。必要な場合は、CIE が必要な ID を提供します。 ### カスタムクエスチョンとは何ですか？ 統合されたカスタマーターゲティングデータを持つネームスペースでは、広告主は次を使用して顧客セグメントをターゲットにできます。 `key:value` ペアリング。詳細については、「顧客データ」を参照してください。 カスタムクエスチョンを持つネームスペースでは、これらの質問がオプションか必須かを広告主に示し、関連する設定を提供できます。CIE は以下を提供できます。 `customQuestionIds` これらがネームスペースで設定されている場合。 ### 指定する必要がありますか `startTime` と `endTime`? キャンペーンを常時掲載（常時有効）にする場合は、これを省略できます。広告主が有効期間を設定したい場合は、ISO-8601形式で両方の値を指定する必要があります。 ### 更新（PATCH）を実行する際、キャンペーンオブジェクト全体を送信せずに特定のプロパティのみを更新するにはどうすればよいですか？ 当社のAPIでは `mask` プロパティを使用しているため、キャンペーンオブジェクト全体を送信することなく、特定のプロパティを更新できます。 #### 重要なポイント * 配置\*\*: `mask` プロパティがリクエスト内で正しく配置されていることを確認してください。 * **エラー処理:** 権限エラーが発生した場合は、リクエスト内のマスクの形式を確認してください。 #### 例 キャンペーン名のような**シンプルなプロパティを変更する場合**は、次を使用します: ```json { "productCampaign": { "name": "new campaign name" }, "mask": "name" } ``` のような\*\*入れ子状のプロパティを変更する場合 `maxBid`: ```json { "productCampaign": { "strategy": { "auction": { "maxBid": "5" } } }, "mask": "strategy.auction.maxBid" } ``` のような\*\*複数のプロパティを変更する場合 `searchTerms` および `maxBid`、更新するプロパティのカンマ区切りリストを次で使用します `mask` プロパティ: ```json { "productCampaign": { "targeting": { "searchTerms": [ { "matchType": "MATCH_TYPE_EXACT_MATCH", "phrase": "yoghurt_new", "suggested": false }, { "matchType": "MATCH_TYPE_EXACT_MATCH", "phrase": "dairy", "suggested": false }, { "matchType": "MATCH_TYPE_EXACT_MATCH", "phrase": "cheezy_new", "suggested": false } ] }, "strategy": { "auction": { "maxBid": "6.5" } } }, "mask": "targeting.searchTerms,strategy.auction" } ``` ## ウォレット ### なぜウォレットが必要なのですか？ ウォレットはキャンペーン資金を管理し、取引が正しい通貨で処理されるようにするために使用されます。詳細については、目的を参照してください。 ### 複数のウォレットを持つことはできますか？ はい、異なる通貨やキャンペーン予算を別々に管理するために、複数のウォレットを作成できます。詳細については、複数のウォレットを参照してください。 ### ウォレットIDはどこで確認できますか？ ウォレットIDを確認するには、次の手順を実行します。 **旧プラットフォーム:** **チーム請求** ページに移動して、ウォレットIDを表示します。 **新しいUI:** **ウォレットマネージャー** を開いて、ウォレットIDを確認します。 {% hint style="info" %} チームによっては異なる通貨のウォレットを複数所有している場合があるため、正しいウォレットを選択していることを確認してください。 {% endhint %} ### 現在残高とは何ですか？ 現在残高とは、クレジットのチャージや限度額が適用されていないウォレットの残高です。 ### 利用可能残高とは何ですか？ 利用可能残高とは、任意の時点で使用可能なウォレット内の合計金額です。これには現在残高と与信限度額が含まれます。 ### 1日の限度額または1日の消化額とは何ですか？ 1日の限度額とは、ウォレットが1日に消化できる最大金額です。 ### 予算ペース調整とは何ですか？ 予算ペース調整とは、1日の限度額の未消化資金が翌日の1日の限度額に繰り越されることを意味します。 ### 1日の残りの限度額とは何ですか？ 1日の残りの限度額とは、前日からの1日の限度額の未消化資金です。 ### 上限付き利用可能残高とは何ですか？ 上限付き利用可能残高とは、消化限度額やチャージクレジットを考慮して、ウォレットでその日に消化が許可されている金額です。この値は使用可能な資金があるかどうかを判断するため、非常に重要です。 **上限付き利用可能残高の計算**: * **与信限度額のみ**: 上限付き利用可能残高 = 利用可能残高。 * **1日の限度額のみ**: 上限付き利用可能残高 = 1日の限度額 + 未消化の繰越額 * **与信限度額と1日の限度額の両方が適用される場合**: (利用可能残高、1日の限度額 + 繰越額) のいずれか小さい方 以下にいくつかの例を示します: * **例1**: 与信限度額が10、ウォレット残高が20。 * **例2**: 1日の予算が1000、ウォレット残高が10,000。 * **例3**: 1日の予算が250、与信限度額が20、ウォレット残高が200。この場合、利用可能残高（現在残高 + 与信限度額）が1日の限度額に未消化の繰越額を加えた額（250）を下回るため、上限付き利用可能残高は220になります。 {% hint style="info" %} 与信限度額は従来の機能であり、ほとんどのリテールパートナーではサポートされていません。 {% endhint %} ### ウォレット残高がマイナスになることはありますか？ いいえ。Partner APIを介してウォレット残高を意図的にマイナスに設定することはできません。キャンペーンのアクティビティによって一時的に残高に影響が出る場合がありますが、この動作はシステムによるものであり、ユーザーが制御できるものではありません。 ### キャンペーン作成時にウォレットを選択できないのはなぜですか？ ウォレットの通貨はカタログの通貨と一致している必要があります。たとえば、カタログがAUDの場合、GBPのウォレットを選択することはできません。詳細については、次を参照してください: [カタログとの通貨の互換性](/retail-media-interface/partner/ja/billing-api/wallet.md#currency-compatibility-with-catalogs). --- # 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/partner-api-overview/frequently-asked-questions.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.