방법: POST /api/v1/advertiser/campaign
설명: 힐탑애즈 광고 계정에 대한 API를 통해 광고 캠페인을 만들 수 있습니다.
이 방법은 팝언더 모바일 및 데스크톱 형식에서만 사용 가능함을 참고하십시오.
매개변수:
이름 | 설명 | 예제 | 댓글 |
key | 힐탑애즈 계정의 API 섹션에서 생성할 수 있는 고유 API 키입니다. | nXzgO3Bc | 요청의 필수 매개 변수입니다. |
format | 캠페인을 생성해야 하는 광고 형식입니다. | 팝언더 모바일 | 광고 형식은 하나만 지정할 수 있습니다. 요청의 필수 매개 변수입니다. |
rate | 1000회 노출에 대한 가격(CPM). | 1.53 | 모든 가격(환율)은 요청에 통화 없이 지정되지만 결과에는 USD로 설정됩니다. 요청의 필수 매개 변수입니다. |
capTotal | 노출 빈도 상한. 이 매개변수는 광고가 게재되는 횟수를 나타냅니다. | 2 | 번호는 하나만 지정할 수 있습니다. |
capResetAfter | 노출 빈도 상한. 이 매개변수는 광고를 표시할 기간을 나타냅니다. | 12 | 번호는 하나만 지정할 수 있습니다. |
capForCampaign | 노출 빈도 상한. 이 매개변수는 규칙이 캠페인에 적용되는지 배너에 적용되는지를 나타냅니다. | 캠페인 | 팝언더 형식의 경우 캠페인만 지정할 수 있습니다. |
channels | 광고를 게재해야 하는 세그먼트 및 트래픽 카테고리입니다. | 주류/비주류 높은 활동성 주류/비주류 중간 활동 주류/비주류 낮은 활동성 | 여러 활동 세그먼트를 지정하려면 쉼표로 구분하여 나열합니다. 트래픽 카테고리는 주류 또는 비주류 중 하나만 지정할 수 있습니다. 요청의 필수 매개 변수입니다. |
type | 광고 캠페인 유형 | CPM, CPC | 현재 CPM 캠페인 유형만 지정할 수 있습니다. 요청의 필수 매개 변수입니다. |
name | 광고 캠페인의 이름입니다. | Popunder_API | 캠페인 이름은 고유해야 하며 이미 생성된 캠페인의 이름과 반복되지 않아야 합니다. 요청의 필수 매개 변수입니다. |
URL | 트래픽을 전송해야 하는 URL 링크를 제공합니다. | 링크는 하나만 지정할 수 있습니다. 요청의 필수 매개 변수입니다. | |
active | 생성된 캠페인의 상태를 참 - 켜짐, 거짓 - 꺼짐으로 지정합니다. | 참, 거짓 | 캠페인 상태를 참(켜짐)으로 지정하면 캠페인은 검토를 거친 후에만 활성화됩니다. |
limitImpressionsTotal | 지정한 총 노출 한계 | 200000 | 지정할 수 있습니다만 하나의 번호입니다. |
limitImpressionsDaily | 지정 매일 노출 한계 | 20000 | 지정할 수 있습니다만 하나의 번호입니다. Min. 매일 노출 한계 15,000. |
limitBudgetTotal | 지정한 총 예산 한도 | 2000 | 지정할 수 있습니다만 하나의 번호입니다. |
limitBudgetDaily | 지정 매일 예산 한도 | 50 | 지정할 수 있습니다만 하나의 번호입니다. Min. 매일 예산 한도는$20. |
filters | 할 수 있도록 허용할 수 있습 허용하거나 허용하지 않을 프록시하고 WebView 교통합니다. | 프록시 WebView | 이 매개 변수로 전달된 개체입니다. |
targeting | 데 필요한 타겟팅 설정을 위한 광고 캠페인입니다.
| geo 브라우저 os device mobilecarrier iprange osversions 앱 | 이러한 매개변수로 전달된 개체입니다. 각각의 새로운 타겟팅을 매개 변수를 지정은 쉼표로 구분됩니다. |
uniformDistributionDaily | 선택하는 어떻게 캠페인이 한계에 도달합니다. | ASAP Evenly | ASAP 에 도달 지정된 캠페인 제한으로 가능한 빠르게 |
limitImpressionsTotal | 지정한 총 노출 한계 | 200000 | 지정할 수 있습니다만 하나의 번호입니다. |
타겟팅체
이름 | 예 | 설명 |
geo | 미국 GB AU | 입력하 두 개의 문자 코드의 필요 국가/국가,쉼표로 구분됩니다. |
브라우저 | 크롬 FireFox 사파리 |
|
os | 안드로이드 iOS |
|
device | 모바일/스마트폰 태블릿 |
|
mobilecarrier | AU~vodafone |
|
iprange | 127.0.0.1 |
|
osversions | iOS15 Win7 |
사용 가능한 모든 버전
|
앱 |
|
타겟팅체
이름 | 예 |
프록시 | 용 허용하지 않는 만 |
WebView | 용 허용하지 않는 만 |
요청 예시:
다음 매개변수를 사용하여 광고 캠페인을 만들려면 다음과 같이 하세요:
광고 형식 - Popunder 모바일
요금 - $1.53
빈도 제한 - 캠페인의 경우 12시간당 2개 표시
채널 - 주류 높은 활동성 и 중간 활동성
유형 - CPM(팝언더 광고 형식의 경우 CPM만 지정할 수 있음)
이름 - Popunder_API
URL - https://mywebsite.com.
활성 - True
타겟팅 - GEO: 미국, 영국, 독일; 브라우저: Chrome, Safary; 기기 - 모바일
링크에 '&' 기호가 포함된 경우 URL 인코딩 형식으로 인코딩해야 한다는 점에 유의하세요. 그렇지 않으면 링크 변경 요청에 대한 응답에서 오류가 발생할 수 있습니다.
예를 들어, 링크
https://mywebsite.com/?token={{CTOKEN}}&zone={{ZONE_ID}}를 다음과 같이 지정해야 합니다.
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
링크를 URL 인코딩 형식으로 인코딩하려면 도구를 사용하면 됩니다.
다음 형식으로 요청을 작성해야 합니다:
curl -X POST --data '{"format":"팝언더 모바일","channels":["메인스트림 높은 활동","메인스트림 중간 활동"],"type":"CPM","rate":1.53,"name":"팝언더_API","url":"https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D","active":true,"capTotal":2,"capResetAfter":12,"capForCampaign":"캠페인","targeting":{"geo":{"operator":"in","operand":["미국","영국","독일"]},"브라우저":{"연산자":{"연산자":["크롬","사파리"]},"디바이스":{"연산자":["모바일/스마트폰"]}}}' https://api.hilltopads.com/v1/advertiser/campaign?key=nXzgO3BcHilltopAds 광고 네트워크 API의 모든 잠재력을 활용하세요!