메인 콘텐츠로 건너뛰기

광고 캠페인 만들기

광고 캠페인을 생성할 수 있는 API 방법에 대한 모든 것.

HilltopAds avatar
작성자: HilltopAds
이번 주에 업데이트함

API를 사용하여 광고 캠페인을 생성하는 방법은?

방법: 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 에 도달 지정된 캠페인 제한으로 가능한 빠르게
​Evenly 점차적으로 도달에 지정된 제한을 통해 일/을 통해 전체 기간

limitImpressionsTotal

지정한 총 노출 한계

200000

지정할 수 있습니다만 하나의 번호입니다.


타겟팅체

이름

설명

geo

미국

GB

AU

입력하 두 개의 문자 코드의 필요 국가/국가,쉼표로 구분됩니다.

브라우저

크롬

FireFox

사파리

os

안드로이드

iOS

device

모바일/스마트폰

태블릿

mobilecarrier

AU~vodafone

iprange

127.0.0.1

osversions

iOS15

Win7

사용 가능한 모든 버전

Facebook

타겟팅체

이름

프록시

허용하지 않는

WebView

허용하지 않는

요청 예시:

다음 매개변수를 사용하여 광고 캠페인을 만들려면 다음과 같이 하세요:

  • 광고 형식 - Popunder 모바일

  • 요금 - $1.53

  • 빈도 제한 - 캠페인의 경우 12시간당 2개 표시

  • 채널 - 주류 높은 활동성 и 중간 활동성

  • 유형 - CPM(팝언더 광고 형식의 경우 CPM만 지정할 수 있음)

  • 이름 - Popunder_API

  • 활성 - 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=nXzgO3Bc

HilltopAds 광고 네트워크 API의 모든 잠재력을 활용하세요!

답변이 도움되었나요?