Google에서는 사용자의 앱을 카테고리별로 정리하고 맞춤형 앱 콘텐츠 소비와 검색을 위한 새로운 몰입형 환경을 제공하는 기기 내 노출 영역을 구축하고 있습니다. 이 전체 화면 환경에서는 개발자 파트너가 앱 외부의 전용 채널에서 최고의 리치 콘텐츠를 선보일 수 있습니다.
이 문서에는 개발자 파트너가 새로운
예약, 이벤트, 숙박, 관심 장소, 사람, 기타 콘텐츠 등의
있습니다. Engage SDK를 사용하여 이러한 카테고리에 속하지 않을 수 있는 카테고리
이 새로운 표면 영역을 채울 수 있습니다.
통합 세부정보
용어
이 통합에는 맞춤 콘텐츠,
추천, 연속입니다.
맞춤 콘텐츠 클러스터에는 개별 사용자의 맞춤 추천이 표시됩니다.
있습니다. 권장사항 그룹이 포함된 UI 뷰입니다.
API를 사용할 수 있습니다.
ArticleEntity: 텍스트 기반 항목을 나타내는 ArticleEntity
두 개 이상의 카테고리와 관련된 콘텐츠 추천
있습니다. 개발자가 ArticleEntity 항목을 사용하면 개발자가
정보를 명확히 설명하기 위해 더 많은 메타데이터를 포함하는 텍스트 및 이미지 콘텐츠
GenericFeaturedEntity보다 높습니다. 예: 마케팅 콘텐츠,
뉴스 스니펫
<ph type="x-smartling-placeholder"></ph>
그림 1: 추천 내 단일 ArticleEntity를 보여주는 UI
kube-APIserver입니다
EventEntity: EventEntity는
있습니다. 이벤트 시작 시간은
사용자에게 전달되어야 합니다
<ph type="x-smartling-placeholder"></ph>
그림 2:
맞춤 콘텐츠 클러스터
LodgingEntity: LodgingEntity는 숙박시설을 나타내며,
단기 및 장기를 위한 호텔, 아파트, 별장
대여
<ph type="x-smartling-placeholder"></ph>
그림 3: 단일 LodgingEntity를 보여주는 UI
맞춤 동영상 클러스터 내에서 이루어집니다
StoreEntity: StoreEntity는 상점, 식당, 카페를 나타냅니다.
식당이나 상점이 가장 인기 있는 콘텐츠를
중요한 정보를
있습니다.
<ph type="x-smartling-placeholder"></ph>
그림 4:
맞춤 콘텐츠 클러스터
PointOfInterestEntity: PointOfInterestEntity는
주유소, 이벤트 장소, 테마파크,
콘텐츠를 강조 표시하는 박물관, 관광 명소, 하이킹 코스 등
여기서 위치는
사용자에게 전달됩니다. 숙박, 상점 또는
식당을 찾는 것입니다.
<ph type="x-smartling-placeholder"></ph>
그림 5: 단일 이미지를 보여주는 UI
추천 클러스터 내의 PointOfInterestEntity입니다.
PersonEntity: PersonEntity를 의미합니다. 권장사항
예를 들어 건강/피트니스,
스포츠, 데이트 등
<ph type="x-smartling-placeholder"></ph>
그림 5:
맞춤 콘텐츠 클러스터
연속 클러스터에는 다음에서 최근 사용자가 참여한 콘텐츠가 표시됩니다.
여러 개발자 파트너를 하나의 UI 그룹으로 구성할 수 있습니다. 각 개발자 파트너
는 지속 기간 중에 최대 10개의 항목을 브로드캐스트할 수 있습니다.
kube-APIserver입니다
연속 콘텐츠의 구조는 다음과 같습니다.
ArticleEntity: 텍스트 기반 항목을 나타내는 ArticleEntity
두 개 이상의 카테고리와 관련된 콘텐츠 추천
있습니다. 이 항목은 아직 끝나지 않은 뉴스를 나타내는 데 사용할 수 있습니다.
사용자가 계속 소비하려는 기사 또는 기타 콘텐츠
나오지 않도록 조심해야 합니다. 예: 마케팅 콘텐츠, 뉴스 스니펫
그림 6. 다음의 단일 ArticleEntity를 보여주는 UI
연속 클러스터입니다
RestaurantBookingEntity: RestaurantBookingEntity를 나타냅니다.
식당이나 카페에 대한 예약 기능을 이용해
음식점 예약 진행 중
그림 7. 단일 이미지를 보여주는 UI
연속 클러스터 내의 RestaurantBookingEntity.
EventBookingEntity: EventBookingEntity는
사용자가 예정되어 있거나 진행 중인 이벤트를 추적할 수 있게 해 줍니다
지정할 수 있습니다. 이벤트에는 다음이 포함되나 이에 국한되지 않습니다.
있습니다.
축구 경기 예약 등의 스포츠 이벤트
e스포츠 예약 등의 게임 이벤트
영화관 영화 예약과 같은 엔터테인먼트 이벤트
콘서트, 극장, 책 사인
여행 또는 관심 장소 예약(예: 가이드 투어, 박물관)
티켓
소셜 / 세미나 / 회의 예약
교육 / 교육 세션 예약
그림 8. 단일 이미지를 보여주는 UI
연속 클러스터 내의 EventBookingEntity입니다.
LodgingSchedulingEntity: LodgingEntityBooking은
사용자가 예정된 여행 일정이나 예약 내역을
진행 중인 호텔 또는 공유숙박 예약
그림 9. 단일 이미지를 보여주는 UI
연속 클러스터 내의 LodgingSchedulingEntity입니다.
TransportationreservationEntity: TransportationBookingEntity
모든 교통수단의 예약을 나타내며
예정된 항공편이나 진행 중인 항공편, 페리, 기차, 버스,
차량 호출 또는 크루즈입니다.
그림 10. 단일 이미지를 보여주는 UI
연속 클러스터 내의 TransportationSchedulingEntity입니다.
차량 렌탈 예약 항목: 차량 대여 예약Entity
렌터카 예약을 나타내며 사용자가 예정된 일정을 추적하도록 돕습니다.
또는 진행 중인 렌터카 예약
그림 11. 단일 이미지를 보여주는 UI
Continuation 클러스터 내의 VehicleVehiclerenBookingEntity입니다.
추천 클러스터는 선택한 히어로를 보여주는 UI 뷰입니다.
여러 개발자 파트너의 GenericFeaturedEntity가 하나의 UI 그룹으로 묶여 있습니다.
1개의 추천 클러스터가
모든 맞춤 콘텐츠 클러스터보다 높은 우선순위로 배치되는 UI 각
개발자 파트너는 지원되는
여러 항목 (다양한 유형일 수 있음)과 함께
추천 클러스터에 있는 여러 앱 개발자를 만나볼 수 있습니다.
GenericFeaturedEntity: GenericFeaturedEntity의 차이점
해당 추천 항목의 추천 항목은 단일
가장 높은 수익을 올릴 수 있는
사용자에게 흥미롭고 관련성 있는 중요한 콘텐츠를 제공하세요.
<ph type="x-smartling-placeholder"></ph>
그림 12: 단일 히어로를 보여주는 UI
추천 클러스터 내의 GenericFeaturedEntity 카드
사전 작업
최소 API 수준: 19
다음과 같이 com.google.android.engage:engage-core 라이브러리를 앱에 추가합니다.
dependencies {
// Make sure you also include that repository in your project's build.gradle file.
implementation 'com.google.android.engage:engage-core:1.5.2'
}
권장 텍스트 크기: 45자(영문 기준) 미만(텍스트가 너무 김
생략 부호가 표시될 수 있음).
이미지 사양
이미지 확장 소재의 필수 사양은 다음 표에 나와 있습니다.
가로세로 비율
최소 픽셀
권장 픽셀
정사각형(1x1)
기본
300x300
1200x1200
가로 모드(1.91x1)
600x314
1200x628
세로 모드(4x5)
480x600
960x1200
Google이 액세스할 수 있도록 공개 CDN에 이미지를 호스팅해야 합니다.
파일 형식
PNG, JPG, 정적 GIF, WebP
최대 파일 크기
5120KB
추가 권장사항
이미지 안전 영역: 중요한 콘텐츠를 이미지의 중앙 80%에 배치합니다.
이미지가 어두운 테마 설정과 밝은 테마 설정에서 제대로 표시될 수 있도록 투명한 배경을 사용합니다.
콘텐츠 카테고리
콘텐츠 카테고리를 사용하면 앱이 여러 개인
카테고리 이렇게 하면 콘텐츠가 다음과 같이 사전 정의된 카테고리 중 일부와 매핑됩니다.
TYPE_EDUCATION
TYPE_SPORTS
TYPE_MOVIES_AND_TV_SHOWS
TYPE_BOOKS
TYPE_AUDIOBOOKS
TYPE_MUSIC
TYPE_DIGITAL_GAMES
TYPE_TRAVEL_AND_LOCAL
TYPE_HOME_AND_AUTO
TYPE_BUSINESS
TYPE_NEWS
TYPE_FOOD_AND_DRINK
TYPE_SHOPPING
TYPE_HEALTH_AND_FITENESS
TYPE_MEDICAL
TYPE_PARENTING
TYPE_DATING
Google이 액세스할 수 있도록 공개 CDN에 이미지를 호스팅해야 합니다.
콘텐츠 카테고리 사용 가이드라인
ArticleEntity 및 GenericFeaturedEntity와 같은 항목은
모든 콘텐츠 카테고리를 사용할 수 있습니다. 다음과 같은 기타 항목의 경우
EventEntity, EventBookingEntity, PointOfInterestEntity 전용
이러한 카테고리의 하위 집합을 사용할 수 있습니다. 카테고리 목록 확인
항목 유형 요건을 충족하는지 확인하세요
조합 대신 일부 콘텐츠 카테고리에 특정 항목 유형 사용
두 가지 유형이 있습니다.
TYPE_MovieS_AND_TV_SHOWS - 다음에서 항목 확인
사용하기 전에 통합 가이드를 시청하세요.
일반 항목이 포함됩니다.
TYPE_FOOD_AND_DRINK - 다음에서 항목 체크아웃
음식 통합 가이드를
일반 항목을 가져야 합니다.
ContentCategory 입력란은 선택사항이며
콘텐츠가 앞서 언급한 어느 카테고리에도 속하지 않는 것으로 확인되었습니다.
여러 콘텐츠 카테고리가 제공된 경우 순서대로 입력하세요.
콘텐츠와의 관련성이 높은 콘텐츠 카테고리를 배치
표시됩니다
2단계: 클러스터 데이터 제공
콘텐츠 게시 작업을 백그라운드에서 실행하고(예: WorkManager 사용) 정기적으로 또는 이벤트를 기반으로 예약하는 것이 좋습니다(예: 사용자가 앱을 열 때마다 또는 사용자가 장바구니에 상품을 추가했을 때).
AppEngagePublishClient는 클러스터 게시를 담당합니다.
클라이언트에서 클러스터를 ���시하는 API는 다음과 같���니다.
isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
deleteUserManagementCluster
deleteClusters
isServiceAvailable
이 API는 서비스를 통합에 사용할 수 있는지, 콘텐츠를 기기에 표시할 수 있는지 확인하는 데 사용됩니다.
Kotlin
client.isServiceAvailable.addOnCompleteListener { task ->
if (task.isSuccessful) {
// Handle IPC call success
if(task.result) {
// Service is available on the device, proceed with content publish
// calls.
} else {
// Service is not available, no further action is needed.
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
}
Java
client.isServiceAvailable().addOnCompleteListener(task - > {
if (task.isSuccessful()) {
// Handle success
if(task.getResult()) {
// Service is available on the device, proceed with content publish
// calls.
} else {
// Service is not available, no further action is needed.
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
});
client.publishRecommendationClusters(
new PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(
new RecommendationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.setTitle("Top Picks For You")
.build())
.build());
client.publishFeaturedCluster(
new PublishFeaturedClustersRequest.Builder()
.addFeaturedCluster(
new FeaturedCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build());
client.publishContinuationCluster(
new PublishContinuationClusterRequest.Builder()
.setContinuationCluster(
new ContinuationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build());
서비스가 요청을 수신하면 다음 작업이 한 트랜잭션 내에서 발생합니다.
개발자 파트너의 기존 ContinuationCluster 데이터가 삭제됩니다.
요청 데이터가 파싱되어, 업데이트된 연속 클러스터에 저장됩니다.
오류가 발생하면 전체 요청이 거부되고 기존 상태가 유지됩니다.
publishUserAccountManagementRequest
이 API는 로그인 카드를 게시하는 데 사용됩니다. 로그인 작업은 앱이 콘텐츠를 게시하거나 더 맞춤설정된 콘텐츠를 제공할 수 있도록 사용자를 앱의 로그인 페이지로 안내합니다.
SignInCardEntity SIGN_IN_CARD_ENTITY =
new SignInCardEntity.Builder()
.addPosterImage(
new Image.Builder()
.setImageUri(Uri.parse("http://www.x.com/image.png"))
.setImageHeightInPixel(500)
.setImageWidthInPixel(500)
.build())
.setActionText("Sign In")
.setActionUri(Uri.parse("http://xx.com/signin"))
.build();
client.publishUserAccountManagementRequest(
new PublishUserAccountManagementRequest.Builder()
.setSignInCardEntity(SIGN_IN_CARD_ENTITY)
.build());
서비스가 요청을 수신하면 다음 작업이 한 트랜잭션 내에서 발생합니다.
개발자 파트너의 기존 UserAccountManagementCluster 데이터가 삭제됩니다.
요청 데이터가 파싱되어, 업데이트된 UserAccountManagementCluster 클러스터에 저장됩니다.
오류가 발생하면 전체 요청이 거부되고 기존 상태가 유지됩니다.
updatePublishStatus
내부적인 이유로 어떠한 클러스터도 게시되지 않는 경우
권장:
updatePublishStatus API의 여러 Cloud UI API에서 사용할 수 있습니다. 이는 다음과 같은 이유로 중요합니다.
콘텐츠가 게시되는 경우에도(STATUS == PUBLISHED) 모든 시나리오에서 상태를 제공하는 것은 이 명시적 상태를 사용하여 통합의 상태 및 기타 측정항목을 전달하는 대시보드를 채우는 데 중요합니다.
게시된 콘텐츠는 없지만 통합 상태가 손상되지 않은 경우(STATUS == NOT_PUBLISHED) Google은 앱 상태 대시보드에서 알림을 트리거하지 않을 수 있습니다. 이는 제공업체의 관점에서 예상되는 상황으로 인해 콘텐츠가 게시되지 않음을 확인합니다.
이를 통해 개발자는 데이터가 게시되는 시점과 게시 시점이
아닙니다.
Google은 상태 코드를 사용하여 사용자가 다음에서 특정 작업을 하도록 유도할 수 있습니다.
앱 콘텐츠를 보거나 극복할 수 있습니다.
적합한 게시 상태 코드 목록은 다음과 같습니다.
// Content is published
AppEngagePublishStatusCode.PUBLISHED,
// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,
// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,
// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,
// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,
// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,
// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,
// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,
// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER
로그인하지 않은 사용자로 인해 콘텐츠가 게시되지 않은 경우 Google은
로그인 카드를 게시하는 것이 좋습니다. 어떤 이유로든 제공업체가
먼저
updatePublishStatus API에 상태 코드 포함
NOT_PUBLISHED_REQUIRES_SIGN_IN
client.deleteClusters(
new DeleteClustersRequest.Builder()
.addClusterType(ClusterType.TYPE_CONTINUATION)
.addClusterType(ClusterType.TYPE_FEATURED)
.addClusterType(ClusterType.TYPE_RECOMMENDATION)
.build());
서비스가 요청을 수신하면 지정된 클러스터 유형과 일치하는 모든 클러스터에서 기존 데이터가 삭제됩니다. 클라이언트는 하나 이상의 클러스터 유형을 전달하도록 선택할 수 있습니다. 오류가 발생하면 전체 요청이 거부되고 기존 상태가 유지됩니다.
오류 처리
후속 작업을 실행하여 성공적인 작업을 복구하고 다시 제출할 수 있도록 게시 API의 작업 결과를 수신 대기하는 것이 좋습니다.
Kotlin
client.publishRecommendationClusters(
PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(..)
.build())
.addOnCompleteListener { task ->
if (task.isSuccessful) {
// do something
} else {
val exception = task.exception
if (exception is AppEngageException) {
@AppEngageErrorCode val errorCode = exception.errorCode
if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
// do something
}
}
}
}
Java
client.publishRecommendationClusters(
new PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(...)
.build())
.addOnCompleteListener(
task -> {
if (task.isSuccessful()) {
// do something
} else {
Exception exception = task.getException();
if (exception instanceof AppEngageException) {
@AppEngageErrorCode
int errorCode = ((AppEngageException) exception).getErrorCode();
if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
// do something
}
}
}
});
오류는 AppEngageException으로 반환되며 원인은 오류 코드로 포함됩니다.
오류 코드
참고
SERVICE_NOT_FOUND
지정된 기기에서 서비스를 사용할 수 없습니다.
SERVICE_NOT_AVAILABLE
서비스는 특정 기기에서 사용할 수 있지만 호출 시점에는 사용할 수 없습니다(예: 명시적으로 사용 중지됨).
SERVICE_CALL_EXECUTION_FAILURE
스레딩 문제로 인해 작업을 실행할 수 없습니다. 이 경우 재시도할 수 있습니다.
SERVICE_CALL_PERMISSION_DENIED
호출자가 서비스를 호출할 수 없습니다.
SERVICE_CALL_INVALID_ARGUMENT
요청에 잘못된 데이터가 포함되어 있습니다(예: 허용된 클러스터 수를 초과함).
SERVICE_CALL_INTERNAL
서비스 측에 오류가 있습니다.
SERVICE_CALL_RESOURCE_EXHAUSTED
서비스 호출이 너무 자주 이루어집니다.
3단계: 브로드캐스트 인텐트 처리
작업을 통해 게시 콘텐츠 API를 호출하는 것 외에도 콘텐츠 게시 요청을 수신하도록 BroadcastReceiver를 설정해야 합니다.
브로드캐스트 인텐트의 목표는 주로 앱 재활성화 및 데이터 동기화 강제입니다. 브로드캐스트 인텐트는 자주 전송되지 않도록 설계되었습니다. 이는 참여 서비스에서 콘텐츠가 오래되었을 수 있다고 판단할 때만(예: 1주일) 트리거됩니다. 이렇게 하면 애플리케이션이 장기간 실행되지 않은 경우에도 사용자에게 새로운 콘텐츠 환경을 제공할 수 있습니다.
BroadcastReceiver는 다음 두 가지 방법으로 설정해야 합니다.
Context.registerReceiver()를 사용하여 BroadcastReceiver 클래스의 인스턴스를 동적으로 등록합니다. 이렇게 하면 여전히 메모리에 있는 애플리케이션의 통신이 가능해집니다.
Kotlin
class AppEngageBroadcastReceiver : BroadcastReceiver(){
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
// Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}
fun registerBroadcastReceivers(context: Context){
var context = context
context = context.applicationContext
// Register Recommendation Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION))
// Register Featured Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(Intents.ACTION_PUBLISH_FEATURED))
// Register Continuation Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}
Java
class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
// Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}
public static void registerBroadcastReceivers(Context context) {
context = context.getApplicationContext();
// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION));
// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));
// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION));
}
AndroidManifest.xml 파일에서 <receiver> 태그를 사용하여 구현을 정적으로 선언합니다. 이를 통해 애플리케이션이 실행 중이 아닐 때 브로드캐스트 인텐트를 수신할 수 있고, 애플리케이션이 콘텐츠를 게시할 수 있습니다.
