Reference Guide
Start typing to search…

Advertisers

Manage advertiser entities and their associations with deals and campaigns

Advertisers

Advertisers represent the companies or entities purchasing advertising through the ADP platform. They are associated with Deals and campaigns.

Overview

An Advertiser entity contains:

  • Identification - Name, contact information
  • Settings - Configuration and preferences
  • Associations - Links to deals and campaigns

Query Advertisers

Basic Query

query GetAdvertisers {
  dream_adserver {
    advertisers(limit: 10) {
      edges {
        advertiser_id
        advertiser_name
        advertiser_desc
      }
      total_count
    }
  }
}

Filtered Query

query GetFilteredAdvertisers($filter: JSON, $sort: JSON) {
  dream_adserver {
    advertisers(
      filter: $filter
      sort: $sort
      limit: 25
      offset: 0
    ) {
      edges {
        advertiser_id
        advertiser_name
        advertiser_desc
        advertiser_ext_id
        advertiser_ext_ids
        advertiser_modification_time
      }
      total_count
    }
  }
}

Variables:

{
  "filter": {
    "advertiser_name": {"like": "%Corp%"}
  },
  "sort": {
    "advertiser_name": "asc"
  }
}

{
  "filter": {
    "advertiser_id": {"=": 1001}
  }
}

Available Fields

⚠️

The DASAdvertiser type contains only 6 fields. Contact information (email, phone, company name, address) is NOT stored in the advertiser object. Use custom fields or external CRM integration for contact data.

FieldTypeDescription
advertiser_idInt!Unique identifier
advertiser_nameString!Advertiser name
advertiser_descStringDescriptive information about the advertiser
advertiser_ext_idStringID of the advertiser in external database
advertiser_ext_idsJSONJSON string containing pairs of data sources and IDs
advertiser_modification_timeStringLast modification time (format: yyyy-mm-ddThh:mm:ss.s+zzzzzz)

Mutations

Create/Update Advertiser

mutation SetAdvertiser($advertiser: DASAdvertiserInput!) {
  dream_adserver {
    set_advertiser(advertiser: $advertiser) {
      status
    }
  }
}

Variables:

{
  "advertiser": {
    "advertiser_name": "Example Corp",
    "advertiser_desc": "Digital advertising company",
    "advertiser_external_id": "EXT-12345",
    "advertiser_provider_name": "ADP"
  }
}
ℹ️

Required fields: advertiser_name, advertiser_external_id, advertiser_provider_name. The mutation returns only a status string, not the advertiser object.

Next Steps

Related