# Guia de Sincronização de Oferta

O objetivo geral de usar o recurso de API é importar/sincronizar as ofertas rapidamente das plataformas do anunciante, respectivamente.

#### **1.** Integração **»** **Sincronização de Ofertas**

![](https://2731110321-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME6HkHUCzlM0Mu33Q9W%2F-MMnbCRAAJrecIJk_pQ7%2F-MMnezTruHuq_1A8-sjb%2F5f2957652ff7bc16ab40b0114ad2bc96.gif?alt=media\&token=e63749c4-dd17-4a66-a535-2da016dc5d7f)

**2. Selecionar Rede / Plataforma do Parceiro »** **Configuração** 

***

### **Ir para Credenciais**

**Credenciais -** Estes serão os detalhes da API fornecidos pelo anunciante, que incluirão domínio da API e chave como credenciais principais. Normalmente, estes sempre mudam conforme as plataformas

<figure><img src="https://4294454144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2FiCJzWDGHotI1R1Pxw9AN%2Fimage.png?alt=media&#x26;token=942bc9f5-01aa-436e-aaaf-34e57b2b70c5" alt=""><figcaption></figcaption></figure>

1. Especifique o nome da API
2. Insira as Credenciais da API
3. Ir para o Próximo&#x20;

***

### **Ir para Configurações**

A linha de opções inclui várias configurações que o usuário deseja aplicar nas ofertas importadas

<figure><img src="https://4294454144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2F6zacFRFZIOEOlpu7qjt0%2Fimage.png?alt=media&#x26;token=6f74195a-7006-4f9a-bbe6-e38339cb1cbc" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Campos</strong></td><td><strong>Descrição</strong></td></tr><tr><td>Agendamento</td><td>Esta é a programação que define com que frequência a API deve ser atualizada automaticamente</td></tr><tr><td>Percentual de Pagamento ao Afiliado</td><td>Isso ajuda a especificar a % do pagamento que o usuário deseja compartilhar com seu afiliado</td></tr><tr><td>Parar Oferta</td><td>Os usuários podem configurar quais configurações devem ser aplicadas às ofertas que não foram sincronizadas na próxima sincronização agendada da API</td></tr><tr><td>Anunciante</td><td>Este será o perfil desse anunciante criado pelo usuário sob o qual todas as ofertas sincronizadas serão salvas</td></tr><tr><td>Visibilidade da Oferta</td><td>O usuário pode selecionar por padrão o status de visibilidade das ofertas sincronizadas para afiliados.<br>(Público, Público + Aprovação Necessária, Privado)</td></tr><tr><td>Fallback</td><td>Fallback global e fallback personalizado podem ser aplicados às ofertas sincronizadas </td></tr><tr><td>Categoria da Oferta</td><td>A categoria pode ser selecionada para as ofertas sincronizadas </td></tr><tr><td>Descrição da Oferta</td><td>A descrição adicionada aqui será pré-posta na descrição da oferta sincronizada</td></tr><tr><td>KPI da Oferta</td><td>O KPI da oferta adicionado aqui será pré-posto na descrição da oferta sincronizada</td></tr><tr><td>Remover Tokens da URL de Rastreamento</td><td>Usando esta opção, é possível remover tokens desnecessários na URL da oferta</td></tr><tr><td>Anexar Tokens na URL de Rastreamento</td><td>Usando esta opção, é possível anexar tokens necessários na URL da oferta</td></tr><tr><td>Atribuir Afiliados</td><td>É possível atribuir afiliados às ofertas sincronizadas</td></tr><tr><td>Ação de Excesso de Limite</td><td>Ações de excesso de limite podem ser adicionadas às ofertas sincronizadas</td></tr></tbody></table>

***

### **Ir para Filtros**

Usando as opções de filtro, é possível filtrar os resultados da sincronização para obter dados específicos/desejados dos anunciantes&#x20;

<figure><img src="https://4294454144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2FJw3ZOrVfFq4JjNfoKSiq%2Fimage.png?alt=media&#x26;token=3cb98757-fedc-4549-acc6-6754eb6e4f33" alt=""><figcaption></figcaption></figure>

Filtros na Sincronização de Ofertas são

<table data-header-hidden><thead><tr><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Filtro</strong> </td><td><strong>Descrição</strong></td></tr><tr><td>Limite de Sincronização de Ofertas</td><td>É possível limitar a quantidade de ofertas a serem sincronizadas pela API </td></tr><tr><td>Modelo </td><td>Ofertas com modelos específicos podem ser filtradas usando isto </td></tr><tr><td>Intervalo de Preço</td><td>É possível definir um limite inferior e superior para o preço das ofertas a serem sincronizadas pela API </td></tr><tr><td>offer_status</td><td>Ofertas com status específico podem ser filtradas usando isto<br>aprovado/expirado</td></tr><tr><td>SO </td><td>Ofertas para sistemas operacionais específicos podem ser filtradas usando isto </td></tr><tr><td>País </td><td>Ofertas para países específicos podem ser filtradas usando isto </td></tr><tr><td>Moeda</td><td>Ofertas para moeda específica podem ser filtradas usando isto </td></tr><tr><td>Eventos / Metas</td><td>Ofertas que contêm eventos específicos podem ser filtradas usando isto</td></tr><tr><td>Ofertas do Anunciante</td><td>É possível especificar o ID do anunciante cujas ofertas devem ser sincronizadas ou não sincronizadas</td></tr></tbody></table>

**Campos**

Estes são os campos que podem ser configurados pelo usuário para sincronizar sempre, uma vez ou nunca.

<figure><img src="https://4294454144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2FOvwT1jeHkSfdXBd2YrbH%2Fimage.png?alt=media&#x26;token=27345a2a-c600-4d24-8149-3245b7bd9361" alt=""><figcaption></figcaption></figure>

***

### Testar API

Usando isto, é possível verificar a resposta bruta da API.