Adobe Experience Platform Identity Service 方法

以下是 Android 库提供的 Experience Cloud ID 方法。

SDK 当前支持多个 Adobe Experience Cloud 解决方案,包括 Analytics、Target、Audience Manager 和 Adobe Experience Platform Identity Service。

方法将根据解决方案来添加前缀。例如,Experience Cloud ID 方法的前缀为 visitor。有关更多信息,请参阅 Experience Cloud ID 配置

  • public static String appendToURL(final String URL)

    将 Adobe 访客数据附加到 URL 字符串以用于 Adobe JavaScript 库。您必须拥有 Mobile SDK 4.12 及更高版本才能使用此方法。有关更多信息,请参阅Adobe Experience Cloud Identity Service文档中的appendVisitorIDsTo

    重要

    此方法可能导致网络调用受阻。请不要在时间敏感的线程中调用此方法。

    • 以下是此方法的语法:

      public static String appendToURL(final String URL) 
      

      将在其中附加访客信息的必需 URL 字符串。

    • 以下是此方法的代码示例:

      String urlSample = "https://example.com";`
              String urlWithAdobeVisitorInfo = Visitor.appendToURL(urlSample);
      
              Intent(Intent.ACTION_VIEW);
              i.setData(Uri.parse(urlWithAdobeVisitorInfo));
              startActivity(i);
      
  • getMarketingCloudId

    从访客 ID 服务中检索 Experience Cloud ID。

    • 以下是此方法的语法:

      public static String getMarketingCloudId(); 
      
    • 以下是此方法的代码示例:

      String = Visitor.getMarketingCloudId();
      
      重要

      此方法可能导致网络调用受阻,因此​不应​从用户界面线程中对其进行调用。

  • syncIdentifiers

    使用该 Experience Cloud ID,您可以设置其他可与每个访客关联的客户 ID。访客 API 接受同一访客具有多个客户 ID,并且使用客户类型标识符区分不同客户 ID 的适用范围。此方法对应于 JavaScript 库中的 setCustomerIDs

    • 以下是此方法的语法:

      public static void syncIdentifiers(Map<String, String> identifiers); 
      
    • 以下是此方法的代码示例:

      Map<String,String> identifiers = new HashMap<String, String>();
      identifiers.put("idType", "idValue");
      Visitor.syncIdentifiers(identifiers);
      
  • syncIdentifier

    将提供的标识符类型和值同步到访客 ID 服务。

    传入 authenticationState 以作为下列值之一:

    • VisitorID.VisitorIDAuthenticationState.VISITOR_ID_AUTHENTICATION_STATE_UNKNOWN

    • VisitorID.VisitorIDAuthenticationState.VISITOR_ID_AUTHENTICATION_STATE_AUTHENTICATED

    • VisitorID.VisitorIDAuthenticationState.VISITOR_ID_AUTHENTICATION_STATE_LOGGED_OUT

    • 以下是此方法的语法:

      public static void syncIdentifier(final String identifierType, final String identifier, final VisitorID.VisitorIDAuthenticationState authenticationState);
      
    • 以下是此方法的代码示例:

      Visitor.syncIdentifier("myIdType", "valueForUser", VisitorID.VisitorIDAuthenticationState.VISITOR_ID_AUTHENTICATION_STATE_LOGGED_OUT);
      
  • syncIdentifiers

    将提供的标识符同步到 ID 服务。

    传入 authenticationState 以作为下列值之一:

    • VisitorID.VisitorIDAuthenticationState.VISITOR_ID_AUTHENTICATION_STATE_UNKNOWN

    • VisitorID.VisitorIDAuthenticationState.VISITOR_ID_AUTHENTICATION_STATE_AUTHENTICATED

    • VisitorID.VisitorIDAuthenticationState.VISITOR_ID_AUTHENTICATION_STATE_LOGGED_OUT

    • 以下是此方法的语法:

      public static void syncIdentifiers(final Map<String String> identifiers, final VisitorID.VisitorIDAuthenticationState authenticationState);
      
    • 以下是此方法的代码示例:

      Map<String, String> identifiers = new HashMap<String, String>();
          identifiers.put("myIdType", "valueForUser"); Visitor.syncIdentifiers(identifiers,
      VisitorID.VisitorIDAuthenticationState.VISITOR_ID_AUTHENTICATION_STATE_AUTHENTICATED); 
      
  • getIdentifiers

    检索只读 ADBVisitorID 对象的列表。

    • 以下是此方法的语法:

      public static List<VisitorID> getIdentifiers(); 
      
    • 以下是此方法的代码示例:

      List<VisitorID> myVisitorIDs = Visitor.getIdentifiers(); 
      
  • getUrlVariablesAsync

    在版本 4.16.0 中引入,此方法会返回一个格式正确的字符串,其中包含访客 ID 服务 URL 变量。有关如何使用此方法的更多信息,请参阅 Adobe Experience Platform Identity Service 方法

    • 以下是此方法的语法:

      public static void getUrlVariablesAsync(final VisitorCallback callback);
      
    • 以下是此方法的代码示例:

      final String urlString = https://www.mydomain.com/index.php; 
      Visitor.getUrlVariablesAsync(new Visitor.VisitorCallback(){ 
        @Override 
        public void call(String urlVariables) { 
            final String urlStringWithVisitorData = String.format("%s?%s", urlString, urlVariables); 
            ...
        } 
      });
      

公共方法

public class VisitorID { 
    public final String idOrigin; 
    public final String idType; 
    public final String id; 
    public VisitorIDAuthenticationState authenticationState; 
 
    public enum VisitorIDAuthenticationState { 
         VISITOR_ID_AUTHENTICATION_STATE_UNKNOWN(0), 
         VISITOR_ID_AUTHENTICATION_STATE_AUTHENTICATED(1), 
         VISITOR_ID_AUTHENTICATION_STATE_LOGGED_OUT(2); 
    } 
}

在此页面上