> 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/pt-br/partner-api-overview/frequently-asked-questions.md). # Perguntas frequentes ## Operações em lote com APIs de parceiros ### O que são operações em lote? As operações em lote permitem criar, editar ou aprovar várias campanhas, carteiras ou equipes em uma única solicitação de API, em vez de fazer chamadas individuais. ### As operações em lote são síncronas ou assíncronas? Assíncronas. Você envia um trabalho e consulta os resultados usando o ID em lote. ### O que acontece se alguns itens na minha solicitação em lote falharem? Cada item é validado de forma independente. Você receberá resultados detalhados mostrando quais tiveram sucesso e quais falharam com mensagens de erro específicas. ## Equipe e Usuário ### O que é um convite? Um convite permite que um usuário se junte a uma equipe na Epsilon Retail Media plataforma. Os convites são normalmente enviados por administradores da equipe e devem ser aceitos por e-mail ou na plataforma antes que o usuário possa acessar os recursos da equipe. ### Como crio uma nova equipe? Use o [Criar equipe](/retail-media-interface/partner/pt-br/team-user-api/team/createteam-1.md) ponto de extremidade com os campos obrigatórios, como nome da equipe, informações da empresa e ID do namespace. Você precisará de permissões adequadas para criar equipes em sua organização. ### Posso pertencer a várias equipes? Sim, os usuários podem pertencer a várias equipes simultaneamente. Cada associação de equipe pode ter diferentes níveis de permissão e funções. ### Qual é a diferença entre as equipes do Varejista e do Fornecedor? As equipes do Varejista gerenciam e revisam campanhas, enquanto as equipes do Fornecedor (anunciantes) criam e gerenciam campanhas. O tipo de equipe determina os recursos e permissões disponíveis. ### Como altero minhas permissões de usuário? Os administradores da equipe podem modificar as permissões do usuário usando o ponto de extremidade Modificar permissão do usuário. Os tipos de permissão incluem Acesso total e Visualização de relatório para as funções de Varejista e Fornecedor. ### O que acontece quando removo um usuário de uma equipe? A remoção de um usuário revoga seu acesso aos recursos, campanhas e dados dessa equipe. O usuário não receberá mais notificações da equipe nem poderá realizar ações específicas da equipe. ### Por quanto tempo os tokens de convite são válidos? Os tokens de convite têm um período de expiração. Entre em contato com o administrador da equipe se o seu convite expirou e você precisar de um novo. ### Posso atualizar as informações da equipe após a criação? Sim, use o ponto de extremidade Atualizar uma equipe para modificar os detalhes da equipe, incluindo nome, informações da empresa, número de telefone, URL do site e endereço. ### Quais tipos de arquivo posso enviar para logotipos? O [Enviar um arquivo](/retail-media-interface/partner/pt-br/team-user-api/user-1/uploadfile-1.md) ponto de extremidade suporta formatos de imagem comuns para logotipos de perfil de equipe e usuário. Verifique a documentação da API para obter requisitos específicos de tamanho e formato de arquivo. ### Como encontro equipes às quais posso me juntar? Use o ponto de extremidade Listar todas as equipes com filtros apropriados, como nome, `namespace_id`, or `seller_id` para descobrir equipes disponíveis em sua organização. ## Listar campanhas ### Quando devo usar `managedOnly`? No Epsilon Retail Media sistema, algumas campanhas são gerenciadas por varejistas em vez de fornecedores. Para anúncios de produtos, o único tipo de gasto disponível é o posicionamento fixo. Use o `managedOnly` parâmetro para buscar apenas campanhas de posicionamento fixo. ## Criar ou atualizar campanhas ### Quando eu uso `managerTeamId`? Use o `managerTeamId` parâmetro ao criar ou atualizar campanhas de posicionamento fixo. Ao especificar `managerTeamId`, você também precisará especificar as configurações de estratégia de posicionamento fixo relevantes. ### O que é um `namespaceId`? O `namespaceId` é o identificador exclusivo do namespace onde as campanhas são criadas ou atualizadas. Para obter mais informações, consulte Namespaces. Você também pode entrar em contato com seu Engenheiro de Integração com o Cliente (CIE) para obter esse valor. ### O que é um `placementId`? Os posicionamentos especificam os locais onde os anúncios são exibidos. Cada posicionamento no Epsilon Retail Media sistema tem um identificador exclusivo chamado `placementId`. Use o [Retorna uma lista de posicionamentos](/retail-media-interface/partner/pt-br/global-api/placements/listplacements.md) API para buscar o `placementId`. Alternativamente, entre em contato com seu CIE para obter esse valor. ### O que é um `walletId`? Um walletId é o identificador da carteira de um anunciante. Cada anunciante pode ter uma ou muitas carteiras. Cada carteira terá um valor de créditos que pode gastar. Ao definir o walletId, você está definindo qual carteira do anunciante será cobrada pela campanha. ### O que é um `templateId`? O `templateId` é usado em implementações do Ad Genius. Não é comumente usado pela maioria dos clientes e geralmente pode ser ignorado. ### O que são campos personalizados? Na Epsilon Retail Media plataforma, alguns varejistas precisam de atributos personalizados para campanhas, como pedidos de compra e detalhes do comprador. Um exemplo está abaixo:
Custom fields.png
Se a sua integração não exigir isso, você pode ignorar este campo. Se exigir, seu CIE fornecerá os IDs necessários. ### O que são perguntas personalizadas? Em namespaces com dados de direcionamento de clientes integrados, os anunciantes podem direcionar segmentos de clientes usando `key:value` combinações. Para obter mais informações, consulte Dados do cliente. Em namespaces com perguntas personalizadas, você pode indicar aos anunciantes se essas perguntas são opcionais ou obrigatórias e fornecer a configuração relevante. Seu CIE pode fornecer o `customQuestionIds` se estiverem configuradas em seu namespace. ### Preciso especificar `startTime` e `endTime`? Você pode omitir isso se a campanha for destinada a ficar sempre ativa. Se o seu anunciante quiser definir um período ativo, você deve fornecer ambos os valores no formato ISO-8601. ### Como posso atualizar uma propriedade específica sem enviar todo o objeto da campanha ao fazer uma atualização (PATCH)? Nossas APIs usam uma `mask` propriedade que permite atualizar uma propriedade específica sem enviar todo o objeto da campanha. #### Pontos principais * Posicionamento\*\*: Garanta que a `mask` propriedade esteja posicionada corretamente em sua solicitação. * **Tratamento de erros:** Se você encontrar um erro de permissões, verifique o formato da máscara em sua solicitação. #### Exemplos **Alterando uma propriedade simples** como o nome da campanha, use o seguinte: ```json { "productCampaign": { "name": "new campaign name" }, "mask": "name" } ``` Alterando uma propriedade aninhada\*\* como o `maxBid`: ```json { "productCampaign": { "strategy": { "auction": { "maxBid": "5" } } }, "mask": "strategy.auction.maxBid" } ``` Alterar várias propriedades\*\* como `searchTerms` e o `maxBid`, use uma lista delimitada por vírgulas das propriedades que você está atualizando na `mask` propriedade: ```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" } ``` ## Carteira ### Por que preciso de uma carteira? As carteiras são usadas para gerenciar os fundos da campanha e garantir que as transações sejam processadas na moeda correta. Para obter mais informações, consulte Finalidade. ### Posso ter várias carteiras? Sim, você pode criar várias carteiras para gerenciar diferentes moedas ou orçamentos de campanha separadamente. Para obter mais informações, consulte Várias carteiras. ### Onde posso encontrar um ID de carteira? Para encontrar um ID de carteira, você pode seguir estas etapas: **Plataforma legada:** Vá para a página **Faturamento da equipe** para ver o ID da sua carteira. **Nova interface:** Abra o **Gerenciador de carteiras** para encontrar o ID da sua carteira. {% hint style="info" %} Algumas equipes podem ter várias carteiras em moedas diferentes, portanto, certifique-se de selecionar a correta. {% endhint %} ### Qual é o saldo atual? O saldo atual é o saldo da carteira sem recargas de crédito ou limites aplicados. ### Qual é o saldo disponível? O saldo disponível é o valor total na carteira que está disponível para gastar a qualquer momento. Ele inclui o saldo atual mais qualquer limite de crédito. ### O que é um limite diário ou gasto diário? Um limite diário é o valor máximo que sua carteira pode gastar em um único dia. ### O que é ritmo de orçamento? Ritmo de orçamento significa que quaisquer fundos não gastos do limite diário serão transferidos para o limite diário do dia seguinte. ### Qual é o limite diário restante? O limite diário restante é o valor do limite diário não gasto do dia anterior. ### Qual é o saldo disponível limitado? O saldo disponível limitado é o valor que a carteira permite que você gaste no dia, considerando quaisquer limites de gastos e/ou créditos de recarga. Esse valor é crucial porque determina se há dinheiro disponível para gastos. **Cálculo do saldo disponível limitado**: * **Apenas limite de crédito**: Saldo disponível limitado = Saldo disponível. * **Apenas limite diário**: Saldo disponível limitado = Limite diário + saldo acumulado não gasto * **Limite de crédito e limite diário aplicados**: O menor valor entre (Saldo disponível, Limite diário + saldo acumulado) Aqui estão alguns exemplos: * **Exemplo 1**: O limite de crédito é 10, o saldo da carteira é 20. * **Exemplo 2**: O orçamento diário é 1000, o saldo da carteira é 10.000. * **Exemplo 3**: O orçamento diário é 250, o limite de crédito é 20, o saldo da carteira é 200. Neste caso, o saldo disponível limitado é 220 porque o saldo disponível (saldo atual + limite de crédito) é menor que o limite diário mais o saldo acumulado não gasto (250). {% hint style="info" %} Os limites de crédito são um recurso legado e não são suportados pela maioria dos varejistas. {% endhint %} ### O saldo da carteira pode ficar negativo? Não. Os saldos das carteiras não podem ser definidos intencionalmente como negativos por meio da Partner API. Embora a atividade da campanha possa afetar temporariamente os saldos, esse comportamento é controlado pelo sistema e não pelo usuário. ### Por que não consigo selecionar uma carteira ao criar uma campanha? A moeda da carteira deve coincidir com a moeda do catálogo. Por exemplo, se seu catálogo estiver em AUD, você não poderá selecionar uma carteira em GBP. Para obter mais informações, consulte [Compatibilidade de moeda com catálogos](/retail-media-interface/partner/pt-br/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/pt-br/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.