캠페인 관리
탭조이의 리포트 API를 사용한 광고 캠페인 관리를 통해 광고 세트 설정, 입찰가, 이벤트 설정, 앱별 설정을 검토하고 업데이트하여 캠페인 성과를 최적화할 수 있습니다.
읽는 시간 2분최근 업데이트: 2일 전
리포트 API를 사용하여 캠페인을 관리하고 이벤트와 광고 세트의 설정 세부 정보를 검토할 수 있습니다.
필수 조건
여기에 나온 단계에 따라 API로 인증해야 합니다.- 리포트 API를 통해 리포트 데이터를 검색하는 방법에 대한 자세한 내용은 리포트 API - 광고주를 참고하십시오.
- 리포트 API로 오류 처리 및 제한 사항에 관한 내용을 알아보려면 리포트 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 } } } }}
광고 세트의 입찰가 변경
참고
반환된 입찰가는 마이크로(1,000,000분의 1 - 미국 달러 기준) 단위로 표시됩니다. 자세한 내용은 현금 스칼라 유형문서를 참고하십시오. 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 생성과 삭제 작업은 한 번의 변경으로 수행됩니다. 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_를 생성하고 삭제하는 작업은 한 번의 변경으로 수행됩니다. 퍼블리셔 AppReference ID를 1개 이상 제공하고 2개 이상의 _MultiRewardEngagementEvents_가 포함된 목록을 제공해야 합니다. 주어진 퍼블리셔 _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 } ] } ] } } }}