Mappage des ID pour la nouvelle interface Search Ads 360

La nouvelle API Search Ads 360 Reporting est désormais disponible. Cette nouvelle API fournit Plus de flexibilité pour créer des rapports personnalisés et intégrer les données dans vos applications de reporting et processus. En savoir plus sur la migration vers la nouvelle interface Search Ads 360 Reporting et son utilisation API.

Les entités de la nouvelle interface Search Ads 360 disposent d'un espace d'identifiants différent de celui de l'ancienne. Pour obtenir le mappage des identifiants entre l'ancienne et la nouvelle interface Search Ads 360, envoyez une Reports.getIdMappingFile() requête. La réponse inclut des mappages d'ID pour toutes les entités d'un annonceur spécifié.

Voici un exemple de fichier renvoyé (au format CSV encodé en UTF-8):

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

Le fichier CSV comporte trois colonnes:

  • Entity Type: type d'entité de cette ligne.

  • Legacy IDs: chaîne JSON du chemin d'accès complet de l'entité dans l'ancienne interface Search Ads 360

  • New IDs: chaîne JSON du chemin d'accès complet de l'entité dans la nouvelle interface Search Ads 360

Le tableau ci-dessous présente une liste d'entités compatibles et des exemples de mappage d'ID:

Type d'entité Description Anciens ID Nouveaux ID
CLIENT Mappage d'ID pour: Les mappages pour les responsables et les agences ne sont pas disponibles. 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
CAMPAGNE Mappage des ID pour la campagne. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP Mappage d'ID pour adGroup 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
CRITÈRE Mappage d'ID pour: 
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 Mappage des ID pour l'annonce. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION Mappage d'ID pour: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Mappage des ID pour le groupe de campagnes. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Mappage des ID pour l'objectif de performances du groupe de campagnes 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Mappage des ID pour la table de flux. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM Mappage des ID pour feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Télécharger le rapport

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()

Unicité de l'ID d'objet

Dans la nouvelle interface Search Ads 360, chaque objet est identifié par son propre ID. Certains de ces identifiants sont sont uniques au niveau mondial dans tous les comptes de la nouvelle interface Search Ads 360, tandis que d'autres sont uniques ; que dans un cadre limité. Par exemple, vous devez utiliser à la fois les identifiants de groupe d'annonces et d'annonce pour identifier les annonces, car les identifiants d'annonce sont attribués de façon unique à chaque groupe d'annonces, mais pas au niveau des groupes d'annonces ; L'unicité de chaque ID d'objet dans la nouvelle interface Search Ads 360 est indiquée ci-dessous. Ces règles appliquées à l'identifiant s'avérer utiles lorsque vous concevez un stockage local pour vos objets dans la nouvelle interface Search Ads 360.

ID d'objet Périmètre de l'unicité Unique au niveau global ?
ID du budget Monde Oui
ID de la campagne Global Oui
ID du groupe d'annonces Global Oui
Identifiant d'annonce Groupe d'annonces Non. La paire (AdGroupId, AdId) est unique.
ID du critère de groupe d'annonces Groupe d'annonces Non. La paire (AdGroupId, CriterionId) est unique.
ID du critère de campagne Campagne Non. La paire (CampaignId, CriterionId) est unique.
Extensions d'annonce Campagne Non. La paire (CampaignId, AdExtensionId) est unique.
ID du flux Global Oui
ID de l'élément de flux Global Oui
ID de l'attribut du flux Flux Non
ID de correspondance de flux Global Oui
ID du libellé Monde Oui
ID de liste d'utilisateurs Monde Oui