Support Home > Campaign Management > Google DoubleClick Integration

Google DoubleClick Integration


The following document defines the process for creating a DoubleClick campaign within Kochava.

 

Data Needed Before Beginning Process:

  • App Bundle ID (Obtained from app developer, app manager or app store)
  • Advertiser ID (Provided by DoubleClick  ‘src=’ parameter of your floodlight tag)
  • Activity Tag (Provided by DoubleClick  ‘cat=’ parameter of your floodlight tag)
  • Group Tag (Provided by DoubleClick ‘type=’ parameter of your floodlight tag)
  • Authorization Token (Provided by DoubleClick)
  •  

    Floodlight Tag Example –

     

    • src is the advertiser ID that is the source of the Floodlight activity.
    • cat is the activity tag string, which Floodlight servers use to identify the activity group to which the activity belongs.
    • type is the group tag string, which identifies the activity group with which the Floodlight activity is associated.
    • u1, u2 ... (if available) are the custom Floodlight variable key-values.

     

    For more information on tracking DBM/DCM campaigns via Kochava have a look at this site:

    https://developers.google.com/app-conversion-tracking/third-party-trackers/doubleclick-integration

 

Use Cases for DoubleClick Campaign:

  • An app marketing campaign with Google DoubleClick has been created.

 

NOTE: The DoubleClick setup process for iOS and Android is similar and therefore this document will cover the setup for both operating systems, with specific differences noted.

NOTE: DoubleClick is one of Kochava’s integrated partners which claims its own installs, this type of integration is known as a SAN (Self Attributing Network). DoubleClick will always claim its own installs, with the exception of mobile web inventory or any inventory that does not have access to a device ID. This means that conversions claimed by DoubleClick may subsequently be attributed by Kochava to other networks. It is therefore expected for Kochava to show fewer installs than are shown in the DoubleClick system. It also means that Kochava does not impose the lookback window setup within Kochava on install claims, so the effective lookback window for post-impression and post-click installs will be the settings configured within the DoubleClick UI.

NOTE: Kochava must receive a valid device ID on every install.

NOTE: For mobile web inventory Kochava recommends using a smartlink and serving it via the DoubleClick ad server. For more information about smartlinks, refer to our Create a Smartlink support documentation.


Create a DoubleClick Campaign

  1. Log in to Kochava.
  2. Select the desired app.
  3. Select App Tools>Campaign Manager.
  4.  

    AppToolsCampaignManagerHD

     

  5. Click Add a Tracker or Select Segment Tools>Add a Tracker.
  6. a. Select the Campaign.
    b. Select the Segment.

     

    NOTE: In order to streamline the Campaign/Segment/Tracker creation process a feature has been added to allow the creation of campaigns and segments while creating a new tracker. For more information about creating a campaign or segment while adding a new tracker, refer to our Create an Install Campaign support document. support documentation.

     

     

  7. Enter the Tracker Name.
  8.  

    NOTE: When a Tracker is created, Kochava automatically generates a name for the Tracker. We recommend that you replace the Tracker name at this point with a clear name of your choosing.

     

  9. Select Tracker Type>Acquisition. (default setting)
  10. Select Media Partner>Doubleclick.
  11. Select an Agency Partner. (optional)
  12. Enter a Deeplink. (Not Required)
  13. Custom Parameters. (Not Required)
  14. Enter Pricing. (optional)
  15. Click Save. (If no further trackers need to be created).
  16. Click Save & Add Another Tracker. (If additional trackers need to be created).
  17.  

    A. Campaign and Segment selection/creation section.


Create an Install Postback Configuration

  1. Select App Tools>Partner Configuration.
  2.  

    AppToolsPartnerConfigurationHD

     

  3. Click Add a Configuration.
  4. Select Network Partner>Doubleclick.
  5. Click Go.
  6.  

    DoubleClickChoosePartnerHD

     

  7. Select Install>Postback Tools>Edit.
  8. Enter the App Bundle ID.
  9.  

    NOTE: For Android the Bundle ID is easily located in the URL of the app on the Google Play store (id=com.packagename). For iOS, refer to our Locating the Apple Bundle ID support documentation.

     

  10. Enter the Advertiser ID.
  11. Enter the Activity Tag.
  12. Enter the Group Tag.
  13. Enter the Authorization Token.
  14. Select the Delivery Delay. (optional)
  15. Select the Retry Atempts. (optional)
  16. Click Save.
  17.  

    A. Up to 10 floodlight tags may be added. In order to conserve space, the above image has been shortened.

     

    NOTE: With our integration we support multiple floodlight tags to be entered.


Create a Post-Install Postback Configuration

  1. Select App Tools>Partner Configuration.
  2.  

    AppToolsPartnerConfigurationHD

     

  3. Click Add a Configuration.
  4. Select Network Partner>Doubleclick.
  5. Click Go.
  6.  

    DoubleClickChoosePartnerHD

     

  7. Locate the desired Post-Install Event and Click Edit Postback.
  8. Enter the App Bundle ID.
  9.  

    NOTE: For Android the Bundle ID is easily located in the URL of the app on the Google Play store (id=com.packagename). For iOS, refer to our Locating the Apple Bundle ID support documentation.

     

  10. Enter the Advertiser ID.
  11. Enter the Activity Tag.
  12. Enter the Group Tag.
  13. Enter the Authorization Token.
  14. Select the Delivery Delay. (optional)
  15. Select the Retry Attempts. (optional)
  16. Select the Delivery Method. (optional)
  17. Click Save.
  18.  

    A. Up to 10 floodlight tags may be added. In order to conserve space, the above image has been shortened.

     

    NOTE: With our integration we support multiple floodlight tags to be entered.


Reengagement Configuration

The information within this section provides the steps necessary to establish a reengagment campaign.

 

NOTE: If visualizing results of your DoubleClick re-engagement efforts in Kochava is not desired, but you would like to configure event data to send to DoubleClick, follow the steps within the Create a Postback section below.

NOTE: Meta-data being sent to DoubleClick is required to be in a specific format which maps to “U” values within DoubleClick. Post-Install event examples have been detailed within our Post-Install Event Examples support document which maps the meta-data correctly to the “U” values within DoubleClick.

 

Create a Reengagement Segment:

  1. Locate the desired Campaign.
  2. Select Campaign Tools>Add a Segment.
  3. Enter a Segment Name.
  4. Enter a Segment Description. (optional)
  5. Click Submit.

 

Create a Reengagement Tracker:

  1. Select Segment Tools>Add a Tracker.
  2. Enter a Tracker Name.
  3. Select Tracker Type>Reengagement.
  4. Select a Network>Doubleclick.
  5. Select Destination URL Type>Custom. (default setting)
  6. Click URL. (Not Required)
  7. Add Reengagement Event(s).

 

NOTE: Reengagement events may be added by clicking on the “+” and removed by clicking “X“.

 

DoubleClickReengagementTrackerSettingsHD

 

Create a Postback Configuration:

  1. Click App Tools>Partner Configuration.
  2.  

    AppToolsPartnerConfigurationHD

     

  3. Select Doubleclick>Network Tools>Postbacks.
  4. Locate the desired event and Click Edit Postback.
  5. Enter the App Bundle.
  6. Enter the Advertiser ID.
  7. Enter the Activity Tag.
  8. Enter the Group Tag.
  9. Enter the Authorization Token.
  10. Select the Delivery Delay. (optional)
  11. Select the Retry Attempts. (optional)
  12. Select the Delivery Method. (optional)
  13. Click Save.
  14.  

    A. Up to 10 floodlight tags may be added. In order to conserve space, the above image has been shortened.


DoubleClick Parameters

Kochava can send the following parameters to DoubleClick within an event postback. These values originate from the event dimensions via the SDK or S2S feed Kochava receives via your app.

 

DoubleClick Parameter Kochava Value
u1= event_name
u2= item_id
u3= item_name
u4= item_quantity
u5= items_in_basket
u6= item_added_from
u7= sum
u8= currency
u9= duration
u10= hours_played
u11= achievement_name
u12= level_name
u13= level_number
u14= referral_from
u15= sessions_played

 

NOTE: In order to view any of the above parameters within the DoubleClick dashboard, map the parameters within DoubleClick UI.

NOTE: For more information on post-install events, refer to our Post-Install Event Examples for best practices and practical examples.


DCM – DoubleClick Campaign Manager

DoubleClick Campaign Manager supports multiple methods of tracking.

DCM Supports claiming via the DDM SAN Infrastructure (mobile inventory only) as outlined above. It also supports click tracking through one of the following three methods:

 

Site-Supplied Click Strings:

Site-Supplied Click Strings are click-tracking URLs provided by the network when requesting an ad from DCM. This is a great solution for displaying ads, as it allows the
network/publisher to provide the click tracker, as well as the network can send pre-populated macros allowing the use of their own tracking links. To implement Site-Supplied Click Strings:

  1. Create a new tracking URL for the publisher in the Kochava Campaign Manager.
  2. Give the click tracker to the network/publisher that will be serving the ads. The network/publisher will send the click tracker (pre-population) to DCM when requesting an impression.

 

NOTE: Utilizing SSCS is the best method to track display clicks when working with DCM. They allow the publisher to define their click URL, which permits publisher level tracking.

 

Event Tags:

DCM allows the Advertiser to embed click trackers as event tags. This method is particularly useful if the tracker will be served over a large number of ads or an entire campaign, which relies on DCM Macros to be embedded in the click or impression. For more information on how to implement event tags in the DoubleClick interface, refer to the Google documentation.

 

NOTE: The above links will only function if a valid Google DoubleClick Manager account is logged in.

 

Landing Page Redirection:

DCM allows the advertiser to place a redirecting Click-Tracker as the landing page URL in the DCM Dashboard. This is convenient if several ads have to be set up, rather than an entire campaign.

 

  1. Create a Smartlink in the Kochava UI.
  2. Append any DBM Macros to the click tracker as Key:Value pairs, which relies on DCM Macros to be embedded in the click.

 


DBM – DoubleClick Bid Manager

DBM supports claiming via the DDM SAN Infrastructure (mobile inventory only) as outlined above. It also allows click tracking as below

 

Smartlink Tracking:

Smartlink tracking uses a click-tracker placed in the DBM dashboard, which relies on DBM Macros.

  1. Create a Smartlink in the Kochava UI.
  2. Append any DBM Macros to the click tracker as Key:Value pairs.
  3. Place the resulting URL into the DBM Campaign Manager.
  4.  

    BEST PRACTICES: Use the SAN infrastructure for all in-app inventory being served, an duse an embedded smartlink on any display-only campaigns.


DS – DoubleClick Search

DoubleClick Search does not support the SAN claiming infrastructure. It has to use an embedded click tracker.

 

URL Tracking Template:

DS supports click-tracking via click-tracking templates placed in the DoubleClick Search dashboard, which uses the URL Template in the DoubleClick Search dashboard.

 

 

NOTE: Depending on your account setup, the URL template might be defined in a different location. Please contact your D3S Account Manager to learn more about the best way to place the redirect URL.

NOTE: To get the most Granular tracking, DoubleClick Search should not be used. Instead, work with each of the search engines individually. If that is not an option, then make sure a click-tracker URL template embedded properly in the URL Template for the campaign.


DFP – DoubleClick for Publishers

DoubleClick for Publisher Partners should be integrated as a stand-alone network on the Kochava side; please contact integrations@kochava.com to get the partner integrated. Once integrated, they will be able to be selected in the drop-down, and will appear as a standard Kochava Certified partner.

 

WARNING: Make sure you contact integrations well in advance of the campaign; 3-5 days should be allowed for to complete the integration at a minimum.

 
 

Last Modified: May 8, 2018 at 2:38 pm