As regras de sincronização influenciam as configurações da oferta ao puxar ofertas do CPAPI para o Affise. As regras estão localizadas na página de configuração da nova campanha, bem como na página de edição da campanha existente. O principal objetivo das regras de sincronização é gerenciar a frequência de sincronização para campos de oferta específicos no Affise.
Antes de começar a
Visão geral da seção de regras de sincronização
As regras de sincronização são usadas para gerenciar a frequência de sincronização de campos de oferta específicos no Affise. A frequência é determinada por:
Primeira sincronização: o campo relevante é puxado para a oferta do Affise na primeira vez em que aparece na resposta da API de origem.
Always (Sempre): o campo relevante é puxado ou atualizado na oferta do Affise toda vez que a sincronização ocorre.
Desativado: o campo relevante nunca é puxado ou atualizado no Affise offer toda vez que a sincronização ocorre.
Categorias de regras de sincronização
Há uma descrição das categorias de Regras de Sincronização:
Categorias: essa seção pode ser usada para agrupar ofertas de acordo com suas verticais.
Descrição: descrição da oferta(Ofertas > uma determinada oferta > Geral > Descrição).
Payments(Pagamentos): os campos Country (País), Devices (Dispositivos), OS (Sistema Operacional), Payment type (Tipo de pagamento), Revenue (Receita), Payouts(Pagamentos) e Currency ( Moeda ) são sincronizados(Offers > a certain offer > Payouts).
Status: o status atribuído à oferta, que é puxado da CPAPI para o Affise e definido de forma forçada. Deixe-o de acordo com a fonte para obter apenas o status preciso da oferta do anunciante.
URL: o URL de rastreamento principal (Ofertas > uma determinada oferta > Rastreamento).
Caps: os limites definidos na oferta(Offers > a certain offer > Caps).
Como a CPAPI usa a API da Affise para afiliados, há a validação dos limites.
Categorias de Smartlink: define a categoria de smartlink que uma oferta terá no Affise.
⚠️ A categoria de smartlink deve ser criada primeiro na Affise.
Direcionamento de tráfego: A regra de sincronização é usada para gerenciar a frequência de sincronização das restrições geográficas. Leia mais sobre a sincronização de segmentação na CPAPI aqui.
Landings: essa regra de sincronização está disponível somente em para a integração Affise <-> Affise. Ela puxa as Landing pages configuradas em Offers > uma determinada oferta > Landing pages.
Countries (Países): Restrições GEO de país para filtrar todas as ofertas aprovadas em um lado da origem com base na segmentação por país.
Is CPI: tem uma finalidade informativa e mostra o modelo de pagamento para afiliados que usam sua API(Offers > a certain offer > General > CPI).
Payments Goal (Meta de pagamentos): o valor da meta a ser retornado no parâmetro de meta de um postback quando a ação de destino for concluída. O valor padrão é 1. A desativação da sincronização da meta de pagamentos requer a desativação da regra Caps Sync(Offers > a certain offer > Payouts > Goal value/Goal title).
Título: título da oferta(Ofertas > uma determinada oferta > Geral > Título).
URL Preview (Visualização de URL): em alguns casos, funciona como trafficback. Se você clicar nesse link no painel Afiliado, poderá ver o que é essa oferta em geral(Offers > a certain offer > Tracking > Preview URL).
KPI: tem uma finalidade informativa(Ofertas > uma determinada oferta > Geral > KPI).
⚠️ O Affise oferece suporte à descrição em vários idiomas somente para a integração Affise <-> Affise.
Redirect Type: o tipo de redirecionamento da oferta, que é atribuído a uma oferta no Affise e é definido de forma forçada.
Nível de privacidade: o nível de privacidade atribuído a uma oferta extraída do CPAPI para o Affise (Público, Pré-moderação e Privado).
URL de destino da impressão: o link que um anunciante fornece a você, para que você possa enviar informações sobre impressões a ele(Ofertas > uma determinada oferta > Rastreamento > URL de destino das impressões).
Permitir impressões: permite o rastreamento de impressões no Affise(Offers > a certain offer > Tracking > Allow impressions).
Notas: notas adicionais, que um anunciante pode passar dentro de sua oferta.
⚠️ Se você configurar valores em algum campo da seção Default values (Valores padrão ), mas a regra Sync homônima estiver configurada como Disabled (Desativada), o valor não será aplicado. A oferta será extraída com um valor padrão. Por exemplo, você configurou o Meta-redirect no campo Redirect Type (Tipo de red irecionamento) na seção Default values (Valores padrão ), mas a regra Redirect Type Sync (Sincronização do tipo de redirecionamento) está desativada. Nesse caso, a oferta conterá um redirecionamento HTTP 302, pois esse é o padrão.
Alteração da frequência das regras de sincronização
Quando você alterar a frequência da regra de sincronização (por exemplo, de Always (Sempre) para First Sync (Primeira sincronização)), lembre-se de que as alterações são aplicadas a todas as ofertas importadas. As ofertas importadas são as ofertas que a CPAPI obtém do feed do anunciante. Se a campanha contiver 100 ofertas, mas um anunciante fornecer 90 ofertas em seu feed de API, as alterações serão aplicadas somente a 90 ofertas.
Quando você altera as regras de sincronização de First Sync ou Disabled para Always, as alterações nas ofertas são entregues ao Affise somente depois que um anunciante faz alterações na fonte.
Regra de sincronização como Always: peculiaridades
Veja o exemplo a seguir:
Na campanha, você tem todas as regras de sincronização como First Sync (ou Disabled), exceto Title. Você alterou o Título na oferta manualmente/via API no Affise. Essas alterações permanecerão até que um anunciante altere qualquer outra coisa (por exemplo, Caps) em seu lado. A CPAPI perceberá essas alterações. Como uma regra de sincronização para Caps é como First Sync, os Caps não serão atualizados, mas o novo Título no Affise será apagado (trazido de volta à versão que o anunciante tem agora), pois a regra de sincronização para Título é Always. Esse princípio é aplicado a todas as regras de sincronização que a campanha tem.
Veja abaixo alguns casos que você pode enfrentar ao trabalhar com a CPAPI:
Você tem a regra Title Sync como Always, a regra Cap Sync como First Sync e alterou o título manualmente/via API no Affise. A CPAPI fez uma chamada de API para um anunciante e não encontrou nenhuma alteração em Caps, todos os valores em Caps permanecem os mesmos. Seu Título permanecerá o mesmo, pelo menos até a próxima chamada de API que a CPAPI fará.
Você tem a regra Title Sync como Always (Sempre), a regra Cap Sync como First Sync (Primeira sincronização) e você alterou o título manualmente/via API no Affise. A CPAPI fez uma chamada de API para um anunciante e descobriu que o anunciante não passou o Caps como um parâmetro completo (não há parâmetros e o valor nele). Seu título permanecerá o mesmo, pelo menos até a próxima chamada de API que a CPAPI fará.
Você tem a regra Title Sync como Always, a regra Cap Sync como First Sync e alterou o título manualmente/via API no Affise. A CPAPI fez uma chamada de API para um anunciante e descobriu que o anunciante passou o parâmetro Caps vazio sem nenhum valor. Seu Título permanecerá o mesmo, pelo menos até a próxima chamada de API que a CPAPI fará.
⚠️ As alterações são contadas mesmo que um anunciante passe "-" ou "0". Qualquer valor é importante.
4. Você tem a regra Title Sync como Always (Sempre), a regra Cap Sync como First Sync (Primeira sincronização) e você alterou o título manualmente/via API no Affise. A CPAPI fez uma chamada de API para o anunciante e encontrou alterações em Caps. Não importa qual frequência tem a regra de sincronização para Caps, seu título será apagado (trazido de volta à versão que o anunciante tem).
Regras de sincronização específicas
Privacy level (Nível de privacidade): se essa regra estiver configurada como Disabled (Desativada), todas as ofertas serão enviadas ao Affise como Public (Pública).
URL & Impression Destination URL: como você pode configurar parâmetros e macros para ambos os links na página de configuração Demand Source, você precisa estar ciente do seguinte:
Se a regra Sync estiver configurada como Disable (Desativar), o sistema não atualizará os dois links com os parâmetros e macros que você configurou.
Se a regra Sync estiver configurada como First Sync, o sistema atualizará os dois links com parâmetros e macros apenas uma vez. Se você atualizar os parâmetros e as macros na página de configuração Demand Source depois que eles forem puxados para o Affise, o sistema não os atualizará novamente.
Se a regra estiver configurada como Always (Sempre), o sistema atualizará os dois links com parâmetros e macros sempre que você os atualizar na página de configuração Demand Source.
Redirect type (Tipo de redirecionamento): se essa regra estiver configurada como Disabled (Desativado), todas as ofertas serão puxadas para o Affise com o tipo de redirecionamento HTTP 302.
Payments Goal (Meta de pagamentos): se você a desativar inicialmente quando a campanha for criada, todas as ofertas conterão "1" como valor de meta por padrão.
Payments Goal & Caps (Meta de pagamentos e limites): essas duas regras têm validação mútua:
Se Caps for para First Sync, a meta de pagamentos poderá ser configurada como First Sync ou Always.
Se Caps for para Always (Sempre), a meta de pagamentos deverá ser configurada apenas como Always (Sempre).
Se Caps for para Desativado, a meta de pagamentos poderá ser configurada como Primeira sincronização, Sempre e Desativado.
Veja este exemplo: você configurou a regra de limites como First Sync (Primeira sincronização), a meta de pagamentos como Always (Sempre) e os limites estão configurados para uma determinada meta. Nesse cenário, pode ocorrer um erro de atualização de oferta quando a meta de pagamentos for alterada na fonte do anunciante. Isso significa que os limites estão configurados para uma meta que não existe. O mesmo erro pode ocorrer quando a meta de pagamentos é configurada como Sempre e você altera a regra de sincronização de limites de Sempre para Desativado.
Limites: a opção Overcap não depende da regra Caps Sync.
Por exemplo:
Os Caps são configurados como First sync (Primeira sincronização) ou Disbaled (Desequilibrada), e o Overcap está ON no CPAPI e OFF no Affise. Quando a sincronização ocorre, o Overcap se torna ativo no Affise.
Os Caps estão ausentes da oferta no CPAPI, os Caps estão configurados como Primeira sincronização e o Overcap está ATIVADO no Affise. Quando a sincronização ocorre, os Caps permanecem na oferta, mas o Overcap não fica ativo no Affise.
Direcionamento de tráfego: leia mais sobre isso aqui.
⚠️ Se você usar o CR Automation ou o Click Automation, é melhor usar a regra de sincronização de segmentação de tráfego como a primeira sincronização. Caso contrário, o sistema apagará os valores sub2 bloqueados toda vez que a CPAPI puxar a oferta no Affise.
Entre em contato com a equipe de Suporte ao Cliente do Affise sobre todas as questões levantadas por meio do e-mail: [email protected].