Android SDK クイックスタート

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

// build.gradle に以下を追加
dependencies {
    implementation 'com.treasuredata:td-android-sdk:1.0.0'
}

// pom.xml に以下を追加
  <dependency>
    <groupId>com.treasuredata</groupId>
    <artifactId>td-android-sdk</artifactId>
    <version>1.0.0</version>
  </dependency>

1) 最新の td-android-sdk-x.x.x-shaded.jar パッケージを以下からダウンロード
    https://central.sonatype.com/search?q=g:com.treasuredata%20%20a:td-android-sdk&smo=true
2) .jar を YOUR_ANDROID_PROJECT/libs フォルダに追加

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  package="com.treasuredata.android.demo"
  android:versionCode="1"
  android:versionName="1.0" >
  ...

  <!-- 必要なパーミッション -->
  <uses-permission android:name="android.permission.INTERNET"/>
</manifest>

td.enableAutoAppendUniqId();

public class ExampleApp extends Application {

  @Override
  public void onCreate() {

    // Treasure Data Android SDK の初期化
    TreasureData.initializeEncryptionKey("RANDOM_STRING_TO_ENCRYPT_DATA");
    TreasureData.disableLogging();
    TreasureData.initializeSharedInstance(this, "YOUR_API_KEY", "API_ENDPOINT");
    TreasureData.sharedInstance.setDefaultDatabase("your_application_name");
    TreasureData.sharedInstance.setDefaultTable("your_event_name");
    TreasureData.sharedInstance.enableAutoAppendUniqId();
    TreasureData.sharedInstance.enableAutoAppendModelInformation();
    TreasureData.sharedInstance.enableAutoAppendAppInformation();
    TreasureData.sharedInstance.enableAutoAppendLocaleInformation();
  }
}

public class ExampleActivity extends Activity {

  public void onDataLoadSomethingFinished(long elapsedTime) {
    Map<String, Object> event = new HashMap<String, Object>();
    event.put("data_type", "something");
    event.put("elapsed_time", elapsedTime);
    TreasureData.sharedInstance().addEvent("events", event);
  }
}

View v = findViewById(R.id.button);
 v.setOnClickListener(new OnClickListener() {
   @Override
   public void onClick(View v) {

     final Map event = new HashMap<String, Object>();
     event.put("id", v.getId());
     event.put("left", v.getLeft());
     event.put("right", v.getRight());
     event.put("top", v.getTop());
     event.put("bottom", v.getBottom());

     td.addEvent("testdb", "demotbl", event);
  }
});

View v = findViewById(R.id.button);
 v.setOnClickListener(new OnClickListener() {
   @Override
   public void onClick(View v) {

     final Map event = new HashMap<String, Object>();
     event.put("id", v.getId());
     event.put("left", v.getLeft());
     event.put("right", v.getRight());
     event.put("top", v.getTop());
     event.put("bottom", v.getBottom());

     td.addEventWithCallback("testdb", "demotbl", event, new TDCallback() {
       @Override
       public void onSuccess() {
         Log.i("ExampleApp", "success!");
       }

       @Override
       public void onError(String errorCode, Exception e) {
         Log.w("ExampleApp", "errorCode: " + errorCode + ", detail: " + e.toString());
       }
     });
  }
});

findViewById(R.id.upload).setOnTouchListener(new OnTouchListener() {
   @Override
   public boolean onTouch(View view, MotionEvent motionEvent) {

     // この API を呼び出して、いつでもバッファされたイベントをアップロードできます。
     td.uploadEvents();

     return false;
  }
});

findViewById(R.id.upload).setOnTouchListener(new OnTouchListener() {
   @Override
   public boolean onTouch(View view, MotionEvent motionEvent) {

     // この API を呼び出して、いつでもバッファされたイベントをアップロードできます。
     td.uploadEventsWithCallback(new TDCallback() {
       @Override
       public void onSuccess() {
         Log.i("ExampleApp", "success!");
       }

       @Override
       public void onError(String errorCode, Exception e) {
         Log.w("ExampleApp", "errorCode: " + errorCode + ", detail: " + e.toString());
       }
     });

     return false;
  }
});

TreasureData.sharedInstance().setDefaultValue(null, null, "key", "Value"); // すべてのデータベースとテーブルを対象
TreasureData.sharedInstance().setDefaultValue("database_name", null, "key", "Value"); // データベース "database_name" のすべてのテーブルを対象
TreasureData.sharedInstance().setDefaultValue(null, "table_name", "key", "Value"); // "table_name" という名前のすべてのテーブルを対象
TreasureData.sharedInstance().setDefaultValue("database_name", "table_name", "key", "Value"); // データベース "database_name" のテーブル "table_name" を対象

String defaultValue = (String) TreasureData.sharedInstance().getDefaultValue("database_name", "table_name", "key"); // データベース "database_name" とテーブル "table_name" を対象とするキーのデフォルト値を取得

TreasureData.sharedInstance().removeDefaultValue("database_name", "table_name", "key"); // データベース "database_name" とテーブル "table_name" を対象とするデフォルト値のみを削除

@Override
protected void onStart(Bundle savedInstanceState) {
                :
        TreasureData.sharedInstance().startSession("demotbl");
                :
}

@Override
protected void onStop() {
                :
        TreasureData.sharedInstance().endSession("demotbl");
        TreasureData.sharedInstance().uploadEvents();
        // 出力 =>>
        // [{"td_session_id":"cad88260-67b4-0242-1329-2650772a66b1",
        // "td_session_event":"start", "time":1418880000},
        //
        // {"td_session_id":"cad88260-67b4-0242-1329-2650772a66b1",
        // "td_session_event":"end", "time":1418880123}
        // ]
            :
}

@Override
protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
                :
        TreasureData.setSessionTimeoutMilli(30 * 1000); // デフォルトは 10 秒
}

@Override
protected void onStart() {
                :
TreasureData.startSession(this);
        :
}

@Override
protected void onStop() {
:
TreasureData.endSession(this);
TreasureData.sharedInstance().uploadEvents();
:
}

@Override
protected void onStart() {
                :
        TreasureData.startSession(this);
        Log.i(TAG, "onStart(): Session ID=" + TreasureData.getSessionId(this));
                :
}

-keep class com.android.vending.billing.** { *; }

td = new TreasureData(this, "your_api_key", "https://specifying-another-endpoint.com");

    TreasureData.initializeEncryptionKey("hello world");
        :
    td.addEventWithCallback(...)

  TreasureData.sharedInstance().setDefaultDatabase("default_db");
    :
  TreasureData.sharedInstance().addEvent("demotbl", …);

    // ローカル時刻を `time` 列として使用
    TreasureData.sharedInstance().enableAutoAppendLocalTimestamp();

    // ローカル時刻をカスタマイズされた列名として追加
    TreasureData.sharedInstance().enableAutoAppendLocalTimestamp("custom_time");

    // ローカル時刻の自動追加を無効化
    TreasureData.sharedInstance().disableAutoAppendLocalTimestamp();

  td.enableAutoAppendUniqId();
    :
  td.addEvent(...);

  td.enableAutoAppendRecordUUID();
  // 列名をカスタマイズしたい場合は、API に渡してください
  // td.enableAutoAppendRecordUUID("my_record_uuid");
    :
  td.addEvent(...);

td.enableAutoAppendAdvertisingIdentifier();
// 列名をカスタマイズしたい場合は、API に渡してください
// td.enableAutoAppendAdvertisingIdentifier("my_advertising_id_column");
:
td.addEvent(...);

  td.enableAutoAppendModelInformation();
    :
  td.addEvent(...);

  td.enableAutoAppendAppInformation();
    :
  td.addEvent(...);

  td.enableAutoAppendLocaleInformation();
    :
  td.addEvent(...);

TreasureData.sharedInstance().enableAutoTrackingIP();

TreasureData.sharedInstance().disableAutoTrackingIP();

// CDP エンドポイントを以下のいずれかに設定してください:
//   https://cdp.in.treasuredata.com        (US)
//   https://cdp-tokyo.in.treasuredata.com  (Tokyo)
//   https://cdp-eu01.in.treasuredata.com   (EU)
//   https://cdp-ap02.in.treasuredata.com   (Seoul)
//   https://cdp-ap03.in.treasuredata.com   (Tokyo)
TreasureData.sharedInstance().setCDPEndpoint("<your_cdp_endpoint>");

TreasureData.sharedInstance().fetchUserSegments(Arrays.asList("<your_profile_api_tokens>"),
                                                Collections.singletonMap("<your_key_column>", "<value>"),
                                                new FetchUserSegmentsCallback() {
                                                    @Override
                                                    public void onSuccess(List<Profile> profiles) {
                                                        System.out.println(profiles);
                                                    }
                                                    @Override
                                                    public void onError(Exception e) {
                                                        System.err.println(e);
                                                    }
                                                });

  TreasureData.enableLogging();

  TreasureData.disableLogging();