인스턴스 API v4

• CRUD 지원
• 광고 네트워크의 애플리케이션 레벨 구성 변경
• 워터폴 그룹에서 인스턴스 추가 또는 제거(활성 AB 테스트 애플리케이션 지원)

속도 제한

인증 유형

GET

설명

메서드

요청 파라미터

요청 예시 URL

응답 파라미터

응답 예시

[  {    "instanceId": 1072562,    "instanceName": "",    "adUnit": "rewardedVideo",    "adFormat": "rewarded",    "networkName": "unityAds",    "appConfig1": "qtr",    "instanceConfig1": "trb",    "isBidder": true,    "groups": [101663],    "isLive": true  },  {    "instanceId": 1014428,    "instanceName": "기본값",    "adUnit": "interstitial",    "adFormat": "interstitial",    "networkName": "unityAds",    "appConfig1": "qertb",    "instanceConfig1": "qtrb",    "isBidder": false,    "groups": [101664],    "isLive": true,    "rate": 25  },  {    "instanceId": 1845809,    "instanceName": "기본값",    "adUnit": "rewardedVideo",    "adFormat": "rewarded",    "networkName": "adManager",    "appConfig1": "bqw",    "instanceConfig1": "qqr",    "isBidder": false,    "groups": [101663 ],    "isLive": true,    "rate": 4  }]

생성

• 'status' 파라미터 세트 없이 생성된 인스턴스는 자동으로 'active'로 설정됩니다.
• 스토어에 라이브 상태가 아닌 앱 대해 생성된 인스턴스는 자동으로 ‘비활성화’로 설정됩니다.
• 동일한 광고 네트워크가 있는 인스턴스의 경우 애플리케이션 설정 값이 동일해야 합니다.
• 커스텀 네트워크 인스턴스 생성에는 'networkKey' 파라미터 필요합니다. 네트워크 기술 자료에서 확인할 수 있습니다.

메서드

요청 파라미터

요청 예시 URL

지원 파라미터

요청 예시

[  {      "instanceName": "newInstance",            "networkName": "unityAds",      "adUnit": "rewardedVideo",      "isBidder": true,      "appConfig1": "414n",      "instanceConfig1": "aaa1",      "instanceConfig2": "aaa1",      "groups": [12345],      "isLive": true  },  {      "instanceName": "newInstance_2",            "networkName": "unityAds",      "adFormat": "rewarded",      "isBidder": false,      "appConfig1": "414n",      "instanceConfig1": "bbb1",      "groups": [12345],      "isLive": true,      "rate": 5  }]

업데이트

메서드

요청 파라미터

요청 예시 URL

지원 파라미터

요청 예시

[  {      "instanceId": 122,      "instanceName": "newInstance",      "appConfig1": "414n",      "instanceConfig1": "aaa1",      "instanceConfig2": "aaa1",      "groups": [1],      "isLive": true,      "rate": 2  }]

삭제

• 기본 인스턴스는 삭제할 수 없습니다.
• 삭제된 인스턴스는 복원할 수 없습니다.

메서드

요청된 파라미터

요청 예시 URL

지원 파라미터

요청 바디 예시

{    "ids": [1458, 5769]}

Success

오류

예시

{    "errorsArray": [        {            "code": ERR-402,            "errorMessage": "인스턴스 이름은 동일한 광고 형식과 네트워크에 대해 고유해야 합니다."            "params": {                "instanceName": "abc"            }        }    ],    "code": 400}

API v3(이전 버전)

인스턴스 가져오기

설명

인증 유형

메서드

필수 파라미터

요청 예시 URL

응답 파라미터

JSON 예제 응답

{  "appKey": "aa2209b1d",  "appName": "내 테스트 앱",  "appStatus": "active",  "platform": "Android",  "bundleId": "com.test.app",  "creationDate": "N/A",  "adUnits": {    "rewardedVideo": {      "activeNetworks": [        "ironSource",        "AdColony"      ],      "activeBidderNetworks": [        ""      ],      "networkInstances": {        "ironSource": [          {            "id": 0,            "name": "기본값",            "status": "active",            "pricing": [              {                "eCPM": "10.5",                "Countries": [                  "FR",                  "UK"                ]              }            ],            "abVersion": "N/A"          }        ],        "AdColony": [          {            "id": 0,            "zoneId": "zone_ID_US_High",            "name": "US_high",            "status": "active",            "rate": 87,            "abVersion": "N/A"          },          {            "id": 2851429,            "zoneId": "zone_ID_US_Low",            "name": "US_Low",            "status": "active",            "rate": 12,            "abVersion": "N/A"          }        ]      },      "networkBidderInstances": []    },    "offerWall": {      "activeNetworks": [        "ironSource"      ]    },    "interstitial": {      "activeNetworks": [],      "activeBidderNetworks": [],      "networkInstances": {        "ironSource": [          {            "id": 0,            "name": "기본값",            "status": "inactive",            "pricing": [              {                "eCPM": "8.5",                "Countries": [                  "FR",                  "UK"                ]              }            ],            "abVersion": "N/A"          }        ]      },      "networkBidderInstances": []    },    "banner": {      "activeNetworks": [],      "networkInstances": {        "ironSource": [          {            "id": 0,            "name": "기본값",            "status": "inactive",            "abVersion": "N/A"          }        ]      }    }  }}

인스턴스 생성

• 'status' 파라미터 세트 없이 생성된 인스턴스는 자동으로 'active'로 설정됩니다.
• 스토어에 라이브 상태가 아닌 앱 대해 생성된 인스턴스는 자동으로 '비활성화'로 설정됩니다.
• Mediation 사용자용 - 새로 생성된 각 인스턴스는 앱의 모든 Mediation 그룹에 포함됩니다.
• 각 앱은 광고 유닛당 최대 10개의 인스턴스로 제한됩니다. 이 제한을 확장하려면 지원 팀에 문의하거나 세일즈 담당자에게 문의하십시오.
• 입찰자 네트워크를 구축하려면 지원 팀에 문의하거나 세일즈 담당자에게 문의하십시오.

CPM 가격

1. CPM 가격 책정을 사용하면 레벨플레이 네트워크에서 예상되는 CPM 속도를 제어하고 유연하게 정의할 수 있습니다. 더 읽어보기 여기.
2. CPM 가격은 특정 계정에서만 사용할 수 있습니다. CPM 가격을 활성화하려면 지원 팀에 문의하거나 세일즈 담당자에게 문의하십시오.
3. 가격이 책정된 인스턴스를 사용하는 베스트 프랙티스는 베스트 프랙티스 문서를 참조하십시오.

1. 인스턴스에 대한 전역 가격을 설정하려면 인스턴스의 국가 필드에 별표 캐릭터 ‘*’를 입력합니다.
2. 가격 책정 없이 생성된 인스턴스와 가격 책정이 정의되지 않은 국가는 최적화된 가격 책정을 사용하도록 설정됩니다.
3. 국가는 ISO 3166-1 알파-2에 따라 국가 코드 2자로 정의됩니다.

인증 유형

메서드

필수 파라미터

선택적 파라미터

요청 예제 URL

https://platform.ironsrc.com/partners/publisher/instances/v3

요청 예시 바디

{  "appKey": "d11a21a5",  "configurations": {    "ironSource": {      "interstitial": [        {          "instanceName": "low_interstitial",          "status": "active",          "pricing": [            {              "country": [                "FR",                "DE"              ],              "eCPM": 3            }          ],          "pricingType": "eCPM"        },        {          "instanceName": "high_interstitial",          "status": "active",          "pricing": [            {              "country": [                "IL",                "US"              ],              "eCPM": 20개            }          ]        }      ]    },    "adColony": {      "rewardedVideo": [        {          "instanceName": "adcolony_rv",          "status": "active",          "zoneId": 102030,          "rate": 10        }      ]    }  }}

JSON 예제 응답

{  "rewardedVideo": {    "AdColony": [      {        "id": 6701121,        "zoneId": "102030",        "name": "adcolony_rv",        "status": "active",        "rate": 10,        "abVersion": "N/A"      }    ]  },  "interstitial": {    "ironSource": [      {        "id": 0,        "name": "기본값",        "status": "active",        "abVersion": "N/A"      },      {        "id": 6701117,        "name": "low_interstitial",        "status": "active",        "abVersion": "N/A",        "pricing": [          {            "eCPM": 3,            "Countries": [              "FR",              "DE"            ]          }        ]      },      {        "id": 6701119,        "name": "high_interstitial",        "status": "active",        "abVersion": "N/A",        "pricing": [          {            "eCPM": 20,            "Countries": [              "IL",              "US"            ]          }        ]      }    ],    "ironSourceBidding": [      {        "id": 2948695,        "name": "",        "status": "inactive",        "abVersion": "N/A"      }    ]  }}

인스턴스 업데이트

• 최대 업데이트 콜 수는 일별로 6개로 제한됩니다.
• 기본 인스턴스가 아닌 인스턴스를 활성화 먼저 기본 인스턴스인스턴스 ID=0)를 활성화 합니다.
• 인스턴스 가격 책정을 업데이트하면 동일한 인스턴스 대한 모든 가격 책정 값이 대체됩니다.
• 입찰자 네트워크를 업데이트하려면 지원 팀에 문의하거나 세일즈 담당자에게 도달률을 지정하십시오.
• 인스턴스 레벨 속도를 제거하려면 비어 있는 문자열 값(예: "")을 사용하여 속도 파라미터 추가합니다.

인증 유형

메서드

필수 파라미터

선택적 파라미터

요청 예제 URL

요청 바디 예시

{  "appKey": "6bc83099",  "configurations": {    "ironSourceBidding": {      "rewardedVideo": [        {          "instanceId": 327,          "status": "inactive"        }      ]    }  }}

JSON 응답 예시

{  "rewardedVideo": {    "ironSource": [      {        "id": 0,        "name": "기본값",        "status": "inactive",        "abVersion": "N/A"      }    ],    "AdColony": [      {        "id": 0,        "name": "default",        "status": "active",        "abVersion": "N/A"      },      {        "id": 326,        "name": "lw",        "status": "inactive",        "rate":"2",        "abVersion": "N/A"      }    ],    "ironSourceBidding": [      {        "id": 327,        "name": "-",        "status": "inactive",        "abVersion": "N/A"      }    ]  },  "interstitial": {    "ironSource": [      {        "id": 0,        "name": "기본값",        "status": "active",        "abVersion": "N/A"      }    ]  },  "banner": {    "ironSource": [      {        "id": 0,        "name": "기본값",        "status": "inactive",        "abVersion": "N/A"      }    ]  }}

인스턴스 삭제

설명

1. 호출 하나의 인스턴스 삭제할 수 있습니다.
2. 기본 인스턴스 삭제할 수 없습니다.
3. 삭제된 인스턴스 복원할 수 없습니다.
4. 응답에는 삭제된 인스턴스를 제외한 앱의 모든 인스턴스가 포함됩니다.

인증 유형

메서드

필수 파라미터

요청 예제 URL

JSON 응답 예시

{  "rewardedVideo": {    "ironSource": [      {        "id": 0,        "name": "기본값",        "status": "active"      },      {        "id": 45678,        "name": "thirdRVInstance",        "status": "inactive"      }    ]  },  "interstitial": {    "ironSource": [      {        "id": 0,        "name": "기본값",        "status": "active"      },      {        "id": 23456,        "name": "secondISInstance",        "status": "active",        "pricing": [          {            "eCPM": "0.01",            "Countries": [              "FR",              "UK"            ]          }        ]      }    ]  },  "banner": {    "ironSource": [      {        "id": 0,        "name": "기본값",        "status": "inactive"      }    ]  }}