To connect your Kwai Ads account to Reportei, you need to request Kwai to grant access to the account data via API.
This process is done by email following the template provided by Kwai. After approving the request, Kwai will send the necessary credentials to complete the integration in Reportei.
Before starting
To request access, you will need the following information:
- Kwai Ads account ID
- name of the company-advertiser holding the account
- name of the agency responsible for the account, if any
- email of Kwai’s commercial contact, if any
Who should send the email
The request can be initiated by any account manager. Depending on who sends the email, Kwai might request additional confirmation to validate the authorization.
In all cases, Kwai needs to validate the authorization before releasing the access credentials.
Information you need to fill in the template
Before sending the email to Kwai, replace the bracketed information in the template.
[advertiser company name]
Name of the company holding the Kwai Ads account that is requesting the authorization
[account ID]
ID of the ad account on Kwai Ads
[agent company name NA]
Name of the agency or agent responsible for the Kwai Ads account, if any. If there is no responsible agency, fill in with NA.
[email protected]
Developer email for Reportei. This email should be kept in the body of the email and also included in the CC of the sent mail.
Email template to send to Kwai
Copy the template below, replace the bracketed information, and send it to Kwai.
Recipients
- [email protected]
- [email protected]
- email of Kwai’s commercial contact, if any
- email of the agency responsible for the account, if any
Subject: Kwai MAPI-Channel Advertiser Authorizes Third-Party Developers
Body of the email
Our company [advertiser company name] authorizes Reportei as a third-party developer through the developer account email devreporteicom 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 NA]
After sending the email
After sending, wait for Kwai’s response. This feedback may take a few days.
Kwai may also request confirmation from the agency or the advertiser depending on who initiated the request.
After approval, Kwai will send the necessary credentials by email to complete the integration in Reportei, such as:
- Client ID
- Secret Key
- Refresh Token
How to complete the integration in Reportei
After receiving the credentials from Kwai
- Access Reportei
- Go to manage integrations
- Select Kwai Ads
- Provide a name to identify the account
- Fill in the fields with the credentials sent by Kwai
- Click on Integrate.
After the connection, the Kwai Ads account data can be used in reports and dashboards in Reportei.
Frequently Asked Questions
Can Reportei generate these credentials?
No, the credentials are generated and sent by Kwai itself after the approval of the request.
Can I connect without sending the email to Kwai?
No, for the integration to work, Kwai first needs to approve access to the account data.
Can the agency send the email?
Yes, the agency can initiate the request on behalf of the advertiser, but the advertiser may need to confirm the authorization when requested by Kwai.
Can the advertiser send the email?
Yes, in this case, the agency responsible for the account may need to respond, confirming the advertiser’s identity.
What should I fill in the agency field if there is no responsible agency?
If there is no agency or agent responsible for the Kwai Ads account, fill in the field with NA.
Which credentials do I need to enter in Reportei?
After the request is approved, Kwai will send the necessary credentials to complete the integration, including Client ID, Secret Key and Refresh Token.