iOS용 Target 메서드

다음은 iOS 라이브러리에서 제공하는 Adobe Target 메서드 목록입니다.

현재 SDK는 Analytics, Target, Audience Manager 및 Adobe Experience Platform ID 서비스 등 여러 Adobe Experience Cloud 솔루션을 지원합니다. 메서드에는 솔루션에 따라 접두사가 붙습니다. 예를 들어 메서드의 경우 앞에 targettarget이 붙습니다.

팁

라이프사이클 지표는 각 mbox 로드에 매개 변수로 전송됩니다. 자세한 내용은 라이프사이클 지표를 참조하십시오. didFinishLaunching 위임 메서드 내에서 Target 요청을 보내는 경우 Target 구현 코드 앞에 [ADBMobile trackAction:data:] 또는 [ADBMobile trackState:data:] 호출을 추가합니다. 이렇게 하면 Target 요청에 전체 라이프사이클 데이터가 포함됩니다.

클래스 참조: ADBTargetLocationRequest

속성

NSString *name; 
NSString *defaultContent; 
NSMutableDictionary *parameters;

문자열 상수

팁

다음 상수는 사용자 지정 매개 변수에 대한 키를 설정할 때 쉽게 사용됩니다.

NSString *const ADBTargetParameterOrderId; 
NSString *const ADBTargetParameterOrderTotal; 
NSString *const ADBTargetParameterProductPurchasedId; 
NSString *const ADBTargetParameterCategoryId; 
NSString *const ADBTargetParameterMbox3rdPartyId; 
NSString *const ADBTargetParameterMboxPageValue; 
NSString *const ADBTargetParameterMboxPc; 
NSString *const ADBTargetParameterMboxSessionId; 
NSString *const ADBTargetParameterMboxHost;
중요

  • 4.14.0 이전 버전의 SDK를 사용하는 경우 입력 매개 변수에서 매개 변수 제한 사항을 참조하십시오.

  • 4.14.0 이상 버전의 SDK를 사용하는 경우 배치 입력 매개 변수에서 매개 변수 제한 사항을 참조하십시오.

메서드에서 사용할 수 있습니다

  • targetLoadRequest:callback

    구성된 Target 서버에 request를 보내고 차단 callback에서 생성된 오퍼의 문자열 값을 반환합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      + (void) targetLoadRequest:(ADBTargetLocationRequest *)request
                  callback:(void (^)(NSString *content))callback;

    • 다음은 이 메서드의 코드 샘플입니다.

      [ADBMobile targetLoadRequest:myRequest
                    callback:^(NSString *content) {
                      // do something with content
                    }];

  • :defaultContent::orderParameters::requestLocationParameters:targetLoadRequestWithNameProfileParameterboxParameterscallback:

    구성된 Target 서버에 request를 보내고 차단 콜백에서 생성된 오퍼의 문자열 값을 반환합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      + (void) targetLoadRequestWithName:(nullable NSString *)name
                    defaultContent:(nullable NSString *)defaultContent
                profileParameters:(nullable NSDictionary *)profileParameters
                  orderParameters:(nullable NSDictionary *)orderParameters
                   mboxParameters:(nullable NSDictionary *)mboxParameters
          requestLocationParameters:(nullable NSDictionary *)requestLocationParameters
                           callback:(nullable void (^)(NSString
                           * __nullable content))callback;

    • 반환: 해당 없음

    • 다음은 이 메서드에 대한 매개 변수입니다.

      • name

        검색할 Target mbox/위치의 이름입니다.

        • 유형: NSString*

      • defaultContent

        Target 서버에 도달할 수 없거나 사용자가 캠페인에 적합하지 않은 경우 콜백에서 반환되는 값입니다.

        • 유형: NSString*

      • profileParameters

        이 사전의 값은 Target에 전송되는 요청의 "profileParameters" 개체에 삽입합니다.

        • 유형: NSDictionary*

      • orderParameters

        이 사전의 값은 Target에 전송되는 요청의 "order" 개체에 삽입합니다.

        • 유형: NSDictionary

      • mboxParameters

        이 사전의 값은 Target에 전송되는 요청의 "mboxParameters" 개체에 삽입합니다.

        • 유형: NSDictionary*

      • requestLocationParameters

        이 사전의 값은 Target에 전송되는 요청의 "requestLocation" 개체에 삽입됩니다.

        유형: NSDictionary*

      • callback

        이 메서드는 Target 서버의 오퍼 콘텐츠를 사용하여 호출됩니다. Target 서버에 연결할 수 없거나 사용자가 캠페인에 적합하지 않으면 defaultContent가 반환됩니다.
        유형: Function

    • 다음은 이 메서드의 코드 샘플입니다.

      [ADBMobile targetLoadRequestWithName:@"myHeroBanner"
                      defaultContent:@"defaultHeroBanner.png"
                  profileParameters:@{@"age":@"20-29"}
                    orderParameters:nil
                     mboxParameters:@{@"customParam":@"customValue"}
          requestLocationParameters:@{@"host":@"my.hostname.com"}
                           callback:^(NSString *content){
                             // do something with content
                             myImageView.image = [UIImage imageNamed:content];
                           }];

      기본 Target API에 대한 자세한 내용은 Target API 참조를 참조하십시오.

  • :defaultContent::orderParameters:targetLoadRequestWithNameprofileParameterboxParameters:callback

    구성된 Target 서버에 요청을 보내고 차단 callback에서 생성된 오퍼의 문자열 값을 반환합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      + (void) targetLoadRequestWithName:(nullable NSString *)name
                    defaultContent:(nullable NSString *)defaultContent
                profileParameters:(nullable NSDictionary *)profileParameters
                  orderParameters:(nullable NSDictionary *)orderParameters
                   mboxParameters:(nullable NSDictionary *)mboxParameters
                         callback:(nullable void (^)(NSString * __nullable content))callback;

    • 다음은 이 메서드의 코드 샘플입니다.

      [ADBMobile targetLoadRequestWithName:@"mboxName"
                      defaultContent:@"defaultContent"
                   profileParameters:{@"profile-parameter-key": @"profile-parameter-value"}
                     orderParameters:@{@"order-parameter-key": @"order-parameter-value"}
                      mboxParameters:@{@"mbox-parameter-key": @"mbox-parameter-value"}
                             callback:^(NSString * content) {
                                     //do something with content 
                           }
                         }];

  • targetCreateOrderConfirmRequestWithName:orderId:orderTotal:​productPurchasedId:parameters

    ADBTargetLocationRequest를 생성합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      + (ADBTargetLocationRequest *)
targetCreateOrderConfirmRequestWithName:(NSString *)name
                                orderId:(NSString *)orderId
                            orderTotal:(NSString *)orderTotal
                    productPurchasedId:(NSString *)productPurchasedId
                        parameters:(NSDictionary *)parameters;

  • targetCreateRequestWithName:defaultContent:parameters

    주어진 매개 변수로 ADBTargetLocationRequest 개체를 만드는 편의 생성자입니다.

    • 다음은 이 메서드에 대한 구문입니다.

      + (ADBTargetLocationRequest *)
targetCreateRequestWithName:(NSString *)name
                     defaultContent:(NSString *)defaultContent
                         parameters:(NSDictionary *)parameters;

    • 다음은 이 메서드의 코드 샘플입니다.

      ADBTargetLocationRequest *myRequest =  
[ADBMobile targetCreateRequestWithName:@"heroBanner"
                        defaultContent:@"default.png"
                            parameters:nil];

  • targetThirdPartyID

    타사 ID를 반환합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      + (nullable NSString *) targetThirdPartyID;

    • 다음은 이 메서드의 코드 샘플입니다.

      NSString *thirdPartyId = [ADBMobile targetThirdPartyID];

  • targetSetThirdPartyID

    타사 ID를 설정합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      + (void) targetSetThirdPartyID:(nullable NSString *)thirdPartyID;

    • 다음은 이 메서드의 코드 샘플입니다.

      [ADBMobile targetSetThirdPartyID:@"thirdPartyID"];

  • targetClearCookies

    앱에서 모든 타겟 쿠키를 지웁니다.

    팁

    SDK 버전 4.10.0부터 Target에서 더 이상 쿠키를 사용하지 않습니다. 이 메서드는 thirdPartyID 및 sessionID를 재설정합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      + (void) targetClearCookies;

    • 다음은 이 메서드의 코드 샘플입니다.

      [ADBMobile targetClearCookies];

  • targetPcID

    PcID를 반환합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      + (nullable NSString *) targetPcID;

    • 다음은 이 메서드의 코드 샘플입니다.

      NSString *myTargetPcID = [ADBMobile targetPcID];

  • targetSessionID

    SessionID를 반환합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      + (nullable NSString *) targetPcID;

    • 다음은 이 메서드의 코드 샘플입니다.

      NSString *myTargetSessionID = [ADBMobile targetSessionID];

예

// make your request 
ADBTargetLocationRequest *myRequest =  
 [ADBMobile targetCreateRequestWithName:@"heroBanner"  
                         defaultContent:@"default.png"  
                          parameters:nil]; 
// load your request 
[ADBMobile targetLoadRequest:myRequest  
                    callback:^(NSString *content) { 
                        // do something with content 
                        heroImage.image = [UIImage imageNamed:content];
                    }];

이 페이지에서는