타겟팅 설정하기

1

오디언스 타겟팅

1. 타겟팅 생성

애드컨트롤 콘솔에서 오디언스 타겟팅을 생성해주세요. 자세한 사항은 오디언스 타겟팅을 참조해주세요.

2. 사용자 ID 설정

export const AuthContext = () => {
    [uid, setUid] = useState<string | null>(null)
    
    useEffect(() => {
        if (!uid) return
        
        Adrop.instance().setConfig({
            appKey: 'YOUR_APP_KEY',
            uid: 'YOUR_UID'
        })
    }, [uid])
}

• 사용자 프로퍼티를 설정하기 위해선 appKey 가 필요합니다.

  • 애드컨트롤 콘솔에서 "관리 > 앱 > SDK 설정 및 구성"에서 adrop_service.json 을 다운로드받아 app_key에 해당하는 값을 appKey 에 넣어주세요.

    • Adrop 초기화 단계에 입력해도 됩니다.

• 사용자 ID를 관리하는 Context 또는 함수 내에서 uid가 설정될 때 setConfig 함수를 위와 같이 호출해주세요.

  • 타겟팅 기능이 정상적으로 작동하려면 광고 지면이 있는 페이지가 렌더링되기 이전에 설정해야합니다.

3. 사용자 프로퍼티 설정

export const AuthContext = () => {
    [uid, setUid] = useState<string | null>(null)
    
    useEffect(() => {
        if (!uid) return
    
        const userProperties: UserProperties | null = {
            adid: 'YOUR_ADID', // Android: Advertising ID, iOS: IDFA
            birth: 'YOUR_BIRTH', // 생년월일 (YYYY, YYYYMM, YYYYMMDD)
            gender: 'M', // M: 남자, F: 여자, U: 알 수 없음
            locale: 'ko_KR' // ISO 639
            timeZone: 'Asia/Seoul' // ISO 8601
            YOUR_CUSTOM_PROPERTY: 'YOUR_CUSTOM_PROPERTY_VALUE'
        }
        
        const appProperties: AppProperties | null = {
            appName: 'YOUR_APP_NAME' // 앱 이름
            appVersion: 'YOUR_APP_VERSION' // 앱 버전
            appBundleVersion: 'YOUR_APP_BUNDLE_VERSION' // 앱 번들 내부 버전
        }
        
        Adrop.instance().metrics
             .setUserProperties(userProperties)
             .setAppProperties(appProperties)
             .commit()
             .then(...)
             .catch(...)
    }, [uid])
}

• property 설정은 모두 optional입니다.

• appKey , uid 가 설정되어있어야 합니다.

• 보낸 property는 병합없이 보낸 정보들로 덮어씌워지게 됩니다. 모든 property를 보내도록 구현해주세요.

• User Property

  • 기본 제공 프로퍼티

    • 별도의 설정없이 입력할 수 있는 유저 프로퍼티입니다. adid , birth , gender , locale , timeZone 이 제공됩니다. 자세한 사항은 UserProperties를 참고해주세요.

  • 커스텀 프로퍼티

    • 애드컨트롤 콘솔에서 "프로퍼티 추가"를 해야 해당 기능을 정상적으로 사용할 수 있습니다. 자세한 내용은 프로퍼티 편집하기를 참고해주세요.

• App Property

  • 기본 제공 Property

    • 별도의 설정없이 입력할 수 있는 앱 프로퍼티입니다. appName , appVersion , appBundleVersion 이 제공됩니다. 자세한 사항은 AppProperties를 참고해주세요.

• 설정이 끝나면 commit 함수를 호출해야 서버에 전송됩니다. setUserProperties , setAppProperties 를 함수 Chaining으로 구성한 후 commit 을 호출해주세요.

2

문맥 타겟팅

1. 타겟팅 생성

• 애드컨트롤 콘솔에서 문맥 타겟팅을 생성해주세요. 자세한 사항은 문맥 타겟팅을 참고해주세요.

2. 광고 지면에 문맥 타겟팅 값 설정

data attributes를 이용한 설정

<div
    ...
    data-adrop-context-id='YOUR_CONTEXT_VALUE'
/>

• 애드컨트롤 콘솔 > 문맥 타겟팅 > 조건 설정에서 지정한 Value 값을 입력해주세요.

renderAd 함수 호출을 이용한 설정

const ref = useRef<HTMLDivElement | null>(null)

useEffect(() => {
    if (!ref.current) return
    
    Adrop.instance().renderAd(ref.current, {
        ...,
        contextId: 'YOUR_CONTEXT_VALUE'
    })
}, [])

return <div ref={ref}/>

• 애드컨트롤 콘솔 > 문맥 타겟팅 > 조건 설정에서 지정한 Value 값을 입력해주세요.