콘텐츠 관리

마지막 업데이트: 12/11/2024

개요

리포트 API를 통해 콘텐츠 관리와 상세 설정을 리뷰할 수 있습니다.

시작하기 전에: API 인증 절차에 따라 인증을 진행해야 합니다. API 인증.

리포트 API를 통해 데이터를 가져오는 방법을 확인하고자 하는 경우 퍼블리셔 용 리포트 API.
에러 관리 및 리포트 API 관련 정보를 확인하고자 하는 경우 리포트 API 사용 예시.

1. 앱 관리

앱 추가하기

오퍼월을 통해 여러분의 수익화 하길 원하는 앱을 추가합니다. 앱 추가는 대시보드를 통해서도 가능합니다. 자세한 내용은 앱 생성하기 문서를 참고 부탁드립니다.

참고: 앱은 생성을 위해 반드시 앱을 구글 플레이 / 앱스토어에 출시할 필요는 없습니다.p (storeUrl 선택사항입니다).

레퍼런스: createPublisherApp mutation

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
    }
  }
}

앱과 플레이스먼트 정보 확인

앱 내 플레이스먼트 정보를 확인합니다.

레퍼런스: Publisher#apps field, PublisherApp type

Query

Result

query {
  publisher{
    apps(first: 50){
      edges{
        node{
          id
          name
          placements{
            id
            name
            mediationName
          }
        }
      }
      pageInfo {
        endCursor
        hasNextPage
      }
    }
  }
}

특정 앱 ID를 통한 플레이스먼트 정보 확인

레퍼런스: Publisher#placements field, Placement type

Query

Result

query {
  publisher{
    placements(appId: "00000000-0000-0000-0000-000000000000"){
      id
      name
      mediationName
    }
  }
}

2. 플레이스먼트와 콘텐츠 카드 관리

플레이스먼트는 오퍼월이 노출되는 위치를 말합니다. 콘텐츠 카드는 플레이스먼트 내 노출할 광고 타입을 말합니다.

플레이스먼트 및 콘텐츠 카드 생성

플레이스먼트와 콘텐츠 카드는 대시보드에서도 생성하실 수 있습니다. 자세한 내용은 here 문서를 참고하시길 바랍니다.

레퍼런스: createPlacementsAndContents mutation

mutation createPlacementAndContent {
  createPlacementsAndContents(input: {entries: [
    {
      appId: "<PASTE_YOUR_APP_ID_HERE>",
      placementName: "Placement from API"
    }
  ]}) {
    placements {
      id
      name
      description
      contents {
        id
        name
        type
        isSkippable
      }
    }
  }
}

콘텐츠 카드 설정 확인

콘텐츠 카드의 ID, 타입 기타 A/B 테스트 관련 설정을 확인합니다. 레퍼런스: Placement#contents field, ContentCard type

Query

Result

query {
  publisher {
    placements (appId:"00000000-0000-0000-0000-000000000000") {
      id
      name
      contents {
        id
        name
      }
    }
  }
}

3. 가상화폐 관리

가상화폐는 Tapjoy를 통한 수익화를 위해 필요합니다. 이를 위해 App ID, 가상화폐 이름, 환율 그리고 등급 설정이 필요합니다. 자세한 내용은 가상화폐 설정 문서를 참고하시길 바랍니다.

가상화폐 생성하기

API를 실행하기 위해서는 우선 App ID, 가상화폐 이름, 환율 그리고 등급 설정이 필요합니다. 가상화폐는 대시보드에서도 생성 가능하며 자세한 내용은 가상화폐 설정하기 문서를 참고하시길 바랍니다.

레퍼런스: createCurrency mutation

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

mutation updateCurrency {
  updateCurrency(input: {
    id: "<CURRENCY_ID>",
    maturity: HIGH,
    name: "Shell Bells",
    initialBalance: 100
  }) {
    currency {
      id
      name
      exchangeRate
      initialBalance
      maturity
      callbackUrl
    }
  }
}

콘텐츠 관리
개요
1. 앱 관리
2. 플레이스먼트와 콘텐츠 카드 관리
3. 가상화폐 관리