Die Variable „purchase-details“ stellt Informationen zu den in einer bestimmten Transaktion verkauften Produkten zur Verfügung. Sie können die Variable einem Floodlight-Ereignis-Snippet, einem Floodlight-Tag, der Datenschicht von Google Tag Manager oder einem Google Tag Manager-Makro hinzufügen.
Je nachdem, wie Sie die Variable hinzufügen, können Sie eines der folgenden Formate verwenden:
-
Wenn Sie das Google-Tag verwenden, formatieren Sie die Variable „purchase-details“ als JSON-Objekt direkt im Floodlight-Ereignis-Snippet.
- Wenn Sie ein Floodlight-iFrame- oder -Bild-Tag nutzen oder die Daten als Makro an Google Tag Manager weitergeben, formatieren Sie die Variable „purchase-details“ als einen in mehrere Felder unterteilten String.
-
Wenn Sie Daten an die Datenschicht von Google Tag Manager weitergeben, sollten Sie die Variable als JSON-Objekt mit Feldern formatieren, die Informationen zum Kauf enthalten.
Anforderungen für das JSON-Format in einem Floodlight-Ereignis-Snippet
Wenn Sie das Google-Tag verwenden, sollten die Kaufdetails im Ereignis-Snippet in Form eines JSON-items-Arrays sowie von country- und language-Feldern angegeben werden. Alle Elemente im Array enthalten die folgenden Felder:
idprice-
quantity
Beispiel:
<!--
Event snippet for Thank You on http://www.example.com/thanks: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 11/01/2017
-->
<script>
gtag('event', 'purchase',
{
'allow_custom_scripts': true,
'send_to': 'DC-1234567/group1/thank123+transactions',
'transaction_id': '012345',
'value': 129.97,
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
],
'country': 'us',
'language': 'en'
}
);
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=1234567;type=group1;cat=thank123;
qty=1;cost=129.97;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=;
ord=012345;prd=i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2|c:us|l:en?" width="1" height="1" alt="">
</noscript>
<!-- End of event snippet: Please do not remove -->
Hinweis: Von Search Ads 360 generierte Ereignis-Snippets enthalten ein optionales <noscript>-Tag mit einem Floodlight-Image-Tag. Mithilfe dieses Tags werden Conversions in Browsern gemeldet, die kein JavaScript unterstützen.
Anforderungen für das JSON-Format in der Datenschicht
Wenn Sie Google Tag Manager verwenden, sollten die Felder der Variablen „purchase-detail“ als Elemente in einem JSON-ecommerce.purchase.products-Array angegeben werden:
'ecommerce':{
'purchase':{
'products': [{
'id': 'String',
'price': 'Floating point',
'quantity': Integer,
'country': 'String', // Optional
'language': 'String', // Optional
'accountId': 'String' // Optional
},
{
… // Each SKU (product) in the transaction
// is in its own array item.
}]
}
}'
Beachten Sie, dass sich die Feldnamen für dieses JSON-Objekt von denen für das JSON-Objekt unterscheiden, das Sie verwenden, wenn Sie die „purchase-details“-Variable einem Floodlight-Ereignis-Snippet hinzufügen.
Wenn Sie Kaufdetails in die Datenschicht verschieben, speichern Sie damit die Daten in demselben Objekt, das Google Analytics verwenden kann, um die auf Ihrer Website gekauften Produkte zu dokumentieren. Das heißt: Wenn Sie sowohl Search Ads 360 als auch Google Analytics verwenden, um Kaufdetails zu dokumentieren, kann Ihr Webentwickler dasselbe Objekt verwenden, um die Daten für beide Produkte zu speichern.
Anforderungen für das String-Format
Im String-Format sollte jedes Feld mit Informationen zum Kauf als Schlüssel/Wert-Paar im folgenden Format angegeben werden:
[Feld-ID][Index]:[Wert]
- [Feld-ID] gibt den gemeldeten Werttyp an.
- [Index] gibt den Artikel an, für den der Wert berichtet wird.
- [Wert] gibt Informationen zum Verkauf des Produkts an.
Trennen Sie die Felder durch einen senkrechten Strich (|) voneinander. Beispiel:
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Felder mit Informationen zum Kauf
|
Feld |
ID im String-Format |
Typ |
Erforderlich |
Beschreibung |
|
|
|
String |
Ja |
Die ID des verkauften Produkts. Die ID muss der Artikel-ID aus dem Google Merchant Center entsprechen. |
|
|
|
Gleitkommawert |
Ja |
Preis pro Einheit des verkauften Produkts. Verwenden Sie kein Währungssymbol. |
|
|
|
Ganzzahl |
Ja |
Die Anzahl der verkauften Produkteinheiten |
|
|
|
String (ISO 3166-Ländercode) |
Nein |
Das Land, das für den Merchant Center-Feed registriert ist, der Daten zum Produkt enthält. Dieses Feld ist nur erforderlich, wenn die Artikel-IDs in mehreren Merchant Center-Feeds nicht eindeutig sind. Geben Sie das Land nur einmal für jedes Produkt an. Es handelt sich nicht um ein wiederkehrendes Feld. Wenn das Feld nicht festgelegt wird, dann wählt Search Ads 360 einen Merchant Center-Feed aus, der die Produkt-ID enthält, und verwendet seine Attribute für die „Verkaufte Produkte“-Dimensionen. |
|
|
|
String (ISO 639-Sprachcode) |
Nein |
Die Sprache, die für den Merchant Center-Feed registriert ist, der Daten zum Produkt enthält. Dieses Feld ist nur erforderlich, wenn die Artikel-IDs in mehreren Merchant Center-Feeds nicht eindeutig sind. Wenn das Feld nicht festgelegt wird, dann wählt Search Ads 360 einen Merchant Center-Feed aus, der die Produkt-ID enthält, und verwendet seine Attribute für die „Verkaufte Produkte“-Dimensionen. |
Sonderzeichen und URL-Codierung
Der Doppelpunkt (:) und der senkrechte Strich (|) werden im String-Format als Feldtrennzeichen verwendet. Search Ads 360 kann keine Daten akzeptieren, die diese Zeichen als Werte in einem Feld enthalten, selbst wenn Sie eines der JSON-Formate verwenden.
Wie bei allen Floodlight-Daten werden die folgenden Zeichen ebenfalls nicht unterstützt:
;, <, >, ?
Nehmen wir einmal an, dass eine Transaktion folgende Elemente enthält:
-
Artikel 1
- Name: m-dress-orange-xl
- UPC: 123456755559
- Preis pro Artikel: 19,99 $
- Menge: 1
-
Artikel 2
- Name: m-polo-green-l
- UPC: 123456788889
- Preis pro Artikel: 54 $
- Menge: 2
Die Variable „purchase-details“ in einem Ereignis-Snippet würde die folgenden Felder enthalten:
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
]
So wird die Variable „purchase-details“ in einem Floodlight-iFrame-Tag angezeigt:
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Neben der Variablen „purchase-details“ würde das Floodlight-Tag oder -Ereignis-Snippet auch die folgenden Daten angeben:
-
ID der Floodlight-Aktivitätsgruppe
-
ID der Floodlight-Aktivität
-
Transaktions-ID (Bestell-ID)
-
Gesamtwert der Transaktion: 129,97 $ = (1*19,99 $ + 2*54 $)
-
Menge: 3. Sie können die genaue Bedeutung dieses Felds festlegen. Eventuell ist es sinnvoll, wenn Sie es verwenden, um die Gesamtgröße des Einkaufswagens in den Bericht aufzunehmen.
-
Alle anderen benutzerdefinierten Floodlight-Variablen
Das endgültige globale Website-Tag mit dem Ereignis-Snippet würde so aussehen:
<!--
Start of global snippet: Please do not remove
Place this snippet between the <head> and </head> tags on every page of your site.
-->
<!-- Google Tag (gtag.js) - DoubleClick -->
<script async src="https://www.googletagmanager.com/gtag/js?id=DC-1234567"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments)};
gtag('js', new Date());
gtag('config', 'DC-1234567');
</script>
<!-- End of global snippet: Please do not remove -->
<!--
Event snippet for Thank You on http://www.example.com/thanks: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 11/01/2017
-->
<script>
gtag('event', 'purchase',
{
'allow_custom_scripts': true,
'send_to': 'DC-1234567/group1/thank123+transactions',
'transaction_id': '012345',
'value': 129.97,
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
],
'country': 'us',
'language': 'en'
}
);
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=1234567;type=group1;cat=thank123;
qty=1;cost=129.97;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=;
ord=012345;prd=i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2|c:us|l:en?" width="1" height="1" alt="">
</noscript>
<!-- End of event snippet: Please do not remove -->
Hier sehen Sie ein Beispiel eines Floodlight-iFrame-Tags mit einer „purchase-details“-Variablen:
Sie können das Merchant Center verwenden, um Ihre Produkte in mehreren Feeds einzureichen, die jeweils ein Targeting auf eine bestimmte Sprache und ein bestimmtes Land aufweisen. Wenn Sie beispielsweise dieselbe Gruppe von Produkten in den USA und in Kanada verkaufen möchten, können Sie einen Feed mit Preisen und Beschreibungen für die USA, einen zweiten mit kanadischen Preisen und Beschreibungen auf Französisch und einen dritten mit kanadischen Preisen und Beschreibungen auf Englisch einrichten.
Wenn Sie Feeds mit denselben Produkt-IDs, aber unterschiedlichen Zielsprachen oder -ländern einreichen, müssen Sie den Sprach- und Ländercode in der Variable „purchase-details“ festlegen. Beispiel: Dieses items-Array und die Felder country und language im Ereignis-Snippet zeigen einen Kauf in dem Feed an, der auf französischsprachige Kanadier ausgerichtet ist:
'items': [
{ 'id': '123456788889',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456755559',
'price': '54.00',
'quantity': 2
}
],
'country': 'ca',
'language': 'fr'
Achten Sie darauf, dass Sie die aus zwei Zeichen bestehenden ISO-Codes für das Land und die Sprache verwenden.