방법: 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 | 생성된 캠페인의 상태를 참 - 켜짐, 거짓 - 꺼짐으로 지정합니다. | 참, 거짓 | 캠페인 상태를 참(켜짐)으로 지정하면 캠페인은 검토를 거친 후에만 활성화됩니다. |
targeting | 광고 캠페인에 필요한 타겟팅 설정입니다.
| geo 브라우저 os 장치 이동통신사 iprange 버전 앱 | 이러한 매개변수는 객체로 전달됩니다. 각각의 새 타겟팅 매개변수는 쉼표로 지정됩니다. |
요청 예시:
다음 매개변수를 사용하여 광고 캠페인을 만들려면 다음과 같이 하세요:
광고 형식 - 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://hilltopads.com/api/v1/advertiser/campaign?key=nXzgO3Bc