Asignación de ID para la nueva experiencia de Search Ads 360

Ya está disponible la nueva API de Search Ads 360 Reporting. La nueva API proporciona Flexibilidad mejorada para crear informes personalizados e integrar los datos en sus aplicaciones de informes y procesos. Más información sobre cómo migrar a la nueva experiencia de Search Ads 360 Reporting y cómo usarla API

Las entidades de la nueva experiencia de Search Ads 360 tienen un espacio de ID diferente al de la experiencia anterior. Para obtener la asignación de ID entre la experiencia anterior de Search Ads 360 y la nueva, envía un Reports.getIdMappingFile() para cada solicitud. La respuesta incluye asignaciones de ID para todas las entidades de un anunciante específico.

Este es un ejemplo del archivo devuelto (formato CSV codificado en UTF-8):

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

El archivo CSV tiene 3 columnas:

  • Entity Type: Es el tipo de entidad de esta fila.

  • Legacy IDs: Es una cadena JSON de la ruta de acceso de la entidad completa en la experiencia anterior de Search Ads 360.

  • New IDs: Es una cadena JSON de la ruta de acceso de la entidad completa en la nueva experiencia de Search Ads 360.

En la siguiente tabla, se muestra una lista de entidades admitidas y ejemplos de asignaciones de ID:

Tipo de entidad Descripción ID heredados IDs nuevos
CLIENTE Asignación de ID para: No están disponibles las asignaciones de administradores y agencias. 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
CAMPAÑA Asignación de ID para una campaña. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP Asignación de ID para adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
Criterio Asignación de ID para: 
adGroupTarget and negativeAdGroupTarget:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "adGroupTargetId": "46700015332504045"
}

keyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "criterionId": "46700015332504045"
}

negativeAdGroupKeyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "negativeAdGroupCriterionId": "46700015332504045"
}

productGroup:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "productGroupId": "92700000508010025"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD Asignación de ID para ad 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION Asignación de ID para: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Asignación de IDs para un grupo de campañas 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Asignación de IDs para el objetivo de rendimiento de un grupo de campañas. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Asignación de ID para la tabla del feed. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM Asignación de ID para feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Descargar el informe

JSON

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media

Python

def download_mapping_file(service, file_name, agency_id, advertiser_id):
  """Generate and save mapping file to a csv.

  Args:
    service: An authorized Doubleclicksearch service.
    file_name: Filename to write the ID mapping file.
    agency_id: DS ID of the agency.
    advertiser_id: DS ID of the advertiser.
  """
  request = service.reports().getIdMappingFile_media(agencyId=agency_id,
      advertiserId=advertiser_id)

  f = open(file_name + '.csv', 'w')
  f.write(request.execute().decode('utf-8'))
  f.close()

Unicidad del ID de objeto

Cada objeto en la nueva experiencia de Search Ads 360 se identifica con su propio ID. Algunos de estos IDs son Son únicas a nivel global en todas las cuentas en la nueva experiencia de Search Ads 360, mientras que otras son únicas. solo en un alcance limitado. Por ejemplo, debes usar tanto el grupo de anuncios como los IDs del anuncio para identificar los anuncios, ya que los IDs se asignan de forma única por grupo de anuncios, pero no entre grupos de anuncios. A continuación, se indica la singularidad de cada ID de objeto en la nueva experiencia de Search Ads 360. Estas reglas de ID pueden puede ser útil a la hora de diseñar el almacenamiento local para tus nuevos objetos de Search Ads 360.

ID de objeto Alcance de la unicidad ¿Es único a nivel global?
ID de presupuesto Global Sí
ID de la campaña Global Sí
ID del grupo de anuncios Global Sí
ID del anuncio Grupo de anuncios El par (AdGroupId, AdId) es único a nivel global.
ID de AdGroupCriterion Grupo de anuncios El par (AdGroupId, CriterionId) es único a nivel global.
ID de criterio de campaña Campaña El par (CampaignId, CriterionId) es único a nivel global.
Extensiones de anuncios Campaña El par (CampaignId, AdExtensionId) es único a nivel global.
ID del feed Global Sí
ID de elemento del feed Global Sí
ID del atributo del feed Feed No
ID de asignación de feeds Global Sí
ID de etiqueta Global Sí
ID de lista de usuarios Global Sí