광고 요청 정보

GFPUserParam을 통해 전달 가능한 정보들

GFPUserParam을 통해 유저 타게팅에 사용되는 정보를 설정할 수 있습니다. (선택사항)

데모(성별,나이)와 기타 부가정보 등을 제공하면, 광고 타게팅 효과를 높일 수 있습니다. GFPAdParam 을 통해 전달되는 정보와는 달리 유저 별로 고정되어 있는 값들로, 앱의 전역 범위에서 설정됩니다.

GFPUserParam.h 참고

• yearOfBirth : 출생년도
• gender : 성별
• userCountryCode : 지역코드 ("Country"와는 다른 param)
• userID : 유저 식별값
• contentId : 네이버 로그인 API에서 제공하는 Content ID

Swift

let userParam = GFPAdManager.userParam() ?? GFPUserParam()
userParam.gender = .female
userParam.yearOfBirth = 1995
userParam.userCountryCode = "KR"
userParam.userID = "abcd"
userParam.contentId = "my-content-id"
GFPAdManager.setUserParam(userParam)

Objective-C

GFPUserParam *userParam;
GFPUserParam *userParam;
if (GFPAdManager.userParam != nil) {
    userParam = GFPAdManager.userParam;
} else {
    userParam = [[GFPUserParam alloc] init];
}
userParam.gender = GFPUserParamGenderTypeFemale;
userParam.yearOfBirth = 1995;
userParam.userCountryCode = @"KR";
userParam.userID = @"abcd";
userParam.contentId = @"my-content-id";
[GFPAdManager setUserParam: userParam];

Year of Birth

(optional) Integer 값으로 출생년도 또는 나이에 해당됩니다.

Swift

let userParam = GFPUserParam()
...
userParam.yearOfBirth = 1995
...

Objective-C

GFPUserParam * userParam = [[GFPUserParam alloc] init];
...
userParam.yearOfBirth = 1995;
...

Country

(optional) User 의 용자의 국적(거주지)에 대한 값에 해당됩니다. ISO 3166-1 alpha-2 에 해당하는 값을 할당합니다.

Swift

let userParam = GFPUserParam()
...
userParam.userCountryCode = "KO"
...

Objective-C

GFPUserParam * userParam = [[GFPUserParam alloc] init];
...
userParam.userCountryCode = @"KO";
...

Gender

(optional) User 의 성별에 해당됩니다.

아래 GFPUserParamGenderType Enum 에 선언된 값 중 하나를 선택해서 할당합니다.

Swift

typedef NS_ENUM(NSInteger, GFPUserParamGenderType) {
    GFPUserParamGenderTypeMale = 1,   // 남자
    GFPUserParamGenderTypeFemale = 2, // 여자
    GFPUserParamGenderTypeOther = 3,  // 모름
};

let userParam = GFPUserParam()
...
userParam = .female
...

Objective-C

typedef NS_ENUM(NSInteger, GFPUserParamGenderType) {
    GFPUserParamGenderTypeMale = 1,   // 남자
    GFPUserParamGenderTypeFemale = 2, // 여자
    GFPUserParamGenderTypeOther = 3,  // 모름
};

GFPUserParam *userParam = [[GFPUserParam alloc] init];
...
userParam = GFPUserParamGenderTypeFemale;
...

User ID

(optional) 서비스내 유저 식별 값을 할당합니다.

Swift

let userParam = GFPUserParam()
...
userParam.userID = "abcd"
...

Objective-C

GFPUserParam * userParam = [[GFPUserParam alloc] init];
...
userParam.userID = @"abcd";
...

GFPAdParam을 통해 전달 가능한 정보들

GFPAdParam을 통해 광고 요청시 공통으로 정보를 함께 전달할 수 있습니다. (선택사항)

커스텀 파라미터를 사용하면 GFP Admin에서 리포트를 받아보거나, 광고 송출 방법을 결정하는데도 활용할 수 있습니다.
헤더비딩 파라미터를 사용하여 PrebidMobile, APS(=Amazon Publisher Services)에서 제공하는 헤더비딩을 사용할 수 있습니다.

GFPAdParam.h 참고

• currentPageUrl: 현재 페이지를 나타내는 URL
• keywords : 컨텐츠를 설명하는 키워드 목록
• referrerPageUrl : Referrer URL
• opt-out : (0: 미설정, 1: 설정) (deprecated.)
• customUserParam : 직접 정의한 커스텀 파라미터
• prebidHBParam : PrebidMobile 헤더비딩 파라미터
• apsParam : Amazon 헤더비딩 파라미터

Swift

let adParam = GFPAdParam()
adParam.keywords = ["KWD_1", "KWD_2"]
adParam.currentPageUrl = "https://naver.com"
adParam.customUserParam = ["key1":"value1"]

Objective-C

GFPAdParam *adParam = [[GFPAdParam alloc] init];
adParam.keywords = @[@"KWD_1", @"KWD_2"];
adParam.currentPageUrl = @"https://naver.com";
adParam.customUserParam = @{@"key1": @"value1"};

Current Page URL

(optional) 현재 화면을 표현하는 page 의 url 에 해당됩니다.

해당 값은 타겟팅 목적의 parameter 로 외부 demand(광고사) 의 광고 요청시에 사용됩니다.

Swift

let adParam = GFPAdParam()
...
adParam.currentPageUrl = "https://naver.com"
...

Objective-C

GFPAdParam *adParam = [[GFPAdParam alloc] init];
...
adParam.currentPageUrl = @"https://naver.com";
...

Keyword

(optional) 현재 화면과 관련된 keyword 에 해당됩니다. Array<String> 형태로 복수개의 keyword 를 할당할 수 있습니다.

해당 값은 타겟팅 목적의 parameter 로 외부 demand 의 광고 요청시에 사용됩니다.

Swift

let adParam = GFPAdParam()
...
adParam.keywords = ["KWD_1", "KWD_2"]
...

Objective-C

GFPAdParam *adParam = [[GFPAdParam alloc] init];
...
adParam.keywords = @[@"KWD_1", @"KWD_2"];
...

Custom User Parameter

(optional) GFP admin 에서 사용되는 parameter 로 세부적인 타게팅 및 리포팅을 위해서 사용됩니다.

key와 value 모두 String으로 세팅되는 Dictionary 형태로 세팅하면 됩니다.

Swift

let adParam = GFPAdParam()
...
adParam.customUserParam = ["key1":"value1", "language":"ko"]
...

Objective-C

GFPAdParam *adParam = [[GFPAdParam alloc] init];
...
adParam.customUserParam = @{@"key1": @"value1", @"language":@"ko"};
...

Header Bidding Parameter

(Optional) HeaderBidding 파라미터를 이용하여 PrebidMobile, APS(=Amazon Publisher Services) 에서 제공하는 헤더비딩을 사용할 수 있습니다.

• prebidHBParam
  • PrebidMobile을 통해 얻은 정보를 설정합니다.
  • key 와 value 모두 String으로 세팅되는 Dictionary 입니다.
• apsParam (GFPAPSAdParam 참조)
  • APS를 통해 얻은 정보를 설정합니다. (crid, size, apsHBParam)

정보

PrebidMobile, APS를 이용한 헤더비딩 파라미터 설정 방법은 헤더 비딩를 참고해주세요.

광고 요청 Query

GFPAdParam 객체의 adCallQuery 메소드를 이용하여 광고 요청과 관련된 query를 획득 할 수 있습니다.

Swift

let adParam = GFPAdParam()
...
let query = adParam.adCallQuery(with: "adUnitId")
...

Objective-C

GFPAdParam *adParam = [[GFPAdParam alloc] init];
...
NSString *query = [adParam adCallQueryWith:@"adUnitId"];
...