다음은 이벤트 API 및 포스트백 API 에 대한 몇 가지 일반적인 질문과 답변입니다.

이벤트 API는 미디어 최적화 보고서와 어떻게 다릅니까?

이벤트 API는 거래 알림이 10분 이내에 완료될 수 있도록 데이터를 더 빠르게 처리하는 데 최적화된 엔드 투 엔드 시스템을 활용합니다. 미디어 최적화 보고서 는 보고에 데이터를 사용하기 전에 기존의 데이터 흐름 접근 방식을 사용합니다.

어떤 거래에 대해 이벤트 API를 사용할 수 있나요?

저희 네트워크에 보고되는 모든 거래에 이벤트 API를 사용할 수 있습니다. 저희는 광고주들에게 엔터프라이즈 웹 서비스, 픽셀 및 일괄 업로드 방법을 사용하여 거래를 보고할 수 있는 기능을 제공합니다. 때문에 일괄 프로세스를 통해 업로드된 거래를 처리하는 데 걸리는 시간은 API에서 데이터를 사용하는 시간에 영향을 미칩니다.

이벤트 API를 통해 사용할 수 있는 데이터 필드는 무엇입니까?

API는 다음과 같은 거래 데이터 필드를 제공합니다. '+'를 클릭하면 설명 및 참고 사항을 확인할 수 있습니다:

etransaction_id

설명: TID라고도 하는 이 필드는 주문 내 각 거래의 고유 ID입니다.

참고: 영숫자 필드. 소비자가 세 개의 서로 다른 SKU를 포함하는 구매를 한 경우, API는 각 SKU에 대해 하나씩 세 개의 레코드를 반환합니다. 세 레코드 모두 order_id 값을 공유하지만, etransaction_id는 각 레코드마다 고유합니다.

advertiser_id

설명: MID라고도 하는 이 필드는 고유한 광고주 ID입니다.

참고: 숫자 필드.

사이트 ID(SID)

설명: 이 필드는 고유한 퍼블리셔ID입니다.

참고: 숫자 필드.

order_id

설명: 이 필드는 주문에 대한 고유한 광고주 오더 ID를 제공합니다.

참고: 숫자 필드.

offer_id

설명: OID라고도 하는 이 필드에는 거래에 커미셔닝된 오퍼의 오퍼 ID를 제공합니다.

참고: 숫자 필드.

sku_number

설명: 이 필드는 품목의 SKU를 제공합니다.

참고: 영숫자 필드. 광고주가 보고한 경우에만 사용할 수 있습니다.

sale_amount

설명: 이 필드에는 소비자가 주문 과정에서 이 품목에 결제한 금액이 표시됩니다.

참고: 숫자 필드.

quantity

설명: 이 필드는 구매한 항목의 수량이 담깁니다.

참고: 숫자 필드.

commissions

설명: 이 필드에는 거래에 대한 총 기본 커미션이 표시됩니다.

참고: 숫자 필드.

transaction_date

설명: 이 필드는 광고주 사이트에서 주문이 이루어진 날짜와 시간입니다.

참고: 시간 형식 필드.

process_date

설명: 이 필드는 Rakuten Advertising에서 거래를 처리한 날짜와 시간입니다. 표준 시간대는 GMT입니다.

참고: 시간 형식 필드.

transaction_type

설명: 이 필드는 거래가 실시간인지 일괄 처리인지 지정합니다.

참고: 영숫자 필드.

product_name

설명: 이 필드에는 구매 또는 반품된 항목의 제품 이름이 담깁니다.

참고: 영숫자 필드.

u1

설명: 특정 캠페인 또는 회원 값을 참조할 수 있도록 정의하는 필드입니다. &u1=파라미터 를 참조합니다.

참고: 영숫자 필드.

currency

설명: 거래에 대한 판매 금액의 통화입니다.

참고: 영숫자 필드.

is_event

설명: 이 필드는 실시간 거래가 이벤트인지 거래인지를 지정합니다.

참고: Y 또는 N 필드.

이벤트: 이 거래는 광고주가 검토한 후 일괄 업로드를 통해 최종적으로 제거될 수 있는 거래 발생을 나타내는 지표 역할을 합니다. 해당 거래를 사용하여 최종 커미션 지급액을 결정해서는 안 됩니다. 이것이 누락되면 보고 오류가 발생할 수 있습니다.

거래: 이러한 거래는 확정된 거래로, 취소가 발생할 때까지 지급될 거래로 간주할 수 있습니다.

예상 데이터 지연 시간은 얼마입니까?

이벤트 API를 통해 사용할 수 있는 거래의 SLA는 10분입니다.

'is_event' 플래그는 무엇을 의미합니까?

일괄 프로세스를 사용하여 거래를 업로드하는 광고주들은 퍼블리셔에게 라쿠텐 어필리에이트 미디어 최적화 픽셀을 사용하여 거래에 대한 방향 정보를 제공할 수 있습니다. 미디어 최적화 픽셀을 통해 보고된 거래는 결과에서 Y값으로 표시됩니다. 귀하가 받으실 총 커미션을 결정하기 위해서는 이런 류의 거래를 사용하지 마시길 바랍니다. 이 데이터는 미디어 최적화 보고서 를 활성화한 광고주들에게서만 지원된다는 점에 유의해야 합니다.

is_event=<is_event> 파라미터의 목적과 데이터 해석 방법에 대한 자세한 내용은 개발자 포털의 이벤트 API 거래 가이드 를 참조하세요.

얼마나 자주 서비스를 쿼리할 수 있습니까?

서비스 호출 빈도는 가입 과정에서 API 개발자 포털에서 선택한 티어에 따라 결정됩니다.

거래 및 이벤트 발생 시 푸시 알림을 받을 수 있습니까(포스트백)?

예, Postback API를 통해 URL을 등록할 수 있습니다. 이 데이터 및 형식은 풀 API에서 제공되는 것과 동일합니다.

포스트백은 동적 URL을 지원할 수 있 으므로 포스트백의 출력을 사용자 지정할 수 있습니다. 개발자 포털에서 사용 가능한 필드와 포스트백 URL 사용자 지정에 대해 자세히 알아보 세요.

일부 거래가 이벤트 API에서 보고되지 않는 이유는 무엇인가요?

이벤트 API는 엔터프라이즈 웹 서비스 및 배치를 사용하여 라쿠텐 어필리에이트에 보고되는 거래와 이벤트를 모두 보고합니다. 엔터프라이즈 웹 서비스를 통해 보고된 것과 동일한 타임라인 내에서 일괄 업로드 방법을 사용하여 라쿠텐 어필리에이트에 보고된 거래를 볼 수 없습니다.

이벤트 API가 다른 보고서와 다른 데이터를 제공하는 이유는 무엇입니까?

이벤트 API는 엔터프라이즈 웹 서비스 및 일괄 처리를 사용하여 라쿠텐 어필리에이트에 보고되는 거래와 이벤트를 모두 보고합니다. 엔터프라이즈 웹 서비스를 통해 보고된 것과 동일한 타임라인 내에서 일괄 업로드 방법을 사용하여 라쿠텐 어필리에이트에 보고된 거래를 볼 수 없습니다. 또한 빠른 속도를 보장하기 위해 클릭 데이터의 저장 기간은 30일로 제한하고 있습니다. 따라서 30일이 지난 클릭의 결과인 거래의 경우, 이벤트 API에 해당 거래와 관련된 u1 값이 없습니다.

취소는 어떻게 이루어집니까? 이는 이벤트 API에서는 어떻게 표시됩니까?

이벤트 API의 취소 내역 은 다른 보고 도구에서와 비슷하게 표시됩니다. 거래 날짜와 오더 ID는 기존 거래와 동일합니다. 처리 일자는 취소 날짜가 됩니다. 'commissions' 및 'sales_amount'과 같은 일부 값은 음수가 됩니다.