포털 빌드를 위한 권장사항

Apigee Edge 문서입니다.
Apigee X 문서로 이동
정보

Apigee에서는 포털을 빌드할 때 다음 섹션에 설명된 권장사항을 적용하는 것을 권장합니다.

잠재고객의 참여 유도하기

시각적으로 잠재고객 참여를 유도하여 고객으로 하여금 더 알아보고 싶게 만드는 콘텐츠를 추가하세요. API 소비자가 로그인하지 않고도 포털의 일부분을 탐색할 수 있도록 사용 설정합니다. 셀프서비스 등록을 제공하여 사용자가 API로 앱을 빌드하기 위해 빠르게 시작 및 실행할 수 있도록 합니다.

사용자가 API를 사용하도록 허용

OpenAPI 사양에서 대화형 API 문서를 자동 생성하면 사용자가 다음을 수행할 수 있습니다.

  • API 알아보기
  • API에 실시간 요청 보내기
  • API에서 반환된 실시간 응답 보기

    자세한 내용은 API 게시를 참고하세요.

기본 학습 과정 해결

잠재고객과 사용자 경험 수준을 기반으로 관련된 사용 사례 및 가이드를 제공합니다. 간단한 curl 명령어 시퀀스와 같은 예시를 표시하거나, 보다 정교한 절차를 진행할 수 있습니다.

검색엔진 최적화(SEO) 구현

콘텐츠가 검색 가능한지 확인합니다. 검색 결과의 순위를 높이고 사용자가 콘텐츠를 쉽게 찾을 수 있도록 검색 엔진 최적화에 투자합니다.

검색엔진 최적화

콘텐츠를 구성할 때는 다음 권장사항을 따르세요. Google에서의 자세한 내용 및 추가 가이드라인은 Google 검색엔진 최적화 기본 가이드를 참조하세요.

권장사항 설명 이점
사용자 친화적 URL 만들기 이해하기 쉬운 URL을 만듭니다. 페이지 만들기에 설명된 대로 포털에 페이지를 추가할 때 사용자 친화적인 페이지 URL을 정의합니다.
  • 사람이 읽을 수 있는 형태로 페이지의 목적을 전달합니다.
  • 페이지 URL의 전체 또는 부분 키워드 일치는 검색 순위를 높입니다.
  • 일반적으로 URL은 검색결과에 표시됩니다.
구체적인 포털 이름 제공 포털 관리에 설명된 대로 포털에 대해 고유하고 설명이 포함된 이름을 정의합니다. 이 콘텐츠는 포털의 홈페이지(index)에 대한 <title> 태그를 채우는 데 사용됩니다.
  • 제목의 전체 또는 부분 키워드 일치는 검색 순위를 높입니다.
  • 일반적으로 페이지 제목의 콘텐츠는 검색결과의 첫 번째 줄에 표시됩니다.
사이트를 쉽게 탐색할 수 있게 만들기 탐색 설정에 설명된 대로 논리적으로 의미 있는 탐색 구조를 정의합니다.
  • 사용자 중심이 되도록 유지합니다.
  • 사용자가 원하는 콘텐츠를 쉽고 빠르게 찾을 수 있도록 도와줍니다.
콘텐츠에 대한 효과적 조합의 키워드 문구 사용 키워드가 관련성이 있고 적절한 경우 콘텐츠에 키워드를 포함합니다. 페이지에 키워드 문자열이 보이면 페이지의 검색 결과 순위가 향상될 수 있습니다. 사용자가 콘텐츠를 검색할 때 사용할 수 있는 키워드 문자열을 예측해 보세요. 아무 키워드나 사용하지 않도록 합니다. 즉, 검색 순위를 향상시키는 목적으로만 키워드를 과도하게 사용하지 마세요. 이렇게 하면 검색엔진에 의해 사이트에 페널티가 적용될 수 있습니다. 콘텐츠를 검색하는 사용자는 관련성이 높은 항목을 찾을 가능성이 높습니다.

개발자 커뮤니티 구축

소셜 미디어를 사용하여 Facebook, Twitter 등의 표준 소셜 채널을 통해 API 커뮤니티를 홍보합니다. API 커뮤니티에서 개발자 간 소통 및 상호작용을 촉진하는 블로그와 포럼을 게시합니다.