コンテンツ管理

最終更新日: 2024年12月11日

概要

Reporting APIは、コンテンツの管理やイベントおよびAd Setの設定内容を確認するために使用できます。

はじめる前に: こちらの手順に従ってAPIに認証する必要があります。

Reporting APIを使ったレポートデータの取得方法については、Reporting API - パブリッシャーをご覧ください。
Reporting APIのエラーハンドリングと制限に関する情報は、Reporting API ベスト・プラクティスをご参照ください。

1. アプリの管理

アプリを追加する

Offerwallで収益化を行うアプリの設定です。アプリの追加は、こちらの手順に従ってダッシュボードからも実行できます。

注: このステップを完了するために、アプリがApp StoreまたはGoogle Playに公開されている必要はありません（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
    }
  }
}

アプリとプレイスメント情報の確認

アプリのプレイスメントID、コンテンツ、説明などの情報を確認できます。

参照: 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. プレイスメントとコンテンツカードの管理

プレイスメントとは、Offerwallを表示できるアプリ内の特定の領域のことです。コンテンツカードは、指定されたプレイスメントで表示される広告の種類を定義します。

プレイスメントとコンテンツカードを作成する

プレイスメントおよびコンテンツカードの作成は、こちらのダッシュボードからも可能です。

参照: 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で収益化するには仮想通貨の設定が必要です。アプリID、通貨名、為替レート、成熟度を指定してください。詳細についてはこちらをご覧ください。

仮想通貨を作成する

この操作はAPIでも実行可能です。アプリ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. 仮想通貨の管理