Show Menu
主題×

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 設定
  • 公用靜態字串 appendToURL (最後字串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); 
    } 
}