Taboola 연동

adstage에서는 Taboola(Realize) 캠페인의 광고비·노출·클릭을 API 키로 자동 수집하고, 트래킹 링크로 유입된 클릭·전환을 taboola.ads 채널로 집계할 수 있습니다. adstage가 측정한 구매를 Taboola로 돌려보내는 S2S 포스트백은 링크 단위로 설정합니다.

베타

Taboola 연동은 실제 광고주 계정으로 검증 중입니다(연동 카드에 베타 표시). adstage 수치가 Taboola Realize와 다르면 adstage 고객지원팀에 알려 주세요.

1. 연동 개요

Taboola는 OAuth 로그인 대신, 광고주가 Realize에서 직접 발급한 Client ID·Client Secret으로 연동합니다.

2. API 키 발급받기

1. Taboola Realize에 로그인한 뒤 API Keys 페이지를 엽니다.

2. client_id와 client_secret을 발급해 복사합니다. Client Secret은 adstage에 암호화되어 저장됩니다.

3. 계정 ID를 확인합니다. Realize에 표시되는 영문 계정 이름이며 my-company-sc 같은 형태입니다. 숫자 ID가 아닙니다.

주의하세요

API Keys 페이지가 보이지 않거나 키를 발급할 수 없으면 Taboola 담당 AM에게 요청하세요. Taboola는 기존 광고주만 이 페이지에서 키를 발급할 수 있고, 그 밖의 경우에는 Taboola에 API 사용을 신청해야 한다고 안내합니다.

adstage 대시보드의 비용 연동 탭과 계정 추가 창에도 같은 안내(Taboola 키 발급 방법)와 Taboola 키 발급 페이지 열기 버튼이 있습니다.

3. 비용 연동하기

1. adstage 대시보드 연동 > 광고 채널 연동 > Taboola에서 비용 연동 탭을 엽니다.

2. Taboola 비용 연동 스위치를 켭니다. 스위치가 꺼져 있으면 연동 계정 추가 버튼을 누를 수 없습니다.

3. 연동 계정 추가를 클릭하고 연동 정보 등록 창에 다음을 입력합니다.

4. 연동을 클릭합니다. adstage가 저장 전에 Taboola API를 한 번 호출해 키가 유효한지, 그 키로 입력한 계정 ID에 접근할 수 있는지 확인합니다(버튼에 인증 중... 표시).

5. 계정이 목록에 준비 중으로 추가되고 첫 수집(최근 30일)이 바로 시작됩니다. 보통 몇 분 안에 성공으로 바뀝니다.

입력값에 문제가 있으면 다음 메시지가 표시됩니다.

계정이 여럿이면 계정 ID마다 하나씩 추가합니다.

연동 계정 관리하기

계정 목록에는 계정명, 상태, 데이터가 업데이트된 최근 일시, 관리(삭제) 열이 표시됩니다.

• 준비 중: 계정 추가 직후 첫 수집이 진행 중입니다.
• 성공: Taboola API 호출이 정상입니다. 광고를 집행하지 않아 데이터가 0건이어도 성공으로 표시됩니다.
• 실패: 키가 바뀌었거나 권한이 없어 Taboola가 요청을 거부했습니다. 배지에 마우스를 올리면 원인을 볼 수 있습니다. 수집할 때마다 다시 시도하므로 원인이 해결되면 자동으로 성공으로 돌아옵니다.
• 상태가 성공이어도 3일 넘게 비용 데이터가 저장되지 않으면 상태 옆에 경고가 나타납니다. 광고 미집행이 아니라면 연동을 확인하세요.

연동 정보는 수정할 수 없습니다. 키를 다시 발급했다면 계정을 삭제하고 새 키로 추가하세요. 계정을 삭제해도 이미 수집된 과거 데이터는 adstage에 남습니다.

4. 트래킹 링크 만들기

딥링크 > 생성에서 광고 채널로 Taboola를 선택합니다. 캠페인 칸에는 {campaign_name}, 추가 파라미터의 하위 채널 칸에는 {site}와 {site_id}가 자동으로 채워집니다. 그대로 두면 Taboola가 클릭 순간 실제 값으로 바꿔 줍니다.

링크에는 다음 매크로가 들어갑니다. 클릭 ID와 캠페인·광고 ID는 입력 여부와 관계없이 항상 붙습니다.

예시:

https://adg.im/@{조직}/track/taboola.ads?short_path={링크경로}&click_id={click_id}&campaign={campaign_name}&campaign_id={campaign_id}&ad_creative_id={campaign_item_id}&sub_channel={site}&sub_channel_1={site_id}

Taboola에 링크 넣기

Realize에서 광고를 만들 때 Landing Page URL 칸에 위 링크를 그대로 넣습니다. 캠페인 단위로 적용하려면 캠페인 생성·수정 화면 아래 Tracking Code 칸에 파라미터만 넣습니다(Taboola가 ?와 &를 붙이므로 맨 앞에 쓰지 않습니다).

주의하세요

• 같은 파라미터를 캠페인(Tracking Code)과 광고(Landing Page URL) 양쪽에 넣지 마세요. Taboola는 한쪽에만 넣으라고 안내하며, 양쪽에 넣으면 수치가 어긋날 수 있습니다.
• 링크의 매크로를 지우거나 바꾸지 마세요. 특히 click_id={click_id}가 빠지면 Taboola로 보내는 전환을 맞출 수 없습니다. 매크로 값 {click_id}는 문서에 적힌 그대로 써야 하며, 왼쪽 파라미터 이름만 바꿀 수 있습니다.
• 광고 그룹 칸은 비워 두세요. Taboola에는 광고 그룹 단계가 없고 비용도 캠페인 단위까지만 수집됩니다. 광고소재 이름 매크로도 광고주가 소재 이름을 직접 넣었을 때만 채워지므로 쓰지 않습니다.
• Taboola는 모든 광고 URL에 tblci 파라미터로도 클릭 ID를 자동으로 붙입니다. adstage는 링크의 click_id 값을 사용하므로 별도 설정은 필요 없습니다.

5. Taboola로 전환 보내기

Taboola는 광고주 서버가 직접 보내는 S2S 포스트백 규격을 공개합니다. adstage에서는 연동 화면이 아니라 **링크의 매체사 포스트백**에서 설정합니다.

1. Realize에서 전환(Conversion)을 먼저 만들고, 전환 설정의 Event Name 값을 확인합니다. Conversion Name이 아니라 Event Name입니다.

2. 위에서 만든 링크의 매체사 포스트백을 켜고 매체 프리셋에서 Taboola — S2S를 고릅니다. 다음 주소가 채워지고, 클릭 ID 파라미터명은 click_id, 포스트백 대상 이벤트는 purchase로 설정됩니다.

https://trc.taboola.com/actions-handler/log/3/s2s-action?click-id={click_id}&name={event}&revenue={revenue}&currency={currency}

3. adstage 이벤트명(예: purchase)이 Realize의 Event Name과 다르면 이벤트명 매핑에서 Realize 값으로 바꿔 주세요. Event Name은 대소문자를 구분합니다.

참고하세요

• 받는 쪽 파라미터 이름은 하이픈이 들어간 click-id여야 합니다. 프리셋 주소를 그대로 쓰면 됩니다.
• 포스트백은 이 링크로 귀속된 전환만 보내며, 같은 클릭의 같은 이벤트는 한 번만 보냅니다. 자세한 동작은 매체사 포스트백을 참고하세요.
• Taboola 문서의 선택 파라미터 중 orderid·quantity는 adstage에 대응하는 매크로가 없어 보내지 않습니다.

6. 수집되는 데이터

리포트에서는 매체 보고 값이라는 뜻으로 지표 이름에 **(Channel)**이 붙습니다(예: 비용 (Channel), 노출 (Channel)).

Taboola가 보고하는 전환 수(CPA Actions)와 전환 금액은 설치가 아니므로 설치 (Channel)·전환 수 (Channel) 지표로는 집계하지 않습니다. 전환은 adstage가 트래킹 링크로 직접 측정한 값으로 보세요.

7. 주의사항

• 지출·노출·클릭이 모두 없는 캠페인은 저장되지 않습니다. 광고를 집행하지 않은 기간이 비어 보이는 것은 정상입니다.
• 당일 데이터는 수집하지 않습니다. 어제까지의 데이터만 조회됩니다.
• Taboola와 adstage 간에 수치 차이가 있을 수 있습니다. Taboola는 데이터를 몇 시간 지연해 갱신하고 클릭은 48시간, 전환은 30일까지 소급 변경되므로, 최근 며칠 수치는 수집할 때마다 바뀔 수 있습니다.
• 노출 수를 Realize의 Served Ads와 비교하면 다르게 보입니다. adstage는 가시 노출 기준으로 수집합니다.
• 커스텀 링크의 채널에 taboola 또는 타불라라고만 써도 리포트에서는 taboola.ads로 집계됩니다.

8. 문제 해결

계정이 추가되지 않을 때

1. 계정 ID 확인: 숫자 ID가 아니라 Realize에 표시되는 영문 계정 ID를 넣었는지, 앞뒤 공백이 없는지 확인
2. 키 확인: Client ID와 Client Secret이 서로 바뀌지 않았는지, 복사할 때 공백이 섞이지 않았는지 확인
3. 권한 확인: 발급한 키로 그 계정에 접근할 수 있는지 Taboola 담당 AM에게 확인
4. 스위치 확인: Taboola 비용 연동 스위치가 켜져 있는지 확인

데이터가 수집되지 않을 때

1. 상태 확인: 상태가 실패면 마우스를 올려 원인을 확인하고, 인증 오류면 계정을 삭제한 뒤 새 키로 다시 등록
2. 집행 확인: Realize에서 해당 기간에 실제 지출이 있는지 확인
3. 범위 확인: 당일 데이터는 수집하지 않으며, 연동 시점 기준 최근 30일만 가져옴
4. 경고 확인: 상태 옆에 경고가 있으면 며칠째 데이터가 없는지 확인

Taboola에 전환이 보이지 않을 때

1. 링크 확인: Realize에 넣은 URL에 click_id={click_id}가 그대로 남아 있는지 확인
2. 이벤트명 확인: 보내는 이름이 Realize 전환 설정의 Event Name과 대소문자까지 같은지 확인
3. 포스트백 설정 확인: 해당 링크에 매체사 포스트백이 켜져 있고, 보내려는 이벤트가 포스트백 대상 이벤트에 있는지 확인
4. 귀속 확인: adstage 리포트에서 그 전환이 taboola.ads로 귀속됐는지 확인. 귀속되지 않은 이벤트는 보내지 않음

추가 지원이 필요한 경우 adstage 고객지원팀에 문의해 주세요.

9. 자주 묻는 질문

Taboola 담당자 없이도 연동할 수 있나요? Realize의 API Keys 페이지에서 직접 키를 발급할 수 있으면 가능합니다. 페이지가 보이지 않으면 Taboola 담당 AM에게 API 사용 승인을 요청하세요.

광고그룹·소재별 비용을 볼 수 있나요? 아니요. 비용은 캠페인 단위까지만 수집됩니다. 소재별로 전환을 비교하려면 링크에 광고소재 이름을 직접 넣고 소재마다 링크를 따로 만드세요.

Realize의 Impressions와 adstage 노출 수가 같은가요? 네. 둘 다 가시 노출 기준입니다. Served Ads 열과는 다릅니다.

연동 전 과거 데이터도 가져오나요? 연동 직후 최근 30일을 자동으로 가져옵니다. 그 이전 데이터가 필요하면 adstage 고객지원팀에 문의해 주세요.

참고 문서

• Backstage API 시작하기(API 키 발급 안내)
• Realize API Keys 페이지
• Client Credentials 인증 방식
• Campaign Summary 리포트
• Campaign Summary 표준 컬럼(노출·가시 노출·전환 정의)
• 트래킹용 URL 파라미터(매크로)
• S2S 수동 연동(클릭 ID 전달 방법)
• S2S 포스트백 URL 규격