X (Twitter) Web - Web to App Campaigns

Follow
Avatar
Fernando Cabral
Updated
Setting Up X (Twitter) Ads
Web & Mobile 
Web-to-App 
Configure for Web & Mobile Web-to-App Campaigns
Ad Mon Aggregation
Not supported
Data Discrepancy
Details coming soon

 

This article details how to configure Singular mobile, PC and Console install attribution for X (Twitter) web campaigns (non-app campaigns). For directions on configuring and attributing X (Twitter) app campaigns, see our X (Twitter) Ads Attribution guide.

X (Twitter) campaigns do not support MMP trackers URLs, so all conversions are measured with click-through attribution only, setting Singular Tracker in the Website URL. 

Overview

Singular’s web-to-app attribution solutions empower marketers to run web campaigns that drive app installs across Mobile, PC, and Console platforms. See more details on Web, Web-to-App, PC, & Console Campaign Optimization.

Add X (Twitter) Web Partner Configuration in Singular

Add X (Twitter) Web CAPI Partner Configuration in Singular

  1. Go to Singular > Attribution > Partner Configuration
  2. Click “Add a Partner”, and type and choose “Twitter Web CAPI”
  3. In the dialog, choose your App and App site (platform) to configure. Mobile, PC, and console apps are supported with this integration
  4. Paste in your app's "Access Token", "Access Secret", "Consumer Key", "Consumer Secret", "Install Event ID" and "Pixel ID".
  5. Optionally configure any additional events to send to X (Twitter) and map it to a "X Event ID"


  6. Click "Save" to finish.
Create Singular Link for "Twitter Web CAPI"

Create Singular Link for "Twitter Web CAPI"

  1. Go to Singular > Attribution > Manage Links
  2. Select your mobile app from the list of apps on the left
  3. Select "Create Link" -> Link Type "Partner" -> Source Name "Twitter Web CAPI"
  4. Continue through the step-by-step link creation. 
  5. Click "Generate"
  6. Copy the "Click-through Tracking Link" for the next step.
Set up your Twitter Web Campaign

Set up your Twitter Web Campaign

  1. In Twitter Ads Manager, create a campaign and select either the Sales or Website Traffic campaign objectives:
    • Sales - optimize from events that you've set up in your Singular Partner Configuration
    • Website Traffic - optimize to clicks

  2. When adding the media, set Singular Link from the section above to the Website URL
  3. Populate all the campaign macros manually, as X Ads doesn't handle link macros. Example:
    https://singular.sng.link/XXXXX/YYYY?pcn={campaign_name}&pscn={ad_group_name}&pcrn={ad_name}&wpsrc=Twitter%20Web%20CAPI&_forward_params=1&wpcn={campaign_name}&wpscn={ad_group_name}&wpcrn={ad_name}
    to 
    https://singular.sng.link/XXXXX/YYYY?pcn=Singular%20CName%20Test&pscn=Singular%20AdGroup%20Test1&pcrn=Singular%20Ad%20Test2&wpsrc=Twitter%20Web%20CAPI&_forward_params=1&wpcn=Singular%20CName%20Test&wpscn=Singular%20AdGroup%20Test1&wpcrn=Singular%20Ad%20Test2

FAQ

Where can you find the Access and Consumer Tokens and Secrets?
#
  1. If you didn't sign up to a X Developer Account, please follow the instructions from X Developer Platform to sign up and create an APP: X Ads API: Getting Started.
  2. With de Developer APP created, navigate to the X Developer Portal dashboard.
  3. Navigate to the "Projects & Apps" page, select the project and open the APP's credentials page.
  4. In the Keys and tokens page you will find all the API credentials for the integration:
Where can you find the X Event IDs and X Pixel ID?
#
  1. Navigate to the X Ads Manager page.
  2. Navigate to the "Tools & Events Manager" page.
  3. At the top copy your "X pixel", and at the table at the bottom copy your "Event IDs"

    If this is a new pixel or event, follow X Ad's step-by-step guide to create a "Pixel". Read more about Generating the Pixel and Creating Events.
What data does Singular send via API?
#
Parameter Details
conversion_time
  • Install or event timestamp.
event_id
  • A standard X Event ID. This value is used to assist X in the deduplication of events.
twclid
  • X (Twitter) click ID
  • automatically passed
hashed email
  • Optional if twclid is provided.
  • Hashed email may be passed as a Singular instrumented event attribute "ehash"
  • Hashed email value must be normalized and SHA 256 hashed
IP address
  • The Client IP Address
user agent
  • The user agent for the browser corresponding to the event
What are the limitations of X (Twitter) Conversions API?
#
  • There are no macros to automatically fill in the campaign data. If you want to have this breakdown in Singular you need to set this manually when adding the Website URL, as instructed in the "Set up your Twitter Web Campaign" menu above.
  • X Ads recommends that the X Conversion API be used to augment an existing X pixel implementation or when you are unable to implement JavaScript on your website.
  • For mobile integrations, X and Singular recommend passing mobile conversion data through Singular's dedicated mobile attribution integration with X Ads. If you are interested in passing mobile conversion data through X Conversions API, reach out to your Singular customer success manager.