Show Menu
화제×

Adobe Experience Platform ID 서비스 메서드

다음은 Android 라이브러리에서 제공하는 Experience Cloud ID 메서드입니다.
현재 SDK는 Analytics, Target, Audience Manager 및 Adobe Experience Platform ID 서비스 등 여러 Adobe Experience Cloud 솔루션을 지원합니다.
메서드에는 솔루션에 따라 접두사가 추가됩니다. 예를 들면 Experience Cloud ID 메서드에는 visitor 접두사가 추가됩니다. 자세한 내용은 Experience Cloud ID 구성 을 참조하십시오.
  • public static String appendToURL(최종 문자열 URL)
    Adobe JavaScript 라이브러리에서 사용할 수 있도록 URL 문자열에 Adobe 방문자 데이터를 추가합니다. 이 메서드를 사용하려면 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();
      
      
      이 메서드로 인해 네트워크 호출이 차단될 수 있으므로 UI 스레드에서 호출해서는 안 됩니다 .
  • 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 ID 서비스 메서드 를 참조하십시오.
    • 다음은 이 메서드에 대한 구문입니다.
      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); 
    } 
}