로딩중입니다
애드브릭스 페이스북 광고 설정 : iOS, 유니티
3/9/2016 2:27:48 PM

애드브릭스 페이스북 광고 설정 : iOS, 유니티


애드브릭스을 통해 페이스북 모바일 앱 인스톨(MAIA), 모바일 앱 참여(MAEA) 광고를 설정하기 위한 가이드입니다.



*주의사항

    - 이 기능을 사용하기 위해서는 반드시 IGAW공통연동이 먼저 진행되어야 합니다. [IGAW공통연동 : iOS] [IGAW 공통 연동 : 유니티 iOS]

    - 이 기능을 사용하기 위해서는 앱 인스톨 광고의 경우 IgaworksCore ver 2.2.2 이상, 앱 참여 광고의 경우 IgaworksCore ver 2.3.2 이상이 필요합니다.

    - 이 기능을 사용하기 위해서는 IDFA 값을 등록해야 합니다. [IGAW 애플 IDFA 등록 : iOS] [IGAW 애플 IDFA 등록 : 유니티 iOS] 

* 업데이트 안내 *
IgaworksCore 2.2.2 에서는 Facebook SDK를 함께 사용하는 경우에 대한 연동 방식을 추가하였습니다.

코드연동
1. URL Scheme Path 세팅

페이스북 광고 설정을 위해서는 URL Scheme 설정이 필요합니다. [How to set Deeplink?]

앱 내 특정 위치로 랜딩될 수 있는 path값(커스텀 쿼리 값)이 세팅되어 있어야 합니다.

* 광고에서 사용할 애드브릭스 트래킹링크 생성 시에 딥링크 스키마와 랜딩 페이지의 path 값이 필요합니다.



2. 딥링크 정보 전달하기

딥링크가 설정된 페이스북 광고를 통해 앱이 오픈되면, 딥링크 path 정보가 전달됩니다. 전달받은 딥링크 path 정보를 SDK에 전달합니다.


#Case1. Facebook SDK를 연동하지 않았을 때

페이스북 SDK를 연동하지 않고, IGAWorks의 SDK만 사용할 때에는 다음의 가이드를 따릅니다.

  • iOS
      @interface AppDelegate () <IgaworksCoreDelegate>

@end

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

	[IgaworksCore shared].delegate = self;

	return YES;
}

#pragma mark - IgaworksCoreDelegate
//open url with deep link
- (void)didReceiveDeeplink:(NSString *)deepLink
{
    if (deepLink.length > 0) {
        [[UIApplication sharedApplication] openURL:[NSURL URLWithString:deepLink]];
    }
}
  • 유니티
public class IgaworksSample : MonoBehaviour
{
	void Start ()
	{
		IgaworksCorePluginIOS.SetIgaworksCoreDelegate();
	}
	
	void Awake()
	{
		// add handle deep link event
		IgaworksCorePluginIOS.didReceiveDeeplink += HandleDidReceiveDeeplink;
	}
	
	void OnDisable()
	{
		IgaworksCorePluginIOS.didReceiveDeeplink -= HandleDidReceiveDeeplink;
	}

	// handle deep link event
	public void HandleDidReceiveDeeplink(string deepLink)
	{
		Debug.Log ("IgaworksSample : HandleDidReceiveDeeplink " + deepLink);

		// url open
	}

}



#Case2. Facebook SDK를 연동하는 경우

페이스북 SDK의 FetchDeferredAppLinkData API의 사용 여부에 따라 아래 2가지 케이스가 있으니, 각 케이스에 해당하는 가이드를 따릅니다.

* 아래 가이드를 적용하기 위해서는 Core2.2.2 버전 이상을 사용하여야 합니다. [다운로드 센터 바로가기]


case2-1. Facebook SDK의 FetchDeferredAppLinkData API를 사용할 경우

페이스북 SDK 의 FetchDeferredAppLinkData API를 사용할 때에는 다음의 가이드를 따릅니다.

  • iOS ( setReferralUrl API )

@interface AppDelegate () <IgaworksCoreDelegate>


@end

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

	[IgaworksCore shared].delegate = self;
      if (launchOptions[UIApplicationLaunchOptionsURLKey] == nil) {
        [FBSDKAppLinkUtility fetchDeferredAppLink:^(NSURL *url, NSError *error) {
          if (error) {
                NSLog(@"Received error while fetching deferred app link %@", error);
            }
            if (url) {
                NSLog(@"Facebook SDK: Received fetching deferred app link %@", url);
               [IgaworksCore setReferralUrl:url];
            }
        }];
    }
	return YES;
}

#pragma mark - IgaworksCoreDelegate
//open url with deep link
- (void)didReceiveDeeplink:(NSString *)deepLink
{
    NSLog(@"Received deeplink url %@", deepLink);
}

  • 유니티 ( SetReferralUrl API )
FB.Mobile.FetchDeferredAppLinkData(DeepLinkCallback);

void DeepLinkCallback(IAppLinkResult result)
{
    if (!String.IsNullOrEmpty(result.Url))
    {
        IgaworksCorePluginIOS.SetReferralUrl(result.Url);
    }    
}


case2-2. Facebook SDK의 FetchDeferredAppLinkData API를 사용하지 않는 경우

페이스북SDK의 FetchDeferredAppLinkData API를 사용하지 않을 때에는 #Case1의 가이드를 따릅니다.



페이스북 광고 세팅 및 테스트

페이스북 광고를 위한 애드브릭스 트래킹링크 생성 방법 및 페이스북 광고 세팅, 테스트 방법은 이용방법 안내 아티클에서 자세히 안내하고 있습니다.


다음 아티클을 참고해주세요.

[페이스북 광고 설정방법]