콘텐츠 관리
탭조이 오퍼월 리포트 API를 사용하여 앱, 콘텐츠 카드, 플레이스먼트, 가상 재화 등 오퍼월 설정을 효율적으로 관리할 수 있습니다.
읽는 시간 3분최근 업데이트: 9시간 전
리포트 API를 사용하여 콘텐츠를 관리하고 이벤트와 광고 세트의 설정 세부 정보를 검토할 수 있습니다.
필수 조건
API로 인증해야 합니다. API 인증을 참고하십시오.
- 리포트 API를 통해 보고 데이터 가져오기에 관한 내용을 알아보려면 리포트 API - 퍼블리셔를 참고하십시오.
- 리포트 API로 오류 처리 및 제한 사항에 관한 내용을 알아보려면 리포트 API 베스트 프랙티스를 참고하십시오.
앱 관리
앱 추가
오퍼월을 사용하여 수익화할 앱입니다. 대시보드에서도 앱을 추가할 수 있습니다. 자세한 내용은 오퍼월 설정 가이드를 참고하십시오.
참고
이 단계를 완료하기 위해 앱이 App Store나 Google Play 스토어에 출시되어 있을 필요는 없습니다(storeUrl 파라미터: 선택 사항).
레퍼런스: createPublisherApp 변경
다음의 변환은 스토어 URL이 포함되어 있거나 없는 새로운 퍼블리셔 앱을 생성합니다.
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 유형
다음 쿼리 ID, 이름, 관련 플레이스먼트 세부 정보를 포함하여 최대 50개의 앱 반환합니다.
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 필드, 플레이스먼트 유형
다음 쿼리 ID, 이름, Mediation 이름 등 특정 앱의 모든 플레이스먼트를 반환합니다.
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 } }}