Supported features<\/h2>\n\n\n\n
The Conversion API supports:<\/p>\n\n\n\n
- \n
- Web and mobile app conversion events<\/li>\n\n\n\n
- Detailed conversion events with attributed data including product id, transaction value, and more<\/li>\n\n\n\n
- Both deterministic and probabilistic attribution methods<\/li>\n\n\n\n
- Customizable event properties and parameters<\/li>\n\n\n\n
- Compatible with existing Pixel tracking and MMP integration<\/li>\n<\/ul>\n\n\n\n
Getting started<\/h2>\n\n\n\n
1.Prerequisites<\/h3>\n\n\n\n
Before implementing the Conversion API, ensure you have:<\/p>\n\n\n\n
- \n
- An active SmartNews Ads account<\/li>\n\n\n\n
- For web campaigns: A SmartNews Pixel created in Event Manager<\/li>\n\n\n\n
- For app campaigns: A Google or Apple app store ID and a Mobile Measurement Partner such as Adjust or AppsFlyer<\/li>\n<\/ul>\n\n\n\n
2. Download authentication credentials (business admins only)<\/h3>\n\n\n\n
Log in to Business Manager<\/a>, select the relevant business from the drop-down menu, and navigate to the \u201cDeveloper Apps\u201d tab. Click on \u201cConversion API\u201d and follow the on-screen instructions to download your API credentials.<\/p>\n\n\n\n
![\"\"](\"https:\/\/help-ads.smartnews.com\/wp-content\/uploads\/2025\/02\/image-2-1-1024x291.png\")
<\/figure>\n\n\n\nIn the downloaded json file, you\u2019ll find your partner name and access token.<\/p>\n\n\n\n
\nAll parties accessing or using the Conversion API\u2014whether you or a third party designated by you\u2014are subject to the SmartNews Ads API Terms of Use<\/a>.<\/p>\n<\/div><\/div>\n\n\n\n
3. Implementation<\/h3>\n\n\n\n
Use the credentials obtained above to begin using Conversion API in your app.<\/p>\n\n\n\n
Web implementation<\/h4>\n\n\n\n
For web conversions, you\u2019ll need to:<\/p>\n\n\n\n
1<\/i>Create a Pixel in Event Manager (required even if not using client-side tracking).<\/span><\/h6>\n\n\n\n
2<\/i>Include your pixel_tag_id<\/mark> in your API calls, along with your partner name and access token as common request parameters.<\/span><\/h6>\n\n\n\n
3<\/i>Set up server-side event tracking.<\/span><\/h6>\n\n\n\n
Example API call for web conversion:<\/p>\n\n\n\n
{\n\t\"action_source\": \"web\",\n\t\"event_name\": \"purchase\",\n\t\"pixel_tag_id\": \"9112675ff25eb25f580feb82\",\n\t\"event_source_url\": \"http:\/\/www.smartnews.com?store=abc\",\n\t\"click_id\": \"UnoPeo4IDmEwnHepAAEA\",\n\t\"event_time\": 1473668802,\n\t\"properties\": {\n\t\t\"currency\": \"JPY\",\n\t\t\"value\": 5000,\n\t\t\"content_ids\": ['12345', '456789'],\n\t\t\"content_type\": \"product\"\n\t}\n}<\/code><\/pre>\n\n\n\nSetting up postbacks using GET and third-party tracking tools<\/h3>\n\n\n\n
You can implement the Conversion API using either GET or POST requests. Here\u2019s how to set up using GET requests with third-party tracking tools:<\/p>\n\n\n\n
1<\/i>Tracking URL Configuration:<\/h6>\n\n\n\n
The tracking URL you\u2019ll use in SmartNews Ads Manager UI must include the click_id parameter and can include additional parameters:<\/p>\n\n\n\n
<https:\/\/xyz.com\/cf\/r\/67b6a149ff421a001274f089?click_id={click_id}&ad_id={ad_id}&campaign_id={campaign_id}&ad_group_id={ad_group_id}&ad_account_id={ad_account_id}><\/code><\/pre>\n\n\n\nImportant<\/strong>\n\nThe `{click_id}` parameter must remain enclosed in curly brackets `{}`. SmartNews supports the following dynamic macros:\n\n- {click_id}\n- {ad_id}\n- {campaign_id}\n- {ad_group_id}\n- {ad_account_id}.\n\nFor more details, see: SmartNews dynamic URL macros<\/a><\/code><\/pre>\n\n\n\n2<\/i>Postback URL Configuration:<\/span><\/h6>\n\n\n\n
Use the following format for your postback URL, replacing the highlighted parameters:<\/p>\n\n\n\n
<https:\/\/log.smartnews-ads.com\/conversion_api\/v1\/[REPLACE_with_partner_name]?action_source=web&pixel_tag_id=[REPLACE_with_Pixel_tag_id]&event_name=[Replace_with_Event_Name]&click_id=[REPLACE_WITH_CLICK_ID]><\/code><\/pre>\n\n\n\n- \n
- Partner_Name:<\/strong> The numeric value provided in your approval email (e.g., “9492446”)<\/li>\n\n\n\n
- Pixel_Tag_Id:<\/strong> The alphanumeric ID of your Pixel Tag created in Event Manager<\/li>\n<\/ul>\n\n\n\n
![\"\"](\"https:\/\/help-ads.smartnews.com\/wp-content\/uploads\/2025\/02\/image-4-1024x490.png\")
<\/figure>\n\n\n\n- \n
- Event_Name:<\/strong> Choose from supported event types<\/a>. Do not leave any empty spaces in the event name.<\/li>\n\n\n\n
- Click_Id:<\/strong> The variable your tracking tool uses to collect
click_id<\/code><\/li>\n<\/ul>\n\n\n\nCommon
click_id<\/code> variables by platform:<\/strong><\/p>\n\n\n\n- \n
- Voluum:
{externalid}<\/code><\/li>\n\n\n\n- ClickBank:
{ext_clid}<\/code><\/li>\n\n\n\n- Everflow:
{sub1}<\/code><\/li>\n\n\n\n- RedTrack:
{ref_id}<\/code><\/li>\n\n\n\n- ClickFlare:
{external_id}<\/code><\/li>\n\n\n\n- Tune:
{aff_click_id}<\/code><\/li>\n\n\n\n- DigiStore24:
{cid}<\/code><\/li>\n\n\n\n- CAKE:
#s2#<\/code><\/li>\n<\/ul>\n\n\n\nExample completed postback URL (using Voluum):<\/strong><\/p>\n\n\n\n
<https:\/\/log.smartnews-ads.com\/conversion_api\/v1\/97559088?action_source=web&pixel_tag_id=69be6b63fe1f47449c3aa6d7&event_name=Purchase&click_id={externalid}><\/code><\/pre>\n\n\n\nExample of Voluum traffic source setup screen using SmartNews parameters:<\/strong><\/p>\n\n\n\n
![\"\"](\"https:\/\/help-ads.smartnews.com\/wp-content\/uploads\/2025\/02\/image-5-1024x776.png\")
<\/figure>\n\n\n\nApp implementation<\/h4>\n\n\n\n
For app conversions, you\u2019ll need to:<\/p>\n\n\n\n
1<\/i>Provide your app store ID and platform in your API calls, along with your partner name and access token as common request parameters.<\/span><\/h6>\n\n\n\n
2<\/i>Implement server-side event tracking.<\/span><\/h6>\n\n\n\n
Example API call for app conversion:<\/p>\n\n\n\n
{\n\t\"action_source\": \"app\",\n\t\"event_name\": \"Purchase\",\n\t\"store_id\": \"jp.gocro.smartnews.android\",\n\t\"mobile_platform\": \"Android\",\n\t\"click_id\": \"UnoPeo4IDmEwnHepAAEA\",\n\t\"event_time\": 1473668802,\n\t\"properties\": {\n\t\t\"currency\": \"JPY\",\n\t\t\"value\": 5000,\n\t\t\"content_ids\": ['12346'],\n\t\t\"content_type\": \"product\"\n\t\t}\n}<\/code><\/pre>\n\n\n\nFAQ<\/h2>\n\n\n\n
Q: Can I use Conversion API alongside Pixel tracking?<\/strong><\/p>\n\n\n\n
A: Yes, the Conversion API can work alongside Pixel tracking or MMP integration. SmartNews automatically deduplicates conversions from these sources using a best-effort approach.<\/p>\n\n\n\n
Q: Do I need to implement Pixel tags if I\u2019m using the Conversion API for app conversions?<\/strong><\/p>\n\n\n\n
A: No, you don\u2019t need to implement Pixel tags for tracking conversions in your app. However, you will need to select a Mobile Measurement Partner (MMP).<\/p>\n\n\n\n
Q: What kind of attributed data is supported\uff1f<\/strong><\/p>\n\n\n\n
A: As of December 2025, the following data is supported:<\/p>\n\n\n\n
- \n
- content_ids (product ID)<\/li>\n\n\n\n
- value (event\/transaction value)<\/li>\n\n\n\n
- currency (currency ID string: JPY, USD, etc.)<\/li>\n\n\n\n
- quantity (number of items in checkout)<\/li>\n\n\n\n
- store_id (Android or iOS app store ID)<\/li>\n<\/ul>\n\n\n\n
For details, check the Conversion API developer documentation<\/a>.<\/p>\n\n\n\n
Q: Do you support passing payout<\/mark> or event_value<\/mark> in requests?<\/strong><\/p>\n\n\n\n
A: Yes, but only in POST requests and not GET requests. We are working to add support for this in GET requests as well.<\/p>\n\n\n\n
Q: Will my authorization token for Conversion API work for Marketing or Reporting API as well?<\/strong><\/p>\n\n\n\n
A: No, you need to fill out a different form and get separate approval for Marketing API. Refer to the Marketing API help page<\/a> and submit the application form.<\/p>\n\n\n\n
Q: Can I distinguish between conversion data from Conversion API and regular Pixel tracking?<\/strong><\/p>\n\n\n\n
A: No, you cannot distinguish between Conversion API data and regular Pixel tracking data in the management dashboard. To confirm whether the Conversion API has been implemented, check the logs in your API development environment.<\/p>\n\n\n\n
Related articles<\/h2>\n\n\n\n
- \n
- Conversion API Developer Documentation: Developer Documentation<\/a><\/li>\n\n\n\n
- SmartNews Ads API Terms of Use:\n
- \n
- Terms of Use (English)<\/a><\/li>\n\n\n\n
- Terms of Use (Japanese)<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
- \n
- Marketing API Resources:\n
- \n
- Marketing API Documentation<\/a><\/li>\n\n\n\n
- Marketing API Developer Guide<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
For additional assistance or questions about implementation, please contact your SmartNews Ads representative.<\/p>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"This guide will walk you through the process of integrating with the SmartNews Ads Conversion API, designed to help advertisers share conversion data more reliably and securely with SmartNews Ads platform. The Conversion API enhances campaign measurement accuracy and increases signal volume, leading to improved advertising performance. Detailed Conversion API documentation > Supported features The Conversion API supports: Getting started 1.Prerequisites Before implementing the Conversion API, ensure you have: 2. Download authentication credentials (business admins only) Log in to Business Manager, select the relevant business from the drop-down menu, and navigate to the \u201cDeveloper Apps\u201d tab. Click on \u201cConversion API\u201d and follow the on-screen instructions to download your API credentials. […]","protected":false},"author":4,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[206,1],"tags":[],"label":[],"class_list":["post-5563","post","type-post","status-publish","format-standard","hentry","category-tracking-en","category-1"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts\/5563","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/comments?post=5563"}],"version-history":[{"count":22,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts\/5563\/revisions"}],"predecessor-version":[{"id":8973,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts\/5563\/revisions\/8973"}],"wp:attachment":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/media?parent=5563"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/categories?post=5563"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/tags?post=5563"},{"taxonomy":"label","embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/label?post=5563"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- Marketing API Developer Guide<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
- Marketing API Documentation<\/a><\/li>\n\n\n\n
- Terms of Use (Japanese)<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
- SmartNews Ads API Terms of Use:\n
- Conversion API Developer Documentation: Developer Documentation<\/a><\/li>\n\n\n\n
- ClickBank:
- Click_Id:<\/strong> The variable your tracking tool uses to collect
- Pixel_Tag_Id:<\/strong> The alphanumeric ID of your Pixel Tag created in Event Manager<\/li>\n<\/ul>\n\n\n\n
- Partner_Name:<\/strong> The numeric value provided in your approval email (e.g., “9492446”)<\/li>\n\n\n\n