キャンペーンの管理

Tapjoy の Reporting API を使用して広告キャンペーンを管理すると、広告セットの設定、入札額、イベント設定、アプリ固有の設定を確認および更新してキャンペーンのパフォーマンスを最適化できます。

読み終わるまでの所要時間 3 分

最終更新 1日前

Reporting API を使用して、キャンペーンを管理し、イベントと広告セットの設定の詳細を確認できます。

前提条件

こちらの手順に従って、API で認証する必要があります。

Reporting API によるレポートデータの取得については、Reporting API - 広告主を参照してください。
Reporting API のエラー処理と制限事項については、Reporting API のベストプラクティスを参照してください。

広告セットの管理

入札額、ターゲティングデータ、キャンペーン状態など、広告セット設定の詳細を確認します。参照情報: Advertiser#adSets フィールド、AdSet タイプ


query {  advertiser {    adSets(first: 50) {      edges {        node {          id          bidding {            amount          }          campaign {            objective          }        }      }      pageInfo {        endCursor        hasNextPage      }    }  }}


{  "data": {    "advertiser": {      "adSets": {        "edges": [          {            "node": {              "id": "00000000-0000-0000-0000-000000000000",              "bidding": {                "amount": 0.02              },              "campaign": {                "objective": "VIEWS"              }            }          },          {            "node": {              "id": "00000000-0000-0000-0000-000000000001",              "bidding": {                "amount": 0.04              },              "campaign": {                "objective": "VIEWS"              }            }          }        ],        "pageInfo": {          "endCursor": "Mg==",          "hasNextPage": false        }      }    }  }}

広告セットの入札額の変更

注

返された入札額は、マイクロ単位 (100 万分の 1 ドル) で表されます。詳細については、Money スカラータイプのドキュメントを参照してください。

参照情報: AdSetBiddingUpdateInput タイプ


mutation {  updateAdSetBidding(input: {    id: "00000000-0000-0000-0000-000000000000",    bidding: {amount: 1000000}  }) {    bidding {      amount    }  }}


{  "data": {    "bidding": {      "amount": 1000000    }  }}

マルチリワードイベントの管理

入札額、イベント名、イベントがリニアかどうかなど、マルチリワードオファーのイベントレベル情報を確認できます。

注

入札額、状態、またはコンバージョン数に関係なく、広告セットでのすべてのイベントが返されます。

参照情報: MultiRewardEngagementEvent タイプ


{  adSet(id: "00000000-0000-0000-0000-000000000000") {    multiRewardEngagementSettings {      events {        eventName        eventValue        amount      }    }  }}


{  "data": {    "adSet": {      "multiRewardEngagementSettings": [        {          "events": [            {              "eventName": "level_#",              "eventValue": "5",              "amount": 0            },            {              "eventName": "level_#",              "eventValue": "10",              "amount": 480000            },            }          ]        }      ]    }  }}

マルチリワードイベントの作成と削除

注

MultiRewardEngagementEvents の作成と削除は、1 回のミューテーションで行われます。AdSet ID と、少なくとも 2 つの MultiRewardEngagementEvents のリストを指定する必要があります。イベントを無効にするには、disable: true 属性を加えます。誤って削除することを防ぐために、イベントを無効にする場合でも、eventName と eventValue は必須です。

参照情報: AdSetBiddingUpdateInput タイプ、MultiRewardEngagementEventInput タイプ


mutation {  updateAdSetBidding(    input:{      id: "00000000-0000-0000-0000-000000000000"      bidding: {        multiRewardEngagementEvents: [          {            eventName:"TUTORIAL_COMPLETE",            eventValue: "",            amount: 2200000          },          {            eventName:"LEVEL_ONE",            eventValue: "",            amount: 12200000          },          {            eventName:"LEVEL_TWO",            eventValue: "",            disable: true          }        ]      }    }  ) {    bidding {      multiRewardEngagementEvents {        eventName        eventValue        amount      }    }  }}


{  "data": {    "updateAdSetBidding": {      "bidding": {        "multiRewardEngagementEvents": [          {            "eventName": "TUTORIAL_COMPLETE",            "eventValue": "",            "amount": 2200000          },          {            "eventName": "LEVEL_ONE",            "eventValue": "",            "amount": 12200000          }        ]      }    }  }}

アプリ固有の設定の管理

パブリッシャーアプリ固有の入札が有効になっているマルチリワードオファーのイベントレベル情報を参照してください。入札額、イベント名、イベントの線形性などのイベント情報をパブリッシャーアプリ別に返します。

注

パブリッシャーアプリ固有ではないイベント設定は、null アプリの下に表示されます。

参照情報: MultiRewardEngagementEvent タイプ、AppReference タイプ


{  adSet(id: "00000000-0000-0000-0000-000000000000") {    multiRewardEngagementSettings {      app {        bundleId      }      events {        eventName        eventValue        amount      }    }  }}


{  "data": {    "adSet": {      "multiRewardEngagementSettings": [        {          "app": null,          "events": [            {              "eventName": "level_#",              "eventValue": "5",              "amount": 0            },            {              "eventName": "level_#",              "eventValue": "10",              "amount": 480000            },          ]        },        {          "app": {            "bundleId": "com.app.example"          },          "events": [            {              "eventName": "level_#",              "eventValue": "10",              "amount": 520000            },            {              "eventName": "level_#",              "eventValue": "30",              "amount": 1680000            },          ]        }      ]    }  }}

アプリごとのイベント設定の作成と削除

注

MultiRewardEngagementEvents と同様に、AppBiddingGroups の作成と削除は 1 回のミューテーションで行われます。パブリッシャーの AppReference ID を 1 つ以上と、MultiRewardEngagementEvents のリストを 2 つ以上指定する必要があります。これらのイベントの額は、指定されたパブリッシャーの AppReference 内でコンバージョンが発生したときに、最上位レベルで設定された価値の代わりに使用されます。

イベントまたはアプリごとの入札グループを無効にするには、disable: true をオブジェクトに追加します。アプリごとの入札グループを無効にすると、その子イベントが自動的に無効になります。イベントを無効にする場合は、誤って削除することを防ぐために、eventName と eventValue が必要です。参照情報: AdSetBiddingUpdateInput タイプ、AppBiddingGroupInput タイプ、MultiRewardEngagementEventInput タイプ、AppReference タイプ


mutation {  updateAdSetBidding(    input:{      id: "00000000-0000-0000-0000-000000000000"      bidding: {        perAppBidGroups: [{          pubAppId:"<example_publisher_app_id>"          multiRewardEngagementEvents: [            {              eventName:"TUTORIAL_COMPLETE",              eventValue: "",              amount: 5500000            },            {              eventName:"LEVEL_ONE",              eventValue: "",              disable: true,            }            ]        },        {          pubAppId:"<example_publisher_app_id_2>",          disable: true        }],        multiRewardEngagementEvents: [          {            eventName:"TUTORIAL_COMPLETE",            eventValue: "",            amount: 2200000          },          {            eventName:"LEVEL_ONE",            eventValue: "",            amount: 12200000          },          {            eventName:"LEVEL_TWO",            eventValue: "",            disable: true          }        ]      }    }  ) {    bidding {      multiRewardEngagementEvents {        eventName        eventValue        amount      }      perAppBidGroups {          pubApp {            id            name          }        }        multiRewardEngagementEvents {          eventName          eventValue          amount      }    }  }}


{  "data": {    "updateAdSetBidding": {      "bidding": {        "multiRewardEngagementEvents": [          {            "eventName": "TUTORIAL_COMPLETE",            "eventValue": "",            "amount": 2200000          },          {            "eventName":"LEVEL_ONE",            "eventValue": "",            "amount": 12200000          }        ],        "perAppBidGroups": [          {            "pubApp": {              "id": "example_publisher_app_id",              "name": "Example Publisher App"            },            "multiRewardEngagementEvents": [              {                "eventName": "TUTORIAL_COMPLETE",                "eventValue": "",                "amount": 5500000              },              {                "eventName": "LEVEL_ONE",                "eventValue": "",                "amount": 15500000              }            ]          }        ]      }    }  }}

ドキュメント

Development

User Acquisition

Monetization

産業