로그인

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

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

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

Criteo API로 보고서 정보를 호출하려면 어떻게 해야 합니까?

To call a report using the Criteo API you can do so using the following queries: 
  1. clientLogin
  2. scheduleReportJob
  3. getJobStatus
  4. getReportDownloadUrl

 

API 호출과 응답 목록

 
1. clientLogin
Returns an authToken, to be used in all subsequent calls.

Parameters:
필드 유형 설명
사용자명 xsd:string 광고주의 사용자 이름
암호 xsd:string 광고주의 암호
소스 xsd:string 애플리케이션을 나타내는 짧은 문자열로, 로깅에 사용됩니다. 이 문자열의 형식은 "companyName-applicationName-versionID"여야 합니다.

Response:
필드 유형 설명
clientLoginResult xsd:string clientLoginResult는 다른 모든 호출에 사용되는 인증 토큰(authToken)으로, 48시간 동안 유효합니다.
 
2. getAccount
Returns basic account information

Parameters:
N/A

Response:
필드 유형 설명
광고주 name xsd:string 이 계정의 이름
email xsd:string 광고주를 위한 주 담당자 이메일
통화 xsd:string 이 계정의 통화. 열거
Time zone xsd:string 이 계정의 시간대. 열거
국가 xsd:string 이 계정의 국가. 열거
 
3. getBudgets
Returns the list of budgets that meets the selector criteria.

Parameters:
필드 유형 설명
budgetSelector BudgetIDs[] 조회할 예산 ID의 목록입니다. 비어 있으면 모든 예산을 조회합니다.

Response:
필드 유형 설명
getBudgetsResult Budget[] 예산 오브젝트의 목록입니다.
 
4. getCampaigns
Returns the list of campaigns that meets the selector criteria.

Parameters:
필드 유형 설명
campaignSelector CampaignSelector BudgetID, CampaignID, CampaignStatus 및 BiddingStrategy를 사용하여 캠페인을 조회할 수 있습니다.

Response:
필드 유형 설명
getCampaignsResult Campaign[] 캠페인 오브젝트의 목록
 
5. getCategories
Returns the list of categories that meets the selector criteria.

Parameters:
필드 유형 설명
categorySelector CategorySelector CategoryID 및 Selected를 사용하여 범주를 조회할 수 있습니다.

Response:
필드 유형 설명
getCategoriesResult Category[] 범주 오브젝트의 목록
 
6. mutateCategories
Updates categories.

Parameters:
필드 유형 설명
mutateCategories CategoryMutates[] 돌연변이 작업 목록입니다. SET 작업만 지원됩니다.

Response:
필드 유형 설명
jobResponse categoryMutateJobResponse[] categoryJobResponseObjects 목록입니다. 작업마다 자체 jobID가 있으며, getJobStatus로 확인할 수 있습니다.
 
7. mutateCampaigns
Updates campaigns.

Parameters:
필드 유형 설명
mutateCampaigns CampaignMutates[] 돌연변이 작업 목록입니다. SET 작업만 지원됩니다.


Response:
필드 유형 설명
jobResponse campaignMutateJobResponse[] campaignJobResponseObjects의 목록입니다. 작업마다 자체 jobID가 있으며, getJobStatus로 확인할 수 있습니다.


8. scheduleReportJob
Schedules a report job for execution.

Parameters:
필드 유형 설명
reportJob ReportJob 요청된 보고서에 대해 설명하는 reportJob 오브젝트를 전달합니다.

Response:
필드 유형 설명
jobID xsd:int 요청된 작업의 ID입니다. getJobStatus 및 getReportDownloadURL에 사용할 수 있습니다.
jobStatus xsd:string 요청의 상태입니다. reportJob이 수락된 경우 ‘Pending’을 반환합니다.
reportJob ReportJob 최초의 reportJob 요청입니다.


9. getJobStatus
Retrives a job status based on its ID.

Parameters:
필드 유형 설명
jobID xsd:int 상태를 조회한 작업의 jobID입니다.

Response:
필드 유형 설명
getJobStatusResult xsd:String 요청된 작업의 상태입니다. 열거


10. getReportDownloadUrl
Returns a URL from which the report with the given job ID can be downloaded. After invoking this method, the caller can do a regular HTTP GET on the returned URL to retrieve the report. The reports are in XML format.

Parameters:
필드 유형 설명
jobID xsd:int 다운로드 URL을 조회한 jobID입니다.

Response:
필드 유형 설명
jobURL xsd:String 보고서를 다운로드할 수 있는 정식 URL입니다.


11. getStatisticsLastUpdate
Returns a list of StatUpdate objects to indicate the “books closed” for the related Type of statistics (ClicksAndImpressions, Sales for now).

Parameters:
None.

Response:
필드 유형 설명
getStatisticsLastUpdateResult StatUpdate[] StatUpdateObjects의 목록입니다. StatUpdate에는 유형과 날짜가 들어 있습니다.

 

오브젝트 설명

 
Type Campaign
필드 유형 설명
campaignID xsd:int 캠페인의 ID
campaignName xsd:string 캠페인의 이름
campaignBid BidInformation 캠페인의 BidInformation
budgetID xsd:decimal 캠페인에 사용되는 예산의 ID입니다.
remainingDays xsd:int 기존 예산으로 이 캠페인을 진행할 수 있는 기간(일)입니다. 이 값은 현재의 지출 경향을 토대로 추정합니다.
상태 xsd:string 캠페인 상태:
  • RUNNING: 캠페인이 현재 활성 상태
  • NOT_RUNNING: 캠피인이 비활성 상태
  • DEAD: 캠페인이 아카이브된 읽기 전용 상태
categoryBids CategoryBid[] 범주에 연결된 BidInformation의 목록입니다.


Type Category
필드 유형 설명
categoryID xsd:int 범주의 ID
categoryName xsd:string 카테고리명(카탈로그 feed에서 조회)입니다.
avgPrice xsd:double 이 범주에 속하는 제품의 평균 가격입니다.
numberOfProducts xsd:int 이 범주의 태그가 부착된 제품 수입니다.
selected xsd:boolean 해당 범주가 선택된 범주인 경우 참입니다(선택된 범주는 입찰 및 보고에 사용 가능).


Type Budget
필드 유형 설명
budgetID xsd:int 예산의 ID입니다.
budgetName xsd:string 예산의 이름입니다.
totalAmount xsd:int 이 예산에 추가된 총액입니다.
remainingBudget xsd:decimal 사용 가능한 금액입니다.
remainingBudgetUpdated xsd:dateTime remainingBudget을 계산한 시간입니다.


Type BidInformation
필드 유형 설명
biddingStrategy xsd:string 입찰 전략:
  • CPC: 클릭당 비용
  • CPA: 작업당 비용
  • CPM: 천 단위당 비용
참고: CPC만 지원됩니다.
cpcBid xsd:double 클릭당 비용의 가치입니다.
cpaBid CPABid CPABid에는 postClick, postView, commission 및 percent가 포함됩니다. (아직 지원되지는 않습니다.)


Type CategoryBid
필드 유형 설명
campaignCategoryUID xsd:int 특정 캠페인의 범주를 나타내는 글로벌 UID입니다.
campaignID xsd:int 이 카테고리의 입찰을 수행한 캠페인의 ID입니다.
categoryID xsd:int 이 입찰을 수행한 카테고리의 ID입니다.
selected xsd:boolean 해당 범주가 선택된 범주인 경우 참입니다(선택된 범주는 입찰 및 보고에 사용 가능).
bidInformation BidInformation 범주 입찰의 BidInformation입니다.


Type ReportJob
필드 유형 설명
reportSelector CategoryIDs
CampaignIDs
보고서에서 데이터를 조회해야 하는 범주 또는 캠페인 ID의 목록입니다.
reportType xsd:string 실행할 보고서 유형:
  • 캠페인
  • 카테고리
aggregationType xsd:string 보고서의 집계 유형:
  • 시간별
  • 일별
startDate xsd:string 보고서의 startDate(YYYY-MM-DD)입니다.
endDate xsd:string 보고서의 endDate입니다(YYYY-MM-DD).
selectedColumns ReportColumn[] 보고서에서 요청된 열 목록:
  • clicks
  • impressions
  • ctr
  • revcpc
  • ecpm
  • cost
  • sales
  • convRate
  • orderValue
  • salesPostView
  • convRatePostView
  • orderValuePostView
  • costOfSale
  • overallCompetitionWin
  • costPerOrder
isResultGzipped xsd:boolean 참이면 보고서를 압축해야 합니다.

 

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