Text Ads

Text ads are text-based native ads that blend naturally with your website's content. They deliver high click-through rates and a good user experience, and their height adjusts automatically based on the content.

🎯 Basic Usage

Simple Text Ad

// HTML에 컨테이너 준비
// <div id="text-container"></div>
 
// SDK 초기화 (한 번만)
AdStage.init({
  apiKey: process.env.NEXT_PUBLIC_ADSTAGE_API_KEY
});
 
// 기본 텍스트 광고 생성
AdStage.ads.text('text-container');

Handling Click Events

AdStage.ads.text('text-container', {
  onClick: (adData) => {
    console.log('텍스트 광고 클릭됨:', adData);
    // 사용자 정의 로직 추가 가능
  }
});

⚙️ Configuration Options

Basic Options

Option	Type	Default	Description
`maxLines`	`number`	`3`	Maximum number of lines to display
`style`	`string`	`'default'`	Style theme
`onClick`	`function`	`undefined`	Callback function executed on click

Filtering Options

Option	Type	Default	Description
`adId`	`string`	`undefined`	Specify a particular ad ID
`language`	`'ko' \| 'en' \| 'ja' \| 'zh'`	`undefined`	Filter by language
`deviceType`	`'MOBILE' \| 'DESKTOP'`	`undefined`	Filter by device
`country`	`'KR' \| 'US' \| 'JP' \| 'CN' \| 'DE'`	`undefined`	Filter by country

Note: The height of text ads adjusts automatically based on the content length (height: 'auto').

💡 Real-World Implementation Examples

The simplest CDN approach, which you can use directly in 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>

🚀 Advanced Features

Limiting the Line Count

You can limit the number of lines a text ad displays.

// 1줄로 제한 (한 줄 텍스트 광고)
AdStage.ads.text('text-container', {
  maxLines: 1
});
 
// 5줄까지 허용
AdStage.ads.text('text-container', {
  maxLines: 5
});

Responsive Line Count Adjustment

How to dynamically adjust the line count based on screen size.

// 미디어 쿼리를 활용한 반응형 구현
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'
  });
});

Specifying a Particular Ad ID

Use this when you want to display only a specific text ad.

AdStage.ads.text('text-container', {
  maxLines: 3,
  adId: 'text-ad-456'  // 특정 광고 ID
});

🔧 Optimization Tips

1. Specifying the Line Count

Use maxLines to specify the maximum number of lines to display (a number, default 3). The height of a text ad adjusts automatically (height: 'auto') to fit the content length.

// 최대 3줄로 표시 (기본값)
AdStage.ads.text('text-container', {
  maxLines: 3
});

2. Background Loading

Because ads load in the background, you receive the slot ID immediately.

// 즉시 슬롯 ID 반환
const slotId = AdStage.ads.text('text-container');
console.log('슬롯 생성됨:', slotId);  // 즉시 실행
 
// 실제 광고는 비동기로 로드됨

3. Leveraging Automatic Cleanup

When the container is removed from the DOM, the ad is also cleaned up automatically.

const slotId = AdStage.ads.text('text-container');
 
// DOM에서 컨테이너 제거 시 자동 정리됨
document.getElementById('text-container').remove();
// 수동으로 destroy() 호출할 필요 없음

🎨 Styling

Using CSS Classes

You can style your ads by leveraging the CSS classes the SDK adds automatically.

/* 광고 컨테이너 기본 스타일 */
.adstage-text-ad {
  position: relative;
  overflow: hidden;
  font-family: inherit;
  line-height: 1.6;
}
 
/* 로딩 상태 */
.adstage-loading {
  opacity: 0.7;
  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
  background-size: 200% 100%;
  animation: loading 1.5s infinite;
}
 
@keyframes loading {
  0% { background-position: 200% 0; }
  100% { background-position: -200% 0; }
}
 
/* 로딩 완료 */
.adstage-loaded {
  opacity: 1;
  transition: opacity 0.3s ease;
}
 
/* 오류 상태 */
.adstage-error {
  border: 1px solid #ff6b6b;
  background-color: #ffe0e0;
}

Checking Slot Status

// 모든 슬롯 확인
const allSlots = AdStage.ads.getAllSlots();
console.log('전체 광고 슬롯:', allSlots);
 
// 특정 슬롯 확인
const slot = AdStage.ads.getSlotById(slotId);
console.log('슬롯 정보:', slot);

Text Ads

Table of Contents