Para conectar sua conta Kwai Ads ao Reportei, é necessário solicitar à Kwai a liberação de acesso aos dados da conta via API.
Esse processo é feito por e-mail, seguindo o modelo indicado pela própria Kwai. Após aprovar a solicitação, a Kwai enviará as credenciais necessárias para concluir a integração no Reportei.
Antes de começar
Para solicitar o acesso, você precisará das seguintes informações:
- ID da conta Kwai Ads;
- nome da empresa/anunciante titular da conta;
- nome da agência responsável pela conta, se houver;
- e-mail do contato comercial da Kwai, se houver;
Quem deve enviar o e-mail?
A solicitação pode ser iniciada por qualquer responsável pela conta. Dependendo de quem enviar o e-mail, a Kwai poderá solicitar uma confirmação adicional para validar a autorização.
Em todos os casos, a Kwai precisa validar a autorização antes de liberar as credenciais de acesso.
Informações que você precisa preencher no modelo
Antes de enviar o e-mail para a Kwai, substitua as informações entre colchetes no modelo:
[advertiser/company name]
Nome da empresa titular da conta Kwai Ads que está solicitando a autorização.
[account ID]
ID da conta de anúncios no Kwai Ads.
[agent company name / N/A]
Nome da agência ou agente responsável pela conta Kwai Ads, caso exista. Se não houver agência responsável, preencha com N/A.
[email protected]
E-mail de desenvolvedor do Reportei. Esse e-mail deve ser mantido no corpo do e-mail e também incluído em cópia no envio.
Modelo de e-mail para enviar à Kwai
Copie o modelo abaixo, substitua as informações entre colchetes e envie para a Kwai.
Destinatários:
- [email protected]
- [email protected]
- e-mail do contato comercial da Kwai, se houver
- e-mail da agência responsável pela conta, se houver
Assunto:
Kwai MAPI-Channel Advertiser Authorizes Third-Party Developers
Corpo do e-mail:
Our company, [advertiser/company name], authorizes Reportei, as a third-party developer, through the developer account email [email protected], to obtain and operate Kwai API.
- Scope of authorization:
“ ad_mapi_campaign_read, ad_mapi_unit_read, ad_mapi_creative_read, ad_mapi_material_read, ad_mapi_report”
- Our account ID on Kwai Ads: [account ID]
- The name of the agent company responsible for our Kwai or SnackVideo Ads account: [agent company name / N/A]
Depois de enviar o e-mail
Após o envio, aguarde a resposta da Kwai. Esse retorno pode levar alguns dias.
A Kwai também poderá solicitar uma confirmação da agência ou do anunciante, dependendo de quem iniciou a solicitação.
Depois da aprovação, a Kwai enviará por e-mail as credenciais necessárias para concluir a integração no Reportei, como:
- Client ID;
- Secret Key;
- Refresh Token.
Como concluir a integração no Reportei
Depois de receber as credenciais da Kwai:
- Acesse o Reportei;
- Vá até “gerenciar integrações”;
- Selecione Kwai Ads;
- Informe um nome para identificar a conta;
- Preencha os campos com as credenciais enviadas pela Kwai;
- Clique em Integrar.
Após a conexão, os dados da conta Kwai Ads poderão ser usados em relatórios e dashboards no Reportei.
Dúvidas frequentes
O Reportei consegue gerar essas credenciais?
Não. As credenciais são geradas e enviadas pela própria Kwai após a aprovação da solicitação.
Posso conectar sem enviar o e-mail para a Kwai?
Não. Para que a integração funcione, primeiro é necessário que a Kwai aprove o acesso aos dados da conta.
A agência pode enviar o e-mail?
Sim. A agência pode iniciar a solicitação em nome do anunciante, mas o anunciante poderá precisar confirmar a autorização quando solicitado pela Kwai.
O anunciante pode enviar o e-mail?
Sim. Nesse caso, a agência responsável pela conta poderá precisar responder confirmando a identidade do anunciante.
O que devo preencher no campo da agência se não houver uma agência responsável?
Caso não exista uma agência ou agente responsável pela conta Kwai Ads, preencha o campo com N/A.
Quais credenciais preciso inserir no Reportei?
Após a aprovação da solicitação, a Kwai enviará as credenciais necessárias para concluir a integração, incluindo Client ID, Secret Key e Refresh Token.