ID-Zuordnung für die neue Search Ads 360-Version

Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Die neue API bietet mehr Flexibilität für die Erstellung benutzerdefinierter Berichte und erleichtert das Einbinden der Daten in Ihre Berichtsanwendungen und -prozesse. Weitere Informationen zur Migration zur neuen Search Ads 360 Reporting API und zur Verwendung dieser API

Entitäten in der neuen Search Ads 360-Version haben einen anderen ID-Bereich als die vorherige Search Ads 360-Version. Wenn Sie die ID-Zuordnung zwischen der vorherigen und der neuen Search Ads 360-Version erhalten möchten, senden Sie eine Reports.getIdMappingFile()-Anfrage. Die Antwort enthält ID-Zuordnungen für die meisten Entitäten für einen bestimmten Werbetreibenden. Weitere Informationen dazu, warum eine Entität möglicherweise in der Zuordnungsdatei ausgelassen wird, finden Sie unter Häufige Gründe für fehlende Entitäten.

Hier ist ein Beispiel für die zurückgegebene Datei (CSV-Format, codiert in UTF-8):

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

Die CSV-Datei enthält drei Spalten:

  • Entity Type: Der Entitätstyp dieser Zeile.

  • Legacy IDs: ein JSON-String mit dem vollständigen Entitätspfad in der vorherigen Search Ads 360-Version

  • New IDs: ein JSON-String mit dem vollständigen Entitätspfad in der neuen Search Ads 360-Version

In der folgenden Tabelle sind die unterstützten Entitäten und Beispiel-ID-Zuordnungen aufgeführt:

Entitätstyp Beschreibung Legacy-IDs Neue IDs
KUNDEN ID-Zuordnung für: Zuordnungen für Manager und Agenturen sind nicht verfügbar. 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
KAMPAGNE ID-Zuordnung für Kampagne 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP ID-Zuordnung für adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
KRITERIEN ID-Zuordnung für Kriterien auf Anzeigengruppenebene: 
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 ID-Zuordnung für ad. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION ID-Zuordnung für Kriterien auf Kampagnenebene: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP ID-Zuordnung für die Kampagnengruppe. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET ID-Zuordnung für das Leistungsziel der Kampagnengruppe. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE ID-Zuordnung für Feedtabelle. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM ID-Zuordnung für feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Häufige Gründe für fehlende Entitäten

Die Zuordnungsdatei eines Werbetreibenden enthält zwar die meisten seiner Entitäten, es kann aber vorkommen, dass einige fehlen. Das hat meist folgende Ursachen:

  • Jede Zuordnungsdatei wird alle drei Tage aktualisiert. Wenn eine Zuordnungsdatei sofort nach dem Erstellen einer neuen Entität heruntergeladen wird, ist die Entität wahrscheinlich nicht in der Zuordnungsdatei enthalten. Es wird wahrscheinlich nach einer Wartezeit von bis zu drei Tagen berücksichtigt.
  • Das Konto, zu dem die Entität gehört, wird entfernt. In diesem Fall wird die ID-Zuordnung nicht unterstützt.

Bericht herunterladen

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

Eindeutigkeit der Objekt-ID

Jedes Objekt in der neuen Search Ads 360-Version wird durch eine eigene ID identifiziert. Einige dieser IDs sind in allen Konten in der neuen Search Ads 360-Version auf globaler Ebene eindeutig, andere nur innerhalb eines begrenzten Gültigkeitsbereichs. So müssen Sie beispielsweise sowohl die Anzeigengruppen- als auch die Anzeigen-IDs verwenden, um Anzeigen eindeutig zu identifizieren, da Anzeigen-IDs pro Anzeigengruppe eindeutig zugewiesen sind, aber nicht für alle Anzeigengruppen. Unten finden Sie eine Liste der eindeutigen Objekt-IDs in der neuen Search Ads 360-Version. Diese ID-Regeln können beim Entwerfen des lokalen Speichers für Ihre neuen Search Ads 360-Objekte hilfreich sein.

Objekt-ID Gültigkeitsbereich der Eindeutigkeit Global eindeutig?
Budget-ID Global Ja
Kampagnen-ID Global Ja
Anzeigengruppen-ID Global Ja
Anzeigen-ID Anzeigengruppe Anzahl (AdGroupId, AdId) ist global eindeutig.
ID des Anzeigengruppenkriteriums Anzeigengruppe Nein. Das Paar (AdGroupId, CriterionId) ist global eindeutig.
ID des Kampagnenkriteriums Kampagne Nein. Das Paar (CampaignId, CriterionId) ist global eindeutig.
Anzeigenerweiterungen Kampagne Nein. Das Paar (CampaignId, AdExtensionId) ist global eindeutig.
Feed-ID Global Ja
ID des Feedelements Global Ja
Feed-Attribut-ID Feed Nein
Feed-Mapping-ID Global Ja
Label-ID Global Ja
UserList-ID Global Ja