로그인

저희 지원센터에 오신 것을 환영합니다

광고 진행을 위한 작업과 라이브를 위해 도움을 드리겠습니다.

저희 지원센터에 오신 것을 환영합니다. 광고 진행을 위한 작업과 라이브를 위해 도움을 드리겠습니다.

마케팅 API 세부정보

크리테오 API를사용하려면 url: https://api.criteo.com/marketing를 방문하십시오.

엔드포인트

인증

유형

엔드포인트

목적

파라미터

참고

POST

/oauth2/token

API로 요청을 보낼 수 있도록 해주는 토큰 회수

  • client_id (필수)
  • client_secret (필수)
  • grant_type (필수)

토큰은 300s에 유효합니다.

 

광고 관리

유형

엔드포인트

목적

파라미터

GET

/portfolio

advertiser_Id(s) 회수

없음

GET

/advertiser/{advertiser_Id}/campaigns

특정 광고주의 캠페인 및 카테고리 조회

advertiser_Id (mandatory): string

GET

/advertiser/{advertiser_Id}/categories

특정 광고주의 캠페인 및 카테고리 조회

카테고리 상태별 필터

advertiser_Id (mandatory): int

enabledOnly: bool

GET

/advertiser/{advertiser_Id}/categories/{categoryHashCode}

특정 광고주의 특정 카테고리 조회

advertiser_Id (필수)

categoryHashCode (필수)

 


캠페인 관리

유형

엔드포인트

목적

파라미터

GET

/campaigns/

포트폴리오의 캠페인 조회

advertiser_Ids: string

campaignIds: string

campaignstatus: string

bidtype: string

GET

/campaigns/{campagnId}

특정 캠페인에서 캠페인과 카테고리 조회

campaignId (필수): int

GET

/campaigns/{campaignId}/categories

특정 캠페인에서 캠페인과 카테고리 조회

카테고리 상태별 필터

campaignId (필수): int

enabledOnly: string

GET

/campaigns/{campaignId}/categories/{categoryHashCode}

포트폴리오의 특정 캠페인 카테고리 조회

campaignId (필수): int

categoryHashCodes (mandatory): int

GET

/campaigns/bids

포트폴리오의 입찰 조회

advertiser_Ids: string

campaignIds: string

categoryHashCodes:string

bidType: string

campaignStatus: string

pendingChanges: bool

PUT

/campaigns/bids

캠페인 또는 캠페인 카테고리에 새로운 입찰값 설정

bidChanges (mandatoy): string

 

캠페인 리포팅

유형

엔드포인트

목적

파라미터

참고

POST

/statistics

광고 퍼포먼스 리포트 조회

statsQuery (mandatoy)

이 엔드포인트에 대한 세부 정보는 해당 문서 섹션을 참조하십시오.

 

예산 관리

유형

엔드포인트

목적

파라미터

GET

/budgets

포트폴리오의 예산 조회

advertiser_Ids: string

budgetIds: string

onlyActiveCampaigns:bool

 

카테고리 관리

유형

엔드포인트

목적

파라미터

GET

/categories

포트폴리오의 카테고리 조회

campaign_Ids: : string

advertiser_Ids: string

categoryHashCodes: string

enabledOnly: bool

PUT

/categories

카테고리 활성화 또는 비활성화

categoriesPerCatalog (필수)

 

Audience management

유형

엔드포인트

목적

파라미터

참고

GET

/audiences

오디언스 목록 요청

advertiser_Id : int

광고주 id를 지정하지 않으면, 사용자의 포트폴리오가 보여집니다.

POST

 /audiences/userlist/ 

오디언스 생성

advertiser_Id : int

name: string

description:string

오디언스 id는 다음 id 입니다. (오디언스가 생성될 때마다 증가)

PUT

/audiences/{audienceId} 

오디언스 메타데이터 변경

name: string

description: string

 

PATCH

/audiences/userlist/{audienceId}

오디언스에 사용자 추가/삭제

operation: string (ADD  or REMOVE) 

schema: string (email 또는 madid)

identifiers: list of string

요청 당 50,000개 ID로 제한됨.

식별자

E-mail: 평문, MD5 또는 MD5의 SHA256

MADID: IDFA 또는 AAID

참고: API는 DMP의 쿠키 ID를 허용하지 않습니다.

DELETE 

/audiences/userlist/{audienceId}/users

오디언스에서 모든 사용자 삭제

   

DELETE 

/audiences/{audienceId}

오디언스 삭제

   

 

파라미터

파라미터

용도

세부 내용

client_id

토큰 회수

e-mail (크리테오 매니지먼트 센터 로그인 정보와 동일)

client_secret

토큰 회수

비밀번호 (크리테오 매니지먼트 센터 로그인 정보와 동일)

grant_type

토큰 회수

항상 "client_credentials"와 동일함

advertiser_Id

특정 광고주 데이터 조회

포트폴리오 엔드포인트로부터 회수

/advertisers 엔드포인트로부터 조회됨

/audience 엔드포인트로부터 조회됨

 /audience/userlist/ 으로부터 조회됨

advertiser_Ids

특정 광고주 데이터 조회

/budget 엔드포인트로부터 조회됨

/campaigns 엔드포인트로부터 조회됨

/campaigns/bids 엔드포인트로부터 조회됨

/categories 엔드포인트로부터 조회됨

/statistics 엔드포인트로부터 조회됨

쉼표로 구분하여 다수의 advertiser_Id를 요청할 수 있습니다. 예: 1,2,3

enabledOnly

카테고리의 필터 목록

/categories 엔드포인트로부터 조회됨

/advertiser/{advertiser_id}/categories endpoint로부터 조회됨

/campaigns/{campaignid}/categories 엔드포인트로부터 조회됨

활성화

카테고리 상태 업데이트

/categories 엔드포인트로부터 조회됨

categoryHashCode

특정 카테고리 데이터 조회

특정 카테고리 상테 업데이트

/advertiser/{advertiser_id}/categories/{categoriesHashCode} endpoint로부터 조회됨

categoryHashCodes

특정 카테고리 데이터 조회

특정 캠페인 카테고리 입찰값 업데이트

/categories 엔드포인트로부터 조회됨

/campaigns/bids 엔드포인트로부터 조회됨

/campaigns/{campaignid}//categories/{categoriesHashCode} 엔드포인트로부터 조회됨

다수의 쉼표로 구분을 하여 다수의 categoryhashcode를 요청할 수 있습니다. 예: 1,2,3

budgetIds

특정 예산 데이터 조회

/budgets 엔드포인트로부터 조회

onlyactiveCampaigns

상태별로 캠페인 필터링

/budgets 엔드포인트로부터 조회

campaignID

특정 캠페인 데이터 조회

특정 캠페인 입찰값 업데이트

/campaigns/{campaignid} 엔드포인트로부터 조회됨

/campaigns/{campaignid}/categories 엔드포인트로부터 조회됨

/campaigns/{campaignid}/categories/{categoriesHashCode} 엔드포인트로부터 조회됨

/campaigns/bids 엔드포인트로부터 조회됨

campaignIds

특정 캠페인 데이터 조회

/campaigns 엔드포인트로부터 조회됨

/campaigns/bids 엔드포인트로부터 조회됨

/categories 엔드포인트로부터 조회됨

쉼표로 구분을 하여 다수의 campaignid를 요청할 수 있습니다. 예: 1,2,3

bidType

입찰 유형별로 필터링

/campaigns 엔드포인트로부터 조회됨

/campaigns/bids 엔드포인트로부터 조회됨

bidValue

특정 캠페인 카테고리 입찰값 업데이트

/campaigns/bids 엔드포인트로부터 조회됨

campaignStatus

캠페인 상태별로 필터링

/campaigns 엔드포인트로부터 조회됨

/campaigns/bids 엔드포인트로부터 조회됨

pendingChanges

대기 중 또는 완료된 변경사항으로 캠페인 필터링

/campaigns/bids 엔드포인트로부터 조회됨

catalogId

카테고리 상태 업데이트

/categories 엔드포인트로부터 조회됨

audienceId

특정 오디언스 업데이트

/audiences/ 로부터 조회됨

상품명

오디언스 이름 업데이트

 /audiences/userlist/ 엔드포인트로부터 조회됨

 /audiences/{audience_id} 엔드포인트로부터 조회됨

상품 상세 설명

오디언스 설명 업데이트

 /audiences/userlist/ 엔드포인트로부터 조회됨

 /audiences/{audience_id} 엔드포인트로부터 조회됨

연산(operation)

오디언스에 대한 조치

/audiences/userlist/{audience_id} 엔드포인트로부터 조회됨

값은 다음과 같아야 함: 추가/삭제

스키마(schema)

오디언스 데이터 유형

 /audiences/userlist/{audience_id} 엔드포인트로부터 조회됨

식별자(identifiers)

사용자 ID 목록

 /audiences/{audience_id} 엔드포인트로부터 조회됨

reportType

통계 보고서 내보내기

/statistics로부터 조회됨

값은 캠페인 퍼포먼스 / Facebook DPA Report / Transaction ID Report로부터 조회되어야 함

ignoreXDevice

통계 보고서 내보내기

/statistics로부터 조회됨

startDate

통계 보고서 내보내기

/statistics로부터 조회됨

endDate

통계 보고서 내보내기

/statistics로부터 조회됨

dimensions

통계 보고서 내보내기

/statistics로부터 조회됨

최대 3개 치수

metrics

통계 보고서 내보내기

/statistics로부터 조회됨

측정는 MC UI에서 선택되어야 함

format

통계 보고서 내보내기

/statistics로부터 조회됨

값은 XML, JSON, CSV, EXCEL, HTML 포맷이어야 함

통화

통계 보고서 내보내기

/statistics로부터 조회됨

값은 ISO 통화 코드이어야 함

Time zone

통계 보고서 내보내기

/statistics로부터 조회됨

GMT / PST / JST 값이어야 함

응답 코드

응답 코드

사유

200

성공

400

잘못된 요청, 무효 구문

401

인증 실패

403

접근 금지

429

요청 한도 도달, 클라이언트별 분당 200개 이하

500

알 수 없는 오류

도움이 되었습니까?
0명 중 0명이 도움이 되었다고 했습니다.
Zendesk 제공