AdWords

Pipelining Data to AdWords

Configuring data pipelining is easy and requires no SDK updates or any other updates to the app code itself. Sending data to Adwords requires copying and pasting 1 link from the Google ads dashboard into SOOMLA Dashboard. The full details can be found inside the SOOMLA dashboard or in the rest of the article below.

Data Delay

3 days - AdWords API can't accept updates of past revenue per user

Special Limitations

N/A 

Integration Steps

1. Click on one of your apps -> Click Integrations
   If your app is not live, you will be automatically redirected to Integrations page
2. Go to the “Data Pipelining” tab and click on Google Ads logo
3. You will need to supply the Link Id in the SOOMLA dashboard. Let's see how to get them in Google Ads dashboard:
1. Go to Google Ads dashboard 
2. In the menu go to Tools -> Linked accounts -> Third-party app analytics -> Create new link to provider 
3. In the dialog box that opens up:
   1. Choose "Other provider" in "App analytics provider" 
   2. Type 4978245588 in the provider ID field
   3.  Select your app and click on CREATE LINK ID button 
   4. Copy the link id  
4. Paste the Link Id you just generated for the package name you want to activate  

The fields will be saved when you click "Enter" or when you click somewhere outside of them. Make sure you see a small loader that indicates that the field was saved.  

Note, it might take a few minutes until the Link ID will be valid for usage.

Verify the data shows up in Adwords 

To see the data in Adwords follow these steps: 

1. From the menu select - Tools --> Measurement --> Conversions
2. Choose "Third-party app analytics"
3. A screen will open up with events from your Linked accounts - find the SOOMLA event and select it for Import

Q&A

Question: There's nowhere to put the credentials

Answer: Your app is not live with SOOMLA yet. On the day after you went live with SOOMLA you will see a list of package names and you can set the credentials for one of them.

Question: Why is the data sent with delay.

Answer: The revenue from ad-networks is only posted in their reporting APIs at the end of the day. SOOMLA has to wait for all networks to post results and then run our own calculations. SOOMLA has to wait 3 days before sending data because AdWords API can't accept updates for past revenue per user.

Question: What is the format of the event SOOMLA sends to Adwords

Answer: This is the event format:

{
    "link_id": <the link id you provided>,
    "app_event_type": "custom",
    "app_event_name": "adRevenue",
    "rdid": <Advertising id of the user>,
    "id_type": <depends on platform>,
    "lat": 0,
    "app_version": <the version of your app>,
    "os_version": '1.0.0',
    "sdk_version": user_row[:version],
    "timestamp": <day of revenue>,
    "value": <the ad revenue>,
    "currency_code": 'USD'
}