Quick Tracking:公式アカウント管理

1. 操作の説明

以下のフォームは、公式アカウントイベント追跡に必要な手順です。順番に従ってください。

1.1 公式アカウントに統合

製品パス: 「データ追跡」-「データソース管理」-「公式アカウント管理」

[公式アカウントに統合] ボタンをクリックします。 右側の [データソースに統合] ページで作成を完了するには、以下の情報が必要です。

ヒント: ブラウザの開発者ツールを使用して、REST API のレスポンスを確認できます。

• 公式アカウント名: アクセスする公式アカウントの名前を入力します

• 公式アカウント ID: 公式アカウント ID を入力します。 公式アカウント ID は一意である必要があります。 次の図は、データを取得する方法を示しています:

「分析設定」

• 所属組織: デフォルトでは、現在の組織は変更できません。 公式アカウントを別の組織に追加する場合は、左側の [グループ] ドロップダウンリストから組織を切り替える必要があります。

• 所属アプリケーション: ドロップダウンリストから現在の組織内のアプリケーションを選択します。

「WeChat メッセージを受信する」

• 暗号化モード: セキュリティモードとプレーンテキストモードに分かれています。

セキュリティモード: EncodingAESKey は、WeChat 公開番号プラットフォームと同じメッセージ本文の暗号化および復号鍵として使用されます。

プレーンテキストモード: メッセージ本文の暗号化および復号機能を使用せず、セキュリティ係数が低くなります。

• EncodingAESKey を取得するには、次のコードを実行します: 公式アカウントバックエンド - 基本構成 - EncodingAESKey をコピーします。

• トークン取得アドレス: 公式アカウントバックエンド - 基本構成 - トークンをコピーします

(注: WeChat 公式アカウントのバックエンド URL は、ユーザーが入力したアドレスです。 WeChat 公式アカウントは、入力されたアドレスにデータを送信し、Quick Tracking と同期します。 参考ドキュメント)

「匿名ユーザーの一意の識別子」

必須。 ユニオンまたは OpenID は、匿名ユーザーの一意の識別子として使用されます。

• OpenID: ユーザーの一意の識別子。

• UnionID: ユーザーを区別するために使用される一意の値。 このパラメータを UnionID に設定した後、access_token を取得する必要があります。

「access_token を取得する」

他のビジネスが同時にトークンを使用する場合、access_token を取得および維持するために中央制御サービスを構築する必要があります。 分析プラットフォームでは、中央制御サービスから access_token を取得できます。 (注: 匿名ユーザーの一意の識別子として unionID を選択した場合、ユーザーはコントロールセンターを構成する必要があります。 Quick Tracking はコントロールセンターを介してトークンを取得し、WeChat 公式アカウントで対応する unionID を取得します (トークンを取得するたびにトークンが更新されるため、他の場所で使用するトークンも更新および変更されます。 また、トークン取得 WeChat 開発プラットフォームの数には制限があり、ユーザーはコントロールセンターからトークンを取得でき、トークンの期間を制御できます))

• 中央制御サーバーアドレス: セルフビルド中央制御サービスアドレスを入力して、トークン中央制御サービスアドレスを取得します。

• Access_token 解析: Access_Token パラメータは、中央制御サーバーから取得した戻り値から解析されます。 Access_Token パラメータは、JSONPah 式を使用して解析されます。 JSONPath 式を入力し、[テスト] をクリックして、Access_Token パラメータが解析されるかどうかをテストします。 Access_Token パラメータが解析されると、Access_Token パラメータを正常に取得できます。

上記の手順を完了し、[保存] をクリックして作成を完了します。

1.2 公式アカウント管理

公式アカウントアクションエリアは、主に以下の部分で構成されています。

• 左側の組織スクリーニングエリア: 異なる組織にアクセスした公式アカウントを切り替えます

• データ表示エリア: 接続されている公式アカウントのリストを表示します。 データには、公式アカウント名、公式アカウント APPID、作成者、アプリケーション、およびアクションが含まれます。 注: 分析設定では、公開番号は 1 つのアプリケーションにのみ属することができます。

• アクションエリア: アクションエリアには、[編集] と [アクション] が含まれています。 [編集] をクリックすると、新しいインターフェースと同じになります。 [削除] をクリックすると、公式アカウントの関連付けがアプリケーションから削除されます。

1.3 データ分析

公式アカウントにアクセスした後のアプリケーション、および「公式アカウントにアクセスした後のアプリケーション」を含む分析ビューと小規模ステーションの場合、公式アカウントイベントをシステム属性に含めて分析に参加させる必要があります。 分析に参加するシステム属性は次のとおりです。

公式アカウントイベントを明らかにするための分析モデルには、イベント分析、ファネル分析、リテンション分析、分布分析、間隔分析、パス解析、ライフサイクル分析、アトリビューション分析、およびオーディエンス管理が含まれます。

2 イベントとイベント属性

WeChat 公式アカウントイベントは、WeChat によって定義、生成、および送信されます。 開発者はこれらのデータをサブスクライブするだけで、カスタマイズすることはできません。 サブスクライブできる特定のイベントリストは次のとおりです。

3 イベント追跡

3.1 サーバー追跡パラメータ追跡

1. 管理コンソールに移動 --> 追跡情報をクリック

2. プライマリドメイン名: サーバー追跡データを報告するためのアドレス

3. サブドメイン: デフォルトドメインはプライマリドメインと同じです。プライベートデプロイメントのお客様は、サブドメイン名を代替ドメイン名として提供できます。

4. ServiceSecret と ServiceID は検証パラメータです。シークレットを公開しないでください。

5. code パラメータは開発者 ID (AppID) を指定します。このパラメータは WeChat 公開 ID プラットフォームから必須であり、追跡管理 - データソース管理 - 公式アカウント管理で構成する必要があります。

注: 上記の情報はシステムセキュリティに関連するため、管理者権限のみが表示できます!

3.2 リクエストパラメータ

API アドレス: https://<データ追跡エンドポイント + ポート> /server/thirdPartyDataSource

リクエストパラメータ content-type:application/json

JSON パラメータのリクエスト:

<xml><ToUserName><![CDATA[gh_0b03a4dd7455]]></ToUserName>
<FromUserName><![CDATA[o884561i2yjDrOhC6IqzEzXtPKUo]]></FromUserName>
<CreateTime>1676613107</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><! [CDATA [Test]]></Content>
<MsgId>24003327368861869</MsgId>
</xml>

3.3 認証署名生成ルール

1. まず、sign フィールドを除くすべてのリクエストフィールドのキーと値をマップオブジェクトにカプセル化します

2. このマップオブジェクトを JSON 文字にシリアル化するには、キーを自然順序、つまり ASCII コードに従ってソートする必要があります。 Java は JSONObject.toJSONString(mapObject, SerializerFeature.MapSortField) を使用できます。

3. serviceSecret を取得する

4. sign = MD5 (ソート後に生成された JSON 文字 + serviceSecret)

5. 計算された sign を元のマップオブジェクトに入れ、JSON 文字にシリアル化します。これが最終的な完全な JSON リクエストメッセージです。

3.4 レスポンスの説明

レスポンスデータ content-type:application/json

レスポンス JSON には、code と message の 2 つのフィールドが含まれています

3.5 java デモ参照

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.alibaba.fastjson.serializer.SerializerFeature;
import com.google.gson.Gson;
import okhttp3.*;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Controller;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.nio.charset.Charset;
import java.util.HashMap;
import java.util.Map;

/**
* ThirdPartyDataSourceApiDemo はサードパーティのデータソースデモにアクセスします
*
* @author chengtao
*/
public class ThirdPartyDataSourceApiDemo {
     private static final Logger logger = LoggerFactory.getLogger(ThirdPartyDataSourceApiDemo.class);

    /**
     * プライマリドメイン名
     */
    private static final String API_URL = "*****";

    /**
     * サーバー追跡情報にある ServiceID に対応します。
     */
    private static final String SERVICE_ID = "*****";

    /**
     * サーバー追跡情報にある ServiceSecret に対応します。
     */
    private static final String SERVICE_SECRET = "*****";

    /**
     * クライアントログ
     */
    private static final OkHttpClient client = new OkHttpClient();

    /**
     * WeChat 公開番号ログを取得し、追跡のために QT に転送します (このインターフェースは WeChat 公開番号管理バックグラウンドで構成する必要があります)
     * 
     * @param request
     * @throws IOException
     */
    @RequestMapping("/token")
    @ResponseBody
    public void token(HttpServletRequest request) throws IOException {
        // WeChat 公式公開番号リクエストのすべてのパラメータを取得し、JSON 形式でカプセル化します。
        Map<String, String[]> paramMap = request.getParameterMap();

        JSONObject json = paramMapToJson(paramMap);

        // メッセージにサービス ID を追加します。
        json.put("app_id",SERVICE_ID);

        // メッセージに ts を追加します。
        json.put("ts", String.valueOf(System.currentTimeMillis()));

        // 公開 ID を入力します。
        String code = "******";
        json.put("code", code);

        // WeChat 公開番号の XML データを取得します。
        String weChatOAData = new String(InputStreamUtil.getBytes(request)); // InputStreamUtil.getBytes(request) の実装が必要です
        json.put("weChatOAData", weChatOAData);

        //署名を計算する
        String sign = MD5Util.md5(JSONObject.toJSONString(json, SerializerFeature.MapSortField) + SERVICE_SECRET);

        json.put("sign", sign);

        String desJsonString = JSON.toJSONString(json, SerializerFeature.DisableCircularReferenceDetect);

        Request newRequest = new Request.Builder()
                .URL(API_URL + "/server") // 正確なエンドポイントへのパスであることを確認してください
                .post(RequestBody.create(MediaType.parse("application/json"),
                        desJsonString))
                .build();
        try {
            Response response = client.newCall(newRequest).execute();
            if (!response.isSuccessful()) {
                System.out.printf("[DEMO] ログの送信に失敗しました %s%n", response);
            } else {
                System.out.printf("[DEMO] 正常に送信されました %s%n",
                        response.body().string());
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    private static JSONObject paramMapToJson(Map<String, String[]> paramMap) {
        Map<String, Object> bodyMap = new HashMap<>();
        for (Map.Entry<String, String[]> entry : paramMap.entrySet()) {
            String key = entry.getKey();
            String[] value = entry.getValue();
            if (value.length == 1) {
                bodyMap.put(key, value[0]);
            } else {
                bodyMap.put(key, value);
            }
        }
        return JSON.parseObject(new Gson().toJson(bodyMap));
    }


    // getBodyString メソッドと InputStreamUtil クラスの実装は提供されていません。必要に応じて実装してください。

}


public class MD5Util {

    public static String md5(String s) {
        char hexDigits[] = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'};
        try {
            byte[] btInput = s.getBytes();
            // MD5 ダイジェストアルゴリズムの MessageDigest オブジェクトを取得します。
            MessageDigest mdInst = MessageDigest.getInstance("MD5");
            // 指定されたバイトでダイジェストを更新します
            mdInst.update(btInput);
            // 暗号文を取得します。
            byte[] md = mdInst.digest();
            // 暗号文を 16 進数文字列に変換します。
            int j = md.length;
                        char str[] = new char[j * 2];
            int k = 0;
            for (int i = 0; i < j; i++) {
                byte byte0 = md[i];
                str[k++] = hexDigits[byte0 >>> 4 & 0xf];
                str[k++] = hexDigits[byte0 & 0xf];
            }
            return new String(str);
        } catch (Exception e) {
            return null;
        }
    }

    /**
     * 単体テスト
     */
    public static void main(String[] args) {
        StringBuilder dtskey = new StringBuilder("abc12390");
        dtskey.append('\0').append("~!@#$%^&*()_+");
        System.out.println(MD5Util.md5(dtskey.toString()));
        System.out.println(MD5Util.md5("20121221"));
        System.out.println(MD5Util.md5("Encryption")); // 暗号化
    }
}