메인 콘텐츠로 건너뛰기
모든 콜렉션아피
광고 캠페인 업데이트
광고 캠페인 업데이트

API를 사용하여 광고 캠페인을 업데이트하는 방법은 무엇인가요?

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

방법: PUT /api/v1/advertiser/campaign/{id}

설명: 생성한 광고 캠페인은 힐탑애즈 계정에 대한 API를 통해 업데이트할 수 있습니다.

이 방법은 팝펀더 모바일팝펀더 데스크톱 형식에서만 사용할 수 있습니다.

매개변수:

이름

설명

예제

댓글

key

힐탑애즈 계정의 API 섹션에서 생성할 수 있는 고유 API 키입니다.

nXzgO3Bc

요청의 필수 매개 변수입니다.

campaignID

업데이트할 광고 캠페인의 ID

123456

하나의 광고 캠페인의 ID만 지정할 수 있습니다.

요청의 필수 매개 변수입니다.

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

버전

이러한 매개변수는 객체로 전달됩니다. 각각의 새 타겟팅 매개변수는 쉼표로 지정됩니다.


요청 예시:

생성된 광고 캠페인에서 ID 123456으로 다음 매개변수를 업데이트하려면 다음과 같이 하세요:

  • 요금 - $2.53까지

  • 빈도 제한 - 캠페인의 경우 24시간당 1회에 한해 표시 가능

  • URL - https://mywebsit2.com로 이동합니다.

링크에 '&' 기호가 포함된 경우 URL 인코딩 형식으로 인코딩해야 한다는 점에 유의하세요. 그렇지 않으면 링크 변경 요청에 대한 응답에서 오류가 발생할 수 있습니다.

예를 들어, 링크

https://mywebsite.com/?token={{CTOKEN}}&zone={{ZONE_ID}}

를 다음과 같이 지정해야 합니다.

https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D

링크를 URL 인코딩 형식으로 인코딩하려면 도구를 사용하면 됩니다.

다음 형식으로 요청을 작성해야 합니다:

curl -X PUT --data '{"rate":"2.53","capTotal":1,"capResetAfter":24,"capForCampaign":"캠페인","url":"https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D"}' https://hilltopads.com/api/v1/advertiser/campaign/123456?key=nXzgO3Bc

답변이 도움되었나요?