Retrieve Placement ClickTracker Information via API

[js]

Dear DCM Team!

In the User Interface I am able to create a Campaign, a Placement in that Campaign and a ClickTracker Ad which is assigned to that Placement. I am able to reproduce this with the API with campaigns.insert, placements.insert and ads.insert. I have two things, which I cannot achieve through the API though:

1. In the User Interface I can set the value in the column "Include in rotation" to TRUE, which I cannot via the API. When I create a Placement, this value is FALSE.

2. In the User Interface I can download the tags of the Placement, which shows me information including the ClickTracker tag. I cannot find out, how I do this with the API.

So, I have two questions:

1. Which property of which entity corresponds to the column "In rotation"? How can I set this property with the API?

2a. How can I retrieve the download of the tags of a certain placement programmatically via the API?

2b. If this is not possible, is there a different way to retrieve the Click Tracker Tag of an Ad from the API?

Your help is very much appreciated,

Jonathan

[Dhanya Sundararaju (DFA API Team)]

Hi Jonathan,

Via the API, you will be able to set the creative rotation for an ad via the creativerotation field in Ads. Secondly, if the placements haven't been changed, the call to generateTags will generate and download the same tags that are available through the UI. Nothing will be duplicated so you can safely use the generateTags to retrieve the same tags via API.

Regards,
Dhanya, DCM API Team

[js]

Hi Dhanya,

thanks for your response! Unfortunately, the second part of your answer is not answering the question I wanted to ask. Maybe I was explaining my question not in a propper way. So let me try to explain better:

There is one source of misunderstanding due to the naming of DCM, which might be a bit confusing here: The Click Tracker is not a Tag, but an Ad (see my first screenshot). This Ad is assigned to a Placement. This Ad has a property which is called "Click Tracker Tag" in the UI, but which is basically a URL. This "Click Tracker Tag" is described here: https://support.google.com/dcm/partner/answer/2826636?hl=en#click. Through the UI, I can retrieve this "Click Tracker Tag" by downloading the Tags of the Placement (see my first screenshot). The "Click Tracker Tag" is then included in the excel-file, in column O (see the attached example). I would like to know how I can get this URL via the API. It is not included in the repsonse of placements.get or placements.generatetags, nor in the response of ads.get

Is there a way to get this URL via the API? If yes, how can I get it?

Thank you ever so much for your help,

Jonathan

[js]

Just one additional information: The response of the placements.generatetags request for the placement which I attached the download to, is:

{

"kind": "dfareporting#placementsGenerateTagsResponse",

"placementTags": [

{

"placementId": "222232443",

"tagDatas": [

{

"format": "PLACEMENT_TAG_CLICK_COMMANDS",

"clickTag": "",

"adId": "420384905"

}

]

}

]

[Chris Feldman (DCM API Team)]

Hi,

Thank you for following up. Can you share the request that you're making to get that response from the generatetags method? When make the request, it's returning the clickTag.

Regards,

Chris Feldman

DCM API Team

[js]

Hi Chris,

thanks for your follow up! As you can see from my previous post, the field `clickTag` is included in the response I get. It is just an empty string, which is not the url which I retrieve via the download. The request I do, is just the basic request, passing the CampaignId and the PlacementId in the request body. The Placement I am using for testing has 4 Ads, only one of the is "Included In Rotation". This seems to be a necessary condition to get a Click Tracker Tag (URL), since the download of the ClickTrackers regularly contains only the Click Tracker Tags of those Ads which are "Included in Rotation". This is also somehow reflected in the response of my request - the response shows only the PlacementId of that PLacement which is "Included in Rotation". Anyway, the clickTag is "". Here is my request (assembled with the google API explorer), I replaced my user profileId with <MY USER PROFILE ID>:

POST https://www.googleapis.com/dfareporting/v3.1/userprofiles/<MY USER PROFILE ID>/placements/generatetags?campaignId=21208471&placementIds=222232443&key={YOUR_API_KEY}

 
Your help is very much appreciated!

Jonathan

[Chris Feldman (DCM API Team)]

Hi Jonathan,

When I use generatetags with those values campaignIds and placementIds, the response I get has the proper click tags. Can you please share an unredacted request and response, in their entirety? I want to ensure that you're doing everything correctly. Please share a timestamp for the request as well. It should be from the last < 7 days. 

You can share this information privately via the forum's 'Reply Privately' feature.

Regards,
Chris Feldman
DCM API Team