Endpoints
Ads Campaign Structure
Each client should attach the Facebook account to the WABA before the partner can work with data from META. See Meta's Official Documentation about Ads Campaign Structure.
Configuring Tracking Keywords
Activate CTWA-tracking for stack (number) before configure conversions. See How to manage the tracking of Signals API.
To effectively use this API, it is essential to configure the appropriate keywords that will be tracked.
See Trackable Events (Keywords).
Best Practices
Here are some Best Practices that you can follow to configure keywords for the Signals API:
Define your campaign objectives: Before you begin configuring keywords, it is essential to have a clear understanding of your campaign objectives. This will help you determine the types of keywords that you should track.
Identify relevant keywords: Once you have defined your campaign objectives, you can start identifying relevant keywords. These are the words and phrases that users are likely to search for when looking for products or services related to your campaign. Try to configure "unique" keywords to track - it will help avoid false-positive results
Configure the Signals API: After identifying keywords, you can configure the Signals API to track the performance of each group of keywords.
Monitor performance: Once you have configured the Signals API to track your keywords, it is important to monitor performance regularly. This will help you identify areas where you need to make changes to optimize your campaigns.
Analyzing Results
The Signals API provides the capability to read data at various levels, offering flexibility and granularity in the data you can access. Depending on your use case, you can choose to read data at the campaign, ad group, ad, or keyword level.
Ad Overview: This provides an overview of your ad campaign's performance, including metrics such as impressions, clicks, and spend. This information is updated on a daily basis, allowing you to stay up-to-date with your campaign's progress.
Ad Daily Insights: Detailed day-by-day information is available to help you compare campaign results over time. This allows you to identify trends and patterns in your campaign's performance and make informed decisions about how to optimize your advertising efforts. This information is updated on a daily basis.
Conversion Insights: The API provides summary statistics per conversion, allowing you to track how well your keywords are performing. This information is updated on a daily basis, giving you insights into your campaign's conversion rates.
Events List: For granular information about each conversion event, the API provides an events list that is updated instantly. This feature allows you to track individual events and analyze their impact on your campaign's overall performance.
Signals Endpoints
Base-URL
pageAuth and Base URLRetrieve Client's Facebook Accounts IDs
To retrieve the client_id
of clients - check Get List of Clients.
Important! Make sure you use HUB Base URL prefix for Get List of Clients.
Signals API don't support /partners endpoint.
Retrieve list of attached Facebook accounts of the client
GET
https://api.signals.360dialog.io/v1/clients/{client_id}/facebook-accounts
Send a GET
request and pick one Facebook account. In case of empty list - ask client to attach Facebook account first.
Retrieve list of Ad accounts related to the client's Facebook account
GET
https://api.signals.360dialog.io/v1/clients/{client_id}/facebook-accounts/{facebook_account}
Send a GET
request and pick the Ad account.
Retrieve list of Ads related to client's Ad account
GET
https://api.signals.360dialog.io/v1/app/{app_id}/ads/account/{ad_account_id}
Send a GET
request and read list of Ads.
To work with pagination concept: offset
and limit
params are available.
Query Parameters
Name | Type | Description |
---|---|---|
offset | integer | Starts from 0 |
limit | integer | From 1 to 100; Default: 20 |
schema
For assistance with Signals endpoints, please contact our Support Team.
Meta Ads
Get Ads
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/ads/account/{ad_account_id}
Return paginated ad list for given app_id
and fb ad_account_id
Request Example
curl --request GET
--url [base-url] /v1/clients/client_id/apps/app_id/ads/account/ad_account_id
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
ad_account_id* | string | |
app_id* | string | |
client_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
campaign_id | string | Example: |
limit | integer | >= 1 <= 100
Default: |
offset | integer | >= 0
Default: |
Get Ad
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/ads/{ad_id}
Return ad by id
and app_id
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/ads/ad_id
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
ad_id* | string | |
app_id* | string | |
client_id* | string |
Get Ads Insights
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/ads/{ad_id}/insights
Return Multiple Ad Insights from Meta for given app_id
, ad_id
and date intervals
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/ads/ad_id/insights
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
ad_id* | string | |
app_id* | string | |
client_id* | string |
Refresh Ads Insights
POST
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/ads/account/{ad_account_id}/refresh
Refresh Ad Insights for given ad account
Request Example
curl --request POST
--url [base-url]/v1/clients/{client_id}/apps/{app_id}/ads/account/{ad_account_id}/refresh
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
ad_account_id* | string | |
app_id* | string | |
client_id* | string |
Refresh Ad Insights
POST
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/ads/{ad_id}/refresh
Refresh Ad insights for given ad
Request Example
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/ads/ad_id/refresh
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
ad_id* | string | |
app_id* | string | |
client_id* | string |
Meta Campaigns
Get Campaigns
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/campaigns/account/{ad_account_id}
Return paginated Campaign list for given app_id
and ad_account_id
Request Example
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/campaigns/account/ad_account_id
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
ad_account_id* | string | |
app_id* | string | |
client_id* | string |
Get Campaign
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/campaigns/{campaign_id}
Return campaign by id
and app_id
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/campaigns/campaign_id
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
campaign_id* | string | |
app_id* | string | |
client_id* | string |
Get Campaign Insights
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/campaigns/{campaign_id}/insights
Return campaign insights for given app_id
, ad_id
and date intervals
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/campaigns/campaign_id/insights
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
ad_account_id* | string | |
app_id* | string | |
client_id* | string |
Refresh Campaigns Insights
POST
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/campaigns/account/{ad_account_id}/refresh
Refresh campaign insights for given Ad Account
Request Example
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/campaigns/account/ad_account_id/refresh
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
ad_account_id* | string | |
app_id* | string | |
client_id* | string |
Refresh Campaign Insights
POST
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/campaigns/{campaign_id}/refresh
Refresh campaign insights for given Campaign
Request Example
curl --request POST
--url [base-url]/v1/clients/{client_id}/apps/{app_id}/campaigns/{campaign_id}/refresh
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
campaign_id* | string | |
app_id* | string | |
client_id* | string |
Events
Events are single instances within your conversion funnel.
Once enabled, Signals automatically tracks default events: button
, button_reply
, list_reply,
conversation
, engagement
, so there is no need for pre-configuration.
You also have the flexibility to create text-based conversions at any time by using the Event type "conversation
" and specifying the Keyword. To set up the Conversion event, you can use the endpoint described below.
Event Type | |
---|---|
| Auto-trackable event - quick button reply from lead to business |
| Auto-trackable event - quick button reply from lead to business |
| Auto-trackable event - quick list-option reply from lead to business |
| Auto-trackable event - quick list-option reply from lead to business |
| Auto-trackable event - one lead sent 1st message to business |
| Configurable event - pick main conversion for campaign from list of available events |
| Auto-trackable event - one lead sent 2nd message to business |
| Configurable Text-based event - " |
Currently, the tracking of a "Conversation" Event is limited to incoming messages from outbound sources. We are actively working to enable tracking for messages sent by the business in the near future.
Create converted event
POST
[signals-base-url]/v1/clients/client_id/apps/app_id/converted_events
Request Example
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/converted_events
--header 'Accept: application/json'
--header 'Authorization: Bearer'
--header 'Content-Type: application/json'
--data '{ "campaign_id": "23851172049950328", "type": "button", "type_id": "63c14b9487dd821c0be8a0b6", "type_value": "product ordered"
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
client_id* | string |
Request Body
Name | Type | Description |
---|---|---|
campaign_id* | string | |
type* | string | Allowed values: |
type_value | string | |
type_id | string |
Get Events Types
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/event_types
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/event_types
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
client_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
date_from* | string | |
date_to* | string | |
event_type_id | string | Example: |
event_type | string | Allowed values: |
ad_id | string | |
limit | integer | >= 1 <= 1000 |
Get Events
GET
[signals-base-url]v1/clients/{client_id}/apps/{app_id}/events
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/events
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
client_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
date_from* | string | |
date_to* | string | |
ad_id | string | Example: |
event_type | string | Allowed values: |
limit | String | >= 1 <= 1000 |
event_type_id | string | Example: |
offset | String | >= 0
Default: |
Export Events
GET
[signals-base-url]v1/clients/{client_id}/apps/{app_id}/events/export
Export events in a CSV file
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/events/export
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
client_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
date_from* | string | |
date_to* | string | |
ad_id | string | Example: |
event_type | string | Allowed values: |
limit | String | >= 1 <= 1000 |
event_type_id | string | Example: |
offset | String | >= 0
Default: |
Get Event Stats
GET
[signals-base-url]v1/clients/{client_id}/apps/{app_id}/standalone-events-stats
Return stats from standalone Events
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/standalone-events-stats
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
client_id* | string |
If you want to get the conversion event for all numbers associated with the business account, you can use the group endpoint. It allows for bulk configuration.
Get Events Groups
GET
[signals-base-url]v1/clients/{client_id}/apps/{app_id}/event_groups
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/event_groups
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
client_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
ad_id | string | |
limit | integer | |
event_type_id | string | Examples: |
event_type | string | Allowed values: |
offset | integer | |
status | string | Allowed values: |
Creating an Ad Campaign
Facebook Account
Get Facebook Accounts
GET
[signals-base-url]v1/clients/{client_id}/apps/{app_id}/facebook-accounts
Request Example
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/facebook-accounts
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
--header 'Content-Type: application/json'
--data '{ "temporary_token": "63c14b9487dd821c0be8a0b6" }'
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
client_id* | string |
Create Facebook Account
POST
[signals-base-url]/v1/clients/client_id/apps/app_id/facebook-accounts
Request Example
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/facebook-accounts
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
--header 'Content-Type: application/json'
--data '{ "temporary_token": "63c14b9487dd821c0be8a0b6" }'
Path Parameters
Name | Type | Description |
---|---|---|
client_id* | string | |
app_id* | string |
Request Body
Name | Type | Description |
---|---|---|
temporary_token* | string |
Get Facebook Ad Accounts
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/facebook-accounts/{facebook_account_id}
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/facebook-accounts/facebook_account_id
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
Path Parameters
Name | Type | Description |
---|---|---|
client_id* | string | |
app_id* | string | |
facebook_account_id* | string |
Ad Campaign
Create Facebook Ad Campaign
POST
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/facebook-accounts
Request Example
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/facebook-accounts/facebook_account_id/facebook-ad-accounts/facebook_ad_account_id/facebook-ad-campaign
--header 'Accept: application/json'
--header 'Authorization: Bearer'
--header 'Content-Type: application/json'
--data '{ "campaign_name": "TEST CTWA POC", "daily_budget": 100, "start_time": "2023-09-18T11:36:41.356737", "end_time": "2023-09-19T12:36:41.356747", "billing_event": "IMPRESSIONS", "body": "Grow your business 5x", "title": "Chat with us", "page_id": "460293477343848", "targeting": { "age_min": 18, "age_max": 65, "gender": "men", "geo_locations": { "countries": [ "US" ], "cities": [ { "key": "1910415" } ] } }, "image_hash": "a275aa36c7b2e6d0105bf683c55e7bd6" }'
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
client_id* | string | |
facebook_ad_account_id* | string | |
facebook_account_id* | string |
Request Body
Name | Type | Description |
---|---|---|
campaign_name* | string | Example: |
title* | string | Example: |
body* | string | Example: |
billing_event* | string | Allowed values: |
end_time* | string <date-time> | Example: |
start_time* | string <date-time> |
|
daily_budget* | integer | Example: |
gender* | string | Allowed values: |
age_max* | integer | <= 65 |
targeting* | String | Facebook ad campaign targeting configuration |
page_id* | string | Example: |
key* | string | Example: |
cities | array | |
countries | array[string] | Example: [ |
geo_locations* | Targeting geo locations | |
image_hash* | string | Example: |
age_min* | integer | >= 18 |
Get Facebook Pages ID
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/facebook-accounts/{facebook_account_id}/facebook-ad-accounts/{facebook_ad_account_id}/facebook-pages
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/facebook-accounts/facebook_account_id/facebook-ad-accounts/facebook_ad_account_id/facebook-pages
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
client_id* | string | |
app_id* | string | |
facebook_account_id* | string | |
facebook_ad_account_id* | string |
Get Facebook Ad Images
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/facebook-accounts/{facebook_account_id}/facebook-ad-accounts/{facebook_ad_account_id}/facebook-ad-images
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/facebook-accounts/facebook_account_id/facebook-ad-accounts/facebook_ad_account_id/facebook-ad-images
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
Path Parameters
Name | Type | Description |
---|---|---|
client_id* | string | |
app_id* | string | |
facebook_account_id* | string |
Upload Image
POST
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/facebook-accounts/{facebook_account_id}/facebook-ad-accounts/{facebook_ad_account_id}/upload-facebook-ad-image
Request Example
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/facebook-accounts/facebook_account_id/facebook-ad-accounts/facebook_ad_account_id/upload-facebook-ad-image
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
--header 'Content-Type: multipart/form-data'
--form img=
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
client_id* | string | |
facebook_ad_account_id* | string | |
facebook_account_id* | string |
Request Body
Name | Type | Description |
---|---|---|
img* | string |
Get Targeting Geolocations
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/facebook-accounts/{facebook_account_id}/facebook-ad-accounts/{facebook_ad_account_id}/targeting-geolocations
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/facebook-accounts/facebook_account_id/facebook-ad-accounts/facebook_ad_account_id/targeting-geolocations
--header 'Accept: application/json'
--header 'Authorization: Bearer '
Path Parameters
Name | Type | Description |
---|---|---|
client_id* | string | |
app_id* | string | |
facebook_account_id* | string | |
facebook_ad_account_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
query* | string |
Text-based Trackable Events (Keywords)
Get Keywords
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/keywords
Request Example
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/keywords
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
Path Parameters
Name | Type | Description |
---|---|---|
client_id* | string | |
app_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
ad_id | string | Example: |
offset | integer | |
limit | integer | |
is_shared | boolean | Example: |
status | string | Allowed values: |
Create Keyword
POST
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/keywords
Example Request
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/keywords
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
--header 'Content-Type: application/json'
--data '{ "keyword": "Product ordered" }'
Path Parameters
Name | Type | Description |
---|---|---|
client_id* | string | |
app_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
ad_id | string | Example: |
Request Body
Name | Type | Description |
---|---|---|
keyword* | string | Example: |
Get Keyword
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/keywords/{keyword_id}
Example Request
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/keywords/keyword_id
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
client_id* | string | |
keyword_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
ad_id | string | |
is_shared | boolean |
Delete Keyword
DELETE
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/keywords/{keyword_id}
Example Request
curl --request DELETE
--url [base-url]/v1/clients/client_id/apps/app_id/keywords/keyword_id
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
keyword_id* | string | |
client_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
ad_id | string | |
delete | boleean |
Update Keyword
PATCH
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/keywords/{keyword_id}
Disable existing keyword and create a new one
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
keyword_id* | string | |
client_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
ad_id | string |
Request Body
Name | Type | Description |
---|---|---|
keyword* | string | Example: |
Create Shared Keyword
POST
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/keywords/shared
Create shared keyword > This keyword will be "shared" with all phone numbers associated with the account.
Path Parameters
Name | Type | Description |
---|---|---|
client_id* | string | |
app_id* | string |
Request Body
Name | Type | Description |
---|---|---|
keyword* | string | Example: |
Sales
Create Sale
POST
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/sales
Request Example
curl --request POST
--url [signals-base-url]/v1/clients/client_id/apps/app_id/sales
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
--header 'Content-Type: application/json'
--data '{ "phone": "123456789", "amount": 100 }'
Path Parameters
Name | Type | Description |
---|---|---|
app_id* | string | |
client_id* | string |
Request Body
Name | Type | Description |
---|---|---|
phone* | string | Example: |
amount* | number | Example: |
Get Sale Insights
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/ads/{ad_id}/sale-insights
Return sale insight for given app_id
, ad_id
and date
intervals
Request example
curl --request GET
--url[signals-base-url]/v1/clients/client_id/apps/app_id/ads/ad_id/sale-insights
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
Path Parameters
Name | Type | Description |
---|---|---|
ad_id* | string | |
client_id* | string | |
app_id* | string |
Query Parameters
Name | Type | Description |
---|---|---|
date_from* | string | |
date_to* | string |
Receive instant notifications
You can subscribe for instant postback for each conversion keyword. When you opt-in for this feature, the Signals API will automatically call your API every time the system detects a conversion event, allowing you to receive real-time updates on your campaign's performance.
Get list of Signals
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/ads/{ad_id}/signals
Example Request
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/ads/ad_id/signals
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
ad_id* | string | |
client_id* | string | |
app_id* | string |
Set Signal Of Ad
POST
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/ads/{ad_id}/signal
Example Request
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/ads/ad_id/signals
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
ad_id* | string | |
client_id* | string | |
app_id* | string |
Request Body
Name | Type | Description |
---|---|---|
url | string <uri> |
|
Get Signal Of Ad
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/ads/{ad_id}/signal
Get Signal url of Ad
Example Request
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/ads/ad_id/signal
--header 'Accept: application/json'
--header 'Authorization: Bearer '
Path Parameters
Name | Type | Description |
---|---|---|
ad_id* | string | |
client_id* | string | |
app_id* | string |
Set Signal of Keyword
POST
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/ads/{ad_id}/keywords/{keyword_id}/signal
Set signal of keyword
Example Request
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/ads/ad_id/keywords/keyword_id/signal
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
--header 'Content-Type: application/json'
--data '{ "url": "https://example.com" }'
Path Parameters
Name | Type | Description |
---|---|---|
keyword_id* | string | |
client_id* | string | |
app_id* | string | |
ad_id* | string |
Request Body
Name | Type | Description |
---|---|---|
url | string<url> |
Get Signal Of Keyword
GET
[signals-base-url]/v1/clients/{client_id}/apps/{app_id}/ads/{ad_id}/keywords/{keyword_id}/signal
Example Request
curl --request GET
--url [base-url]/v1/clients/client_id/apps/app_id/ads/ad_id/keywords/keyword_id/signal
--header 'Accept: application/json'
--header 'Authorization: Bearer'
Path Parameters
Name | Type | Description |
---|---|---|
ad_id* | string | |
client_id* | string | |
app_id* | string | |
keyword_id* | string |
Set Signal of Event
POST
[signals-base-url]/v1/clients/client_id/apps/app_id/ads/ad_id/events/session_start/signal
Example Request
curl --request POST
--url [base-url]v1/clients/client_id/apps/app_id/ads/ad_id/events/session_start/signal
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
--header 'Content-Type: application/json'
--data '{ "url": "https://example.com" }'
Path Parameters
Name | Type | Description |
---|---|---|
client_id* | String | |
app_id* | String | |
ad_id* | String | |
event_type* | str | Allowed value: |
Get Signal of Event
GET
[signals-base-url]/v1/clients/client_id/apps/app_id/ads/ad_id/events/session_start/signal
Example Request
curl --request POST
--url [base-url]/v1/clients/client_id/apps/app_id/ads/ad_id/events/session_start/signal
--header 'Accept: application/json'
--header 'Authorization: Bearer 122'
--header 'Content-Type: application/json'
--data '{ "url": "https://example.com" }'
Path Parameters
Name | Type | Description |
---|---|---|
client_id* | string | |
app_id* | string | |
ad_id* | string | |
event_type* | string | Allowed value: session_start |
Last updated