> 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/ko/partner-api-overview/frequently-asked-questions.md). # 자주 묻는 질문 ## 파트너 API를 사용한 일괄 작업 ### 일괄 작업이란 무엇인가요? 일괄 작업을 사용하면 개별 호출을 하는 대신 단일 API 요청으로 여러 캠페인, 지갑 또는 팀을 생성, 수정 또는 승인할 수 있습니다. ### 일괄 작업은 동기식인가요, 비동기식인가요? 비동기식입니다. 작업을 제출한 후 일괄 ID를 사용하여 결과를 폴링합니다. ### 일괄 요청의 일부 항목이 실패하면 어떻게 되나요? 각 항목은 독립적으로 검증됩니다. 성공한 항목과 구체적인 오류 메시지와 함께 실패한 항목을 보여주는 상세 결과를 받게 됩니다. ## 팀 및 사용자 ### 초대란 무엇인가요? 초대를 통해 사용자는 Epsilon Retail Media 플랫폼에서 팀에 참여할 수 있습니다. 초대는 일반적으로 팀 관리자가 전송하며 사용자가 팀 리소스에 액세스하려면 이메일이나 플랫폼 내에서 승인해야 합니다. ### 새 팀은 어떻게 생성하나요? 팀 이름, 회사 정보, 네임스페이스 ID와 같은 필수 필드와 함께 [Create team](/retail-media-interface/partner/ko/team-user-api/team/createteam-1.md) 엔드포인트를 사용하세요. 조직 내에서 팀을 생성하려면 적절한 권한이 필요합니다. ### 여러 팀에 소속될 수 있나요? 네, 사용자는 동시에 여러 팀에 소속될 수 있습니다. 각 팀 멤버십은 서로 다른 권한 수준과 역할을 가질 수 있습니다. ### 리테일러 팀과 공급업체 팀의 차이점은 무엇인가요? 리테일러 팀은 캠페인을 관리하고 검토하는 반면, 공급업체 팀(광고주)은 캠페인을 생성하고 관리합니다. 팀 유형에 따라 사용 가능한 기능과 권한이 결정됩니다. ### 사용자 권한은 어떻게 변경하나요? 팀 관리자는 Modify user permission 엔드포인트를 사용하여 사용자 권한을 수정할 수 있습니다. 권한 유형에는 리테일러 및 공급업체 역할 모두에 대한 전체 액세스(Full access) 및 리포트 보기(Report View)가 포함됩니다. ### 팀에서 사용자를 제거하면 어떻게 되나요? 사용자를 제거하면 해당 팀의 리소스, 캠페인 및 데이터에 대한 액세스 권한이 취소됩니다. 해당 사용자는 더 이상 팀 알림을 받지 못하며 팀 전용 작업을 수행할 수 없게 됩니다. ### 초대 토큰은 얼마 동안 유효한가요? 초대 토큰에는 만료 기간이 있습니다. 초대가 만료되어 새 토큰이 필요한 경우 팀 관리자에게 문의하세요. ### 생성 후 팀 정보를 업데이트할 수 있나요? 네, Update a team 엔드포인트를 사용하여 이름, 회사 정보, 전화번호, 웹사이트 URL 및 주소를 포함한 팀 세부 정보를 수정할 수 있습니다. ### 로고로 어떤 파일 유형을 업로드할 수 있나요? 해당 [Upload a file](/retail-media-interface/partner/ko/team-user-api/user-1/uploadfile-1.md) 엔드포인트는 팀 및 사용자 프로필 로고에 대한 일반적인 이미지 형식을 지원합니다. 특정 파일 크기 및 형식 요구 사항은 API 설명서를 확인하세요. ### 참여할 수 있는 팀은 어떻게 찾나요? 이름과 같은 적절한 필터와 함께 Lists all teams 엔드포인트를 사용하여 `namespace_id`, or `seller_id` 조직 내에서 이용 가능한 팀을 확인하세요. ## List campaigns ### 언제 사용해야 하나요? `managedOnly`? 다음에서 Epsilon Retail Media 시스템에서 일부 캠페인은 공급업체가 아닌 리테일러에 의해 관리됩니다. 상품 광고의 경우 이용 가능한 유일한 지출 유형은 고정 게재입니다. 고정 게재 캠페인만 가져오려면 `managedOnly` 매개변수를 사용하세요. ## Create or update campaigns ### 언제 사용하나요? `managerTeamId`? 고정 게재 캠페인을 생성하거나 업데이트할 때 `managerTeamId` 매개변수를 사용하세요. `managerTeamId`를 지정할 때는 관련 고정 게재 전략 설정도 지정해야 합니다. ### 무엇인가요? `namespaceId`? 해당 `namespaceId` 은 캠페인이 생성되거나 업데이트되는 네임스페이스의 고유 식별자입니다. 자세한 내용은 Namespaces를 참조하세요. Customer Integration Engineer(CIE)에게 문의하여 이 값을 얻을 수도 있습니다. ### 무엇인가요? `placementId`? 게재위치는 광고가 표시되는 위치를 지정합니다. Epsilon Retail Media 시스템의 각 게재위치에는 다음과 같은 고유 식별자가 있습니다. `placementId`. 다음 항목을 사용합니다. [Returns a list of placements](/retail-media-interface/partner/ko/global-api/placements/listplacements.md) API를 사용하여 `placementId`를 가져오세요. 또는 CIE에 문의하여 이 값을 얻으세요. ### 무엇인가요? `walletId`? walletId는 광고주 지갑의 식별자입니다. 각 광고주는 하나 또는 여러 개의 지갑을 가질 수 있습니다. 각 지갑에는 사용할 수 있는 크레딧 값이 있습니다. walletId를 설정하면 캠페인 비용이 청구될 광고주의 지갑을 설정하게 됩니다. ### 무엇인가요? `templateId`? 해당 `templateId` 은 Ad Genius 구현에 사용됩니다. 대부분의 고객이 일반적으로 사용하지 않으며 보통 무시해도 됩니다. ### 맞춤 필드란 무엇인가요? 내 Epsilon Retail Media 플랫폼에서 일부 리테일러는 구매 주문 및 구매자 세부 정보와 같은 캠페인용 사용자 지정 속성이 필요합니다. 예시는 아래와 같습니다.
Custom fields.png
연동에 이러한 항목이 필요하지 않은 경우 이 필드를 무시할 수 있습니다. 필요한 경우 CIE가 필요한 ID를 제공합니다. ### 사용자 지정 질문이란 무엇인가요? 고객 타겟팅 데이터가 연동된 네임스페이스에서 광고주는 다음을 사용하여 고객 세그먼트를 타겟팅할 수 있습니다. `key:value` 쌍. 자세한 내용은 고객 데이터를 참조하세요. 사용자 지정 질문이 있는 네임스페이스에서는 광고주에게 이러한 질문이 선택 사항인지 필수 사항인지 표시하고 관련 구성을 제공할 수 있습니다. 네임스페이스에 구성되어 있는 경우 CIE가 `customQuestionIds` 를 제공할 수 있습니다. ### 지정해야 하나요? `startTime` 및 `endTime`? 캠페인을 상시 진행(always on)하려는 경우 이 항목을 생략할 수 있습니다. 광고주가 활성 기간을 설정하려는 경우 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**: 크레딧 한도는 10, 지갑 잔액은 20입니다. * **예시 2**: 일일 예산은 1000, 지갑 잔액은 10,000입니다. * **예시 3**: 일일 예산은 250, 크레딧 한도는 20, 지갑 잔액은 200입니다. 이 경우 사용 가능한 잔액(현재 잔액 + 크레딧 한도)이 일일 한도 + 미사용 이월액(250)보다 적기 때문에 상한이 설정된 사용 가능한 잔액은 220입니다. {% hint style="info" %} 크레딧 한도는 기존 기능이며 대부분의 리테일러에서 지원하지 않습니다. {% endhint %} ### 지갑 잔액이 음수가 될 수 있나요? 아니요. 파트너 API를 통해 지갑 잔액을 의도적으로 음수로 설정할 수 없습니다. 캠페인 활동이 잔액에 일시적으로 영향을 미칠 수 있지만, 이러한 동작은 시스템에 의해 제어되며 사용자가 제어할 수 없습니다. ### 캠페인을 생성하는 동안 지갑을 선택할 수 없는 이유는 무엇인가요? 지갑의 통화가 카탈로그의 통화와 일치해야 합니다. 예를 들어 카탈로그가 AUD로 되어 있다면 GBP 통화의 지갑을 선택할 수 없습니다. 자세한 내용은 다음을 참조하세요. [카탈로그와의 통화 호환성](/retail-media-interface/partner/ko/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/ko/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.