IDGraph Android Tracking Code New - 修訂歷史

BrandonTeng 於 2024年10月23日 (三) 06:20

2024-10-23T06:20:13Z

←上個修訂		於 2024年10月23日 (三) 06:20 的修訂
行 5：		行 5：

	:第一個參數為Context		:第一個參數為Context
	:第二個參數請填入你的Profile ID (~~可向您的TAMedia窗口詢問~~)		:第二個參數請填入你的Profile ID (可向您的TAmedia窗口詢問)
	:第三個為boolean值，設為true時，每次回報會出現Toast訊息框以確認回報是否成功		:第三個為boolean值，設為true時，每次回報會出現Toast訊息框以確認回報是否成功
	<br>		<br>
行 13：		行 13：
	IDGraphTracker.getInstance().reportTrackLog(extraParams)		IDGraphTracker.getInstance().reportTrackLog(extraParams)
	</source>		</source>
	~~<br>~~
	<br>		<br>
	上述提及的函式，可參考下列方式加入您的專案		上述提及的函式，可參考下列方式加入您的專案
	*<~~big~~>~~<u>Without Application Class</u></big>~~		<source>
	:若APP專案未擁有自己的Application class，可以將追蹤碼放在自己的APP首頁，也就是第一個出現的Activity，透過此方式，每次APP重啟時都會觸發回報，程式碼如下:		override fun onCreate(savedInstanceState: Bundle?) {
	~~<b><MainActivity.java></b>~~		super.onCreate(savedInstanceState)
	~~public class MainActivity extends AppCompatActivity {~~		enableEdgeToEdge()
			fusedLocationClient = LocationServices.getFusedLocationProviderClient(this)
	~~private static final String PROFILE_ID = "<b><Your Profile ID></b>";~~
	~~private static final boolean isDebug = false;~~		setContent {

	~~@Override~~		var latitude by remember { mutableStateOf("") }
	~~protected void~~ onCreate(Bundle ~~savedInstanceState~~) {		var longitude by remember { mutableStateOf("") }
	super.onCreate(savedInstanceState);
	~~setContentView~~(R.~~layout.activity_main~~);		MainScreen(
			onRequestLocation = { requestLocationPermission { lon, lat ->
	~~// Initial~~		latitude = lat
	IDGraphTracker.getInstance().init(this, PROFILE_ID, ~~isDebug~~);		longitude = lon
	~~// Send Tracking Log~~		} },
	IDGraphTracker.getInstance().reportTrackLog();		onReportLocation = { lon, lat ->
			val extraParams = listOf(lon, lat)
			IDGraphTracker.getInstance().init(this, PROFILE_ID, false)
			IDGraphTracker.getInstance().reportTrackLog(extraParams)
			},
			latitude = latitude,
			longitude = longitude
			)
			}
	}		}
			</source>
	~~Other Code ...~~
	}

	~~<br>~~
	*<big><u>With Application Class</u></big>
	:若APP專案有自己的Application class，可將追蹤碼放在此class，由於Application的執行時間是在Activity啟動前，因此會比Without Application Class更早回報，但是<span style="color:red;">如果APP是透過Back鍵關掉的話，由於Application還會留在系統一小段時間, 導致使用者短時間內再次打開APP時並不會觸發回報</span>, 必須等待系統將其回收或是使用者自行把APP刷掉(在桌面點選Menu Button, 再將APP上滑關閉), Application才算是真正結束，程式碼如下:<br>
	~~<b><MyCustomApplication.java></b>~~
	~~public class MyCustomApplication extends Application {~~

	~~private static final String PROFILE_ID = "<b><Your Profile ID></b>";~~
	~~private static final boolean isDebug = false;~~

	~~// Called when the application is starting, before any other application objects have been created.~~
	~~// Overriding this method is totally optional!~~
	~~@Override~~
	~~public void onCreate() {~~
	~~super.onCreate();~~

	~~// Initial~~
	~~IDGraphTracker.getInstance().init(this, PROFILE_ID, isDebug);~~
	~~// Send Tracking Log~~
	~~IDGraphTracker.getInstance().reportTrackLog();~~
	}

	~~Other Code ...~~
	}

	~~<b><AndroidManifest.xml></b>~~
	~~<application~~
	~~android:name="<b>.MyCustomApplication</b>"~~
	~~android:allowBackup="true"~~
	~~android:label="@string/app_name"~~
	~~android:supportsRtl="true"~~
	~~android:theme="@style/AppTheme" >~~

	~~Other Code ...~~

	~~</application>~~

	<br>		<br>
	<br>		<br>
	[[IDGraph_Android_SDK_Developer_Guide\|回IDGraph Android SDK首頁]]		[[IDGraph_Android_SDK_Developer_Guide\|回IDGraph Android SDK首頁]]

BrandonTeng 於 2024年10月23日 (三) 06:15

2024-10-23T06:15:23Z

←上個修訂		於 2024年10月23日 (三) 06:15 的修訂
行 8：		行 8：
	:第三個為boolean值，設為true時，每次回報會出現Toast訊息框以確認回報是否成功		:第三個為boolean值，設為true時，每次回報會出現Toast訊息框以確認回報是否成功
	<br>		<br>
	~~若要進行回報，需呼叫下列函式~~		若要進行回報需呼叫下列函式，extraParams為額外參數(非必要)，如果開發者知道目前經緯度，可透過此參數帶入
	<source>		<source>
			val extraParams = listOf(lon, lat)
	IDGraphTracker.getInstance().reportTrackLog(extraParams)		IDGraphTracker.getInstance().reportTrackLog(extraParams)
	</source>		</source>

BrandonTeng 於 2024年10月23日 (三) 06:12

2024-10-23T06:12:42Z

←上個修訂		於 2024年10月23日 (三) 06:12 的修訂
行 9：		行 9：
	<br>		<br>
	若要進行回報，需呼叫下列函式		若要進行回報，需呼叫下列函式
	IDGraphTracker.getInstance().reportTrackLog();		<source>
			IDGraphTracker.getInstance().reportTrackLog(extraParams)
			</source>
	<br>		<br>
	<br>		<br>

BrandonTeng 於 2024年10月23日 (三) 06:11

2024-10-23T06:11:55Z

←上個修訂		於 2024年10月23日 (三) 06:11 的修訂
行 1：		行 1：
	在回報Log前，必須讓SDK進行初始化，您需要執行下列函式		在回報Log前，必須讓SDK進行初始化，您需要執行下列函式
	IDGraphTracker.getInstance().init(~~Context~~, <PROFILE_ID>, isDebug);		<source>
			IDGraphTracker.getInstance().init(this, PROFILE_ID, isDebug)
			</source>

	:第一個參數為Context		:第一個參數為Context
	:第二個參數請填入你的Profile ID (可向您的TAMedia窗口詢問)		:第二個參數請填入你的Profile ID (可向您的TAMedia窗口詢問)

BrandonTeng：建立內容為「在回報Log前，必須讓SDK進行初始化，您需要執行下列函式 IDGraphTracker.getInstance().init(Context, , isDebug); :第一個參數為Context :第二個參數請填入你的Profile ID (可向您的TAMedia窗口詢問) :第三個為boolean值，設為true時，每次回報會出現Toast訊息框以確認回報是否成功
若要進行回報，需呼叫下列函式 IDGraphTracker.getInstance().reportTrackLog();

上…」的新頁面

2024-10-23T06:04:47Z

建立內容為「在回報Log前，必須讓SDK進行初始化，您需要執行下列函式 IDGraphTracker.getInstance().init(Context, <PROFILE_ID>, isDebug); :第一個參數為Context :第二個參數請填入你的Profile ID (可向您的TAMedia窗口詢問) :第三個為boolean值，設為true時，每次回報會出現Toast訊息框以確認回報是否成功 若要進行回報，需呼叫下列函式 IDGraphTracker.getInstance().reportTrackLog(); 上…」的新頁面

新頁面

在回報Log前，必須讓SDK進行初始化，您需要執行下列函式
IDGraphTracker.getInstance().init(Context, <PROFILE_ID>, isDebug);
:第一個參數為Context
:第二個參數請填入你的Profile ID (可向您的TAMedia窗口詢問)
:第三個為boolean值，設為true時，每次回報會出現Toast訊息框以確認回報是否成功
 
若要進行回報，需呼叫下列函式
IDGraphTracker.getInstance().reportTrackLog();
 
 
上述提及的函式，可參考下列方式加入您的專案
*<big>Without Application Class</big>
:若APP專案未擁有自己的Application class，可以將追蹤碼放在自己的APP首頁，也就是第一個出現的Activity，透過此方式，每次APP重啟時都會觸發回報，程式碼如下:
<MainActivity.java>
public class MainActivity extends AppCompatActivity {

private static final String PROFILE_ID = "<Your Profile ID>";
private static final boolean isDebug = false;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

// Initial
IDGraphTracker.getInstance().init(this, PROFILE_ID, isDebug);
// Send Tracking Log
IDGraphTracker.getInstance().reportTrackLog();
}

Other Code ...
}

 
*<big>With Application Class</big>
:若APP專案有自己的Application class，可將追蹤碼放在此class，由於Application的執行時間是在Activity啟動前，因此會比Without Application Class更早回報，但是如果APP是透過Back鍵關掉的話，由於Application還會留在系統一小段時間, 導致使用者短時間內再次打開APP時並不會觸發回報, 必須等待系統將其回收或是使用者自行把APP刷掉(在桌面點選Menu Button, 再將APP上滑關閉), Application才算是真正結束，程式碼如下: 
<MyCustomApplication.java>
public class MyCustomApplication extends Application {

private static final String PROFILE_ID = "<Your Profile ID>";
private static final boolean isDebug = false;

// Called when the application is starting, before any other application objects have been created.
// Overriding this method is totally optional!
@Override
public void onCreate() {
super.onCreate();

// Initial
IDGraphTracker.getInstance().init(this, PROFILE_ID, isDebug);
// Send Tracking Log
IDGraphTracker.getInstance().reportTrackLog();
}

Other Code ...
}

<AndroidManifest.xml>
<application
android:name=".MyCustomApplication"
android:allowBackup="true"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme" >

Other Code ...

</application>

 
 
[[IDGraph_Android_SDK_Developer_Guide|回IDGraph Android SDK首頁]]