English

AdMesh

언어 컨텍스트 기반 자체 광고 네트워크. IDFA/GAID/제3자 SDK 없이 광고 서빙, 영국식 공개 경매, 배치 이벤트 트래킹을 제공합니다.

개요

AdMesh는 ATT/IDFA를 사용하지 않습니다. 슬롯 키 + 언어만으로 컨텍스트 매칭이 이루어지며, 매월 20일~말일 영국식 경매로 다음 달 슬롯이 할당됩니다. 익명화는 SHA256(ip + UA + salt)로 처리되어 개인 식별 정보를 저장하지 않습니다.

광고 서빙

bash
curl -H "X-API-Key: $KEY" \
  "https://api.moai.page/v1/admesh/slot/home_top?lang=ko"
json
{
  "creativeId": "cr_8a7d",
  "campaignId": "cp_3f29",
  "image": "https://cdn.moai.page/ads/8a7d.jpg",
  "headline": "신학기 도서 30% 할인",
  "ctaUrl": "https://example.com/promo",
  "impressionToken": "imp_eyJhbGciOiJIUzI..."
}

이벤트 트래킹

impression/view/click/dwell 모두 단일 배치 엔드포인트로 전송합니다. CTR = 클릭 / View × 100 (Impression 아님).

typescript
await client.admesh.batchEvents({
  events: [
    { type: 'IMPRESSION', impressionToken: 'imp_...', ts: Date.now() },
    { type: 'VIEW',       impressionToken: 'imp_...', ts: Date.now(), durationMs: 1200 },
    { type: 'CLICK',      impressionToken: 'imp_...', ts: Date.now() },
  ],
});

캠페인/크리에이티브

  • POST /v1/admesh/campaigns — 캠페인 생성
  • POST /v1/admesh/creatives — 크리에이티브 업로드 (검수 자동/관리자 SLA 24h)
  • POST /v1/admesh/bids — 입찰
  • GET /v1/admesh/reports?from=...&to=... — 일/월별 리포트

운영 원칙

  • ATT / IDFA / GAID / 제3자 광고 SDK 사용 금지
  • 경매: 영국식 (낙찰가 = 본인 최고 입찰가)
  • 환불 사유 3종: CREATIVE_REJECTED(100%) / ADVERTISER_CANCEL_BEFORE(50%) / ADVERTISER_CANCEL_DURING(잔여 × 50%)
  • 광고주 등급: GENERAL / PREMIUM(월 100만원+)
PreviousNotifyNextAnon