FAQ stat - naver/searchad-apidoc GitHub Wiki

Table of Contents

FAQ

Q. ์—ฐ๊ฐ„ ํ‚ค์›Œ๋“œ ๊ฒ€์ƒ‰์ˆ˜ ์ถ”์ด API ์ œ๊ณต์—ฌ๋ถ€

ํŠน์ • ํ‚ค์›Œ๋“œ์˜ ๊ณผ๊ฑฐ 1๋…„๊ฐ„์˜ ๊ฒ€์ƒ‰์ˆ˜ ์ถ”์ด๋Š” ์—ฐ๊ด€ํ‚ค์›Œ๋“œ์˜ ์„ ํƒ์— ๋„์›€์„ ๋“œ๋ฆฌ๊ณ ์ž ๊ทธ๋ž˜ํ”„ UI ํ˜•ํƒœ๋กœ๋งŒ ์ œ๊ณต๋“œ๋ฆฌ๋ฉฐ, ๋„ค์ด๋ฒ„ ๊ฒ€์ƒ‰๊ด‘๊ณ  API ์„œ๋น„์Šค๋ฅผ ํ†ตํ•ด์„œ๋Š” ์ œ๊ณต๋“œ๋ฆฌ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๊ฒ€์ƒ‰์ˆ˜ ์ถ”์ด์— ๋Œ€ํ•œ ์ •๋ณด๋Š” ๊ฒ€์ƒ‰๊ด‘๊ณ ๊ฐ€ ์•„๋‹ˆ๋ผ ๋„ค์ด๋ฒ„ ์ฐจ์›์—์„œ ๋„ค์ด๋ฒ„๋ฐ์ดํ„ฐ๋žฉ์„ ์šด์˜ํ•˜๊ณ  ์žˆ๋Š”๋ฐ์š”. ๊ธฐ๊ฐ„๊ณผ ๋‚ด์šฉ์ด ๋” ์ƒ์„ธํ•œ ๋ฐ์ดํ„ฐ๊ฐ€ ์ œ๊ณต๋˜๊ณ  ์žˆ์œผ๋‹ˆ ํ™œ์šฉ์„ ๊ฒ€ํ† ํ•ด ๋ณด์‹œ๋ฉด ์ข‹์„ ๊ฒƒ ๊ฐ™์Šต๋‹ˆ๋‹ค. ๋‹จ, ์ด API์˜ ๊ฒฝ์šฐ๋Š” ์ ˆ๋Œ€๊ฐ’์ด ์•„๋‹Œ ์กฐํšŒ๊ธฐ๊ฐ„ ์ค‘ ์ตœ๋Œ€๊ฐ’์„ ๊ธฐ์ค€์œผ๋กœ ๊ตฌ์„ฑ๋œ ์ƒ๋Œ€๊ฐ’์ด๋ผ๋Š” ์  ์ฃผ์˜ ๋ถ€ํƒ๋“œ๋ฆฝ๋‹ˆ๋‹ค. ๋„ค์ด๋ฒ„ ๋ฐ์ดํ„ฐ๋žฉ API ์•ˆ๋‚ด : https://developers.naver.com/products/datalab/

Q. timeRange ๊ธฐ์ค€ ๋ฒ”์œ„

  • breakdown ์ด ์—†๋Š” ์ผ๋ฐ˜ ๋ฆฌํฌํŠธ

    • ์ œ๊ณต๊ธฐ๊ฐ„: 2๋…„

    • ๋ฐ์ดํ„ฐ ์œˆ๋„์šฐ: 92์ผ(์•ฝ 3๊ฐœ์›”)

  • breakdown์ด ์žˆ๋Š” ์ผ๋ฐ˜ ๋ฆฌํฌํŠธ (์บ ํŽ˜์ธ ํƒ€์ž…์— ๋”ฐ๋ผ ๋‹ค๋ฆ„)

    • ์บ ํŽ˜์ธ ํƒ€์ž… | ์ œ๊ณต๊ธฐ๊ฐ„ | ๋ฐ์ดํ„ฐ ์œˆ๋„์šฐ

      1. ํŒŒ์›Œ๋งํฌ | 7 | 7

      2. ์‡ผํ•‘๊ฒ€์ƒ‰ | 7 | 7

      3. ํŒŒ์›Œ์ปจํ…์ธ  | 7 | 7

      4. ๋ธŒ๋žœ๋“œ๊ฒ€์ƒ‰ | 120 | 90

      5. ์‹ ์ œํ’ˆ | 7 | 7

      6. ํ”Œ๋ ˆ์ด์Šค ๊ด‘๊ณ  | 120 | 90

Q. stat ์ง€ํ‘œ ํ•ญ๋ชฉ ์˜๋ฏธ

  • impCnt ๋…ธ์ถœ์ˆ˜

  • clkCnt ํด๋ฆญ์ˆ˜

  • ctr ํด๋ฆญ๋ฅ 

  • cpc ํ‰๊ท ํด๋ฆญ๋น„์šฉ

  • salesAmt ์ด๋น„์šฉ

  • ccnt ์ „ํ™˜์ˆ˜

  • crto ์ „ํ™˜์œจ

  • convAmt ์ „ํ™˜๋งค์ถœ์•ก

  • ror ๊ด‘๊ณ ์ˆ˜์ต๋ฅ  (์ „ํ™˜๋งค์ถœ/์ด๋น„์šฉ

  • cpConv ์ „ํ™˜๋‹น๋น„์šฉ (์ด๋น„์šฉ/์ „ํ™˜์ˆ˜)

  • avgRnk ํ‰๊ท ๋…ธ์ถœ์ˆœ์œ„

  • pcNxAvgRnk PC ํ†ต๊ฒ€ ํ‰๊ท ๋…ธ์ถœ์ˆœ์œ„

  • mblNxAvgRnk ๋ชจ๋ฐ”์ผ ํ†ต๊ฒ€ ํ‰๊ท ๋…ธ์ถœ์ˆœ์œ„

  • recentAvgRnk ์ตœ๊ทผ ํ†ต๊ฒ€ ํ‰๊ท ๋…ธ์ถœ์ˆœ์œ„

  • viewCnt ๋™์˜์ƒ์กฐํšŒ์ˆ˜

Q. stat report ํ•ญ๋ชฉ๋ณ„ ๊ธฐ๊ฐ„

  • AD: 365์ผ (๊ด‘๊ณ ํšจ๊ณผ๋ณด๊ณ ์„œ)

  • AD_DETAIL: 180์ผ (๊ด‘๊ณ ํšจ๊ณผ์ƒ์„ธ๋ณด๊ณ ์„œ)

  • AD_CONVERSION: 365์ผ (๊ด‘๊ณ ์ „ํ™˜๋ณด๊ณ ์„œ)

  • AD_CONVERSION_DETAIL: 45์ผ (๊ด‘๊ณ ์ „ํ™˜์ƒ์„ธ๋ณด๊ณ ์„œ)

  • ADEXTENSION: 365์ผ (ํ™•์žฅ์†Œ์žฌํšจ๊ณผ๋ณด๊ณ ์„œ)

  • ADEXTENSION_CONVERSION: 365์ผ (ํ™•์žฅ์†Œ์žฌ์ „ํ™˜๋ณด๊ณ ์„œ)

  • NAVERPAY_CONVERSION: 365์ผ (๋„ค์ด๋ฒ„ํŽ˜์ด๋ณด๊ณ ์„œ)

  • EXPKEYWORD: 365์ผ (ํ‚ค์›Œ๋“œํ™•์žฅ๊ด‘๊ณ ํšจ๊ณผ๋ณด๊ณ ์„œ)

  • SHOPPINGKEYWORD_DETAIL: 180์ผ (์‡ผํ•‘๊ฒ€์ƒ‰๊ด‘๊ณ ํ‚ค์›Œ๋“œ์ƒ์„ธ๋ณด๊ณ ์„œ)

  • SHOPPINGKEYWORD_CONVERSION_DETAIL: 45์ผ (์‡ผํ•‘๊ฒ€์ƒ‰๊ด‘๊ณ ํ‚ค์›Œ๋“œ์ƒ์„ธ์ „ํ™˜๋ณด๊ณ ์„œ)

  • SHOPPINGBRANDPRODUCT: 365์ผ (์‡ผํ•‘๊ฒ€์ƒ‰๊ด‘๊ณ ๋ธŒ๋žœ๋“œํ˜• ์ƒํ’ˆ๋ณ„ ๊ด‘๊ณ ํšจ๊ณผ๋ณด๊ณ ์„œ)

  • SHOPPINGBRANDPRODUCT_CONVERSION: 365์ผ (์‡ผํ•‘๊ฒ€์ƒ‰๊ด‘๊ณ ๋ธŒ๋žœ๋“œํ˜• ์ƒํ’ˆ์ „ํ™˜๋ณด๊ณ ์„œ)

  • CRITERION: 365์ผ (ํƒ€๊ฒŒํŒ… ์„ฑ๊ณผ ๋ณด๊ณ ์„œ)

  • CRITERION_CONVERSION: 365์ผ (ํƒ€๊ฒŒํŒ… ์ „ํ™˜ ๋ณด๊ณ ์„œ)

Q. statType ์„ ํ†ตํ•ด์„œ ์ œ๊ณต๋˜๋Š” ๋ณด๊ณ ์„œ ์ข…๋ฅ˜

  • ์‡ผํ•‘๊ฒ€์ƒ‰์—์„œ NPLA_SCH_KEYWORD custom ๋ณด๊ณ ์„œ (์‡ผํ•‘๊ฒ€์ƒ‰์˜ ํ‚ค์›Œ๋“œ๋ณ„ ๋ณด๊ณ ์„œ)

  • ๋ธŒ๋žœ๋“œ๊ฒ€์ƒ‰์—์„œ BRND_CONTRACT custom ๋ณด๊ณ ์„œ (๋ธŒ๋žœ๋“œ๊ฒ€์ƒ‰์˜ ๊ณ„์•ฝ๋ณ„ ๋ณด๊ณ ์„œ)

โš ๏ธ **GitHub.com Fallback** โš ๏ธ