모바일용 Topics API 개요

bookmark_border 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Android의 Topics API와 구현 단계에 관해 알아봅니다. 주제 구현으로 바로 이동할 수도 있습니다.

Topics API 작동 방식

Topics API는 사용자의 활동을 기반으로 사용자에게 관심이 있는 것으로 보이는 주제를 관찰하고 액세스 권한을 제공하는 데 사용할 수 있습니다. 그러면 Topics API는 API 호출자 (예: 광고 기술 플랫폼)에게 사용자의 관심 주제에 대한 액세스 권한을 부여할 수 있지만 사용자의 활동에 관한 추가 정보는 공개하지 않습니다.

주요 개념

• 주제는 현재 사용자의 관심 주제이며 인간이 읽을 수 있으며 주제 분류의 일부입니다.
• 호출자는 Topics API에 사용자의 관심분야를 관찰하거나 액세스하도록 요청하는 앱, 서드 파티 SDK, 웹사이트, 서비스와 같은 항목입니다.
• 호출자가 지난 3 에포크 동안 이 주제와 연결된 웹페이지 또는 앱에서 Topics API 요청을 보낸 경우 주제는 호출자가 관찰합니다.
• 에포크는 주제 계산 기간으로 기본값은 1주일입니다.
• 분류는 /Arts & Entertainment/Music & Audio/Soul & R&B 및 /Business & Industrial/Business Services/Corporate Events와 같은 카테고리를 포함하는 계층 구조의 카테고리 목록입니다.
• 주제는 사용자 활동을 0개 이상의 주제에 매핑하는 분류기 모델을 사용하여 파생됩니다.

Topics API 흐름 핵심 단계

Topics API 수명 주기는 다음 세 가지 주요 단계로 구성됩니다.

• 사용자가 웹페이지 https://cats.example/tabby/index.html를 방문하거나 앱 cats을 다운로드하는 경우와 같은 사용자 활동을 관찰합니다.
• 사용자 활동(예: /Pets & Animals/Pets/Cats)에서 주제를 파생합니다.
• 이전에 사용자에 관해 관찰된 주제 액세스입니다(예: 관련성 있는 광고(예: 고양이 사료 프로모션)를 선택하기 위한 신호).

주제 관찰

호출자는 관찰한 관심 주제에만 액세스할 수 있습니다. 호출자는 이 주제와 연결된 컨텍스트에서 Topics API 요청을 보낼 때 주제를 관찰합니다. 이 개념을 설명하기 위해 다음과 같이 단순화된 예시를 살펴보세요.

• Topics API 호출자가 A와 B 두 개 있다고 가정해 보겠습니다.
• 두 가지 컨텍스트가 있습니다.
  • Greenhouse(예: Greenhouse라는 앱 또는 Home & Garden 주제와 연결된 웹사이트 greenhouse.example).
  • 테니스 운동: Sports/Tennis 주제와 연결된 Tennis Exercises라는 앱 또는 tennis.example 웹사이트를 예로 들 수 있습니다.
• 호출자 A와 B가 모두 Greenhouse 컨텍스트에 있습니다.
• 호출자 B만 테니스 연습 컨텍스트에 있습니다.
• 편의상 에포크 1 이전에는 사용자에 대해 관찰된 주제가 없다고 가정합니다.
• 사용자가 Greenhouse 앱을 방문하고 호출자 A와 B가 Topics API를 호출하여 페이지 또는 앱 방문을 기록합니다 (Topics API를 호출하는 방법을 알아보려면 다음 단계에 제안된 구현 가이드를 참고하세요). 이 레코드 (호스트 이름 또는 앱 데이터)는 나중에 관심 주제를 파생하는 데 사용됩니다. 나중에 Topics API는 주제 Home & Garden를 호출자 A와 B가 모두 관찰한 것으로 표시합니다.
• 사용자가 테니스 운동 앱을 방문합니다. 호출자 B만 Topics API 요청을 보냅니다. 나중에 Topics API는 주제 Sports/Tennis를 호출자 B가 관찰한 것으로 표시합니다.
• 에포크가 끝날 때 Topics API는 사용자의 인기 주제를 새로고침하고 사용자 활동을 기반으로 이러한 주제를 관찰한 호출자를 결정합니다.
• 나중에 호출자 B가 Topics API를 다시 호출하면 응답 배열에서 이 사용자의 Home & Garden 또는 Sports/Tennis 주제 (또는 5% 의 확률로 임의의 주제)를 가져올 수 있습니다.
• 호출자 A는 주제 Sports/Tennis를 관찰한 적이 없으므로 주제 Home & Garden에만 액세스할 수 있습니다. 즉, 서드 파티는 사용자가 관심을 두는 주제가 있는 특정 맥락 (앱 또는 웹사이트) 내에서만 해당 주제에 관해 알 수 있습니다.

주제 파생

Topics는 사용자 활동에서 관심 주제를 파생합니다. 주제는 사전 정의된 오픈소스 분류에서 선택합니다. Topics는 에포크당 한 번씩 사용자의 상위 5개 주제와 에포크 중에 이를 관찰한 호출자를 새로고침합니다. Topics 분류 기준 모델은 웹페이지 방문의 호스트 이름, Android의 앱 정보와 같은 사용자 활동에서 주제를 파생합니다.

호출자가 사용자의 관심분야에 액세스함

API는 최근 3개 에포크 내에서 호출자가 관찰한 주제만 반환합니다. 호출자에게 최대 3개의 주제가 반환될 수 있으며,최근 3개 에포크당 하나씩 주제가 반환됩니다 (호출자가 해당 에포크의 주제를 관찰한 경우). 반환된 주제는 호출자가 문맥 정보를 보완하는 데 사용할 수 있으며 사용자에게 더 관련성 높은 광고를 찾는 데 도움이 되도록 결합될 수 있습니다.

에포크

Topics API는 제공하는 관심 주제를 최신 상태로 유지해야 합니다. 주제는 에포크(기본적으로 1주일)라는 기간 동안의 활동을 기반으로 사용자를 위해 추론됩니다. 각 사용자는 자체 에포크를 가지며 (에포크는 '사용자별') 초기 시작 시간은 무작위로 지정됩니다.

Topics API는 각 에포크에 한 번씩 사용자의 상위 5개 주제를 계산하고 기기 내 정보를 사용하여 이러한 주제를 관찰한 호출자를 결정합니다. 각 에포크의 주제는 해당 기간 동안 사용자가 가장 많이 살펴본 5개의 주제 중에서 무작위로 선택됩니다. 개인 정보 보호를 강화하는 한편 모든 주제가 표시되도록 하기 위해, 관심분야 분류에서 선택 가능한 모든 주제 중 특정 주제가 무작위로 선택될 확률은 5% 로 되어 있습니다.

Android 주제 실습

Android의 Topics API는 일반적으로 여러 앱에서 작동하는 서드 파티 광고 SDK를 지원하도록 설계되었습니다. Topics는 교차 앱 식별자를 사용하지 않고 사용자의 앱 사용에 따라 관심 있는 대략적인 광고 주제를 호출자에게 제공합니다. 이러한 주제는 광고를 표시하려는 앱과 관련된 문맥 정보를 보완하는 데 사용할 수 있으며 사용자에게 적합한 광고를 선택하는 데 도움이 되도록 결합될 수 있습니다.

Topics API의 맥락에서 구매자와 광고주는 판매 측에 의존합니다. 판매자 측은 게시자 앱에 광범위하게 노출되고 사용자의 주제를 관찰한 후 구매자가 더 관련성 높은 광고를 선택하는 데 도움이 되도록 주제를 구매자와 공유합니다. 주제를 가져오려면 판매 측 앱과 SDK가 최소 한 에포크 동안 Topics API를 관찰하여 공간을 설정해야 합니다.

Topics API 구현 가이드를 참고하세요. )을 확인하세요.

비즈니스 유형별 주제 통합

Topics API를 사용하여 IBA (관심 기반 광고)를 사용 설정합니다. 광고 기술 비즈니스 유형에 따른 단계에 따라 Topics API를 통합하고 출시를 준비하세요.

모든 광고 기술

• 주제 분류를 검토하고 의견을 제공합니다.
• Topics API 샘플 앱을 실험하여 기기 내 분류 기준에서 반환되는 주제 데이터를 확인합니다.
• Topics API 호출을 시작하도록 앱 및 SDK 흐름을 업데이트합니다.
• 광고 요청에서 주제 전송을 시작하도록 프로토콜을 업데이트합니다.
• 개인 정보 보호 샌드박스에 광고 기술을 등록합니다.

판매 측 광고 기술

• 관찰자가 되어 Topics API 공간을 설정합니다. Topics API는 새로운 신호를 제공하므로 Topics API 호출을 시작하려면 SDK를 업데이트해야 합니다. 주제를 일관되게 가져오려면 SDK가 게시자 앱에서 에포크당 한 번 이상 API를 호출해야 합니다. 광고 요청과 함께 전송할 최대 주제 수 (주제 3개)를 가져오려면 최대 4 에포크가 필요합니다.
• 광고 요청에 Topics API 정보를 포함합니다. 각 광고 요청에서 구매 측 파트너와 Topics API 데이터를 공유하기 시작합니다. Topics API는 특정 방문자에게 적절한 광고를 찾는 데 도움이 되도록 다른 신호(예: 문맥 신호)를 보완할 계획입니다.
• 구매 측 파트너와 주제를 공유하기 위한 프로토콜을 공동작업합니다. Topics API를 사용하려면 각 SDK가 다운스트림 파트너와 협력하여 Topics API 데이터의 공유 방식에 동의해야 합니다.

구매 측 광고 기술

• 판매 측 파트너와 소통하여 주제를 관찰하고 공간을 설정하려는 계획을 확인합니다. 주제를 수신하려면 판매 측 제공업체가 에포크당 한 번 이상 Topics API를 호출해야 합니다.
• 판매 측 파트너로부터 주제를 받기 위한 프로토콜을 공동작업합니다. 주제는 판매 측 파트너가 광고 요청의 일부로 공유할 새로운 신호입니다. 구매 측 소비자는 주제 공유 방식에 관해 상위 파트너와 협력해야 합니다.
• 입찰 및 최적화 모델에서 주제를 통합합니다. Topics API는 방문자에게 적절한 광고를 찾는 데 도움이 되도록 문맥과 같은 다른 신호를 보완할 것으로 예상됩니다.

API가 앱의 주제를 추론하는 방법

Android에서 Topics API는 분류 기준 모델을 사용하여 앱 정보를 기반으로 앱의 주제를 추론합니다. 현재 구현에서는 Topics가 앱과 패키지 이름을 사용하여 앱에 관심 주제를 할당하지만, 나중에 앱 설명과 같은 다른 정보를 포함하도록 확장될 수 있습니다.

주제 분류 기준

관심 주제는 공개적으로 사용 가능한 앱 정보에 관해 학습된 분류 기준 모델에서 파생됩니다.

• 특정 에포크 동안 주제를 계산하는 추론에 분류 모델을 사용하면 사용된 신호 집합이 기기에 유지됩니다. 이러한 신호에는 설치되었거나 최근에 사용한 앱이 포함될 수 있으며 나중에 다른 신호를 포함하도록 확장될 수 있습니다.
• V5 모델은 Google Play 스토어와 같은 앱 스토어에서 공개적으로 사용 가능한 앱 정보 중 사람의 라벨이 지정된 54만 개와 ML 라벨이 지정된 1,700만 개를 바탕으로 Google에서 학습했습니다. 이 모델은 앱 이름과 패키지 이름을 입력 신호로 사용하며 앱 개발자가 앱이 어떤 주제로 분류되는지 테스트하고 확인하는 데 자유롭게 사용할 수 있습니다.
• 앱이 두 개 이상의 주제에 매핑되거나, 주제에 매핑되지 않거나, 사용자의 주제 기록에 추가되지 않을 수 있습니다. 앱이 분류에서 2개 이상의 주제에 매핑되는 경우 이 앱에 대해 선택된 주제 수는 상위 3개로 제한됩니다.

분류기 모델의 작동 방식을 더 잘 이해하려면 Android Topics Classifier Colab을 사용하여 다양한 앱 데이터가 분류에 미치는 영향을 테스트하면 됩니다.

분류

주제는 사전 정의된 오픈소스 분류에서 선택됩니다. 분류는 공개적으로 사용 가능하며 변경될 수 있습니다. 이 페이지 상단의 의견 보내기 버튼을 사용하여 의견을 제출할 수 있습니다. 이 분류는 사람이 선별하므로 민감한 주제는 분류에 포함되지 않습니다. Android의 모바일 앱에 게재할 수 있는 광고 카테고리에 맞게 조정됩니다.

Android 주제 실습

사용자가 기기에 앱을 7개(A, B, C, D, E, F, G) 설치했다고 가정해 보겠습니다. 이러한 앱에서 앱과 광고 기술 SDK의 주제 분류가 다음과 같다고 가정해 보겠습니다.

1주 차: Topics API가 이 에포크 동안 사용자의 상위 5개 주제를 생성합니다.

2주 차에 앱의 호출자가 API를 호출하면 반환된 주제 목록에는 '주제에 관해 알아볼 수 있는 호출자'에 호출자가 있는 주제만 포함됩니다. 해당 에포크 동안 해당 앱의 주제 열을 나타냅니다.

• 각 호출자가 사용할 수 있는 주제 계산에 포함되는 기록 기간은 3에포크 (또는 3주)입니다.
• 광고 SDK를 통해 Topics API를 호출하는 앱과 연결된 주제만 사용됩니다. 즉, 앱에 Topics API를 호출하는 광고 SDK가 포함되어 있지 않으면 앱과 연결된 주제는 광고 SDK에서 액세스할 수 있는 주제 풀에 기여하지 않습니다.
• 앱은 Topics API를 선언적으로 선택 해제할 수도 있습니다. 선택 해제된 앱과 연결된 주제는 주간 주제 계산에 영향을 주지 않습니다. 이 문서는 관련 구현 세부정보를 포함하도록 업데이트될 예정입니다.

플랫폼에서 5개 주제를 추론하기에 충분한 앱 사용이 없으면 플랫폼은 나머지 주제를 무작위로 생성하는 등의 옵션을 고려할 수 있습니다.

반환된 주제 암호화

Topics API를 호출하는 등록된 광고 기술 플랫폼은 반환된 주제를 있습니다.

개인 정보 보호 샌드박스는 광고 기술에서 제공한 엔드포인트에서 이러한 키를 가져옵니다. 키는 정기적으로 업데이트하되 최소 6개월마다 업데이트하지 않는 것이 좋습니다.

개인 정보 보호 샌드박스는 등록 프로세스 중에 광고 기술이 제공하는 엔드포인트의 가용성을 확인하도록 요청합니다. 기존 광고 기술과 새로 등록된 광고 기술에 대한 자세한 내용은 등록 가이드를 참고하세요.

다음 단계

참고 항목

Android의 Topics API에 관해 자세히 알아보려면 리소스를 확인하세요.

• 샘플 앱, 공동작업, 둘러보기 동영상 주제를 확인하세요.
• 사용자와 개발자가 API를 제어하는 방법을 알아보세요.
• 질문하고, 소통하고, 의견을 공유하려면 지원 리소스를 확인하세요.