본문으로 건너뛰기

광고 요청 정보

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

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

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

GFPUserParam.h 참고

  • yearOfBirth : 출생년도
  • gender : 성별
  • userCountryCode : 지역코드 ("Country"와는 다른 param)
  • userID : 유저 식별값
  • contentId : 네이버 로그인 API에서 제공하는 Content ID
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 값으로 출생년도 또는 나이에 해당됩니다.

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

Country​

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

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

Gender​

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

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

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

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

User ID​

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

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 헤더비딩 파라미터
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(광고사) 의 광고 요청시에 사용됩니다.

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

Keyword​

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

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

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

Custom User Parameter​

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

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

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를 이용한 헤더비딩 파라미터 설정 방법은 가이드를 참고해주세요.