โฆษณาแบบข้อความ โฆษณาแบบข้อความเป็นโฆษณาเนทีฟที่อิงข้อความ ซึ่งกลมกลืนไปกับเนื้อหาของเว็บไซต์ได้อย่างเป็นธรรมชาติ ให้อัตราการคลิกที่สูงและประสบการณ์การใช้งานที่ดี อีกทั้งความสูงจะปรับโดยอัตโนมัติตามเนื้อหา
// HTML에 컨테이너 준비
// <div id="text-container"></div>
// SDK 초기화 (한 번만)
AdStage. init ({
apiKey: process.env. NEXT_PUBLIC_ADSTAGE_API_KEY
});
// 기본 텍스트 광고 생성
AdStage.ads. text ( 'text-container' );
AdStage.ads. text ( 'text-container' , {
onClick : ( adData ) => {
console. log ( '텍스트 광고 클릭됨:' , adData);
// 사용자 정의 로직 추가 가능
}
});
ตัวเลือก ประเภท ค่าเริ่มต้น คำอธิบาย maxLinesnumber3จำนวนบรรทัดสูงสุดที่จะแสดง stylestring'default'ธีมสไตล์ onClickfunctionundefinedฟังก์ชัน callback ที่จะทำงานเมื่อมีการคลิก
ตัวเลือก ประเภท ค่าเริ่มต้น คำอธิบาย adIdstringundefinedระบุ ID ของโฆษณาที่ต้องการ language'ko' | 'en' | 'ja' | 'zh'undefinedกรองตามภาษา deviceType'MOBILE' | 'DESKTOP'undefinedกรองตามอุปกรณ์ country'KR' | 'US' | 'JP' | 'CN' | 'DE'undefinedกรองตามประเทศ
หมายเหตุ : ความสูงของโฆษณาแบบข้อความจะปรับโดยอัตโนมัติตามความยาวของเนื้อหา (height: 'auto')
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 = "text-container" style = "width: 100%; max-width: 600px; margin: 20px auto; padding: 16px; border: 1px solid #ddd; border-radius: 8px;" >
로딩 중...
</ 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. text ( 'text-container' , {
maxLines: 3
});
</ script >
</ body >
</ html >
คุณสามารถจำกัดจำนวนบรรทัดที่โฆษณาแบบข้อความแสดงได้
// 1줄로 제한 (한 줄 텍스트 광고)
AdStage.ads. text ( 'text-container' , {
maxLines: 1
});
// 5줄까지 허용
AdStage.ads. text ( 'text-container' , {
maxLines: 5
});
วิธีปรับจำนวนบรรทัดแบบไดนามิกตามขนาดหน้าจอ
// 미디어 쿼리를 활용한 반응형 구현
const getResponsiveMaxLines = () => {
if (window.innerWidth <= 768 ) {
return 2 ; // 모바일: 2줄
} else if (window.innerWidth <= 1024 ) {
return 3 ; // 태블릿: 3줄
} else {
return 4 ; // 데스크톱: 4줄
}
};
AdStage.ads. text ( 'text-container' , {
maxLines: getResponsiveMaxLines (),
deviceType: window.innerWidth <= 768 ? 'MOBILE' : 'DESKTOP'
});
// 윈도우 리사이즈 시 재생성
window. addEventListener ( 'resize' , () => {
// 기존 광고 제거 후 새로 생성
AdStage.ads. destroy (slotId);
slotId = AdStage.ads. text ( 'text-container' , {
maxLines: getResponsiveMaxLines (),
deviceType: window.innerWidth <= 768 ? 'MOBILE' : 'DESKTOP'
});
});
ใช้เมื่อคุณต้องการแสดงเฉพาะโฆษณาแบบข้อความที่ระบุเท่านั้น
AdStage.ads. text ( 'text-container' , {
maxLines: 3 ,
adId: 'text-ad-456' // 특정 광고 ID
});
ใช้ maxLines เพื่อระบุจำนวนบรรทัดสูงสุดที่จะแสดง (เป็นตัวเลข ค่าเริ่มต้น 3) ความสูงของโฆษณาแบบข้อความจะปรับโดยอัตโนมัติ (height: 'auto') ให้พอดีกับความยาวของเนื้อหา
// 최대 3줄로 표시 (기본값)
AdStage.ads. text ( 'text-container' , {
maxLines: 3
});
เนื่องจากโฆษณาโหลดในเบื้องหลัง คุณจึงได้รับ slot ID ทันที
// 즉시 슬롯 ID 반환
const slotId = AdStage.ads. text ( 'text-container' );
console. log ( '슬롯 생성됨:' , slotId); // 즉시 실행
// 실제 광고는 비동기로 로드됨
เมื่อคอนเทนเนอร์ถูกลบออกจาก DOM โฆษณาก็จะถูกล้างออกโดยอัตโนมัติเช่นกัน
const slotId = AdStage.ads. text ( 'text-container' );
// DOM에서 컨테이너 제거 시 자동 정리됨
document. getElementById ( 'text-container' ). remove ();
// 수동으로 destroy() 호출할 필요 없음
คุณสามารถจัดสไตล์โฆษณาของคุณได้โดยใช้ประโยชน์จาก CSS class ที่ SDK เพิ่มให้โดยอัตโนมัติ
/* 광고 컨테이너 기본 스타일 */
.adstage-text-ad {
position : relative ;
overflow : hidden ;
font-family : inherit ;
line-height : 1.6 ;
}
/* 로딩 상태 */
.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);