Support setAdvertiserTrackingEnabled on iOS (#47)

* iOS implementation of advertiser tracking

* Advertiser tracking flag is iOS-only

* Add description of ATE functions

* Rename functions for consistency, and add to header

* Fix typo in docs

Author: dri-richard

facebook/api/facebook.script_api

@@ -233,6 +233,22 @@
           Facebook Canvas platform, therefore this function has no effect on Facebook
           Canvas.
 
+#*****************************************************************************************************
+
+  - name: enable_advertiser_tracking
+    type: function
+    desc: Enable advertiser tracking
+          This function will set AdvertiserTrackingEnabled (the 'ATE' flag) to true on iOS, to inform
+          Audience Network to use the data to deliver personalized ads for users on iOS 14 and above.
+
+#*****************************************************************************************************
+
+  - name: disable_advertiser_tracking
+    type: function
+    desc: Disable advertiser tracking
+          This function will set AdvertiserTrackingEnabled (the 'ATE' flag) to false on iOS, to inform
+          Audience Network not to use the data to deliver personalized ads for users on iOS 14 and above.
+
 #*****************************************************************************************************
 
   - name: show_dialog

facebook/src/facebook.cpp

@@ -122,6 +122,26 @@ static int Facebook_Init(lua_State* L)
     return 0;
 }
 
+static int Facebook_EnableAdvertiserTracking(lua_State* L)
+{
+#if defined(DM_PLATFORM_IOS) 
+    CHECK_FACEBOOK_INIT(L);
+    return Platform_FacebookEnableAdvertiserTracking(L);
+#else
+    return 0;
+#endif
+}
+
+static int Facebook_DisableAdvertiserTracking(lua_State* L)
+{
+#if defined(DM_PLATFORM_IOS) 
+    CHECK_FACEBOOK_INIT(L);
+    return Platform_FacebookDisableAdvertiserTracking(L);
+#else
+    return 0;
+#endif
+}
+
 static const luaL_reg Facebook_methods[] =
 {
     {"init", Facebook_Init},
@@ -135,6 +155,8 @@ static const luaL_reg Facebook_methods[] =
     {"show_dialog", Facebook_ShowDialog},
     {"login_with_permissions", Facebook_LoginWithPermissions},
     {"deferred_deep_link", Facebook_FetchDeferredAppLinkData},
+    {"enable_advertiser_tracking", Facebook_EnableAdvertiserTracking},
+    {"disable_advertiser_tracking", Facebook_DisableAdvertiserTracking},
     {0, 0}
 };
 

facebook/src/facebook_ios.mm

@@ -524,6 +524,20 @@ int Platform_FacebookDisableEventUsage(lua_State* L)
     return 0;
 }
 
+int Platform_FacebookEnableAdvertiserTracking(lua_State* L)
+{
+    [FBSDKSettings setAdvertiserTrackingEnabled :true];
+
+    return 0;
+}
+
+int Platform_FacebookDisableAdvertiserTracking(lua_State* L)
+{
+    [FBSDKSettings setAdvertiserTrackingEnabled :false];
+
+    return 0;
+}
+
 int Platform_FacebookShowDialog(lua_State* L)
 {
     int top = lua_gettop(L);

facebook/src/facebook_private.h

@@ -142,6 +142,8 @@ int Platform_FacebookPermissions(lua_State* L);
 int Platform_FacebookPostEvent(lua_State* L);
 int Platform_FacebookEnableEventUsage(lua_State* L);
 int Platform_FacebookDisableEventUsage(lua_State* L);
+int Platform_FacebookEnableAdvertiserTracking(lua_State* L);
+int Platform_FacebookDisableAdvertiserTracking(lua_State* L);
 int Platform_FacebookShowDialog(lua_State* L);
 int Platform_FacebookLoginWithPermissions(lua_State* L, const char** permissions, uint32_t permission_count, int audience, dmScript::LuaCallbackInfo* callback);
 int Platform_FetchDeferredAppLinkData(lua_State* L, dmScript::LuaCallbackInfo* callback);