@bprotsyk/aso-core 2.1.188 → 2.1.190

package/README-update-campaign-params.md

@@ -0,0 +1,184 @@
+# Campaign Parameters Update Script
+
+This script updates campaign parameters for all campaigns that belong to groups with 3-4 digit numeric names (e.g., "123", "1234").
+
+## What it does
+
+The script will:
+
+1. Fetch all campaign groups from Keitaro
+2. Filter groups with 3-4 digit numeric names
+3. Find all campaigns belonging to those groups
+4. Display all campaigns with their current and new parameters
+5. Ask for ONE confirmation to update all campaigns
+6. For each campaign:
+   - **Update** `sub_id_11`: name="firebase_app_instance_id", alias="Firebase App Instance ID", placeholder="{firebase_app_instance_id}"
+   - **Update** `sub_id_12`: name="firebase_user_id", alias="Firebase User ID", placeholder="{firebase_user_id}"
+   - **Update** `sub_id_13`: name="firebase_device_language_code", alias="Firebase Device Language Code", placeholder="{firebase_device_language_code}"
+   - **Update** `sub_id_14`: name="firebase_push_token", alias="Firebase Push Token", placeholder="{firebase_push_token}"
+   - **Remove** `sub_id_15` (set to empty)
+   - **Update** `sub_id_17`: name="advertising_id", alias="Appsflyer Advertising ID", placeholder="{advertising_id}"
+   - **Update** `sub_id_18`: name="appsflyer_device_id", alias="Appsflyer Device ID", placeholder="{appsflyer_device_id}"
+   - **Update** `sub_id_20`: name="campaign", alias="Naming", placeholder="{campaign}"
+   - **Remove all S2S postbacks** (if present)
+
+## Parameter Details
+
+Each parameter is updated with the exact values specified:
+
+```typescript
+sub_id_11: {
+  name: "firebase_app_instance_id",
+  placeholder: "{firebase_app_instance_id}",
+  alias: "Firebase App Instance ID"
+}
+
+sub_id_12: {
+  name: "firebase_user_id",
+  placeholder: "{firebase_user_id}",
+  alias: "Firebase User ID"
+}
+
+sub_id_13: {
+  name: "firebase_device_language_code",
+  placeholder: "{firebase_device_language_code}",
+  alias: "Firebase Device Language Code"
+}
+
+sub_id_14: {
+  name: "firebase_push_token",
+  placeholder: "{firebase_push_token}",
+  alias: "Firebase Push Token"
+}
+
+sub_id_15: {
+  name: "",
+  placeholder: "",
+  alias: ""
+} // REMOVED
+
+sub_id_17: {
+  name: "advertising_id",
+  placeholder: "{advertising_id}",
+  alias: "Appsflyer Advertising ID"
+}
+
+sub_id_18: {
+  name: "appsflyer_device_id",
+  placeholder: "{appsflyer_device_id}",
+  alias: "Appsflyer Device ID"
+}
+
+sub_id_20: {
+  name: "campaign",
+  placeholder: "{campaign}",
+  alias: "Naming"
+}
+```
+
+## Usage
+
+```bash
+cd core
+npx ts-node update-campaign-params.ts
+```
+
+## Interactive Mode
+
+The script runs in interactive mode by default. It will display ALL campaigns at once, then ask for one confirmation:
+
+```
+====================================================================================================
+CAMPAIGNS TO BE UPDATED:
+====================================================================================================
+
+Campaign ID: 1234 | Group: [123]
+Name: [123] MyApp [com.example.app] [Android] domain.com
+Has S2S Postbacks: YES (will be removed)
+
+CURRENT PARAMETERS:
+  sub_id_11: name="" placeholder="" alias=""
+  sub_id_12: name="" placeholder="" alias=""
+  sub_id_13: name="" placeholder="" alias=""
+  sub_id_14: name="" placeholder="" alias=""
+  sub_id_15: name="old_naming" placeholder="{naming}" alias="Naming"
+  sub_id_17: name="old_adid" placeholder="{advertising_id}" alias="..."
+  sub_id_18: name="old_devid" placeholder="{appsflyer_device_id}" alias="..."
+  sub_id_20: name="" placeholder="" alias=""
+
+NEW PARAMETERS:
+  sub_id_11: name="firebase_app_instance_id" placeholder="{firebase_app_instance_id}" alias="Firebase App Instance ID"
+  sub_id_12: name="firebase_user_id" placeholder="{firebase_user_id}" alias="Firebase User ID"
+  sub_id_13: name="firebase_device_language_code" placeholder="{firebase_device_language_code}" alias="Firebase Device Language Code"
+  sub_id_14: name="firebase_push_token" placeholder="{firebase_push_token}" alias="Firebase Push Token"
+  sub_id_15: REMOVED (empty)
+  sub_id_17: name="advertising_id" placeholder="{advertising_id}" alias="Appsflyer Advertising ID"
+  sub_id_18: name="appsflyer_device_id" placeholder="{appsflyer_device_id}" alias="Appsflyer Device ID"
+  sub_id_20: name="campaign" placeholder="{campaign}" alias="Naming"
+----------------------------------------------------------------------------------------------------
+
+[... more campaigns ...]
+
+====================================================================================================
+Total campaigns to update: 15
+====================================================================================================
+
+Do you want to update ALL 15 campaigns? (y/n):
+```
+
+### Response Options:
+- `y` or `yes` - Update all campaigns
+- `n` or `no` - Cancel the operation
+
+## Programmatic Usage
+
+You can also use the function directly in your code:
+
+```typescript
+import { TraffleKeitaroService } from './src/network/keitaro/traffle/traffle-keitaro-service';
+
+// With confirmation (interactive)
+const result = await TraffleKeitaroService.updateCampaignParametersForNumericGroups(true);
+
+// Without confirmation (automatic - use with caution!)
+const result = await TraffleKeitaroService.updateCampaignParametersForNumericGroups(false);
+
+console.log(result);
+// { updated: 5, failed: 0, skipped: 2 }
+```
+
+## Safety Features
+
+1. **Group Validation**: Only processes campaigns in groups with 3-4 digit numeric names
+2. **Confirmation Required**: By default, asks for ONE confirmation before updating all campaigns
+3. **Detailed Preview**: Shows ALL campaigns with current and new parameters before asking for confirmation
+4. **Postback Removal**: Safely removes S2S postbacks for all updated campaigns
+5. **Error Handling**: Continues processing even if individual campaigns fail
+6. **Summary Report**: Provides detailed statistics at the end
+
+## Return Value
+
+The function returns an object with statistics:
+
+```typescript
+{
+  updated: number,  // Successfully updated campaigns
+  failed: number,   // Campaigns that failed to update
+  skipped: number   // All campaigns skipped if user cancels (0 if user confirms)
+}
+```
+
+## Requirements
+
+- Node.js environment with TypeScript support
+- Access to Keitaro API (configured in `traffle-keitaro-service.ts`)
+- Proper authentication credentials
+
+## Notes
+
+- Parameters are set to exact values as specified (not randomly generated)
+- Only campaigns in groups with names matching `/^\d{3,4}$/` (3-4 digits) are processed
+- All S2S postbacks will be removed from updated campaigns
+- The script shows all campaigns at once and requires ONE confirmation to proceed
+- The script is safe to run multiple times - you can review all campaigns before confirming
+

package/lib/app/app.d.ts

@@ -141,10 +141,14 @@ export declare enum IntegrationVersion {
     PWA = "PWA"
 }
 export interface IKeitaroDirectTrackingParams {
-    naming: string;
+    firebase_app_instance_id: string;
+    firebase_user_id: string;
+    firebase_device_language_code: string;
+    firebase_push_token: string;
     bundle_id: string;
     advertising_id: string;
     appsflyer_device_id: string;
+    campaign: string;
 }
 export interface IAppKeitaroData {
     trackingCampaignId: number;

package/lib/keitaro/keitaro-campaign.d.ts

@@ -26,6 +26,7 @@ export interface IKeitaroCampaign {
     source?: string;
     bind_visitors?: string;
     group?: string;
+    postbacks?: any[];
 }
 export interface IKeitaroCampaignParameters {
     [key: string]: IKeitaroCampaignParameter;

package/lib/network/keitaro/traffle/http.d.ts

@@ -1,2 +1,3 @@
-declare const _default: import("axios").AxiosInstance;
-export default _default;
+declare const keitaroApi: import("axios").AxiosInstance;
+export declare const keitaroGroupsApi: import("axios").AxiosInstance;
+export default keitaroApi;

package/lib/network/keitaro/traffle/http.js

@@ -3,11 +3,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.keitaroGroupsApi = void 0;
 const axios_1 = __importDefault(require("axios"));
-exports.default = axios_1.default.create({
+// API key for groups operations
+const GROUPS_API_KEY = '778a14c0730abe2629e88101cb88d573';
+// API key for all other operations
+const DEFAULT_API_KEY = 'd589bd5356d5726539c32c2e523f1518';
+// Default instance for most operations
+const keitaroApi = axios_1.default.create({
     baseURL: 'https://traffle-tech.com/admin_api/v1/',
     headers: {
-        // "Api-Key": `3e80a8fcf1ceb01a761457d017e43a0a`,
-        "Api-Key": `778a14c0730abe2629e88101cb88d573`,
+        "Api-Key": DEFAULT_API_KEY,
     },
 });
+// Separate instance for groups operations
+exports.keitaroGroupsApi = axios_1.default.create({
+    baseURL: 'https://traffle-tech.com/admin_api/v1/',
+    headers: {
+        "Api-Key": GROUPS_API_KEY,
+    },
+});
+exports.default = keitaroApi;

package/lib/network/keitaro/traffle/traffle-keitaro-service.d.ts

@@ -105,6 +105,26 @@ declare function TrafleKeitaroParameters(parameters: any): Promise<{
             placeholder: string;
             alias: string;
         };
+        sub_id_11: {
+            name: string;
+            placeholder: string;
+            alias: string;
+        };
+        sub_id_12: {
+            name: string;
+            placeholder: string;
+            alias: string;
+        };
+        sub_id_13: {
+            name: string;
+            placeholder: string;
+            alias: string;
+        };
+        sub_id_14: {
+            name: string;
+            placeholder: string;
+            alias: string;
+        };
         sub_id_15: {
             name: string;
             placeholder: string;
@@ -130,14 +150,24 @@ declare function TrafleKeitaroParameters(parameters: any): Promise<{
             placeholder: any;
             alias: string;
         };
+        sub_id_20: {
+            name: string;
+            placeholder: string;
+            alias: string;
+        };
     };
-} | null>;
+}>;
 declare function cloneTraffleCampaign(app: IApp, platform: EPlatform, addDefaultStreams?: boolean): Promise<IKeitaroCampaign | any>;
 export declare function updateStreamsForApp(app: IApp, platform: EPlatform): Promise<boolean>;
 export declare function updateCampaignNamesToNewPattern(requireConfirmation?: boolean): Promise<{
     updated: number;
     failed: number;
 }>;
+export declare function updateCampaignParametersForNumericGroups(requireConfirmation?: boolean): Promise<{
+    updated: number;
+    failed: number;
+    skipped: number;
+}>;
 export declare const TraffleKeitaroService: {
     addOffersToTraffleKeitaro: typeof addOffersToTraffleKeitaro;
     getTraffleOffersGroups: typeof getTraffleOffersGroups;
@@ -151,5 +181,6 @@ export declare const TraffleKeitaroService: {
     TrafleKeitaroParameters: typeof TrafleKeitaroParameters;
     updateStreamsForApp: typeof updateStreamsForApp;
     updateCampaignNamesToNewPattern: typeof updateCampaignNamesToNewPattern;
+    updateCampaignParametersForNumericGroups: typeof updateCampaignParametersForNumericGroups;
 };
 export {};