Dokumentation Audience Manager Audience Manager-Tutorials

Validierung der globalen Geräte-ID global-device-id-validation

Last update: Mon Dec 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Data Governance und Datenschutz

Erstellt für:

Experte
Entwickler

Geräte-Advertising-IDs (d. h. iDFA, GAID, Roku-ID) haben Formatierungsstandards, die erfüllt sein müssen, damit sie im digitalen Werbe-Ökosystem verwendet werden können. Heute können Kunden und Partner IDs in jedem beliebigen Format in unsere globalen Datenquellen hochladen, ohne darüber informiert zu werden, ob die ID ordnungsgemäß formatiert ist. Diese Funktion führt die Validierung von Geräte-IDs ein, die zur ordnungsgemäßen Formatierung an die globalen Datenquellen gesendet werden, und bietet Fehlermeldungen, wenn IDs falsch formatiert sind. Bei der Einführung wird die Validierung für iDFA, Google Advertising und Roku IDs unterstützt.

Übersicht über Formatstandards overview-of-format-standards

Im Folgenden finden Sie die globalen Geräte-Advertising ID-Pools, die derzeit von AAM erkannt und unterstützt werden. Diese werden als freigegebene Data Sources implementiert, die von jedem Kunden oder Datenpartner verwendet werden können, der mit Daten arbeitet, die an Benutzer dieser Plattformen gebunden sind.

Plattform

AAM Data Source ID

ID-Format

AAM PID

Hinweise

Google Android (GAID)

20914

32 Hexadezimalzahlen, im Allgemeinen dargestellt als 8-4-4-12 Beispiel, 97987BCA-AE59-4C7D-94BA-EE4F19AB8C21

1352

Diese ID muss in einer Referenz in unformatierter/ungehashter/unveränderter Form erfasst werden - https://play.google.com/about/monetization-ads/ads/ad-id/

Apple iOS (IDFA)

20915

32 Hexadezimalzahlen, allgemein dargestellt als 8-4-4-4-12 z. B. 6D92078A-8246-4BA4-AE5B-76104861E7DC

3560

Diese ID muss in einer Referenz in unformatierter/ungehashter/unveränderter Form erfasst werden - https://support.apple.com/en-us/HT205223

Roku (RIDA)

121963

32 Hexadezimalzahlen, im Allgemeinen dargestellt als 8-4-4-4-12 Beispiel, FCB2A29C-315A-5E6B-BCFD-D889BA19AADA

11536

Diese ID muss in einer Referenz in unformatierter/ungehashter/unveränderter Form erfasst werden - https://sdkdocs.roku.com/display/sdkdoc/Roku+Advertising+Framework

Microsoft Advertising ID (MAID)

389146

Numerische Zeichenfolge des Alphas

14593

Diese ID muss in einem Formularverweis (Roh/Ungehasht/Unverändert) erfasst werden - https://docs.microsoft.com/en-us/uwp/api/windows.system.userprofile.advertisingmanager.advertisingid
https://msdn.microsoft.com/en-us/library/windows/apps/windows.system.userprofile.advertisingmanager.advertisingid.aspx

Samsung DUID

404660

Beispiel für eine numerische Alpha-Zeichenfolge, 7XCBNROQJQPYW

15950

Diese ID muss in einer Referenz in unformatierter/ungehashter/unveränderter Form erfasst werden - https://developer.samsung.com/tv/develop/api-references/samsung-product-api-references/productinfo-api

Festlegen einer Advertising-Kennung in der App setting-an-advertising-identifier-in-the-app

Das Festlegen der Advertiser-ID in der App ist wirklich ein zweistufiger Prozess, zunächst wird die Advertiser-ID abgerufen und dann an die Experience Cloud gesendet. Unten finden Sie Links zum Ausführen dieser Schritte.

Abrufen der ID
1. Apple Informationen über die advertising ID finden Sie HIER.
2. Einige Informationen zum Festlegen der advertiser ID für Android-Entwickler finden Sie HIER.
Senden Sie sie mithilfe der setAdvertisingIdentifier in der SDK an die Experience Cloud
1. Informationen zur Verwendung von setAdvertisingIdentifier finden Sie in der Dokumentation sowohl für iOS als auch für Android.

// iOS (Swift) example for using setAdvertisingIdentifier:
ACPCore.setAdvertisingIdentifier([AdvertisingId]) // ...where [AdvertisingId] is replaced by the actual advertising ID

DCS-Fehlermeldung bei falschen IDs dcs-error-messaging-for-incorrect-ids

Wenn eine falsche globale Geräte-ID (IDFA, GAID usw.) in Echtzeit an den Audience Manager übermittelt wird, wird beim Treffer ein Fehlercode zurückgegeben. Im Folgenden finden Sie ein Beispiel für einen zurückgegebenen Fehler, da die ID als Apple IDFA gesendet wird, die nur Großbuchstaben enthalten sollte, und dennoch ein Kleinbuchstabe „x“ in der ID vorhanden ist.

Eine Liste der Fehlercodes finden inDokumentation.

Onboarding von globalen Geräte-IDs onboarding-global-device-ids

Zusätzlich zur Echtzeit-Übermittlung von globalen Geräte-IDs können Sie auch Daten mit den IDs "onboard" (hochladen). Dieser Prozess ist der gleiche wie beim Onboarding von Daten mit Ihren Kunden-IDs (normalerweise über Schlüssel/Wert-Paare), Sie würden jedoch einfach die richtigen Data Source-IDs verwenden, damit die Daten der globalen Geräte-ID zugewiesen werden. Eine Dokumentation zum Onboarding-Prozess finden Sie in der Dokumentation. Denken Sie daran, je nach verwendeter Plattform die globale Datenquellen-ID zu verwenden.

Wenn über den Onboarding-Prozess falsche globale Geräte-IDs gesendet werden, werden die Fehler in der Onboarding Status Report angezeigt.

Im Folgenden finden Sie ein Beispiel für einen Fehler, der durch diesen Bericht verursacht würde:

Fehlerbild

recommendation-more-help

468cbaa0-07ce-4354-9a38-4f23b645a466