El documento resume las últimas actualizaciones de la API de AdWords, incluyendo nuevas funcionalidades como la importación de conversiones fuera de línea, cambios en los nombres obligatorios de campañas y grupos de anuncios, y cinco funcionalidades que ya no están en beta como los modificadores de ofertas de criterios de visualización y anuncios de búsqueda dinámica. También proporciona ejemplos de código para utilizar estas nuevas características a través de la API.
2. AdWords API Features Update
Qué es nuevo, no está en beta e importante
Marc Wandschneider, Google Inc.
+GustavoMenezes, Google, Inc.
AdWords API Workshops – All rights reserved
3. Últimos Puntos Importantes
● Algunas funcionalidades nuevas
○ Offline conversions import & tracking
○ Nuevos informes y campos
○ Cambios en shared budget
AdWords API Workshops – All rights reserved
4. Últimos Puntos Importantes (cont.)
● Algunos cambios más:
○ Nombres obligatórios en Campaigns y AdGroups
○ No puedes mas usar search network en NetworkSetting
○ Las Stats ya no existen en los servicios
AdWords API Workshops – All rights reserved
5. Últimos Puntos Importantes (cont.)
● 5 funcionalidades que ya no están en beta
○ Display criteria bid modifiers
○ Dynamic Search Ads
○ AdGroup level feeds (site links)
○ Flexible bidding strategies (shared)
○ Location bid modifiers
AdWords API Workshops – All rights reserved
7. Offline Conversion Import
● Permite registrar conversiones en AdWords
● Puede ser una conversión manual
● El conversion tracker puede funcionar de manera diferente
● Acepta registros hasta 90 días después del click
● Valor preciso es configurable
● Útiles para:
● Flexible bidding
● Conversion reporting
AdWords API Workshops – All rights reserved
8. Offline Conversion Import (cont.)
● Procedimiento básico
a. Registre para recibir GCLID con auto-tagging
b. Guarde el click ID como clave en su base de datos
c. Cuando conversión se pasa, marque en la base de datos
d. A menudo ejecute código para subir a la API
AdWords API Workshops – All rights reserved
9. Offline Conversion Import (cont.)
● Para subir una conversión, dos pasos:
a. Crear un tipo de conversión
■ via UI o ConversionTrackerService
b. Suba la conversión
AdWords API Workshops – All rights reserved
10. Crear Tipo de Conversión (código)
UploadConversion uc = new UploadConversion();
uc.setCategory(ConversionTrackerCategory.SIGNUP);
uc.setName("Freemium signup");
uc.setViewthroughLookbackWindow(30);
uc.setCtcLookbackWindow(90);
ConversionTrackerService.mutate(ADD, uc);
// NOTE: wait 6 hours after creating before uploading.
AdWords API Workshops – All rights reserved
11. Subir Conversión
OfflineConversionFeed feed = new OfflineConversionFeed();
feed.setConversionName("Freemium signup");
feed.setConversionTime(conversionTime);
feed.setGoogleClickId(gClid);
feed.setConversionValue(3.50);
// optional, > 0
OfflineConversionFeedService.mutate(ADD, feed);
// conversion can take up to 3 hours to be processed fully
AdWords API Workshops – All rights reserved
13. Nombres de Campaign y AdGroup
● Ahora son obligatórios
● Su sistema tiene que garantizar
que sean únicos
● Error si están vacíos
AdWords API Workshops – All rights reserved
14. NetworkSetting y Search
● Campañas de Display only mejorarán con el tiempo
● No puede más usar search para NetworkSetting
● Error: TargetError.TARGET_ERROR
● Todavia puede usar display network
● Sólo afecta si cambia los NetworkSetting de
campañas que ya existen
AdWords API Workshops – All rights reserved
15. Stats Objects se Fueron
● Muchos servicios (7) tenian Stats
● i.e. AdGroupService ,CampaignService, MutateJobService
● Ya no las tienen
● Use informes para los obtenerlas
● La API de informes es muy fácil de usar
● ¡Ya los debería estar usando!
AdWords API Workshops – All rights reserved
16. Presupuestos Individuales de Campañas
● Desde v201309, es posible crear presupuestos “no
compartidos”
● Desde v201302, existe un campo boolean Budget para
esto: isExplicitlyShared
● El isExplicitlyShared ahora funciona de verdad
● Llene isExplicitlyShared = false para crear un
presupuesto no compartido
● Valor por defecto: isExplicitlyShared = true
AdWords API Workshops – All rights reserved
17. Porqué Crear Presupuestos no
Compartidos?
● No se muestran en la UI en ‘Shared Library’
● No pueden ser compartidos de ninguna manera, hasta
que isExplicitlyShared = true
● No se puede convertir a no compartido
● Presupuestos compartidos son borrados cuando la
campaña es borrada
○ BudgetService.mutate(REMOVE op) no es necesario
AdWords API Workshops – All rights reserved
19. 1. Display Criteria Bid Modifiers
●
BiddableAdGroupCriterion.bidModifier
!!
● Puede alterar bids para diferentes tipos de Display
Network
● Puede alterar bids para audiencias específicas
● También en RLSAs!
● No funciona para palabras clave u otros tipos
AdWords API Workshops – All rights reserved
20. 2. Dynamic Search Ads
● Anuncios basados en el contenido de tus sitios
● No es necesario añadir título, url o palabras
● Sólo son necesarias las descripciones y URL visibles
● Mismo ranking - mismo rendimiento que otros anuncios
● Funcionan dentro de campañas con palabras claves
● Se pueden usar DSAs con palabras “catch-all”
● También se pueden usar palabras negativas, reportes y
extensiones
AdWords API Workshops – All rights reserved
21. Dynamic Search Ads (cont.)
● Crear Campaigns y AdGroups como antes
● Añada palabras claves
● Para DSAs, necesita 3 cosas:
● DomainInfoExtension
● Una o más Webpage Criteria
● DynamicSearchAds
AdWords API Workshops – All rights reserved
22. Dynamic Search Ads (cont.)
●
●
●
●
Crear Ad de tipo DynamicSearchAd
Llena description1, description2, displayUrl
Ojo: Se llena url necesita usar valor parametrizado
Puede actualizar, cambiar status, etc
AdWords API Workshops – All rights reserved
23. Dynamic Search Ads (cont.)
● parámetro url, necesita un parámetro
● Un de los que seguien:
● {unescapedlpurl} — Use en inicio, cambia toda la URL
● {unescapedlpurl}?lang=en
● {escapedlpurl} — UR- versón codificada, i.e. para trackers
● http://www.3rdpartytracker.com/?lp={escapedlpurl}
● {lpurlpath} — Solo la parte de query de la landing page URL
● http://www.mygoodbusiness.com/tracking/{lpurlpath}
●
Si no hay url, {unescapedlpurl} es usado
AdWords API Workshops – All rights reserved
24. Dynamic Search Ads (cont.)
DynamicSearchAd dsa = new DynamicSearchAd();
dsa.url = "{unescapedlpurl}?source=dsa";
dsa.displayUrl = "amazingcarrepairs.com";
dsa.description1 = "We'll take good care of your car";
dsa.description2 = "Wash and wax service included.";
AdGroupAd aga = new AdGroupAd(_adgroupid);
aga.ad = dsa;
AdGroupService.mutate(ADD, aga);
AdWords API Workshops – All rights reserved
25. Dynamic Search Ads (cont.)
● Añada un criterio de tipo Webpage
● Puede ser de título, contenido, URL, etc.
● También puede ser negativa
● No lo va con estas páginas, etc.
AdWords API Workshops – All rights reserved
26. Dynamic Search Ads (cont.)
WebpageCondition cond = new WebpageCondition();
cond.operand = URL; // filter on URLs, equal to "CONTAINS"
cond.argument = "/grandcherokee";
WebpageParameter param = new WebpageParameter();
param.criterionName = "Jeep Grand Cherokee";
param.conditions = [ cond ];
Webpage wp = new Webpage(); // the criterion
wp.parameter = param;
// can now put in AdGroupCriterion object and ADD!
AdWords API Workshops – All rights reserved
27. Dynamic Search Ads (cont.)
● Advertencia:
● DSAs necesitan de DomainInfoExtension
●
Son Campaign Ad Extensions
● No se pueden crear con la API
●
Se debe usar la Web de AdWords
● Puede crear DSAs con DomainInfoExtension que ya
existen
● Puede sacar toda la información de DSAs
AdWords API Workshops – All rights reserved
28. 3. AdGroup Level Feeds
● Puede usar AdGroupFeedService
● Añada site links en AdGroups
● (es esto)
AdWords API Workshops – All rights reserved
29. 4. Flexible Bidding Strategies
● Actualmente específico por campaña
● Tiene que crear un nuevo por campaña
● Es mejor si crea una biblioteca de estratégias
● Usar la misma para otras campañas
● Es fácil probar diferentes estrategias
● Esto es Flexible Bidding Strategies
● Flexible ~= Compartido
AdWords API Workshops – All rights reserved
32. Flexible Bidding Strategies (cont.)
● BiddingStrategyService es la reserva
● Crear un objeto SharedBiddingStrategy
● Posee biddingScheme como ya está acostumbrado
●
I.e. TargetSpendBiddingScheme
● Para Campaign.biddingStrategyConfiguration
● Use bidding strategy ID del objeto compartido
AdWords API Workshops – All rights reserved
33. Flexible Bidding Strategies (cont.)
// 1. create the shared bidding
TargetSpendBiddingScheme tsbs =
tsbs.spendTarget = 250000000;
tsbs.bidCeiling = 2500000;
strategy.
new TargetSpendBiddingScheme();
// $250 a month
// max 2.50$ bid
SharedBiddingStrategy sbs = new SharedBiddingStrategy();
sbs.name = "Monthly targeted spend";
sbs.type = TARGET_SPEND;
sbs.biddingScheme = tsbs;
BiddingStrategyService.mutate(ADD, sbs); // extract result
AdWords API Workshops – All rights reserved
34. Flexible Bidding Strategies (cont.)
// 2. add it to the campaign.
Campaign c = new Campaign();
// set up stuff on c
BiddingStrategyConfiguration bsc = new
BiddingStrategyConfiguration();
bsc.biddingStrategyId = sbs.id;
c.biddingStrategyConfiguration = bsc;
CampaignService.mutate(ADD, c);
AdWords API Workshops – All rights reserved
35. 5. Location Bid Modifiers
● Diferentes bids para sitios
diferentes
● Todo en la misma campaña
AdWords API Workshops – All rights reserved
36. Location Bid Modifiers (cont.)
// 1. normal location criterion.
LocationCriterion lc = new Location();
lc.id = 1002451; // Toronto, Ontario, Canada
lc.bidModifier = 1.0;
CampaignCriterion cc = new CampaignCriterion();
cc.campaignId = _campaignId;
cc.criterion = lc;
CampaignCriterionService.mutate(ADD, cc);
AdWords API Workshops – All rights reserved
37. Location Bid Modifiers (cont.)
// 2. let's bid more for successful suburb
LocationCriterion lc = new Location();
lc.id = 1002350;
// Mississauga, Ont, Can
lc.bidModifier = 1.5;
// bid 50% more for here
CampaignCriterion cc = new CampaignCriterion();
cc.campaignId = _campaignId;
cc.criterion = lc;
CampaignCriterionService.mutate(ADD, cc);
AdWords API Workshops – All rights reserved
38. Las Olvidadas
No olvide de estas funcionalidades
AdWords API Workshops – All rights reserved
39. Algunas Funcionalidades no Utilizadas
● Palabras Clave Negativas
● Site Links (ahora en Feed Services)
● Esto por sí sólo ayudará con QS, CTR
● Una forma fácil de mejorar
AdWords API Workshops – All rights reserved
40. Palabras Clave Negativas
// Create keyword. We're creating ads for “Westminster dentist”.
Keyword keyword = new Keyword();
keyword.setText("reviews");
keyword.setMatchType(KeywordMatchType.BROAD);
// Create negative campaign criterion.
NegativeCampaignCriterion ncc = new NegativeCampaignCriterion();
ncc.setCampaignId(_campaignId);
ncc.setCriterion(keyword);
CampaignCriterionService.mutate(ADD, ncc);
AdWords API Workshops – All rights reserved
41. Site Links
● Ahora parte de Feed Services
● Más en los enlaces
AdWords API Workshops – All rights reserved
42. Enlaces
Google Ads v201309 Blog Post - http://goo.gl/TvNQDx
v201309 Migration Guide - http://goo.gl/e4O7YZ
AdWords API Workshops – All rights reserved