Zum Hauptinhalt springen

​
Conversion-API einrichten

​
Voraussetzungen 

​
Zugriff auf die Ads API – neue Anträge

Schritt 1: Developer-Konto
  • Wenn Sie ein Developer-Konto beantragen, wählen Sie einen unserer Tarife für eine sofortige Freischaltung.
  • Hinweis: Als Best Practice empfehlen wir dringend, den offiziellen X-Handle Ihres Unternehmens zu verwenden, um ein Developer-Konto zu erstellen und den Zugriff auf die Ads API zu beantragen. Wenn das Developer-Konto mit einem Entwickler-Handle verknüpft ist, können diese Anmeldedaten bei Bedarf nicht übertragen werden. Es ist am besten, dies unter einem Unternehmenskonto zu verwalten und bei Bedarf die Multi-User-Anmeldung zu nutzen. Andernfalls sollte das Konto mindestens mit individuellen Einstellungen eingerichtet sein (Headerbild, Avatar, Profilbeschreibung und Profil-URL) und die Zwei-Faktor-Authentifizierung verwenden.
Schritt 2: Ads API-Antrag
  • Stellen Sie sicher, dass Sie die richtige App-id für Ihren Ads API-Antrag bereithalten. Die App-id finden Sie im Entwicklerportal unter Projects & Apps. Beispiel: 16489123
  • Fordern Sie Zugriff auf die Ads API an, indem Sie sich an Ihre X-Ansprechperson wenden.

​
Ads API-Zugriff – Bestehende Anwendungen

  • Wenn Sie bereits eine aktiv genutzte Ads API-App haben, können sowohl die App als auch bestehende Access Tokens für die Conversion API verwendet werden.

​
Access Tokens

  • User Access Tokens für den Nutzer-Handle, dem die Ads API-Anwendung gehört, können direkt im Entwicklerportal generiert und abgerufen werden. Dies wird als „persönlicher Access Token“ bezeichnet, da er für Ihren eigenen X-Handle gedacht ist. Allgemeine Informationen zur Authentifizierung und zum Entwicklerportal finden Sie hier.
  • User Access Tokens für Nutzer-Handles, die nicht dem Ads API-Anwendungsinhaber gehören, müssen mit einem 3-legged OAuth-Flow generiert werden. Optionen zur Generierung des Access Token mit 3-legged OAuth umfassen:
  • Alle mit der Conversion API verwendeten Nutzer-Tokens müssen für Nutzer mit dem Zugriffslevel AD_MANAGER oder ACCOUNT_ADMIN ausgestellt sein. Dies kann über das authenticated_user_access endpoint überprüft werden.
  • Hinweis: Die Tokens selbst (nach der oben beschriebenen Erstellung) können zur Nutzung an Nutzer ohne das Zugriffslevel AD_MANAGER oder ACCOUNT_ADMIN weitergegeben werden.

​
Schritte

​
Erstellen des Conversion-API-Ereignisses

Um die Conversion API zu verwenden, müssen Sie im Ads Manager ein neues Conversion-Ereignis erstellen oder ein bereits vorhandenes Ereignis nutzen, das mit dem X Pixel verwendet wird. Wenn Sie eine Deduplizierung zwischen Pixel- und Conversion-API-Ereignissen durchführen möchten, müssen Sie das vorhandene Ereignis verwenden, das Sie für den Pixel erstellt haben. 
Option 1: Verwendung eines vorhandenen Conversion-Events im Ads Manager
Wenn Sie ein vorhandenes Event nutzen möchten, das Sie bereits mit dem X Pixel verwenden, ist das möglich; übernehmen Sie dafür die Event-ID dieses Events. Wenn Sie sowohl Pixel als auch Conversion API für dasselbe Event einsetzen, stellen Sie sicher, dass Sie den Deduplizierungsschlüssel sowohl im Pixel-Code-Snippet als auch in der Conversion-API-Anfrage (als conversion_id) verwenden, um Events zwischen Pixel und Conversion API für dasselbe Event zu deduplizieren. Weitere Informationen finden Sie in Abschnitt d. Testing Events and Deduplication. 
Option 2: Erstellen eines neuen Conversion-Events im Ads Manager:
Es ist wichtig, vor dem Erstellen eines Events eine Eventquelle im Events Manager anzulegen. Um zu überprüfen, ob Sie eine Eventquelle (X Pixel) zu Ihrem Konto hinzugefügt haben, gehen Sie zum Events Manager und prüfen Sie, ob in der linken Navigation X Pixel angezeigt wird. Wenn Sie noch keine Eventquelle hinzugefügt haben, folgen Sie bitte den nachstehenden Schritten, um eine Eventquelle zu erstellen.
  1. Gehen Sie zu ads.x.com
  2. Navigieren Sie oben links zum Abschnitt Tools und klicken Sie auf Events Manager
  3. Wählen Sie oben rechts Add event source, um Add an event source auszuwählen, falls in Ihrer linken Seitenleiste noch keine X Pixel-Eventquelle vorhanden ist
    1. Die ID der X Pixel-Eventquelle ist Ihre Pixel ID
Jetzt haben Sie eine Eventquelle und eine Pixel ID. Sie müssen innerhalb der Eventquelle ein Event für die Conversion-Events erstellen, die Sie verfolgen möchten:
  1. Wählen Sie innerhalb der X Pixel-Eventquelle auf der rechten Seite Add events
  2. Wählen Sie Install with Conversion API
  3. Sie sehen die Pixel ID und Event ID dieses Events, die in der API verwendet werden
    1. Die ID des Events ist Ihre Event ID
  4. Klicken Sie auf Save, und Ihr Conversion-Event ist erstellt und einsatzbereit

​
Vorbereiten von Identifikatoren für Conversion-Events 

Derzeit muss mindestens ein Identifikator übergeben werden, etwa die Click ID (twclid), eine E-Mail-Adresse oder eine Telefonnummer. Bei Verwendung von IP-Adresse oder User-Agent muss ein zweiter Identifikator gesendet werden, um ein korrektes Conversion-Matching zu gewährleisten. Das Übermitteln weiterer Identifikatoren führt zu einer höheren Conversion-Matching-Rate.
Feld für KundenabgleichFormatHashing erforderlich?
X Click IDVon X generiert (weitere Informationen)Nein
E-Mail-AdresseFührende und nachgestellte Leerzeichen entfernenErforderlich (SHA256)
TelefonnummerE.164-StandardErforderlich (SHA256)
IP-AdresseFührende und nachgestellte Leerzeichen entfernenNein
User-AgentFührende und nachgestellte Leerzeichen entfernenNein

​
1. X Click-ID-Bezeichner vorbereiten 

Es wird empfohlen, die Click ID stets in die Conversion-Anfrage aufzunehmen. Die Click ID sollte aus dem query-String-Parameter twclid extrahiert werden, sobald sie verfügbar ist, nachdem der Nutzer zur Ziel-Website navigiert hat.  Einfaches JavaScript-Beispiel: 
var queryString = document.location.search;
if (queryString.has('twclid') {
  twitterClickID = getParam(queryString, 'twclid');
  // Empfohlene nächste Schritte: Logging, in den lokalen Speicher schreiben
}
Es wird empfohlen:
  1. Den twclid-Wert stets zu parsen, wenn er in den URL-Query-Parametern vorhanden ist.
  2. Die data zusammen mit relevanten Formularfeldern oder Informationen zu Conversion-Ereignissen zu speichern.
Die Verknüpfung der Click-ID mit Conversion-Ereignissen und Workflow-Informationen ermöglicht Szenarien wie Batch-Verarbeitung, Algorithmen zur Analyse und Erstellung von Conversion-Ereignissen auf Basis mehrerer Website-Navigationspfade sowie Massenuploads. Die Event Source URL sollte URL-codiert sein und die Webseite repräsentieren, die das Ereignis ausgelöst hat.

​
2. E-Mail-Identifikator vorbereiten 

Unterstützte Customer-Matching-fields können übermittelt werden, sollten jedoch normalisiert und, falls erforderlich, gehasht werden, um die Privatsphäre zu schützen. Die Informationen müssen mit SHA-256 ohne Salt gehasht werden.  Beispielsweise sollte eine E-Mail-Adresse wie test@x.com in gehashter Form an uns übermittelt werden: d360d510a224510f373931ce2d6215a799f5a9c1cef221b0149b6b6b50cced62.

​
3. Telefonidentifikator vorbereiten 

Die Telefonnummer sollte gemäß dem E.164-Standard übermittelt werden, und die Daten müssen ohne Salt mit SHA256 gehasht werden.  Beispiel: Für eine US‑Telefonnummer +11234567890 sollte sie in gehashter Form an uns gesendet werden: 1fa6b8d986d9b9cd01bf36951815158bbde9f520c0567c835dfe34783d0a4231.

​
4. IP-Adressidentifier vorbereiten

Die IP-Adresse muss zusammen mit einem anderen Identifier (twclid, E-Mail-Adresse, Telefonnummer oder User-Agent) übermittelt werden. Für diesen Identifier ist kein Hashing erforderlich. Dieser Wert wird in Punkt-Dezimalnotation angegeben, mit vier durch Punkte getrennten Zahlen. Beispielsweise kann die IP-Adresse eines Nutzers 8.25.197.25 sein.

​
5. User-Agent-Bezeichner vorbereiten

Der User-Agent muss zusammen mit einem anderen Bezeichner (twclid, E‑Mail‑Adresse, Telefonnummer oder IP‑Adresse) übermittelt werden. Für diesen Bezeichner ist kein Hashing erforderlich. Dieser Bezeichner ermöglicht dem Server, die Anwendung, das Betriebssystem, den Anbieter und/oder die Version des anfragenden User-Agents zu identifizieren. Beispielsweise kann dieser Wert als Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36 übergeben werden.

​
Erstellen der Conversion-Event-Anfrage

POST: version/measurement/conversions/:pixel_id Senden Sie Conversion-Events für ein bestimmtes Anzeigenkonto. Prüfen Sie den Antwortcode auf Erfolg (HTTP 200 OK). Es wird empfohlen, für den Fall zurückgegebener Fehlercodes einen Wiederholungsmechanismus und grundlegtes Logging einzusetzen. Ausführliche Informationen zur URL des endpoints und zu den Parametern des POST-Body finden Sie im Abschnitt API Reference. 

​
Beispielanforderung (zur besseren Lesbarkeit formatiert)


    twurl -H 'ads-api.x.com' -X POST '/12/measurement/conversions/oka17' --data '
    {
      "conversions":[
         {
            "conversion_time":"2022-02-18T01:14:00.603Z",
            "event_id":"ol288",
            "identifiers":[
               {
                  "twclid":"23opevjt88psuo13lu8d020qkn"
               },
               {
                  "hashed_email":"d360d510a224510f373931ce2d6215a799f5a9c1cef221b0149b6b6b50cced62"
               },
               {
                  "hashed_phone_number":"1fa6b8d986d9b9cd01bf36951815158bbde9f520c0567c835dfe34783d0a4231"
               },
               {
                  "ip_address":"1.0.0.0",
                  "user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36"
               }
            ],
            "value":"20.00",
            "number_items":3,
            "conversion_id":"23294827",
            "description":"Einkäufe für Tierbedarf",
            "contents":[
               {
                  "content_id":"1",
                  "content_name":"Decken",
                  "content_type":"Tierbedarf",
                  "content_price":100.99,
                  "num_items":1,
                  "content_group_id":"123"
               }
            ]
         }
      ]
    }' --header 'Content-Type: application/json'

​
Beispiel-Antwort

{"request": {
 "params": {
     "account_id":"18ce552mlaq"}
 },
 "data": {
     "conversions_processed":1,
     "debug_id":"ff02e052-36e4-47d6-bdf0-6d8986446562"}
}

​
Rate Limit

Die Rate Limit beträgt 60.000 Ereignisse pro Konto, pro 15‑Minuten‑Intervall. Beachten Sie, dass Ihr Servercode möglicherweise Logik außerhalb dieses Request-Aufrufs implementieren muss, einschließlich:
  1. Instrumentierung von Nutzeraktionen (Logging), um pro Ereignis korrekte Conversion-Daten senden zu können
  2. Alle erforderlichen Logiken, um Conversion-Ereignisse von Nutzern herauszufiltern, die relevante Datenschutzentscheidungen getroffen haben – zum Beispiel, wenn sie dem Tracking oder dem Verkauf ihrer personenbezogenen Daten auf der Website des Werbetreibenden widersprochen haben
  3. Integration mit Event-Triggern und Seiten, um Ereignisse zu erfassen und Conversions zu senden

​
Testen von Ereignissen und Deduplizierung

​
Testen von Events

Wenn Ihr Event erfolgreich Conversion-Events empfangen hat, sollte innerhalb von 12 bis 24 Stunden der Status des „Single event web tag“ auf der Seite Conversion Tracking im Ads Manager auf TRACKING stehen. Das Senden von Conversions über die Conversion API wirkt sich nicht auf laufende Kampagnen aus. Sie können die Analyseergebnisse Ihres Conversion-Events pro Tag-ID auch wie folgt überprüfen:

​
Deduplizierung zwischen Pixel und Conversion API

Wenn Sie Konversionen zwischen Pixel- und Conversion-API-Anfragen deduplizieren möchten, steht conversion_id als Deduplizierungsschlüssel zur Verfügung. Die Deduplizierung erfolgt nur auf Ereignisebene. Anders ausgedrückt: Um zwischen Pixel- und CAPI-Anfragen zu deduplizieren, muss ein Werbetreibender dasselbe Ereignis in beiden (Pixel- und CAPI-)Anfragen verwenden und zusätzlich dieselbe conversion_id nutzen. Deduplizierung kann nur für Ereignisse erfolgen, die innerhalb eines 48‑stündigen Zeitfensters eingehen.

​
Conversion-Tracking (Überblick)

​
Zusammenfassung

Conversion-Tracking ermöglicht es Ihnen, die Anzahl der X Nutzer zu messen, die nach dem Ansehen und Interagieren mit Ihren Anzeigen auf X eine gewünschte Aktion ausführen. Es bietet Ihnen die Möglichkeit zu ermitteln, welche Ihrer Kampagnen Aktionen wie Seitenbesuche, Anmeldungen und Käufe auslösen. So erhalten Werbetreibende Off-X-Messmöglichkeiten, um die Performance ihrer Direct-Response-Anzeigen zu verstehen und Kunden kosteneffizient zu akquirieren. Mit einem Conversion-Tag können Werbetreibende Nutzer-Conversions erfassen und ihren X Werbekampagnen zuordnen. Dies verschafft ihnen die nötige Transparenz, um ihre Kampagnen auf die Erreichung ihrer Cost-per-Acquisition-(CPA)-Ziele zu optimieren. Es gibt eine Vielzahl von Website-Aktionen, die ein Werbetreibender mit Conversion-Tracking messen kann. Er kann eine oder mehrere auswählen – entsprechend den Aktionen, die er mit seiner Werbekampagne fördern möchte:
  • Seitenbesuch: Nutzer besucht eine Landingpage auf der Website des Werbetreibenden
  • Kauf: Nutzer schließt den Kauf eines Produkts oder einer Dienstleistung auf der Website des Werbetreibenden ab
  • Download: Nutzer lädt eine Datei, etwa ein Whitepaper oder ein Softwarepaket, von der Website des Werbetreibenden herunter
  • Anmeldung: Nutzer meldet sich für den Dienst, den Newsletter oder die E-Mail-Kommunikation des Werbetreibenden an
  • Benutzerdefiniert: Sammelkategorie für eine benutzerdefinierte Aktion, die in keine der oben genannten Kategorien fällt
Das Conversion-Tracking von X bietet Werbetreibenden einen vollständigen Blick auf die Conversion-Attribution. Im Vergleich zu Drittanbieter-Messsystemen, die Kunden anstelle der eigenen Conversion-Tracking-Funktion von X verwendet haben könnten – etwa eindeutige Click-URLs in Kombination mit Tracking-Tags von Drittanbietern – ermöglicht das Conversion-Tag von X, Conversions zu erfassen, die Mid- und Upper-Funnel-Engagements wie Tweet-Erweiterungen, Retweets, Favoriten, Antworten und Follows sowie Impressionen zugeschrieben werden.

​
FAQ

Zunächst erstellt ein Werbetreibender ein Conversion-Tag, also ein von X bereitgestelltes Code-Snippet, und implementiert es auf seiner Website. Das Tag ist dann bereit, eine Conversion zu messen, sobald ein Nutzer die definierte Aktion ausführt.Nutzer sehen anschließend die Anzeige des Werbetreibenden im X-Client, die sie zur Website des Werbetreibenden und zur entsprechend getaggten Aktion führt. Wenn der Nutzer diese Aktion innerhalb des/der vom Werbetreibenden beim Einrichten des Tags festgelegten Attributionsfenster(s) abschließt, erkennt das Tag, dass der Nutzer zuvor mit einer X-Anzeige interagiert hat. Das Tag „feuert“ dann, d. h. es sendet eine Benachrichtigung an die Server von X, sodass die Conversion der Anzeige zugeschrieben werden kann, die sie ausgelöst hat.
Nein, unser Produkt ist nicht dafür ausgelegt, spezifische Conversion-Tags bestimmten Kampagnen zuzuordnen. Stattdessen verfolgt das System, sobald ein Tag eingerichtet ist, automatisch, welche Anzeige Conversions auf einem bestimmten Tag erzielt hat.
Standard-Attributionsfenster nach View: 1 TagStandard-Attributionsfenster nach Engagement: 14 TageDiese Standardwerte können bei der Einrichtung des Conversion-Tags oder jederzeit nach der Erstellung des Tags geändert werden. Die Optionen für Attributionsfenster nach Engagement sind 1, 7, 14, 30, 60 und 90 Tage. Die Optionen für Attributionsfenster nach View sind keine, 1, 7, 14, 30, 60 und 90 Tage.
Auch wenn die Ziele, Ausgangssituationen und Strategien je nach Kunde variieren, finden Sie hier einige Ideen, die sich bei Kunden bewährt haben, die am Conversion-Tracking in der Alpha- oder Beta-Phase teilgenommen haben:Creative:
  • Angebote: Kombinieren Sie einen Rabatt, eine Aktion oder kostenlosen Versand mit dem Promoted Tweet, um mehr Interesse an der gewünschten Aktion zu wecken
  • Gewinnspiele und Wettbewerbe: Vor allem bei bekannten Marken führten Gewinnspiele und Wettbewerbe zu Conversions
  • Experimentieren mit Tweet-Text: Testen von Groß- vs. Kleinschreibung (FREE vs. free bzw. NOW vs. now)
  • Fristen: Setzen Sie eine Deadline, um Menschen zu sofortigem Handeln zu motivieren (Angebot endet am 12. Dezember!)
  • Aussagekräftige Fotos hinzufügen: Es lohnt sich zu testen, ob visuell ansprechende Fotos im Tweet-Creative Conversions fördern; die Ergebnisse können variieren oder vom Angebot des Kunden abhängen.
Targeting:
  • @handle-Targeting und Targeting nach Interessenkategorien: Eine enge Abstimmung von Tweet-Text und @Handles auf die intendierte Zielgruppe des Tweets förderte Conversions
  • Nutzung von Nischen-, aber volumenstarken Keywords: Im Konzertbereich erwies sich die Verwendung von Keywords zum Künstler/Musiker (z. B. dessen Name) als effektiv.
  • Tailored Audiences: Kunden, die TA Web und Conversion-Tracking gemeinsam nutzten, erzielten niedrigere CPAs als Kontrollgruppen mit anderen Targetings
Je granularer Ihre Kampagnensegmentierung, desto umsetzbarer sind die gemeldeten Conversion-Ergebnisse. Beispielsweise ist es deutlich einfacher, eine Kampagne mit 4 Keywords zu optimieren als eine mit 50.

​
Fehlerbehebung und Support für die Conversion API

Bei Fragen zu Fehlercodes nach dem Aufruf der API finden Sie den entsprechenden Abschnitt unten. Für alle anderen Fragen wenden Sie sich bitte an Ihre Ansprechperson bei X; wir kümmern uns so schnell wie möglich um die Lösung. 

​
Fehlerbehandlung und Erläuterung

Eine einzelne Anfrage ist nur dann erfolgreich, wenn für alle darin enthaltenen Konvertierungen keine Fehler auftreten. Tritt in einer einzelnen Konvertierung ein Fehler auf, gibt der endpoint eine Liste aller zutreffenden Fehler aus.

​
Übersicht der Fehlercodes der X Ads API

Hier finden Sie eine umfassende Liste der Fehlercodes in der X Ads API: https://developer.x.com/en/docs/twitter-ads-api/response-codes Erfolgreiche Antworten der Conversion API sind durch einen HTTP-Statuscode der 200er-Serie und eine JSON-basierte Nutzlast gekennzeichnet, die das angeforderte Objekt enthält.

​
Bei einem HTTP-Code aus der 500er‑Reihe liegt ein Serverproblem vor, nicht ein Problem mit Ihrer Anfrage oder der Kontoeinrichtung. Bitte prüfen Sie die X API Status-Seite oder das Developer Community Forum, falls andere ähnliche Probleme melden.

​
Bei einem HTTP-Statuscode aus der 400er‑Reihe treten häufig folgende Fälle auf

  • 400 Bad Request (Anfrage entspricht nicht den Standards)
  • 401 Unauthorized (Authentifizierungsprobleme)
  • 403 Forbidden (API‑Zugriffsprobleme im Zusammenhang mit diesem Developer-Konto)
  • 404 Not Found (URL oder Parameter sind für das endpoint möglicherweise nicht korrekt)

​
Fehlercodes der Conversion-API

​
400 Bad-Request-Szenarien

GrundTypFehlermeldung
Fehlender Bezeichner (derzeit gehashte E-Mail oder X-Click-ID – twclid)400 Bad RequestEs muss mindestens ein Benutzerbezeichner angegeben werden
Ungültige gehashte E-Mail400 Bad RequestHashed_email ist kein gültiger SHA-256 hash
Der type von event_id ist kein Single Event Tag (SET)400 Bad RequestEvent_id (<event_id>) ist kein Single Event Tag (SET)
Angeforderte Conversion-Ereignisse überschreiten das Limit (derzeit 500 Ereignisse pro Anfrage)400 Bad RequestConversion Count Limit ist 500
Fehlende Event-ID400 Bad RequestEvent-ID wurde nicht gefunden

​
Beispiel für einen JSON-Fehlercode

Anfrage:
POST '/11/measurement/conversions/o6dkt' --data '{"conversions":[{"conversion_time":"2022-06-16T01:14:00.603Z","event_id":"o6dkt","identifiers":[{"twclid":"23opevjt88psuo13lu8d020qkn"}]}]}' --header 'Content-Type: application/json'

​
Fehlermeldung:

{"errors":[{"code":"INVALID_PARAMETER","message":"event_id (o6dkt) is not a single event tag (SET)","parameter":"event_id"}],"request":{"params":{"account_id":"18ce552mlaq"}}}

​
Anfrage:

twurl_ads -X POST '/11/measurement/conversions/o6dkt' --data '{"conversions":[{"conversion_time":"2022-06-16T01:14:00.603Z","event_id":"o6dl3","identifiers":[{"twclid":""}]}]}' --header 'Content-Type: application/json'

​
Fehlermeldung:

{"errors":[{"code":"INVALID_PARAMETER","message":"Es muss mindestens ein Benutzerbezeichner angegeben werden","parameter":""}],"request":{"params":{"account_id":"18ce552mlaq"}}}

​
Anfrage:

twurl_ads -X POST '/11/measurement/conversions/o6dkt' --data '{"conversions":[{"conversion_time": "2022-06-16T01:14:00.603Z", "event_id":"o6dl3", "identifiers": [{"hashed_email": "abc"}]}]}' --header 'Content-Type: application/json'

​
Fehlermeldung:

{"errors":[{"code":"INVALID_PARAMETER","message":"hashed_email (abc) is not a valid SHA-256 hash","parameter":"hashed_email"}],"request":{"params":{"account_id":"18ce552mlaq"}}}

​
Anfrage:

twurl_ads -X POST '/11/measurement/conversions/o6dkt' --data '{"conversions":[{"conversion_time": "2022-06-16T01:14:00.603", "event_id":"o6dl3", "identifiers": [{"twclid": "23opevjt88psuo13lu8d020qkn"}]}]}' --header 'Content-Type: application/json'

​
Fehlermeldung:

{"errors":[{"code":"INVALID_PARAMETER","message":"Expected time in yyyy-MM-ddTHH:mm:ss.SSSZ, got \"2022-06-16T01:14:00.603\" for conversion_time","parameter":"conversion_time"}],"request":{"params":{"account_id":"18ce552mlaq"}}}

​
401 Nicht autorisiert

Grund: Authentifizierungsdaten fehlen oder sind falsch Lösung: Befolgen Sie die Authentifizierungsschritte in der Einrichtungsdokumentation mit einer der drei Authentifizierungsmethoden: User Access Tokens für andere Benutzerhandles als das Handle, dem die Ads API‑App gehört, müssen über einen 3-legged OAuth-Flow generiert werden. Optionen zum Generieren des Access Token mit 3-legged OAuth sind: Alle Benutzer-Tokens, die mit der Conversion API verwendet werden, müssen für Nutzer mit dem Zugriffslevel AD_MANAGER oder ACCOUNT_ADMIN* ausgestellt sein. Dies kann über den authenticated_user_access endpoint überprüft werden.

​
403 Zugriff verweigert 

GrundTypFehlermeldung
Das von Ihnen verwendete Developer-Konto hat keinen Zugriff auf die Ads API. Hier Zugriff beantragen.403 Unauthorized ClientDie Client‑Anwendung mit id <>, die diese Anfrage stellt, hat keinen Zugriff auf die X Ads API. Stellen Sie sicher, dass Ihre Anwendung über advertiser-api‑Zugriff verfügt. Verwenden Sie ‘twurl accounts’ und ‘twurl set default <username> <key>’, um die verwendete Anwendung zu ändern.

​
404 Nicht gefunden 

GrundTypFehlermeldung
Die Request-URL oder die Parameter sind für den endpoint nicht korrekt404 Route Not FoundDie angeforderte Ressource wurde nicht gefunden
Sie haben keinen Zugriff auf das Konto, dem die pixel_id/Universal-Website-Tag gehört404 Not FoundUser <user_id> does not have access to account <account_id>. Type ‘sn <user_id>’ to get the handle of the user. Use ‘twurl accounts’ and ‘twurl set default \u003Cusername\u003E’ to change the user you’re using.
Die event id gehört nicht zu dem angegebenen Konto, das mit der pixel ID (UWT ID) verknüpft ist404 Not Foundevent_id <event_id> gehört nicht zum angegebenen Konto

​
Beispiel für einen JSON-Fehlercode

​
Anfrage:

twurl_ads -X POST '/11/measurement/conversions/o8z6j' --data '{"conversions":[{"conversion_time": "2022-06-16T01:14:00.603Z", "event_id":"abc", "identifiers": [{"twclid": "23opevjt88psuo13lu8d020qkn"}]}]}' --header 'Content-Type: application/json' Fehlermeldung: {"errors":[{"code":"NOT_FOUND","message":"event_id (abc) gehört nicht zum angegebenen Account","parameter":"event_id"},{"code":"INVALID_PARAMETER","message":"event_id (abc) ist kein Single Event Tag (SET)","parameter":"event_id"}],"request":{"params":{"account_id":"18ce55gze09"}}}

​
API-Referenzindex

Für die vollständige API-Referenz wählen Sie ein endpoint aus der List:

​
Web-Conversions

Conversion-APImeasurement/conversions/:pixel_id
Web-Event-Tagaccounts/:account_id/web_event_tags

​
Web Conversions

POST version/measurement/conversions/:pixel_id Senden Sie Website‑Conversion‑Events für eine einzelne Event‑Tag‑ID. Der Antwortcode sollte auf Erfolg geprüft werden (HTTP 200 OK). Es wird empfohlen, einen Retry‑Mechanismus und grundlegtes Logging vorzusehen, falls Fehlercodes zurückgegeben werden. Das Rate Limit beträgt 100.000 Requests pro 15‑Minuten‑Intervall und Konto (jede Request erlaubt 500 Events).
Ressourcen-URL
https://ads-api.x.com/12/measurement/conversions/:pixel_id
Anforderungs-URL-Parameter
NameBeschreibung
pixel_id
erforderlich		Die Base-Tag-ID für ein Werbekonto. Dies ist der base36-codierte Wert der Base-Tag-ID eines Werbekontos.

Type: string

Beispiel: o8z6j
conversions
erforderlich		Das Objekt im POST-Body der API-Anfrage. Liste von Conversion-Ereignissen. Es können bis zu 500 Conversion-Ereignisse übermittelt werden. Siehe die Tabelle unten für unterstützte fields.

Type: array

Beispiel: "conversions":[{"conversion_time": "2022-02-18T01:14:00.603Z", "event_id":"o87ne", "identifiers": [{"twclid": "23opevjt88psuo13lu8d020qkn"}], "conversion_id": "23294827"}]
conversions-Objekt
NameBeschreibung
conversion_time
erforderlich		Der Zeitpunkt im Format ISO 8601.

Typ: string

Beispiel: 2017-10-05T00:00:00Z
event_id
erforderlich		Die Base-36-ID eines bestimmten Events. Sie entspricht einem vorkonfigurierten Event innerhalb dieses Anzeigenkontos. Im entsprechenden Event im Events Manager wird dies als ID bezeichnet.

Typ: string

Beispiel: o87ne oder tw-o8z6j-o87ne (tw-pixel_id-event-id) – beide werden akzeptiert
identifiers
erforderlich		Eine Liste von Identifier-Objekten, um das Conversion-Event abzugleichen. Unterstützte fields sind in der Tabelle unten aufgeführt. Mindestens eines der Identifier-Objekte ist erforderlich.

Bei Verwendung von IP-Adresse oder User-Agent muss ein zweiter Identifier gesendet werden, um eine korrekte Zuordnung der Conversion sicherzustellen.

Typ: array

Beispiel: "identifiers": [{"twclid": "23opevjt88psuo13lu8d020qkn"},{"hashed_email": "e586883b2b4faf78d48300a79e0e15138d664cdf796ffb86e533170a9893eda8"}]
number_items
optional		Die Anzahl der im Event gekauften Artikel. Muss eine positive Zahl größer als null sein.

Typ: integer

Beispiel: 4
price_currency
optional		Die Währung der im Event gekauften Artikel, angegeben gemäß ISO-4217. Siehe Currency für detaillierte Informationen.

Typ: string

Standard: USD

Beispiel: JPY
value
optional		Der Preis der im Event gekauften Artikel, angegeben in der Währung price_currency.

Typ: double

Beispiel: 100.00
conversion_id
optional		Zur Deduplizierung zwischen Pixel- und Conversion-API-Conversions. Ein Bezeichner für ein Conversion-Event, der für die Deduplizierung zwischen Web Pixel- und Conversion-API-Conversions im gleichen Event-Tag verwendet werden kann. Weitere Informationen finden Sie im Abschnitt „Testing Events and Deduplication“ des Conversions Guide.

Typ: string

Beispiel: 23294827
description
optional		Beschreibung mit zusätzlichen Informationen zu den Conversions.

Typ: string

Beispiel: test conversion
contents
optional		Liste mit Details zu einem bestimmten Produkt/Content für granularere Angaben. Siehe Tabelle unten für unterstützte fields.

Typ: array

Beispiel: "contents": [{"content_id": "1", "content_name": "Blankets", "content_type": "home improvement", "content_price": 100.99, "num_items": 1, "content_group_id": "123"}, {"content_id": "2"}]
Bezeichnerobjekt
NameBeschreibung
twclid
manchmal erforderlich		Klick-ID, wie sie aus der Click-through-URL geparst wird. Sie ist erforderlich, wenn kein anderer Bezeichner angegeben wird.

Type: string

Example: 26l6412g5p4iyj65a2oic2ayg2
hashed_email
manchmal erforderlich		Eine mit SHA256 gehashte E-Mail-Adresse. Der Text muss kleingeschrieben sein; entfernen Sie vor dem Hashing alle führenden oder nachgestellten Leerzeichen. Erforderlich, wenn kein anderer Bezeichner angegeben wird.

Type: string

Example: Für test-email@test.com = e586883b2b4faf78d48300a79e0e15138d664cdf796ffb86e533170a9893eda8
hashed_phone_number
manchmal erforderlich		Eine Telefonnummer im E164-Format, gehasht mit SHA256. Die Telefonnummer muss vor dem Hashing im E164-Format vorliegen. Erforderlich, wenn kein anderer Bezeichner angegeben wird.

Type: string

Example: Für +11234567890 = 1fa6b8d986d9b9cd01bf36951815158bbde9f520c0567c835dfe34783d0a4231
ip_address
manchmal erforderlich		Dieser Wert wird in Punkt-Dezimal-Notation geschrieben, mit vier durch Punkte getrennten Zahlen.

Die IP-Adresse muss zusammen mit einem anderen Bezeichner (twclid, E-Mail-Adresse, Telefonnummer oder User-Agent) übermittelt werden.

Type: string

Example: 8.25.197.25
**user_agent **
manchmal erforderlich		Dieser Bezeichner ermöglicht es dem Server, die Anwendung, das Betriebssystem, den Anbieter und/oder die Version des anfragenden User-Agents zu identifizieren.

Der User-Agent muss zusammen mit einem anderen Bezeichner (twclid, E-Mail-Adresse, Telefonnummer oder IP-Adresse) übermittelt werden.

Type: string

Example: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36.
contents object
NameDescription
content_id
optional		SKU oder GTIN; Kennung, die den Inhalt repräsentiert.

Type: string

Example: jhp
content_group_id
optional		ID, die einer Gruppe von Produktvarianten zugeordnet ist

Type: integer

Example: group 1
content_name
optional		Name des Produkts oder der Dienstleistung.

Type: string

Example: radio flyer
content_price
optional		Preis des Produkts oder der Dienstleistung.

Type: double

Example: 5.00
content_type
optional		Kategorie des gekauften Produkts.

Type: string

Example: clothes
num_items
optional		Anzahl der gekauften Produkte

Type: integer

Example: 1
Antwortparameter
NameBeschreibung
conversions_processedAnzahl der erfolgreich verarbeiteten Conversions

Typ: Integer

Beispiel: 1
debug_idEine Debug-UUID, die für nachfolgende Untersuchungen verwendet werden kann

Typ: String

Beispiel: ff02e052-36e4-47d6-bdf0-6d8986446562
Beispielanfrage
    twurl -H 'ads-api.x.com' -X POST '/12/measurement/conversions/oka17' --data '
    {
      "conversions":[
         {
            "conversion_time":"2022-02-18T01:14:00.603Z",
            "event_id":"ol288",
            "identifiers":[
               {
                  "twclid":"23opevjt88psuo13lu8d020qkn"
               },
               {
                  "hashed_email":"d360d510a224510f373931ce2d6215a799f5a9c1cef221b0149b6b6b50cced62"
               },
               {
                  "hashed_phone_number":"1fa6b8d986d9b9cd01bf36951815158bbde9f520c0567c835dfe34783d0a4231"
               },
               {
                  "ip_address":"1.0.0.0",
                  "user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36"
               }
            ],
            "value":"20.00",
            "number_items":3,
            "conversion_id":"23294827",
            "description":"Käufe von Tierbedarf",
            "contents":[
               {
                  "content_id":"1",
                  "content_name":"Decken",
                  "content_type":"Tierbedarf"
                  "content_price":100.99,
                  "num_items":1,
                  "content_group_id":"123"
               }
            ]
         }
      ]
    }' --header 'Content-Type: application/json'
Beispielanfrage
    {
       "request":{
          "params":{
             "account_id":"18ce552mlaq"
          }
       },
       "data":{
          "conversions_processed":1,
          "debug_id":"ff02e052-36e4-47d6-bdf0-6d8986446562"
       }
    }

​
Web-Event-Tags

GET accounts/:account_id/web_event_tags Ruft Details zu einigen oder allen mit dem aktuellen Konto verknüpften Web-Event-Tags ab.

​
Ressourcen-URL

https://ads-api.x.com/12/accounts/:account_id/web_event_tags

​
Parameter

NameBeschreibung
account_id
erforderlich		Der Bezeichner für das verwendete Konto. Er erscheint im Pfad der Ressource und ist in der Regel ein erforderlicher Parameter für alle Advertiser-API-Anfragen mit Ausnahme von GET accounts. Das angegebene Konto muss dem authentifizierten Benutzer zugeordnet sein.

Type: string

Example: 18ce54d4x5t
count
optional		Gibt die Anzahl der Datensätze an, die pro einzelner Anfrage abgerufen werden sollen.

Type: int

Default: 200
Min, Max: 1, 1000
cursor
optional		Gibt einen Cursor an, um die nächste Ergebnisseite abzurufen. Siehe Pagination für weitere Informationen.

Type: string

Example: 8x7v00oow
sort_by
optional		Sortiert nach einem unterstützten Attribut in auf- oder absteigender Reihenfolge. Siehe Sorting für weitere Informationen.

Type: string

Example: created_at-asc
web_event_tag_ids
optional		Beschränkt die Antwort auf die gewünschten Web-Event-Tags, indem eine kommagetrennte Liste von Bezeichnern angegeben wird. Es können bis zu 200 IDs angegeben werden.

Type: string

Example: o3bk1
with_deleted
optional		Schließt gelöschte Ergebnisse in die Anfrage ein.

Type: boolean

Default: false
Possible values: true, false
with_total_count
optional		Schließt das Antwortattribut total_count ein.

Hinweis: Dieser Parameter und cursor schließen sich gegenseitig aus.

Hinweis: Anfragen, die total_count enthalten, unterliegen niedrigeren Rate Limits; derzeit 200 pro 15 Minuten.

Type: boolean

Default: false
Possible values: true, false

​
Beispielanfrage

GET https://ads-api.x.com/12/accounts/18ce54d4x5t/web_event_tags?web_event_tag_ids=o3bk1

​
Beispielantwort

    {
      "request": {
        "params": {
          "web_event_tag_ids": [
            "o3bk1"
          ],
          "account_id": "18ce54d4x5t"
        }
      },
      "next_cursor": null,
      "data": [
        {
          "name": "Web-Event-Tag",
          "view_through_window": 7,
          "click_window": 7,
          "embed_code": "<script src=\"//platform.x.com/oct.js\" type=\"text/javascript\"></script><script type=\"text/javascript\">twttr.conversion.trackPid('ny3od',  { tw_sale_amount: 0, tw_order_quantity: 0 });</script><noscript><img height=\"1\" width=\"1\" style=\"display:none;\" alt=\"\"  src=\"https://analytics.x.com/i/adsct?txn_id=ny3od&amp;p_id=Twitter&amp;tw_sale_amount=0&amp;tw_order_quantity=0\" /><img height=\"1\" width=\"1\" style=\"display:none;\" alt=\"\"  src=\"//t.co/i/adsct?txn_id=ny3od&amp;p_id=Twitter&amp;tw_sale_amount=0&amp;tw_order_quantity=0\" /></noscript>",
          "id": "o3bk1",
          "retargeting_enabled": false,
          "last_tracked_at": "2021-05-22T17:00:04Z",
          "status": "TRACKING",
          "type": "DOWNLOAD"
          "website_tag_id": "ny3od",
          "deleted": false
        }
      ]
    }

​
GET accounts/:account_id/web_event_tags/:web_event_tag_id

Ruft ein bestimmtes Web-Event-Tag ab, das dem aktuellen Konto zugeordnet ist.
Ressourcen-URL
https://ads-api.x.com/12/accounts/:account_id/web_event_tags/:web_event_tag_id
Parameter
NameBeschreibung
account_id
erforderlich		Der Bezeichner des verwendeten Kontos. Er erscheint im Ressourcenpfad und ist in der Regel ein erforderlicher Parameter für alle Advertiser-API‑Anfragen, mit Ausnahme von GET accounts. Das angegebene Konto muss dem authentifizierten Benutzer zugeordnet sein.

Type: string

Beispiel: 18ce54d4x5t
web_event_tag_id
erforderlich		Ein Verweis auf das Web-Event-Tag, mit dem Sie in der Anfrage arbeiten.

Type: string

Beispiel: o3bk1
with_deleted
optional		Gelöschte Ergebnisse in die Anfrage einbeziehen.

Type: boolean

Standard: false
Mögliche Werte: true, false
Beispielanfrage
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/web_event_tags/o3bk1
Beispiel-Antwort
    {
      "request": {
        "params": {
          "web_event_tag_id": "o3bk1",
          "account_id": "18ce54d4x5t"
        }
      },
      "data": {
        "name": "Web-Event-Tag",
        "view_through_window": 7,
        "click_window": 7,
        "embed_code": "<script src=\"//platform.x.com/oct.js\" type=\"text/javascript\"></script><script type=\"text/javascript\">twttr.conversion.trackPid('ny3od',  { tw_sale_amount: 0, tw_order_quantity: 0 });</script><noscript><img height=\"1\" width=\"1\" style=\"display:none;\" alt=\"\"  src=\"https://analytics.x.com/i/adsct?txn_id=ny3od&amp;p_id=Twitter&amp;tw_sale_amount=0&amp;tw_order_quantity=0\" /><img height=\"1\" width=\"1\" style=\"display:none;\" alt=\"\"  src=\"//t.co/i/adsct?txn_id=ny3od&amp;p_id=Twitter&amp;tw_sale_amount=0&amp;tw_order_quantity=0\" /></noscript>",
        "id": "o3bk1",
        "retargeting_enabled": false,
        "last_tracked_at": "2021-05-22T17:00:04Z",
        "status": "TRACKING",
        "type": "DOWNLOAD",
        "website_tag_id": "ny3od",
        "deleted": false
      }
    }

​
POST accounts/:account_id/web_event_tags

Erstellen Sie ein neues Web‑Event‑Tag, das dem aktuellen Account zugeordnet ist.

​
Ressourcen-URL

https://ads-api.x.com/12/accounts/:account_id/web_event_tags

​
Parameter

NameBeschreibung
account_id
erforderlich		Der Bezeichner für das verwendete Konto. Er erscheint im Pfad der Ressource und ist in der Regel ein erforderlicher Parameter für alle Advertiser-API-Anfragen mit Ausnahme von GET accounts. Das angegebene Konto muss dem authentifizierten Benutzer zugeordnet sein.

Type: string

Beispiel: 18ce54d4x5t
click_window
erforderlich		Das Klickfenster für dieses Web-Tag.

Hinweis: Es werden nur die unten aufgeführten Werte akzeptiert.

Type: int

Mögliche Werte: 1, 7, 14, 30
name
erforderlich		Der Name des Web-Tags.

Type: string

Beispiel: Sample single conversion event
retargeting_enabled
erforderlich		Gibt an, ob Retargeting für dieses Web-Tag aktiviert werden soll.

Type: boolean

Mögliche Werte: true, false
type
erforderlich		Der Typ des Web-Tags.

Type: enum

Mögliche Werte: ADDED_PAYMENT_INFO, ADD_TO_CART, ADD_TO_WISHLIST, CHECKOUT_INITIATED, CONTENT_VIEW, CUSTOM, DOWNLOAD, PRODUCT_CUSTOMIZATION, PURCHASE, SEARCH, SIGN_UP, SITE_VISIT, START_TRIAL, SUBSCRIBE

(In der UI wird SITE_VISIT als „Page view“ und SIGN_UP als „Lead“ angezeigt)
view_through_window
erforderlich		Das View-through-Fenster für dieses Web-Tag. Dieser Wert muss stets kleiner oder gleich dem Wert von click_window sein.

Hinweis: Es werden nur die unten aufgeführten Werte akzeptiert.

Type: int

Mögliche Werte: 0, 1, 7, 14, 30
Beispielanfrage
POST https://ads-api.x.com/12/accounts/18ce54d4x5t/web_event_tags?click_window=7&name=web event tag&retargeting_enabled=false&type=SITE_VISIT&view_through_window=7

​
Beispielantwort

    {
      "data": {
        "name": "Web-Event-Tag",
        "view_through_window": 7,
        "click_window": 7,
        "embed_code": "<script src='"//platform.x.com/oct.js"' type='"text/javascript"'></script><script type='"text/javascript"'>twttr.conversion.trackPid('ny3od',  { tw_sale_amount: 0, tw_order_quantity: 0 });</script><noscript><img alt='""' height='"1"' src='"https://analytics.x.com/i/adsct?txn_id=ny3od&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0"' style='"display:none;"' width='"1"'/><img alt='""' height='"1"' src='"//t.co/i/adsct?txn_id=ny3od&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0"' style='"display:none;"' width='"1"'/></noscript>",
        "id": "o3bk1",
        "retargeting_enabled": false,
        "last_tracked_at": null,
        "status": "UNVERIFIED",
        "type": "SITE_VISIT",
        "website_tag_id": "ny3od",
        "deleted": false
      },
      "request": {
        "params": {
          "name": "Web-Event-Tag",
          "view_through_window": 7,
          "click_window": 7,
          "retargeting_enabled": false,
          "account_id": "18ce54d4x5t",
          "type": "SITE_VISIT"
        }
      }
    }

​
PUT accounts/:account_id/web_event_tags/:web_event_tag_id

Aktualisiert ein dem aktuellen Konto zugeordnetes Web-Event-Tag.
Ressourcen-URL
https://ads-api.x.com/12/accounts/:account_id/web_event_tags/:web_event_tag_id

​
Parameter

NameBeschreibung
account_id
erforderlich		Der Bezeichner des genutzten Kontos. Er erscheint im Ressourcenpfad und ist in der Regel ein erforderlicher Parameter für alle Advertiser-API-Anfragen mit Ausnahme von GET accounts. Das angegebene Konto muss dem authentifizierten Benutzer zugeordnet sein.

Typ: string

Beispiel: 18ce54d4x5t
web_event_tag_id
erforderlich		Der Bezeichner eines Web-Tags im aktuellen Konto.

Typ: string

Beispiel: o3bk1
click_window
optional		Das Click-Window für dieses Web-Tag.

Hinweis: Es werden nur die unten aufgeführten möglichen Werte akzeptiert.

Typ: int

Mögliche Werte: 1, 7, 14, 30
name
optional		Der Name des Web-Tags.

Typ: string

Beispiel: Sample single conversion event
retargeting_enabled
optional		Gibt an, ob Retargeting für dieses Web-Tag aktiviert sein soll.

Typ: boolean

Mögliche Werte: true, false
type
optional		Der Typ des Web-Tags.

Typ: enum

Mögliche Werte: ADDED_PAYMENT_INFO, ADD_TO_CART, ADD_TO_WISHLIST, CHECKOUT_INITIATED, CONTENT_VIEW, CUSTOM, DOWNLOAD, PRODUCT_CUSTOMIZATION, PURCHASE, SEARCH, SIGN_UP, SITE_VISIT, START_TRIAL, SUBSCRIBE

(In der UI wird SITE_VISIT als „Page view“ und SIGN_UP als „Lead“ angezeigt)
view_through_window
optional		Das View-through-Window für dieses Web-Tag. Dieser Wert muss stets kleiner oder gleich dem Wert von click_window sein.

Hinweis: Es werden nur die unten aufgeführten möglichen Werte akzeptiert.

Typ: int

Mögliche Werte: 0, 1, 7, 14, 30

​
Beispielanforderung

PUT https://ads-api.x.com/12/accounts/18ce54d4x5t/web_event_tags/o3bk1?type=DOWNLOAD

​
Beispielantwort

    {
      "data": {
        "name": "Webereignis-Tag",
        "view_through_window": 7,
        "click_window": 7,
        "embed_code": "<script src='"//platform.x.com/oct.js"' type='"text/javascript"'></script><script type='"text/javascript"'>twttr.conversion.trackPid('ny3od',  { tw_sale_amount: 0, tw_order_quantity: 0 });</script><noscript><img alt='""' height='"1"' src='"https://analytics.x.com/i/adsct?txn_id=ny3od&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0"' style='"display:none;"' width='"1"'/><img alt='""' height='"1"' src='"//t.co/i/adsct?txn_id=ny3od&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0"' style='"display:none;"' width='"1"'/></noscript>",
        "id": "o3bk1",
        "retargeting_enabled": false,
        "last_tracked_at": "2021-05-22T17:00:04Z",
        "status": "UNVERIFIED",
        "type": "DOWNLOAD",
        "website_tag_id": "ny3od",
        "deleted": false
      },
      "request": {
        "params": {
          "web_event_tag_id": "o3bk1",
          "type": "DOWNLOAD",
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
DELETE accounts/:account_id/web_event_tags/:web_event_tag_id

Löscht ein bestimmtes Web-Event-Tag, das dem aktuellen Konto zugeordnet ist.

​
Ressourcen-URL

https://ads-api.x.com/12/accounts/:account_id/web_event_tags/:web_event_tag_id
Parameter
NameBeschreibung
account_id
erforderlich		Der Bezeichner des genutzten Kontos. Er erscheint im Pfad der Ressource und ist im Allgemeinen ein erforderlicher Parameter für alle Advertiser-API-Anfragen mit Ausnahme von GET accounts. Das angegebene Konto muss dem authentifizierten Nutzer zugeordnet sein.

Type: string

Example: 18ce54d4x5t
web_event_tag_id
erforderlich		Der Bezeichner eines Web-Tags im aktuellen Konto.

Type: string

Example: o3bk1
Beispielanfrage
DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/web_event_tags/o3bk1
Beispielantwort
    {
      "data": {
        "name": "Webevent-Tag",
        "view_through_window": 7,
        "click_window": 7,
        "embed_code": "<script src='"//platform.x.com/oct.js"' type='"text/javascript"'></script><script type='"text/javascript"'>twttr.conversion.trackPid('ny3od',  { tw_sale_amount: 0, tw_order_quantity: 0 });</script><noscript><img alt='""' height='"1"' src='"https://analytics.x.com/i/adsct?txn_id=ny3od&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0"' style='"display:none;"' width='"1"'/><img alt='""' height='"1"' src='"//t.co/i/adsct?txn_id=ny3od&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0"' style='"display:none;"' width='"1"'/></noscript>",
        "id": "o3bk1",
        "retargeting_enabled": false,
        "last_tracked_at": "2021-05-22T17:00:04Z",
        "status": "UNVERIFIED",
        "type": "DOWNLOAD",
        "website_tag_id": "ny3od",
        "deleted": true
      },
      "request": {
        "params": {
          "web_event_tag_id": "o3bk1",
          "account_id": "18ce54d4x5t"
        }
      }
    }
⌘I