콘텐츠 관리
탭조이 오퍼월 리포트 API를 사용하여 앱, 콘텐츠 카드, 플레이스먼트, 가상 재화 등 오퍼월 설정을 효율적으로 관리할 수 있습니다.
읽는 시간 2분최근 업데이트: 2일 전
리포트 API를 사용하여 콘텐츠를 관리하고 이벤트와 광고 세트의 설정 세부 정보를 검토할 수 있습니다.
필수 조건
API로 인증해야 합니다. API 인증을 참고하십시오.- 리포트 API를 통해 리포팅 데이터 가져오기에 관한 내용을 알아보려면 리포트 API - 퍼블리셔를 참고하십시오.
- 리포트 API로 오류 처리 및 제한 사항에 관한 내용을 알아보려면 리포트 API 베스트 프랙티스를 참고하십시오.
앱 관리
앱 추가
오퍼월을 사용하여 수익화할 앱입니다. 대시보드에서도 앱을 추가할 수 있습니다. 자세한 내용은 오퍼월 설정 가이드를 참고하십시오.참고
App Store나 Google Play 스토어에 릴리스되지 않아도 이 단계를 완료할 수 있습니다(storeUrl 파라미터: 선택 사항). mutation createPublisherAppWithStoreUrl { createPublisherApp(input: { name: "App Created With Store URL", platform: ANDROID, storeUrl: "https://play.google.com/store/apps/details?id=com.tapjoy.tapout&gl=us", orientation: PORTRAIT }) { app { id name timezone realWorldCurrency } }}mutation createPublisherAppWithoutStoreUrl { createPublisherApp(input: { name: "App Created WithOUT Store URL", platform: ANDROID, orientation: PORTRAIT, currency: KRW, timezone: TOKYO_SEOUL }) { app { id name timezone realWorldCurrency } }}
앱 및 플레이스먼트 정보 조회
플레이스먼트 ID, 콘텐츠, 설명 등 앱의 플레이스먼트 정보를 검토합니다. 레퍼런스: Publisher#apps 필드, PublisherApp 유형query { publisher{ apps(first: 50){ edges{ node{ id name placements{ id name mediationName } } } pageInfo { endCursor hasNextPage } } }}
{ "data": { "publisher": { "apps": { "edges": [ { "node": { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "placements": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "mediationName": null }, { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "mediationName": null }, { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "mediationName": "ironsource" }, { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "mediationName": null } ] } }, { "node": { "id": "00000000-0000-0000-0000-000000000000", "name": "XXX YYY ZZZ", "placements": [] } } ], "pageInfo": { "endCursor": "Mg", "hasNextPage": true } } } }}
특정 앱 ID의 플레이스먼트 정보 조회
레퍼런스: Publisher#placements 필드, 플레이스먼트 유형query { publisher{ placements(appId: "00000000-0000-0000-0000-000000000000"){ id name mediationName } }}
{ "data": { "publisher": { "placements": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "AppLaunch", "mediationName": null }, { "id": "00000000-0000-0000-0000-000000000000", "name": "InsufficientCurrency", "mediationName": null }, ] } }}
플레이스먼트 및 콘텐츠 카드 관리
플레이스먼트는 앱에서 오퍼월을 표시할 수 있는 특정 영역입니다. 콘텐츠 카드는 특정 플레이스먼트에 표시할 광고 유형을 정의합니다.플레이스먼트 및 콘텐츠 카드 생성
대시보드에서 플레이스먼트와 콘텐츠 카드를 생성할 수 있습니다. 자세한 내용은 각각 플레이스먼트와 오퍼월 카드 설정을 참고하십시오. 레퍼런스: createPlacementsAndContents 변화mutation createPlacementAndContent { createPlacementsAndContents(input: {entries: [ { appId: "<PASTE_YOUR_APP_ID_HERE>", placementName: "Placement from API" } ]}) { placements { id name description contents { id name type isSkippable } } }}
콘텐츠 카드 설정 조회
설정된 A/B 테스트의 콘텐츠 카드 ID, 유형, 상태 등의 정보를 확인합니다. 레퍼런스: Placement#contents 필드, ContentCard 유형query { publisher { placements (appId:"00000000-0000-0000-0000-000000000000") { id name contents { id name } } }}
{ "data": { "publisher": { "placements": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "AppLaunch", "contents": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "Content for AppLaunch testing by Tapjoy" }, { "id": "00000000-0000-0000-0000-000000000000", "name": "Content for testing placement by Tapjoy" } ] }, { "id": "00000000-0000-0000-0000-000000000000", "name": "InsufficientCurrency", "contents": [ { "id": "00000000-0000-0000-0000-000000000000", "name": "Content for InsufficientCurrency testing by Tapjoy" }, { "id": "00000000-0000-0000-0000-000000000000", "name": "Content for testing placement by Tapjoy" } ] } ] } }}
가상 재화 관리
탭조이로 수익화를 진행하려면 가상 재화가 필요합니다. 앱 ID, 재화 이름, 교환율, 만료 기간을 제공해야 합니다. 자세한 내용은 가상 재화 개요를 참고하십시오.가상 재화 생성
API에서 이 액션을 수행하려면 앱 ID, 재화 이름, 교환율, 만료 시간을 제공해야 합니다. 대시보드에서도 가상 재화를 생성할 수 있습니다. 레퍼런스: createCurrency 변화mutation createCurrency { createCurrency(input: { appId: "<PASTE_YOUR_APP_ID_HERE>", name: "New Virtual Currency", exchangeRate: 100, maturity: MEDIUM }) { currency { id name exchangeRate initialBalance maturity } }}
가상 재화 업데이트
아래의 변화를 사용하여 가상 재화를 업데이트할 수도 있습니다. 레퍼런스: updateCurrency 변화mutation updateCurrency { updateCurrency(input: { id: "<CURRENCY_ID>", maturity: HIGH, name: "Shell Bells", initialBalance: 100 }) { currency { id name exchangeRate initialBalance maturity callbackUrl } }}