loadAd

Cập nhật lần cuối: 26/03/2024

Bắt đầu hỗ trợ ở phiên bản:

• SDK: 2.37.0

API dùng để tải quảng cáo. Có các loại quảng cáo sau đây:

ID	Size
ZMA_Masthead	480x270
ZMA_Middle	300x250
ZMA_Fullscreen	Toàn màn hình
ZMA_Reward	Toàn màn hình.

Mặc định quảng cáo sẽ được hiển thị sau khi tải xong. Vị trí hiển thị quảng cáo sẽ được xác định theo ID của từng loại. Ví dụ:

...
<div id="ZMA_Masthead"></div>

Parameters

Object object

Property	Type	Default	Required	Description	Minimum Version
ids	string | string[]		true	ID của loại quảng cáo cần tải trong trang
config	config			Cấu hình thêm

Object config

Property	Type	Default	Required	Description	Minimum Version
display	boolen	true	false	Nhận các giá trị sau: true: Hiển thị quảng cáo sau khi tải false: Không hiển thị quảng cáo sau khi tải
onLoad	function		false	Trả về trạng thái có quảng cáo hay không
onShow	function		false	Trả về trạng thái có quảng cáo hiển thị thành công hay không
onClose	function		false	Sau khi ZMA_Reward đóng sẽ gọi hàm này và trả về reward token của quảng cáo. Xem thêm Hướng dẫn verify reward token
rewardConfig	rewardConfig			Cấu hình hiển thị cho Ads Reward

Object rewardConfig

Property	Type	Default	Description	Minimum Version
displayType	string	"popup"	Kiểu hiển thị. Có 2 giá trị: "inline" hoặc "popup"
screenMode	string	"portrait"	Hiển thị kiểu ngang hay dọc, chỉ hoạt động khi displayType: "popup". Có 2 giá trị “portrait” hoặc “landscape”

Sample Code

import React, { useEffect } from "react";
import { loadAd } from "zmp-sdk/apis";

function HomePage() {
  useEffect(() => {
    loadAd({ ids: ["ZMA_Middle"] });
  }, []);

  return (
    <>
      ...
      <div id='ZMA_Middle' />
      ...
    </>
  );
}

export default HomePage;

Verify reward token

API được dùng để verify token được trả về trong hàm onClose khi mở quảng cáo loại ZMA_Reward

Request

• URL: https://h5.zalo.me/openapi/ads/verify-token

• Method: GET

• Parameters

  Name	Type	Required	Description
  token	string	yes	Reward token
  appId	string	yes	Mini App ID

Response

• Status: 200 OK

• Body: JSON

  {
    "msg": "Success",
    "err": 0,
    "data": {
      "result": true
    }
  }

  • Field “data”:

    Name	Type	Description
    result	boolean	Kết quả kiểm tra