플레이스먼트 API

• 플레이스먼트 목록 전체 세부 정보 확인
• 새 플레이스먼트를 생성하고 플레이스먼트 광고 게재 설정을 정의합니다.
• 기존 플레이스먼트 업데이트
• 삭제(아카이브) 배치

메서드 가져오기

설명

요청

URL 요청 예시

요청 파라미터

응답

응답 파라미터

응답 바디 예시

[    {        "name": "Home_Screen",        "id": 12,        "adUnit": "rewardedVideo",        "itemName": "코인",        "rewardAmount": 3,        "adDelivery": 1,        "capping": {            "enabled": 1,            "cappingLimit": 3,            "cappingInterval": "h"        },        "pacing": {            "enabled": 1,            "pacingMinutes": 12.5        },        "abVersion": "A"    }]

포스트 메서드

• 인터스티셜 광고
• Banner
• 플레이스먼트 이름은 광고 유닛 유형별로 고유해야 합니다.
• 단일 POST 호출 멀티 플레이스먼트 생성이 지원됩니다.
• 그에 대한 응답으로 placementId를 받게 됩니다. 이 파라미터 Ironsource 플랫폼에 표시되지 않습니다. PUT 및 DELETE 메서드에 이 파라미터 사용해야 합니다.

요청

요청 바디 파라미터

요청 바디 예시

{  "appKey": "28cd2e39",  "placements": [    {      "adUnit": "rewardedVideo", // rewardedVideo / interstitial / banner      "name": "Main_Menu", // 고유 플레이스먼트 이름      "itemName": "코인", // 보상형 광고 항목 이름      "rewardAmount": 25, // 광고 조회당 제공할 보상 금액      "capping": {        	"enabled": 1, // 1 - 제한을 활성화하다, 사용 가능하다, 그렇지 않으면 0 (기본값: 1)		"cappingLimit": 3, // cappingInterval당 광고 수 제한		"cappingInterval": "h" // interval type. "h"-hours, "d"-days (default: “d”)      }    },    {      "adUnit": "banner",      "name": "Custom_Pause",      "pacing": {      	"enabled": 0, // 1 - 활성화하다, 사용 가능하다 0(기본값: 1)	  	"pacingMinutes": 3, // 분 단위의 페이싱 간격      }    }  ]}

응답

응답 파라미터

응답 바디 예시

{    "appKey": "28cd2e39",    "placements": [        {            "adUnit": "rewardedVideo",            "id": 2, // 플레이스먼트의 고유 ID            "name": "Main_Menu"        },        {            "adUnit": "banner",            "id": 4,            "name": "Custom_Pause"        }    ]}

put 메서드

• 보상형 동영상
• 인터스티셜 광고
• Banner

요청

URL 요청 예시

https://dev-php-ssp5.supersonicads.com/partners/publisher/placements/v1?appKey=132deb27d

요청 바디 파라미터

요청 바디 예시

{    "appKey": "28cd2e39",    "placements": [        {            "adUnit": "rewardedVideo", // rewardedVideo / interstitial / banner            "id": 1, // 고유 플레이스먼트 ID            "rewardAmount": 25, // 제공할 보상 금액 변경            "adDelivery": 1, // 광고 전송 토글, 1 - 활성화, 그렇지 않으면 0            "capping": {                "cappingInterval": "h" // 한도 간격을 시간으로 업데이트            }        },        {            "adUnit": "interstitial",            "id": 3,            "pacing": {                "enabled": 1, // 1 - 활성화하다, 사용 가능하다, 그렇지 않으면 0                "pacingMinutes": 15, // 분 단위의 페이싱 간격            }        }    ]}

응답

메서드 삭제

• 보상형 동영상
• 인터스티셜 광고
• Banner

요청

요청 바디 파라미터

요청 바디 예시

{    "appKey": "28cd2e39",    "adUnit": "rewardedVideo", // rewardedVideo / interstitial / banner    "id": 1 // 고유 플레이스먼트 ID}

응답