광고주 세그먼트 API 안내서

이 안내서에서는 사용자 재참여 캠페인 동안 부정적 대상 선별에 InMobi 세그먼트 API 종단점을 사용하는 방법에 대해 설명합니다.

참고: 이 안내서는 세그먼트 데이터를 InMobi에 직접 제공하려고 하는 광고주를 위한 안내서입니다.

세그먼트 종단점

앱 내에서 활동에 따라 여러 세그먼트로 사용자를 구분하려는 광고주에게 유용합니다. 예를 들어 30일 이상 앱을 열지 않은 사용자에게는 '휴면 사용자' 태그를 붙이고, 구매율이 높은 사용자에게는 '우수 사용자' 태그를 붙일 수 있습니다.

참고: 동일한 사용자에게 두 가지 세그먼트 태그를 붙일 수 있습니다.

이 프로세스에는 세 가지 구성요소가 있습니다. 세그먼트 생성, 세그먼트 삭제, 세그먼트에서 사용자 추가 및 삭제.

세그먼트 생성

세그먼트를 생성하려면 이 API를 사용합니다.

전송할 매개 변수

매개 변수

유형

필수 여부

설명

propertyId

문자열

InMobi에 등록할 때 사용한 앱 ID. InMobi에 앱 등록 방법에 대한 자세한 내용을 보려면? 여기를 클릭하십시오.

segmentName

문자열

세그먼트 이름(앱 ID에 고유한 이름), 적용된 고유한 소문자 확인, 최대 2000 utf-8자

전송할 형식

GET 메소드

URL 형식:
http://advertiser.inmobiapis.com/tpce/v1/segment?propertyId=&segmentName=

예:
http://advertiser.inmobiapis.com/tpce/v1/segment?propertyId=12345&segmentName=highpayingusers

JSON 응답

성공 JSON 응답:

{<br />"status":"OK",<br />"message":"success",<br />"code":200,<br />"segmentId":xxxx<br />}

실패 JSON 응답:

{<br />"status":"error_status",<br />"message":"error_message",<br />"code":error_code,<br />"segmentId":-1<br />}

참고: SegmentID는 성공의 경우 양의 긴 값이고, 실패의 경우 -1입니다.

세그먼트 삭제

세그먼트를 삭제하려면 이 API를 사용합니다.

전송할 매개 변수

매개 변수

유형

필수 여부

설명

propertyId

문자열

InMobi에 등록할 때 사용한 앱 ID. InMobi에 앱 등록 방법에 대한 자세한 내용을 보려면? 여기를 클릭하십시오.

segmentId

문자열

세그먼트를 생성할 때 InMobi에 의해 반환된는 세그먼트 ID.

전송할 형식

DELETE 메소드

URL 형식:
http://advertiser.inmobiapis.com/tpce/v1/segment?propertyId=&segmentId=

예:
http://advertiser.inmobiapis.com/tpce/v1/segment?propertyId=12345&segmentId=56789

JSON 응답

성공 JSON 응답:

{<br /> "status":"OK",<br /> "message":"success",<br /> "code":200,<br /> }

실패 JSON 응답:

{<br /> "status":"error_status",<br /> "message":"error_message",<br /> "code":error_code,<br /> }

세그먼트에서 사용자 추가 및 삭제

세그먼트에서 사용자를 추가 및 삭제하려면 이 API를 사용합니다.

참고: 세그먼트에 사용자 태그를 달기 전에 사용자의 앱 설치에 대해 InMobi에 알려주십시오.

전송할 매개 변수

다음과 같은 매개 변수를 전송합니다.

매개 변수

필수 여부?

설명

propertyId

InMobi에 등록할 때 사용한 앱 ID. InMobi에 앱 등록 방법에 대한 자세한 내용을 보려면? 여기를 클릭하십시오.

segmentIds<br />

사용자가 존재하는 세그먼트 ID 목록(세미콜론으로 구분)

u-id-map

장치 ID 섹션의 지침을 따르는 장치 ID

  • ida은(는) iOS에 필수적입니다.
  • gpId, um5 또는 o1 중 하나는 Android에 필수적입니다.

action

add, deletereplace의 값이 가능합니다. 지정된 앱과 세그먼트 ID에서 사용자가 수행할 조치들입니다. 다음 목적으로 이 매개 변수를 사용합니다.

  • 세그먼트에 사용자를 add
  • 세그먼트에서 사용자를 delete
  • 또는 이전 사용자 세그먼트를 새로운 세그먼트 목록으로 replace.

전송할 형식

한 번에 한 사용자: GET 메소드

URL 형식:
http://advertiser.inmobiapis.com/tpce/v1/usersegment?propertyId=&o1=&um5=&gpId=&ida=&idv=&segmentIds={1;2;3}&action=add

참고:

  • 장치 ID는 쿼리 매개 변수로 독립적으로 전송됩니다.
  • 매개 변수를 따옴표로 묶을 필요가 없습니다.
  • 세그먼트 ID들은 세미콜론으로 구분하고 중괄호로 묶어야 합니다.

JSON 응답

성공 JSON 응답:

{<br />"status":"OK",<br />"message":"success",<br />"code":200<br />}

실패 JSON 응답:

{<br />"status":”error_status”,<br />"message":"error_message",<br />"code":error_code<br />}
한 번에 여러 사용자: 다중 파일 업로드

여기에서 광고주는 CSV 형식으로 최대 10MB 용량 세그먼트 데이터를 전송할 수 있습니다. 파일은 압축해야 합니다.

참고: CSV 파일에는 아래와 같이 제목이 정해진 순서로 있어야 합니다.

propertyId, o1, um5, gpId, ida, idv, segmentIds, action

참고:

  • 제목들이 정해진 순서를 따르지 않으면 오류가 발생합니다.
  • 특정 장치 ID를 사용할 수 없으면 해당 열의 값이 비어 있습니다.
  • segmentId 열은 세미콜론으로 구분된 세그먼트 ID 목록으로 구성됩니다.

예:
"12345","40bd001563085fc35165329ea1ff5c5ecbdbbeef","202cb962ac59075b964b07152d234b70",””,"","","{1;2;3}","add"

다중 파일 업로드 요청 구조에 대해서는 아래를 참조하십시오.

요청 구조

세부 정보

URL 게시

http://advertiser-content.inmobiapis.com/tpce/v1/upload/usersegment

헤더

  • 컨텐츠 유형: 다중/양식-데이터
  • 수락-인코딩: gzip
  • 컨텐츠-처리: attachment; filename="xyzfilename"
  • 컨텐츠-길이: 33
  • 컨텐츠-유형: text/csv
  • 컨텐츠-전송-인코딩: binary

파트 본문

첨부된 파일 스트림

JSON 응답

{<br />"status":"OK",<br />"message":"success_message xxxxxx ",<br />"code":200,<br />"jobUrl":"job url to check status of file upload"<br />}

참고: JobUrl은 작업의 성공/실패 여부 또는 작업을 진행 중인지 여부를 나타내는 JSON 응답을 제공합니다.

장치 ID 지침

iOS

매개 변수 이름

매개 변수 유형

설명

ida

문자열

해싱 없는 광고주 ID. iOS 6 이상에만 해당됩니다. 자세한 내용을 보려면 여기를 클릭하십시오.

idv

문자열

해싱 없는 공급업체 ID. iOS 6 이상에만 해당합니다. 자세한 내용을 보려면 여기를 클릭하십시오.

Android

매개 변수 이름

매개 변수 유형

설명

gpId

문자열

해싱 없는 Google Play 광고 ID. 자세한 정보는 여기에서 확인하십시오.

o1

문자열

SHA1 / Android_ID

um5

문자열

MD5 / Android_ID