Engage SDK 购物：第三方技术集成说明

Google 正在构建一个设备上的界面，该界面按垂直领域组织用户的应用，并为个性化应用内容使用和发现提供新的沉浸式体验。此全屏体验为开发者合作伙伴提供了一个机会，让他们可以在其应用之外的专用频道中展示他们最好的丰富内容。

本指南包含开发者合作伙伴将他们的购物内容集成到此新界面区域以及现有 Google 界面（如娱乐空间）的说明，使用 Engage SDK 来填充这两个界面。

集成细节

术语

此集成包括以下五种集群类型：推荐、精选、购物车、购物清单、重新订购和购物订单跟踪。

• 推荐集群显示来自单个开发者合作伙伴的个性化购物建议。这些建议可以根据用户进行个性化设置或进行概括（例如，趋势商品）。根据需要使用这些建议来显示产品、事件、促销、优惠券、订阅等。

  您的推荐采用以下结构

  • 推荐集群：包含来自同一开发者合作伙伴的一组推荐的 UI 视图。

  • ShoppingEntity：表示集群中单个商品的对象。

• 精选集群在单个 UI 分组中展示来自多个开发者合作伙伴的选定英雄ShoppingEntity。将有一个精选集群，它位于 UI 顶部附近，优先于所有推荐集群。每个开发者合作伙伴允许在精选集群中发布单个 ShoppingEntity。

• 购物车集群在单个 UI 分组中显示来自多个开发者合作伙伴的购物车预览，提示用户完成未完成的购物车。将有一个购物车集群，它位于 UI 顶部附近，优先于所有推荐集群。每个开发者合作伙伴允许在购物车集群中广播最多 3 个ShoppingCart 实例。

  您的购物车采用以下结构

  • 购物车集群：包含来自多个开发者合作伙伴的购物车预览的 UI 视图。

  • 购物车: 代表单个开发者合作伙伴的购物车预览的物件，将在购物车集群中显示。 ShoppingCart 必须显示购物车中商品的总数，还可以包括用户购物车中某些商品的图片。

• 购物清单 集群显示来自多个开发者合作伙伴的购物清单的快速预览，这些清单在一个 UI 分组中，提示用户返回相应的应用程序以更新和完成他们的清单。只有一个购物清单集群。

• 重新排序 集群显示来自多个开发者合作伙伴的上一个订单的快速预览，这些订单在一个 UI 分组中，提示用户重新排序。只有一个重新排序集群。

  • 重新排序集群必须显示用户先前订单中的商品总数，并且必须还包括以下内容之一

    • 用户先前订单中 X 个商品的图片。
    • 用户先前订单中 X 个商品的标签。

• 购物订单跟踪 集群显示来自许多开发者合作伙伴的待处理或最近完成的购物订单的快速预览，在一个 UI 分组中，允许用户跟踪他们的订单。

  只有一个 ShoppingOrderTracking 集群，它显示在 UI 的顶部附近，优先级高于所有推荐集群。每个开发者合作伙伴都可以在购物订单跟踪集群中广播多个 ShoppingOrderTrackingEntity 项目。

  • 您的 ShoppingOrderTrackingCluster 采用以下结构

    • 购物订单跟踪集群: 包含来自许多开发者合作伙伴的订单跟踪预览组的 UI 视图
    • ShoppingOrderTrackingEntity: 代表单个开发者合作伙伴的购物订单跟踪预览的物件，将在购物订单跟踪集群中显示。 ShoppingOrderTrackingEntity 必须显示订单状态和订单时间。我们强烈建议为 ShoppingOrderTrackingEntity 填充预计送达时间，因为该时间将在提供时显示给用户。

预备工作

最低 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'
}

有关更多信息，请参见 Android 11 中的软件包可见性。

总结

该设计基于对 绑定服务 的实现。

客户可以发布的数据受以下不同集群类型的限制

步骤 1: 提供实体数据

SDK 已定义不同的实体来表示每个项目类型。以下实体受购物类别支持

1. ShoppingEntity
2. ShoppingCart
3. ShoppingList
4. Reorder
5. ShoppingOrderTracking

下面的图表概述了每种类型的可用属性和要求。

ShoppingEntity

ShoppingEntity 物件代表开发者合作伙伴想要发布的产品、促销、优惠、订阅或活动。

ShoppingEntity

ShoppingCart

ShoppingList

ShoppingReorderCluster

ShoppingOrderTrackingCluster

图片规范

以下是图像资产的必要规格

文件格式

PNG、JPG、静态 GIF、WebP

最大文件大小

5120 KB

其他建议

• 图像安全区域：将重要内容放在图像中心 80% 的区域内。
• 使用透明背景，以便图像可以在深色和浅色主题设置中正常显示。

步骤 2：提供集群数据

建议在后台执行内容发布作业（例如，使用 WorkManager）并定期或按事件（例如，每次用户打开应用程序或用户将某些内容添加到购物车时）进行调度。

AppEngageShoppingClient 负责发布购物集群。

以下 API 用于在客户端发布集群

• isServiceAvailable
• publishRecommendationClusters
• publishFeaturedCluster
• publishShoppingCart
• publishShoppingCarts
• publishShoppingList
• publishShoppingReorderCluster
• publishShoppingOrderTrackingCluster
• publishUserAccountManagementRequest
• updatePublishStatus
• deleteRecommendationsClusters
• deleteFeaturedCluster
• deleteShoppingCartCluster
• deleteShoppingListCluster
• deleteShoppingReorderCluster
• deleteShoppingOrderTrackingCluster
• deleteUserManagementCluster
• deleteClusters

isServiceAvailable

此 API 用于检查服务是否可用于集成，以及内容是否可以在设备上呈现。

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.
    }
}

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.
    }
});

publishRecommendationClusters

此 API 用于发布 RecommendationCluster 对象列表。

一个 RecommendationCluster 对象可以具有以下属性

client.publishRecommendationClusters(
            PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Black Friday Deals")
                        .build())
                .build())

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Black Friday Deals")
                        .build())
                .build());

当服务收到请求时，会在一个事务内执行以下操作

• 删除所有现有的推荐集群数据。
• 解析请求中的数据并将其存储在新的推荐集群中。

如果出现错误，整个请求将被拒绝，并且将保留现有状态。

publishFeaturedCluster

此 API 用于发布一个 FeaturedCluster 对象。

client.publishFeaturedCluster(
            PublishFeaturedClusterRequest.Builder()
                .setFeaturedCluster(
                    FeaturedCluster.Builder()
                        ...
                        .build())
                .build())

client.publishFeaturedCluster(
            new PublishFeaturedClusterRequest.Builder()
                .setFeaturedCluster(
                    new FeaturedCluster.Builder()
                        ...
                        .build())
                .build());

当服务收到请求时，会在一个事务内执行以下操作

• 删除开发人员合作伙伴的现有 FeaturedCluster 数据。
• 解析请求中的数据并将其存储在更新的特色集群中。

如果出现错误，整个请求将被拒绝，并且将保留现有状态。

publishShoppingCart

此 API 用于发布一个 ShoppingCartCluster 对象。

client.publishShoppingCart(
            PublishShoppingCartRequest.Builder()
                .setShoppingCart(
                    ShoppingCart.Builder()
                        ...
                        .build())
                .build())

client.publishShoppingCart(
            new PublishShoppingCartRequest.Builder()
                .setShoppingCart(
                    new ShoppingCart.Builder()
                        ...
                        .build())
                .build())

当服务收到请求时，会在一个事务内执行以下操作

• 删除开发人员合作伙伴的现有 ShoppingCart 数据。
• 解析请求中的数据并将其存储在更新的购物车集群中。

如果出现错误，整个请求将被拒绝，并且将保留现有状态。

publishShoppingCarts

此 API 用于发布多个 ShoppingCart 对象。这适用于开发人员合作伙伴针对每个商家发布独立的购物车。使用此 API 时，请在标题中包含商家名称。

client.publishShoppingCarts(
            PublishShoppingCartClustersRequest.Builder()
                .addShoppingCart(
                    ShoppingCart.Builder()
                        ...
                        .build())
                .build())

client.publishShoppingCarts(
            new PublishShoppingCartClustersRequest.Builder()
                .addShoppingCart(
                    new ShoppingCart.Builder()
                        ...
                        .build())
                .build())

当服务收到请求时，会在一个事务内执行以下操作

• 删除开发人员合作伙伴的现有 ShoppingCart 数据。
• 解析请求中的数据并将其存储在更新的购物车集群中。

如果出现错误，整个请求将被拒绝，并且将保留现有状态。

publishShoppingList

此 API 用于发布一个 FoodShoppingList 对象。

client.publishFoodShoppingList(
            PublishFoodShoppingListRequest.Builder()
                .setFoodShoppingList(
                    FoodShoppingListEntity.Builder()
                        ...
                        .build())
                .build())

client.publishFoodShoppingList(
            new PublishFoodShoppingListRequest.Builder()
                .setFoodShoppingList(
                    new FoodShoppingListEntity.Builder()
                        ...
                        .build())
                .build());

当服务收到请求时，会在一个事务内执行以下操作

• 删除开发人员合作伙伴的现有 FoodShoppingList 数据。
• 解析请求中的数据并将其存储在更新的购物清单集群中。

如果出现错误，整个请求将被拒绝，并且将保留现有状态。

publishShoppingReorderCluster

此 API 用于发布一个 ShoppingReorderCluster 对象。

client.publishShoppingReorderCluster(
            PublishShoppingReorderClusterRequest.Builder()
                .setReorderCluster(
                    ShoppingReorderCluster.Builder()
                        ...
                        .build())
                .build())

client.publishShoppingReorderCluster(
            new PublishShoppingReorderClusterRequest.Builder()
                .setReorderCluster(
                    new ShoppingReorderCluster.Builder()
                        ...
                        .build())
                .build());

当服务收到请求时，会在一个事务内执行以下操作

• 删除开发人员合作伙伴的现有 ShoppingReorderCluster 数据。
• 解析请求中的数据并将其存储在更新的重新排序集群中。

如果出现错误，整个请求将被拒绝，并且将保留现有状态。

publishShoppingOrderTrackingCluster

此 API 用于发布一个 ShoppingOrderTrackingCluster 对象。

client.publishShoppingOrderTrackingCluster(
            PublishShoppingOrderTrackingClusterRequest.Builder()
                .setShoppingOrderTrackingCluster(
                    ShoppingOrderTrackingCluster.Builder()
                        ...
                        .build())
                .build())

client.publishShoppingOrderTrackingCluster(
            new PublishShoppingOrderTrackingClusterRequest.Builder()
                .setShoppingOrderTrackingCluster(
                    new ShoppingOrderTrackingCluster.Builder()
                        ...
                        .build())
                .build());

当服务收到请求时，会在一个事务内执行以下操作

• 删除开发人员合作伙伴的现有 ShoppingOrderTrackingCluster 数据。
• 解析请求中的数据并将其存储在更新的购物订单跟踪集群中。

如果出现错误，整个请求将被拒绝，并且将保留现有状态。

publishUserAccountManagementRequest

此 API 用于发布登录卡片。登录操作将用户引导至应用程序的登录页面，以便应用程序可以发布内容（或提供更多个性化的内容）。

以下元数据是登录卡片的一部分：

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              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(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

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 更新发布状态。这很重要，因为

• 在所有情况下提供状态，即使在内容发布时（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 建议发布登录卡片。如果由于任何原因提供者无法发布登录卡片，则我们建议使用状态代码NOT_PUBLISHED_REQUIRES_SIGN_IN调用updatePublishStatus API。

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

deleteRecommendationClusters

此 API 用于删除推荐集群的内容。

client.deleteRecommendationClusters()

client.deleteRecommendationClusters();

当服务收到请求时，它会从推荐集群中删除现有数据。如果出现错误，整个请求将被拒绝，并且将保留现有状态。

deleteFeaturedCluster

此 API 用于删除特色集群的内容。

client.deleteFeaturedCluster()

client.deleteFeaturedCluster();

当服务收到请求时，它会从特色集群中删除现有数据。如果出现错误，整个请求将被拒绝，并且将保留现有状态。

deleteShoppingCartCluster

此 API 用于删除购物车集群的内容。

client.deleteShoppingCartCluster()

client.deleteShoppingCartCluster();

当服务收到请求时，它会从购物车集群中删除现有数据。如果出现错误，整个请求将被拒绝，并且将保留现有状态。

deleteShoppingListCluster

此 API 用于删除购物清单集群的内容。

client.deleteShoppingListCluster()

client.deleteShoppingListCluster();

当服务收到请求时，它会从购物清单集群中删除现有数据。如果出现错误，整个请求将被拒绝，并且将保留现有状态。

deleteShoppingReorderCluster

此 API 用于删除购物重新排序集群的内容。

client.deleteShoppingReorderCluster()

client.deleteShoppingReorderCluster();

当服务收到请求时，它会从购物重新排序集群中删除现有数据。如果出现错误，整个请求将被拒绝，并且将保留现有状态。

deleteShoppingOrderTrackingCluster

此 API 用于删除购物订单跟踪集群的内容。

client.deleteShoppingOrderTrackingCluster()

client.deleteShoppingOrderTrackingCluster();

当服务收到请求时，它会从购物订单跟踪集群中删除现有数据。如果出现错误，整个请求将被拒绝，并且将保留现有状态。

deleteUserManagementCluster

此 API 用于删除 UserAccountManagement 集群的内容。

client.deleteUserManagementCluster()

client.deleteUserManagementCluster();

当服务收到请求时，它会从 UserAccountManagement 集群中删除现有数据。如果出现错误，整个请求将被拒绝，并且将保留现有状态。

deleteClusters

此 API 用于删除给定集群类型的内容。

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      ...
      .build())

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                ...
                .build());

当服务收到请求时，它会从与指定集群类型匹配的所有集群中删除现有数据。客户端可以选择传递一个或多个集群类型。如果出现错误，整个请求将被拒绝，并且将保留现有状态。

错误处理

强烈建议监听发布 API 的任务结果，以便可以采取后续操作来恢复并重新提交成功的任务。

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
            }
          }
        }
      }

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 返回。

步骤 3：处理广播意图

除了通过作业进行内容发布 API 调用外，还需要设置一个 BroadcastReceiver 来接收内容发布请求。

广播意图的主要目的是重新激活应用程序并强制数据同步。广播意图并非旨在频繁发送。仅在 Engage 服务确定内容可能已过时（例如，一周前）时才会触发它。这样，即使应用程序长时间未执行，用户也可以更加确信拥有新鲜的内容体验。

必须通过以下两种方式设置 BroadcastReceiver

• 使用 Context.registerReceiver() 动态注册 BroadcastReceiver 类的实例。这使仍然驻留在内存中的应用程序能够进行通信。

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION
  // broadcast is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is
  // received
  // Trigger shopping cart cluster publish when PUBLISH_SHOPPING_CART broadcast
  // is received
  // Trigger shopping list cluster publish when PUBLISH_SHOPPING_LIST broadcast
  // is received
  // Trigger reorder cluster publish when PUBLISH_REORDER_CLUSTER broadcast is
  // received
  // Trigger shopping order tracking cluster publish when
  // PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER 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 Shopping Cart Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_SHOPPING_CART))

// Register Shopping List Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_SHOPPING_LIST))

// Register Reorder Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_REORDER_CLUSTER))

// Register Shopping Order Tracking Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER))
}

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 shopping cart cluster publish when PUBLISH_SHOPPING_CART broadcast is
// received

// Trigger shopping list cluster publish when PUBLISH_SHOPPING_LIST broadcast is
// received

// Trigger reorder cluster publish when PUBLISH_REORDER_CLUSTER broadcast is
// received

// Trigger reorder cluster publish when PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER
// 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 Shopping Cart Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_SHOPPING_CART));

// Register Shopping List Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_SHOPPING_LIST));

// Register Reorder Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_REORDER_CLUSTER));

// Register Shopping Order Tracking Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER));

}

• 在您的 AndroidManifest.xml 文件中使用 <receiver> 标签静态声明实现。这允许应用程序在未运行时接收广播意图，并且还允许应用程序发布内容。

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.shopping.PUBLISH_SHOPPING_CART" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.shopping.PUBLISH_SHOPPING_LIST" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.shopping.PUBLISH_REORDER_CLUSTER" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.shopping.PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER" />
      </intent-filter>
   </receiver>
</application>

服务将发送以下 意图

• com.google.android.engage.action.PUBLISH_RECOMMENDATION 建议在收到此意图时启动 publishRecommendationClusters 调用。
• com.google.android.engage.action.PUBLISH_FEATURED 建议在收到此意图时启动 publishFeaturedCluster 调用。
• com.google.android.engage.action.shopping.PUBLISH_SHOPPING_CART 建议在收到此意图时启动 publishShoppingCart 调用。
• com.google.android.engage.action.shopping.PUBLISH_SHOPPING_LIST 建议在收到此意图时启动 publishShoppingList 调用。
• com.google.android.engage.action.shopping.PUBLISH_REORDER_CLUSTER 建议在收到此意图时启动 publishReorderCluster 调用。
• com.google.android.engage.action.shopping.PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER 建议在收到此意图时启动 publishShoppingOrderTrackingCluster 调用。

集成工作流程

有关完成集成后验证集成的分步指南，请参见 Engage 开发人员集成工作流程。

常见问题解答

有关常见问题解答，请参见 Engage SDK 常见问题解答。

联系我们

如有任何问题，请在集成过程中联系 [email protected]。我们的团队会尽快回复。

下一步

完成此集成后，您的下一步操作如下

• 发送电子邮件至 [email protected] 并附加您已集成的 APK，以便 Google 进行测试。
• Google 会进行验证并进行内部审查，以确保集成按预期工作。如果需要更改，Google 会与您联系并提供必要的详细信息。
• 测试完成后，如果不需要更改，Google 会与您联系，通知您可以开始将更新的集成 APK 发布到 Play 商店。
• Google 确认您的更新的 APK 已发布到 Play 商店后，您的推荐、精选、购物车、购物清单、重新排序群集和购物订单跟踪群集可能会发布并对用户可见。