캠페인 관리

탭조이의 리포트 API를 사용한 광고 캠페인 관리를 통해 광고 세트 설정, 입찰가, 이벤트 설정, 앱별 설정을 검토하고 업데이트하여 캠페인 성과를 최적화할 수 있습니다.

읽는 시간 2분

최근 업데이트: 3달 전

리포트 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 - 미국 달러 기준) 단위로 표시됩니다. 자세한 내용은 현금 스칼라 유형기술 자료를 참고하십시오.

레퍼런스: 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 생성과 삭제 작업은 한 번의 변경으로 수행됩니다. 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_를 생성하고 삭제하는 작업은 한 번의 변경으로 수행됩니다. 퍼블리셔 AppReference ID를 1개 이상 제공하고 2개 이상의 _MultiRewardEngagementEvents_가 포함된 목록을 제공해야 합니다. 주어진 퍼블리셔 _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

산업 분야