キャンペーンの管理
Tapjoy の Reporting API を使用して広告キャンペーンを管理すると、広告セットの設定、入札額、イベント設定、アプリ固有の設定を確認および更新してキャンペーンのパフォーマンスを最適化できます。
読み終わるまでの所要時間 3 分最終更新 10日前
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 スカラータイプの ドキュメント を参照してください。mutation { updateAdSetBidding(input: { id: "00000000-0000-0000-0000-000000000000", bidding: {amount: 1000000} }) { bidding { amount } }}
{ "data": { "bidding": { "amount": 1000000 } }}
マルチリワードイベントの管理
入札額、イベント名、イベントがリニアかどうかなど、マルチリワードオファーのイベントレベル情報を確認できます。注
入札額、状態、またはコンバージョン数に関係なく、広告セットでのすべてのイベントが返されます。{ 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 は必須です。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 アプリの下に表示されます。{ 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 内でコンバージョンが発生したときに、最上位レベルで設定された価値の代わりに使用されます。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 } ] } ] } } }}