Hämta bakgrundsmusik i Attribution AI

Det här dokumentet är en guide för nedladdning av bakgrundsmusik för Attribution AI.

Komma igång

Med Attribution AI kan du hämta bakgrundsmusik i filformatet Parquet. Den här självstudien kräver att du har läst och slutfört nedladdningen av bakgrundsmusik för Attribution AI i guiden Komma igång.

För att få åtkomst till bakgrundsmusik för Attribution AI måste du dessutom ha en tjänstinstans med statusen Slutfört. Om du vill skapa en ny tjänstinstans går du till användarhandboken för Attribution AI. Om du nyligen har skapat en tjänstinstans och den fortfarande håller på att träna och betygsätta, kan du vänta i 24 timmar tills den är klar.

Hitta ditt datauppsättnings-ID dataset-id

Klicka på listrutan Fler åtgärder i den övre högra navigeringen och välj sedan Access scores i tjänstinstansen för att få information om Attribution AI.

En ny dialogruta visas med en länk till dokumentationen för nedladdning av bakgrundsmusik och datauppsättnings-ID:t för den aktuella instansen. Kopiera datauppsättnings-ID:t till Urklipp och fortsätt till nästa steg.

Hämta ditt batch-ID retrieve-your-batch-id

Om du använder ditt datauppsättnings-ID från föregående steg måste du ringa ett anrop till katalog-API:t för att hämta ett batch-ID. Ytterligare frågeparametrar används för detta API-anrop för att returnera den senaste lyckade gruppen i stället för en lista med batchar som tillhör din organisation. Om du vill returnera ytterligare batchar ökar du talet för frågeparametern limit till önskad mängd som du vill returnera. Mer information om vilka typer av frågeparametrar som finns tillgängliga finns i guiden Filtrera katalogdata med frågeparametrar.

API-format

GET /batches?&dataSet={DATASET_ID}&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1

Begäran

curl -X GET 'https://platform.adobe.io/data/foundation/catalog/batches?&dataSet=5e8f81ce7a4ecb18a8d25b22&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Svar

Ett godkänt svar returnerar en nyttolast som innehåller ett batch-ID-objekt. I det här exemplet är nyckelvärdet för det returnerade objektet batch-ID 01E5QSWCAASFQ054FNBKYV6TIQ. Kopiera ditt batch-ID till nästa API-anrop.

{
    "01E5QSWCAASFQ054FNBKYV6TIQ": {
        "status": "success",
        "tags": {
            "Tags": [ ... ],
        },
        "relatedObjects": [
            {
                "type": "dataSet",
                "id": "5e8f81cf7a4ecb28a8d85b22"
            }
        ],
        "id": "01E5QSWCAASFQ054FNBKYV6TIQ",
        "externalId": "01E5QSWCAASFQ054FNBKYV6TIQ",
        "replay": {
            "predecessors": [
                "01E5N7EDQQP4JHJ93M7C3WM5SP"
            ],
            "reason": "Replacing for 2020-04-09",
            "predecessorListingType": "IMMEDIATE"
        },
        "inputFormat": {
            "format": "parquet"
        },
        "imsOrg": "412657965Y566A4A0A495D4A@AdobeOrg",
        "started": 1586715571808,
        "metrics": {
            "partitionCount": 1,
            "outputByteSize": 2380339,
            "inputFileCount": -1,
            "inputByteSize": 2381007,
            "outputRecordCount": 24340,
            "outputFileCount": 1,
            "inputRecordCount": 24340
        },
        "completed": 1586715582735,
        "created": 1586715571217,
        "createdClient": "acp_foundation_push",
        "createdUser": "sensei_exp_attributionai@AdobeID",
        "updatedUser": "acp_foundation_dataTracker@AdobeID",
        "updated": 1586715583582,
        "version": "1.0.5"
    }
}

Hämta nästa API-anrop med ditt batch-ID retrieve-the-next-api-call-with-your-batch-id

När du har ditt batch-ID kan du göra en ny GET-förfrågan till /batches. Begäran returnerar en länk som används som nästa API-begäran.

API-format

GET batches/{BATCH_ID}/files

Begäran

Använd ditt eget batch-ID och gör följande begäran.

curl -X GET 'https://platform.adobe.io/data/foundation/export/batches/01E5QSWCAASFQ054FNBKYV6TIQ/files' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Svar

Ett godkänt svar returnerar en nyttolast som innehåller ett _links-objekt. I objektet _links finns ett href med ett nytt API-anrop som värde. Kopiera det här värdet för att fortsätta till nästa steg.

{
    "data": [
        {
            "dataSetFileId": "01E5QSWCAASFQ054FNBKYV6TIQ-1",
            "dataSetViewId": "5e8f81cf7a4ecb28a8d85b22",
            "version": "1.0.0",
            "created": "1586715582571",
            "updated": "1586715582571",
            "isValid": false,
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1"
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 1
    }
}

Hämta dina filer retrieving-your-files

Använd det href-värde du fick i det föregående steget som ett API-anrop för att skapa en ny GET-begäran för att hämta din filkatalog.

API-format

GET files/{DATASETFILE_ID}

Begäran

curl -X GET 'https://platform.adobe.io/data/foundation/export/files/01E5QSWCAASFQ054FNBKYV6TIQ-1' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Svar

Svaret innehåller en datamatris som kan ha en enda post, eller en lista med filer som tillhör den katalogen. Exemplet nedan innehåller en lista med filer och har komprimerats för läsbarhet. I det här fallet måste du följa URL:en för varje fil för att kunna komma åt filen.

{
    "data": [
        {
            "name": "part-00000-tid-5614147572541837832-908bd66a-d856-47fe-b7da-c8e7d22a4097-1370467-1.c000.snappy.parquet",
            "length": "2380211",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1?path=part-00000-trd-5714147572541837832-938bd66a-d556-41fe-b7da-c8e7d22a4097-1320467-1.c000.snappy.parquet"
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 1
    }
}

Kopiera värdet href för alla filobjekt i arrayen data och fortsätt till nästa steg.

Ladda ned fildata

Om du vill hämta fildata skickar du en GET till det "href"-värde som du kopierade i föregående steg när du hämtade dina filer.

API-format

GET files/{DATASETFILE_ID}?path={FILE_NAME}

Begäran

curl -X GET 'https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1?path=part-00000-trd-5714147572541837832-938bd66a-d556-41fe-b7da-c8e7d22a4097-1320467-1.c000.snappy.parquet' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -O 'file.parquet'

Svar

Svaret hämtar filen som du begärde i din aktuella katalog. I det här exemplet är filnamnet"file.parquet".

Poängen som hämtas kommer att vara i Parquet-format och måste antingen ha en Spark-shell- eller Parquet-läsare för att visa poängen. Du kan använda Apache Parquet-verktygen för visning av Raw-poäng. Parquetverktyg kan analysera data med Spark.

Nästa steg

I det här dokumentet beskrivs stegen som krävs för att hämta bakgrundsmusik för Attribution AI. Mer information om bakgrundsmusik finns i dokumentationen för Attribut-AI-indata och -utdata.

Åtkomst till bakgrundsmusik med Snowflake

Du kan komma åt aggregerade Attribution AI via Snowflake. För närvarande måste du skicka e-post till supporten för Adobe på attributionai-support@adobe.com för att kunna konfigurera och ta emot inloggningsuppgifterna till ditt läsarkonto för Snowflake.

När supporten för Adobe har bearbetat din begäran, får du en URL för läsarkontot till Snowflake och motsvarande uppgifter nedan:

När du har dina inloggningsuppgifter och URL-adresser kan du söka efter modelltabellerna, aggregerade efter kontaktpunktsdatum eller konverteringsdatum.

Hitta ditt schema i Snowflake

Logga in på Snowflake med de angivna inloggningsuppgifterna. Klicka på fliken Kalkylblad i den övre vänstra huvudnavigeringen och navigera sedan till din databaskatalog i den vänstra panelen.

Klicka sedan på Välj schema i skärmens övre högra hörn. Bekräfta att du har markerat rätt databas i den port som visas. Klicka sedan på listrutan Schema och välj ett av scheman i listan. Du kan söka direkt från de poängtabeller som listas under det valda schemat.

Ansluta PowerBI till Snowflake (valfritt)

Dina inloggningsuppgifter för Snowflake kan användas för att skapa en anslutning mellan PowerBI Desktop och Snowflake-databaser.

Skriv Snowflake URL:en i rutan Server. Skriv sedan in XSMALL under Lagerställe. Skriv sedan in ditt användarnamn och lösenord.

När anslutningen har upprättats väljer du din Snowflake-databas och väljer sedan lämpligt schema. Du kan nu läsa in alla tabeller.