DokumentationAudience ManagerAudience Manager-Tutorials

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

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Experte
  • Entwickler

Geräte-Advertising-IDs (d. h. iDFA, GAID, Roku-ID) verfügen über Formatierungsstandards, die eingehalten werden müssen, damit sie im digitalen Werbe-Ökosystem verwendet werden können. Kunden und Partner können heute IDs in beliebige Formate in unsere globalen Datenquellen hochladen, ohne darüber informiert zu werden, ob die ID korrekt formatiert ist. Diese Funktion führt zur Validierung von Geräte-IDs, die zur korrekten Formatierung an die globalen Datenquellen gesendet werden, und bietet Fehlermeldungen, wenn IDs falsch formatiert sind. Wir unterstützen die Validierung für iDFA, Google Advertising und Roku IDs beim Start.

Übersicht über die 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 sind als freigegebene Data Sources -Variablen implementiert, die von jedem Kunden oder Datenpartner verwendet werden können, der mit Daten arbeitet, die an Benutzer dieser Plattformen gebunden sind.

Plattform
Source ID AAM Data
ID-Format
AAM PID
Hinweise
Google Android (GAID)
20914
32 Hexadezimalzahlen, im Allgemeinen als Beispiel 8-4-4-4-12 dargestellt, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
1352
Diese ID muss in einer rohen/ungehashten/unveränderten Formularreferenz erfasst werden - https://play.google.com/about/monetization-ads/ads/ad-id/
Apple iOS (IDFA)
20915
32 Hexenzahlen, allgemein als Beispiel 8-4-4-4-12 angegeben, 6D92078A-8246-4BA4-AE5B-76104861E7DC
3560
Diese ID muss in einer rohen/ungehashten/unveränderten Formularreferenz erfasst werden - https://support.apple.com/en-us/HT205223
Roku (RIDA)
121963
32 Hexadezimalzahlen, im Allgemeinen als Beispiel 8-4-4-4-12 dargestellt, fcb2a29c-315a-5e6b-bcfd-d889ba19aada
11536
Diese ID muss in einer rohen/ungehashten/unveränderten Formularreferenz 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 einer rohen/ungehashten/unveränderten Formularreferenz 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 numerische Alpha-Zeichenfolge 7XCBNROQJQPYW
15950
Diese ID muss in einer rohen/ungehashten/unveränderten Formularreferenz erfasst werden - https://developer.samsung.com/tv/develop/api-references/samsung-product-api-references/productinfo-api

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

Das Festlegen der Advertiser-ID in der App ist in Wahrheit ein zweistufiger Prozess, der zunächst die Advertiser-ID abruft und dann an die Experience Cloud sendet. Nachstehend finden Sie Links zur Durchführung dieser Schritte.

  1. ID abrufen

    1. Apple Informationen über den advertising ID finden Sie HIER.
    2. Einige Informationen zum Festlegen des advertiser ID für Android -Entwickler finden Sie HIER.

  2. Senden Sie es mit der setAdvertisingIdentifier -Methode im SDK an die Experience Cloud.

    1. Informationen zur Verwendung von setAdvertisingIdentifier finden Sie in der Dokumentation für sowohl iOS als auch Android.

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

DCS-Fehlernachrichten für falsche IDs dcs-error-messaging-for-incorrect-ids

Wenn eine falsche globale Geräte-ID (IDFA, GAID usw.) in Echtzeit an Audience Manager gesendet 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, der nur Großbuchstaben enthalten soll, und trotzdem gibt es in der ID eine Kleinbuchstabe 'x'.

Fehlerbild

Eine Liste der Fehlercodes finden Sie in der Dokumentation .

Onboarding globaler Geräte-IDs onboarding-global-device-ids

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

Wenn beim Onboarding-Prozess falsche globale Geräte-IDs gesendet werden, werden die Fehler im Onboarding Status Report angezeigt.

Im Folgenden finden Sie ein Beispiel eines Fehlers, der durch diesen Bericht ausgegeben wird:

Fehlerbild

recommendation-more-help
468cbaa0-07ce-4354-9a38-4f23b645a466