Track
Pixel- & Plattform-IntegrationenReferenzFortgeschrittene

Reddit, Pinterest und Snapchat Conversions APIs im Vergleich: Click-IDs, Testmodi und Eventnamen

Ein kompakter Vergleich der Reddit Conversions API, Pinterest Conversions API und Snapchat Conversions API — Endpunkte, Auth, Click-IDs (rdt_cid, epik, ScCid), Eventnamen, Dedup-Felder und Test-Schalter.

Von
Track-Redaktion
Veröffentlicht
Zuletzt fachlich geprüft
Lesedauer
2 Min. Lesezeit

Das Wichtigste in Kürze

  • Alle drei APIs teilen Metas Form — Eventname, Zeitstempel, Event-ID, gehashte Nutzerdaten plus Click-ID, Custom Data —, unterscheiden sich aber in Endpunkt, Auth, Click-ID-Parameter, Event-Vokabular und Zeitstempelformat.
  • Die Click-IDs heißen rdt_cid, epik und ScCid (Groß-/Kleinschreibung relevant) und speisen jeweils ein plattformspezifisches Feld; bei Pinterest schmerzt ein fehlendes epik am meisten.
  • Das Testen unterscheidet sich: Reddit nutzt test_mode im Body, Pinterest den Query-Parameter ?test=true, Snapchat tauscht /events gegen /validate.
  • Typische Fehler sind falsche Parameternamen, doppeltes Hashing, ein Pixel-Token über mehrere Konten und ein in Produktion vergessener Testmodus.

Die gemeinsame Form

Alle drei nehmen ein JSON-Array von Events an, jeweils mit Eventname, Zeitstempel, Event-ID zur Deduplizierung, einem user/user_data-Block mit gehashter E-Mail und Telefonnummer plus der Click-ID der Plattform sowie einem Custom-Data-Block mit Wert, Währung, Bestellnummer und Inhalten. Alle drei wollen SHA-256-Hashes kleingeschriebener E-Mails und E.164-Telefonnummern. Alle drei haben ein Browser-Pixel, das ein First-Party-Cookie setzt und dieselbe Event-ID akzeptiert, und alle drei attribuieren am besten, wenn die auf der Landingpage erfasste Click-ID mit dem Server-Event mitreist.

Im direkten Vergleich

RedditPinterestSnapchat
Endpunktads-api.reddit.com/api/v3/pixels/{pixel_id}/conversion_eventsapi.pinterest.com/v5/ad_accounts/{ad_account_id}/eventstr.snapchat.com/v3/{pixel_id}/events
AuthBearer-Token (Reddit-Ads-OAuth oder Conversions-Token)Bearer-Token mit ads:write (Conversion-Access-Token)Bearer-Token (CAPI-Token aus dem Ads Manager)
Click-ID-URL-Parameterrdt_cidepikScCid
Click-ID-Feldclick_iduser_data.click_iduser_data.sc_click_id
Browser-Cookie_rdt_uuid_epik_sciduser_data.sc_cookie1
Eventname KaufPurchasecheckoutPURCHASE
Eventname LeadLeadleadSIGN_UP
Dedup-Feldevent_metadata.conversion_idevent_idevent_id (Pixel: client_dedup_id)
ZeitstempelRFC 3339 event_atUnix-Sekunden event_timeUnix-ms event_time
Test-Schaltertest_mode: true im BodyQuery-Parameter ?test=trueEndpunkt /validate statt /events
Batch-Limit1.0001.0002.000

Reddit

Reddits Event-Vokabular ist kurz: PageVisit, ViewContent, Search, AddToCart, AddToWishlist, Purchase, Lead, SignUp, Custom. Werte gehören in event_metadata.value_decimal mit currency und item_count. Das Flag test_mode erfasst das Event im Test-Tab des Events Managers, ohne es zu zählen — das macht den Testevent des Assistenten sicher. Eine conversion_id in den Metadaten dedupliziert gegen das Pixel-rdt('track', 'Purchase', { conversionId }).

Pinterest

Pinterest nutzt kleingeschriebene Eventnamen (checkout, add_to_cart, lead, signup, page_visit, view_category, search, watch_video, custom) und action_source: web|app_android|app_ios|offline. user_data.em und ph sind Arrays von Hashes; external_id ebenso. Der Query-Parameter ?test=true validiert und liefert Ergebnisse je Event, ohne ins Reporting zu schreiben. Pinterest ist die Plattform, bei der ein fehlendes epik am meisten schmerzt, weil das Pixel-Cookie oft blockiert wird; erfasse epik beim Landen.

Snapchat

Snapchats v3-API spiegelt Metas Feldnamen am engsten (action_source, user_data, custom_data) und nutzt Eventnamen in Großbuchstaben: PURCHASE, SAVE, START_CHECKOUT, ADD_CART, VIEW_CONTENT, ADD_BILLING, SIGN_UP, SEARCH, PAGE_VIEW, SUBSCRIBE, AD_CLICK, AD_VIEW, COMPLETE_TUTORIAL, LEVEL_COMPLETE, INVITE, LOGIN, SHARE, RESERVE, ACHIEVEMENT_UNLOCKED, SPENT_CREDITS, RATE, START_TRIAL, LIST_VIEW, APP_INSTALL, APP_OPEN, CUSTOM_EVENT_1..5. Der Endpunkt /validate liefert dieselben Validierungsfehler wie der Live-Endpunkt, erfasst aber nichts — der Testmodus tauscht also den Pfad statt ein Flag zu setzen. Sende sc_click_id aus dem Parameter ScCid und sc_cookie1 aus dem Cookie _scid, wenn Marketing-Consent vorliegt.

Typische Fehler

  • Die Click-ID aus dem falschen Parameternamen senden (ScCid unterscheidet Groß-/Kleinschreibung; Pinterests heißt epik, nicht pin_click_id).
  • Bereits gehashte Werte ein zweites Mal hashen, wenn das CRM Hashes exportiert.
  • Denselben Pixel-Token über mehrere Werbekonten nutzen — jeder Token ist auf ein Pixel oder Konto beschränkt.
  • Den Testmodus in Produktion eingeschaltet lassen: Track zeigt auf jeder Destination, die noch im Testmodus ist, ein dauerhaftes Banner.

Primärquellen

Dokumentationen und Standards, auf denen dieser Artikel beruht.

  1. Reddit Ads — Conversions APIads-api.reddit.com
  2. Pinterest API — Conversionsdevelopers.pinterest.com
  3. Snap — Conversions APIdevelopers.snap.com

War dieser Artikel hilfreich?

Fachlich verantwortlich

Track-Redaktion

Produkt & Engineering

Die Menschen hinter Track: Engineers und Analysts, die täglich an Server-Side Tracking, Consent-Tooling und Connector-Integrationen arbeiten.