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 及更高版本才能使用此方法。有关更多信息,请参阅附加访客 ID 辅助函数

    重要

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

    • 以下是此方法的语法:

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

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now