Skip to main content

📣 Campaign Audit

Campaign Audit empowers Web3 developers to optimize their marketing strategies by providing in-depth analysis of wallet metrics. By examining key indicators such as potential bot percentage, hodler score, outbound transaction value, and wallet balance, developers can compare the quality and engagement of wallets acquired through various channels. This data-driven approach enables developers to identify the most effective marketing channels, allocate budgets more efficiently, and enhance ROI by focusing on campaigns that drive high-quality user acquisition and engagement. Wallet Intelligence fields offer the granular insights needed to fine-tune marketing efforts and ensure sustained growth in the competitive Web3 landscape.

Instructions​

Step 0: Collect Campaign Wallet Batches

  • Gather batches of wallet addresses acquired through different marketing campaigns. For example, collect a batch of wallets from Twitter ads and another batch of wallets from Reddit campaigns.
  • Each batch can contain up to 10,000 addresses.
  • If the list is over 10K wallets, then you will need to submit multiple requests. Example -->
[
"0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"0x988527874C7E3f02115F89A6a97135c70B6a47Fc",
...,
"0x5f3fd252caa351a69f5c98b78fd0db71adfe5bea"
]

Step 1: Obtain API Key

Step 2: Construct the API Request

  • Use the multi-wallet endpoint URL https://api.thirdwavelabs.com/evm/wallets/batch.
  • Set the request method to POST.

Step 3: Set Headers

  • Include the X-Api-Key header in your request with your API key as the value.
  • Set the Content-Type header to application/json.

Step 4: Send the Request

  • Execute the request for each batch of wallets separately, submitting the array of wallet addresses in the request body.
curl
--request POST 'https://api.thirdwavelabs.com/evm/wallets/batch' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '["0xd8da6bf26964af9d7eed9e03e53415d37aa96045","0x988527874C7E3f02115F89A6a97135c70B6a47Fc",...,"0x5f3fd252caa351a69f5c98b78fd0db71adfe5bea"]'

Step 5: Receive and Interpret the Response

  • Upon receiving the response from the API, parse the data into a CSV file or spreadsheet format to analyze the wallet audience in aggregate.
  • Review the attributes of each wallet object, including botWarning, outboundTransactionValue, balance, outboundTransactionCount, hodlerScore, and other characteristics.
  • Compare the performance of wallets acquired through different marketing campaigns, focusing on metrics such as potential bot percentage, hodler score, outbound transaction value, and wallet balance.
[
    {
        "data": {
        "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "firstSeenAt": "2015-09-28T08:24:43.000Z",
        "balance": 3206079.16,
        "hodlerScore": 55,
        "engagementScore": 84,
        "botWarning": false,
        "outboundTransactionValue": 64270664.33,
        "outboundTransactionCount": "1244",
        "transactionPatterns": [
         { "key": "CONTINUOUS", "value": false },
         { "key": "HIGH_VELOCITY", "value": false },
         { "key": "SUSPICIOUS_WALLET_NETWORK", "value": false },
         { "key": "TIMED", "value": false }
         ]
    }
    },
    {
        "data": {
        "address": "0x988527874C7E3f02115F89A6a97135c70B6a47Fc",
        "firstSeenAt": "2021-09-14T12:15:40.000Z",
        "balance": 1476.61,
        "hodlerScore": 98,
        "engagementScore": 99,
        "botWarning": true,
        "outboundTransactionValue": 64270664.33,
        "outboundTransactionCount": "1244",
        "transactionPatterns": [
         { "key": "CONTINUOUS", "value": true },
         { "key": "HIGH_VELOCITY", "value": false },
         { "key": "SUSPICIOUS_WALLET_NETWORK", "value": true },
         { "key": "TIMED", "value": false }
         ]
    }
    },
    {
        ...
    },
    {
        "data": {
        "address": "0x5f3fd252caa351a69f5c98b78fd0db71adfe5bea",
        "firstSeenAt": "2024-04-11T07:18:39.000Z",
        "balance": 1.95,
        "hodlerScore": 63,
        "engagementScore": 22,
        "botWarning": false,
        "outboundTransactionValue": 1.56,
        "outboundTransactionCount": "5",
        "transactionPatterns": [
         { "key": "CONTINUOUS", "value": false },
         { "key": "HIGH_VELOCITY", "value": false },
         { "key": "SUSPICIOUS_WALLET_NETWORK", "value": false },
         { "key": "TIMED", "value": false }
         ]
    }
    }
]
info

If the wallet address provided doesn't exist, wasn't in the correct format, or is not on a supported chain, the response for that entry will be null.

Step 6: Generate Insights

  • Utilize the extracted data to generate insights and assess the effectiveness of different marketing campaigns.
  • Identify trends and patterns in wallet quality metrics to determine which campaigns yield the highest ROI.
  • Optimize future marketing strategies based on the analysis to allocate budget towards campaigns that drive higher-quality wallets and better ROI.

Suggested analysis to run:

Validity

  • % Potential Bots
  • % Transaction Pattern flags (i.e. % flagged for suspicious wallet network)

Value

  • Total, median, average balance
  • Top 10 wallets by balance
  • Total, median, average outboundTransactionValue
  • Top 10 Wallets wallets by outboundTransactionValue

Behavior

  • Median, average, hodlerScore
  • Top 10 wallets by hodlerScore
  • Median, average, engagementScore
  • Top 10 wallets by engagementScore

Experience

  • Total, median, average outboundTransactionCount
  • Top 10 wallets by outboundTransactionCount
  • Segment by wallet age based on firstSeenAt timestamp

Outcome​

By conducting a Campaign Audit using Thirdwave's Wallet Intelligence API, developers can gain valuable insights into the effectiveness of their marketing campaigns and optimize future strategies for improved ROI.