• API 레퍼런스

Attribution Result

Device UUID로 기여된 결과를 가져올 수 있습니다.

Attribution Result API는 Authorization Header로 AIRBRIDGE-API-KEY 와 AIRBRDGE-SDK-TOKEN을 받을 수 있습니다. AIRBRIDGE-API-KEY를 사용하는 경우 API Token을 사용하고 AIRBRIDGE-SDK-TOKEN를 사용하는 경우 SDK Token을 사용합니다.

호출의 예시는 아래와 같습니다.

curl -H "Authorization: AIRBRIDGE-API-KEY {API-TOKEN}" https://api.airbridge.io

기여 결과 가져오기

GET

https://api.airbridge.io/attribution-result/v1/apps/{app_name}/mobile-app

기여 결과를 가져옵니다.

Request

Headers

Accept-Language
string

API 요청 및 결과 반환에 사용할 언어를 지정할 수 있습니다. ISO-639-1 포맷을 따릅니다.

Content-Type
string

리소스의 미디어 타입을 나타냅니다. 기본값으로 application/json을 사용합니다.

Authorization
string

API 요청에 사용하는 키값입니다. 키값 생성 및 조회 방법을 확인하여 획득할 수 있습니다.

Path Params

app_name
필수string

에어브릿지 앱 이름(App Name)

Query Params

device_uuid
필수string

Android 혹은 iOS의 Device UUID.

앱 SDK를 통해 획득한 디바이스 UUID입니다. OS별로 획득하는 방법은 아래 가이드를 참조해주시기 바랍니다.

Request
curl -X GET 'https://api.airbridge.io/attribution-result/v1/apps/{app_name}/mobile-app?device_uuid=f3fab994-baea-4b52-b190-5f023b6ae638' \ -H 'Accept-Language: ko' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'

Response

200SUCCESS

204SUCCESS

기여 결과를 찾을 수 없는 경우, API는 204 No Content 응답을 반환합니다. 이는 유효한 요청이지만 해당 조건에 맞는 기여 데이터가 없음을 의미합니다.

400ERROR

401ERROR

Response
{ "at": "2023-01-01T09:30:00.123Z", "data": { "attributedTerm": null, "attributedAdGroup": "TEST_ADGROUP", "attributedChannel": "website", "attributedContent": null, "attributedCampaign": "TEST_CAMPAIGN", "attributedAdCreative": "TEST_ADCREATIVE", "attributedSubPublisher": null, "attributedSubSubPublisher1": null, "attributedSubSubPublisher2": null, "attributedSubSubPublisher3": null }}
Response
{}
Response
{ "result": "Invalid device_uuid"}
Response
{ "result": "invalid authorization header"}