โฆษณาแบนเนอร์ โฆษณาแบนเนอร์เป็นโฆษณาแบบรูปภาพ และเป็นรูปแบบโฆษณาที่ใช้กันมากที่สุดบนเว็บไซต์ AdStage SDK รองรับการปรับขนาดอัตโนมัติ ฟังก์ชันสไลด์ และการโหลดในเบื้องหลังสำหรับโฆษณาแบนเนอร์
// HTML에 컨테이너 준비
// <div id="banner-container"></div>
// SDK 초기화 (한 번만)
AdStage. init ({
apiKey: process.env. NEXT_PUBLIC_ADSTAGE_API_KEY
});
// 기본 배너 광고 생성
AdStage.ads. banner ( 'banner-container' , {
width: '100%' ,
height: 250
});
AdStage.ads. banner ( 'banner-container' , {
width: '100%' ,
height: 250 ,
onClick : ( adData ) => {
console. log ( '배너 광고 클릭됨:' , adData);
// 사용자 정의 로직 추가 가능
}
});
ตัวเลือก ประเภท ค่าเริ่มต้น คำอธิบาย widthstring | number'100%'ความกว้างของแบนเนอร์ (px หรือ %) heightnumber250ความสูงของแบนเนอร์ (px) onClickfunctionundefinedฟังก์ชัน callback ที่ทำงานเมื่อมีการคลิก
ตัวเลือก ประเภท ค่าเริ่มต้น คำอธิบาย autoSlidebooleanfalseสไลด์อัตโนมัติเมื่อมีโฆษณาหลายรายการ slideIntervalnumber5000ช่วงเวลาการสไลด์ (มิลลิวินาที) adIdstringundefinedระบุ ID ของโฆษณาที่ต้องการ
ตัวเลือก ประเภท ค่าเริ่มต้น คำอธิบาย language'ko' | 'en' | 'ja' | 'zh'undefinedกรองตามภาษา deviceType'MOBILE' | 'DESKTOP'undefinedกรองตามอุปกรณ์ country'KR' | 'US' | 'JP' | 'CN' | 'DE'undefinedกรองตามประเทศ
HTML (CDN) JavaScript (ES6) React Next.js App Next.js Provider
วิธี CDN ที่ง่ายที่สุด ช่วยให้คุณใช้งานได้โดยตรงใน HTML
<! DOCTYPE html >
< html >
< head >
< meta charset = "UTF-8" >
< title >배너 광고 예제</ title >
</ head >
< body >
< h1 >내 웹사이트</ h1 >
<!-- 배너 광고 컨테이너 -->
< div id = "banner-container" style = "width: 100%; height: 250px; border: 1px solid #ddd;" >
로딩 중...
</ div >
<!-- AdStage SDK 로드 -->
< script src = "https://unpkg.com/@adstage/web-sdk/dist/index.umd.js" ></ script >
< script >
// SDK 초기화
AdStage. init ({
apiKey: 'your-api-key'
});
// 배너 광고 생성
AdStage.ads. banner ( 'banner-container' , {
width: '100%' ,
height: 250
});
</ script >
</ body >
</ html >
ฟีเจอร์ที่สไลด์โฆษณาแบนเนอร์โดยอัตโนมัติเมื่อมีหลายรายการ
AdStage.ads. banner ( 'banner-container' , {
width: '100%' ,
height: 250 ,
autoSlide: true , // 자동 슬라이드 활성화
slideInterval: 3000 // 3초마다 슬라이드
});
วิธีปรับขนาดแบนเนอร์ตามขนาดหน้าจอ
// 미디어 쿼리를 활용한 반응형 구현
const getResponsiveHeight = () => {
if (window.innerWidth <= 768 ) {
return 100 ; // 모바일: 높이 100px
} else if (window.innerWidth <= 1024 ) {
return 200 ; // 태블릿: 높이 200px
} else {
return 250 ; // 데스크톱: 높이 250px
}
};
AdStage.ads. banner ( 'banner-container' , {
width: '100%' ,
height: getResponsiveHeight (),
deviceType: window.innerWidth <= 768 ? 'MOBILE' : 'DESKTOP'
});
// 윈도우 리사이즈 시 재생성
window. addEventListener ( 'resize' , () => {
// 기존 광고 제거 후 새로 생성
AdStage.ads. destroy (slotId);
slotId = AdStage.ads. banner ( 'banner-container' , {
width: '100%' ,
height: getResponsiveHeight (),
deviceType: window.innerWidth <= 768 ? 'MOBILE' : 'DESKTOP'
});
});
ใช้เมื่อคุณต้องการแสดงเฉพาะโฆษณาแบนเนอร์รายการใดรายการหนึ่ง
AdStage.ads. banner ( 'banner-container' , {
width: '100%' ,
height: 250 ,
adId: 'banner-ad-123' // 특정 광고 ID
});
SDK จะปรับขนาดคอนเทนเนอร์ให้เหมาะกับขนาดของรูปภาพโดยอัตโนมัติ
// 이미지 크기에 맞춰 자동 조정
AdStage.ads. banner ( 'banner-container' , {
width: '100%' ,
height: 'auto' // 이미지 비율에 맞춰 자동 조정
});
โฆษณาจะโหลดในเบื้องหลัง คุณจึงได้รับ slot ID ได้ทันที
// 즉시 슬롯 ID 반환
const slotId = AdStage.ads. banner ( 'banner-container' );
console. log ( '슬롯 생성됨:' , slotId); // 즉시 실행
// 실제 광고는 비동기로 로드됨
เมื่อคอนเทนเนอร์ถูกลบออกจาก DOM โฆษณาก็จะถูกล้างออกโดยอัตโนมัติด้วย
const slotId = AdStage.ads. banner ( 'banner-container' );
// DOM에서 컨테이너 제거 시 자동 정리됨
document. getElementById ( 'banner-container' ). remove ();
// 수동으로 destroy() 호출할 필요 없음
คุณสามารถจัดสไตล์ได้โดยใช้ CSS class ที่ SDK เพิ่มให้โดยอัตโนมัติ
/* 광고 컨테이너 기본 스타일 */
.adstage-ad {
position : relative ;
overflow : hidden ;
border-radius : 8 px ;
}
/* 로딩 상태 */
.adstage-loading {
opacity : 0.7 ;
background : linear-gradient ( 90 deg , #f0f0f0 25 % , #e0e0e0 50 % , #f0f0f0 75 % );
background-size : 200 % 100 % ;
animation : loading 1.5 s infinite ;
}
@keyframes loading {
0% { background-position : 200 % 0 ; }
100% { background-position : -200 % 0 ; }
}
/* 로딩 완료 */
.adstage-loaded {
opacity : 1 ;
transition : opacity 0.3 s ease ;
}
/* 오류 상태 */
.adstage-error {
border : 1 px solid #ff6b6b ;
background-color : #ffe0e0 ;
}
// 모든 슬롯 확인
const allSlots = AdStage.ads. getAllSlots ();
console. log ( '전체 광고 슬롯:' , allSlots);
// 특정 슬롯 확인
const slot = AdStage.ads. getSlotById (slotId);
console. log ( '슬롯 정보:' , slot);