Adjust 차단 리스트 API를 사용하면 허위 또는 만료된 링크로부터의 트래픽을 차단할 수 있습니다. 커스텀 링크와 파트너 링크를 차단 리스트에 추가할 수 있습니다. 자기 기여 네트워크(SAN) 파트너 링크는 차단 리스트에 추가할 수 없습니다. SAN 파트너 링크로부터의 트래픽을 차단하려면 반드시 SAN 파트너를 삭제해야 합니다. SAN 파트너 목록은 셀프 어트리뷰션 네트워크 설정 페이지를 참고하시기 바랍니다.
인증
차단 리스트 API는 인증을 위해 베어러 토큰 을 사용합니다. 차단 리스트 API에 보내는 모든 요청에는 반드시 Adjust API 토큰을 Authorization 헤더에 포함해야 합니다.
Single Sign-On (SSO)를 활성화한 경우, Adjust 담당자에게 연락하거나 support@adjust.com 으로 이메일을 보내 API를 찾는 데 도움을 받으시기 바랍니다.
비 SSO 계정의 경우, API는 사용자의 프로필 에서 확인할 수 있습니다. Adjust API 토큰을 확인하려면 다음 단계를 따르시기 바랍니다.
- 계정(사용자) 아이콘을 선택합니다.
- 계정 설정 을 선택합니다.
- 내 프로필 탭을 선택합니다.
- API 토큰 은 사용자 세부 사항 과 함께 표시됩니다. 시스템 클립보드에 토큰을 복사하기 위해 복사를 선택합니다.
Adjust API 토큰 재설정
Adjust API 토큰은 언제든지 재설정할 수 있습니다. 토큰을 재설정하면 이전의 토큰은 무효화됩니다. Adjust API 토큰을 재설정한 경우 기존 토큰이 사용되는 모든 곳에서 교체해야 합니다. 무효화된 토큰에 대한 요청은 Adjust에 의해 거부됩니다.
Adjust API 토큰 재설정
- 계정(사용자) 아이콘을 선택합니다.
- 계정 설정 을 선택합니다.
- 내 프로필 탭을 선택합니다.
- API 토큰 은 사용자 세부 사항 과 함께 표시됩니다.
- API 토큰 재설정 을 선택합니다.
- 모달에 계정 비밀번호를 입력한 후 API 토큰 재설정을 위해 재설정 을 선택합니다. 화면 우측 상단에 확인 메시지가 나타납니다.
- 시스템 클립보드에 API 토큰 을 복사하기 위해 복사를 선택합니다.
링크 차단 리스트 등록
POST https://api.adjust.com/dashboard/api/trackers/{link}/blacklist링크를 차단 리스트에 추가하여 해당 링크에 대한 인게이지먼트 및 콜백 기록을 중지할 수 있습니다. 차단 리스트에 등록된 링크는 사용자가 다른 링크에 리어트리뷰션될 때까지 기존의 어트리뷰션을 유지합니다.
링크를 차단 리스트에 추가하기 전에 기록된 클릭과 노출은 계속 어트리뷰션에 유효합니다. 예를 들어, 7일의 어트리뷰션 윈도우를 설정하고 2일차에 링크를 차단 리스트에 추가한 경우 Adjust는 1일차의 인게이지먼트를 어트리뷰션에 고려합니다.
파라미터
다음의 파라미터는 반드시 쿼리 경로(path)에 포함되어야 합니다.
link(String)-
영숫자로 조합된 Adjust 링크 토큰
응답 형식
{ "label": "string", "token": "string", "name": "string", "url": "string", "path": "string", "has_subtrackers": true, "archived": true, "visible": true, "attribution_partner": true, "creative_token": "string", "adgroup_token": "string", "campaign_token": "string", "network_token": "string", "click_url": "string", "impression_url": "string", "allow_partner_linking": true, "settings": { "partner_id": "string", "partner_display_name": "string", "tracking_parameters": "string", "cost_data_parameters": "string", "cost_data": true, "partner_cost_data_parameters": "string", "campaign_structure": "string", "additional_parameters": "string", "attribution_settings": "string", "blacklisted": true }, "urls": { "descendants": "string", "ancestors": "string", "update": "string", "show": "string", "archive": "string", "unarchive": "string" }}예:
$ curl \--header "Authorization: Token token={api_token}" \-L -X POST "https://api.adjust.com/dashboard/api/trackers/abc123/blacklist"{ "label": "Twitter installs", "token": "abc123", "name": "Twitter installs", "url": "https://app.adjust.com/abc123", "path": "", "has_subtrackers": true, "archived": false, "visible": true, "attribution_partner": false, "creative_token": null, "adgroup_token": null, "campaign_token": null, "network_token": "abc123", "click_url": "https://app.adjust.com/abc123", "impression_url": "https://view.adjust.com/impression/abc123", "allow_partner_linking": true, "settings": { "partner_id": null, "partner_display_name": null, "tracking_parameters": null, "cost_data_parameters": null, "cost_data": false, "partner_cost_data_parameters": null, "campaign_structure": null, "additional_parameters": null, "attribution_settings": null, "blacklisted": true }, "urls": { "descendants": "/api/trackers/abc123/descendants.json", "ancestors": "/api/trackers/abc123/ancestors.json", "update": "/api/trackers/abc123.json", "show": "/api/trackers/abc123.json", "archive": "/api/trackers/abc123/archive.json", "unarchive": "/api/trackers/abc123/unarchive.json" }}링크 차단 리스트 등록 해제
POST https://api.adjust.com/dashboard/api/trackers/{link}/unblacklist언제든지 링크의 차단 리스트를 해제하여 재활성화할 수 있습니다. 링크를 차단 리스트에서 해제하면 Adjust가 인게이지먼트 및 콜백 측정을 재개합니다.
링크가 활성화되었을 때 수신된 인게이지먼트만 어트리뷰션 퍼널에서 고려됩니다.
파라미터
다음의 파라미터는 반드시 쿼리 경로(path)에 포함되어야 합니다.
link(String)-
영숫자로 조합된 Adjust 링크 토큰
응답 형식
{ "label": "string", "token": "string", "name": "string", "url": "string", "path": "string", "has_subtrackers": true, "archived": true, "visible": true, "attribution_partner": true, "creative_token": "string", "adgroup_token": "string", "campaign_token": "string", "network_token": "string", "click_url": "string", "impression_url": "string", "allow_partner_linking": true, "settings": { "partner_id": "string", "partner_display_name": "string", "tracking_parameters": "string", "cost_data_parameters": "string", "cost_data": true, "partner_cost_data_parameters": "string", "campaign_structure": "string", "additional_parameters": "string", "attribution_settings": "string", "blacklisted": true }, "urls": { "descendants": "string", "ancestors": "string", "update": "string", "show": "string", "archive": "string", "unarchive": "string" }}예:
$ curl \--header "Authorization: Token token={api_token}" \-L -X POST "https://api.adjust.com/dashboard/api/trackers/abc123/unblacklist"{ "label": "Twitter installs", "token": "abc123", "name": "Twitter installs", "url": "https://app.adjust.com/abc123", "path": "", "has_subtrackers": true, "archived": false, "visible": true, "attribution_partner": false, "creative_token": null, "adgroup_token": null, "campaign_token": null, "network_token": "abc123", "click_url": "https://app.adjust.com/abc123", "impression_url": "https://view.adjust.com/impression/abc123", "allow_partner_linking": true, "settings": { "partner_id": null, "partner_display_name": null, "tracking_parameters": null, "cost_data_parameters": null, "cost_data": false, "partner_cost_data_parameters": null, "campaign_structure": null, "additional_parameters": null, "attribution_settings": null, "blacklisted": false }, "urls": { "descendants": "/api/trackers/abc123/descendants.json", "ancestors": "/api/trackers/abc123/ancestors.json", "update": "/api/trackers/abc123.json", "show": "/api/trackers/abc123.json", "archive": "/api/trackers/abc123/archive.json", "unarchive": "/api/trackers/abc123/unarchive.json" }}링크 상태 확인
Campaign Lab에서 차단 리스트에 추가된 링크를 확인할 수 있습니다. 이를 위해 다음을 수행하시기 바랍니다.
- Campaign Lab으로 이동합니다.
- 파트너를 선택하면 관련 링크 목록이 표시됩니다. 차단 리스트에 있는 링크는 차단 리스트에 등록됨 으로 표시됩니다.
Campaign Lab에서 차단 리스트에 등록된 링크를 숨길 수 있습니다. 자세한 내용은 Campaign Lab에서 숨겨진 링크를 참조하시기 바랍니다.