Bevor Sie mit der Implementierung der Meta CAPI beginnen, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:
• TAGGRS-Setup: Stellen Sie sicher, dass Ihr TAGGRS-Servercontainer bereitgestellt ist. Sie können unseren folgen Leitfaden zur Implementierung um es einfach machen zu lassen.
• API-Zugriffstoken: Generieren Sie im Meta Events Manager unter Conversions API → Settings.
• Pixel-ID: Suchen Sie im Meta Events Manager unter Datenquellen.
• Konfiguration der Datenebene: Stellen Sie sicher, dass Ihre Website Daten über GA4 an den Server-GTM-Container sendet.
gehe zu Templates und wähle Gallery.
Facebook Conversion API von stape and click Add to workspace.
Erstellen Sie ein neues Tag in Ihrem Servercontainer und wählen Sie Facebook-Konvertierungs-API als Tag-Typ.
Konfigurieren Sie die wichtigsten Einstellungen:
Wählen Sie zwischen den folgenden 2 Optionen.
• Vom Kunden erben: Ordnet GA4-Ereignisse automatisch Meta-Standardereignissen zu
• Überschreiben: Gibt Ihnen die volle Kontrolle über die Eventkonfiguration und Payload-Anpassung
Für webbasierte Konvertierungen auf Website setzen.
Geben Sie Ihr Zugriffstoken ein oder verwenden Sie eine Variable wie {{Meta-Access-Token}}.
Gib deine Pixel-ID ein oder verwende eine Variable wie {{Meta Pixel ID}}.
Check Generate _fbp cookie if it not exist for better event matching.
Aufstellen User data und Custom data Abschnitte für verbessertes Tracking.
Die Stape-Vorlage verarbeitet die meisten Datenzuordnungen automatisch, Sie können sie jedoch mit benutzerdefinierten Variablen erweitern:
Variable type
Variable name
Purpose
Data Layer Variable
Event Name
Maps to event_name from client
Data Layer Variable
Transaction ID
Maps to ecommerce.transaction_id
Data Layer Variable
Purchase Value
Maps to ecommerce.value
Data Layer Variable
Currency
Maps to ecommerce.currency
Data Layer Variable
User Email
Maps to user_data.email_address
Data Layer Variable
User Phone
Maps to user_data.phone_number
Erstellen Sie eine Benutzerdefiniert Trigger, der ausgelöst wird, wenn Ihr Datenclient Ereignisse verarbeitet. Stellen Sie die Triggerbedingung ein:
Die Stapelvorlage ordnet allgemeine GA4-Ereignisse automatisch Meta-Standardereignissen zu:purchase → Purchaseadd_to_cart → AddToCartbegin_checkout → InitiateCheckoutpage_view → PageView
Aktiviere Einstellungen für die Einwilligung wenn Sie das Einwilligungsmanagement verwenden:
• Konfigurieren Sie so, dass Daten nur gesendet werden, wenn eine Marketinggenehmigung erteilt wurde.
• Stellen Sie sicher, dass Ihr Web-Container den Zustimmungsstatus an den Servercontainer übergibt.
Die Vorlage verarbeitet die automatische Ereignisdeduplizierung, wenn sie mit übereinstimmenden Ereignis-IDs zwischen clientseitigen und serverseitigen Implementierungen konfiguriert ist.
graph.facebook.com in POST - 200.
Wenn bei dir Facebook-CAPI-Fehler im Zusammenhang mit Inhalt oder inhalts_ids Parameter, in diesem Abschnitt wird erklärt, warum das Problem auftritt und wie es richtig behoben werden kann.
Wenn Sie Ereignisse über Facebook CAPI an Meta senden, kann im Events Manager der folgende Fehler auftreten:
{"error":{"message":"Invalid
parameter","type":"OAuthException","code":100,
"error_subcode":2804008,"is_transient":false,
"error_user_title":"Invalid Contents Parameter",
"error_user_msg":"The contents parameter you entered
doesn't contain a list of JSON objects. Enter a
list of JSON objects that contain the product
IDs associated with the event plus information
about the products. For example: [{ 'id' :
'ABC123', 'quantity' : '2', 'item_price' : 5.99},
{ 'id' : 'XYZ789' , 'quantity' : 2, 'item_price'
: 9.99}]","fbtrace_id":"..."}}Dies deutet in der Regel darauf hin, dass Inhalt Der Parameter ist entweder falsch formatiert oder nicht als Liste von JSON-Objekten formatiert.
contents und content_ids Gehen Sie in Ihrem Tag-Manager zu Ihrem Servercontainer. Suchen Sie nach Ihrem vorhandenen Facebook-CAPI-Tag. Entfernen Sie die folgenden Parameter (falls vorhanden): contents und content_ids.
contents Parameter für KaufereignisseFacebook geht davon aus, dass es sich bei Inhalten um eine Reihe von Produktobjekten handelt. Der sicherste Ansatz besteht darin, ihn mithilfe von GA4-E-Commerce-Daten im Web-Container zu erstellen.
Erstellen Sie also eine JavaScript-Variable in Ihrem Client-Container:
• Öffnen Sie Ihren Web-Container.
• Fügen Sie eine neue Variable des Typs hinzu Benutzerdefiniertes JavaScript.
• Verwenden Sie den folgenden Code, um den zu konstruieren Inhalt parameter (Stellen Sie sicher, dass {{DLV - ecommerce.items}} Ihre richtige Artikelvariable ist):
function() {
// Access the items array from the dataLayer
var items = {{DLV - ecommerce.items}};
// Validate that items is an array with at
least one item
if (!items || !Array.isArray(items) ||
items.length === 0) {
return null;
}
// Map over each item to create a new array
with the modified properties
var modifiedItems = items.map(function(item) {
return {
id: item.item_id,
name: item.item_name || "",
price: item.price || 0,
quantity: item.quantity || 1
};
});
// Return only the first item in
the modified array as required
return [modifiedItems[0]];
}Dadurch wird sichergestellt, dass die JSON-Struktur gültig ist, die erforderlichen Produktfelder enthalten sind und alles mit den CAPI-Validierungsregeln von Meta kompatibel ist.
Im Servercontainer:
• Erstellen Sie ein spezielles Facebook-CAPI-Tag für Kaufereignisse.
• Schließen Sie Kaufereignisse aus dem ursprünglichen Facebook-CAPI-Tag aus.
Im kaufspezifischen CAPI-Tag:
• Fügen Sie das Inhalt Parameter.
• Benutze eine Daten zur Veranstaltung variabel zum Ziehen des Inhalt Wert aus der Variablen, die Sie zuvor im Web-Container erstellt haben.
Veröffentlichen Sie sowohl den Web-Container als auch den serverseitigen Container.
Testen Sie alle Ereignisse (z. B. Zum Einkaufswagen hinzufügen, Kauf), um zu bestätigen, dass sie erwartungsgemäß funktionieren.
Überprüfen Sie den Meta Event Manager, um sicherzustellen, dass keine Fehler auftreten.
