AdGraph
AdGraph

Open, decentralized on-chain graph of user preferences


As social and commerce shift onchain, wallets become identities. AdGraph builds onchain profiles of wallet addresses, capturing likes and preferences across all web3 apps they use

Banner

Integrate with AdGraph

Features 01

Adding data

When your app integrates with AdGraph, you contribute and utilize AdGraph data. This involves tagging interactions with relevant metadata (e.g., tagging a user’s profile with [cat, pet] when they view a cat profile page) and calling our API with these tags, the user address, and your app ID.

Try our sample site to see the usecase:

Features 02

Using data

You can use the host of preference data available on AdGraph to personalize content for users or target them with relevant ads. You can build your own service on top of AdGraph by using our contract events, or you can use our AI service which takes an image and tells you the wallet addresses who’ll be interested in it.

Guide To Integrate AdGraph

Integrating AdGraph is easy. You need to make a GET request like:

    axios.get('https://hollow-kilobyte-modern.functions.on-fleek.app', {
    params: {
        profile: "<user's wallet address>",
        app: "<your app name>",
        tags: "<comma separated tags>",
        temporary_api_key: "appkey_testnet"
    }
});
For Example:

    axios.get('https://hollow-kilobyte-modern.functions.on-fleek.app', {
    params: {
        profile: "0x4bec619bf1834bbe11f334117aca57bf68f0bc2c",
        app: "shop3",
        tags: "tag1,tag2,tag3",
        temporary_api_key: "appkey_testnet"
    }
}); 
The params are passed in the URL. For testnet, the temporary_api_key is hardcoded, however for mainnet, you’ll be minted an app-specific api key, which will keep rotating. The refresh tokens and api keys will be handled largely through our SDK which is in development. For accessing wallet addresses interested in particular tags, you can use your subgraph endpoint for testnet with the following GraphQL query:

query MyQuery {
  tagAddeds(
    where: {tag_in: ["laptop", "technology", "adgraph"]}
  ) {
    profile
    app
    id
    tag
  }
}


Endpoint: https://api.studio.thegraph.com/proxy/80137/adgraph/v0.0.4/graphql
We are working on more diverse and better managed services for AdGraph. Keep visiting our docs for further info. Note: This is an alpha product, things might break. Active development is going on to help make the usage and onboarding easy. We would love to speak with anyone interested in it. Mail us at adgraph@debjit.dev for issues you’re facing or custom GraphQL queries you need.

AdGraph Integration Features

Data Contribution

Integrate your app with AdGraph to contribute user interaction data. For example, tag user profiles with metadata like [cat, pet] when they view relevant content.

Free Integration

Adding data to AdGraph is free, with all integration costs sponsored by AdGraph.

Personalization

Leverage AdGraph’s preference data to personalize content or target users with relevant ads based on their onchain profile.

Build Services

Utilize AdGraph’s contract events to create your own services or enhance existing ones, making use of comprehensive user preference data.

AI Utilization

Use AdGraph’s AI to identify wallet addresses interested in specific images, enhancing targeting and personalization.

Ad Management

Upcoming services will provide APIs for directly fetching targeted ads to show users, simplifying ad management and delivery.